@superbased/observer 1.4.17 → 1.4.18

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +28 -7
  2. package/package.json +6 -6
package/README.md CHANGED
@@ -254,11 +254,30 @@ in the help drawer.
254
254
  One row per AI-coding session. Each session has a stable ID, a tool
255
255
  (claude-code / cursor / codex / cline / copilot), a working-directory
256
256
  project, action count, sub-agent action count (when the session
257
- spawned sub-agents via the `Agent` tool), and if `observer score`
258
- has run — quality / errors / redundancy ratios.
259
-
260
- Click a row to open the session-detail modal: action breakdown,
261
- token buckets, cost, recent actions.
257
+ spawned sub-agents via the `Agent` tool), per-session **Tokens** and
258
+ **Cost** columns, and — if `observer score` has run — quality / errors
259
+ / redundancy ratios. The `~` suffix on Cost flags rows whose pricing
260
+ was tier-fallback rather than billing-grade ("accurate" reliability).
261
+
262
+ Click a row to open the session-detail modal:
263
+
264
+ - **Top tiles** — Tool, Started, Actions count (ok/fail), Cost.
265
+ - **Action breakdown** — chart of action_type counts.
266
+ - **Tokens** — the four billing buckets (Net Input / Cache Read /
267
+ Cache Write / Output) for the whole session, per-turn-deduped
268
+ (proxy preferred, JSONL fills gaps).
269
+ - **Per-model breakdown** — when a session uses multiple models
270
+ (Claude Code's main + sub-agent dispatches always do), a row per
271
+ model with its tokens and cost.
272
+ - **Messages** — per-message timeline keyed on the upstream
273
+ Anthropic `msg_xxx`. Each row shows the message id, role, model,
274
+ the message's own token bucket, cost, and a `N ▾` pill that
275
+ expands inline to show the contained tool calls. Toggle radio at
276
+ the top: **Tool messages only** (default — assistant turns with
277
+ ≥1 tool call + user prompts) vs **All messages** (also pure-text
278
+ assistant replies). Requires `observer backfill --message-id`
279
+ on first upgrade for historical sessions to surface their parent
280
+ message ids.
262
281
 
263
282
  ### Actions tab
264
283
 
@@ -619,8 +638,10 @@ Every command supports `--help` for the full surface.
619
638
  | `observer summarize` | Roll-up summary across sessions |
620
639
  | `observer export` | Export DB to xlsx / json |
621
640
  | `observer prune` | Manual retention pass (delete old data) |
622
- | `observer backfill --is-sidechain` | Re-walk JSONL to populate is_sidechain on pre-migration rows |
623
- | `observer backfill --cache-tier` | Re-walk JSONL to populate cache_creation_1h_tokens (added by migration 008) on pre-migration rows. Run once after upgrading to v1.4.16+ to correct historical 1h-tier cache writes that were silently billed at the cheaper 5m rate. Idempotent. |
641
+ | `observer backfill --is-sidechain` | Re-walk JSONL to populate `actions.is_sidechain` (added by migration 010) on pre-migration rows. |
642
+ | `observer backfill --cache-tier` | Re-walk JSONL to populate `cache_creation_1h_tokens` (added by migration 008) on pre-migration rows. Run once after upgrading to v1.4.16+ to correct historical 1h-tier cache writes that were silently billed at the cheaper 5m rate. |
643
+ | `observer backfill --message-id` | Re-walk JSONL to populate `message_id` on `actions` and `token_usage` (added by migration 012). Required by the per-message timeline view in the Sessions modal. |
644
+ | `observer backfill --all` | Run every supported backfill in one invocation. Idempotent — safe to re-run. |
624
645
  | `observer metrics` | Prometheus-format metrics endpoint |
625
646
  | `observer serve` | MCP server (stdio JSON-RPC) — usually invoked by `observer init` registration |
626
647
  | `observer tail` | Live event stream |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@superbased/observer",
3
- "version": "1.4.17",
3
+ "version": "1.4.18",
4
4
  "description": "SuperBased Observer — capture, normalize, compress, and analyze AI coding tool activity across Claude Code, Codex, Cursor, Cline/Roo, and Copilot.",
5
5
  "keywords": [
6
6
  "ai",
@@ -36,11 +36,11 @@
36
36
  "LICENSE"
37
37
  ],
38
38
  "optionalDependencies": {
39
- "@superbased/observer-linux-x64": "1.4.17",
40
- "@superbased/observer-linux-arm64": "1.4.17",
41
- "@superbased/observer-darwin-x64": "1.4.17",
42
- "@superbased/observer-darwin-arm64": "1.4.17",
43
- "@superbased/observer-win32-x64": "1.4.17"
39
+ "@superbased/observer-linux-x64": "1.4.18",
40
+ "@superbased/observer-linux-arm64": "1.4.18",
41
+ "@superbased/observer-darwin-x64": "1.4.18",
42
+ "@superbased/observer-darwin-arm64": "1.4.18",
43
+ "@superbased/observer-win32-x64": "1.4.18"
44
44
  },
45
45
  "scripts": {
46
46
  "test": "node bin/observer.js --version"