@a5c-ai/agent-platform 5.0.1-staging.b436b3b3e611

package/dist/cost/collector.js

@@ -0,0 +1,105 @@
+"use strict";
+/**
+ * Cost data collector for Babysitter runs.
+ *
+ * Bridges the Claude Code JSONL parser with the run journal: parses a
+ * session file (including subagent files), then writes COST_TRACKED events
+ * to the run's journal for later aggregation and reporting.
+ */
+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.collectCostDataForRun = collectCostDataForRun;
+exports.resolveClaudeCodeSessionDir = resolveClaudeCodeSessionDir;
+const path = __importStar(require("node:path"));
+const os = __importStar(require("node:os"));
+const claudeCodeParser_1 = require("./claudeCodeParser");
+const journal_1 = require("./journal");
+/**
+ * Parse a Claude Code session (main + subagents) and write COST_TRACKED
+ * events into the run journal.
+ *
+ * Each assistant message with usage data becomes a separate journal event,
+ * preserving the full token breakdown for fine-grained cost analysis.
+ *
+ * @param runDir - Absolute path to the run directory (e.g. `.a5c/runs/<runId>`).
+ * @param sessionJsonlPath - Absolute path to the main session `.jsonl` file.
+ * @returns The number of COST_TRACKED events written to the journal.
+ */
+async function collectCostDataForRun(runDir, sessionJsonlPath) {
+    const events = await (0, claudeCodeParser_1.parseClaudeCodeSessionWithSubagents)(sessionJsonlPath);
+    let written = 0;
+    for (const event of events) {
+        await (0, journal_1.appendCostEvent)(runDir, event);
+        written += 1;
+    }
+    return written;
+}
+/**
+ * Resolve the Claude Code projects directory path for a given session ID.
+ *
+ * Claude Code stores session JSONL files at:
+ * ```
+ * ~/.claude/projects/<project-slug>/<sessionId>.jsonl
+ * ```
+ *
+ * Since we don't always know the project slug, this function returns the
+ * base Claude Code projects directory. The caller can then search for the
+ * session file within the project subdirectories.
+ *
+ * If a workspace path is provided, the project slug is derived using Claude
+ * Code's path-encoding convention (forward slashes and colons replaced with
+ * dashes, prefixed with the drive letter on Windows).
+ *
+ * @param sessionId - The Claude Code session UUID.
+ * @param workspacePath - Optional absolute workspace path to derive the project slug.
+ * @returns Absolute path to the session `.jsonl` file (when workspace is
+ *   provided) or the Claude Code projects directory (when workspace is omitted).
+ */
+function resolveClaudeCodeSessionDir(sessionId, workspacePath) {
+    const homeDir = os.homedir();
+    const projectsDir = path.join(homeDir, ".claude", "projects");
+    if (!workspacePath) {
+        return projectsDir;
+    }
+    // Claude Code encodes the workspace path as the project directory name.
+    // On Windows: C:\Users\foo\project -> C--Users-foo-project
+    //   The colon becomes a dash, backslashes become dashes (so :\ -> --)
+    // On Unix: /home/foo/project -> -home-foo-project
+    const projectSlug = workspacePath
+        .replace(/\\/g, "/") // Normalize to forward slashes.
+        .replace(/\//g, "-") // Replace path separators with dashes.
+        .replace(/:/g, "-"); // Replace colons with dashes (Windows drive).
+    return path.join(projectsDir, projectSlug, `${sessionId}.jsonl`);
+}

package/dist/cost/effectCost.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Status: NOT INTEGRATED YET
+ * Moved from @a5c-ai/babysitter-sdk.
+ * Per-effect cost aggregation (GAP-SUBOBS-003).
+ */
+import type { EffectIndex } from "@a5c-ai/babysitter-sdk";
+export interface EffectCostSummary {
+    effectId: string;
+    taskId: string;
+    kind: string;
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationInputTokens: number;
+    cacheReadInputTokens: number;
+    costUsd: number;
+    model?: string;
+}
+export interface EffectCostResult {
+    effects: EffectCostSummary[];
+    totalCostUsd: number;
+}
+export declare function computeEffectCosts(index: EffectIndex): EffectCostResult;
+//# sourceMappingURL=effectCost.d.ts.map

package/dist/cost/effectCost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effectCost.d.ts","sourceRoot":"","sources":["../../src/cost/effectCost.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB,EAAE,MAAM,CAAC;IACjC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,gBAAgB,CAwBvE"}

package/dist/cost/effectCost.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeEffectCosts = computeEffectCosts;
+function computeEffectCosts(index) {
+    const effects = [];
+    let totalCostUsd = 0;
+    for (const record of index.listEffects()) {
+        if (record.costUsd === undefined && record.inputTokens === undefined && record.outputTokens === undefined) {
+            continue; // No cost data for this effect
+        }
+        const summary = {
+            effectId: record.effectId,
+            taskId: record.taskId,
+            kind: record.kind ?? "unknown",
+            inputTokens: record.inputTokens ?? 0,
+            outputTokens: record.outputTokens ?? 0,
+            cacheCreationInputTokens: record.cacheCreationInputTokens ?? 0,
+            cacheReadInputTokens: record.cacheReadInputTokens ?? 0,
+            costUsd: record.costUsd ?? 0,
+            model: record.costModel,
+        };
+        effects.push(summary);
+        totalCostUsd += summary.costUsd;
+    }
+    return { effects, totalCostUsd };
+}

package/dist/cost/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Re-export shim — canonical implementation lives in @a5c-ai/agent-runtime.
+ * Internal agent-platform consumers continue to import via relative paths
+ * through this barrel file.
+ */
+export { type CostEventData, type ModelCostStats, type KindCostStats, type RunCostStats, type AggregateCostStats, type ModelPricing, type ModelPricingExtended, MODEL_PRICING, MODEL_PRICING_EXTENDED, calculateCostUsd, calculateCostUsdExtended, type CostStatsOptions, COST_TRACKED_EVENT_TYPE, appendCostEvent, extractCostEvents, computeRunCostStats, parseClaudeCodeSession, parseClaudeCodeSessionWithSubagents, aggregateUsageData, type AggregatedUsage, collectCostDataForRun, resolveClaudeCodeSessionDir, computeEffectCosts, type EffectCostSummary, type EffectCostResult, } from "@a5c-ai/agent-runtime/cost";
+//# sourceMappingURL=index.d.ts.map

package/dist/cost/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cost/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAEL,KAAK,aAAa,EAGlB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EAGvB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,aAAa,EACb,sBAAsB,EAGtB,gBAAgB,EAChB,wBAAwB,EAGxB,KAAK,gBAAgB,EAGrB,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EAGnB,sBAAsB,EACtB,mCAAmC,EACnC,kBAAkB,EAClB,KAAK,eAAe,EAGpB,qBAAqB,EACrB,2BAA2B,EAG3B,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,4BAA4B,CAAC"}

package/dist/cost/index.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeEffectCosts = exports.resolveClaudeCodeSessionDir = exports.collectCostDataForRun = exports.aggregateUsageData = exports.parseClaudeCodeSessionWithSubagents = exports.parseClaudeCodeSession = exports.computeRunCostStats = exports.extractCostEvents = exports.appendCostEvent = exports.COST_TRACKED_EVENT_TYPE = exports.calculateCostUsdExtended = exports.calculateCostUsd = exports.MODEL_PRICING_EXTENDED = exports.MODEL_PRICING = void 0;
+/**
+ * Re-export shim — canonical implementation lives in @a5c-ai/agent-runtime.
+ * Internal agent-platform consumers continue to import via relative paths
+ * through this barrel file.
+ */
+var cost_1 = require("@a5c-ai/agent-runtime/cost");
+Object.defineProperty(exports, "MODEL_PRICING", { enumerable: true, get: function () { return cost_1.MODEL_PRICING; } });
+Object.defineProperty(exports, "MODEL_PRICING_EXTENDED", { enumerable: true, get: function () { return cost_1.MODEL_PRICING_EXTENDED; } });
+// Cost calculation
+Object.defineProperty(exports, "calculateCostUsd", { enumerable: true, get: function () { return cost_1.calculateCostUsd; } });
+Object.defineProperty(exports, "calculateCostUsdExtended", { enumerable: true, get: function () { return cost_1.calculateCostUsdExtended; } });
+// Journal helpers
+Object.defineProperty(exports, "COST_TRACKED_EVENT_TYPE", { enumerable: true, get: function () { return cost_1.COST_TRACKED_EVENT_TYPE; } });
+Object.defineProperty(exports, "appendCostEvent", { enumerable: true, get: function () { return cost_1.appendCostEvent; } });
+Object.defineProperty(exports, "extractCostEvents", { enumerable: true, get: function () { return cost_1.extractCostEvents; } });
+Object.defineProperty(exports, "computeRunCostStats", { enumerable: true, get: function () { return cost_1.computeRunCostStats; } });
+// Claude Code JSONL parser
+Object.defineProperty(exports, "parseClaudeCodeSession", { enumerable: true, get: function () { return cost_1.parseClaudeCodeSession; } });
+Object.defineProperty(exports, "parseClaudeCodeSessionWithSubagents", { enumerable: true, get: function () { return cost_1.parseClaudeCodeSessionWithSubagents; } });
+Object.defineProperty(exports, "aggregateUsageData", { enumerable: true, get: function () { return cost_1.aggregateUsageData; } });
+// Cost data collector
+Object.defineProperty(exports, "collectCostDataForRun", { enumerable: true, get: function () { return cost_1.collectCostDataForRun; } });
+Object.defineProperty(exports, "resolveClaudeCodeSessionDir", { enumerable: true, get: function () { return cost_1.resolveClaudeCodeSessionDir; } });
+// Effect cost
+Object.defineProperty(exports, "computeEffectCosts", { enumerable: true, get: function () { return cost_1.computeEffectCosts; } });

package/dist/cost/journal.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Cost tracking journal helpers for Babysitter SDK.
+ *
+ * Provides functions to append COST_TRACKED events to the run journal,
+ * extract cost events from a journal, and compute aggregated cost statistics.
+ */
+import { type AppendEventResult, type JournalEvent } from "@a5c-ai/babysitter-sdk";
+import type { CostEventData, RunCostStats } from "./types";
+/** Journal event type constant for cost tracking events. */
+export declare const COST_TRACKED_EVENT_TYPE = "COST_TRACKED";
+/**
+ * Append a COST_TRACKED event to a run's journal.
+ *
+ * Computes the USD cost (if not already set) before persisting so that the
+ * journal record is self-contained.
+ *
+ * @param runDir - Absolute path to the run directory.
+ * @param costData - Token usage and metadata for the cost event.
+ * @returns The append result with seq, ulid, filename, checksum, path, and recordedAt.
+ */
+export declare function appendCostEvent(runDir: string, costData: CostEventData): Promise<AppendEventResult>;
+/**
+ * Filter journal events to only COST_TRACKED entries.
+ *
+ * @param events - Full journal event list (as returned by `loadJournal`).
+ * @returns Subset of events whose type is COST_TRACKED.
+ */
+export declare function extractCostEvents(events: JournalEvent[]): JournalEvent[];
+/**
+ * Compute aggregated cost statistics for a run from its journal events.
+ *
+ * Extracts COST_TRACKED events, then accumulates totals with per-model and
+ * per-task-kind breakdowns.
+ *
+ * @param runId - The run identifier (included in the returned stats object).
+ * @param events - Full journal event list for the run.
+ * @returns Aggregated cost stats for the run.
+ */
+export declare function computeRunCostStats(runId: string, events: JournalEvent[]): RunCostStats;
+//# sourceMappingURL=journal.d.ts.map

package/dist/cost/journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.d.ts","sourceRoot":"","sources":["../../src/cost/journal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAe,KAAK,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAChG,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EAGb,MAAM,SAAS,CAAC;AAGjB,4DAA4D;AAC5D,eAAO,MAAM,uBAAuB,iBAAiB,CAAC;AAEtD;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC,iBAAiB,CAAC,CA0B5B;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAExE;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,YAAY,EAAE,GACrB,YAAY,CAwFd"}

package/dist/cost/journal.js

@@ -0,0 +1,137 @@
+"use strict";
+/**
+ * Cost tracking journal helpers for Babysitter SDK.
+ *
+ * Provides functions to append COST_TRACKED events to the run journal,
+ * extract cost events from a journal, and compute aggregated cost statistics.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COST_TRACKED_EVENT_TYPE = void 0;
+exports.appendCostEvent = appendCostEvent;
+exports.extractCostEvents = extractCostEvents;
+exports.computeRunCostStats = computeRunCostStats;
+const babysitter_sdk_1 = require("@a5c-ai/babysitter-sdk");
+const types_1 = require("./types");
+/** Journal event type constant for cost tracking events. */
+exports.COST_TRACKED_EVENT_TYPE = "COST_TRACKED";
+/**
+ * Append a COST_TRACKED event to a run's journal.
+ *
+ * Computes the USD cost (if not already set) before persisting so that the
+ * journal record is self-contained.
+ *
+ * @param runDir - Absolute path to the run directory.
+ * @param costData - Token usage and metadata for the cost event.
+ * @returns The append result with seq, ulid, filename, checksum, path, and recordedAt.
+ */
+async function appendCostEvent(runDir, costData) {
+    // Pre-compute costUsd if the caller did not supply it.
+    const enriched = { ...costData };
+    if (enriched.costUsd == null) {
+        const computed = (0, types_1.calculateCostUsd)(enriched.model, enriched.inputTokens, enriched.outputTokens, enriched.cacheCreationTokens, enriched.cacheReadTokens);
+        if (computed !== undefined) {
+            enriched.costUsd = computed;
+        }
+    }
+    // Set timestamp if missing.
+    if (!enriched.timestamp) {
+        enriched.timestamp = new Date().toISOString();
+    }
+    return (0, babysitter_sdk_1.appendEvent)({
+        runDir,
+        eventType: exports.COST_TRACKED_EVENT_TYPE,
+        event: enriched,
+    });
+}
+/**
+ * Filter journal events to only COST_TRACKED entries.
+ *
+ * @param events - Full journal event list (as returned by `loadJournal`).
+ * @returns Subset of events whose type is COST_TRACKED.
+ */
+function extractCostEvents(events) {
+    return events.filter((e) => e.type === exports.COST_TRACKED_EVENT_TYPE);
+}
+/**
+ * Compute aggregated cost statistics for a run from its journal events.
+ *
+ * Extracts COST_TRACKED events, then accumulates totals with per-model and
+ * per-task-kind breakdowns.
+ *
+ * @param runId - The run identifier (included in the returned stats object).
+ * @param events - Full journal event list for the run.
+ * @returns Aggregated cost stats for the run.
+ */
+function computeRunCostStats(runId, events) {
+    const costEvents = extractCostEvents(events);
+    const stats = {
+        runId,
+        date: costEvents.length > 0 ? costEvents[0].recordedAt : new Date().toISOString(),
+        eventCount: costEvents.length,
+        totalInputTokens: 0,
+        totalOutputTokens: 0,
+        totalCacheCreation: 0,
+        totalCacheRead: 0,
+        totalCostUsd: 0,
+        byModel: {},
+        byKind: {},
+    };
+    for (const event of costEvents) {
+        const data = event.data;
+        const inputTokens = data.inputTokens ?? 0;
+        const outputTokens = data.outputTokens ?? 0;
+        const cacheCreationTokens = data.cacheCreationTokens ?? 0;
+        const cacheReadTokens = data.cacheReadTokens ?? 0;
+        // Resolve per-event cost: use pre-computed value or calculate on the fly.
+        const eventCost = data.costUsd ??
+            (0, types_1.calculateCostUsd)(data.model, inputTokens, outputTokens, cacheCreationTokens, cacheReadTokens) ??
+            0;
+        // --- Run-level totals ---
+        stats.totalInputTokens += inputTokens;
+        stats.totalOutputTokens += outputTokens;
+        stats.totalCacheCreation += cacheCreationTokens;
+        stats.totalCacheRead += cacheReadTokens;
+        stats.totalCostUsd += eventCost;
+        // --- Per-model breakdown ---
+        const model = data.model ?? "unknown";
+        if (!stats.byModel[model]) {
+            stats.byModel[model] = {
+                model,
+                eventCount: 0,
+                inputTokens: 0,
+                outputTokens: 0,
+                cacheCreationTokens: 0,
+                cacheReadTokens: 0,
+                costUsd: 0,
+            };
+        }
+        const ms = stats.byModel[model];
+        ms.eventCount += 1;
+        ms.inputTokens += inputTokens;
+        ms.outputTokens += outputTokens;
+        ms.cacheCreationTokens += cacheCreationTokens;
+        ms.cacheReadTokens += cacheReadTokens;
+        ms.costUsd += eventCost;
+        // --- Per-kind breakdown ---
+        const kind = data.taskKind ?? "unknown";
+        if (!stats.byKind[kind]) {
+            stats.byKind[kind] = {
+                kind,
+                eventCount: 0,
+                costUsd: 0,
+            };
+        }
+        const ks = stats.byKind[kind];
+        ks.eventCount += 1;
+        ks.costUsd += eventCost;
+    }
+    // Round totals to 6 decimal places to avoid floating-point drift.
+    stats.totalCostUsd = Math.round(stats.totalCostUsd * 1_000_000) / 1_000_000;
+    for (const ms of Object.values(stats.byModel)) {
+        ms.costUsd = Math.round(ms.costUsd * 1_000_000) / 1_000_000;
+    }
+    for (const ks of Object.values(stats.byKind)) {
+        ks.costUsd = Math.round(ks.costUsd * 1_000_000) / 1_000_000;
+    }
+    return stats;
+}

package/dist/cost/types.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Cost tracking type definitions and pricing constants for Babysitter SDK.
+ *
+ * Covers Anthropic Claude API token usage structures as seen in Claude Code
+ * session JSONL files, plus aggregation interfaces for run-level and
+ * cross-run cost reporting.
+ *
+ * Pricing source: https://docs.anthropic.com/en/docs/about-claude/pricing
+ * Last verified: 2026-04-05
+ */
+/**
+ * Token/cost data for a single API interaction (assistant message).
+ *
+ * Field names mirror the Anthropic API usage response shape, converted to
+ * camelCase for SDK consistency.
+ */
+export interface CostEventData {
+    /** Model identifier, e.g. "claude-opus-4-6", "claude-sonnet-4-6". */
+    model: string;
+    /** Base (non-cached) input tokens. */
+    inputTokens: number;
+    /** Output (completion) tokens. */
+    outputTokens: number;
+    /** Total cache-creation input tokens (sum of 5m + 1h buckets). */
+    cacheCreationTokens: number;
+    /** Tokens read from prompt cache (cache hits). */
+    cacheReadTokens: number;
+    /** Ephemeral 5-minute cache-creation input tokens. */
+    cacheCreation5mTokens: number;
+    /** Extended 1-hour cache-creation input tokens. */
+    cacheCreation1hTokens: number;
+    /** Service tier reported by the API (e.g. "standard"). */
+    serviceTier?: string;
+    /** Effect ID that produced this usage, when tracked inside a run. */
+    effectId?: string;
+    /** Task kind (e.g. "orchestrator_task", "node", "breakpoint"). */
+    taskKind?: string;
+    /** Wall-clock duration of the API call in milliseconds. */
+    durationMs?: number;
+    /** Computed cost in USD for this single event. */
+    costUsd?: number;
+    /** ISO-8601 timestamp of the event. */
+    timestamp?: string;
+}
+/** Per-model cost aggregation within a run. */
+export interface ModelCostStats {
+    model: string;
+    eventCount: number;
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens: number;
+    cacheReadTokens: number;
+    costUsd: number;
+}
+/** Per-task-kind cost aggregation within a run. */
+export interface KindCostStats {
+    kind: string;
+    eventCount: number;
+    costUsd: number;
+}
+/** Cost summary for a single run. */
+export interface RunCostStats {
+    runId: string;
+    date: string;
+    eventCount: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalCacheCreation: number;
+    totalCacheRead: number;
+    totalCostUsd: number;
+    byModel: Record<string, ModelCostStats>;
+    byKind: Record<string, KindCostStats>;
+}
+/** Aggregate cost summary across multiple runs. */
+export interface AggregateCostStats {
+    totalRuns: number;
+    totalEvents: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalCacheCreation: number;
+    totalCacheRead: number;
+    totalCostUsd: number;
+    /** Overall cost including all token categories across all runs. */
+    overallCostUsd: number;
+    runs: RunCostStats[];
+}
+/** Per-million-token pricing for a single model. All values in USD. */
+export interface ModelPricing {
+    /** Base (non-cached) input tokens, per 1M tokens. */
+    inputPer1M: number;
+    /** Output tokens, per 1M tokens. */
+    outputPer1M: number;
+    /**
+     * Cache-creation tokens, per 1M tokens.
+     *
+     * This is the blended/default rate used when the 5m vs 1h breakdown is
+     * unavailable. Defaults to the 5-minute cache write rate (1.25x input).
+     */
+    cacheCreationPer1M: number;
+    /** Cache-read (hit) tokens, per 1M tokens (0.1x input). */
+    cacheReadPer1M: number;
+}
+/**
+ * Pricing table for known Claude models.
+ *
+ * Keys use the API model identifier format (e.g. "claude-opus-4-6").
+ * Pricing sourced from https://docs.anthropic.com/en/docs/about-claude/pricing
+ *
+ * Cache-creation rates default to the 5-minute write multiplier (1.25x input).
+ * For fine-grained 5m vs 1h cost splits, use {@link MODEL_PRICING_EXTENDED}.
+ */
+export declare const MODEL_PRICING: Record<string, ModelPricing>;
+/**
+ * Extended pricing with separate 5-minute and 1-hour cache write rates.
+ *
+ * Use this when the event data provides the `cacheCreation5mTokens` /
+ * `cacheCreation1hTokens` breakdown (available via the `cache_creation`
+ * sub-object in the Anthropic API response).
+ */
+export interface ModelPricingExtended extends ModelPricing {
+    /** 5-minute cache write, per 1M tokens (1.25x input). */
+    cacheCreation5mPer1M: number;
+    /** 1-hour cache write, per 1M tokens (2x input). */
+    cacheCreation1hPer1M: number;
+}
+export declare const MODEL_PRICING_EXTENDED: Record<string, ModelPricingExtended>;
+/**
+ * Calculate the USD cost for a single API interaction.
+ *
+ * Uses the blended cache-creation rate from {@link MODEL_PRICING}.
+ * For fine-grained 5m/1h splits, use {@link calculateCostUsdExtended}.
+ *
+ * @returns Cost in USD, or `undefined` if the model is unknown.
+ */
+export declare function calculateCostUsd(model: string, inputTokens: number, outputTokens: number, cacheCreationTokens: number, cacheReadTokens: number): number | undefined;
+/**
+ * Calculate the USD cost with separate 5-minute and 1-hour cache write rates.
+ *
+ * Use when the Anthropic API response includes the `cache_creation` sub-object
+ * with `ephemeral_5m_input_tokens` and `ephemeral_1h_input_tokens`.
+ *
+ * @returns Cost in USD, or `undefined` if the model is unknown.
+ */
+export declare function calculateCostUsdExtended(model: string, inputTokens: number, outputTokens: number, cacheCreation5mTokens: number, cacheCreation1hTokens: number, cacheReadTokens: number): number | undefined;
+/** Options for the cost:stats CLI command. */
+export interface CostStatsOptions {
+    /** Show stats for a specific run. */
+    runId?: string;
+    /** Aggregate stats across all runs. */
+    all?: boolean;
+    /** Output JSON instead of a table. */
+    json?: boolean;
+    /** Custom runs directory. */
+    runsDir?: string;
+    /** Filter to a specific model. */
+    model?: string;
+    /** Filter to a specific task kind. */
+    kind?: string;
+    /** Only show runs after this ISO-8601 date. */
+    since?: string;
+    /** Only show runs before this ISO-8601 date. */
+    until?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cost/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cost/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IAEd,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IAEpB,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;IAErB,kEAAkE;IAClE,mBAAmB,EAAE,MAAM,CAAC;IAE5B,kDAAkD;IAClD,eAAe,EAAE,MAAM,CAAC;IAExB,sDAAsD;IACtD,qBAAqB,EAAE,MAAM,CAAC;IAE9B,mDAAmD;IACnD,qBAAqB,EAAE,MAAM,CAAC;IAE9B,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,+CAA+C;AAC/C,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,mDAAmD;AACnD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qCAAqC;AACrC,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACvC;AAED,mDAAmD;AACnD,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,YAAY,EAAE,CAAC;CACtB;AAED,uEAAuE;AACvE,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CA4DtD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,oBAAqB,SAAQ,YAAY;IACxD,yDAAyD;IACzD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oDAAoD;IACpD,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAyEvE,CAAC;AA0BF;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,mBAAmB,EAAE,MAAM,EAC3B,eAAe,EAAE,MAAM,GACtB,MAAM,GAAG,SAAS,CAWpB;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,qBAAqB,EAAE,MAAM,EAC7B,qBAAqB,EAAE,MAAM,EAC7B,eAAe,EAAE,MAAM,GACtB,MAAM,GAAG,SAAS,CAuBpB;AAED,8CAA8C;AAC9C,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,sCAAsC;IACtC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}