@esankhan3/anvil-agent-core 0.2.0 → 0.4.0

package/README.md

@@ -106,7 +106,7 @@ All adapters share the same Anvil Stream Format (NDJSON), the same
                                               ↑
                                          ProviderRegistry
                                               ↑
-                                         LlmRouter   (retries, fallbacks, rate limit)
+                                         LlmRouter   (runAgent/invoke: backoff retries, fallbacks, circuit breaker, rate limit)
                                               ↑
                                          Telemetry   (OTel spans + cost)
                                               ↑

package/dist/__tests__/fetch-pool.integration.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Integration test — proves the heal-on-failure fix actually works.
+ *
+ * Without the fix, a poisoned pool fails every subsequent fetch with the
+ * same TypeError until the process restarts. With the fix:
+ *   - call 1 succeeds against a live server
+ *   - server dies → call 2 fails (TypeError: fetch failed)
+ *   - recycleFetchPoolOnFailure() runs
+ *   - server comes back → call 3 succeeds against the healed pool
+ *
+ * This is the test the plan in docs/FETCH-POOL-MANAGEMENT-PLAN.md §6.2
+ * specifies as the canary for the entire fix.
+ */
+export {};
+//# sourceMappingURL=fetch-pool.integration.test.d.ts.map

package/dist/__tests__/fetch-pool.integration.test.d.ts.map

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

package/dist/__tests__/fetch-pool.integration.test.js

@@ -0,0 +1,109 @@
+/**
+ * Integration test — proves the heal-on-failure fix actually works.
+ *
+ * Without the fix, a poisoned pool fails every subsequent fetch with the
+ * same TypeError until the process restarts. With the fix:
+ *   - call 1 succeeds against a live server
+ *   - server dies → call 2 fails (TypeError: fetch failed)
+ *   - recycleFetchPoolOnFailure() runs
+ *   - server comes back → call 3 succeeds against the healed pool
+ *
+ * This is the test the plan in docs/FETCH-POOL-MANAGEMENT-PLAN.md §6.2
+ * specifies as the canary for the entire fix.
+ */
+import { describe, it, before, after, beforeEach } from 'node:test';
+import assert from 'node:assert/strict';
+import http from 'node:http';
+import { getFetchPool, recycleFetchPoolOnFailure, getPoolMetrics, resetAllPools, } from '../fetch-pool.js';
+describe('fetch-pool integration — heal-on-failure end-to-end', () => {
+    let server = null;
+    let port = 0;
+    async function startServer() {
+        server = http.createServer((req, res) => {
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ ok: true, path: req.url }));
+        });
+        await new Promise((resolve) => {
+            server.listen(port, '127.0.0.1', () => {
+                port = server.address().port;
+                resolve();
+            });
+        });
+    }
+    async function stopServer() {
+        if (!server)
+            return;
+        await new Promise((resolve) => {
+            server.close(() => resolve());
+            // Force-close any sockets the pool may be holding so the close()
+            // callback fires promptly.
+            server.closeAllConnections?.();
+        });
+        server = null;
+    }
+    before(async () => {
+        await startServer();
+    });
+    beforeEach(async () => {
+        await resetAllPools();
+    });
+    after(async () => {
+        await stopServer();
+        await resetAllPools();
+    });
+    it('healed pool succeeds after a network failure poisons the old pool', async () => {
+        const url = `http://127.0.0.1:${port}/v1/messages`;
+        // 1. First call succeeds against a live server.
+        const r1 = await fetch(url, {
+            // @ts-expect-error — undici dispatcher accepted by Node fetch at runtime
+            dispatcher: getFetchPool('anthropic'),
+        });
+        assert.strictEqual(r1.status, 200);
+        await r1.text();
+        // 2. Kill the server. The pool now holds zombie sockets pointed at a
+        //    dead listener — every subsequent fetch through the SAME dispatcher
+        //    fails with `TypeError: fetch failed`.
+        await stopServer();
+        let caught = null;
+        try {
+            await fetch(url, {
+                // @ts-expect-error — undici dispatcher accepted by Node fetch at runtime
+                dispatcher: getFetchPool('anthropic'),
+            });
+        }
+        catch (err) {
+            caught = err;
+        }
+        assert.ok(caught instanceof Error, 'expected fetch to throw with server down');
+        assert.match(caught.message + ' ' + (caught.cause instanceof Error ? caught.cause.message : ''), /fetch failed|ECONNREFUSED|ECONNRESET|socket/i);
+        // 3. Recycle the pool — this is what the adapter's catch block does
+        //    in production.
+        await recycleFetchPoolOnFailure('anthropic', caught);
+        const metrics = getPoolMetrics().find((m) => m.provider === 'anthropic');
+        assert.strictEqual(metrics?.recycleCount, 1, 'pool should have been recycled');
+        // 4. Bring the server back on the same port.
+        await startServer();
+        // 5. The next fetch must succeed. Without the recycle, the same zombie
+        //    socket would be re-used and this would fail again.
+        const r3 = await fetch(url, {
+            // @ts-expect-error — undici dispatcher accepted by Node fetch at runtime
+            dispatcher: getFetchPool('anthropic'),
+        });
+        assert.strictEqual(r3.status, 200, 'healed pool must serve the next request');
+        const body = (await r3.json());
+        assert.strictEqual(body.ok, true);
+    });
+    it('one provider failing does not recycle a sibling provider', async () => {
+        // Touch both pools so they exist.
+        getFetchPool('anthropic');
+        getFetchPool('gemini');
+        // Poison only one.
+        await recycleFetchPoolOnFailure('anthropic', new TypeError('fetch failed'));
+        const metrics = getPoolMetrics();
+        const anthropic = metrics.find((m) => m.provider === 'anthropic');
+        const gemini = metrics.find((m) => m.provider === 'gemini');
+        assert.strictEqual(anthropic?.recycleCount, 1);
+        assert.strictEqual(gemini?.recycleCount, 0, 'sibling provider must be untouched');
+    });
+});
+//# sourceMappingURL=fetch-pool.integration.test.js.map

