@ai-dossier/cli 0.49.2 → 0.53.0

package/dist/usage/host-session.js

@@ -0,0 +1,325 @@
+"use strict";
+/**
+ * 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.
+ */
+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.lastAssistantModel = lastAssistantModel;
+exports.findClaudeTranscript = findClaudeTranscript;
+exports.hasPendingDossierRun = hasPendingDossierRun;
+exports.claudeHostModel = claudeHostModel;
+exports.ancestorDepth = ancestorDepth;
+exports.detectHostSession = detectHostSession;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const collect_claude_1 = require("./collect-claude");
+const collect_opencode_1 = require("./collect-opencode");
+const util_1 = require("./util");
+const NONE = { agent: null, session_id: null, model: null };
+/** Bytes read from a transcript's tail when looking for the latest model. */
+const TAIL_BYTES = 256 * 1024;
+/** An opencode session older than this is not the one invoking us. */
+const OPENCODE_RECENT_MS = 10 * 60 * 1000;
+const CLAUDE_SESSION_RE = /^[0-9a-f-]{36}$/i;
+function tail(file, bytes) {
+    let fd = null;
+    try {
+        const size = fs.statSync(file).size;
+        const start = Math.max(0, size - bytes);
+        const buffer = Buffer.allocUnsafe(size - start);
+        fd = fs.openSync(file, 'r');
+        const read = fs.readSync(fd, buffer, 0, buffer.length, start);
+        return buffer.subarray(0, read).toString('utf-8');
+    }
+    catch {
+        return '';
+    }
+    finally {
+        if (fd !== null)
+            fs.closeSync(fd);
+    }
+}
+/** The last real (non-synthetic) assistant `message.model` in a transcript's tail. */
+function lastAssistantModel(transcript) {
+    const lines = tail(transcript, TAIL_BYTES).split('\n');
+    for (let i = lines.length - 1; i >= 0; i--) {
+        const line = lines[i];
+        if (!line.includes('"assistant"') || !line.includes('"model"'))
+            continue;
+        try {
+            const record = JSON.parse(line);
+            const model = record?.message?.model;
+            if (record?.type === 'assistant' &&
+                typeof model === 'string' &&
+                model &&
+                model !== '<synthetic>') {
+                return model;
+            }
+        }
+        catch {
+            // partial first line of the tail window, or a malformed line
+        }
+    }
+    return null;
+}
+/** Newest transcript file (main or subagent) belonging to `sessionId`, or null. */
+function findClaudeTranscript(projectsDir, sessionId) {
+    let best = null;
+    const consider = (file) => {
+        const mtime = (0, util_1.mtimeMs)(file);
+        if (mtime !== null && (!best || mtime > best.mtime))
+            best = { file, mtime };
+    };
+    for (const project of (0, util_1.safeReaddir)(projectsDir)) {
+        if (!project.isDirectory())
+            continue;
+        const dir = path.join(projectsDir, project.name);
+        consider(path.join(dir, `${sessionId}.jsonl`));
+        const subDir = path.join(dir, sessionId, 'subagents');
+        for (const sub of (0, util_1.safeReaddir)(subDir)) {
+            if (sub.isFile() && sub.name.endsWith('.jsonl'))
+                consider(path.join(subDir, sub.name));
+        }
+    }
+    return best?.file ?? null;
+}
+/** Transcripts written within this long of the newest one are "concurrently active" candidates. */
+const ACTIVE_WINDOW_MS = 2 * 60 * 1000;
+const DOSSIER_RUN_RE = /\b(?:ai-)?dossier\s+run\b/;
+/** Every transcript (main + subagents) of `sessionId`, with mtimes. */
+function claudeTranscripts(projectsDir, sessionId) {
+    const out = [];
+    const consider = (file) => {
+        const mtime = (0, util_1.mtimeMs)(file);
+        if (mtime !== null)
+            out.push({ file, mtime });
+    };
+    for (const project of (0, util_1.safeReaddir)(projectsDir)) {
+        if (!project.isDirectory())
+            continue;
+        const dir = path.join(projectsDir, project.name);
+        consider(path.join(dir, `${sessionId}.jsonl`));
+        const subDir = path.join(dir, sessionId, 'subagents');
+        for (const sub of (0, util_1.safeReaddir)(subDir)) {
+            if (sub.isFile() && sub.name.endsWith('.jsonl'))
+                consider(path.join(subDir, sub.name));
+        }
+    }
+    return out;
+}
+/**
+ * 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.
+ */
+function hasPendingDossierRun(transcript) {
+    const lines = tail(transcript, TAIL_BYTES).split('\n');
+    const answered = new Set();
+    for (let i = lines.length - 1; i >= 0; i--) {
+        const line = lines[i];
+        if (!line.includes('tool_'))
+            continue;
+        let record;
+        try {
+            record = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        const content = Array.isArray(record.message?.content) ? record.message.content : [];
+        for (const block of content) {
+            if (block?.type === 'tool_result' && typeof block.tool_use_id === 'string') {
+                answered.add(block.tool_use_id);
+            }
+            if (block?.type === 'tool_use' && typeof block.id === 'string' && !answered.has(block.id)) {
+                const command = block.input?.command;
+                if (typeof command === 'string' && DOSSIER_RUN_RE.test(command))
+                    return true;
+            }
+        }
+        if (record.type === 'assistant' &&
+            content.some((b) => b?.type === 'tool_use')) {
+            // Only the newest tool-calling turn can be the one invoking us.
+            return false;
+        }
+    }
+    return false;
+}
+/**
+ * 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.
+ */
+function claudeHostModel(projectsDir, sessionId) {
+    const all = claudeTranscripts(projectsDir, sessionId);
+    if (all.length === 0)
+        return null;
+    const newest = Math.max(...all.map((t) => t.mtime));
+    const active = all.filter((t) => t.mtime >= newest - ACTIVE_WINDOW_MS);
+    const pending = active.filter((t) => hasPendingDossierRun(t.file));
+    if (pending.length === 1)
+        return lastAssistantModel(pending[0].file);
+    const pool = pending.length > 1 ? pending : active;
+    const models = new Set(pool.map((t) => lastAssistantModel(t.file)));
+    if (models.size !== 1)
+        return null;
+    return [...models][0];
+}
+/** `/proc/<pid>/stat` parent pid, or null (non-Linux, gone, unreadable). */
+function parentPid(pid) {
+    try {
+        const stat = fs.readFileSync(`/proc/${pid}/stat`, 'utf-8');
+        // comm (field 2) may contain spaces/parens — parse after the LAST ')'.
+        const fields = stat.slice(stat.lastIndexOf(')') + 2).split(' ');
+        const ppid = Number.parseInt(fields[1], 10);
+        return Number.isFinite(ppid) ? ppid : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Sentinel depth for "cannot tell" (no pid given, or no /proc): trusted, but loses to a proven ancestor. */
+const UNKNOWN_DEPTH = Number.MAX_SAFE_INTEGER;
+/**
+ * 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.
+ */
+function ancestorDepth(pidText, self = process.pid) {
+    const pid = pidText ? Number.parseInt(pidText, 10) : Number.NaN;
+    if (!Number.isFinite(pid) || !fs.existsSync(`/proc/${self}/stat`))
+        return UNKNOWN_DEPTH;
+    let current = self;
+    for (let depth = 0; depth < 64 && current !== null && current > 1; depth++) {
+        if (current === pid)
+            return depth;
+        current = parentPid(current);
+    }
+    return null;
+}
+function openCodeSession(dbFile, cwd, nowMs) {
+    const base = { agent: 'opencode', session_id: null, model: null };
+    const sqlite = (0, collect_opencode_1.loadNodeSqlite)();
+    if (!sqlite || !fs.existsSync(dbFile))
+        return base;
+    try {
+        const db = new sqlite.DatabaseSync(dbFile, { readOnly: true });
+        try {
+            const session = db
+                .prepare('SELECT id FROM session WHERE directory = ? AND time_updated >= ? ORDER BY time_updated DESC LIMIT 1')
+                .all(cwd, nowMs - OPENCODE_RECENT_MS)[0];
+            if (!session?.id)
+                return base;
+            const message = db
+                .prepare('SELECT data FROM message WHERE session_id = ? ORDER BY time_created DESC LIMIT 20')
+                .all(session.id);
+            for (const { data } of message) {
+                try {
+                    const parsed = JSON.parse(data);
+                    if (parsed?.role === 'assistant' && typeof parsed.modelID === 'string') {
+                        const model = typeof parsed.providerID === 'string'
+                            ? `${parsed.providerID}/${parsed.modelID}`
+                            : parsed.modelID;
+                        return { ...base, session_id: session.id, model };
+                    }
+                }
+                catch {
+                    // skip malformed payloads
+                }
+            }
+            return { ...base, session_id: session.id };
+        }
+        finally {
+            db.close();
+        }
+    }
+    catch {
+        return base;
+    }
+}
+/** Identify the invoking agent host, its session, and its current model. Never throws. */
+function detectHostSession(opts = {}) {
+    const env = opts.env ?? process.env;
+    try {
+        // Child processes inherit BOTH hosts' markers (e.g. an opencode agent
+        // dispatched by a sched daemon started from a Claude Code shell), so pick
+        // the NEAREST host ancestor, not whichever marker is checked first.
+        const claudeDepth = env.CLAUDECODE === '1' || env.CLAUDE_CODE === '1' ? ancestorDepth(env.CLAUDE_PID) : null;
+        const opencodeDepth = env.OPENCODE === '1' ? ancestorDepth(env.OPENCODE_PID) : null;
+        const useClaude = claudeDepth !== null && (opencodeDepth === null || claudeDepth <= opencodeDepth);
+        if (useClaude) {
+            const id = env.CLAUDE_CODE_SESSION_ID;
+            if (!id || !CLAUDE_SESSION_RE.test(id)) {
+                return { agent: 'claude-code', session_id: null, model: null };
+            }
+            return {
+                agent: 'claude-code',
+                session_id: id,
+                model: claudeHostModel(opts.claudeProjectsDir ?? (0, collect_claude_1.defaultClaudeProjectsDir)(env), id),
+            };
+        }
+        if (opencodeDepth !== null) {
+            return openCodeSession(opts.opencodeDb ?? (0, collect_opencode_1.defaultOpenCodeDbPath)(env), opts.cwd ?? process.cwd(), opts.nowMs ?? Date.now());
+        }
+    }
+    catch {
+        // fall through
+    }
+    return NONE;
+}
+//# sourceMappingURL=host-session.js.map

package/dist/usage/host-session.js.map

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

package/dist/usage/ledger.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Ledger assembly + aggregation for `ai-dossier usage` (#769).
+ *
+ * `collectLedger` runs every collector for a time range and joins the
+ * attribution sources; the pure functions below turn rows into the views'
+ * numbers (so they are unit-testable without any store on disk).
+ */
+import { type OpenCodeOpenResult } from './collect-opencode';
+import type { Ledger, LimitEvent, UsageRow } from './types';
+/** Where each store lives — defaults resolve from the environment; tests point them at fixtures. */
+export interface LedgerPaths {
+    claudeProjectsDir: string;
+    opencodeDb: string;
+    schedRoot: string;
+    runsLog: string;
+}
+export declare function defaultLedgerPaths(env?: NodeJS.ProcessEnv): LedgerPaths;
+export interface CollectOptions {
+    sinceMs: number;
+    untilMs: number;
+    paths: LedgerPaths;
+    host?: string;
+    /** Override how opencode.db is opened (tests). */
+    openOpenCode?: (dbFile: string) => OpenCodeOpenResult;
+}
+/** Run every collector for `[sinceMs, untilMs)` and join attribution. Read-only; never throws for a missing store. */
+export declare function collectLedger(opts: CollectOptions): Ledger;
+export interface TokenTotals {
+    input: number;
+    output: number;
+    reasoning: number;
+    cache_read: number;
+    cache_write: number;
+    /** Sum of every token class. */
+    total: number;
+    /** Sum of recorded costs; null when no row recorded one. */
+    cost_usd: number | null;
+    messages: number;
+}
+export declare function rowTotal(row: UsageRow): number;
+export declare function totalsOf(rows: readonly UsageRow[]): TokenTotals;
+export interface GroupTotals extends TokenTotals {
+    key: string;
+}
+/** Group rows by `keyOf`, largest total first. */
+export declare function groupRows(rows: readonly UsageRow[], keyOf: (row: UsageRow) => string): GroupTotals[];
+/** Share of tokens (0..1) attributed to a concrete model id; 1 for an empty set. */
+export declare function modelCoverage(rows: readonly UsageRow[]): number;
+export interface SessionSummary extends TokenTotals {
+    session_id: string;
+    parent_session_id: string | null;
+    source: string;
+    models: string[];
+    project: string | null;
+    issue: number | null;
+    batch: string | null;
+    unit: string | null;
+    title: string | null;
+    first_ts: string;
+    last_ts: string;
+}
+/** Per-session totals, largest first. */
+export declare function summarizeSessions(rows: readonly UsageRow[]): SessionSummary[];
+/** Tokens per clock hour across `[sinceMs, untilMs)`, oldest first — the burn-rate series. */
+export declare function hourlyBurn(rows: readonly UsageRow[], sinceMs: number, untilMs: number): {
+    hour: string;
+    total: number;
+    messages: number;
+}[];
+/** Repeats closer than this fold into one limit event (agents/cron retry a wall every few minutes). */
+export declare const LIMIT_REPEAT_GAP_MS: number;
+/**
+ * Fold repeats of the same wall (same source, unit and message) into their
+ * first occurrence — `count`/`last_ts` record what was folded. A wall hit by a
+ * cron every 15 minutes is one event, not twenty; its onset is what needs
+ * explaining. Input must be sorted by `ts`.
+ */
+export declare function collapseLimitEvents(events: readonly LimitEvent[], gapMs?: number): LimitEvent[];
+export interface LimitContext {
+    event: LimitEvent;
+    /** Top consumers (by session) in the window that ended at the event. */
+    top: SessionSummary[];
+    window_ms: number;
+}
+/** For each limit event, the top `n` sessions by tokens in the `windowMs` before it. */
+export declare function limitContexts(limits: readonly LimitEvent[], rows: readonly UsageRow[], windowMs: number, n?: number): LimitContext[];
+//# sourceMappingURL=ledger.d.ts.map

package/dist/usage/ledger.d.ts.map

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