@esankhan3/anvil-agent-core 0.1.0

package/dist/__tests__/router-resolver.test.js

@@ -0,0 +1,110 @@
+/**
+ * Phase 3 — resolver: capability + complexity + prefer → routing chain.
+ *
+ * Pure function tests; no I/O. Each test composes a small registry inline.
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { resolveModel, ModelResolutionError, } from '../router/resolver.js';
+import { DEFAULT_WALKER_CONFIG } from '../router/model-registry.js';
+function entry(over) {
+    return {
+        id: 'x',
+        provider: 'ollama',
+        tier: 'local',
+        capabilities: ['code'],
+        complexity_max: 'M',
+        vram_gb: 1,
+        exclusive_slot: false,
+        ...over,
+    };
+}
+function reg(...models) {
+    return { models, walker: { ...DEFAULT_WALKER_CONFIG } };
+}
+describe('resolveModel — happy path', () => {
+    it('returns primary + fallbacks across tier preference', () => {
+        const r = resolveModel({ capability: 'code', complexity: 'S', prefer: ['local', 'cheap', 'premium'] }, reg(entry({ id: 'qwen-7b', tier: 'local' }), entry({ id: 'haiku', tier: 'cheap', provider: 'claude' }), entry({ id: 'opus', tier: 'premium', provider: 'claude', complexity_max: 'L' })));
+        assert.equal(r.primary, 'qwen-7b');
+        assert.deepEqual(r.fallbacks.map((f) => f.model), ['haiku', 'opus']);
+    });
+    it('returns only the primary when one tier matches and prefer is single', () => {
+        const r = resolveModel({ capability: 'code', complexity: 'S', prefer: ['premium'] }, reg(entry({ id: 'qwen-7b', tier: 'local' }), entry({ id: 'opus', tier: 'premium', provider: 'claude', complexity_max: 'L' })));
+        assert.equal(r.primary, 'opus');
+        assert.deepEqual(r.fallbacks, []);
+    });
+    it('preserves yaml-declared order within a tier', () => {
+        const r = resolveModel({ capability: 'code', complexity: 'S', prefer: ['local'] }, reg(entry({ id: 'first', tier: 'local' }), entry({ id: 'second', tier: 'local' }), entry({ id: 'third', tier: 'local' })));
+        assert.equal(r.primary, 'first');
+        assert.deepEqual(r.fallbacks.map((f) => f.model), ['second', 'third']);
+    });
+    it('walks tiers in declared `prefer` order (premium-first valid)', () => {
+        const r = resolveModel({ capability: 'code', complexity: 'S', prefer: ['premium', 'local'] }, reg(entry({ id: 'qwen-7b', tier: 'local' }), entry({ id: 'opus', tier: 'premium', provider: 'claude', complexity_max: 'L' })));
+        assert.equal(r.primary, 'opus');
+        assert.deepEqual(r.fallbacks.map((f) => f.model), ['qwen-7b']);
+    });
+    it('skips tiers absent from prefer entirely', () => {
+        const r = resolveModel({ capability: 'code', complexity: 'S', prefer: ['local'] }, reg(entry({ id: 'qwen-7b', tier: 'local' }), entry({ id: 'haiku', tier: 'cheap', provider: 'claude' }), entry({ id: 'opus', tier: 'premium', provider: 'claude', complexity_max: 'L' })));
+        assert.equal(r.primary, 'qwen-7b');
+        assert.deepEqual(r.fallbacks, []);
+    });
+});
+describe('resolveModel — filters', () => {
+    it('rejects models lacking the requested capability', () => {
+        assert.throws(() => resolveModel({ capability: 'vision', complexity: 'S', prefer: ['local'] }, reg(entry({ id: 'qwen-7b', tier: 'local', capabilities: ['code'] }))), ModelResolutionError);
+    });
+    it('rejects models whose complexity_max is below requested', () => {
+        assert.throws(() => resolveModel({ capability: 'code', complexity: 'L', prefer: ['local'] }, reg(entry({ id: 'qwen-7b', tier: 'local', complexity_max: 'M' }))), ModelResolutionError);
+    });
+    it('respects minContextTokens when set', () => {
+        const r = resolveModel({ capability: 'code', complexity: 'S', prefer: ['local', 'premium'], minContextTokens: 200_000 }, reg(entry({ id: 'qwen-7b', tier: 'local', context_tokens: 8192 }), entry({
+            id: 'opus',
+            tier: 'premium',
+            provider: 'claude',
+            complexity_max: 'L',
+            context_tokens: 200_000,
+        })));
+        assert.equal(r.primary, 'opus');
+        assert.deepEqual(r.fallbacks, []);
+    });
+    it('omits models marked unavailable in the availability map', () => {
+        const registry = reg(entry({ id: 'down', tier: 'local' }), entry({ id: 'up', tier: 'local' }));
+        registry.availability = new Map();
+        registry.availability.set('down', { available: false, lastChecked: Date.now() });
+        registry.availability.set('up', { available: true, lastChecked: Date.now() });
+        const r = resolveModel({ capability: 'code', complexity: 'S', prefer: ['local'] }, registry);
+        assert.equal(r.primary, 'up');
+        assert.deepEqual(r.fallbacks, []);
+    });
+    it('treats missing availability entry as available (opt-in unavailability)', () => {
+        const registry = reg(entry({ id: 'untouched', tier: 'local' }));
+        registry.availability = new Map(); // empty map
+        const r = resolveModel({ capability: 'code', complexity: 'S', prefer: ['local'] }, registry);
+        assert.equal(r.primary, 'untouched');
+    });
+});
+describe('resolveModel — empty result diagnostics', () => {
+    it('throws ModelResolutionError with per-step counts', () => {
+        let caught = null;
+        try {
+            resolveModel({ capability: 'vision', complexity: 'L', prefer: ['local'] }, reg(entry({ id: 'a', tier: 'local', capabilities: ['code'] }), entry({ id: 'b', tier: 'local', capabilities: ['vision'], complexity_max: 'S' })));
+        }
+        catch (e) {
+            caught = e;
+        }
+        assert.ok(caught, 'should throw');
+        assert.equal(caught?.diagnostic.totalInRegistry, 2);
+        assert.equal(caught?.diagnostic.matchedCapability, 1, 'only b has vision');
+        assert.equal(caught?.diagnostic.matchedComplexity, 0, 'b is S, requested L');
+        assert.match(caught.message, /no model matches/);
+        assert.match(caught.message, /vision/);
+        assert.match(caught.message, /complexity: L/);
+    });
+    it('throws when registry is empty', () => {
+        assert.throws(() => resolveModel({ capability: 'code', complexity: 'S', prefer: ['local'] }, reg()), ModelResolutionError);
+    });
+    it('throws when no model matches the prefer tiers', () => {
+        assert.throws(() => resolveModel({ capability: 'code', complexity: 'S', prefer: ['premium'] }, reg(entry({ id: 'qwen-7b', tier: 'local' }))), ModelResolutionError);
+    });
+});
+//# sourceMappingURL=router-resolver.test.js.map

package/dist/__tests__/router-resolver.test.js.map

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

package/dist/__tests__/router-retry.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Phase 2 tests for the per-error retry engine.
+ *
+ * Uses a deterministic fake clock so backoff delays don't slow the suite.
+ */
+export {};
+//# sourceMappingURL=router-retry.test.d.ts.map