package/dist/__tests__/fetch-pool.integration.test.js.map

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

package/dist/__tests__/fetch-pool.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Unit tests for fetch-pool — per-provider dispatcher with heal-on-failure.
+ *
+ * Covers the eight contracts from FETCH-POOL-MANAGEMENT-PLAN.md §6.1:
+ *   a) Lazy construction returns a stable instance per provider
+ *   b) Per-provider isolation — different providers get different agents
+ *   c) Bounded options applied at construction
+ *   d) Recycle on poisoned-error pattern swaps the agent
+ *   e) No recycle on non-poisoned errors (e.g. 400, 401, 503)
+ *   f) Concurrent recycles coalesce to one bump
+ *   g) Metrics shape is well-formed
+ *   h) resetAllPools clears state cleanly
+ */
+export {};
+//# sourceMappingURL=fetch-pool.test.d.ts.map

package/dist/__tests__/fetch-pool.test.d.ts.map

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

package/dist/__tests__/fetch-pool.test.js

@@ -0,0 +1,115 @@
+/**
+ * Unit tests for fetch-pool — per-provider dispatcher with heal-on-failure.
+ *
+ * Covers the eight contracts from FETCH-POOL-MANAGEMENT-PLAN.md §6.1:
+ *   a) Lazy construction returns a stable instance per provider
+ *   b) Per-provider isolation — different providers get different agents
+ *   c) Bounded options applied at construction
+ *   d) Recycle on poisoned-error pattern swaps the agent
+ *   e) No recycle on non-poisoned errors (e.g. 400, 401, 503)
+ *   f) Concurrent recycles coalesce to one bump
+ *   g) Metrics shape is well-formed
+ *   h) resetAllPools clears state cleanly
+ */
+import { describe, it, beforeEach } from 'node:test';
+import assert from 'node:assert/strict';
+import { Agent } from 'undici';
+import { getFetchPool, recycleFetchPoolOnFailure, getPoolMetrics, resetAllPools, } from '../fetch-pool.js';
+describe('fetch-pool', () => {
+    beforeEach(async () => {
+        await resetAllPools();
+    });
+    it('a) lazy construction returns the same Agent on repeat calls', () => {
+        const a1 = getFetchPool('anthropic');
+        const a2 = getFetchPool('anthropic');
+        assert.ok(a1 instanceof Agent);
+        assert.strictEqual(a1, a2, 'second call should return same instance');
+    });
+    it('b) per-provider isolation — separate Agents per provider', () => {
+        const anthropic = getFetchPool('anthropic');
+        const gemini = getFetchPool('gemini');
+        const opencode = getFetchPool('opencode');
+        assert.notStrictEqual(anthropic, gemini);
+        assert.notStrictEqual(anthropic, opencode);
+        assert.notStrictEqual(gemini, opencode);
+    });
+    it('c) constructed Agent is bounded — close() resolves without hanging', async () => {
+        // Indirect bounded-keep-alive test: a fresh pool with no in-flight work
+        // closes synchronously-ish. If construction picked up unbounded defaults,
+        // tests for d/f would intermittently hang on the close() inside recycle.
+        const agent = getFetchPool('openai');
+        const closed = agent.close();
+        await Promise.race([
+            closed,
+            new Promise((_, reject) => setTimeout(() => reject(new Error('close hung beyond 500ms')), 500)),
+        ]);
+    });
+    it('d) recycle swaps the Agent when the error matches a poisoned pattern', async () => {
+        const before = getFetchPool('opencode');
+        await recycleFetchPoolOnFailure('opencode', new TypeError('fetch failed'));
+        const after = getFetchPool('opencode');
+        assert.notStrictEqual(after, before, 'agent should have been swapped');
+        const metrics = getPoolMetrics().find((m) => m.provider === 'opencode');
+        assert.ok(metrics);
+        assert.strictEqual(metrics.recycleCount, 1);
+        assert.ok(metrics.lastRecycleAt);
+        assert.match(metrics.lastRecycleReason ?? '', /fetch failed/);
+    });
+    it('e) does not recycle on non-poisoned errors (real upstream status)', async () => {
+        const before = getFetchPool('gemini');
+        await recycleFetchPoolOnFailure('gemini', new Error('400 Bad Request'));
+        await recycleFetchPoolOnFailure('gemini', new Error('503 Service Unavailable'));
+        await recycleFetchPoolOnFailure('gemini', new Error('quota exceeded'));
+        const after = getFetchPool('gemini');
+        assert.strictEqual(after, before, 'agent must not change on non-network errors');
+        const metrics = getPoolMetrics().find((m) => m.provider === 'gemini');
+        assert.strictEqual(metrics?.recycleCount, 0);
+    });
+    it('f) concurrent recycles coalesce — recycleCount increments once', async () => {
+        getFetchPool('ollama');
+        const err = new TypeError('fetch failed');
+        const all = await Promise.all(Array.from({ length: 10 }, () => recycleFetchPoolOnFailure('ollama', err)));
+        assert.strictEqual(all.length, 10);
+        const metrics = getPoolMetrics().find((m) => m.provider === 'ollama');
+        assert.strictEqual(metrics?.recycleCount, 1, 'must coalesce to one recycle');
+    });
+    it('g) getPoolMetrics returns well-shaped entries', async () => {
+        getFetchPool('anthropic');
+        getFetchPool('openrouter');
+        const metrics = getPoolMetrics();
+        assert.ok(Array.isArray(metrics));
+        assert.strictEqual(metrics.length, 2);
+        for (const m of metrics) {
+            assert.ok(['anthropic', 'openrouter'].includes(m.provider));
+            assert.strictEqual(typeof m.createdAt, 'string');
+            assert.match(m.createdAt, /\dT\d/, 'ISO timestamp');
+            assert.strictEqual(typeof m.recycleCount, 'number');
+            assert.strictEqual(typeof m.active, 'boolean');
+            assert.strictEqual(m.active, true, 'idle pool is active');
+        }
+    });
+    it('h) resetAllPools drops all state', async () => {
+        getFetchPool('anthropic');
+        getFetchPool('gemini');
+        assert.strictEqual(getPoolMetrics().length, 2);
+        await resetAllPools();
+        assert.strictEqual(getPoolMetrics().length, 0);
+        // Subsequent get reconstructs cleanly
+        const fresh = getFetchPool('anthropic');
+        assert.ok(fresh instanceof Agent);
+        assert.strictEqual(getPoolMetrics().length, 1);
+    });
+    it('recycle reads ECONNRESET from err.cause', async () => {
+        const before = getFetchPool('anthropic');
+        // Node's fetch wraps the underlying socket error in `.cause`.
+        const err = new TypeError('fetch failed', {
+            cause: new Error('read ECONNRESET'),
+        });
+        await recycleFetchPoolOnFailure('anthropic', err);
+        const after = getFetchPool('anthropic');
+        assert.notStrictEqual(after, before);
+        const m = getPoolMetrics().find((p) => p.provider === 'anthropic');
+        assert.strictEqual(m?.recycleCount, 1);
+    });
+});
+//# sourceMappingURL=fetch-pool.test.js.map

