@sentropic/agent-stats-core 0.1.0

package/dist/parsers/claude.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Parser for Claude Code session jsonl files
+ * (`~/.claude/projects/<cwd-encoded>/<sessionId>.jsonl`).
+ *
+ * Streams the file line-by-line and yields normalized `SessionEvent`s.
+ *
+ * Known top-level types (May 2026):
+ *   assistant, user, attachment, permission-mode, ai-title, custom-title,
+ *   agent-name, last-prompt, system, file-history-snapshot, queue-operation
+ *
+ * Known `message.content[]` sub-types:
+ *   text, tool_use, tool_result, thinking, (raw string content)
+ */
+import type { SessionEvent } from '../schema.js';
+interface ClaudeParseOptions {
+    /** Absolute path of the session jsonl. Used to derive sessionId/projectCwd if not in the file. */
+    filePath: string;
+    /** Hard-cap on lines processed (for tests). */
+    maxLines?: number;
+}
+/**
+ * Parse a single Claude jsonl session file and yield normalized events.
+ *
+ * Notes:
+ * - Emits a synthetic `session_start` from the first timestamped record.
+ * - Emits `session_end` from the last record.
+ * - The session id is derived from the filename (basename without extension).
+ * - The project cwd is read from the first record that carries one, falling
+ *   back to a sanitized form of the parent directory name.
+ */
+export declare function parseClaudeSession(opts: ClaudeParseOptions): AsyncGenerator<SessionEvent, void, unknown>;
+export {};
+//# sourceMappingURL=claude.d.ts.map

package/dist/parsers/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/parsers/claude.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAS,MAAM,cAAc,CAAC;AAExD,UAAU,kBAAkB;IAC1B,kGAAkG;IAClG,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA0DD;;;;;;;;;GASG;AACH,wBAAuB,kBAAkB,CACvC,IAAI,EAAE,kBAAkB,GACvB,cAAc,CAAC,YAAY,EAAE,IAAI,EAAE,OAAO,CAAC,CA4H7C"}

package/dist/parsers/claude.js

