specweave 1.0.556 → 1.0.557

package/dist/src/core/cost/spend-aggregator.js

@@ -0,0 +1,123 @@
+/**
+ * SpendAggregator — daily rollups and provider breakdown from spend records
+ *
+ * Reads SpendRecord JSONL files and computes:
+ * - Daily cost rollups with per-provider breakdown
+ * - Overall provider cost summary
+ * - Budget status (current spend vs configured limits)
+ *
+ * Uses mtime-based cache invalidation (same pattern as CostAggregator).
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { SpendRecordReader } from './spend-record-reader.js';
+export class SpendAggregator {
+    constructor(dir) {
+        this.cache = null;
+        this.dir = dir;
+        this.reader = new SpendRecordReader(dir);
+    }
+    /**
+     * Get daily cost rollups, optionally filtered by date range
+     */
+    getDailyRollups(from, to) {
+        const records = this.getRecords();
+        const filtered = from && to
+            ? records.filter(r => {
+                const ts = new Date(r.timestamp);
+                return ts >= from && ts <= to;
+            })
+            : records;
+        const byDay = new Map();
+        for (const record of filtered) {
+            const date = record.timestamp.slice(0, 10); // YYYY-MM-DD
+            if (!byDay.has(date)) {
+                byDay.set(date, { date, total_cost: 0, total_tokens: 0, sessions: 0, providers: {} });
+            }
+            const day = byDay.get(date);
+            day.total_cost += record.cost_usd;
+            day.total_tokens += record.input_tokens + record.output_tokens;
+            day.sessions += 1;
+            if (!day.providers[record.provider]) {
+                day.providers[record.provider] = { cost: 0, tokens: 0, sessions: 0 };
+            }
+            day.providers[record.provider].cost += record.cost_usd;
+            day.providers[record.provider].tokens += record.input_tokens + record.output_tokens;
+            day.providers[record.provider].sessions += 1;
+        }
+        return [...byDay.values()].sort((a, b) => a.date.localeCompare(b.date));
+    }
+    /**
+     * Get cost breakdown by provider
+     */
+    getProviderBreakdown() {
+        const records = this.getRecords();
+        const breakdown = {};
+        for (const record of records) {
+            if (!breakdown[record.provider]) {
+                breakdown[record.provider] = { total_cost: 0, total_tokens: 0, sessions: 0, models: {} };
+            }
+            const pb = breakdown[record.provider];
+            pb.total_cost += record.cost_usd;
+            pb.total_tokens += record.input_tokens + record.output_tokens;
+            pb.sessions += 1;
+            if (!pb.models[record.model]) {
+                pb.models[record.model] = { cost: 0, tokens: 0, sessions: 0 };
+            }
+            pb.models[record.model].cost += record.cost_usd;
+            pb.models[record.model].tokens += record.input_tokens + record.output_tokens;
+            pb.models[record.model].sessions += 1;
+        }
+        return breakdown;
+    }
+    /**
+     * Get budget status for current month
+     */
+    getBudgetStatus(config) {
+        if (!config?.monthly)
+            return null;
+        const now = new Date();
+        const monthStart = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), 1));
+        const monthEnd = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth() + 1, 0, 23, 59, 59));
+        const records = this.getRecords();
+        const monthRecords = records.filter(r => {
+            const ts = new Date(r.timestamp);
+            return ts >= monthStart && ts <= monthEnd;
+        });
+        const currentSpend = monthRecords.reduce((sum, r) => sum + r.cost_usd, 0);
+        return {
+            currentSpend,
+            monthlyLimit: config.monthly,
+            percentUsed: (currentSpend / config.monthly) * 100,
+        };
+    }
+    /**
+     * Force cache invalidation
+     */
+    invalidateCache() {
+        this.cache = null;
+    }
+    getRecords() {
+        const hash = this.computeMtimeHash();
+        if (this.cache && this.cache.mtimeHash === hash) {
+            return this.cache.records;
+        }
+        const records = this.reader.readAll();
+        this.cache = { records, mtimeHash: hash };
+        return records;
+    }
+    computeMtimeHash() {
+        if (!fs.existsSync(this.dir))
+            return '';
+        const files = fs.readdirSync(this.dir)
+            .filter(f => f.endsWith('.jsonl'))
+            .sort();
+        return files
+            .map(f => {
+            const stat = fs.statSync(path.join(this.dir, f));
+            return `${f}:${stat.mtimeMs}:${stat.size}`;
+        })
+            .join('|');
+    }
+}
+//# sourceMappingURL=spend-aggregator.js.map