package/dist/__tests__/fetch-pool.test.js.map

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

package/dist/__tests__/gemini-adapter-recording.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * §H4 — cross-vendor turn recording for the Gemini single-shot adapter.
+ *
+ * Verifies the adapter (a) records `turn:0:assistant-start` with the
+ * user prompt and `turn:0:assistant-end` with the streamed text on the
+ * live path, and (b) honors a recorded turn on replay by skipping the
+ * upstream fetch entirely. Mocks `globalThis.fetch` with a fake Gemini
+ * SSE stream; the recorder runs over a test-double EffectRuntime.
+ */
+export {};
+//# sourceMappingURL=gemini-adapter-recording.test.d.ts.map

package/dist/__tests__/gemini-adapter-recording.test.d.ts.map

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

package/dist/__tests__/gemini-adapter-recording.test.js

@@ -0,0 +1,108 @@
+/**
+ * §H4 — cross-vendor turn recording for the Gemini single-shot adapter.
+ *
+ * Verifies the adapter (a) records `turn:0:assistant-start` with the
+ * user prompt and `turn:0:assistant-end` with the streamed text on the
+ * live path, and (b) honors a recorded turn on replay by skipping the
+ * upstream fetch entirely. Mocks `globalThis.fetch` with a fake Gemini
+ * SSE stream; the recorder runs over a test-double EffectRuntime.
+ */
+import { describe, it, before, after } from 'node:test';
+import assert from 'node:assert/strict';
+import { GeminiAdapter } from '../gemini-adapter.js';
+import { TurnRecorder } from '../turn-recorder/index.js';
+function geminiSse(text) {
+    const body = `data: ${JSON.stringify({ candidates: [{ content: { parts: [{ text }] } }] })}\n` +
+        `data: ${JSON.stringify({
+            candidates: [{ content: { parts: [{ text: '' }] } }],
+            usageMetadata: { promptTokenCount: 10, candidatesTokenCount: 5 },
+        })}\n`;
+    return new Response(body, { status: 200, headers: { 'Content-Type': 'text/event-stream' } });
+}
+class StubWritable {
+    chunks = [];
+    write(chunk) {
+        this.chunks.push(typeof chunk === 'string' ? chunk : new TextDecoder().decode(chunk));
+        return true;
+    }
+    end() { }
+    on() { }
+}
+/** EffectRuntime double; `seed[name]` makes peekRecorded return a replay. */
+function fakeRuntime(seed = {}) {
+    const log = [];
+    const runtime = {
+        async effect(name, fn, opts) {
+            if (name in seed) {
+                log.push({ name, opts, payload: seed[name] });
+                return seed[name];
+            }
+            const payload = await fn();
+            log.push({ name, opts, payload });
+            return payload;
+        },
+        peekRecorded(name) {
+            return (name in seed ? seed[name] : undefined);
+        },
+    };
+    return { runtime, log };
+}
+const baseConfig = {
+    userPrompt: 'summarise the repo',
+    model: 'gemini-2.5-flash',
+    workingDir: '/tmp',
+    stage: 'build',
+    persona: 'engineer',
+    sessionId: 'run-gem',
+};
+let originalFetch;
+let originalKey;
+before(() => {
+    originalFetch = globalThis.fetch;
+    originalKey = process.env.GEMINI_API_KEY;
+    process.env.GEMINI_API_KEY = 'test-key';
+});
+after(() => {
+    globalThis.fetch = originalFetch;
+    if (originalKey === undefined)
+        delete process.env.GEMINI_API_KEY;
+    else
+        process.env.GEMINI_API_KEY = originalKey;
+});
+describe('GeminiAdapter — H4 turn recording', () => {
+    it('records assistant-start (with userPrompt) and assistant-end (with text) on the live path', async () => {
+        globalThis.fetch = (async () => geminiSse('hello from gemini'));
+        const { runtime, log } = fakeRuntime();
+        const recorder = new TurnRecorder({ runtime, partialSink: () => { }, runId: 'run-gem', stepId: 'build' });
+        const r = await new GeminiAdapter().run({ ...baseConfig, turnRecorder: recorder }, new StubWritable());
+        assert.equal(r.output, 'hello from gemini');
+        const start = log.find((e) => e.name === 'turn:0:assistant-start');
+        assert.ok(start, 'assistant-start must be recorded');
+        assert.equal(start.payload.userPrompt, 'summarise the repo');
+        const end = log.find((e) => e.name === 'turn:0:assistant-end');
+        assert.ok(end, 'assistant-end must be recorded');
+        assert.equal(end.payload.text, 'hello from gemini');
+        assert.equal(end.payload.provider, 'gemini');
+    });
+    it('skips the upstream fetch on replay and returns the recorded turn', async () => {
+        let fetched = false;
+        globalThis.fetch = (async () => { fetched = true; return geminiSse('SHOULD NOT RUN'); });
+        // Seed a recorded assistant-end → startTurn returns `replayed`.
+        const { runtime } = fakeRuntime({
+            'turn:0:assistant-end': {
+                text: 'recorded answer',
+                stopReason: 'end_turn',
+                usage: { inputTokens: 10, outputTokens: 5 },
+                provenance: { segments: [{ model: 'gemini-2.5-flash', provider: 'gemini', range: [0, 15], source: 'live' }] },
+                historyDelta: [],
+            },
+        });
+        const recorder = new TurnRecorder({ runtime, partialSink: () => { }, runId: 'run-gem', stepId: 'build' });
+        const r = await new GeminiAdapter().run({ ...baseConfig, turnRecorder: recorder }, new StubWritable());
+        assert.equal(fetched, false, 'replay must NOT hit the upstream');
+        assert.equal(r.output, 'recorded answer');
+        assert.equal(r.inputTokens, 10);
+        assert.equal(r.outputTokens, 5);
+    });
+});
+//# sourceMappingURL=gemini-adapter-recording.test.js.map