@@ -0,0 +1,169 @@
+/**
+ * Parser for Claude Code session jsonl files
+ * (`~/.claude/projects/<cwd-encoded>/<sessionId>.jsonl`).
+ *
+ * Streams the file line-by-line and yields normalized `SessionEvent`s.
+ *
+ * Known top-level types (May 2026):
+ *   assistant, user, attachment, permission-mode, ai-title, custom-title,
+ *   agent-name, last-prompt, system, file-history-snapshot, queue-operation
+ *
+ * Known `message.content[]` sub-types:
+ *   text, tool_use, tool_result, thinking, (raw string content)
+ */
+import { createHash } from 'node:crypto';
+import { createReadStream } from 'node:fs';
+import { createInterface } from 'node:readline';
+const sha256short = (text) => createHash('sha256').update(text).digest('hex').slice(0, 16);
+function categorizeTool(name) {
+    if (name === 'Bash')
+        return 'bash';
+    if (name.startsWith('mcp__'))
+        return 'mcp';
+    if (['Read', 'Write', 'Edit', 'Glob', 'Grep', 'NotebookEdit', 'WebFetch', 'WebSearch'].includes(name))
+        return 'native';
+    return 'unknown';
+}
+function normalizeUsage(raw) {
+    return {
+        newInputTokens: raw?.input_tokens ?? 0,
+        cachedInputTokens: raw?.cache_read_input_tokens ?? 0,
+        cacheWriteTokens: raw?.cache_creation_input_tokens ?? 0,
+        outputTokens: raw?.output_tokens ?? 0,
+        reasoningTokens: 0, // Claude doesn't expose reasoning sub-count.
+    };
+}
+/**
+ * Parse a single Claude jsonl session file and yield normalized events.
+ *
+ * Notes:
+ * - Emits a synthetic `session_start` from the first timestamped record.
+ * - Emits `session_end` from the last record.
+ * - The session id is derived from the filename (basename without extension).
+ * - The project cwd is read from the first record that carries one, falling
+ *   back to a sanitized form of the parent directory name.
+ */
+export async function* parseClaudeSession(opts) {
+    const stream = createReadStream(opts.filePath, { encoding: 'utf8' });
+    const rl = createInterface({ input: stream, crlfDelay: Infinity });
+    const fileBase = opts.filePath.split('/').pop() ?? opts.filePath;
+    const sessionIdFromFile = fileBase.replace(/\.jsonl$/, '');
+    let sessionId = sessionIdFromFile;
+    let projectCwd = '';
+    let firstTs;
+    let lastTs;
+    let lineCount = 0;
+    let startEmitted = false;
+    // Defer the start event until we have at least one timestamp + cwd.
+    const buffer = [];
+    function flush() {
+        const out = buffer.splice(0);
+        return out;
+    }
+    for await (const line of rl) {
+        lineCount += 1;
+        if (opts.maxLines !== undefined && lineCount > opts.maxLines)
+            break;
+        if (!line.trim())
+            continue;
+        let rec;
+        try {
+            rec = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (rec.sessionId)
+            sessionId = rec.sessionId;
+        if (rec.cwd)
+            projectCwd = rec.cwd;
+        const ts = rec.timestamp;
+        if (ts) {
+            if (!firstTs)
+                firstTs = ts;
+            lastTs = ts;
+        }
+        // Emit session_start lazily once we have ts + cwd (or first ts at least).
+        if (!startEmitted && firstTs) {
+            startEmitted = true;
+            const startEvent = {
+                kind: 'session_start',
+                ts: firstTs,
+                tool: 'claude',
+                sessionId,
+                projectCwd,
+                isSubagent: false, // Claude Task sub-agents would be detected differently.
+            };
+            buffer.push(startEvent);
+        }
+        const recTs = ts ?? firstTs ?? new Date(0).toISOString();
+        const base = { tool: 'claude', sessionId, projectCwd, ts: recTs };
+        // user / assistant turn record (carries `message`)
+        if (rec.type === 'assistant' && rec.message) {
+            const msg = rec.message;
+            // Emit tool_use / tool_result / skill_invoke from content[]
+            if (Array.isArray(msg.content)) {
+                for (const c of msg.content) {
+                    if (c.type === 'tool_use' && c.name) {
+                        buffer.push({
+                            ...base,
+                            kind: 'tool_call',
+                            name: c.name,
+                            category: categorizeTool(c.name),
+                            inputBytes: c.input ? JSON.stringify(c.input).length : 0,
+                        });
+                    }
+                }
+            }
+            // Emit turn event when usage is present.
+            if (msg.usage) {
+                buffer.push({
+                    ...base,
+                    kind: 'turn',
+                    model: msg.model ?? 'unknown',
+                    usage: normalizeUsage(msg.usage),
+                });
+            }
+        }
+        else if (rec.type === 'user' && rec.message) {
+            const msg = rec.message;
+            // user message can be string OR array of content items; extract text length + hash
+            let text = '';
+            if (typeof msg.content === 'string') {
+                text = msg.content;
+            }
+            else if (Array.isArray(msg.content)) {
+                for (const c of msg.content) {
+                    if (c.type === 'text' && typeof c.text === 'string')
+                        text += c.text;
+                }
+            }
+            if (text) {
+                buffer.push({
+                    ...base,
+                    kind: 'user_prompt',
+                    textLength: text.length,
+                    textHash: sha256short(text),
+                });
+            }
+        }
+        else if (rec.type === 'attachment') {
+            // Detect SessionStart hooks for skill invocations.
+            const hookName = rec.attachment?.hookName ?? '';
+            if (hookName.startsWith('Skill') || hookName === 'SessionStart:startup') {
+                // No-op for now; skills are tracked through tool_use of Skill tool.
+            }
+        }
+        yield* flush();
+    }
+    if (lastTs && startEmitted) {
+        yield {
+            kind: 'session_end',
+            ts: lastTs,
+            tool: 'claude',
+            sessionId,
+            projectCwd,
+        };
+    }
+}
+//# sourceMappingURL=claude.js.map

package/dist/parsers/claude.js.map

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

package/dist/parsers/codex.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Parser for Codex CLI session rollouts.
+ *
+ * Two-stage:
+ *   1. `indexCodexSessions(opts)` queries `~/.codex/state_5.sqlite`
+ *      (table `threads`) for sessions matching cwd / time-range filters and
+ *      returns a list of `CodexIndexEntry` pointing to the rollout paths.
+ *   2. `parseCodexRollout({filePath})` streams a single rollout jsonl and
+ *      yields normalized `SessionEvent`s.
+ *
+ * Codex rollout top-level types seen in May 2026:
+ *   session_meta, event_msg, response_item, compacted, turn_context.
+ *
+ * `event_msg.payload.type` sub-types include:
+ *   token_count, agent_message, user_message, task_started, task_complete,
+ *   turn_aborted, context_compacted, mcp_tool_call_begin / *_end,
+ *   web_search_begin / *_end, exec_command_begin / *_end,
+ *   patch_apply_begin / *_end.
+ *
+ * `response_item.payload.type` sub-types: message, function_call,
+ * function_call_output, reasoning.
+ */
+import type { SessionEvent } from '../schema.js';
+export interface CodexIndexEntry {
+    /** Thread id (uuid v7). */
+    id: string;
+    /** Absolute path to the rollout jsonl. */
+    rolloutPath: string;
+    /** Working directory at the time of the session. */
+    cwd: string;
+    /** Model id chosen at session create time (column added later; may be null). */
+    model?: string;
+    /** Unix seconds. */
+    createdAt: number;
+    updatedAt: number;
+    /** Codex's running `tokens_used` counter for this thread. */
+    tokensUsed: number;
+    /** Whether this session source is `subagent`. */
+    isSubagent: boolean;
+}
+export interface IndexCodexOptions {
+    /** Path to state_5.sqlite (default: ~/.codex/state_5.sqlite). */
+    dbPath?: string;
+    /** Lower bound on created_at. */
+    since?: Date;
+    /** Upper bound on created_at. */
+    until?: Date;
+    /** Filter on cwd (exact or prefix; pass with trailing slash for prefix). */
+    projectCwd?: string;
+    /** Hard limit on number of returned entries. */
+    limit?: number;
+}
+/**
+ * Query the Codex threads DB and return matching session entries.
+ *
+ * The function opens the DB in readonly mode and never mutates anything.
+ */
+export declare function indexCodexSessions(opts?: IndexCodexOptions): CodexIndexEntry[];
+export interface ParseCodexRolloutOptions {
+    filePath: string;
+    /** Optional sessionId/cwd override (when caller already has the index entry). */
+    sessionId?: string;
+    projectCwd?: string;
+}
+/**
+ * Stream-parse a Codex rollout jsonl and yield normalized events.
+ */
+export declare function parseCodexRollout(opts: ParseCodexRolloutOptions): AsyncGenerator<SessionEvent, void, unknown>;
+//# sourceMappingURL=codex.d.ts.map

package/dist/parsers/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../src/parsers/codex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAQH,OAAO,KAAK,EAAE,YAAY,EAAS,MAAM,cAAc,CAAC;AAOxD,MAAM,WAAW,eAAe;IAC9B,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,iCAAiC;IACjC,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAaD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,iBAAsB,GAAG,eAAe,EAAE,CAgDlF;AAuFD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAuB,iBAAiB,CACtC,IAAI,EAAE,wBAAwB,GAC7B,cAAc,CAAC,YAAY,EAAE,IAAI,EAAE,OAAO,CAAC,CA6J7C"}

package/dist/parsers/codex.js

@@ -0,0 +1,262 @@
+/**
+ * Parser for Codex CLI session rollouts.
+ *
+ * Two-stage:
+ *   1. `indexCodexSessions(opts)` queries `~/.codex/state_5.sqlite`
+ *      (table `threads`) for sessions matching cwd / time-range filters and
+ *      returns a list of `CodexIndexEntry` pointing to the rollout paths.
+ *   2. `parseCodexRollout({filePath})` streams a single rollout jsonl and
+ *      yields normalized `SessionEvent`s.
+ *
+ * Codex rollout top-level types seen in May 2026:
+ *   session_meta, event_msg, response_item, compacted, turn_context.
+ *
+ * `event_msg.payload.type` sub-types include:
+ *   token_count, agent_message, user_message, task_started, task_complete,
+ *   turn_aborted, context_compacted, mcp_tool_call_begin / *_end,
+ *   web_search_begin / *_end, exec_command_begin / *_end,
+ *   patch_apply_begin / *_end.
+ *
+ * `response_item.payload.type` sub-types: message, function_call,
+ * function_call_output, reasoning.
+ */
+import { createHash } from 'node:crypto';
+import { createReadStream } from 'node:fs';
+import { createInterface } from 'node:readline';
+import Database from 'better-sqlite3';
+import { ZERO_USAGE } from '../schema.js';
+/**
+ * Query the Codex threads DB and return matching session entries.
+ *
+ * The function opens the DB in readonly mode and never mutates anything.
+ */
+export function indexCodexSessions(opts = {}) {
+    const dbPath = opts.dbPath ?? `${process.env['HOME'] ?? ''}/.codex/state_5.sqlite`;
+    const db = new Database(dbPath, { readonly: true, fileMustExist: true });
+    try {
+        const conditions = [];
+        const params = {};
+        if (opts.since) {
+            conditions.push('created_at >= $since');
+            params['since'] = Math.floor(opts.since.getTime() / 1000);
+        }
+        if (opts.until) {
+            conditions.push('created_at <= $until');
+            params['until'] = Math.floor(opts.until.getTime() / 1000);
+        }
+        if (opts.projectCwd) {
+            if (opts.projectCwd.endsWith('/')) {
+                conditions.push('cwd LIKE $cwdPrefix');
+                params['cwdPrefix'] = `${opts.projectCwd}%`;
+            }
+            else {
+                conditions.push('cwd = $cwd');
+                params['cwd'] = opts.projectCwd;
+            }
+        }
+        const where = conditions.length ? `WHERE ${conditions.join(' AND ')}` : '';
+        const limit = opts.limit ? `LIMIT ${Math.floor(opts.limit)}` : '';
+        const sql = `
+      SELECT
+        id, rollout_path, cwd, model, created_at, updated_at, tokens_used,
+        thread_source
+      FROM threads
+      ${where}
+      ORDER BY created_at DESC
+      ${limit}
+    `;
+        const rows = db.prepare(sql).all(params);
+        return rows.map((r) => ({
+            id: r.id,
+            rolloutPath: r.rollout_path,
+            cwd: r.cwd,
+            ...(r.model !== null ? { model: r.model } : {}),
+            createdAt: r.created_at,
+            updatedAt: r.updated_at,
+            tokensUsed: r.tokens_used,
+            isSubagent: r.thread_source === 'subagent',
+        }));
+    }
+    finally {
+        db.close();
+    }
+}
+function normalizeCodexUsage(raw) {
+    if (!raw)
+        return ZERO_USAGE;
+    const cached = raw.cached_input_tokens ?? 0;
+    const total = raw.input_tokens ?? 0;
+    return {
+        newInputTokens: Math.max(0, total - cached),
+        cachedInputTokens: cached,
+        cacheWriteTokens: 0, // Codex doesn't expose cache writes separately.
+        outputTokens: raw.output_tokens ?? 0,
+        reasoningTokens: raw.reasoning_output_tokens ?? 0,
+    };
+}
+const sha256short = (text) => createHash('sha256').update(text).digest('hex').slice(0, 16);
+function categorizeCodexTool(name) {
+    if (name.startsWith('mcp__') || name.startsWith('mcp_'))
+        return 'mcp';
+    if (name === 'shell' || name === 'exec_command' || name === 'bash')
+        return 'bash';
+    if (['Read', 'Write', 'Edit', 'apply_patch', 'patch_apply', 'view_image'].some((n) => name.includes(n)))
+        return 'native';
+    return 'function';
+}
+/**
+ * Stream-parse a Codex rollout jsonl and yield normalized events.
+ */
+export async function* parseCodexRollout(opts) {
+    const stream = createReadStream(opts.filePath, { encoding: 'utf8' });
+    const rl = createInterface({ input: stream, crlfDelay: Infinity });
+    const fileBase = opts.filePath.split('/').pop() ?? opts.filePath;
+    // rollout filenames are: rollout-YYYY-MM-DDTHH-MM-SS-<uuid>.jsonl
+    const uuidMatch = fileBase.match(/-([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})\.jsonl$/);
+    let sessionId = opts.sessionId ?? uuidMatch?.[1] ?? fileBase.replace(/\.jsonl$/, '');
+    let projectCwd = opts.projectCwd ?? '';
+    let model = 'unknown';
+    let lastTs;
+    let startEmitted = false;
+    for await (const line of rl) {
+        if (!line.trim())
+            continue;
+        let rec;
+        try {
+            rec = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        const ts = rec.timestamp ?? new Date(0).toISOString();
+        lastTs = ts;
+        const base = { tool: 'codex', sessionId, projectCwd, ts };
+        if (rec.type === 'session_meta') {
+            const p = (rec.payload ?? {});
+            if (p.id)
+                sessionId = p.id;
+            if (p.cwd)
+                projectCwd = p.cwd;
+            const parentId = p.source?.subagent?.thread_spawn?.parent_thread_id;
+            const depth = p.source?.subagent?.thread_spawn?.depth;
+            const isSub = p.thread_source === 'subagent';
+            yield {
+                ...base,
+                sessionId,
+                projectCwd,
+                kind: 'session_start',
+                ...(p.model_provider ? { model: p.model_provider } : {}),
+                ...(parentId ? { forkedFromId: parentId } : {}),
+                ...(typeof depth === 'number' ? { subagentDepth: depth } : {}),
+                ...(p.agent_nickname ? { agentNickname: p.agent_nickname } : {}),
+                ...(p.cli_version ? { cliVersion: p.cli_version } : {}),
+                isSubagent: isSub,
+            };
+            startEmitted = true;
+            continue;
+        }
+        if (rec.type === 'event_msg') {
+            const p = (rec.payload ?? {});
+            switch (p.type) {
+                case 'token_count': {
+                    const last = p.info?.last_token_usage;
+                    if (last && (last.input_tokens ?? 0) + (last.output_tokens ?? 0) > 0) {
+                        const rl1 = p.rate_limits?.primary?.used_percent;
+                        const rl2 = p.rate_limits?.secondary?.used_percent;
+                        yield {
+                            ...base,
+                            kind: 'turn',
+                            model,
+                            usage: normalizeCodexUsage(last),
+                            ...(p.info?.total_token_usage
+                                ? { cumulative: normalizeCodexUsage(p.info.total_token_usage) }
+                                : {}),
+                            ...(typeof rl1 === 'number' && typeof rl2 === 'number'
+                                ? { rateLimit: { primaryPercent: rl1, secondaryPercent: rl2 } }
+                                : {}),
+                        };
+                    }
+                    break;
+                }
+                case 'context_compacted':
+                    yield { ...base, kind: 'compaction' };
+                    break;
+                case 'user_message': {
+                    const text = typeof p.message === 'string' ? p.message : '';
+                    if (text) {
+                        yield {
+                            ...base,
+                            kind: 'user_prompt',
+                            textLength: text.length,
+                            textHash: sha256short(text),
+                        };
+                    }
+                    break;
+                }
+                case 'mcp_tool_call_end': {
+                    const name = `mcp__${p.server ?? 'unknown'}__${p.tool ?? 'unknown'}`;
+                    const out = p.result ? JSON.stringify(p.result).length : 0;
+                    yield {
+                        ...base,
+                        kind: 'tool_call',
+                        name,
+                        category: 'mcp',
+                        outputBytes: out,
+                    };
+                    break;
+                }
+                case 'exec_command_end': {
+                    const out = (p.aggregated_output?.length ?? 0) + (p.stdout?.length ?? 0) + (p.stderr?.length ?? 0);
+                    const cmdArr = Array.isArray(p.command) ? p.command : [];
+                    const cmdName = typeof cmdArr[0] === 'string' ? cmdArr[0] : 'shell';
+                    yield {
+                        ...base,
+                        kind: 'tool_call',
+                        name: cmdName,
+                        category: 'bash',
+                        outputBytes: out,
+                        ...(typeof p.exit_code === 'number' && p.exit_code !== 0 ? { error: true } : {}),
+                    };
+                    break;
+                }
+                case 'web_search_end':
+                    yield {
+                        ...base,
+                        kind: 'tool_call',
+                        name: 'web_search',
+                        category: 'native',
+                    };
+                    break;
+                default:
+                    break;
+            }
+            continue;
+        }
+        if (rec.type === 'response_item') {
+            const p = (rec.payload ?? {});
+            if (p.type === 'function_call' && typeof p.name === 'string') {
+                yield {
+                    ...base,
+                    kind: 'tool_call',
+                    name: p.name,
+                    category: categorizeCodexTool(p.name),
+                };
+            }
+            continue;
+        }
+        if (rec.type === 'compacted') {
+            yield { ...base, kind: 'compaction' };
+            continue;
+        }
+    }
+    if (startEmitted && lastTs) {
+        yield {
+            kind: 'session_end',
+            ts: lastTs,
+            tool: 'codex',
+            sessionId,
+            projectCwd,
+        };
+    }
+}
+//# sourceMappingURL=codex.js.map

package/dist/parsers/codex.js.map

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

package/dist/rate-card.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Rate cards used to estimate the credits / cost burnt by each turn.
+ *
+ * Two distinct currencies coexist:
+ *   - **Codex credits**: published in OpenAI's Codex rate card (credits /
+ *     1M tokens). The Pro weekly bucket sums these.
+ *   - **Claude USD cents**: Anthropic's public API list price, expressed as
+ *     `100 × $` per 1M tokens, so a $1.25 input rate becomes 125.
+ *
+ * Mixing the two in the same aggregate makes no sense; the aggregator splits
+ * them into separate sub-totals (`codexCredits` vs `claudeUsdCents`).
+ *
+ * Sources (May 2026):
+ *   - Codex rate card (developers.openai.com/codex/pricing,
+ *     help.openai.com codex-rate-card)
+ *   - Anthropic pricing page
+ *   - Cross-referenced with the project memory
+ *     `reference_codex-quota-equation`
+ *
+ * All numbers may drift; update from the source when OpenAI / Anthropic
+ * change their public pricing.
+ */
+import type { Usage } from './schema.js';
+export type CostCurrency = 'codex_credits' | 'claude_usd_cents' | 'unknown';
+/** Rate weights per 1M tokens for one model. */
+export interface ModelRates {
+    newInputPerMillion: number;
+    cachedPerMillion: number;
+    cacheWritePerMillion: number;
+    outputPerMillion: number;
+    currency: CostCurrency;
+}
+export declare const ZERO_RATES: ModelRates;
+/**
+ * Default rate card. Keys MUST match the model id reported by the parser
+ * (Codex `model_provider` value, Claude `message.model` value). Aliases /
+ * fallbacks are resolved by `resolveRates`.
+ */
+export declare const DEFAULT_RATE_CARD: Record<string, ModelRates>;
+/**
+ * Resolve the rate-card entry for a model. Returns `ZERO_RATES` when the
+ * model is not registered, so callers always get a defined value.
+ */
+export declare function resolveRates(model: string | undefined, card?: Record<string, ModelRates>): ModelRates;
+/** Compute the cost of a single turn's usage given the model. */
+export declare function estimateCost(usage: Usage, rates: ModelRates): {
+    amount: number;
+    currency: CostCurrency;
+};
+//# sourceMappingURL=rate-card.d.ts.map

package/dist/rate-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-card.d.ts","sourceRoot":"","sources":["../src/rate-card.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,MAAM,YAAY,GAAG,eAAe,GAAG,kBAAkB,GAAG,SAAS,CAAC;AAE5E,gDAAgD;AAChD,MAAM,WAAW,UAAU;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,eAAO,MAAM,UAAU,EAAE,UAMxB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAsExD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAqB,GACnD,UAAU,CAcZ;AAED,iEAAiE;AACjE,wBAAgB,YAAY,CAC1B,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,UAAU,GAChB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAA;CAAE,CAQ5C"}