package/dist/src/core/cost/spend-aggregator.js.map

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

package/dist/src/core/cost/spend-pipeline.d.ts

@@ -0,0 +1,27 @@
+/**
+ * SpendPipeline — wires SpendEmitter to persistence and alerting
+ *
+ * Call initSpendPipeline() once at startup to connect:
+ * SpendEmitter → SpendRecordWriter (persistence)
+ * SpendEmitter → BudgetMonitor (alerting)
+ */
+import type { BudgetAlert } from './budget-monitor.js';
+import type { BillingBudgetConfig } from './spend-aggregator.js';
+export interface SpendPipelineOptions {
+    /** Directory for JSONL spend files (default: .specweave/state/spend) */
+    spendDir: string;
+    /** Budget configuration from config.json billing.budgets */
+    budgetConfig?: BillingBudgetConfig;
+    /** Callback when budget alert fires */
+    onBudgetAlert?: (alert: BudgetAlert) => void;
+}
+/**
+ * Initialize the spend tracking pipeline.
+ * Safe to call multiple times — only initializes once.
+ */
+export declare function initSpendPipeline(options: SpendPipelineOptions): void;
+/**
+ * Reset initialization state (for testing)
+ */
+export declare function resetSpendPipeline(): void;
+//# sourceMappingURL=spend-pipeline.d.ts.map

package/dist/src/core/cost/spend-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend-pipeline.d.ts","sourceRoot":"","sources":["../../../../src/core/cost/spend-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAIjE,MAAM,WAAW,oBAAoB;IACnC,wEAAwE;IACxE,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,uCAAuC;IACvC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;CAC9C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAgCrE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC"}

package/dist/src/core/cost/spend-pipeline.js

@@ -0,0 +1,51 @@
+/**
+ * SpendPipeline — wires SpendEmitter to persistence and alerting
+ *
+ * Call initSpendPipeline() once at startup to connect:
+ * SpendEmitter → SpendRecordWriter (persistence)
+ * SpendEmitter → BudgetMonitor (alerting)
+ */
+import { SpendEmitter } from './spend-record.js';
+import { SpendRecordWriter } from './spend-record-writer.js';
+import { BudgetMonitor } from './budget-monitor.js';
+let initialized = false;
+/**
+ * Initialize the spend tracking pipeline.
+ * Safe to call multiple times — only initializes once.
+ */
+export function initSpendPipeline(options) {
+    if (initialized)
+        return;
+    initialized = true;
+    const emitter = SpendEmitter.getInstance();
+    const writer = new SpendRecordWriter(options.spendDir);
+    // Persist every spend record to JSONL
+    emitter.onSpend(record => {
+        try {
+            writer.write(record);
+        }
+        catch {
+            // Fail silently — don't crash the LLM call for a write failure
+        }
+    });
+    // Budget alerting (if configured)
+    if (options.budgetConfig?.monthly || options.onBudgetAlert) {
+        const monitor = new BudgetMonitor(options.spendDir, options.budgetConfig, options.onBudgetAlert ?? (() => { }));
+        emitter.onSpend(record => {
+            try {
+                monitor.check(record);
+            }
+            catch {
+                // Fail silently
+            }
+        });
+    }
+}
+/**
+ * Reset initialization state (for testing)
+ */
+export function resetSpendPipeline() {
+    initialized = false;
+    SpendEmitter.getInstance().removeAllListeners();
+}
+//# sourceMappingURL=spend-pipeline.js.map