package/dist/__tests__/router-retry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router-retry.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/router-retry.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/__tests__/router-retry.test.js

@@ -0,0 +1,302 @@
+/**
+ * Phase 2 tests for the per-error retry engine.
+ *
+ * Uses a deterministic fake clock so backoff delays don't slow the suite.
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { runWithRetry, DEFAULT_RETRY_POLICY, LlmRouter, } from '../router/index.js';
+// ---------------------------------------------------------------------------
+// Fakes
+// ---------------------------------------------------------------------------
+const fakeCapabilities = {
+    tier: 'function-calling',
+    streaming: false,
+    toolUse: false,
+    fileSystem: false,
+    shellExecution: false,
+    sessionResume: false,
+};
+function makeFakeAdapter(responses) {
+    let calls = 0;
+    const adapter = {
+        provider: 'claude',
+        capabilities: fakeCapabilities,
+        supportsModel: () => true,
+        getModelPricing: () => null,
+        checkAvailability: async () => ({ available: true }),
+        invokeStream: async function* () {
+            /* unused */
+        },
+        invoke: async (_opts) => {
+            const r = responses[calls];
+            calls += 1;
+            if (!r)
+                throw new Error('fake adapter: ran out of responses');
+            if (r.err)
+                throw r.err;
+            return r.ok;
+        },
+    };
+    return {
+        adapter,
+        get calls() {
+            return calls;
+        },
+    };
+}
+function fakeResult() {
+    return {
+        text: 'hi',
+        toolCalls: [],
+        usage: { inputTokens: 1, outputTokens: 1 },
+        costUsd: 0.001,
+        durationMs: 1,
+        provider: 'claude',
+        model: 'claude-sonnet-4-6',
+        finishReason: 'end',
+    };
+}
+function makeFakeClock() {
+    let nowMs = 0;
+    const delays = [];
+    return {
+        delays,
+        now: () => nowMs,
+        sleep: async (ms) => {
+            delays.push(ms);
+            nowMs += ms;
+        },
+    };
+}
+const policyFor = (cls) => DEFAULT_RETRY_POLICY[cls];
+// ---------------------------------------------------------------------------
+// runWithRetry direct tests
+// ---------------------------------------------------------------------------
+describe('runWithRetry', () => {
+    it('returns immediately when fn succeeds first try', async () => {
+        const clock = makeFakeClock();
+        const out = await runWithRetry(async () => 42, { policyFor, sleep: clock.sleep, now: clock.now });
+        assert.equal(out.result, 42);
+        assert.equal(out.attempts.length, 1);
+        assert.equal(clock.delays.length, 0);
+    });
+    it('classifies 429 → rate_limit and retries 5 times exponentially', async () => {
+        const clock = makeFakeClock();
+        let calls = 0;
+        const out = await runWithRetry(async () => {
+            calls += 1;
+            if (calls <= 3) {
+                throw Object.assign(new Error('rate limited'), { status: 429 });
+            }
+            return 'ok';
+        }, { policyFor, sleep: clock.sleep, now: clock.now, random: () => 0.5 });
+        assert.equal(out.result, 'ok');
+        assert.equal(out.attempts.length, 4);
+        // attempts 0-2 errored; attempt 3 succeeded. 3 sleeps occurred.
+        assert.equal(clock.delays.length, 3);
+        // No jitter (random=0.5 → 0 deviation), exponential 1000/2000/4000.
+        assert.deepEqual(clock.delays, [1000, 2000, 4000]);
+        assert.equal(out.attempts[0].errorClass, 'rate_limit');
+    });
+    it('honors Retry-After header over computed backoff', async () => {
+        const clock = makeFakeClock();
+        let calls = 0;
+        await runWithRetry(async () => {
+            calls += 1;
+            if (calls === 1) {
+                throw Object.assign(new Error('429'), {
+                    status: 429,
+                    headers: { 'retry-after': '7' },
+                });
+            }
+            return 'ok';
+        }, { policyFor, sleep: clock.sleep, now: clock.now, random: () => 0.5 });
+        assert.deepEqual(clock.delays, [7000]); // 7s honored, not 1s exponential
+    });
+    it('does NOT retry on auth (401)', async () => {
+        const clock = makeFakeClock();
+        let calls = 0;
+        const out = await runWithRetry(async () => {
+            calls += 1;
+            throw Object.assign(new Error('unauthorized'), { status: 401 });
+        }, { policyFor, sleep: clock.sleep, now: clock.now });
+        assert.equal(calls, 1);
+        assert.equal(out.attempts.length, 1);
+        assert.equal(out.attempts[0].errorClass, 'auth');
+        assert.ok(out.error);
+        assert.equal(clock.delays.length, 0);
+    });
+    it('does NOT retry on content_policy', async () => {
+        const clock = makeFakeClock();
+        let calls = 0;
+        const out = await runWithRetry(async () => {
+            calls += 1;
+            throw Object.assign(new Error('safety filter rejected'), {
+                status: 400,
+                error: { type: 'content_filter' },
+            });
+        }, { policyFor, sleep: clock.sleep, now: clock.now });
+        assert.equal(calls, 1);
+        assert.equal(out.attempts[0].errorClass, 'content_policy');
+        assert.ok(out.error);
+    });
+    it('5xx three times then succeeds', async () => {
+        const clock = makeFakeClock();
+        let calls = 0;
+        const out = await runWithRetry(async () => {
+            calls += 1;
+            if (calls <= 3)
+                throw Object.assign(new Error('boom'), { status: 503 });
+            return 'ok';
+        }, { policyFor, sleep: clock.sleep, now: clock.now, random: () => 0.5 });
+        assert.equal(out.result, 'ok');
+        assert.equal(calls, 4);
+        // server_5xx: 200, 400, 800 (exponential, base 200)
+        assert.deepEqual(clock.delays, [200, 400, 800]);
+    });
+    it('caps exponential delay at maxMs', async () => {
+        const clock = makeFakeClock();
+        const policy = {
+            attempts: 3,
+            backoff: 'exponential',
+            baseMs: 1000,
+            maxMs: 1500,
+            jitter: false,
+        };
+        let calls = 0;
+        await runWithRetry(async () => {
+            calls += 1;
+            if (calls < 4)
+                throw Object.assign(new Error(''), { status: 503 });
+            return 'ok';
+        }, {
+            policyFor: () => policy,
+            sleep: clock.sleep,
+            now: clock.now,
+        });
+        // 1000 capped to 1500, 2000 → 1500, 4000 → 1500
+        assert.deepEqual(clock.delays, [1000, 1500, 1500]);
+    });
+    it('linear backoff multiplies baseMs by attempt number', async () => {
+        const clock = makeFakeClock();
+        const policy = {
+            attempts: 3,
+            backoff: 'linear',
+            baseMs: 500,
+            jitter: false,
+        };
+        let calls = 0;
+        await runWithRetry(async () => {
+            calls += 1;
+            if (calls < 4)
+                throw Object.assign(new Error(''), { code: 'ETIMEDOUT' });
+            return 'ok';
+        }, { policyFor: () => policy, sleep: clock.sleep, now: clock.now });
+        // 500*1, 500*2, 500*3
+        assert.deepEqual(clock.delays, [500, 1000, 1500]);
+    });
+});
+// ---------------------------------------------------------------------------
+// LlmRouter.invoke single-adapter integration
+// ---------------------------------------------------------------------------
+describe('LlmRouter.invoke (Phase 2 single-adapter)', () => {
+    it('routes by tag to the configured primary model', async () => {
+        const { adapter } = makeFakeAdapter([{ ok: fakeResult() }]);
+        const config = {
+            routes: [{ tag: 'planner', primary: 'claude-sonnet-4-6' }],
+            retryPolicy: DEFAULT_RETRY_POLICY,
+        };
+        const router = new LlmRouter({
+            config,
+            resolver: { resolve: (_id) => adapter },
+        });
+        const out = await router.invoke({ tag: 'planner', prompt: 'hello' });
+        assert.equal(out.result?.text, 'hi');
+        assert.equal(out.attempts.length, 1);
+        assert.equal(out.attempts[0].fallbackIndex, 0);
+        assert.equal(out.totalCostUsd, 0.001);
+    });
+    it('honors raw-model pin escape hatch', async () => {
+        let captured = '';
+        const adapter = {
+            provider: 'openai',
+            capabilities: fakeCapabilities,
+            supportsModel: () => true,
+            getModelPricing: () => null,
+            checkAvailability: async () => ({ available: true }),
+            invokeStream: async function* () { },
+            invoke: async (opts) => {
+                captured = opts.model;
+                return { ...fakeResult(), provider: 'openai' };
+            },
+        };
+        const router = new LlmRouter({
+            config: {
+                routes: [{ tag: 'planner', primary: 'claude-sonnet-4-6' }],
+                retryPolicy: DEFAULT_RETRY_POLICY,
+            },
+            resolver: { resolve: () => adapter },
+        });
+        await router.invoke({ tag: 'planner', model: 'gpt-4o', prompt: 'q' });
+        assert.equal(captured, 'gpt-4o');
+    });
+    it('throws RouterError with attempt history on terminal failure', async () => {
+        const fake = makeFakeAdapter([
+            { err: Object.assign(new Error('boom'), { status: 401 }) },
+        ]);
+        const router = new LlmRouter({
+            config: {
+                routes: [{ tag: 'planner', primary: 'claude-sonnet-4-6' }],
+                retryPolicy: DEFAULT_RETRY_POLICY,
+            },
+            resolver: { resolve: () => fake.adapter },
+        });
+        await assert.rejects(router.invoke({ tag: 'planner', prompt: 'q' }), (e) => {
+            assert.equal(e.name, 'RouterError');
+            const re = e;
+            assert.equal(re.attempts.length, 1);
+            assert.equal(re.attempts[0].errorClass, 'auth');
+            return true;
+        });
+    });
+    it('respects per-provider classifier override', async () => {
+        let calls = 0;
+        const adapter = {
+            provider: 'gemini',
+            capabilities: fakeCapabilities,
+            supportsModel: () => true,
+            getModelPricing: () => null,
+            checkAvailability: async () => ({ available: true }),
+            invokeStream: async function* () { },
+            invoke: async () => {
+                calls += 1;
+                if (calls === 1)
+                    throw new Error('quota exceeded'); // no status code
+                return fakeResult();
+            },
+        };
+        const clock = makeFakeClock();
+        const router = new LlmRouter({
+            config: {
+                routes: [{ tag: 'planner', primary: 'gemini-2.5-flash' }],
+                retryPolicy: DEFAULT_RETRY_POLICY,
+            },
+            resolver: { resolve: () => adapter },
+            sleep: clock.sleep,
+            now: clock.now,
+            random: () => 0.5,
+            errorClassifiers: {
+                gemini: (err) => {
+                    const msg = err.message ?? '';
+                    return /quota/i.test(msg) ? 'rate_limit' : undefined;
+                },
+            },
+        });
+        const out = await router.invoke({ tag: 'planner', prompt: 'q' });
+        assert.equal(out.result?.text, 'hi');
+        assert.equal(out.attempts.length, 2);
+        assert.equal(out.attempts[0].errorClass, 'rate_limit');
+    });
+});
+//# sourceMappingURL=router-retry.test.js.map

