@esankhan3/anvil-agent-core 0.1.0

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

@@ -0,0 +1,283 @@
+/**
+ * Phase 5 tests for the fallback chain walker.
+ *
+ * Each test wires a per-model AdapterResolver that the LlmRouter consults
+ * step-by-step. We verify per-error gating, terminal short-circuiting,
+ * cost ledger consistency, and the maxFallbackCostUsd cap.
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdtempSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { LlmRouter, SpendLedger, DEFAULT_RETRY_POLICY, } from '../router/index.js';
+const fakeCapabilities = {
+    tier: 'function-calling',
+    streaming: false,
+    toolUse: false,
+    fileSystem: false,
+    shellExecution: false,
+    sessionResume: false,
+};
+function makeMatrix(models) {
+    const calls = {};
+    const resolver = {
+        resolve: (modelId) => {
+            const def = models[modelId];
+            if (!def)
+                throw new Error(`unknown model: ${modelId}`);
+            calls[modelId] = calls[modelId] ?? 0;
+            return {
+                provider: def.provider,
+                capabilities: fakeCapabilities,
+                supportsModel: () => true,
+                getModelPricing: () => null,
+                checkAvailability: async () => ({ available: true }),
+                invokeStream: async function* () { },
+                invoke: async (_opts) => {
+                    const idx = calls[modelId];
+                    calls[modelId] = idx + 1;
+                    const r = def.responses[idx];
+                    if (!r)
+                        throw new Error(`${modelId}: ran out of responses (idx=${idx})`);
+                    if (r.err)
+                        throw r.err();
+                    return r.ok();
+                },
+            };
+        },
+    };
+    return { resolver, calls };
+}
+function ok(model, costUsd = 0.001) {
+    return {
+        text: 'hi',
+        toolCalls: [],
+        usage: { inputTokens: 10, outputTokens: 5 },
+        costUsd,
+        durationMs: 1,
+        provider: 'claude',
+        model,
+        finishReason: 'end',
+    };
+}
+const baseConfig = (routes, extra = {}) => ({
+    routes,
+    retryPolicy: {
+        ...DEFAULT_RETRY_POLICY,
+        rate_limit: { ...DEFAULT_RETRY_POLICY.rate_limit, attempts: 0 }, // disable retry — test fallback walks directly
+        server_5xx: { ...DEFAULT_RETRY_POLICY.server_5xx, attempts: 0 },
+        timeout: { ...DEFAULT_RETRY_POLICY.timeout, attempts: 0 },
+        unknown: { ...DEFAULT_RETRY_POLICY.unknown, attempts: 0 },
+    },
+    ...extra,
+});
+const baseInvoke = { tag: 'planner', prompt: 'q' };
+// ---------------------------------------------------------------------------
+describe('LlmRouter fallback chain', () => {
+    it('falls back from rate_limit primary to second model', async () => {
+        const { resolver, calls } = makeMatrix({
+            sonnet: {
+                provider: 'claude',
+                responses: [{ err: () => Object.assign(new Error('429'), { status: 429 }) }],
+            },
+            haiku: {
+                provider: 'claude',
+                responses: [{ ok: () => ok('haiku') }],
+            },
+        });
+        const router = new LlmRouter({
+            config: baseConfig([
+                { tag: 'planner', primary: 'sonnet', fallbacks: [{ model: 'haiku', on: ['rate_limit'] }] },
+            ]),
+            resolver,
+        });
+        const out = await router.invoke(baseInvoke);
+        assert.equal(out.result?.model, 'haiku');
+        assert.equal(out.attempts.length, 2);
+        assert.equal(out.attempts[0].fallbackIndex, 0);
+        assert.equal(out.attempts[0].errorClass, 'rate_limit');
+        assert.equal(out.attempts[1].fallbackIndex, 1);
+        assert.equal(calls.sonnet, 1);
+        assert.equal(calls.haiku, 1);
+    });
+    it('terminal auth error short-circuits — no fallback walk', async () => {
+        const { resolver, calls } = makeMatrix({
+            sonnet: {
+                provider: 'claude',
+                responses: [{ err: () => Object.assign(new Error('401'), { status: 401 }) }],
+            },
+            haiku: {
+                provider: 'claude',
+                responses: [{ ok: () => ok('haiku') }],
+            },
+        });
+        const router = new LlmRouter({
+            config: baseConfig([
+                { tag: 'planner', primary: 'sonnet', fallbacks: [{ model: 'haiku' }] },
+            ]),
+            resolver,
+        });
+        await assert.rejects(router.invoke(baseInvoke), (e) => {
+            assert.equal(e.name, 'RouterError');
+            const re = e;
+            assert.equal(re.attempts.length, 1);
+            assert.equal(re.attempts[0].errorClass, 'auth');
+            return true;
+        });
+        assert.equal(calls.sonnet, 1);
+        assert.ok(!calls.haiku, 'haiku must not be called on auth failure');
+    });
+    it('content_policy never falls back cross-provider (security default)', async () => {
+        const { resolver, calls } = makeMatrix({
+            sonnet: {
+                provider: 'claude',
+                responses: [
+                    {
+                        err: () => Object.assign(new Error('safety filter rejected'), {
+                            status: 400,
+                            error: { type: 'content_filter' },
+                        }),
+                    },
+                ],
+            },
+            gpt: { provider: 'openai', responses: [{ ok: () => ok('gpt-4o') }] },
+        });
+        const router = new LlmRouter({
+            config: baseConfig([
+                { tag: 'planner', primary: 'sonnet', fallbacks: [{ model: 'gpt' }] },
+            ]),
+            resolver,
+        });
+        await assert.rejects(router.invoke(baseInvoke), /content_policy|safety|content policy|safety filter/i);
+        assert.ok(!calls.gpt, 'cross-provider fallback must not run on content_policy');
+    });
+    it('honors per-fallback `on` gates — skips non-matching steps', async () => {
+        const { resolver, calls } = makeMatrix({
+            a: {
+                provider: 'claude',
+                responses: [{ err: () => Object.assign(new Error('500'), { status: 500 }) }],
+            },
+            b: {
+                provider: 'claude',
+                responses: [{ ok: () => ok('b') }],
+            },
+            c: {
+                provider: 'openai',
+                responses: [{ ok: () => ok('c') }],
+            },
+        });
+        const router = new LlmRouter({
+            config: baseConfig([
+                {
+                    tag: 'planner',
+                    primary: 'a',
+                    fallbacks: [
+                        { model: 'b', on: ['rate_limit'] }, // not eligible — primary failed with 5xx
+                        { model: 'c' }, // eligible (no `on` = any retryable)
+                    ],
+                },
+            ]),
+            resolver,
+        });
+        const out = await router.invoke(baseInvoke);
+        assert.equal(out.result?.model, 'c');
+        assert.equal(out.attempts.length, 2);
+        assert.equal(out.attempts[1].provider, 'openai');
+        assert.ok(!calls.b, 'b should be skipped per `on: [rate_limit]` gate');
+    });
+    it('records spend for every step including failures', async () => {
+        const tempDir = mkdtempSync(join(tmpdir(), 'anvil-fallback-'));
+        try {
+            const ledger = new SpendLedger(join(tempDir, 'spend.sqlite'));
+            const { resolver } = makeMatrix({
+                sonnet: {
+                    provider: 'claude',
+                    responses: [{ err: () => Object.assign(new Error('429'), { status: 429 }) }],
+                },
+                haiku: { provider: 'claude', responses: [{ ok: () => ok('haiku', 0.0005) }] },
+            });
+            const router = new LlmRouter({
+                config: baseConfig([
+                    { tag: 'planner', primary: 'sonnet', fallbacks: [{ model: 'haiku' }] },
+                ]),
+                resolver,
+                ledger,
+            });
+            await router.invoke({ ...baseInvoke, runId: 'r-fb' });
+            assert.equal(ledger.count(), 2);
+            const rows = ledger.recent(10);
+            const sonnetRow = rows.find((r) => r.model === 'sonnet');
+            const haikuRow = rows.find((r) => r.model === 'haiku');
+            assert.equal(sonnetRow?.errorClass, 'rate_limit');
+            assert.equal(sonnetRow?.costUsd, 0);
+            assert.equal(sonnetRow?.fallbackIndex, 0);
+            assert.equal(haikuRow?.fallbackIndex, 1);
+            assert.ok(Math.abs((haikuRow?.costUsd ?? 0) - 0.0005) < 1e-9);
+            ledger.close();
+        }
+        finally {
+            rmSync(tempDir, { recursive: true, force: true });
+        }
+    });
+    it('aggregates attempts + cost in the final RouterError on full chain failure', async () => {
+        const { resolver } = makeMatrix({
+            a: {
+                provider: 'claude',
+                responses: [{ err: () => Object.assign(new Error('429'), { status: 429 }) }],
+            },
+            b: {
+                provider: 'openai',
+                responses: [{ err: () => Object.assign(new Error('500'), { status: 500 }) }],
+            },
+        });
+        const router = new LlmRouter({
+            config: baseConfig([
+                { tag: 'planner', primary: 'a', fallbacks: [{ model: 'b' }] },
+            ]),
+            resolver,
+        });
+        await assert.rejects(router.invoke(baseInvoke), (e) => {
+            assert.equal(e.name, 'RouterError');
+            const re = e;
+            assert.equal(re.attempts.length, 2);
+            assert.equal(re.attempts[0].errorClass, 'rate_limit');
+            assert.equal(re.attempts[1].errorClass, 'server_5xx');
+            return true;
+        });
+    });
+    it('walks the entire chain to exhaustion when no cap trips', async () => {
+        const { resolver, calls } = makeMatrix({
+            a: {
+                provider: 'claude',
+                responses: [{ err: () => Object.assign(new Error('500'), { status: 500 }) }],
+            },
+            b: {
+                provider: 'openai',
+                responses: [{ err: () => Object.assign(new Error('500'), { status: 500 }) }],
+            },
+            c: {
+                provider: 'gemini',
+                responses: [{ err: () => Object.assign(new Error('500'), { status: 500 }) }],
+            },
+        });
+        const router = new LlmRouter({
+            config: baseConfig([
+                { tag: 'planner', primary: 'a', fallbacks: [{ model: 'b' }, { model: 'c' }] },
+            ]),
+            resolver,
+        });
+        await assert.rejects(router.invoke(baseInvoke), (e) => {
+            const re = e;
+            assert.equal(re.attempts.length, 3);
+            assert.equal(re.attempts[0].provider, 'claude');
+            assert.equal(re.attempts[1].provider, 'openai');
+            assert.equal(re.attempts[2].provider, 'gemini');
+            return true;
+        });
+        assert.equal(calls.a, 1);
+        assert.equal(calls.b, 1);
+        assert.equal(calls.c, 1);
+    });
+});
+//# sourceMappingURL=router-fallback.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"router-fallback.test.js","sourceRoot":"","sources":["../../src/__tests__/router-fallback.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,OAAO,EACL,SAAS,EACT,WAAW,EACX,oBAAoB,GAErB,MAAM,oBAAoB,CAAC;AAc5B,MAAM,gBAAgB,GAAyB;IAC7C,IAAI,EAAE,kBAAkB;IACxB,SAAS,EAAE,KAAK;IAChB,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,KAAK;IACjB,cAAc,EAAE,KAAK;IACrB,aAAa,EAAE,KAAK;CACrB,CAAC;AAOF,SAAS,UAAU,CACjB,MAA8E;IAE9E,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,MAAM,QAAQ,GAAoB;QAChC,OAAO,EAAE,CAAC,OAAe,EAAiB,EAAE;YAC1C,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;YAC5B,IAAI,CAAC,GAAG;gBAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,OAAO,EAAE,CAAC,CAAC;YACvD,KAAK,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACrC,OAAO;gBACL,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,YAAY,EAAE,gBAAgB;gBAC9B,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI;gBACzB,eAAe,EAAE,GAAG,EAAE,CAAC,IAAI;gBAC3B,iBAAiB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;gBACpD,YAAY,EAAE,KAAK,SAAS,CAAC,MAAK,CAAC;gBACnC,MAAM,EAAE,KAAK,EAAE,KAAiC,EAAyB,EAAE;oBACzE,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;oBAC3B,KAAK,CAAC,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;oBACzB,MAAM,CAAC,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;oBAC7B,IAAI,CAAC,CAAC;wBAAE,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,+BAA+B,GAAG,GAAG,CAAC,CAAC;oBACzE,IAAI,CAAC,CAAC,GAAG;wBAAE,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC;oBACzB,OAAO,CAAC,CAAC,EAAG,EAAE,CAAC;gBACjB,CAAC;aACF,CAAC;QACJ,CAAC;KACF,CAAC;IACF,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED,SAAS,EAAE,CAAC,KAAa,EAAE,OAAO,GAAG,KAAK;IACxC,OAAO;QACL,IAAI,EAAE,IAAI;QACV,SAAS,EAAE,EAAE;QACb,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE;QAC3C,OAAO;QACP,UAAU,EAAE,CAAC;QACb,QAAQ,EAAE,QAAQ;QAClB,KAAK;QACL,YAAY,EAAE,KAAK;KACpB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,GAAG,CACjB,MAA8B,EAC9B,QAA+B,EAAE,EACnB,EAAE,CAAC,CAAC;IAClB,MAAM;IACN,WAAW,EAAE;QACX,GAAG,oBAAoB;QACvB,UAAU,EAAE,EAAE,GAAG,oBAAoB,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,+CAA+C;QAChH,UAAU,EAAE,EAAE,GAAG,oBAAoB,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC,EAAE;QAC/D,OAAO,EAAE,EAAE,GAAG,oBAAoB,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE;QACzD,OAAO,EAAE,EAAE,GAAG,oBAAoB,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE;KAC1D;IACD,GAAG,KAAK;CACT,CAAC,CAAC;AAEH,MAAM,UAAU,GAAe,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;AAE/D,8EAA8E;AAE9E,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC;YACrC,MAAM,EAAE;gBACN,QAAQ,EAAE,QAAQ;gBAClB,SAAS,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;aAC7E;YACD,KAAK,EAAE;gBACL,QAAQ,EAAE,QAAQ;gBAClB,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;aACvC;SACF,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;YAC3B,MAAM,EAAE,UAAU,CAAC;gBACjB,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE;aAC3F,CAAC;YACF,QAAQ;SACT,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACzC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAC/C,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QACvD,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAC/C,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC;YACrC,MAAM,EAAE;gBACN,QAAQ,EAAE,QAAQ;gBAClB,SAAS,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;aAC7E;YACD,KAAK,EAAE;gBACL,QAAQ,EAAE,QAAQ;gBAClB,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;aACvC;SACF,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;YAC3B,MAAM,EAAE,UAAU,CAAC;gBACjB,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE;aACvE,CAAC;YACF,QAAQ;SACT,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAQ,EAAE,EAAE;YAC3D,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;YACpC,MAAM,EAAE,GAAG,CAAgB,CAAC;YAC5B,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACpC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YAChD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,0CAA0C,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;QACjF,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC;YACrC,MAAM,EAAE;gBACN,QAAQ,EAAE,QAAQ;gBAClB,SAAS,EAAE;oBACT;wBACE,GAAG,EAAE,GAAG,EAAE,CACR,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,wBAAwB,CAAC,EAAE;4BACjD,MAAM,EAAE,GAAG;4BACX,KAAK,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE;yBAClC,CAAC;qBACL;iBACF;aACF;YACD,GAAG,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE;SACrE,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;YAC3B,MAAM,EAAE,UAAU,CAAC;gBACjB,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE;aACrE,CAAC;YACF,QAAQ;SACT,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,qDAAqD,CAAC,CAAC;QACvG,MAAM,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,wDAAwD,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC;YACrC,CAAC,EAAE;gBACD,QAAQ,EAAE,QAAQ;gBAClB,SAAS,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;aAC7E;YACD,CAAC,EAAE;gBACD,QAAQ,EAAE,QAAQ;gBAClB,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;aACnC;YACD,CAAC,EAAE;gBACD,QAAQ,EAAE,QAAQ;gBAClB,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;aACnC;SACF,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;YAC3B,MAAM,EAAE,UAAU,CAAC;gBACjB;oBACE,GAAG,EAAE,SAAS;oBACd,OAAO,EAAE,GAAG;oBACZ,SAAS,EAAE;wBACT,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE,EAAE,yCAAyC;wBAC7E,EAAE,KAAK,EAAE,GAAG,EAAE,EAAsB,qCAAqC;qBAC1E;iBACF;aACF,CAAC;YACF,QAAQ;SACT,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QACrC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACjD,MAAM,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,iDAAiD,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;QAC/D,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;YAC9D,MAAM,EAAE,QAAQ,EAAE,GAAG,UAAU,CAAC;gBAC9B,MAAM,EAAE;oBACN,QAAQ,EAAE,QAAQ;oBAClB,SAAS,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;iBAC7E;gBACD,KAAK,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE;aAC9E,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;gBAC3B,MAAM,EAAE,UAAU,CAAC;oBACjB,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE;iBACvE,CAAC;gBACF,QAAQ;gBACR,MAAM;aACP,CAAC,CAAC;YACH,MAAM,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YACtD,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;YAChC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC;YACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC;YACvD,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;YAClD,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;YACpC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC;YAC1C,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC;YACzC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,OAAO,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;YAC9D,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2EAA2E,EAAE,KAAK,IAAI,EAAE;QACzF,MAAM,EAAE,QAAQ,EAAE,GAAG,UAAU,CAAC;YAC9B,CAAC,EAAE;gBACD,QAAQ,EAAE,QAAQ;gBAClB,SAAS,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;aAC7E;YACD,CAAC,EAAE;gBACD,QAAQ,EAAE,QAAQ;gBAClB,SAAS,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;aAC7E;SACF,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;YAC3B,MAAM,EAAE,UAAU,CAAC;gBACjB,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE;aAC9D,CAAC;YACF,QAAQ;SACT,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAQ,EAAE,EAAE;YAC3D,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;YACpC,MAAM,EAAE,GAAG,CAAgB,CAAC;YAC5B,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACpC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;YACtD,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;YACtD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACtE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC;YACrC,CAAC,EAAE;gBACD,QAAQ,EAAE,QAAQ;gBAClB,SAAS,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;aAC7E;YACD,CAAC,EAAE;gBACD,QAAQ,EAAE,QAAQ;gBAClB,SAAS,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;aAC7E;YACD,CAAC,EAAE;gBACD,QAAQ,EAAE,QAAQ;gBAClB,SAAS,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;aAC7E;SACF,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;YAC3B,MAAM,EAAE,UAAU,CAAC;gBACjB,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE;aAC9E,CAAC;YACF,QAAQ;SACT,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAQ,EAAE,EAAE;YAC3D,MAAM,EAAE,GAAG,CAAgB,CAAC;YAC5B,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACpC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAChD,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAChD,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAChD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/router-local-executor.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Phase 4 — local executor: single-slot FIFO + same-id no-evict + error
+ * recovery.
+ */
+export {};
+//# sourceMappingURL=router-local-executor.test.d.ts.map