package/dist/src/core/cost/spend-pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend-pipeline.js","sourceRoot":"","sources":["../../../../src/core/cost/spend-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIpD,IAAI,WAAW,GAAG,KAAK,CAAC;AAWxB;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA6B;IAC7D,IAAI,WAAW;QAAE,OAAO;IACxB,WAAW,GAAG,IAAI,CAAC;IAEnB,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEvD,sCAAsC;IACtC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;QACvB,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,+DAA+D;QACjE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,kCAAkC;IAClC,IAAI,OAAO,CAAC,YAAY,EAAE,OAAO,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;QAC3D,MAAM,OAAO,GAAG,IAAI,aAAa,CAC/B,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,YAAY,EACpB,OAAO,CAAC,aAAa,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CACpC,CAAC;QAEF,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;YACvB,IAAI,CAAC;gBACH,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACxB,CAAC;YAAC,MAAM,CAAC;gBACP,gBAAgB;YAClB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,WAAW,GAAG,KAAK,CAAC;IACpB,YAAY,CAAC,WAAW,EAAE,CAAC,kBAAkB,EAAE,CAAC;AAClD,CAAC"}

package/dist/src/core/cost/spend-record-reader.d.ts

@@ -0,0 +1,23 @@
+/**
+ * SpendRecordReader — reads and filters spend records from JSONL files
+ *
+ * Supports date-range queries across monthly-partitioned files.
+ */
+import type { SpendRecord } from './spend-record.js';
+export declare class SpendRecordReader {
+    private readonly dir;
+    constructor(dir: string);
+    /**
+     * Read spend records within a date range
+     */
+    readRange(from: Date, to: Date): SpendRecord[];
+    /**
+     * Read all spend records from all files
+     */
+    readAll(): SpendRecord[];
+    /**
+     * Determine which monthly files might contain records in the given range
+     */
+    private getRelevantFiles;
+}
+//# sourceMappingURL=spend-record-reader.d.ts.map

package/dist/src/core/cost/spend-record-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend-record-reader.d.ts","sourceRoot":"","sources":["../../../../src/core/cost/spend-record-reader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,GAAG,EAAE,MAAM;IAIvB;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,GAAG,WAAW,EAAE;IA0B9C;;OAEG;IACH,OAAO,IAAI,WAAW,EAAE;IAwBxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAczB"}

package/dist/src/core/cost/spend-record-reader.js

@@ -0,0 +1,81 @@
+/**
+ * SpendRecordReader — reads and filters spend records from JSONL files
+ *
+ * Supports date-range queries across monthly-partitioned files.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+export class SpendRecordReader {
+    constructor(dir) {
+        this.dir = dir;
+    }
+    /**
+     * Read spend records within a date range
+     */
+    readRange(from, to) {
+        const files = this.getRelevantFiles(from, to);
+        const records = [];
+        for (const file of files) {
+            const filePath = path.join(this.dir, file);
+            if (!fs.existsSync(filePath))
+                continue;
+            const content = fs.readFileSync(filePath, 'utf-8');
+            for (const line of content.split('\n')) {
+                if (!line.trim())
+                    continue;
+                try {
+                    const record = JSON.parse(line);
+                    const ts = new Date(record.timestamp);
+                    if (ts >= from && ts <= to) {
+                        records.push(record);
+                    }
+                }
+                catch {
+                    // Skip malformed lines
+                }
+            }
+        }
+        return records;
+    }
+    /**
+     * Read all spend records from all files
+     */
+    readAll() {
+        if (!fs.existsSync(this.dir))
+            return [];
+        const files = fs.readdirSync(this.dir)
+            .filter(f => f.endsWith('.jsonl'))
+            .sort();
+        const records = [];
+        for (const file of files) {
+            const content = fs.readFileSync(path.join(this.dir, file), 'utf-8');
+            for (const line of content.split('\n')) {
+                if (!line.trim())
+                    continue;
+                try {
+                    records.push(JSON.parse(line));
+                }
+                catch {
+                    // Skip malformed lines
+                }
+            }
+        }
+        return records;
+    }
+    /**
+     * Determine which monthly files might contain records in the given range
+     */
+    getRelevantFiles(from, to) {
+        const files = [];
+        const current = new Date(from);
+        current.setUTCDate(1); // Start of month
+        while (current <= to) {
+            const year = current.getUTCFullYear();
+            const month = String(current.getUTCMonth() + 1).padStart(2, '0');
+            files.push(`${year}-${month}.jsonl`);
+            current.setUTCMonth(current.getUTCMonth() + 1);
+        }
+        return files;
+    }
+}
+//# sourceMappingURL=spend-record-reader.js.map

