@rasensio/aidlc 1.2.0 → 1.3.0

package/dist/cost/providers/kiro.js

@@ -0,0 +1,147 @@
+/**
+ * kiro cost provider: per-turn credit usage from local session files.
+ *
+ * Two on-disk shapes (both undocumented — fail-soft everywhere, D2):
+ * - IDE: ~/.kiro/sessions/<workspace-hash>/sess_<uuid>/messages.jsonl with
+ *   usage_summary events: promptTurnSummaries[].usage (credits, fractional).
+ *   session.json alongside carries workspacePaths for project matching.
+ * - CLI: ~/.kiro/sessions/cli/<uuid>.json with
+ *   session_state.conversation_metadata.user_turn_metadatas[].metering_usage.
+ *
+ * Cursor: "<n>" — count of usage events already consumed from the file
+ * (files are append-only per session).
+ *
+ * Design: design.md §3, D2
+ */
+import { readFileSync, existsSync, realpathSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, resolve, sep } from 'node:path';
+import { SESSION_ID_RE } from '../types.js';
+export function kiroSessionsRoot(env) {
+    return join(env.home ?? homedir(), '.kiro', 'sessions');
+}
+function isCount(v) {
+    return typeof v === 'number' && Number.isFinite(v) && v >= 0;
+}
+/** Parse IDE messages.jsonl usage_summary events. Fail-soft per line. */
+function parseIdeUsage(path) {
+    const events = [];
+    let raw;
+    try {
+        raw = readFileSync(path, 'utf8');
+    }
+    catch {
+        return events;
+    }
+    for (const line of raw.split('\n')) {
+        const t = line.trim();
+        if (t === '')
+            continue;
+        try {
+            const entry = JSON.parse(t);
+            if (entry.type !== 'usage_summary')
+                continue;
+            const at = typeof entry.timestamp === 'string' && !Number.isNaN(Date.parse(entry.timestamp))
+                ? entry.timestamp
+                : new Date(0).toISOString();
+            const summaries = entry.promptTurnSummaries;
+            if (!Array.isArray(summaries))
+                continue;
+            for (const s of summaries) {
+                const rec = s;
+                if (rec.unit === 'credit' && isCount(rec.usage)) {
+                    events.push({ at, credits: rec.usage, model: null });
+                }
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return events;
+}
+/** Parse CLI session JSON metering_usage entries. Fail-soft. */
+function parseCliUsage(path) {
+    const events = [];
+    let root;
+    try {
+        root = JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return events;
+    }
+    const state = root.session_state;
+    const meta = state?.conversation_metadata;
+    const turns = meta?.user_turn_metadatas;
+    if (!Array.isArray(turns))
+        return events;
+    for (const turn of turns) {
+        const t = turn;
+        const at = typeof t.end_timestamp === 'string' && !Number.isNaN(Date.parse(t.end_timestamp))
+            ? t.end_timestamp
+            : new Date(0).toISOString();
+        const model = typeof t.model === 'string' ? t.model : null;
+        const metering = t.metering_usage;
+        if (!Array.isArray(metering))
+            continue;
+        for (const m of metering) {
+            const rec = m;
+            if (rec.unit === 'credit' && isCount(rec.value)) {
+                events.push({ at, credits: rec.value, model });
+            }
+        }
+    }
+    return events;
+}
+export const kiroProvider = {
+    name: 'kiro',
+    detect(env) {
+        return existsSync(kiroSessionsRoot(env));
+    },
+    resolveSource(input, env) {
+        if (!SESSION_ID_RE.test(input.session_id))
+            return null;
+        const root = kiroSessionsRoot(env);
+        let realRoot;
+        try {
+            realRoot = realpathSync(root);
+        }
+        catch {
+            return null;
+        }
+        // CLI shape first: sessions/cli/<id>.json
+        const cliPath = join(realRoot, 'cli', `${input.session_id}.json`);
+        if (existsSync(cliPath)) {
+            return { provider: 'kiro', path: realpathSync(cliPath) };
+        }
+        // IDE shape: locate sess_<id> under a workspace-hash directory whose
+        // session.json workspacePaths includes the project root.
+        if (input.transcript_path) {
+            let real;
+            try {
+                real = realpathSync(resolve(input.transcript_path));
+            }
+            catch {
+                return null;
+            }
+            if (real !== realRoot && !real.startsWith(realRoot + sep))
+                return null;
+            return { provider: 'kiro', path: real };
+        }
+        return null;
+    },
+    async extract(source, since) {
+        const events = source.path.endsWith('.json')
+            ? parseCliUsage(source.path)
+            : parseIdeUsage(source.path);
+        const consumed = since !== null && /^\d+$/.test(since) ? Number(since) : 0;
+        const segments = [];
+        for (let i = consumed; i < events.length; i++) {
+            const e = events[i];
+            const units = { kind: 'credits', credits: e.credits, model: e.model };
+            segments.push({ at: e.at, units, cursor: String(i + 1) });
+        }
+        return segments;
+    },
+};
+//# sourceMappingURL=kiro.js.map

package/dist/cost/providers/kiro.js.map

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

package/dist/cost/providers/provider.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Cost provider seam (FR3.1).
+ *
+ * A provider knows how to (a) detect its platform, (b) locate and validate
+ * its usage records for a session, and (c) extract usage segments since a
+ * cursor. Providers never touch ledgers or instances — attribution belongs
+ * to the recorder.
+ *
+ * Design: design.md §3
+ */
+import type { RecordInput, SourceRef, UsageSegment } from '../types.js';
+export interface ProviderEnv {
+    projectRoot: string;
+    /** Home directory override for tests. */
+    home?: string;
+}
+export interface CostProvider {
+    readonly name: string;
+    /** Is this platform present for the project/user? */
+    detect(env: ProviderEnv): boolean;
+    /**
+     * Validate hook input and resolve the usage-record source (FR3.9).
+     * Returns null (with a logged reason) when input is invalid or the
+     * source is outside the platform's known root.
+     */
+    resolveSource(input: RecordInput, env: ProviderEnv): SourceRef | null;
+    /**
+     * Extract usage segments after `since` (a cursor previously returned in
+     * a segment). Streaming and fail-soft: malformed records are skipped.
+     */
+    extract(source: SourceRef, since: string | null, env: ProviderEnv): Promise<UsageSegment[]>;
+}
+export declare function registerProvider(p: CostProvider): void;
+export declare function getProvider(name: string): CostProvider | undefined;
+export declare function allProviders(): CostProvider[];
+//# sourceMappingURL=provider.d.ts.map

package/dist/cost/providers/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/cost/providers/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAExE,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,MAAM,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC;IAClC;;;;OAIG;IACH,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI,CAAC;IACtE;;;OAGG;IACH,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CAC7F;AAID,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,YAAY,GAAG,IAAI,CAEtD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAElE;AAED,wBAAgB,YAAY,IAAI,YAAY,EAAE,CAE7C"}

package/dist/cost/providers/provider.js

@@ -0,0 +1,21 @@
+/**
+ * Cost provider seam (FR3.1).
+ *
+ * A provider knows how to (a) detect its platform, (b) locate and validate
+ * its usage records for a session, and (c) extract usage segments since a
+ * cursor. Providers never touch ledgers or instances — attribution belongs
+ * to the recorder.
+ *
+ * Design: design.md §3
+ */
+const registry = new Map();
+export function registerProvider(p) {
+    registry.set(p.name, p);
+}
+export function getProvider(name) {
+    return registry.get(name);
+}
+export function allProviders() {
+    return [...registry.values()];
+}
+//# sourceMappingURL=provider.js.map

package/dist/cost/providers/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../src/cost/providers/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA2BH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC;AAEjD,MAAM,UAAU,gBAAgB,CAAC,CAAe;IAC9C,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;AAChC,CAAC"}

package/dist/cost/rates-bundled.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Bundled rate table, versioned with the CLI (FR6.1).
+ *
+ * Anthropic list prices per MTok; kiro-credit at the standard overage rate.
+ * `aidlc cost rates update` refreshes token rates from the configured
+ * source; unit-priced entries (kiro-credit) have no public feed and are
+ * bundled/override only (D3).
+ */
+import type { RateSnapshot } from './types.js';
+export declare const BUNDLED_RATES: RateSnapshot;
+//# sourceMappingURL=rates-bundled.d.ts.map

package/dist/cost/rates-bundled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rates-bundled.d.ts","sourceRoot":"","sources":["../../src/cost/rates-bundled.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,eAAO,MAAM,aAAa,EAAE,YAa3B,CAAC"}

package/dist/cost/rates-bundled.js

@@ -0,0 +1,23 @@
+/**
+ * Bundled rate table, versioned with the CLI (FR6.1).
+ *
+ * Anthropic list prices per MTok; kiro-credit at the standard overage rate.
+ * `aidlc cost rates update` refreshes token rates from the configured
+ * source; unit-priced entries (kiro-credit) have no public feed and are
+ * bundled/override only (D3).
+ */
+export const BUNDLED_RATES = {
+    snapshot_version: 'bundled-2026-08-15',
+    effective_date: '2026-08-15',
+    rates: {
+        'claude-fable-5': { input_per_mtok: 5.0, output_per_mtok: 25.0, cache_read_per_mtok: 0.5, cache_write_per_mtok: 6.25 },
+        'claude-opus-5': { input_per_mtok: 5.0, output_per_mtok: 25.0, cache_read_per_mtok: 0.5, cache_write_per_mtok: 6.25 },
+        'claude-opus-4-1': { input_per_mtok: 15.0, output_per_mtok: 75.0, cache_read_per_mtok: 1.5, cache_write_per_mtok: 18.75 },
+        'claude-sonnet-5': { input_per_mtok: 3.0, output_per_mtok: 15.0, cache_read_per_mtok: 0.3, cache_write_per_mtok: 3.75 },
+        'claude-sonnet-4-6': { input_per_mtok: 3.0, output_per_mtok: 15.0, cache_read_per_mtok: 0.3, cache_write_per_mtok: 3.75 },
+        'claude-sonnet-4-5': { input_per_mtok: 3.0, output_per_mtok: 15.0, cache_read_per_mtok: 0.3, cache_write_per_mtok: 3.75 },
+        'claude-haiku-4-5': { input_per_mtok: 1.0, output_per_mtok: 5.0, cache_read_per_mtok: 0.1, cache_write_per_mtok: 1.25 },
+        'kiro-credit': { per_unit: 0.04 },
+    },
+};
+//# sourceMappingURL=rates-bundled.js.map

package/dist/cost/rates-bundled.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rates-bundled.js","sourceRoot":"","sources":["../../src/cost/rates-bundled.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,CAAC,MAAM,aAAa,GAAiB;IACzC,gBAAgB,EAAE,oBAAoB;IACtC,cAAc,EAAE,YAAY;IAC5B,KAAK,EAAE;QACL,gBAAgB,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,mBAAmB,EAAE,GAAG,EAAE,oBAAoB,EAAE,IAAI,EAAE;QACtH,eAAe,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,mBAAmB,EAAE,GAAG,EAAE,oBAAoB,EAAE,IAAI,EAAE;QACrH,iBAAiB,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,mBAAmB,EAAE,GAAG,EAAE,oBAAoB,EAAE,KAAK,EAAE;QACzH,iBAAiB,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,mBAAmB,EAAE,GAAG,EAAE,oBAAoB,EAAE,IAAI,EAAE;QACvH,mBAAmB,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,mBAAmB,EAAE,GAAG,EAAE,oBAAoB,EAAE,IAAI,EAAE;QACzH,mBAAmB,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,mBAAmB,EAAE,GAAG,EAAE,oBAAoB,EAAE,IAAI,EAAE;QACzH,kBAAkB,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE,oBAAoB,EAAE,IAAI,EAAE;QACvH,aAAa,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;KAClC;CACF,CAAC"}

package/dist/cost/rates.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Rate table: bundled defaults, on-demand cached updates, config overrides.
+ *
+ * Resolution precedence: config override > cached update > bundled (FR6.5).
+ * Model ids are normalized with a closed table-driven rule before lookup —
+ * additions are code changes with tests, never "etc.".
+ *
+ * Dollar math uses integer micro-dollars to avoid float drift (DD6).
+ *
+ * Design: design.md §4.5, D3
+ */
+import type { RateEntry, RateSnapshot, CostConfig, CostUnits } from './types.js';
+/** Normalization rule: applied in order; printed by `rates show --normalization`. */
+export declare const NORMALIZATION_RULES: Array<{
+    kind: 'prefix' | 'suffix';
+    pattern: RegExp;
+    describe: string;
+}>;
+/** Normalize a raw model id for rate lookup (FR6.5). */
+export declare function normalizeModelId(model: string): string;
+export declare function cachedRatesPath(projectRoot: string): string;
+export declare function loadBundled(): RateSnapshot;
+export type RateOrigin = 'override' | 'cached' | 'bundled';
+export interface EffectiveRates {
+    snapshot: string;
+    entries: Map<string, {
+        rate: RateEntry;
+        origin: RateOrigin;
+    }>;
+}
+/** Merge bundled < cached < overrides into the effective table. */
+export declare function effectiveRates(projectRoot: string, config: CostConfig | null): EffectiveRates;
+/** Cost of usage units in integer micro-dollars; null = unpriced. */
+export declare function priceUnits(units: CostUnits, rates: EffectiveRates): number | null;
+export declare function microToUsd(micro: number): string;
+/**
+ * Fetch the LiteLLM pricing JSON and cache the models we know how to price.
+ * HTTPS only, redirects refused, 5MB cap, schema-validated, temp-then-rename.
+ * Throws with a user-safe message on any failure — callers keep the old table.
+ */
+export declare function updateRates(projectRoot: string, config: CostConfig | null): Promise<RateSnapshot>;
+//# sourceMappingURL=rates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rates.d.ts","sourceRoot":"","sources":["../../src/cost/rates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAOjF,qFAAqF;AACrF,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAQvG,CAAC;AAEF,wDAAwD;AACxD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CActD;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE3D;AAwBD,wBAAgB,WAAW,IAAI,YAAY,CAE1C;AAaD,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,MAAM,EAAE,UAAU,CAAA;KAAE,CAAC,CAAC;CAC/D;AAED,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,cAAc,CAiB7F;AAED,qEAAqE;AACrE,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAiBjF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAcD;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,CA4DvG"}

package/dist/cost/rates.js

@@ -0,0 +1,190 @@
+/**
+ * Rate table: bundled defaults, on-demand cached updates, config overrides.
+ *
+ * Resolution precedence: config override > cached update > bundled (FR6.5).
+ * Model ids are normalized with a closed table-driven rule before lookup —
+ * additions are code changes with tests, never "etc.".
+ *
+ * Dollar math uses integer micro-dollars to avoid float drift (DD6).
+ *
+ * Design: design.md §4.5, D3
+ */
+import { readFileSync, writeFileSync, renameSync, mkdirSync, existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { BUNDLED_RATES } from './rates-bundled.js';
+const DEFAULT_RATES_URL = 'https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json';
+const FETCH_SIZE_CAP = 5 * 1024 * 1024;
+/** Normalization rule: applied in order; printed by `rates show --normalization`. */
+export const NORMALIZATION_RULES = [
+    { kind: 'prefix', pattern: /^(us|eu|apac|global)\./, describe: 'strip region prefix (us./eu./apac./global.)' },
+    { kind: 'prefix', pattern: /^anthropic\./, describe: 'strip anthropic. prefix' },
+    { kind: 'prefix', pattern: /^aws\//, describe: 'strip aws/ prefix' },
+    { kind: 'prefix', pattern: /^bedrock\//, describe: 'strip bedrock/ prefix' },
+    { kind: 'prefix', pattern: /^vertex_ai\//, describe: 'strip vertex_ai/ prefix' },
+    { kind: 'suffix', pattern: /-v\d+(:\d+)?$/, describe: 'strip -vN / -vN:M version suffix' },
+    { kind: 'suffix', pattern: /@\d{8}$/, describe: 'strip @YYYYMMDD suffix' },
+];
+/** Normalize a raw model id for rate lookup (FR6.5). */
+export function normalizeModelId(model) {
+    let m = model.toLowerCase();
+    let changed = true;
+    while (changed) {
+        changed = false;
+        for (const rule of NORMALIZATION_RULES) {
+            const next = m.replace(rule.pattern, '');
+            if (next !== m) {
+                m = next;
+                changed = true;
+            }
+        }
+    }
+    return m;
+}
+export function cachedRatesPath(projectRoot) {
+    return join(projectRoot, '.aidlc', 'cost', 'rates.json');
+}
+function isRateEntry(v) {
+    if (typeof v !== 'object' || v === null)
+        return false;
+    const allowed = new Set([
+        'input_per_mtok', 'output_per_mtok', 'cache_read_per_mtok', 'cache_write_per_mtok', 'per_unit',
+    ]);
+    return Object.entries(v).every(([k, val]) => allowed.has(k) && typeof val === 'number' && Number.isFinite(val) && val >= 0);
+}
+function validateSnapshot(data) {
+    if (typeof data !== 'object' || data === null)
+        return false;
+    const s = data;
+    return (typeof s.snapshot_version === 'string' &&
+        typeof s.effective_date === 'string' &&
+        typeof s.rates === 'object' &&
+        s.rates !== null &&
+        Object.values(s.rates).every(isRateEntry));
+}
+export function loadBundled() {
+    return BUNDLED_RATES;
+}
+function loadCached(projectRoot) {
+    const p = cachedRatesPath(projectRoot);
+    if (!existsSync(p))
+        return null;
+    try {
+        const parsed = JSON.parse(readFileSync(p, 'utf8'));
+        return validateSnapshot(parsed) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Merge bundled < cached < overrides into the effective table. */
+export function effectiveRates(projectRoot, config) {
+    const bundled = loadBundled();
+    const cached = loadCached(projectRoot);
+    const entries = new Map();
+    for (const [model, rate] of Object.entries(bundled.rates)) {
+        entries.set(model, { rate, origin: 'bundled' });
+    }
+    if (cached) {
+        for (const [model, rate] of Object.entries(cached.rates)) {
+            entries.set(model, { rate, origin: 'cached' });
+        }
+    }
+    for (const [model, rate] of Object.entries(config?.rates ?? {})) {
+        if (isRateEntry(rate))
+            entries.set(normalizeModelId(model), { rate, origin: 'override' });
+    }
+    const snapshot = cached ? cached.snapshot_version : bundled.snapshot_version;
+    return { snapshot: config?.rates ? `${snapshot}+overrides` : snapshot, entries };
+}
+/** Cost of usage units in integer micro-dollars; null = unpriced. */
+export function priceUnits(units, rates) {
+    if (units.kind === 'tokens') {
+        const entry = rates.entries.get(normalizeModelId(units.model));
+        if (!entry)
+            return null;
+        const r = entry.rate;
+        if (r.input_per_mtok === undefined || r.output_per_mtok === undefined)
+            return null;
+        const micro = (units.input_tokens * r.input_per_mtok) +
+            (units.output_tokens * r.output_per_mtok) +
+            (units.cache_read_tokens * (r.cache_read_per_mtok ?? 0)) +
+            (units.cache_write_tokens * (r.cache_write_per_mtok ?? 0));
+        // rate is $/MTok → micro-dollars = tokens * rate ($/MTok) * 1e6 / 1e6.
+        return Math.round(micro);
+    }
+    const entry = rates.entries.get('kiro-credit');
+    if (!entry || entry.rate.per_unit === undefined)
+        return null;
+    return Math.round(units.credits * entry.rate.per_unit * 1_000_000);
+}
+export function microToUsd(micro) {
+    return `$${(micro / 1_000_000).toFixed(2)}`;
+}
+/**
+ * Fetch the LiteLLM pricing JSON and cache the models we know how to price.
+ * HTTPS only, redirects refused, 5MB cap, schema-validated, temp-then-rename.
+ * Throws with a user-safe message on any failure — callers keep the old table.
+ */
+export async function updateRates(projectRoot, config) {
+    const url = config?.rates_url ?? DEFAULT_RATES_URL;
+    if (!url.startsWith('https://'))
+        throw new Error('rates_url must be https://');
+    const res = await fetch(url, { redirect: 'error' });
+    if (!res.ok)
+        throw new Error(`rate source returned ${res.status}`);
+    const text = await res.text();
+    if (text.length > FETCH_SIZE_CAP)
+        throw new Error('rate source exceeds size cap');
+    let raw;
+    try {
+        raw = JSON.parse(text);
+    }
+    catch {
+        throw new Error('rate source is not valid JSON');
+    }
+    const bundled = loadBundled();
+    const rates = {};
+    // Extract only models present in the bundled table (extract-known-only, DD7):
+    // upstream keys are matched post-normalization.
+    const wanted = new Set(Object.keys(bundled.rates));
+    for (const [key, value] of Object.entries(raw)) {
+        const norm = normalizeModelId(key);
+        if (!wanted.has(norm))
+            continue;
+        const e = value;
+        if (typeof e.input_cost_per_token !== 'number' || typeof e.output_cost_per_token !== 'number')
+            continue;
+        const entry = {
+            input_per_mtok: e.input_cost_per_token * 1_000_000,
+            output_per_mtok: e.output_cost_per_token * 1_000_000,
+        };
+        if (typeof e.cache_read_input_token_cost === 'number') {
+            entry.cache_read_per_mtok = e.cache_read_input_token_cost * 1_000_000;
+        }
+        if (typeof e.cache_creation_input_token_cost === 'number') {
+            entry.cache_write_per_mtok = e.cache_creation_input_token_cost * 1_000_000;
+        }
+        if (isRateEntry(entry))
+            rates[norm] = entry;
+    }
+    if (Object.keys(rates).length === 0) {
+        throw new Error('rate source contained no known models');
+    }
+    // Unit-priced entries (kiro-credit) have no public feed — carry from bundled.
+    for (const [model, rate] of Object.entries(bundled.rates)) {
+        if (rate.per_unit !== undefined && !(model in rates))
+            rates[model] = rate;
+    }
+    const snapshot = {
+        snapshot_version: `litellm-${new Date().toISOString().slice(0, 10)}`,
+        effective_date: new Date().toISOString().slice(0, 10),
+        rates,
+    };
+    const target = cachedRatesPath(projectRoot);
+    mkdirSync(dirname(target), { recursive: true });
+    const tmp = target + '.tmp';
+    writeFileSync(tmp, JSON.stringify(snapshot, null, 2) + '\n');
+    renameSync(tmp, target);
+    return snapshot;
+}
+//# sourceMappingURL=rates.js.map

package/dist/cost/rates.js.map

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

package/dist/cost/recorder.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Cost recorder: orchestrates capture from provider extraction to ledger
+ * appends. Owns all attribution — providers stay platform-pure (DD3).
+ *
+ * Flow (design §4.1): validate input → acquire per-session lock → read
+ * newest cursor (instance ledgers + unattributed) → provider.extract →
+ * split segments by claim intervals × phase transitions → merge per
+ * (instance, phase, model) → validate + append. The ledger append is the
+ * atomic commit point (DD1); re-runs after a crash re-extract from the
+ * last committed cursor.
+ *
+ * Failures append structured lines to .aidlc/cost/capture.log — never raw
+ * transcript or ledger content (SR1).
+ */
+import { type ProviderEnv } from './providers/provider.js';
+import type { RecordInput } from './types.js';
+export declare function captureLogPath(projectRoot: string): string;
+export declare function logCapture(projectRoot: string, stage: string, errorCode: string, counts?: Record<string, number>): void;
+/** Most recent capture-log line, for surfacing in `aidlc cost` (FR3.10). */
+export declare function lastCaptureError(projectRoot: string): {
+    timestamp: string;
+    stage: string;
+    error_code: string;
+} | null;
+/** Try to take the per-session lock. Returns a release fn, or null if held. */
+export declare function acquireLock(projectRoot: string, sessionId: string): (() => void) | null;
+interface PhaseWindow {
+    phase: string;
+    from: number;
+    /** Exclusive upper bound; Infinity for the current phase. */
+    to: number;
+}
+/** Build phase windows for an instance from its transitions.log. */
+export declare function phaseWindows(projectRoot: string, instance: string, initialPhase: string): PhaseWindow[];
+/** All instances that have session events mentioning this session. */
+export declare function instancesForSession(projectRoot: string, sessionId: string): string[];
+export interface RecordResult {
+    appended: number;
+    unattributed: number;
+    instances: string[];
+}
+export interface RecordOptions {
+    projectRoot: string;
+    provider: string;
+    input: RecordInput;
+    claimTimeoutMinutes: number;
+    env?: ProviderEnv;
+    now?: Date;
+}
+/**
+ * Run one capture pass for a session. Returns counts, or null when the
+ * lock is held elsewhere (the holder re-checks before releasing, so a
+ * firing lost to the lock is still captured — design §4.2).
+ */
+export declare function recordUsage(opts: RecordOptions): Promise<RecordResult | null>;
+export {};
+//# sourceMappingURL=recorder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../../src/cost/recorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAoBH,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAS9C,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,UAAU,CACxB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAClC,IAAI,CA+BN;AAED,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAarH;AAUD,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAqCvF;AAMD,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,WAAW,EAAE,CAiBvG;AASD,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CASpF;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,WAAW,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAkCnF"}