package/dist/__tests__/gemini-adapter-recording.test.js.map

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

package/dist/__tests__/legacy-adapter-language-model.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Phase 1 — `legacyAdapterToLanguageModel` shim.
+ *
+ * A fake `ModelAdapter` writes known Anvil Stream Format NDJSON to the sink
+ * and resolves a `ModelAdapterResult`. We assert the shim turns that push
+ * stream into the pull `LanguageModel` surface correctly: `invokeStream`
+ * yields the right `StreamEvent`s, `invoke` assembles the `InvokeResult`, and
+ * a rejected `run()` surfaces as a throw the unified classifier understands.
+ */
+export {};
+//# sourceMappingURL=legacy-adapter-language-model.test.d.ts.map

package/dist/__tests__/legacy-adapter-language-model.test.d.ts.map

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

package/dist/__tests__/legacy-adapter-language-model.test.js

@@ -0,0 +1,102 @@
+/**
+ * Phase 1 — `legacyAdapterToLanguageModel` shim.
+ *
+ * A fake `ModelAdapter` writes known Anvil Stream Format NDJSON to the sink
+ * and resolves a `ModelAdapterResult`. We assert the shim turns that push
+ * stream into the pull `LanguageModel` surface correctly: `invokeStream`
+ * yields the right `StreamEvent`s, `invoke` assembles the `InvokeResult`, and
+ * a rejected `run()` surfaces as a throw the unified classifier understands.
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { legacyAdapterToLanguageModel } from '../agent/session/legacy-adapter-language-model.js';
+import { emitContent, emitToolUse } from '../stream-format.js';
+import { UpstreamError } from '../upstream-error.js';
+import { classifyError } from '../router/errors.js';
+class FakeAdapter {
+    script;
+    provider = 'openrouter';
+    capabilities = { streaming: true };
+    constructor(script) {
+        this.script = script;
+    }
+    supportsModel() { return true; }
+    getModelPricing() { return null; }
+    async checkAvailability() { return { available: true }; }
+    run(_config, output) {
+        return this.script(output);
+    }
+}
+const OPTS = {
+    model: 'some-model',
+    messages: [{ role: 'user', content: 'hi' }],
+};
+function fakeResult(over) {
+    return {
+        output: '', inputTokens: 0, outputTokens: 0, costUsd: 0, durationMs: 0,
+        provider: 'openrouter', model: 'some-model', ...over,
+    };
+}
+async function collect(stream) {
+    const out = [];
+    for await (const ev of stream)
+        out.push(ev);
+    return out;
+}
+describe('legacyAdapterToLanguageModel — invoke()', () => {
+    it('assembles InvokeResult from streamed text + resolved result', async () => {
+        const adapter = new FakeAdapter(async (out) => {
+            emitContent(out, 'Hello ');
+            emitContent(out, 'world');
+            return fakeResult({ output: 'Hello world', inputTokens: 10, outputTokens: 5, costUsd: 0.001, durationMs: 120, stopReason: 'end_turn' });
+        });
+        const lm = legacyAdapterToLanguageModel(adapter);
+        const res = await lm.invoke(OPTS);
+        assert.equal(res.text, 'Hello world');
+        assert.equal(res.usage.inputTokens, 10);
+        assert.equal(res.usage.outputTokens, 5);
+        assert.equal(res.costUsd, 0.001);
+        assert.equal(res.durationMs, 120);
+        assert.equal(res.finishReason, 'end');
+        assert.equal(res.provider, 'openrouter');
+        assert.deepEqual(res.toolCalls, []);
+    });
+    it('surfaces tool_use blocks as structured toolCalls + tool-use finish', async () => {
+        const adapter = new FakeAdapter(async (out) => {
+            emitToolUse(out, 'read_file', { path: 'a.ts' }, 't1');
+            return fakeResult({ output: '', stopReason: 'tool_use' });
+        });
+        const res = await legacyAdapterToLanguageModel(adapter).invoke(OPTS);
+        assert.equal(res.toolCalls.length, 1);
+        assert.equal(res.toolCalls[0].name, 'read_file');
+        assert.equal(res.toolCalls[0].id, 't1');
+        assert.deepEqual(res.toolCalls[0].arguments, { path: 'a.ts' });
+        assert.equal(res.finishReason, 'tool-use');
+    });
+});
+describe('legacyAdapterToLanguageModel — invokeStream()', () => {
+    it('yields text-delta events then usage then finish', async () => {
+        const adapter = new FakeAdapter(async (out) => {
+            emitContent(out, 'A');
+            emitContent(out, 'B');
+            return fakeResult({ output: 'AB', inputTokens: 3, outputTokens: 2, stopReason: 'end_turn' });
+        });
+        const events = await collect(legacyAdapterToLanguageModel(adapter).invokeStream(OPTS));
+        const kinds = events.map((e) => e.type);
+        assert.deepEqual(kinds, ['text-delta', 'text-delta', 'usage', 'finish']);
+        assert.equal(events[0].text, 'A');
+        assert.equal(events[3].reason, 'end');
+    });
+});
+describe('legacyAdapterToLanguageModel — error propagation', () => {
+    it('rethrows a rejected run() so the unified classifier can act on it', async () => {
+        const adapter = new FakeAdapter(async () => {
+            throw new UpstreamError(0, 'fetch failed: fetch failed', { provider: 'opencode', retryable: true });
+        });
+        await assert.rejects(() => legacyAdapterToLanguageModel(adapter).invoke(OPTS), (err) => {
+            assert.equal(classifyError(err), 'timeout');
+            return true;
+        });
+    });
+});
+//# sourceMappingURL=legacy-adapter-language-model.test.js.map

package/dist/__tests__/legacy-adapter-language-model.test.js.map

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

package/dist/__tests__/ollama-adapter-recording.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * §H4 — turn recording + replay-equivalence for the Ollama AGENTIC adapter.
+ *
+ * The agentic port records per-turn assistant-start / tool_use / tool_result /
+ * assistant-end and, crucially, HONORS `replayed` on a same-runId resume so the
+ * recorded effects re-issue in order WITHOUT re-calling the upstream or
+ * re-executing tools. This is the guarantee that prevents a crash-resume from
+ * tripping a DeterminismViolation under FO1's runId reuse.
+ *
+ * Test 1 records a 2-turn (tool-call → text) run and asserts the effect log.
+ * Test 2 replays that exact log and asserts ZERO upstream fetches + ZERO tool
+ * executions, with byte-identical output.
+ */
+export {};
+//# sourceMappingURL=ollama-adapter-recording.test.d.ts.map

package/dist/__tests__/ollama-adapter-recording.test.d.ts.map

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