@ai-dossier/cli 0.51.0 → 0.53.0

package/dist/usage/collect-opencode.d.ts

@@ -0,0 +1,74 @@
+/**
+ * opencode collector (#769): per-message usage from opencode's SQLite store
+ * (`~/.local/share/opencode/opencode.db`, `message.data` JSON with
+ * `modelID`/`providerID`/`tokens`/`cost`).
+ *
+ * Read-only by construction: the database is opened with `readOnly: true`.
+ * The store can be very large (14 GB observed on hcc) and `message` has no
+ * time index, so the query never scans `message` by time — it selects the
+ * (small) `session` table by `time_updated`, then reads each session's
+ * messages through the `(session_id, time_created, id)` index.
+ *
+ * Uses the built-in `node:sqlite` (Node >= 22.13 unflagged). Where it is
+ * unavailable (Node 20) the collector reports `unavailable` rather than
+ * failing the whole view.
+ */
+import type { UsageRow } from './types';
+/** Session metadata the collector needs. */
+export interface OpenCodeSession {
+    id: string;
+    parent_id: string | null;
+    directory: string | null;
+    title: string | null;
+}
+/** One `message` row as stored (`data` is the JSON payload). */
+export interface OpenCodeMessage {
+    id: string;
+    time_created: number;
+    data: string;
+}
+/** The narrow read surface the collector uses — injectable for tests. */
+export interface OpenCodeReader {
+    sessionsUpdatedSince(sinceMs: number): OpenCodeSession[];
+    messagesSince(sessionId: string, sinceMs: number): OpenCodeMessage[];
+    close(): void;
+}
+export type OpenCodeOpenResult = {
+    status: 'ok';
+    reader: OpenCodeReader;
+} | {
+    status: 'unavailable' | 'error';
+    detail: string;
+};
+/** Default opencode DB path, honouring `OPENCODE_DB` and `XDG_DATA_HOME`. */
+export declare function defaultOpenCodeDbPath(env?: NodeJS.ProcessEnv): string;
+interface SqliteStatement {
+    all(...params: unknown[]): unknown[];
+}
+interface SqliteDatabase {
+    prepare(sql: string): SqliteStatement;
+    close(): void;
+}
+type SqliteModule = {
+    DatabaseSync: new (file: string, options?: {
+        readOnly?: boolean;
+    }) => SqliteDatabase;
+};
+/** `node:sqlite`, or null on a runtime without it. */
+export declare function loadNodeSqlite(): SqliteModule | null;
+/** Open `dbFile` read-only. Never throws. */
+export declare function openOpenCodeDb(dbFile: string, sqlite?: SqliteModule | null): OpenCodeOpenResult;
+export interface OpenCodeCollectOptions {
+    reader: OpenCodeReader;
+    sinceMs: number;
+    untilMs?: number;
+    host: string;
+}
+/**
+ * Usage rows for every assistant message with non-zero tokens in sessions
+ * active since `sinceMs`. A message still streaming (all-zero tokens) is
+ * skipped rather than recorded as a zero row.
+ */
+export declare function collectOpenCode(opts: OpenCodeCollectOptions): UsageRow[];
+export {};
+//# sourceMappingURL=collect-opencode.d.ts.map

package/dist/usage/collect-opencode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-opencode.d.ts","sourceRoot":"","sources":["../../src/usage/collect-opencode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGxC,4CAA4C;AAC5C,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,yEAAyE;AACzE,MAAM,WAAW,cAAc;IAC7B,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,CAAC;IACzD,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,CAAC;IACrE,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,GACxC;IAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAExD,6EAA6E;AAC7E,wBAAgB,qBAAqB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAIlF;AAKD,UAAU,eAAe;IACvB,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;CACtC;AACD,UAAU,cAAc;IACtB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;IACtC,KAAK,IAAI,IAAI,CAAC;CACf;AACD,KAAK,YAAY,GAAG;IAClB,YAAY,EAAE,KAAK,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,cAAc,CAAC;CACtF,CAAC;AAEF,sDAAsD;AACtD,wBAAgB,cAAc,IAAI,YAAY,GAAG,IAAI,CAoBpD;AAED,6CAA6C;AAC7C,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,YAAY,GAAG,IAAuB,GAC7C,kBAAkB,CAwCpB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,sBAAsB,GAAG,QAAQ,EAAE,CAyDxE"}

package/dist/usage/collect-opencode.js