package/dist/__tests__/router-local-executor.test.d.ts.map

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

package/dist/__tests__/router-local-executor.test.js

@@ -0,0 +1,193 @@
+/**
+ * Phase 4 — local executor: single-slot FIFO + same-id no-evict + error
+ * recovery.
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { LocalExecutor } from '../router/local-executor.js';
+function deferred() {
+    let resolve;
+    let reject;
+    const promise = new Promise((res, rej) => {
+        resolve = res;
+        reject = rej;
+    });
+    return { promise, resolve, reject };
+}
+describe('LocalExecutor — single call', () => {
+    it('runs fn and updates loaded on a single call', async () => {
+        const evictions = [];
+        const exec = new LocalExecutor({ evict: async (id) => { evictions.push(id); } });
+        const result = await exec.withModel('qwen', async () => 'ok');
+        assert.equal(result, 'ok');
+        assert.equal(exec.inspect().loaded, 'qwen');
+        assert.deepEqual(evictions, []);
+    });
+    it('does not evict on first load (no previous model)', async () => {
+        const evictions = [];
+        const exec = new LocalExecutor({ evict: async (id) => { evictions.push(id); } });
+        await exec.withModel('first', async () => undefined);
+        assert.deepEqual(evictions, []);
+    });
+});
+describe('LocalExecutor — eviction', () => {
+    it('evicts the previous model when switching ids', async () => {
+        const evictions = [];
+        const exec = new LocalExecutor({ evict: async (id) => { evictions.push(id); } });
+        await exec.withModel('qwen', async () => undefined);
+        await exec.withModel('gemma', async () => undefined);
+        assert.deepEqual(evictions, ['qwen']);
+        assert.equal(exec.inspect().loaded, 'gemma');
+    });
+    it('does NOT evict when the same id is reused consecutively', async () => {
+        const evictions = [];
+        const exec = new LocalExecutor({ evict: async (id) => { evictions.push(id); } });
+        await exec.withModel('qwen', async () => undefined);
+        await exec.withModel('qwen', async () => undefined);
+        await exec.withModel('qwen', async () => undefined);
+        assert.deepEqual(evictions, []);
+        assert.equal(exec.inspect().loaded, 'qwen');
+    });
+    it('chains evictions across multiple distinct ids', async () => {
+        const evictions = [];
+        const exec = new LocalExecutor({ evict: async (id) => { evictions.push(id); } });
+        await exec.withModel('a', async () => undefined);
+        await exec.withModel('b', async () => undefined);
+        await exec.withModel('c', async () => undefined);
+        await exec.withModel('a', async () => undefined);
+        assert.deepEqual(evictions, ['a', 'b', 'c']);
+        assert.equal(exec.inspect().loaded, 'a');
+    });
+});
+describe('LocalExecutor — FIFO + concurrency', () => {
+    it('serializes parallel calls to the same id (no overlap)', async () => {
+        const exec = new LocalExecutor();
+        const order = [];
+        const d1 = deferred();
+        const d2 = deferred();
+        const p1 = exec.withModel('qwen', async () => {
+            order.push('start1');
+            await d1.promise;
+            order.push('end1');
+        });
+        const p2 = exec.withModel('qwen', async () => {
+            order.push('start2');
+            await d2.promise;
+            order.push('end2');
+        });
+        // Yield twice so the queue's microtask plumbing can run.
+        await Promise.resolve();
+        await Promise.resolve();
+        assert.deepEqual(order, ['start1'], 'second call must wait for the slot');
+        d1.resolve();
+        await p1;
+        // After p1 settles, the executor pumps p2 (same id → no evict).
+        await Promise.resolve();
+        await Promise.resolve();
+        assert.deepEqual(order, ['start1', 'end1', 'start2']);
+        d2.resolve();
+        await p2;
+        assert.deepEqual(order, ['start1', 'end1', 'start2', 'end2']);
+    });
+    it('preserves enqueue order even with cross-id swaps', async () => {
+        const evictions = [];
+        const exec = new LocalExecutor({ evict: async (id) => { evictions.push(id); } });
+        const callOrder = [];
+        const ps = ['a', 'b', 'a', 'c', 'a'].map((id, i) => exec.withModel(id, async () => {
+            callOrder.push(`${id}#${i}`);
+        }));
+        await Promise.all(ps);
+        assert.deepEqual(callOrder, ['a#0', 'b#1', 'a#2', 'c#3', 'a#4']);
+        assert.deepEqual(evictions, ['a', 'b', 'a', 'c']);
+    });
+    it('releases the slot when fn throws and keeps draining the queue', async () => {
+        const exec = new LocalExecutor();
+        const log = [];
+        const p1 = exec.withModel('a', async () => {
+            log.push('a-start');
+            throw new Error('boom');
+        });
+        const p2 = exec.withModel('b', async () => {
+            log.push('b-start');
+            return 'b-done';
+        });
+        await assert.rejects(p1, /boom/);
+        const r = await p2;
+        assert.equal(r, 'b-done');
+        assert.deepEqual(log, ['a-start', 'b-start']);
+        assert.equal(exec.inspect().loaded, 'b');
+    });
+});
+describe('LocalExecutor — inspect', () => {
+    it('reports queueDepth while items wait', async () => {
+        const exec = new LocalExecutor();
+        const block = deferred();
+        const p1 = exec.withModel('a', async () => { await block.promise; });
+        // Two more enqueued behind it.
+        const p2 = exec.withModel('a', async () => undefined);
+        const p3 = exec.withModel('b', async () => undefined);
+        // The executor's pump runs synchronously up to the first await, so
+        // by the time we observe, item 1 is in-flight and 2 are still queued.
+        await Promise.resolve();
+        const snap = exec.inspect();
+        assert.equal(snap.loaded, 'a');
+        assert.equal(snap.queueDepth, 2);
+        block.resolve();
+        await Promise.all([p1, p2, p3]);
+        assert.equal(exec.inspect().queueDepth, 0);
+    });
+});
+describe('LocalExecutor — intruder detection (Phase 4.7)', () => {
+    it('evicts an out-of-band exclusive model resident in Ollama before loading', async () => {
+        const evictions = [];
+        let probed = false;
+        const exec = new LocalExecutor({
+            evict: async (id) => { evictions.push(id); },
+            // Ollama already has gemma4:e4b loaded out-of-band when our queue runs.
+            probeResident: async () => {
+                probed = true;
+                return ['gemma4:e4b'];
+            },
+            isExclusive: () => true,
+        });
+        await exec.withModel('qwen3:14b', async () => undefined);
+        assert.ok(probed, 'probe must run before loading');
+        assert.deepEqual(evictions, ['gemma4:e4b'], 'intruder evicted before our load');
+        assert.equal(exec.inspect().loaded, 'qwen3:14b');
+    });
+    it('skips eviction when an intruder is co-resident-eligible (e.g. embed model)', async () => {
+        const evictions = [];
+        const exec = new LocalExecutor({
+            evict: async (id) => { evictions.push(id); },
+            probeResident: async () => ['bge-m3'],
+            // Embed model — flagged as non-exclusive.
+            isExclusive: (id) => id !== 'bge-m3',
+        });
+        await exec.withModel('qwen3:14b', async () => undefined);
+        assert.deepEqual(evictions, [], 'co-resident utility must NOT be evicted');
+    });
+    it('does not double-evict our own tracked model when probe also returns it', async () => {
+        const evictions = [];
+        const exec = new LocalExecutor({
+            evict: async (id) => { evictions.push(id); },
+            probeResident: async () => ['qwen3:14b'],
+            isExclusive: () => true,
+        });
+        // First load — no previous, no eviction.
+        await exec.withModel('qwen3:14b', async () => undefined);
+        // Second load same id — probe sees the same id we already track,
+        // intruder filter must NOT count it as an intruder.
+        await exec.withModel('qwen3:14b', async () => undefined);
+        assert.deepEqual(evictions, [], 'same-id probe match is not an intruder');
+    });
+    it('survives a probeResident failure by treating residents as []', async () => {
+        const exec = new LocalExecutor({
+            evict: async () => undefined,
+            probeResident: async () => { throw new Error('Ollama unreachable'); },
+        });
+        // Should not throw — probe failure is non-fatal.
+        await exec.withModel('qwen3:14b', async () => undefined);
+        assert.equal(exec.inspect().loaded, 'qwen3:14b');
+    });
+});
+//# sourceMappingURL=router-local-executor.test.js.map

package/dist/__tests__/router-local-executor.test.js.map

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

package/dist/__tests__/router-model-registry.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Phase 2 — model-registry loader + validator.
+ *
+ * Covers parsing of valid yaml, missing-file behavior, and every rejection
+ * path the validator owns. Filesystem tests use an isolated tmp dir.
+ */
+export {};
+//# sourceMappingURL=router-model-registry.test.d.ts.map

package/dist/__tests__/router-model-registry.test.d.ts.map

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