Juvina.Diagnostics 0.1.0

Juvina.Diagnostics

See what memory saves you, on your own dashboard, on your own traffic.

OpenTelemetry instrumentation for Juvina memory recalls. It emits four measurements into whatever backend you already use — Prometheus, Grafana, Application Insights, Jaeger, the .NET Aspire dashboard, or anything else that speaks OTel.

You don't have to take anyone's word for what memory saves. The line draws itself, in the pane you already watch.

juvina.tokens.saved            tokens NOT sent, versus replaying the history
juvina.tokens.sent             tokens actually sent as the constructed recall
juvina.recall.duration         how long the recall took (ms)
juvina.recall.evidence_lines   evidence lines the engine drew on

Install

dotnet add package Juvina.Diagnostics

Wire it up

Register the meter with your existing OpenTelemetry setup:

builder.Services.AddOpenTelemetry()
    .WithMetrics(m => m.AddMeter(JuvinaMetrics.MeterName))
    .WithTracing(t => t.AddSource(JuvinaMetrics.ActivitySourceName));

Then record each recall:

using var span = JuvinaMetrics.StartRecall(environment: "my-project");

var recall = await memory.RecallAsync(question);

JuvinaMetrics.RecordRecall(
    recallTokens:  recall.TokenCount,
    historyTokens: conversation.TokenCount,   // measured, not estimated — see below
    durationMs:    recall.LatencyMs,
    evidenceLines: recall.EvidenceLines,
    environment:   "my-project");

That's it. juvina.tokens.saved starts accumulating on your dashboard.

About the saving

historyTokens is optional, and if you don't pass it, no saving is reported.

That is deliberate. The saving is the difference between the compact recall you sent and the full history you would otherwise have replayed — so it can only be reported when you actually know the size of that history. An unmeasured saving is not a saving, and this package will not invent one.

Pass the real token count of the conversation you would have sent, and the number on your dashboard is yours, computed from your own traffic.

What this package does not do

• It sends nothing anywhere. It writes to the standard .NET Meter and ActivitySource APIs; your application decides where — or whether — that goes.
• It has no dependency on the Juvina engine, so it cannot phone home even by accident.
• On net8.0 it takes no package dependency at all: System.Diagnostics.Metrics is in the BCL.

Requires

The metrics describe recalls performed by the Juvina memory engine. Juvina runs entirely on your machine — memories live in a local database, and model calls go to your own endpoint on your own key.

https://juvina.ai

MIT licensed.