@@ -0,0 +1,198 @@
+"use strict";
+/**
+ * opencode collector (#769): per-message usage from opencode's SQLite store
+ * (`~/.local/share/opencode/opencode.db`, `message.data` JSON with
+ * `modelID`/`providerID`/`tokens`/`cost`).
+ *
+ * Read-only by construction: the database is opened with `readOnly: true`.
+ * The store can be very large (14 GB observed on hcc) and `message` has no
+ * time index, so the query never scans `message` by time — it selects the
+ * (small) `session` table by `time_updated`, then reads each session's
+ * messages through the `(session_id, time_created, id)` index.
+ *
+ * Uses the built-in `node:sqlite` (Node >= 22.13 unflagged). Where it is
+ * unavailable (Node 20) the collector reports `unavailable` rather than
+ * failing the whole view.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultOpenCodeDbPath = defaultOpenCodeDbPath;
+exports.loadNodeSqlite = loadNodeSqlite;
+exports.openOpenCodeDb = openOpenCodeDb;
+exports.collectOpenCode = collectOpenCode;
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const util_1 = require("./util");
+/** Default opencode DB path, honouring `OPENCODE_DB` and `XDG_DATA_HOME`. */
+function defaultOpenCodeDbPath(env = process.env) {
+    if (env.OPENCODE_DB)
+        return env.OPENCODE_DB;
+    const dataHome = env.XDG_DATA_HOME || path.join(os.homedir(), '.local', 'share');
+    return path.join(dataHome, 'opencode', 'opencode.db');
+}
+/** How far before the window start messages are read (a long-running message completes later than it is created). */
+const MESSAGE_SLACK_MS = 60 * 60 * 1000;
+/** `node:sqlite`, or null on a runtime without it. */
+function loadNodeSqlite() {
+    try {
+        // Lazy: a static import would crash the whole CLI on Node 20.
+        // Node 22.13–22.x still emits an ExperimentalWarning on first load; it
+        // would land on stderr of every `ai-dossier run` inside opencode. Drop
+        // just that one warning while loading.
+        const emit = process.emitWarning;
+        process.emitWarning = ((warning, ...rest) => {
+            const text = typeof warning === 'string' ? warning : warning.message;
+            if (/sqlite/i.test(text))
+                return;
+            return emit.call(process, warning, ...rest);
+        });
+        try {
+            return require('node:sqlite');
+        }
+        finally {
+            process.emitWarning = emit;
+        }
+    }
+    catch {
+        return null;
+    }
+}
+/** Open `dbFile` read-only. Never throws. */
+function openOpenCodeDb(dbFile, sqlite = loadNodeSqlite()) {
+    if (!fs.existsSync(dbFile))
+        return { status: 'unavailable', detail: `no database at ${dbFile}` };
+    if (!sqlite) {
+        return {
+            status: 'unavailable',
+            detail: `node:sqlite not available in Node ${process.versions.node} (needs >= 22.13)`,
+        };
+    }
+    let db;
+    try {
+        db = new sqlite.DatabaseSync(dbFile, { readOnly: true });
+    }
+    catch (err) {
+        return { status: 'error', detail: `cannot open ${dbFile}: ${err.message}` };
+    }
+    let sessions;
+    let messages;
+    try {
+        sessions = db.prepare('SELECT id, parent_id, directory, title FROM session WHERE time_updated >= ?');
+        // `time_created` bound is widened by MESSAGE_SLACK_MS: a row's timestamp is
+        // its COMPLETION time, so a message created just before the window and
+        // completed inside it must still be read; the collector re-filters exactly.
+        messages = db.prepare('SELECT id, time_created, data FROM message WHERE session_id = ? AND time_created >= ? ORDER BY time_created');
+    }
+    catch (err) {
+        // Not an opencode store of the expected shape (other version / wrong file).
+        db.close();
+        return { status: 'error', detail: `unexpected schema in ${dbFile}: ${err.message}` };
+    }
+    return {
+        status: 'ok',
+        reader: {
+            sessionsUpdatedSince: (sinceMs) => sessions.all(sinceMs),
+            messagesSince: (sessionId, sinceMs) => messages.all(sessionId, sinceMs - MESSAGE_SLACK_MS),
+            close: () => db.close(),
+        },
+    };
+}
+/**
+ * Usage rows for every assistant message with non-zero tokens in sessions
+ * active since `sinceMs`. A message still streaming (all-zero tokens) is
+ * skipped rather than recorded as a zero row.
+ */
+function collectOpenCode(opts) {
+    const rows = [];
+    const untilMs = opts.untilMs ?? Number.POSITIVE_INFINITY;
+    for (const session of opts.reader.sessionsUpdatedSince(opts.sinceMs)) {
+        for (const message of opts.reader.messagesSince(session.id, opts.sinceMs)) {
+            let data;
+            try {
+                data = JSON.parse(message.data);
+            }
+            catch {
+                continue;
+            }
+            if (data.role !== 'assistant')
+                continue;
+            const tokens = (data.tokens ?? {});
+            const cache = (tokens.cache ?? {});
+            const input = (0, util_1.count)(tokens.input);
+            const output = (0, util_1.count)(tokens.output);
+            const reasoning = (0, util_1.count)(tokens.reasoning);
+            const cache_read = (0, util_1.count)(cache.read);
+            const cache_write = (0, util_1.count)(cache.write);
+            if (input + output + reasoning + cache_read + cache_write === 0)
+                continue;
+            const time = (data.time ?? {});
+            const tsMs = typeof time.completed === 'number' ? time.completed : message.time_created;
+            if (tsMs < opts.sinceMs || tsMs >= untilMs)
+                continue;
+            const pathInfo = (data.path ?? {});
+            const cwd = typeof pathInfo.cwd === 'string' ? pathInfo.cwd : session.directory;
+            const providerID = typeof data.providerID === 'string' ? data.providerID : null;
+            const modelID = typeof data.modelID === 'string' ? data.modelID : null;
+            const issue = (0, util_1.issueFromRef)(cwd ? path.basename(cwd) : null);
+            rows.push({
+                ts: new Date(tsMs).toISOString(),
+                host: opts.host,
+                provider: providerID ?? 'opencode',
+                // `provider/model` — the same id shape opencode's own `-m` flag takes.
+                model: modelID ? (providerID ? `${providerID}/${modelID}` : modelID) : null,
+                input,
+                output,
+                reasoning,
+                cache_read,
+                cache_write,
+                cost_usd: typeof data.cost === 'number' ? data.cost : null,
+                source: 'opencode',
+                session_id: session.id,
+                parent_session_id: session.parent_id ?? null,
+                title: session.title,
+                cwd,
+                project: (0, util_1.projectOf)(cwd),
+                branch: null,
+                issue,
+                issue_source: issue === null ? null : 'branch',
+                batch: null,
+                unit: null,
+            });
+        }
+    }
+    return rows;
+}
+//# sourceMappingURL=collect-opencode.js.map