package/dist/src/core/cost/spend-record-reader.js.map

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

package/dist/src/core/cost/spend-record-writer.d.ts

@@ -0,0 +1,18 @@
+/**
+ * SpendRecordWriter — JSONL persistence for spend records
+ *
+ * Appends SpendRecords to monthly-partitioned JSONL files:
+ * .specweave/state/spend/YYYY-MM.jsonl
+ *
+ * Uses O_APPEND for atomic writes (safe for concurrent processes).
+ */
+import type { SpendRecord } from './spend-record.js';
+export declare class SpendRecordWriter {
+    private readonly dir;
+    constructor(dir: string);
+    /**
+     * Append a SpendRecord to the appropriate monthly JSONL file
+     */
+    write(record: SpendRecord): void;
+}
+//# sourceMappingURL=spend-record-writer.d.ts.map

package/dist/src/core/cost/spend-record-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend-record-writer.d.ts","sourceRoot":"","sources":["../../../../src/core/cost/spend-record-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,GAAG,EAAE,MAAM;IAIvB;;OAEG;IACH,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;CAUjC"}

package/dist/src/core/cost/spend-record-writer.js

@@ -0,0 +1,27 @@
+/**
+ * SpendRecordWriter — JSONL persistence for spend records
+ *
+ * Appends SpendRecords to monthly-partitioned JSONL files:
+ * .specweave/state/spend/YYYY-MM.jsonl
+ *
+ * Uses O_APPEND for atomic writes (safe for concurrent processes).
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+export class SpendRecordWriter {
+    constructor(dir) {
+        this.dir = dir;
+    }
+    /**
+     * Append a SpendRecord to the appropriate monthly JSONL file
+     */
+    write(record) {
+        fs.mkdirSync(this.dir, { recursive: true });
+        const partition = record.timestamp.slice(0, 7); // YYYY-MM
+        const filePath = path.join(this.dir, `${partition}.jsonl`);
+        const line = JSON.stringify(record) + '\n';
+        // O_APPEND ensures atomic line writes even with concurrent processes
+        fs.appendFileSync(filePath, line, { flag: 'a' });
+    }
+}
+//# sourceMappingURL=spend-record-writer.js.map

package/dist/src/core/cost/spend-record-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend-record-writer.js","sourceRoot":"","sources":["../../../../src/core/cost/spend-record-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAG7B,MAAM,OAAO,iBAAiB;IAG5B,YAAY,GAAW;QACrB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAmB;QACvB,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE5C,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU;QAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,QAAQ,CAAC,CAAC;QAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;QAE3C,qEAAqE;QACrE,EAAE,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/src/core/cost/spend-record.d.ts