package/dist/__tests__/router-retry.test.js.map

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

package/dist/__tests__/router-scaffold.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Phase 1 smoke tests for `@esankhan3/anvil-agent-core/router`.
+ *
+ * Verifies:
+ *   1. Module barrel exports the canonical surface
+ *   2. Type round-trips (RouterConfig → LlmRouter → getConfig)
+ *   3. classifyError dispatches the documented status/code/name table
+ *   4. parseRetryAfterMs handles seconds + HTTP-date forms
+ */
+export {};
+//# sourceMappingURL=router-scaffold.test.d.ts.map

package/dist/__tests__/router-scaffold.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router-scaffold.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/router-scaffold.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/__tests__/router-scaffold.test.js

@@ -0,0 +1,103 @@
+/**
+ * Phase 1 smoke tests for `@esankhan3/anvil-agent-core/router`.
+ *
+ * Verifies:
+ *   1. Module barrel exports the canonical surface
+ *   2. Type round-trips (RouterConfig → LlmRouter → getConfig)
+ *   3. classifyError dispatches the documented status/code/name table
+ *   4. parseRetryAfterMs handles seconds + HTTP-date forms
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { LlmRouter, RouterError, classifyError, parseRetryAfterMs, ALL_ERROR_CLASSES, } from '../router/index.js';
+const defaultRetryPolicy = {
+    rate_limit: { attempts: 5, backoff: 'exponential', baseMs: 1000, maxMs: 30000 },
+    timeout: { attempts: 3, backoff: 'linear', baseMs: 500, maxMs: 5000 },
+    server_5xx: { attempts: 4, backoff: 'exponential', baseMs: 200, maxMs: 5000 },
+    auth: { attempts: 0, backoff: 'constant', baseMs: 0 },
+    content_policy: { attempts: 0, backoff: 'constant', baseMs: 0 },
+    invalid_request: { attempts: 0, backoff: 'constant', baseMs: 0 },
+    unknown: { attempts: 1, backoff: 'constant', baseMs: 1000 },
+};
+describe('router/index barrel', () => {
+    it('exports the documented public surface', () => {
+        assert.equal(typeof LlmRouter, 'function');
+        assert.equal(typeof RouterError, 'function');
+        assert.equal(typeof classifyError, 'function');
+        assert.equal(typeof parseRetryAfterMs, 'function');
+        assert.equal(ALL_ERROR_CLASSES.length, 7);
+    });
+});
+describe('LlmRouter scaffold', () => {
+    it('round-trips a minimal config through getConfig', () => {
+        const config = {
+            routes: [{ tag: 'planner', primary: 'claude-sonnet-4-6' }],
+            retryPolicy: defaultRetryPolicy,
+        };
+        const router = new LlmRouter({ config });
+        const snapshot = router.getConfig();
+        assert.deepEqual(snapshot.routes, config.routes);
+        assert.deepEqual(snapshot.retryPolicy, defaultRetryPolicy);
+    });
+    it('rejects invoke when no AdapterResolver is wired', async () => {
+        const router = new LlmRouter({
+            config: {
+                routes: [{ tag: 'noop', primary: 'm' }],
+                retryPolicy: defaultRetryPolicy,
+            },
+        });
+        await assert.rejects(router.invoke({ tag: 'noop', prompt: 'hi' }), /AdapterResolver/);
+    });
+});
+describe('classifyError', () => {
+    it('maps HTTP status codes', () => {
+        assert.equal(classifyError({ status: 429 }), 'rate_limit');
+        assert.equal(classifyError({ statusCode: 503 }), 'server_5xx');
+        assert.equal(classifyError({ status: 500 }), 'server_5xx');
+        assert.equal(classifyError({ status: 401 }), 'auth');
+        assert.equal(classifyError({ status: 403 }), 'auth');
+        assert.equal(classifyError({ status: 400 }), 'invalid_request');
+    });
+    it('detects content-policy hints inside 400 responses', () => {
+        assert.equal(classifyError({ status: 400, error: { type: 'content_filter' } }), 'content_policy');
+        assert.equal(classifyError({ status: 400, message: 'safety filter rejected the prompt' }), 'content_policy');
+    });
+    it('detects timeouts via name, code, or message', () => {
+        assert.equal(classifyError({ name: 'AbortError' }), 'timeout');
+        assert.equal(classifyError({ code: 'ETIMEDOUT' }), 'timeout');
+        assert.equal(classifyError({ message: 'socket hang up' }), 'timeout');
+    });
+    it('falls back to unknown when nothing matches', () => {
+        assert.equal(classifyError({ message: 'something weird' }), 'unknown');
+        assert.equal(classifyError(undefined), 'unknown');
+        assert.equal(classifyError(null), 'unknown');
+    });
+});
+describe('parseRetryAfterMs', () => {
+    it('parses seconds form', () => {
+        assert.equal(parseRetryAfterMs({ 'retry-after': '2' }), 2000);
+        assert.equal(parseRetryAfterMs({ 'Retry-After': '0.5' }), 500);
+    });
+    it('parses HTTP-date form', () => {
+        const future = new Date(Date.now() + 60_000).toUTCString();
+        const ms = parseRetryAfterMs({ 'retry-after': future });
+        assert.ok(ms !== null && ms > 50_000 && ms <= 60_000, `expected ~60000ms, got ${ms}`);
+    });
+    it('returns null when absent or unparseable', () => {
+        assert.equal(parseRetryAfterMs(undefined), null);
+        assert.equal(parseRetryAfterMs({}), null);
+        assert.equal(parseRetryAfterMs({ 'retry-after': 'not-a-date' }), null);
+    });
+});
+describe('RouterError', () => {
+    it('captures the attempt history', () => {
+        const err = new RouterError('all providers failed', {
+            attempts: [
+                { model: 'a', provider: 'claude', attemptIndex: 0, fallbackIndex: 0, durationMs: 10 },
+            ],
+        });
+        assert.equal(err.name, 'RouterError');
+        assert.equal(err.attempts.length, 1);
+    });
+});
+//# sourceMappingURL=router-scaffold.test.js.map

package/dist/__tests__/router-scaffold.test.js.map

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

package/dist/__tests__/router-spend-ledger.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Phase 4 tests for SpendLedger + budget enforcement.
+ *
+ * Uses on-disk temp SQLite files (better-sqlite3 doesn't support
+ * `:memory:` cleanly with WAL pragma). Each test gets its own file.
+ */
+export {};
+//# sourceMappingURL=router-spend-ledger.test.d.ts.map

package/dist/__tests__/router-spend-ledger.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router-spend-ledger.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/router-spend-ledger.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}