package/dist/usage/collect-opencode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-opencode.js","sourceRoot":"","sources":["../../src/usage/collect-opencode.ts"],"names":[],"mappings":"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"}

package/dist/usage/host-session.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Resolve the agent host an `ai-dossier run` was invoked from — session id
+ * and the model it is running — so `runs.jsonl` records a concrete model
+ * instead of null (#769, "fix at the source").
+ *
+ * ~99% of `runs.jsonl` rows are `llm: auto` invocations made BY a host agent
+ * (Claude Code, opencode) that then follows the printed dossier itself; no
+ * agent is spawned, so nothing reported a model. The host's own store knows
+ * it:
+ *
+ * - Claude Code exports `CLAUDE_CODE_SESSION_ID`; its transcript
+ *   (`~/.claude/projects/<slug>/<id>.jsonl`, or a subagent's under
+ *   `<id>/subagents/`) records each assistant message's resolved `model`.
+ *   Subagents share the parent's id, so the caller is the transcript whose
+ *   newest tool call is a still-pending `ai-dossier run` (else the recently
+ *   active transcripts' model when they all agree; null when they don't).
+ * - Both markers are inherited by child processes, so the NEAREST host
+ *   ancestor (`CLAUDE_PID` / `OPENCODE_PID` via /proc) wins.
+ * - opencode exports `OPENCODE=1` but no session id; the newest session for
+ *   this working directory in opencode.db (updated in the last few minutes)
+ *   is the caller.
+ *
+ * Best effort and bounded: every failure yields nulls, never an exception.
+ */
+export interface HostSession {
+    agent: 'claude-code' | 'opencode' | null;
+    session_id: string | null;
+    model: string | null;
+}
+/** The last real (non-synthetic) assistant `message.model` in a transcript's tail. */
+export declare function lastAssistantModel(transcript: string): string | null;
+/** Newest transcript file (main or subagent) belonging to `sessionId`, or null. */
+export declare function findClaudeTranscript(projectsDir: string, sessionId: string): string | null;
+/**
+ * Whether a transcript's newest tool call is a still-pending `ai-dossier run`
+ * — i.e. this transcript's agent is the one executing us right now: the
+ * command is in a `tool_use` block whose `tool_result` has not been written.
+ */
+export declare function hasPendingDossierRun(transcript: string): boolean;
+/**
+ * The model of the Claude Code agent invoking us. Subagents share their
+ * parent's `CLAUDE_CODE_SESSION_ID`, so "newest transcript" alone can pick a
+ * concurrent sibling: prefer the one transcript with a pending `ai-dossier
+ * run` call; otherwise accept the recently-active candidates' model only when
+ * they all agree — a guess between different models records null.
+ */
+export declare function claudeHostModel(projectsDir: string, sessionId: string): string | null;
+/**
+ * How many generations up `pid` is from this process: a number when it is a
+ * proven ancestor, null when it provably is not (an inherited env marker from
+ * an unrelated outer host), UNKNOWN_DEPTH when it cannot be told.
+ */
+export declare function ancestorDepth(pidText: string | undefined, self?: number): number | null;
+export interface DetectHostOptions {
+    env?: NodeJS.ProcessEnv;
+    cwd?: string;
+    nowMs?: number;
+    claudeProjectsDir?: string;
+    opencodeDb?: string;
+}
+/** Identify the invoking agent host, its session, and its current model. Never throws. */
+export declare function detectHostSession(opts?: DetectHostOptions): HostSession;
+//# sourceMappingURL=host-session.d.ts.map

package/dist/usage/host-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-session.d.ts","sourceRoot":"","sources":["../../src/usage/host-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAQH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,aAAa,GAAG,UAAU,GAAG,IAAI,CAAC;IACzC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AA2BD,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAqBpE;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgB1F;AA4BD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CA+BhE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWrF;AAkBD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,GAAE,MAAoB,GACzB,MAAM,GAAG,IAAI,CASf;AA2CD,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,iBAAsB,GAAG,WAAW,CAiC3E"}