@rynfar/meridian 1.29.2 → 1.30.0

package/README.md

@@ -80,7 +80,7 @@ The Claude Code SDK provides programmatic access to Claude. But your favorite co
 - **Passthrough mode** — forward tool calls to the client instead of executing internally
 - **Multimodal** — images, documents, and file attachments pass through to Claude
 - **Multi-profile** — switch between Claude accounts instantly, no restart needed
-- **Telemetry dashboard** — real-time performance metrics at `/telemetry`
+- **Telemetry dashboard** — real-time performance metrics at `/telemetry`, including token usage and prompt cache efficiency ([`MONITORING.md`](MONITORING.md))
 
 ## Multi-Profile Support
 
@@ -508,7 +508,7 @@ You haven't run `meridian setup`. Without the plugin, OpenCode requests won't ha
 
 ## Contributing
 
-Issues and PRs welcome. Join the [Discord](https://discord.gg/7vNVFYBz) to discuss ideas before opening issues. See [`ARCHITECTURE.md`](ARCHITECTURE.md) for module structure and dependency rules, [`CLAUDE.md`](CLAUDE.md) for coding guidelines, and [`E2E.md`](E2E.md) for end-to-end test procedures.
+Issues and PRs welcome. Join the [Discord](https://discord.gg/7vNVFYBz) to discuss ideas before opening issues. See [`ARCHITECTURE.md`](ARCHITECTURE.md) for module structure and dependency rules, [`CLAUDE.md`](CLAUDE.md) for coding guidelines, [`E2E.md`](E2E.md) for end-to-end test procedures, and [`MONITORING.md`](MONITORING.md) for understanding token usage and prompt cache health.
 
 ## License
 

package/assets/bot-icon.svg

@@ -0,0 +1,54 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" fill="none">
+  <rect width="512" height="512" rx="112" fill="#1C1830"/>
+  
+  <!-- Antenna -->
+  <line x1="256" y1="72" x2="256" y2="115" stroke="#A78BFA" stroke-width="8" stroke-linecap="round"/>
+  <circle cx="256" cy="64" r="14" fill="#C4B5FD"/>
+  <!-- Antenna signal arcs -->
+  <path d="M228 52 A32 32 0 0 1 284 52" fill="none" stroke="#C4B5FD" stroke-width="3" opacity="0.4" stroke-linecap="round"/>
+  <path d="M216 40 A44 44 0 0 1 296 40" fill="none" stroke="#C4B5FD" stroke-width="2.5" opacity="0.25" stroke-linecap="round"/>
+  
+  <!-- Robot head -->
+  <rect x="128" y="115" width="256" height="200" rx="40" fill="#2D2750"/>
+  <rect x="128" y="115" width="256" height="200" rx="40" fill="none" stroke="#8B7CF6" stroke-width="4"/>
+  
+  <!-- Eyes — screens with Meridian purple glow -->
+  <rect x="170" y="165" width="68" height="52" rx="14" fill="#1C1830" stroke="#8B7CF6" stroke-width="3"/>
+  <rect x="274" y="165" width="68" height="52" rx="14" fill="#1C1830" stroke="#8B7CF6" stroke-width="3"/>
+  <!-- Eye glow -->
+  <circle cx="204" cy="191" r="16" fill="#8B7CF6" opacity="0.8"/>
+  <circle cx="308" cy="191" r="16" fill="#8B7CF6" opacity="0.8"/>
+  <!-- Eye highlights -->
+  <circle cx="210" cy="185" r="5" fill="#C4B5FD" opacity="0.6"/>
+  <circle cx="314" cy="185" r="5" fill="#C4B5FD" opacity="0.6"/>
+  
+  <!-- Mouth — friendly LED strip -->
+  <rect x="196" y="248" width="120" height="24" rx="12" fill="#1C1830" stroke="#8B7CF6" stroke-width="2"/>
+  <circle cx="220" cy="260" r="5" fill="#C4B5FD" opacity="0.7"/>
+  <circle cx="244" cy="260" r="5" fill="#8B7CF6"/>
+  <circle cx="268" cy="260" r="5" fill="#C4B5FD" opacity="0.7"/>
+  <circle cx="292" cy="260" r="5" fill="#8B7CF6" opacity="0.5"/>
+  
+  <!-- Ear bolts -->
+  <circle cx="118" cy="200" r="16" fill="#2D2750" stroke="#8B7CF6" stroke-width="3"/>
+  <circle cx="118" cy="200" r="6" fill="#8B7CF6"/>
+  <circle cx="394" cy="200" r="16" fill="#2D2750" stroke="#8B7CF6" stroke-width="3"/>
+  <circle cx="394" cy="200" r="6" fill="#8B7CF6"/>
+  
+  <!-- Neck -->
+  <rect x="228" y="315" width="56" height="28" rx="6" fill="#2D2750" stroke="#8B7CF6" stroke-width="2"/>
+  
+  <!-- Body / chest plate -->
+  <rect x="148" y="343" width="216" height="120" rx="30" fill="#2D2750" stroke="#8B7CF6" stroke-width="4"/>
+  
+  <!-- Meridian logo on chest — the globe axis + arcs -->
+  <line x1="256" y1="365" x2="256" y2="443" stroke="#8B7CF6" stroke-width="6" stroke-linecap="round"/>
+  <!-- Chest latitude arcs -->
+  <path d="M212 382 A48 48 0 0 1 300 382" fill="none" stroke="#C4B5FD" stroke-width="3" opacity="0.5"/>
+  <path d="M212 426 A48 48 0 0 0 300 426" fill="none" stroke="#C4B5FD" stroke-width="3" opacity="0.5"/>
+  <!-- Chest poles -->
+  <circle cx="256" cy="365" r="8" fill="#C4B5FD"/>
+  <circle cx="256" cy="443" r="8" fill="#C4B5FD"/>
+  <!-- Chest center node -->
+  <circle cx="256" cy="404" r="6" fill="#8B7CF6"/>
+</svg>

package/dist/{cli-trtwsfge.js → cli-b2n69dg7.js}

@@ -6220,7 +6220,8 @@ function jsonSchemaToZod(schema) {
 function createPassthroughMcpServer(tools) {
   const server = createSdkMcpServer({ name: PASSTHROUGH_MCP_NAME });
   const toolNames = [];
-  for (const tool of tools) {
+  const sortedTools = [...tools].sort((a, b) => a.name.localeCompare(b.name));
+  for (const tool of sortedTools) {
     try {
       const zodSchema = tool.input_schema?.properties ? jsonSchemaToZod(tool.input_schema) : exports_external.object({});
       const shape = zodSchema instanceof exports_external.ZodObject ? zodSchema.shape : { input: exports_external.any() };
@@ -6286,6 +6287,16 @@ class TelemetryStore {
     }
     return results;
   }
+  getLastForSession(sdkSessionId) {
+    for (let i = 0;i < this.count; i++) {
+      const idx = (this.head - 1 - i + this.capacity) % this.capacity;
+      const metric = this.buffer[idx];
+      if (metric && metric.sdkSessionId === sdkSessionId && metric.error === null) {
+        return metric;
+      }
+    }
+    return;
+  }
   summarize(windowMs = 60 * 60 * 1000) {
     const since = Date.now() - windowMs;
     const metrics = this.getRecent({ limit: this.capacity, since });
@@ -6302,7 +6313,15 @@ class TelemetryStore {
         upstreamDuration: emptyPhase,
         totalDuration: emptyPhase,
         byModel: {},
-        byMode: {}
+        byMode: {},
+        tokenUsage: {
+          totalInputTokens: 0,
+          totalOutputTokens: 0,
+          totalCacheReadTokens: 0,
+          totalCacheCreationTokens: 0,
+          avgCacheHitRate: 0,
+          cacheMissOnResumeCount: 0
+        }
       };
     }
     const errorCount = metrics.filter((m) => m.error !== null).length;
@@ -6328,6 +6347,26 @@ class TelemetryStore {
       entry.count++;
       entry.totalMs += m.totalDurationMs;
     }
+    let totalInputTokens = 0;
+    let totalOutputTokens = 0;
+    let totalCacheReadTokens = 0;
+    let totalCacheCreationTokens = 0;
+    let cacheHitRateSum = 0;
+    let cacheHitRateCount = 0;
+    let cacheMissOnResumeCount = 0;
+    for (const m of metrics) {
+      totalInputTokens += m.inputTokens ?? 0;
+      totalOutputTokens += m.outputTokens ?? 0;
+      totalCacheReadTokens += m.cacheReadInputTokens ?? 0;
+      totalCacheCreationTokens += m.cacheCreationInputTokens ?? 0;
+      if (m.cacheHitRate !== undefined) {
+        cacheHitRateSum += m.cacheHitRate;
+        cacheHitRateCount++;
+      }
+      if (m.isResume && m.cacheHitRate !== undefined && m.cacheHitRate === 0) {
+        cacheMissOnResumeCount++;
+      }
+    }
     return {
       windowMs,
       totalRequests: metrics.length,
@@ -6339,7 +6378,15 @@ class TelemetryStore {
       upstreamDuration: computePercentiles(upstreams),
       totalDuration: computePercentiles(totals),
       byModel: Object.fromEntries(Object.entries(byModel).map(([k, v]) => [k, { count: v.count, avgTotalMs: Math.round(v.totalMs / v.count) }])),
-      byMode: Object.fromEntries(Object.entries(byMode).map(([k, v]) => [k, { count: v.count, avgTotalMs: Math.round(v.totalMs / v.count) }]))
+      byMode: Object.fromEntries(Object.entries(byMode).map(([k, v]) => [k, { count: v.count, avgTotalMs: Math.round(v.totalMs / v.count) }])),
+      tokenUsage: {
+        totalInputTokens,
+        totalOutputTokens,
+        totalCacheReadTokens,
+        totalCacheCreationTokens,
+        avgCacheHitRate: cacheHitRateCount > 0 ? Math.round(cacheHitRateSum / cacheHitRateCount * 100) / 100 : 0,
+        cacheMissOnResumeCount
+      }
     };
   }
   clear() {
@@ -6590,7 +6637,7 @@ function render(s, reqs, logs) {
   // Count lineage types for badges
   const lineageCounts = {};
   for (const r of reqs) { const t = r.lineageType || 'unknown'; lineageCounts[t] = (lineageCounts[t] || 0) + 1; }
-  const logCounts = { session: 0, lineage: 0, error: 0 };
+  const logCounts = { session: 0, lineage: 0, error: 0, token: 0 };
   for (const l of logs) { if (logCounts[l.category] !== undefined) logCounts[l.category]++; }
 
   // Tabs
@@ -6615,6 +6662,20 @@ function render(s, reqs, logs) {
     + card('Queue Wait', ms(s.queueWait.p50), 'p95: ' + ms(s.queueWait.p95))
     + '</div>';
 
+  // Token usage cards
+  if (s.tokenUsage) {
+    const t = s.tokenUsage;
+    const fmtTok = n => n > 1000000 ? (n/1000000).toFixed(1) + 'M' : n > 1000 ? Math.round(n/1000) + 'k' : String(n);
+    html += '<div class="section"><div class="section-title">Token Usage</div></div>';
+    html += '<div class="cards">'
+      + card('Input Tokens', fmtTok(t.totalInputTokens), '')
+      + card('Output Tokens', fmtTok(t.totalOutputTokens), '')
+      + card('Cache Read', fmtTok(t.totalCacheReadTokens), '')
+      + card('Cache Write', fmtTok(t.totalCacheCreationTokens), '')
+      + card('Avg Cache Hit', (t.avgCacheHitRate * 100).toFixed(0) + '%', t.cacheMissOnResumeCount > 0 ? t.cacheMissOnResumeCount + ' cache miss on resume' : '')
+      + '</div>';
+  }
+
   // Model breakdown
   const models = Object.entries(s.byModel);
   if (models.length > 0) {
@@ -6658,7 +6719,7 @@ function render(s, reqs, logs) {
     + '<span><span class="legend-dot" style="background:var(--upstream)"></span>Response</span>'
     + '</div>'
     + '<table><thead><tr><th>Time</th><th>Adapter</th><th>Model</th><th>Mode</th><th>Session</th><th>Status</th>'
-    + '<th>Queue</th><th>Proxy</th><th>TTFB</th><th>Total</th><th>Waterfall</th></tr></thead><tbody>';
+    + '<th>Queue</th><th>Proxy</th><th>TTFB</th><th>Total</th><th>Tokens</th><th>Cache</th><th>Waterfall</th></tr></thead><tbody>';
 
   const maxTotal = Math.max(...reqs.map(r => r.totalDurationMs), 1);
 
@@ -6686,6 +6747,8 @@ function render(s, reqs, logs) {
       + '<td class="mono">' + ms(r.proxyOverheadMs) + '</td>'
       + '<td class="mono">' + ms(r.ttfbMs) + '</td>'
       + '<td class="mono">' + ms(r.totalDurationMs) + '</td>'
+      + '<td class="mono">' + (r.inputTokens != null ? (r.inputTokens > 1000 ? Math.round(r.inputTokens/1000) + 'k' : r.inputTokens) + ' in<br>' + (r.outputTokens > 1000 ? Math.round(r.outputTokens/1000) + 'k' : r.outputTokens || 0) + ' out' : '—') + '</td>'
+      + '<td class="mono">' + (r.cacheHitRate != null ? '<span style="color:' + (r.cacheHitRate > 0.5 ? 'var(--green)' : r.cacheHitRate > 0 ? 'var(--yellow)' : 'var(--red)') + '">' + Math.round(r.cacheHitRate * 100) + '%</span>' : '—') + '</td>'
       + '<td><div class="waterfall">'
       + '<div class="waterfall-seg queue" style="width:' + qW + 'px"></div>'
       + '<div class="waterfall-seg overhead" style="width:' + ohW + 'px"></div>'
@@ -6706,6 +6769,7 @@ function render(s, reqs, logs) {
     + '<span class="log-filter' + (activeLogFilter === 'session' ? ' active' : '') + '" data-filter="session" onclick="setLogFilter(&apos;session&apos;)" style="--accent:var(--blue)">Session<span class="tab-badge">' + logCounts.session + '</span></span>'
     + '<span class="log-filter' + (activeLogFilter === 'lineage' ? ' active' : '') + '" data-filter="lineage" onclick="setLogFilter(&apos;lineage&apos;)" style="--accent:var(--purple)">Lineage<span class="tab-badge">' + logCounts.lineage + '</span></span>'
     + '<span class="log-filter' + (activeLogFilter === 'error' ? ' active' : '') + '" data-filter="error" onclick="setLogFilter(&apos;error&apos;)" style="--accent:var(--red)">Error<span class="tab-badge">' + logCounts.error + '</span></span>'
+    + '<span class="log-filter' + (activeLogFilter === 'token' ? ' active' : '') + '" data-filter="token" onclick="setLogFilter(&apos;token&apos;)" style="--accent:var(--yellow)">Token<span class="tab-badge">' + logCounts.token + '</span></span>'
     + '</div>';
 
   if (logs.length === 0) {
@@ -6717,7 +6781,7 @@ function render(s, reqs, logs) {
 
     for (const log of logs) {
       const levelColor = {info:'var(--green)',warn:'var(--yellow)',error:'var(--red)'}[log.level] || 'var(--muted)';
-      const catColor = {session:'var(--blue)',lineage:'var(--purple)',error:'var(--red)',lifecycle:'var(--muted)'}[log.category] || 'var(--muted)';
+      const catColor = {session:'var(--blue)',lineage:'var(--purple)',error:'var(--red)',lifecycle:'var(--muted)',token:'var(--yellow)'}[log.category] || 'var(--muted)';
       const display = (activeLogFilter === 'all' || log.category === activeLogFilter) ? '' : 'display:none';
       html += '<tr class="log-row" data-category="' + log.category + '" style="' + display + '">'
         + '<td class="mono">' + ago(log.timestamp) + '</td>'
@@ -7702,6 +7766,16 @@ var openCodeAdapter = {
   getAllowedMcpTools() {
     return ALLOWED_MCP_TOOLS;
   },
+  usesPassthrough() {
+    const envVal = process.env.MERIDIAN_PASSTHROUGH ?? process.env.CLAUDE_PROXY_PASSTHROUGH;
+    if (envVal === "0" || envVal === "false" || envVal === "no") {
+      return false;
+    }
+    return true;
+  },
+  supportsThinking() {
+    return true;
+  },
   buildSdkAgents(body, mcpToolNames) {
     if (!Array.isArray(body.tools))
       return {};
@@ -13877,6 +13951,50 @@ function filterBetasForProfile(rawBetaHeader, profileType, policy = DEFAULT_BETA
   };
 }
 
+// src/proxy/tokenHealth.ts
+var CONTEXT_SPIKE_THRESHOLD = 0.6;
+var CACHE_MISS_THRESHOLD = 0.05;
+var OUTPUT_EXPLOSION_RATIO = 2;
+var fmt = (n) => n > 1000 ? `${Math.round(n / 1000)}k` : String(n);
+function detectTokenAnomalies(current, previous) {
+  const anomalies = [];
+  if (previous && previous.inputTokens > 0) {
+    const growth = (current.inputTokens - previous.inputTokens) / previous.inputTokens;
+    if (growth > CONTEXT_SPIKE_THRESHOLD) {
+      const pct = Math.round(growth * 100);
+      anomalies.push({
+        type: "context_spike",
+        severity: growth > 2 ? "critical" : "warn",
+        detail: `Input tokens grew ${pct}% in one turn (${fmt(previous.inputTokens)} -> ${fmt(current.inputTokens)}). Possible context leak or full replay.`
+      });
+    }
+  }
+  if (current.isResume && current.cacheHitRate <= CACHE_MISS_THRESHOLD && current.inputTokens > 0) {
+    anomalies.push({
+      type: "cache_miss",
+      severity: "critical",
+      detail: `Cache hit rate ${Math.round(current.cacheHitRate * 100)}% on resume (expected >50%). Prompt caching likely invalidated — check tool ordering or system prompt changes.`
+    });
+  }
+  if (previous && previous.outputTokens > 0 && current.outputTokens > 0) {
+    const ratio = current.outputTokens / previous.outputTokens;
+    if (ratio > OUTPUT_EXPLOSION_RATIO && current.outputTokens > 2000) {
+      anomalies.push({
+        type: "output_explosion",
+        severity: "warn",
+        detail: `Output tokens ${fmt(current.outputTokens)} are ${ratio.toFixed(1)}x the previous turn (${fmt(previous.outputTokens)}).`
+      });
+    }
+  }
+  return anomalies;
+}
+function formatAnomalyAlerts(requestId, anomalies) {
+  return anomalies.map((a) => {
+    const icon = a.severity === "critical" ? "TOKEN ALERT" : "TOKEN WARN";
+    return `[PROXY] ${requestId} ${icon}: ${a.detail}`;
+  });
+}
+
 // src/proxy/session/lineage.ts
 import { createHash as createHash2 } from "crypto";
 var MIN_SUFFIX_FOR_COMPACTION = 2;
@@ -14555,14 +14673,72 @@ function buildFreshPrompt(messages, stripCacheControl) {
 `) || "";
 }
 function logUsage(requestId, usage) {
-  const fmt = (n) => n > 1000 ? `${Math.round(n / 1000)}k` : String(n);
+  const fmt2 = (n) => n > 1000 ? `${Math.round(n / 1000)}k` : String(n);
+  const cacheRead = usage.cache_read_input_tokens ?? 0;
+  const totalInput = usage.input_tokens ?? 0;
+  const cacheRate = totalInput > 0 ? Math.round(cacheRead / totalInput * 100) : 0;
+  const cacheTag = totalInput > 0 ? ` cache=${cacheRate}%` : "";
   const parts = [
-    `input=${fmt(usage.input_tokens ?? 0)}`,
-    `output=${fmt(usage.output_tokens ?? 0)}`,
-    ...usage.cache_read_input_tokens ? [`cache_read=${fmt(usage.cache_read_input_tokens)}`] : [],
-    ...usage.cache_creation_input_tokens ? [`cache_write=${fmt(usage.cache_creation_input_tokens)}`] : []
+    `input=${fmt2(usage.input_tokens ?? 0)}`,
+    `output=${fmt2(usage.output_tokens ?? 0)}`,
+    ...usage.cache_read_input_tokens ? [`cache_read=${fmt2(usage.cache_read_input_tokens)}`] : [],
+    ...usage.cache_creation_input_tokens ? [`cache_write=${fmt2(usage.cache_creation_input_tokens)}`] : []
   ];
-  console.error(`[PROXY] ${requestId} usage: ${parts.join(" ")}`);
+  console.error(`[PROXY] ${requestId} usage: ${parts.join(" ")}${cacheTag}`);
+}
+function computeCacheHitRate(usage) {
+  if (!usage)
+    return;
+  const read = usage.cache_read_input_tokens ?? 0;
+  const creation = usage.cache_creation_input_tokens ?? 0;
+  const uncached = usage.input_tokens ?? 0;
+  const total = uncached + read + creation;
+  if (total === 0)
+    return;
+  return read / total;
+}
+function checkTokenHealth(requestId, sdkSessionId, usage, turnNumber, isResume, isPassthrough) {
+  if (!usage || !sdkSessionId)
+    return;
+  const cacheHitRate = computeCacheHitRate(usage) ?? 0;
+  const current = {
+    requestId,
+    turnNumber,
+    inputTokens: usage.input_tokens ?? 0,
+    outputTokens: usage.output_tokens ?? 0,
+    cacheReadInputTokens: usage.cache_read_input_tokens ?? 0,
+    cacheCreationInputTokens: usage.cache_creation_input_tokens ?? 0,
+    cacheHitRate,
+    isResume,
+    isPassthrough
+  };
+  const prevMetric = telemetryStore.getLastForSession(sdkSessionId);
+  const previous = prevMetric ? {
+    requestId: prevMetric.requestId,
+    turnNumber: turnNumber - 1,
+    inputTokens: prevMetric.inputTokens ?? 0,
+    outputTokens: prevMetric.outputTokens ?? 0,
+    cacheReadInputTokens: prevMetric.cacheReadInputTokens ?? 0,
+    cacheCreationInputTokens: prevMetric.cacheCreationInputTokens ?? 0,
+    cacheHitRate: prevMetric.cacheHitRate ?? 0,
+    isResume: prevMetric.isResume,
+    isPassthrough: prevMetric.isPassthrough
+  } : undefined;
+  const anomalies = detectTokenAnomalies(current, previous);
+  if (anomalies.length > 0) {
+    const alerts = formatAnomalyAlerts(requestId, anomalies);
+    for (const line of alerts) {
+      console.error(line);
+    }
+    for (const a of anomalies) {
+      diagnosticLog.log({
+        level: a.severity === "critical" ? "error" : "warn",
+        category: "token",
+        message: `${requestId} ${a.type}: ${a.detail}`,
+        requestId
+      });
+    }
+  }
 }
 function createProxyServer(config = {}) {
   const finalConfig = { ...DEFAULT_PROXY_CONFIG, ...config };
@@ -15015,7 +15191,7 @@ function createProxyServer(config = {}) {
                 } else {
                   for (const block of message.message.content) {
                     const b = block;
-                    if (passthrough && (b.type === "thinking" || b.type === "redacted_thinking")) {
+                    if (passthrough && !adapter.supportsThinking?.() && (b.type === "thinking" || b.type === "redacted_thinking")) {
                       claudeLog("passthrough.thinking_stripped", { mode: "non_stream", type: b.type });
                       continue;
                     }
@@ -15100,6 +15276,7 @@ Subprocess stderr: ${stderrOutput}`;
             hasToolUse
           });
           const nonStreamQueueWaitMs = requestMeta.queueStartedAt - requestMeta.queueEnteredAt;
+          checkTokenHealth(requestMeta.requestId, currentSessionId || resumeSessionId, lastUsage, allMessages.length, isResume, passthrough);
           telemetryStore.record({
             requestId: requestMeta.requestId,
             timestamp: Date.now(),
@@ -15120,7 +15297,12 @@ Subprocess stderr: ${stderrOutput}`;
             totalDurationMs,
             contentBlocks: contentBlocks.length,
             textEvents: 0,
-            error: null
+            error: null,
+            inputTokens: lastUsage?.input_tokens,
+            outputTokens: lastUsage?.output_tokens,
+            cacheReadInputTokens: lastUsage?.cache_read_input_tokens,
+            cacheCreationInputTokens: lastUsage?.cache_creation_input_tokens,
+            cacheHitRate: computeCacheHitRate(lastUsage)
           });
           if (currentSessionId) {
             storeSession(profileSessionId, body.messages || [], currentSessionId, profileScopedCwd, sdkUuidMap, lastUsage);
@@ -15388,7 +15570,7 @@ data: ${JSON.stringify({ type: "message_stop" })}
                     }
                     if (eventType === "content_block_start") {
                       const block = event.content_block;
-                      if (passthrough && (block?.type === "thinking" || block?.type === "redacted_thinking")) {
+                      if (passthrough && !adapter.supportsThinking?.() && (block?.type === "thinking" || block?.type === "redacted_thinking")) {
                         if (eventIndex !== undefined)
                           skipBlockIndices.add(eventIndex);
                         claudeLog("passthrough.thinking_stripped", { mode: "stream", type: block.type, index: eventIndex });
@@ -15570,6 +15752,7 @@ data: {"type":"message_stop"}
                   textEventsForwarded
                 });
                 const streamQueueWaitMs = requestMeta.queueStartedAt - requestMeta.queueEnteredAt;
+                checkTokenHealth(requestMeta.requestId, currentSessionId || resumeSessionId, lastUsage, allMessages.length, isResume, passthrough);
                 telemetryStore.record({
                   requestId: requestMeta.requestId,
                   timestamp: Date.now(),
@@ -15590,7 +15773,12 @@ data: {"type":"message_stop"}
                   totalDurationMs: streamTotalDurationMs,
                   contentBlocks: eventsForwarded,
                   textEvents: textEventsForwarded,
-                  error: null
+                  error: null,
+                  inputTokens: lastUsage?.input_tokens,
+                  outputTokens: lastUsage?.output_tokens,
+                  cacheReadInputTokens: lastUsage?.cache_read_input_tokens,
+                  cacheCreationInputTokens: lastUsage?.cache_creation_input_tokens,
+                  cacheHitRate: computeCacheHitRate(lastUsage)
                 });
                 if (textEventsForwarded === 0) {
                   claudeLog("response.empty_stream", {

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   startProxyServer
-} from "./cli-trtwsfge.js";
+} from "./cli-b2n69dg7.js";
 import"./cli-g9ypdz51.js";
 import"./cli-rtab0qa6.js";
 import"./cli-m9pfb7h9.js";
@@ -49,7 +49,7 @@ See https://github.com/rynfar/meridian for full documentation.`);
   process.exit(0);
 }
 if (args[0] === "profile") {
-  const { profileAdd, profileList, profileRemove, profileSwitch, profileLogin, profileHelp } = await import("./profileCli-pdqrpw0m.js");
+  const { profileAdd, profileList, profileRemove, profileSwitch, profileLogin, profileHelp } = await import("./profileCli-5e3p99k0.js");
   const subcommand = args[1];
   const profileId = args[2];
   if (subcommand === "add" && profileId)

package/dist/{profileCli-pdqrpw0m.js → profileCli-5e3p99k0.js}

@@ -199,8 +199,8 @@ function profileLogin(id) {
   }
 }
 function promptYesNo(question) {
+  process.stderr.write(`${question} [Y/n] `);
   const result = spawnSync("node", ["-e", [
-    `process.stdout.write(${JSON.stringify(`${question} [Y/n] `)});`,
     `const rl = require("readline").createInterface({ input: process.stdin });`,
     `rl.once("line", (a) => { process.stdout.write(a); rl.close(); });`,
     `rl.once("close", () => process.exit(0));`

package/dist/proxy/adapter.d.ts

@@ -82,6 +82,15 @@ export interface AgentAdapter {
      * When defined, takes precedence over the env var for this agent.
      */
     usesPassthrough?(): boolean;
+    /**
+     * Whether this agent's client can render thinking blocks.
+     *
+     * When true, thinking/redacted_thinking blocks are forwarded in
+     * passthrough mode instead of being stripped.
+     * When false or undefined, they are stripped (safe default for
+     * clients that may choke on the encrypted signature field).
+     */
+    supportsThinking?(): boolean;
     /**
      * Map a client-side tool_use block to file changes (passthrough mode).
      *

package/dist/proxy/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/proxy/adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;;OAGG;IACH,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;IAE5C;;;OAGG;IACH,uBAAuB,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,GAAG,SAAS,CAAA;IAEtD;;;OAGG;IACH,gBAAgB,CAAC,OAAO,EAAE,GAAG,GAAG,MAAM,CAAA;IAEtC;;;OAGG;IACH,sBAAsB,IAAI,SAAS,MAAM,EAAE,CAAA;IAE3C;;;;OAIG;IACH,yBAAyB,IAAI,SAAS,MAAM,EAAE,CAAA;IAE9C;;;OAGG;IACH,gBAAgB,IAAI,MAAM,CAAA;IAE1B;;OAEG;IACH,kBAAkB,IAAI,SAAS,MAAM,EAAE,CAAA;IAEvC;;;;OAIG;IACH,cAAc,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,YAAY,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAEhF;;;OAGG;IACH,aAAa,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,CAAA;IAE9D;;;OAGG;IACH,0BAA0B,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAA;IAE9E;;;;;;OAMG;IACH,gBAAgB,CAAC,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAA;IAErC;;;;;;;;OAQG;IACH,eAAe,CAAC,IAAI,OAAO,CAAA;IAE3B;;;;;;;;;;;;;;;OAeG;IACH,6BAA6B,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,eAAe,EAAE,UAAU,EAAE,CAAA;CAC3G"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/proxy/adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;;OAGG;IACH,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;IAE5C;;;OAGG;IACH,uBAAuB,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,GAAG,SAAS,CAAA;IAEtD;;;OAGG;IACH,gBAAgB,CAAC,OAAO,EAAE,GAAG,GAAG,MAAM,CAAA;IAEtC;;;OAGG;IACH,sBAAsB,IAAI,SAAS,MAAM,EAAE,CAAA;IAE3C;;;;OAIG;IACH,yBAAyB,IAAI,SAAS,MAAM,EAAE,CAAA;IAE9C;;;OAGG;IACH,gBAAgB,IAAI,MAAM,CAAA;IAE1B;;OAEG;IACH,kBAAkB,IAAI,SAAS,MAAM,EAAE,CAAA;IAEvC;;;;OAIG;IACH,cAAc,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,YAAY,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAEhF;;;OAGG;IACH,aAAa,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,CAAA;IAE9D;;;OAGG;IACH,0BAA0B,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAA;IAE9E;;;;;;OAMG;IACH,gBAAgB,CAAC,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAA;IAErC;;;;;;;;OAQG;IACH,eAAe,CAAC,IAAI,OAAO,CAAA;IAE3B;;;;;;;OAOG;IACH,gBAAgB,CAAC,IAAI,OAAO,CAAA;IAE5B;;;;;;;;;;;;;;;OAeG;IACH,6BAA6B,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,eAAe,EAAE,UAAU,EAAE,CAAA;CAC3G"}

package/dist/proxy/adapters/opencode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"opencode.d.ts","sourceRoot":"","sources":["../../../src/proxy/adapters/opencode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAQ9C,eAAO,MAAM,eAAe,EAAE,YAqG7B,CAAA"}
+{"version":3,"file":"opencode.d.ts","sourceRoot":"","sources":["../../../src/proxy/adapters/opencode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAQ9C,eAAO,MAAM,eAAe,EAAE,YAiH7B,CAAA"}

package/dist/proxy/passthroughTools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"passthroughTools.d.ts","sourceRoot":"","sources":["../../src/proxy/passthroughTools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,eAAO,MAAM,oBAAoB,OAAO,CAAA;AACxC,eAAO,MAAM,sBAAsB,cAAmC,CAAA;AAsCtE;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,GAAG,CAAA;CAAE,CAAC;;;EAsCzE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKvD"}
+{"version":3,"file":"passthroughTools.d.ts","sourceRoot":"","sources":["../../src/proxy/passthroughTools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,eAAO,MAAM,oBAAoB,OAAO,CAAA;AACxC,eAAO,MAAM,sBAAsB,cAAmC,CAAA;AAsCtE;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,GAAG,CAAA;CAAE,CAAC;;;EA2CzE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKvD"}

package/dist/proxy/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/proxy/server.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACtE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,CAAA;AAsBvD,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,KAAK,aAAa,EAEnB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAA+B,iBAAiB,EAAE,mBAAmB,EAAsC,MAAM,iBAAiB,CAAA;AAGzI,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAA;AAChE,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,CAAA;AACjD,YAAY,EAAE,aAAa,EAAE,CAAA;AAoG7B,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,WAAW,CA8pDhF;AAED,wBAAsB,gBAAgB,CAAC,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAiEhG"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/proxy/server.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACtE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,CAAA;AAuBvD,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,KAAK,aAAa,EAEnB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAA+B,iBAAiB,EAAE,mBAAmB,EAAsC,MAAM,iBAAiB,CAAA;AAGzI,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAA;AAChE,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,CAAA;AACjD,YAAY,EAAE,aAAa,EAAE,CAAA;AAyK7B,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,WAAW,CAyrDhF;AAED,wBAAsB,gBAAgB,CAAC,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAiEhG"}

package/dist/proxy/tokenHealth.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Token health anomaly detection.
+ *
+ * Pure functions that compare consecutive turn token snapshots
+ * and classify abnormal patterns. No I/O, no imports from server.ts.
+ */
+export interface TokenSnapshot {
+    requestId: string;
+    turnNumber: number;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadInputTokens: number;
+    cacheCreationInputTokens: number;
+    cacheHitRate: number;
+    isResume: boolean;
+    isPassthrough: boolean;
+}
+export interface TokenAnomaly {
+    type: "context_spike" | "cache_miss" | "output_explosion";
+    severity: "warn" | "critical";
+    detail: string;
+}
+/**
+ * Compare a current turn's token snapshot against the previous turn.
+ * Returns an array of detected anomalies (empty if everything looks normal).
+ */
+export declare function detectTokenAnomalies(current: TokenSnapshot, previous: TokenSnapshot | undefined): TokenAnomaly[];
+/**
+ * Format anomalies as stderr log lines.
+ */
+export declare function formatAnomalyAlerts(requestId: string, anomalies: TokenAnomaly[]): string[];
+//# sourceMappingURL=tokenHealth.d.ts.map

package/dist/proxy/tokenHealth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenHealth.d.ts","sourceRoot":"","sources":["../../src/proxy/tokenHealth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,wBAAwB,EAAE,MAAM,CAAA;IAChC,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,OAAO,CAAA;IACjB,aAAa,EAAE,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,eAAe,GAAG,YAAY,GAAG,kBAAkB,CAAA;IACzD,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAA;IAC7B,MAAM,EAAE,MAAM,CAAA;CACf;AAaD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,aAAa,GAAG,SAAS,GAClC,YAAY,EAAE,CAsChB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAK1F"}

package/dist/server.js

@@ -6,7 +6,7 @@ import {
   getMaxSessionsLimit,
   hashMessage,
   startProxyServer
-} from "./cli-trtwsfge.js";
+} from "./cli-b2n69dg7.js";
 import"./cli-g9ypdz51.js";
 import"./cli-rtab0qa6.js";
 import"./cli-m9pfb7h9.js";

package/dist/telemetry/dashboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../src/telemetry/dashboard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,eAAO,MAAM,aAAa,QA4UlB,CAAA"}
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../src/telemetry/dashboard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,eAAO,MAAM,aAAa,QA6VlB,CAAA"}

package/dist/telemetry/logStore.d.ts

@@ -11,7 +11,7 @@ export interface DiagnosticLog {
     /** Log level */
     level: "info" | "warn" | "error";
     /** Log category for filtering */
-    category: "session" | "lineage" | "error" | "lifecycle";
+    category: "session" | "lineage" | "error" | "lifecycle" | "token";
     /** Request ID (if associated with a request) */
     requestId?: string;
     /** Human-readable message */

package/dist/telemetry/logStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logStore.d.ts","sourceRoot":"","sources":["../../src/telemetry/logStore.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,aAAa;IAC5B,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,gBAAgB;IAChB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;IAChC,iCAAiC;IACjC,QAAQ,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAA;IACvD,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAA;CAChB;AAID,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,IAAI,CAAI;IAChB,OAAO,CAAC,KAAK,CAAI;IACjB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;gBAErB,QAAQ,CAAC,EAAE,MAAM;IAK7B,0BAA0B;IAC1B,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,GAAG,IAAI;IAMlD,wCAAwC;IACxC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAIlD,qEAAqE;IACrE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAIlD,iCAAiC;IACjC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAIhD;;;;;OAKG;IACH,SAAS,CAAC,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,aAAa,EAAE;IAgB/F,6BAA6B;IAC7B,KAAK,IAAI,IAAI;CAKd;AAED,4CAA4C;AAC5C,eAAO,MAAM,aAAa,oBAA2B,CAAA"}
+{"version":3,"file":"logStore.d.ts","sourceRoot":"","sources":["../../src/telemetry/logStore.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,aAAa;IAC5B,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,gBAAgB;IAChB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;IAChC,iCAAiC;IACjC,QAAQ,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,CAAA;IACjE,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAA;CAChB;AAID,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,IAAI,CAAI;IAChB,OAAO,CAAC,KAAK,CAAI;IACjB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;gBAErB,QAAQ,CAAC,EAAE,MAAM;IAK7B,0BAA0B;IAC1B,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,GAAG,IAAI;IAMlD,wCAAwC;IACxC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAIlD,qEAAqE;IACrE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAIlD,iCAAiC;IACjC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAIhD;;;;;OAKG;IACH,SAAS,CAAC,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,aAAa,EAAE;IAgB/F,6BAA6B;IAC7B,KAAK,IAAI,IAAI;CAKd;AAED,4CAA4C;AAC5C,eAAO,MAAM,aAAa,oBAA2B,CAAA"}

package/dist/telemetry/store.d.ts

@@ -26,6 +26,9 @@ export declare class TelemetryStore {
         since?: number;
         model?: string;
     }): RequestMetric[];
+    /** Find the most recent successful metric for a given SDK session ID.
+     *  Used by anomaly detection to compare consecutive turns. */
+    getLastForSession(sdkSessionId: string): RequestMetric | undefined;
     /**
      * Compute aggregate statistics over a time window.
      * @param windowMs - Time window in ms (default: 1 hour)

package/dist/telemetry/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/telemetry/store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAe,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAY3E,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,IAAI,CAAI;IAChB,OAAO,CAAC,KAAK,CAAI;IACjB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;gBAErB,QAAQ,CAAC,EAAE,MAAM;IAK7B,yCAAyC;IACzC,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAMnC,8CAA8C;IAC9C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;OAKG;IACH,SAAS,CAAC,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,aAAa,EAAE;IAiB5F;;;OAGG;IACH,SAAS,CAAC,QAAQ,GAAE,MAAuB,GAAG,gBAAgB;IAwE9D,gCAAgC;IAChC,KAAK,IAAI,IAAI;CAKd;AAkBD,kDAAkD;AAClD,eAAO,MAAM,cAAc,gBAAuB,CAAA"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/telemetry/store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAe,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAY3E,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,IAAI,CAAI;IAChB,OAAO,CAAC,KAAK,CAAI;IACjB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;gBAErB,QAAQ,CAAC,EAAE,MAAM;IAK7B,yCAAyC;IACzC,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAMnC,8CAA8C;IAC9C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;OAKG;IACH,SAAS,CAAC,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,aAAa,EAAE;IAiB5F;kEAC8D;IAC9D,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAWlE;;;OAGG;IACH,SAAS,CAAC,QAAQ,GAAE,MAAuB,GAAG,gBAAgB;IAiH9D,gCAAgC;IAChC,KAAK,IAAI,IAAI;CAKd;AAkBD,kDAAkD;AAClD,eAAO,MAAM,cAAc,gBAAuB,CAAA"}

package/dist/telemetry/types.d.ts

@@ -57,6 +57,17 @@ export interface RequestMetric {
     textEvents: number;
     /** Error type if the request failed, null if successful */
     error: string | null;
+    /** Input tokens consumed (from SDK usage) */
+    inputTokens?: number;
+    /** Output tokens generated */
+    outputTokens?: number;
+    /** Input tokens read from prompt cache (lower cost) */
+    cacheReadInputTokens?: number;
+    /** Input tokens written to prompt cache (one-time cost) */
+    cacheCreationInputTokens?: number;
+    /** Cache hit ratio: cacheRead / (cacheRead + cacheCreation + uncached).
+     *  1.0 = perfect caching, 0.0 = no caching. undefined when no token data. */
+    cacheHitRate?: number;
 }
 export interface PhaseTiming {
     p50: number;
@@ -91,5 +102,15 @@ export interface TelemetrySummary {
         count: number;
         avgTotalMs: number;
     }>;
+    /** Aggregate token usage across all requests in the window */
+    tokenUsage: {
+        totalInputTokens: number;
+        totalOutputTokens: number;
+        totalCacheReadTokens: number;
+        totalCacheCreationTokens: number;
+        avgCacheHitRate: number;
+        /** Requests where cache hit rate was 0 despite being a resume */
+        cacheMissOnResumeCount: number;
+    };
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/telemetry/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/telemetry/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAA;IAEjB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAA;IAEjB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAA;IAEb,wFAAwF;IACxF,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,iCAAiC;IACjC,IAAI,EAAE,QAAQ,GAAG,YAAY,CAAA;IAE7B,8CAA8C;IAC9C,QAAQ,EAAE,OAAO,CAAA;IAEjB,0CAA0C;IAC1C,aAAa,EAAE,OAAO,CAAA;IAEtB;;;;;sEAKkE;IAClE,WAAW,CAAC,EAAE,cAAc,GAAG,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,CAAA;IAEzE,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAA;IAEd,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAA;IAEnB;;8CAE0C;IAC1C,eAAe,EAAE,MAAM,CAAA;IAEvB,4DAA4D;IAC5D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAErB,yCAAyC;IACzC,kBAAkB,EAAE,MAAM,CAAA;IAE1B,6DAA6D;IAC7D,eAAe,EAAE,MAAM,CAAA;IAEvB,+CAA+C;IAC/C,aAAa,EAAE,MAAM,CAAA;IAErB,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAA;IAElB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAA;IAChB,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAA;IACrB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAA;IAClB,0BAA0B;IAC1B,iBAAiB,EAAE,MAAM,CAAA;IAEzB,iCAAiC;IACjC,SAAS,EAAE,WAAW,CAAA;IACtB,aAAa,EAAE,WAAW,CAAA;IAC1B,IAAI,EAAE,WAAW,CAAA;IACjB,gBAAgB,EAAE,WAAW,CAAA;IAC7B,aAAa,EAAE,WAAW,CAAA;IAE1B,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC9D,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC9D"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/telemetry/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rynfar/meridian",
-  "version": "1.29.2",
+  "version": "1.30.0",
   "description": "Local Anthropic API powered by your Claude Max subscription. One subscription, every agent.",
   "type": "module",
   "main": "./dist/server.js",