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

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":"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"}

package/dist/cost/types.js

@@ -0,0 +1,228 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MODEL_PRICING_EXTENDED = exports.MODEL_PRICING = void 0;
+exports.calculateCostUsd = calculateCostUsd;
+exports.calculateCostUsdExtended = calculateCostUsdExtended;
+/**
+ * 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}.
+ */
+exports.MODEL_PRICING = {
+    // --- Opus family ---
+    "claude-opus-4-6": {
+        inputPer1M: 5,
+        outputPer1M: 25,
+        cacheCreationPer1M: 6.25, // 1.25x input
+        cacheReadPer1M: 0.5, // 0.1x input
+    },
+    "claude-opus-4-5": {
+        inputPer1M: 5,
+        outputPer1M: 25,
+        cacheCreationPer1M: 6.25,
+        cacheReadPer1M: 0.5,
+    },
+    "claude-opus-4-1": {
+        inputPer1M: 15,
+        outputPer1M: 75,
+        cacheCreationPer1M: 18.75,
+        cacheReadPer1M: 1.5,
+    },
+    "claude-opus-4-0": {
+        inputPer1M: 15,
+        outputPer1M: 75,
+        cacheCreationPer1M: 18.75,
+        cacheReadPer1M: 1.5,
+    },
+    // --- Sonnet family ---
+    "claude-sonnet-4-6": {
+        inputPer1M: 3,
+        outputPer1M: 15,
+        cacheCreationPer1M: 3.75,
+        cacheReadPer1M: 0.3,
+    },
+    "claude-sonnet-4-5": {
+        inputPer1M: 3,
+        outputPer1M: 15,
+        cacheCreationPer1M: 3.75,
+        cacheReadPer1M: 0.3,
+    },
+    "claude-sonnet-4-0": {
+        inputPer1M: 3,
+        outputPer1M: 15,
+        cacheCreationPer1M: 3.75,
+        cacheReadPer1M: 0.3,
+    },
+    // --- Haiku family ---
+    "claude-haiku-4-5": {
+        inputPer1M: 1,
+        outputPer1M: 5,
+        cacheCreationPer1M: 1.25,
+        cacheReadPer1M: 0.1,
+    },
+    "claude-haiku-3-5": {
+        inputPer1M: 0.8,
+        outputPer1M: 4,
+        cacheCreationPer1M: 1,
+        cacheReadPer1M: 0.08,
+    },
+};
+exports.MODEL_PRICING_EXTENDED = {
+    "claude-opus-4-6": {
+        inputPer1M: 5,
+        outputPer1M: 25,
+        cacheCreationPer1M: 6.25,
+        cacheCreation5mPer1M: 6.25,
+        cacheCreation1hPer1M: 10,
+        cacheReadPer1M: 0.5,
+    },
+    "claude-opus-4-5": {
+        inputPer1M: 5,
+        outputPer1M: 25,
+        cacheCreationPer1M: 6.25,
+        cacheCreation5mPer1M: 6.25,
+        cacheCreation1hPer1M: 10,
+        cacheReadPer1M: 0.5,
+    },
+    "claude-opus-4-1": {
+        inputPer1M: 15,
+        outputPer1M: 75,
+        cacheCreationPer1M: 18.75,
+        cacheCreation5mPer1M: 18.75,
+        cacheCreation1hPer1M: 30,
+        cacheReadPer1M: 1.5,
+    },
+    "claude-opus-4-0": {
+        inputPer1M: 15,
+        outputPer1M: 75,
+        cacheCreationPer1M: 18.75,
+        cacheCreation5mPer1M: 18.75,
+        cacheCreation1hPer1M: 30,
+        cacheReadPer1M: 1.5,
+    },
+    "claude-sonnet-4-6": {
+        inputPer1M: 3,
+        outputPer1M: 15,
+        cacheCreationPer1M: 3.75,
+        cacheCreation5mPer1M: 3.75,
+        cacheCreation1hPer1M: 6,
+        cacheReadPer1M: 0.3,
+    },
+    "claude-sonnet-4-5": {
+        inputPer1M: 3,
+        outputPer1M: 15,
+        cacheCreationPer1M: 3.75,
+        cacheCreation5mPer1M: 3.75,
+        cacheCreation1hPer1M: 6,
+        cacheReadPer1M: 0.3,
+    },
+    "claude-sonnet-4-0": {
+        inputPer1M: 3,
+        outputPer1M: 15,
+        cacheCreationPer1M: 3.75,
+        cacheCreation5mPer1M: 3.75,
+        cacheCreation1hPer1M: 6,
+        cacheReadPer1M: 0.3,
+    },
+    "claude-haiku-4-5": {
+        inputPer1M: 1,
+        outputPer1M: 5,
+        cacheCreationPer1M: 1.25,
+        cacheCreation5mPer1M: 1.25,
+        cacheCreation1hPer1M: 2,
+        cacheReadPer1M: 0.1,
+    },
+    "claude-haiku-3-5": {
+        inputPer1M: 0.8,
+        outputPer1M: 4,
+        cacheCreationPer1M: 1,
+        cacheCreation5mPer1M: 1,
+        cacheCreation1hPer1M: 1.6,
+        cacheReadPer1M: 0.08,
+    },
+};
+/**
+ * Resolve pricing for a model identifier.
+ *
+ * Handles common variations: the API may return "claude-opus-4-6-20260301"
+ * or similar dated suffixes. We strip the date and try progressively
+ * shorter prefixes until we find a match.
+ */
+function resolvePricing(model) {
+    // Direct match first.
+    if (exports.MODEL_PRICING[model])
+        return exports.MODEL_PRICING[model];
+    // Strip date suffix (e.g. "claude-opus-4-6-20260301" -> "claude-opus-4-6").
+    const withoutDate = model.replace(/-\d{8}$/, "");
+    if (exports.MODEL_PRICING[withoutDate])
+        return exports.MODEL_PRICING[withoutDate];
+    // Try prefix matching (longest first).
+    const keys = Object.keys(exports.MODEL_PRICING).sort((a, b) => b.length - a.length);
+    for (const key of keys) {
+        if (withoutDate.startsWith(key))
+            return exports.MODEL_PRICING[key];
+    }
+    return undefined;
+}
+/**
+ * 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.
+ */
+function calculateCostUsd(model, inputTokens, outputTokens, cacheCreationTokens, cacheReadTokens) {
+    const pricing = resolvePricing(model);
+    if (!pricing)
+        return undefined;
+    const cost = (inputTokens / 1_000_000) * pricing.inputPer1M +
+        (outputTokens / 1_000_000) * pricing.outputPer1M +
+        (cacheCreationTokens / 1_000_000) * pricing.cacheCreationPer1M +
+        (cacheReadTokens / 1_000_000) * pricing.cacheReadPer1M;
+    return Math.round(cost * 1_000_000) / 1_000_000; // 6 decimal places
+}
+/**
+ * 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.
+ */
+function calculateCostUsdExtended(model, inputTokens, outputTokens, cacheCreation5mTokens, cacheCreation1hTokens, cacheReadTokens) {
+    const pricing = exports.MODEL_PRICING_EXTENDED[model] ?? (() => {
+        // Fall back to base pricing with derived 1h rate (2x input).
+        const base = resolvePricing(model);
+        if (!base)
+            return undefined;
+        return {
+            ...base,
+            cacheCreation5mPer1M: base.cacheCreationPer1M,
+            cacheCreation1hPer1M: base.inputPer1M * 2,
+        };
+    })();
+    if (!pricing)
+        return undefined;
+    const ext = pricing;
+    const cost = (inputTokens / 1_000_000) * ext.inputPer1M +
+        (outputTokens / 1_000_000) * ext.outputPer1M +
+        (cacheCreation5mTokens / 1_000_000) * ext.cacheCreation5mPer1M +
+        (cacheCreation1hTokens / 1_000_000) * ext.cacheCreation1hPer1M +
+        (cacheReadTokens / 1_000_000) * ext.cacheReadPer1M;
+    return Math.round(cost * 1_000_000) / 1_000_000;
+}

