@a5c-ai/agent-platform 5.0.1-staging.016f0b0e8119

package/dist/cost/claudeCodeParser.js

@@ -0,0 +1,232 @@
+"use strict";
+/**
+ * Claude Code JSONL session file parser for cost data collection.
+ *
+ * Parses Claude Code session JSONL files (main session and subagent files)
+ * to extract token usage data and compute costs. Each assistant message with
+ * a `usage` block becomes a {@link CostEventData} entry.
+ *
+ * JSONL format (one JSON object per line):
+ * ```json
+ * {
+ *   "type": "assistant",
+ *   "message": {
+ *     "model": "claude-opus-4-6",
+ *     "usage": {
+ *       "input_tokens": 3,
+ *       "cache_creation_input_tokens": 26928,
+ *       "cache_read_input_tokens": 0,
+ *       "cache_creation": { "ephemeral_5m_input_tokens": 0, "ephemeral_1h_input_tokens": 26928 },
+ *       "output_tokens": 28,
+ *       "service_tier": "standard"
+ *     }
+ *   },
+ *   "timestamp": "2026-04-05T..."
+ * }
+ * ```
+ */
+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.parseClaudeCodeSession = parseClaudeCodeSession;
+exports.parseClaudeCodeSessionWithSubagents = parseClaudeCodeSessionWithSubagents;
+exports.aggregateUsageData = aggregateUsageData;
+const node_fs_1 = require("node:fs");
+const path = __importStar(require("node:path"));
+const types_1 = require("./types");
+// ============================================================================
+// Single-file parser
+// ============================================================================
+/**
+ * Parse a single Claude Code session JSONL file into cost events.
+ *
+ * Reads the file, splits by newline, and for each line that represents an
+ * assistant message with usage data, extracts token counts and computes
+ * the USD cost using the extended pricing model.
+ *
+ * @param sessionJsonlPath - Absolute path to the `.jsonl` file.
+ * @returns Array of cost events extracted from assistant messages.
+ */
+async function parseClaudeCodeSession(sessionJsonlPath) {
+    let content;
+    try {
+        content = await node_fs_1.promises.readFile(sessionJsonlPath, "utf-8");
+    }
+    catch (err) {
+        const e = err;
+        if (e.code === "ENOENT")
+            return [];
+        throw err;
+    }
+    const lines = content.split("\n");
+    const events = [];
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        let entry;
+        try {
+            entry = JSON.parse(trimmed);
+        }
+        catch {
+            // Malformed line — skip silently.
+            continue;
+        }
+        if (entry.type !== "assistant")
+            continue;
+        const usage = entry.message?.usage;
+        if (!usage)
+            continue;
+        const model = entry.message?.model ?? "unknown";
+        const inputTokens = usage.input_tokens ?? 0;
+        const outputTokens = usage.output_tokens ?? 0;
+        const cacheCreationTokens = usage.cache_creation_input_tokens ?? 0;
+        const cacheReadTokens = usage.cache_read_input_tokens ?? 0;
+        const cacheCreation5mTokens = usage.cache_creation?.ephemeral_5m_input_tokens ?? 0;
+        const cacheCreation1hTokens = usage.cache_creation?.ephemeral_1h_input_tokens ?? 0;
+        const costUsd = (0, types_1.calculateCostUsdExtended)(model, inputTokens, outputTokens, cacheCreation5mTokens, cacheCreation1hTokens, cacheReadTokens);
+        events.push({
+            model,
+            inputTokens,
+            outputTokens,
+            cacheCreationTokens,
+            cacheReadTokens,
+            cacheCreation5mTokens,
+            cacheCreation1hTokens,
+            serviceTier: usage.service_tier,
+            costUsd: costUsd ?? undefined,
+            timestamp: entry.timestamp,
+        });
+    }
+    return events;
+}
+// ============================================================================
+// Session + subagent parser
+// ============================================================================
+/**
+ * Parse a Claude Code session JSONL file and all associated subagent files.
+ *
+ * Subagent files live at `<sessionDir>/subagents/agent-*.jsonl` where
+ * `<sessionDir>` is derived by stripping the `.jsonl` extension from the
+ * main session file path.
+ *
+ * @param sessionJsonlPath - Absolute path to the main session `.jsonl` file.
+ * @returns Merged array of cost events from the main session and all subagents.
+ */
+async function parseClaudeCodeSessionWithSubagents(sessionJsonlPath) {
+    // Parse main session file.
+    const mainEvents = await parseClaudeCodeSession(sessionJsonlPath);
+    // Derive the session directory (same name without .jsonl extension).
+    const sessionDir = sessionJsonlPath.replace(/\.jsonl$/, "");
+    const subagentsDir = path.join(sessionDir, "subagents");
+    let subagentFiles;
+    try {
+        const entries = await node_fs_1.promises.readdir(subagentsDir);
+        subagentFiles = entries
+            .filter((f) => f.startsWith("agent-") && f.endsWith(".jsonl"))
+            .map((f) => path.join(subagentsDir, f));
+    }
+    catch (err) {
+        const e = err;
+        if (e.code === "ENOENT")
+            return mainEvents;
+        throw err;
+    }
+    // Parse all subagent files and merge.
+    const subagentResults = await Promise.all(subagentFiles.map((f) => parseClaudeCodeSession(f)));
+    const allEvents = [...mainEvents];
+    for (const sub of subagentResults) {
+        allEvents.push(...sub);
+    }
+    return allEvents;
+}
+/**
+ * Aggregate usage data across an array of cost events.
+ *
+ * Sums token counts and costs, producing both overall totals and a
+ * per-model breakdown.
+ *
+ * @param events - Array of cost events (e.g. from {@link parseClaudeCodeSessionWithSubagents}).
+ * @returns Aggregated usage summary with per-model breakdown.
+ */
+function aggregateUsageData(events) {
+    const result = {
+        eventCount: 0,
+        totalInputTokens: 0,
+        totalOutputTokens: 0,
+        totalCacheCreationTokens: 0,
+        totalCacheReadTokens: 0,
+        totalCacheCreation5mTokens: 0,
+        totalCacheCreation1hTokens: 0,
+        totalCostUsd: 0,
+        byModel: {},
+    };
+    for (const event of events) {
+        result.eventCount += 1;
+        result.totalInputTokens += event.inputTokens;
+        result.totalOutputTokens += event.outputTokens;
+        result.totalCacheCreationTokens += event.cacheCreationTokens;
+        result.totalCacheReadTokens += event.cacheReadTokens;
+        result.totalCacheCreation5mTokens += event.cacheCreation5mTokens;
+        result.totalCacheCreation1hTokens += event.cacheCreation1hTokens;
+        result.totalCostUsd += event.costUsd ?? 0;
+        // Per-model breakdown.
+        const model = event.model ?? "unknown";
+        if (!result.byModel[model]) {
+            result.byModel[model] = {
+                model,
+                eventCount: 0,
+                inputTokens: 0,
+                outputTokens: 0,
+                cacheCreationTokens: 0,
+                cacheReadTokens: 0,
+                costUsd: 0,
+            };
+        }
+        const ms = result.byModel[model];
+        ms.eventCount += 1;
+        ms.inputTokens += event.inputTokens;
+        ms.outputTokens += event.outputTokens;
+        ms.cacheCreationTokens += event.cacheCreationTokens;
+        ms.cacheReadTokens += event.cacheReadTokens;
+        ms.costUsd += event.costUsd ?? 0;
+    }
+    // Round totals to 6 decimal places to avoid floating-point drift.
+    result.totalCostUsd =
+        Math.round(result.totalCostUsd * 1_000_000) / 1_000_000;
+    for (const ms of Object.values(result.byModel)) {
+        ms.costUsd = Math.round(ms.costUsd * 1_000_000) / 1_000_000;
+    }
+    return result;
+}

package/dist/cost/collector.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 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.
+ */
+/**
+ * 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.
+ */
+export declare function collectCostDataForRun(runDir: string, sessionJsonlPath: string): Promise<number>;
+/**
+ * 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).
+ */
+export declare function resolveClaudeCodeSessionDir(sessionId: string, workspacePath?: string): string;
+//# sourceMappingURL=collector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../src/cost/collector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM,CAkBR"}

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;
+}