@@ -0,0 +1,81 @@
+/**
+ * SpendRecord type and SpendEmitter
+ *
+ * Foundation for multi-model spend tracking. SpendRecord captures per-request
+ * cost data across all LLM providers. SpendEmitter is a singleton EventEmitter
+ * that decouples tracking from persistence and alerting.
+ */
+import { EventEmitter } from 'events';
+/**
+ * Unified spend record for any LLM provider request
+ */
+export interface SpendRecord {
+    /** Unique record ID (UUID v4) */
+    id: string;
+    /** ISO 8601 timestamp */
+    timestamp: string;
+    /** Provider identifier */
+    provider: string;
+    /** Full model ID */
+    model: string;
+    /** Input token count */
+    input_tokens: number;
+    /** Output token count */
+    output_tokens: number;
+    /** Cached input tokens read (discount pricing) */
+    cached_tokens: number;
+    /** Cache write tokens (surcharge pricing) */
+    cache_write_tokens: number;
+    /** Reasoning/thinking tokens */
+    reasoning_tokens: number;
+    /** Calculated cost in USD */
+    cost_usd: number;
+    /** How cost was determined */
+    cost_source: 'calculated' | 'api_reported' | 'unknown' | 'local';
+    /** SpecWeave project name */
+    project?: string;
+    /** Increment ID if in increment context */
+    increment_id?: string;
+    /** Session identifier */
+    session_id?: string;
+    /** Request duration in milliseconds */
+    duration_ms?: number;
+}
+/**
+ * Input for creating a SpendRecord (required fields + optional overrides)
+ */
+export interface SpendRecordInput {
+    provider: string;
+    model: string;
+    input_tokens: number;
+    output_tokens: number;
+    cached_tokens?: number;
+    cache_write_tokens?: number;
+    reasoning_tokens?: number;
+    cost_usd: number;
+    cost_source: SpendRecord['cost_source'];
+    project?: string;
+    increment_id?: string;
+    session_id?: string;
+    duration_ms?: number;
+}
+/**
+ * Create a SpendRecord with generated ID and timestamp
+ */
+export declare function createSpendRecord(input: SpendRecordInput): SpendRecord;
+/**
+ * Singleton EventEmitter for spend tracking events.
+ * Decouples spend record creation from persistence and alerting.
+ */
+export declare class SpendEmitter extends EventEmitter {
+    private static instance;
+    private constructor();
+    static getInstance(): SpendEmitter;
+    /** Type-safe emit for spend events */
+    emitSpend(record: SpendRecord): boolean;
+    /** Type-safe listener registration */
+    onSpend(listener: (record: SpendRecord) => void): this;
+    /** Type-safe listener removal */
+    offSpend(listener: (record: SpendRecord) => void): this;
+}
+//# sourceMappingURL=spend-record.d.ts.map

package/dist/src/core/cost/spend-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend-record.d.ts","sourceRoot":"","sources":["../../../../src/core/cost/spend-record.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,aAAa,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gCAAgC;IAChC,gBAAgB,EAAE,MAAM,CAAC;IACzB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,WAAW,EAAE,YAAY,GAAG,cAAc,GAAG,SAAS,GAAG,OAAO,CAAC;IACjE,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,WAAW,CAkBtE;AAED;;;GAGG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAC5C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAe;IAEtC,OAAO;IAKP,MAAM,CAAC,WAAW,IAAI,YAAY;IAOlC,sCAAsC;IACtC,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;IAIvC,sCAAsC;IACtC,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;IAItD,iCAAiC;IACjC,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;CAGxD"}

package/dist/src/core/cost/spend-record.js

@@ -0,0 +1,60 @@
+/**
+ * SpendRecord type and SpendEmitter
+ *
+ * Foundation for multi-model spend tracking. SpendRecord captures per-request
+ * cost data across all LLM providers. SpendEmitter is a singleton EventEmitter
+ * that decouples tracking from persistence and alerting.
+ */
+import { EventEmitter } from 'events';
+import { randomUUID } from 'crypto';
+/**
+ * Create a SpendRecord with generated ID and timestamp
+ */
+export function createSpendRecord(input) {
+    return {
+        id: randomUUID(),
+        timestamp: new Date().toISOString(),
+        provider: input.provider,
+        model: input.model,
+        input_tokens: input.input_tokens,
+        output_tokens: input.output_tokens,
+        cached_tokens: input.cached_tokens ?? 0,
+        cache_write_tokens: input.cache_write_tokens ?? 0,
+        reasoning_tokens: input.reasoning_tokens ?? 0,
+        cost_usd: input.cost_usd,
+        cost_source: input.cost_source,
+        project: input.project,
+        increment_id: input.increment_id,
+        session_id: input.session_id,
+        duration_ms: input.duration_ms,
+    };
+}
+/**
+ * Singleton EventEmitter for spend tracking events.
+ * Decouples spend record creation from persistence and alerting.
+ */
+export class SpendEmitter extends EventEmitter {
+    constructor() {
+        super();
+        this.setMaxListeners(20);
+    }
+    static getInstance() {
+        if (!SpendEmitter.instance) {
+            SpendEmitter.instance = new SpendEmitter();
+        }
+        return SpendEmitter.instance;
+    }
+    /** Type-safe emit for spend events */
+    emitSpend(record) {
+        return this.emit('spend', record);
+    }
+    /** Type-safe listener registration */
+    onSpend(listener) {
+        return this.on('spend', listener);
+    }
+    /** Type-safe listener removal */
+    offSpend(listener) {
+        return this.off('spend', listener);
+    }
+}
+//# sourceMappingURL=spend-record.js.map

