@a5c-ai/babysitter-sdk 0.0.186 → 0.0.187-staging.02a0ee21

package/dist/cli/commands/costStats.d.ts

@@ -0,0 +1,13 @@
+/**
+ * cost:stats command - Show cost tracking statistics from run journals
+ *
+ * Usage:
+ *   babysitter cost:stats [runId] [--json] [--all] [--runs-dir <dir>]
+ *
+ * With runId: reads journal for that run, finds COST_TRACKED events, prints table
+ * With --all: aggregates across all runs in the runs directory
+ * With --json: outputs JSON instead of table
+ */
+import type { CostStatsOptions } from "../../cost/types";
+export declare function handleCostStats(options: CostStatsOptions): Promise<number>;
+//# sourceMappingURL=costStats.d.ts.map

package/dist/cli/commands/costStats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"costStats.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/costStats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,KAAK,EACV,gBAAgB,EAKjB,MAAM,kBAAkB,CAAC;AAwP1B,wBAAsB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAwChF"}

package/dist/cli/commands/costStats.js

@@ -0,0 +1,319 @@
+"use strict";
+/**
+ * cost:stats command - Show cost tracking statistics from run journals
+ *
+ * Usage:
+ *   babysitter cost:stats [runId] [--json] [--all] [--runs-dir <dir>]
+ *
+ * With runId: reads journal for that run, finds COST_TRACKED events, prints table
+ * With --all: aggregates across all runs in the runs directory
+ * With --json: outputs JSON instead of table
+ */
+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.handleCostStats = handleCostStats;
+const node_fs_1 = require("node:fs");
+const path = __importStar(require("node:path"));
+const defaults_1 = require("../../config/defaults");
+const storage_1 = require("../../storage");
+const journal_1 = require("../../cost/journal");
+// ============================================================================
+// ANSI Colors
+// ============================================================================
+const COLORS = {
+    reset: "\x1b[0m",
+    bold: "\x1b[1m",
+    dim: "\x1b[2m",
+    cyan: "\x1b[36m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    red: "\x1b[31m",
+};
+function supportsColors() {
+    if (process.env.NO_COLOR !== undefined)
+        return false;
+    if (process.env.FORCE_COLOR !== undefined)
+        return true;
+    return Boolean(process.stdout?.isTTY);
+}
+function col(text, color, useColors) {
+    return useColors ? `${COLORS[color]}${text}${COLORS.reset}` : text;
+}
+// ============================================================================
+// Single Run
+// ============================================================================
+async function costStatsForRun(runsDir, runId) {
+    const runDir = path.join(runsDir, runId);
+    let stat;
+    try {
+        stat = await node_fs_1.promises.stat(runDir);
+    }
+    catch {
+        return null;
+    }
+    if (!stat.isDirectory())
+        return null;
+    const events = await (0, storage_1.loadJournal)(runDir);
+    return (0, journal_1.computeRunCostStats)(runId, events);
+}
+// ============================================================================
+// All Runs
+// ============================================================================
+async function costStatsForAllRuns(runsDir) {
+    let entries;
+    try {
+        entries = await node_fs_1.promises.readdir(runsDir);
+    }
+    catch {
+        entries = [];
+    }
+    const runs = [];
+    for (const entry of entries) {
+        const runDir = path.join(runsDir, entry);
+        try {
+            const s = await node_fs_1.promises.stat(runDir);
+            if (!s.isDirectory())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        const events = await (0, storage_1.loadJournal)(runDir);
+        const stats = (0, journal_1.computeRunCostStats)(entry, events);
+        if (stats.eventCount === 0)
+            continue;
+        runs.push(stats);
+    }
+    let totalInputTokens = 0;
+    let totalOutputTokens = 0;
+    let totalCacheCreation = 0;
+    let totalCacheRead = 0;
+    let totalCostUsd = 0;
+    let totalEvents = 0;
+    for (const r of runs) {
+        totalInputTokens += r.totalInputTokens;
+        totalOutputTokens += r.totalOutputTokens;
+        totalCacheCreation += r.totalCacheCreation;
+        totalCacheRead += r.totalCacheRead;
+        totalCostUsd += r.totalCostUsd;
+        totalEvents += r.eventCount;
+    }
+    totalCostUsd = Math.round(totalCostUsd * 1_000_000) / 1_000_000;
+    return {
+        totalRuns: runs.length,
+        totalEvents,
+        totalInputTokens,
+        totalOutputTokens,
+        totalCacheCreation,
+        totalCacheRead,
+        totalCostUsd,
+        overallCostUsd: totalCostUsd,
+        runs,
+    };
+}
+// ============================================================================
+// Formatting
+// ============================================================================
+function fmtNum(n) {
+    return n.toLocaleString("en-US");
+}
+function fmtUsd(n) {
+    return `$${n.toFixed(4)}`;
+}
+function pad(s, width, right = false) {
+    if (right)
+        return s.padStart(width);
+    return s.padEnd(width);
+}
+function printSingleRunTable(stats, useColors) {
+    console.log("");
+    console.log(col(`Run: ${stats.runId}`, "bold", useColors));
+    console.log(col(`Date: ${stats.date}`, "dim", useColors));
+    console.log("");
+    if (stats.eventCount === 0) {
+        console.log(col("  No COST_TRACKED events found in this run.", "yellow", useColors));
+        console.log("");
+        return;
+    }
+    // Summary row
+    console.log(col("  Summary", "cyan", useColors));
+    console.log(`  Events:            ${col(fmtNum(stats.eventCount), "bold", useColors)}`);
+    console.log(`  Input tokens:      ${col(fmtNum(stats.totalInputTokens), "bold", useColors)}`);
+    console.log(`  Output tokens:     ${col(fmtNum(stats.totalOutputTokens), "bold", useColors)}`);
+    console.log(`  Cache write:       ${col(fmtNum(stats.totalCacheCreation), "bold", useColors)}`);
+    console.log(`  Cache read:        ${col(fmtNum(stats.totalCacheRead), "bold", useColors)}`);
+    console.log(`  Total cost:        ${col(fmtUsd(stats.totalCostUsd), "green", useColors)}`);
+    console.log("");
+    // Per-model breakdown
+    const models = Object.keys(stats.byModel).sort();
+    if (models.length > 0) {
+        console.log(col("  By Model", "cyan", useColors));
+        const hdr = [
+            pad("Model", 24),
+            pad("Events", 8, true),
+            pad("Input Tokens", 14, true),
+            pad("Output Tokens", 15, true),
+            pad("Cache Write", 13, true),
+            pad("Cache Read", 12, true),
+            pad("Cost ($)", 12, true),
+        ].join("  ");
+        console.log(col(`  ${hdr}`, "dim", useColors));
+        console.log(col(`  ${"-".repeat(hdr.length)}`, "dim", useColors));
+        for (const model of models) {
+            const m = stats.byModel[model];
+            const row = [
+                pad(m.model, 24),
+                pad(fmtNum(m.eventCount), 8, true),
+                pad(fmtNum(m.inputTokens), 14, true),
+                pad(fmtNum(m.outputTokens), 15, true),
+                pad(fmtNum(m.cacheCreationTokens), 13, true),
+                pad(fmtNum(m.cacheReadTokens), 12, true),
+                pad(fmtUsd(m.costUsd), 12, true),
+            ].join("  ");
+            console.log(`  ${row}`);
+        }
+        console.log("");
+    }
+    // Per-kind breakdown
+    const kinds = Object.keys(stats.byKind).sort();
+    if (kinds.length > 0) {
+        console.log(col("  By Task Kind", "cyan", useColors));
+        const hdr = [
+            pad("Kind", 24),
+            pad("Events", 8, true),
+            pad("Cost ($)", 12, true),
+        ].join("  ");
+        console.log(col(`  ${hdr}`, "dim", useColors));
+        console.log(col(`  ${"-".repeat(hdr.length)}`, "dim", useColors));
+        for (const kind of kinds) {
+            const k = stats.byKind[kind];
+            const row = [
+                pad(k.kind, 24),
+                pad(fmtNum(k.eventCount), 8, true),
+                pad(fmtUsd(k.costUsd), 12, true),
+            ].join("  ");
+            console.log(`  ${row}`);
+        }
+        console.log("");
+    }
+}
+function printAggregateTable(agg, useColors) {
+    console.log("");
+    console.log(col("Cost Stats \u2014 All Runs", "bold", useColors));
+    console.log("");
+    if (agg.totalRuns === 0) {
+        console.log(col("  No runs with COST_TRACKED events found.", "yellow", useColors));
+        console.log("");
+        return;
+    }
+    console.log(`  Total runs with cost data: ${col(fmtNum(agg.totalRuns), "bold", useColors)}`);
+    console.log(`  Total events:              ${col(fmtNum(agg.totalEvents), "bold", useColors)}`);
+    console.log(`  Total input tokens:        ${col(fmtNum(agg.totalInputTokens), "bold", useColors)}`);
+    console.log(`  Total output tokens:       ${col(fmtNum(agg.totalOutputTokens), "bold", useColors)}`);
+    console.log(`  Total cache write:         ${col(fmtNum(agg.totalCacheCreation), "bold", useColors)}`);
+    console.log(`  Total cache read:          ${col(fmtNum(agg.totalCacheRead), "bold", useColors)}`);
+    console.log(`  Total cost:                ${col(fmtUsd(agg.totalCostUsd), "green", useColors)}`);
+    console.log("");
+    if (agg.runs.length > 0) {
+        console.log(col("  Per-Run Breakdown", "cyan", useColors));
+        const hdr = [
+            pad("Run ID", 28),
+            pad("Date", 24),
+            pad("Events", 8, true),
+            pad("Input", 12, true),
+            pad("Output", 12, true),
+            pad("Cost ($)", 12, true),
+        ].join("  ");
+        console.log(col(`  ${hdr}`, "dim", useColors));
+        console.log(col(`  ${"-".repeat(hdr.length)}`, "dim", useColors));
+        const sorted = [...agg.runs].sort((a, b) => b.totalCostUsd - a.totalCostUsd);
+        for (const r of sorted) {
+            const row = [
+                pad(r.runId, 28),
+                pad(r.date.slice(0, 24), 24),
+                pad(fmtNum(r.eventCount), 8, true),
+                pad(fmtNum(r.totalInputTokens), 12, true),
+                pad(fmtNum(r.totalOutputTokens), 12, true),
+                pad(fmtUsd(r.totalCostUsd), 12, true),
+            ].join("  ");
+            console.log(`  ${row}`);
+        }
+        console.log("");
+    }
+}
+// ============================================================================
+// Main Handler
+// ============================================================================
+async function handleCostStats(options) {
+    const runsDir = options.runsDir ?? process.env[defaults_1.CONFIG_ENV_VARS.RUNS_DIR] ?? defaults_1.DEFAULTS.runsDir;
+    const resolvedRunsDir = path.resolve(runsDir);
+    const useColors = supportsColors();
+    if (options.all) {
+        const agg = await costStatsForAllRuns(resolvedRunsDir);
+        if (options.json) {
+            console.log(JSON.stringify(agg, null, 2));
+        }
+        else {
+            printAggregateTable(agg, useColors);
+        }
+        return 0;
+    }
+    if (options.runId) {
+        const stats = await costStatsForRun(resolvedRunsDir, options.runId);
+        if (!stats) {
+            const msg = `Run not found: ${options.runId} (looked in ${resolvedRunsDir})`;
+            if (options.json) {
+                console.error(JSON.stringify({ error: msg }));
+            }
+            else {
+                console.error(msg);
+            }
+            return 1;
+        }
+        if (options.json) {
+            console.log(JSON.stringify(stats, null, 2));
+        }
+        else {
+            printSingleRunTable(stats, useColors);
+        }
+        return 0;
+    }
+    // No runId and no --all: print help
+    console.error("Usage: babysitter cost:stats [runId] [--all] [--json] [--runs-dir <dir>]");
+    console.error("  runId    Show cost stats for a specific run");
+    console.error("  --all    Aggregate cost stats across all runs");
+    console.error("  --json   Output JSON instead of table");
+    return 1;
+}

package/dist/cli/commands/harnessPhase2.js

@@ -126,22 +126,22 @@ async function resolveEffect(action, harnessName, options, piSession, discovered
         if (piSession) {
             const bashCommand = [command, ...shellArgs.map(harnessUtils_1.shellQuoteArg)].join(" ");
             const bashResult = await piSession.executeBash(bashCommand);
+            const ok = bashResult.exitCode === 0;
             return {
-                status: bashResult.exitCode === 0 ? "ok" : "error",
-                value: bashResult.exitCode === 0 ? bashResult.output : undefined,
-                error: bashResult.exitCode === 0
-                    ? undefined
-                    : new Error(`Shell command exited with code ${bashResult.exitCode ?? "null"}: ${bashResult.output}`),
+                status: "ok",
+                value: ok
+                    ? bashResult.output
+                    : { success: false, exitCode: bashResult.exitCode ?? 1, stdout: bashResult.output, stderr: "", error: `Shell command exited with code ${bashResult.exitCode ?? "null"}: ${bashResult.output}` },
                 stdout: bashResult.output,
             };
         }
         const shellResult = await (0, harnessPhase1_1.execShellEffect)(command, shellArgs, cwd);
+        const shellOk = shellResult.exitCode === 0;
         return {
-            status: shellResult.exitCode === 0 ? "ok" : "error",
-            value: shellResult.exitCode === 0 ? shellResult.stdout : undefined,
-            error: shellResult.exitCode === 0
-                ? undefined
-                : new Error(`Shell command exited with code ${shellResult.exitCode}: ${shellResult.stderr}`),
+            status: "ok",
+            value: shellOk
+                ? shellResult.stdout
+                : { success: false, exitCode: shellResult.exitCode, stdout: shellResult.stdout, stderr: shellResult.stderr, error: `Shell command exited with code ${shellResult.exitCode}: ${shellResult.stderr}` },
             stdout: shellResult.stdout,
             stderr: shellResult.stderr,
         };

package/dist/cli/commands/instructions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAoBH,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,eAAe,GAAG,gBAAgB,GAAG,aAAa,GAAG,qBAAqB,CAAC;IACvF,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,IAAI,EAAE,OAAO,CAAC;CACf;AAmID;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAmFjB"}
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAoBH,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,eAAe,GAAG,gBAAgB,GAAG,aAAa,GAAG,qBAAqB,CAAC;IACvF,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,IAAI,EAAE,OAAO,CAAC;CACf;AAqID;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAmFjB"}

package/dist/cli/commands/instructions.js

@@ -30,11 +30,12 @@ const COMPOSERS = {
         promptType: "babysit-skill",
         partsIncluded: [
             "non-negotiables", "dependencies", "interview", "user-profile",
-            "process-creation", "intent-fidelity-checks", "run-creation",
+            "process-creation", "intent-fidelity-checks", "run-overlap-detection", "run-creation",
             "iteration", "effects", "breakpoint-handling", "results-posting",
             "loop-control", "completion-proof", "task-kinds", "task-examples",
             "quick-reference", "recovery", "process-guidelines", "critical-rules",
             "see-also",
+            "project-instructions",
         ],
     },
     "process-create": {
@@ -43,14 +44,15 @@ const COMPOSERS = {
         partsIncluded: [
             "interview", "user-profile", "process-creation",
             "intent-fidelity-checks", "process-guidelines",
-            "task-kinds", "task-examples",
+            "parallel-phase-detection", "task-kinds", "task-examples",
+            "project-instructions",
         ],
     },
     "orchestrate": {
         fn: prompts_1.composeOrchestrationPrompt,
         promptType: "orchestrate",
         partsIncluded: [
-            "run-creation", "iteration", "effects", "breakpoint-handling",
+            "run-overlap-detection", "run-creation", "iteration", "effects", "breakpoint-handling",
             "results-posting", "loop-control", "completion-proof",
             "quick-reference", "recovery", "critical-rules",
         ],

package/dist/cli/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":";AAKA,OAAO,EAAE,sBAAsB,IAAI,6BAA6B,EAAoB,MAAM,oBAAoB,CAAC;AAywB/G;;;;;;;;;GASG;AACH,iBAAS,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CA8BlE;AAOD,2EAA2E;AAC3E,QAAA,MAAM,sBAAsB,sCAAgC,CAAC;AAytD7D,OAAO,EAAE,aAAa,IAAI,cAAc,EAAE,sBAAsB,IAAI,uBAAuB,EAAE,CAAC;AAE9F,wBAAgB,mBAAmB;eAEf,MAAM,EAAE,GAA2B,OAAO,CAAC,MAAM,CAAC;kBA0pBpD,MAAM;EAIvB"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":";AAKA,OAAO,EAAE,sBAAsB,IAAI,6BAA6B,EAAoB,MAAM,oBAAoB,CAAC;AAixB/G;;;;;;;;;GASG;AACH,iBAAS,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CA8BlE;AAOD,2EAA2E;AAC3E,QAAA,MAAM,sBAAsB,sCAAgC,CAAC;AA0tD7D,OAAO,EAAE,aAAa,IAAI,cAAc,EAAE,sBAAsB,IAAI,uBAAuB,EAAE,CAAC;AAE9F,wBAAgB,mBAAmB;eAEf,MAAM,EAAE,GAA2B,OAAO,CAAC,MAAM,CAAC;kBAkqBpD,MAAM;EAIvB"}

package/dist/cli/main.js

@@ -63,6 +63,7 @@ const profile_1 = require("./commands/profile");
 const processLibrary_1 = require("./commands/processLibrary");
 const plugin_1 = require("./commands/plugin");
 const tokensStats_1 = require("./commands/tokensStats");
+const costStats_1 = require("./commands/costStats");
 const compressionStatus_1 = require("./commands/compressionStatus");
 const compressionToggle_1 = require("./commands/compressionToggle");
 const compressionReset_1 = require("./commands/compressionReset");
@@ -121,6 +122,7 @@ Other commands (agents should never call these directly unless explicitly instru
   babysitter plugin:update-registry [<pluginName>] [--plugin-name <name>] [--plugin-version <ver>] [--global|--project] [--json] [--verbose]
   babysitter plugin:remove-from-registry [<pluginName>] [--plugin-name <name>] [--global|--project] [--json] [--verbose]
   babysitter tokens:stats [runId] [--all] [--runs-dir <dir>] [--json]
+  babysitter cost:stats [runId] [--all] [--runs-dir <dir>] [--json]
   babysitter compression:status [--json]
   babysitter compression:toggle <layer> <on|off> [--json]
   babysitter compression:set <layer.key> <value> [--json]
@@ -549,9 +551,10 @@ function parseArgs(argv) {
             parsed.keepDays = parsePositiveInteger(raw, "--keep-days");
             continue;
         }
-        // tokens:stats flags
+        // tokens:stats / cost:stats flags
         if (arg === "--all") {
             parsed.tokensAll = true;
+            parsed.costAll = true;
             parsed.retrospectAll = true;
             continue;
         }
@@ -593,6 +596,9 @@ function parseArgs(argv) {
     else if (parsed.command === "tokens:stats") {
         [parsed.tokensRunId] = positionals;
     }
+    else if (parsed.command === "cost:stats") {
+        [parsed.costRunId] = positionals;
+    }
     else if (parsed.command === "compression:toggle") {
         const [layer, onOff] = positionals;
         parsed.compressionLayer = layer;
@@ -2052,6 +2058,7 @@ const VALID_COMMANDS = [
     "health",
     "configure",
     "tokens:stats",
+    "cost:stats",
     "compression:status",
     "compression:toggle",
     "compression:set",
@@ -2900,6 +2907,14 @@ function createBabysitterCli() {
                         runsDir: parsed.runsDir,
                     });
                 }
+                if (parsed.command === "cost:stats") {
+                    return await (0, costStats_1.handleCostStats)({
+                        runId: parsed.costRunId,
+                        all: parsed.costAll,
+                        json: parsed.json,
+                        runsDir: parsed.runsDir,
+                    });
+                }
                 // Compression commands
                 if (parsed.command === "compression:status") {
                     return (0, compressionStatus_1.handleCompressionStatus)({ json: parsed.json });

package/dist/config/defaults.d.ts

@@ -122,6 +122,16 @@ export declare const DEFAULTS: Readonly<BabysitterConfig>;
  * Override: set BABYSITTER_STATE_DIR to use a different path.
  */
 export declare function getGlobalStateDir(): string;
+/**
+ * Returns the global babysitter log directory (~/.a5c/logs/).
+ *
+ * Structured hook/CLI/process logs are user-global by default so every
+ * harness entrypoint resolves the same log root regardless of plugin install
+ * location or current working directory.
+ *
+ * Override: set BABYSITTER_LOG_DIR to use a different path.
+ */
+export declare function getGlobalLogDir(): string;
 /**
  * Retrieves configuration with environment variable overrides merged in.
  *

package/dist/config/defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,QAAQ,EAAE,QAAQ,CAAC;IAEnB;;;OAGG;IACH,eAAe,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;CASlB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAwEtC,CAAC;AAEX;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAQ1C;AAiDD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CAqCjF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,sBAAsB,CA2E/E;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAAC,gBAAgB,CAAC,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAEjE"}
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,QAAQ,EAAE,QAAQ,CAAC;IAEnB;;;OAGG;IACH,eAAe,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;CASlB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAwEtC,CAAC;AAEX;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAQ1C;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAQxC;AAiDD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CAqCjF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,sBAAsB,CA2E/E;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAAC,gBAAgB,CAAC,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAEjE"}

package/dist/config/defaults.js

@@ -42,6 +42,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DEFAULTS = exports.CONFIG_ENV_VARS = void 0;
 exports.getGlobalStateDir = getGlobalStateDir;
+exports.getGlobalLogDir = getGlobalLogDir;
 exports.getConfig = getConfig;
 exports.validateConfig = validateConfig;
 exports.getDefaults = getDefaults;
@@ -148,6 +149,24 @@ function getGlobalStateDir() {
         : path.join(os.homedir(), ".a5c");
     return path.join(globalRoot, "state");
 }
+/**
+ * Returns the global babysitter log directory (~/.a5c/logs/).
+ *
+ * Structured hook/CLI/process logs are user-global by default so every
+ * harness entrypoint resolves the same log root regardless of plugin install
+ * location or current working directory.
+ *
+ * Override: set BABYSITTER_LOG_DIR to use a different path.
+ */
+function getGlobalLogDir() {
+    if (process.env.BABYSITTER_LOG_DIR) {
+        return path.resolve(process.env.BABYSITTER_LOG_DIR);
+    }
+    const globalRoot = process.env.BABYSITTER_GLOBAL_STATE_DIR?.trim()
+        ? path.resolve(process.env.BABYSITTER_GLOBAL_STATE_DIR)
+        : path.join(os.homedir(), ".a5c");
+    return path.join(globalRoot, "logs");
+}
 /**
  * Valid log levels for validation
  */

package/dist/config/index.d.ts

@@ -21,5 +21,5 @@
  * }
  * ```
  */
-export { type LogLevel, type BabysitterConfig, type ConfigValidationResult, DEFAULTS, CONFIG_ENV_VARS, getConfig, getGlobalStateDir, validateConfig, getDefaults, isValidLogLevel, } from "./defaults";
+export { type LogLevel, type BabysitterConfig, type ConfigValidationResult, DEFAULTS, CONFIG_ENV_VARS, getConfig, getGlobalLogDir, getGlobalStateDir, validateConfig, getDefaults, isValidLogLevel, } from "./defaults";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAG3B,QAAQ,EACR,eAAe,EAGf,SAAS,EACT,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,eAAe,GAChB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAG3B,QAAQ,EACR,eAAe,EAGf,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/config/index.js

@@ -23,13 +23,14 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isValidLogLevel = exports.getDefaults = exports.validateConfig = exports.getGlobalStateDir = exports.getConfig = exports.CONFIG_ENV_VARS = exports.DEFAULTS = void 0;
+exports.isValidLogLevel = exports.getDefaults = exports.validateConfig = exports.getGlobalStateDir = exports.getGlobalLogDir = exports.getConfig = exports.CONFIG_ENV_VARS = exports.DEFAULTS = void 0;
 var defaults_1 = require("./defaults");
 // Constants
 Object.defineProperty(exports, "DEFAULTS", { enumerable: true, get: function () { return defaults_1.DEFAULTS; } });
 Object.defineProperty(exports, "CONFIG_ENV_VARS", { enumerable: true, get: function () { return defaults_1.CONFIG_ENV_VARS; } });
 // Functions
 Object.defineProperty(exports, "getConfig", { enumerable: true, get: function () { return defaults_1.getConfig; } });
+Object.defineProperty(exports, "getGlobalLogDir", { enumerable: true, get: function () { return defaults_1.getGlobalLogDir; } });
 Object.defineProperty(exports, "getGlobalStateDir", { enumerable: true, get: function () { return defaults_1.getGlobalStateDir; } });
 Object.defineProperty(exports, "validateConfig", { enumerable: true, get: function () { return defaults_1.validateConfig; } });
 Object.defineProperty(exports, "getDefaults", { enumerable: true, get: function () { return defaults_1.getDefaults; } });

package/dist/cost/claudeCodeParser.d.ts

@@ -0,0 +1,81 @@
+/**
+ * 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..."
+ * }
+ * ```
+ */
+import type { CostEventData, ModelCostStats } from "./types";
+/**
+ * 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.
+ */
+export declare function parseClaudeCodeSession(sessionJsonlPath: string): Promise<CostEventData[]>;
+/**
+ * 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.
+ */
+export declare function parseClaudeCodeSessionWithSubagents(sessionJsonlPath: string): Promise<CostEventData[]>;
+/** Aggregated usage summary returned by {@link aggregateUsageData}. */
+export interface AggregatedUsage {
+    /** Total number of cost events. */
+    eventCount: number;
+    /** Total base input tokens across all events. */
+    totalInputTokens: number;
+    /** Total output tokens across all events. */
+    totalOutputTokens: number;
+    /** Total cache-creation tokens (top-level) across all events. */
+    totalCacheCreationTokens: number;
+    /** Total cache-read tokens across all events. */
+    totalCacheReadTokens: number;
+    /** Total 5-minute cache-creation tokens. */
+    totalCacheCreation5mTokens: number;
+    /** Total 1-hour cache-creation tokens. */
+    totalCacheCreation1hTokens: number;
+    /** Total computed cost in USD. */
+    totalCostUsd: number;
+    /** Per-model breakdown of usage statistics. */
+    byModel: Record<string, ModelCostStats>;
+}
+/**
+ * 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.
+ */
+export declare function aggregateUsageData(events: CostEventData[]): AggregatedUsage;
+//# sourceMappingURL=claudeCodeParser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claudeCodeParser.d.ts","sourceRoot":"","sources":["../../src/cost/claudeCodeParser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAqC7D;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAC1C,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,aAAa,EAAE,CAAC,CA+D1B;AAMD;;;;;;;;;GASG;AACH,wBAAsB,mCAAmC,CACvD,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,aAAa,EAAE,CAAC,CA+B1B;AAMD,uEAAuE;AACvE,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,gBAAgB,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iEAAiE;IACjE,wBAAwB,EAAE,MAAM,CAAC;IACjC,iDAAiD;IACjD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,4CAA4C;IAC5C,0BAA0B,EAAE,MAAM,CAAC;IACnC,0CAA0C;IAC1C,0BAA0B,EAAE,MAAM,CAAC;IACnC,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACzC;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,eAAe,CAqD3E"}