@klars/agentobs 0.1.5 → 0.1.6

package/dist/commands/stats.js

@@ -19,15 +19,39 @@ export async function stats(opts) {
         console.log(JSON.stringify({ summary, tools }, null, 2));
         return;
     }
-    console.log(`
-AgentObs · ${range}
-
-  Cost           ${money(summary.total_cost_usd)}
-  Tool calls     ${summary.tool_calls}
-  Sessions       ${summary.sessions}
-  Errors         ${summary.errors} (${(summary.error_rate * 100).toFixed(1)}%)
-  Blocked        ${summary.blocked}
+    console.log(`
+AgentObs · ${range}
+
+  Cost           ${money(summary.total_cost_usd)}
+  Tool calls     ${summary.tool_calls}
+  Sessions       ${summary.sessions}
+  Errors         ${summary.errors} (${(summary.error_rate * 100).toFixed(1)}%)
+  Blocked        ${summary.blocked}
   Tokens         ${summary.tokens_in.toLocaleString()} in / ${summary.tokens_out.toLocaleString()} out`);
+    // A zero tool-call count next to a non-zero session count is the single most
+    // confusing thing a new user sees - it reads as a broken install. Say which
+    // integration produced the data and what it can and cannot see.
+    if (summary.tool_calls === 0 && summary.coarse_sessions > 0) {
+        const n = summary.coarse_sessions;
+        console.log([
+            '',
+            `  Why the zeros: all ${n} session${n === 1 ? '' : 's'} came from "agentobs run"`,
+            '  (process-wrap), which observes a process from the outside - it records',
+            '  duration and exit code, but cannot see individual tool calls or tokens.',
+            '',
+            '  For per-tool-call detail and cost, use the Claude Code hook (see',
+            '  "agentobs init") or ingest a structured log with "agentobs watch".',
+        ].join(String.fromCharCode(10)));
+    }
+    else if (summary.coarse_sessions > 0 && summary.rich_sessions > 0) {
+        // Mixed data: the totals are real but under-count, since coarse sessions
+        // contribute no tool calls or tokens of their own.
+        console.log([
+            '',
+            `  Note: ${summary.coarse_sessions} of ${summary.sessions} sessions are coarse (process-wrap),`,
+            '  so they add no tool calls or tokens to these totals.',
+        ].join(String.fromCharCode(10)));
+    }
     // State plainly when the cost total is incomplete rather than letting a
     // partial number read as the whole spend.
     if (summary.uncosted_calls > 0) {

package/dist/core/queries.js

@@ -57,6 +57,12 @@ export function getSummary(db, range) {
        FROM tool_calls ${where}`)
         .get(...args);
     const sessions = db.prepare(`SELECT COUNT(*) AS n FROM sessions ${where}`).get(...args);
+    const byFidelity = db
+        .prepare(`SELECT
+         COALESCE(SUM(CASE WHEN fidelity = 'coarse' THEN 1 ELSE 0 END), 0) AS coarse,
+         COALESCE(SUM(CASE WHEN fidelity <> 'coarse' THEN 1 ELSE 0 END), 0) AS rich
+       FROM sessions ${where}`)
+        .get(...args);
     const toolCalls = Number(calls.tool_calls ?? 0);
     const errors = Number(calls.errors ?? 0);
     return {
@@ -72,6 +78,8 @@ export function getSummary(db, range) {
         tokens_in: Number(calls.tokens_in ?? 0),
         tokens_out: Number(calls.tokens_out ?? 0),
         avg_duration_ms: calls.avg_duration_ms === null ? null : Number(calls.avg_duration_ms),
+        coarse_sessions: Number(byFidelity.coarse ?? 0),
+        rich_sessions: Number(byFidelity.rich ?? 0),
         previous: previousPeriod(db, range, since),
     };
 }

package/dist/server/public/app.css

@@ -959,3 +959,21 @@ tbody td:first-child {
 .tile[data-accent='sessions'] .tile-label .i { color: var(--series-3); }
 .tile[data-accent='errors'] .tile-label .i { color: var(--status-critical); }
 .tile[data-accent='blocked'] .tile-label .i { color: var(--status-serious); }
+
+/* The hero note can run to a full explanatory sentence when the data is
+   coarse. Cap its width and keep it under the figure so it wraps tightly
+   instead of stretching the flex row and opening a gap beside the stats. */
+.hero > div:first-child {
+  flex: 1 1 460px;
+  min-width: 0;
+}
+
+.hero-note {
+  max-width: 62ch;
+  line-height: 1.45;
+}
+
+.hero-side {
+  flex: 0 0 auto;
+  align-self: flex-start;
+}

package/dist/server/public/app.js

@@ -106,6 +106,7 @@ async function refresh() {
       fetchJson('/api/sessions'),
     ]);
 
+    state.summary = summary;
     renderSummary(summary);
     state.timeline = timeline;
     drawTimeline();
@@ -130,8 +131,16 @@ function renderSummary(s) {
   // Say plainly when the cost figure is incomplete, rather than presenting a
   // partial total as if it were the whole spend.
   const note = document.getElementById('hero-note');
-  if (s.tool_calls === 0) {
+  if (s.sessions === 0) {
     note.textContent = 'No activity recorded yet.';
+  } else if (s.tool_calls === 0 && s.coarse_sessions > 0) {
+    // Never say "no activity" while the Sessions tile shows a number - that
+    // contradiction reads as a broken install. Name the reason instead.
+    const n = s.coarse_sessions;
+    note.textContent =
+      `${count(n)} coarse session${n === 1 ? '' : 's'} from "agentobs run" — process-wrap sees duration and exit code, not tool calls or tokens. Connect the Claude Code hook for full detail.`;
+  } else if (s.coarse_sessions > 0 && s.rich_sessions > 0) {
+    note.textContent = `${count(s.coarse_sessions)} of ${count(s.sessions)} sessions are coarse, so they add no tool calls or tokens to these totals.`;
   } else if (s.uncosted_calls > 0) {
     note.textContent = `${count(s.uncosted_calls)} call${s.uncosted_calls === 1 ? '' : 's'} have no price for their model — add it to ~/.agentobs/pricing.json to include them.`;
   } else {
@@ -182,7 +191,11 @@ function renderTools(rows) {
   body.replaceChildren();
   if (rows.length === 0) {
     const tr = document.createElement('tr');
-    tr.append(Object.assign(cell('No tool calls recorded yet.', 'empty'), { colSpan: 5 }));
+    const msg =
+      state.summary && state.summary.coarse_sessions > 0
+        ? 'Coarse sessions record no tool calls — connect the Claude Code hook for per-tool detail.'
+        : 'No tool calls recorded yet.';
+    tr.append(Object.assign(cell(msg, 'empty'), { colSpan: 5 }));
     body.append(tr);
     return;
   }
@@ -328,7 +341,13 @@ function drawTimeline() {
     ctx.fillStyle = muted;
     ctx.font = '13px ' + cssVar('--font');
     ctx.textAlign = 'center';
-    ctx.fillText('No activity in this range', cssWidth / 2, cssHeight / 2);
+    // Distinguish "nothing happened" from "the data here cannot have tool
+    // calls", which is what a coarse-only range actually means.
+    const msg =
+      state.summary && state.summary.coarse_sessions > 0
+        ? 'Coarse sessions record no tool calls'
+        : 'No activity in this range';
+    ctx.fillText(msg, cssWidth / 2, cssHeight / 2);
     return;
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@klars/agentobs",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Observability and control layer for AI coding agents - see every tool call, token, and dollar your agents spend, and stop them before they do something risky.",
   "license": "MIT",
   "author": "Klars AI",