package/dist/src/core/cost/spend-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend-record.js","sourceRoot":"","sources":["../../../../src/core/cost/spend-record.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAyDpC;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAuB;IACvD,OAAO;QACL,EAAE,EAAE,UAAU,EAAE;QAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,CAAC;QACvC,kBAAkB,EAAE,KAAK,CAAC,kBAAkB,IAAI,CAAC;QACjD,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,IAAI,CAAC;QAC7C,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;KAC/B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,YAAa,SAAQ,YAAY;IAG5C;QACE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;YAC3B,YAAY,CAAC,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;QAC7C,CAAC;QACD,OAAO,YAAY,CAAC,QAAQ,CAAC;IAC/B,CAAC;IAED,sCAAsC;IACtC,SAAS,CAAC,MAAmB;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,sCAAsC;IACtC,OAAO,CAAC,QAAuC;QAC7C,OAAO,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,iCAAiC;IACjC,QAAQ,CAAC,QAAuC;QAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/src/core/cost/spend-tracking-provider.d.ts

@@ -0,0 +1,43 @@
+/**
+ * SpendTrackingProvider — LLMProvider decorator
+ *
+ * Wraps any LLMProvider to capture token usage from every analyze() call
+ * and emit a SpendRecord via the SpendEmitter singleton. Uses the same
+ * decorator pattern as the existing BudgetGuardProvider.
+ *
+ * Zero changes required to individual provider implementations.
+ */
+import type { LLMProvider, LLMProviderType, AnalyzeResult, AnalyzeOptions, StructuredOptions } from '../llm/types.js';
+export interface SpendTrackingContext {
+    incrementId?: string;
+    project?: string;
+    sessionId?: string;
+}
+/**
+ * Decorator that intercepts LLMProvider.analyze() results and emits
+ * SpendRecords for every successful request with token usage data.
+ */
+export declare class SpendTrackingProvider implements LLMProvider {
+    private readonly inner;
+    private readonly emitter;
+    private readonly registry;
+    private readonly context;
+    constructor(inner: LLMProvider, context?: SpendTrackingContext);
+    get name(): LLMProviderType;
+    get defaultModel(): string;
+    analyze(prompt: string, options?: AnalyzeOptions): Promise<AnalyzeResult>;
+    analyzeStructured<T>(prompt: string, options: StructuredOptions<T>): Promise<{
+        data: T;
+        usage: AnalyzeResult['usage'];
+        estimatedCost: number;
+    }>;
+    estimateCost(inputTokens: number, outputTokens: number, model?: string): number;
+    isAvailable(): Promise<boolean>;
+    getStatus(): Promise<{
+        available: boolean;
+        latencyMs?: number;
+        error?: string;
+    }>;
+    private emitSpendRecord;
+}
+//# sourceMappingURL=spend-tracking-provider.d.ts.map

package/dist/src/core/cost/spend-tracking-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend-tracking-provider.d.ts","sourceRoot":"","sources":["../../../../src/core/cost/spend-tracking-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,aAAa,EACb,cAAc,EACd,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AAIzB,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,qBAAsB,YAAW,WAAW;IACvD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;gBAEnC,KAAK,EAAE,WAAW,EAAE,OAAO,GAAE,oBAAyB;IAOlE,IAAI,IAAI,IAAI,eAAe,CAE1B;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAEK,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAMzE,iBAAiB,CAAC,CAAC,EACvB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC5B,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IAe7E,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM;IAI/E,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B,SAAS,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAIhF,OAAO,CAAC,eAAe;CAsDxB"}