package/dist/daemon/automationExecutor.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared automation-rule execution path for daemon timer and webhook triggers.
+ */
+import type { AutomationExecutionRecord } from "@a5c-ai/agent-comm-mux";
+import type { AutomationTriggerEvent } from "./types";
+type StoredAutomationExecutionRecord = Omit<AutomationExecutionRecord, "status" | "reason"> & {
+    readonly status: AutomationExecutionRecord["status"] | "skipped";
+    readonly skipReason?: string;
+};
+export interface ExecuteAutomationTriggerOptions {
+    backlogFilePath?: string;
+    now?: () => string;
+}
+export declare function executeAutomationTrigger(event: AutomationTriggerEvent, options?: ExecuteAutomationTriggerOptions): Promise<StoredAutomationExecutionRecord>;
+export {};
+//# sourceMappingURL=automationExecutor.d.ts.map

package/dist/daemon/automationExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"automationExecutor.d.ts","sourceRoot":"","sources":["../../src/daemon/automationExecutor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,KAAK,EACV,yBAAyB,EAY1B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AA8CtD,KAAK,+BAA+B,GAAG,IAAI,CAAC,yBAAyB,EAAE,QAAQ,GAAG,QAAQ,CAAC,GAAG;IAC5F,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;IACjE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AASF,MAAM,WAAW,+BAA+B;IAC9C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AA4LD,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,sBAAsB,EAC7B,OAAO,GAAE,+BAAoC,GAC5C,OAAO,CAAC,+BAA+B,CAAC,CA4E1C"}