@namzu/sdk 2.0.0 → 3.0.0

package/dist/provider/__tests__/retry.test.js

@@ -0,0 +1,259 @@
+import { describe, expect, it, vi } from 'vitest';
+import { ProviderError, classifyProviderError, isAbortError } from '../../types/provider/errors.js';
+import { withProviderRetry } from '../retry.js';
+const PARAMS = { model: 'm', messages: [] };
+function chunk(content) {
+    return { id: 'c', delta: { content } };
+}
+/** A driver whose behavior is scripted per attempt. */
+function scripted(script) {
+    let calls = 0;
+    const provider = {
+        id: 'scripted',
+        name: 'Scripted',
+        chatStream: (_params) => {
+            const step = script[Math.min(calls, script.length - 1)];
+            calls++;
+            if (!step)
+                throw new Error('script exhausted');
+            return step();
+        },
+        get calls() {
+            return calls;
+        },
+    };
+    return provider;
+}
+function httpError(status, message = `HTTP ${status}`, headers) {
+    return Object.assign(new Error(message), { status, headers });
+}
+async function drain(stream) {
+    let out = '';
+    for await (const c of stream)
+        out += c.delta.content ?? '';
+    return out;
+}
+const noSleep = async () => { };
+describe('classifyProviderError', () => {
+    it.each([
+        [429, 'rate_limit', true],
+        [529, 'overloaded', true],
+        [503, 'overloaded', true],
+        [500, 'server_error', true],
+        [502, 'server_error', true],
+        [408, 'timeout', true],
+        [401, 'auth', false],
+        [403, 'auth', false],
+        [404, 'not_found', false],
+        [400, 'invalid_request', false],
+    ])('maps HTTP %i to %s (retryable=%s)', (status, code, retryable) => {
+        const e = classifyProviderError(httpError(status));
+        expect(e.code).toBe(code);
+        expect(e.retryable).toBe(retryable);
+        expect(e.status).toBe(status);
+    });
+    it('files a window overflow as context_length_exceeded even though it arrives as a 400', () => {
+        const e = classifyProviderError(httpError(400, 'prompt is too long: 250000 tokens > 200000'));
+        expect(e.code).toBe('context_length_exceeded');
+        // Retrying the identical request cannot help — the caller must shed history.
+        expect(e.retryable).toBe(false);
+    });
+    it('classifies transport errnos without a status', () => {
+        expect(classifyProviderError(Object.assign(new Error('reset'), { code: 'ECONNRESET' })).code).toBe('network');
+        expect(classifyProviderError(Object.assign(new Error('slow'), { code: 'ETIMEDOUT' })).code).toBe('timeout');
+        // undici nests the errno under `cause`.
+        expect(classifyProviderError(Object.assign(new Error('x'), { cause: { code: 'EAI_AGAIN' } })).code).toBe('network');
+    });
+    it('reads Retry-After as delta-seconds and as an HTTP date', () => {
+        expect(classifyProviderError(httpError(429, '', { 'retry-after': '2' })).retryAfterMs).toBe(2000);
+        const now = Date.parse('2026-07-31T10:00:00Z');
+        const at = new Date(now + 5000).toUTCString();
+        expect(classifyProviderError(httpError(429, '', { 'retry-after': at }), undefined, now).retryAfterMs).toBe(5000);
+    });
+    it('is idempotent — re-classifying a ProviderError returns it unchanged', () => {
+        const first = classifyProviderError(httpError(429));
+        expect(classifyProviderError(first)).toBe(first);
+    });
+    it('does not treat an abort as a provider failure', () => {
+        const abort = Object.assign(new Error('aborted'), { name: 'AbortError' });
+        expect(isAbortError(abort)).toBe(true);
+    });
+});
+describe('withProviderRetry', () => {
+    it('retries a 429 and succeeds', async () => {
+        const provider = scripted([
+            () => {
+                throw httpError(429);
+            },
+            async function* () {
+                yield chunk('ok');
+            },
+        ]);
+        const wrapped = withProviderRetry(provider, { sleepFn: noSleep, random: () => 0.5 });
+        expect(await drain(wrapped.chatStream(PARAMS))).toBe('ok');
+        expect(provider.calls).toBe(2);
+    });
+    it('does NOT retry a 400 — a malformed request stays malformed', async () => {
+        const provider = scripted([
+            () => {
+                throw httpError(400, 'bad tool schema');
+            },
+        ]);
+        const wrapped = withProviderRetry(provider, { sleepFn: noSleep });
+        await expect(drain(wrapped.chatStream(PARAMS))).rejects.toMatchObject({
+            code: 'invalid_request',
+        });
+        expect(provider.calls).toBe(1);
+    });
+    it('gives up after maxRetries and throws a classified ProviderError', async () => {
+        const provider = scripted([
+            () => {
+                throw httpError(503);
+            },
+        ]);
+        const wrapped = withProviderRetry(provider, {
+            config: { maxRetries: 2 },
+            sleepFn: noSleep,
+        });
+        const err = await drain(wrapped.chatStream(PARAMS)).catch((e) => e);
+        expect(err).toBeInstanceOf(ProviderError);
+        expect(err.code).toBe('overloaded');
+        expect(provider.calls).toBe(3); // initial + 2 retries
+    });
+    it('NEVER retries once a content chunk has been produced', async () => {
+        // Retrying here would replay "hello" and duplicate it in the buffer
+        // the consumer has already emitted as text_delta events.
+        const provider = scripted([
+            async function* () {
+                yield chunk('hello');
+                throw httpError(503);
+            },
+            async function* () {
+                yield chunk('SHOULD NOT HAPPEN');
+            },
+        ]);
+        const wrapped = withProviderRetry(provider, { sleepFn: noSleep });
+        let seen = '';
+        const err = await (async () => {
+            try {
+                for await (const c of wrapped.chatStream(PARAMS))
+                    seen += c.delta.content ?? '';
+                return undefined;
+            }
+            catch (e) {
+                return e;
+            }
+        })();
+        expect(seen).toBe('hello');
+        expect(err).toBeInstanceOf(ProviderError);
+        expect(provider.calls).toBe(1);
+    });
+    it('retries a driver that reports failure in-band via chunk.error', async () => {
+        const provider = scripted([
+            async function* () {
+                yield { id: 'c', delta: {}, error: 'overloaded_error' };
+            },
+            async function* () {
+                yield chunk('recovered');
+            },
+        ]);
+        const wrapped = withProviderRetry(provider, { sleepFn: noSleep });
+        expect(await drain(wrapped.chatStream(PARAMS))).toBe('recovered');
+        expect(provider.calls).toBe(2);
+    });
+    it('honours a server-directed Retry-After instead of the computed backoff', async () => {
+        const slept = [];
+        const provider = scripted([
+            () => {
+                throw httpError(429, 'slow down', { 'retry-after': '7' });
+            },
+            async function* () {
+                yield chunk('ok');
+            },
+        ]);
+        const wrapped = withProviderRetry(provider, {
+            sleepFn: async (ms) => {
+                slept.push(ms);
+            },
+        });
+        await drain(wrapped.chatStream(PARAMS));
+        expect(slept).toEqual([7000]);
+    });
+    it('ignores an absurd Retry-After and falls back to bounded backoff', async () => {
+        const slept = [];
+        const provider = scripted([
+            () => {
+                throw httpError(429, '', { 'retry-after': '900' }); // 15 minutes
+            },
+            async function* () {
+                yield chunk('ok');
+            },
+        ]);
+        const wrapped = withProviderRetry(provider, {
+            config: { maxRetryAfterMs: 60_000, initialDelayMs: 500 },
+            random: () => 1,
+            sleepFn: async (ms) => {
+                slept.push(ms);
+            },
+        });
+        await drain(wrapped.chatStream(PARAMS));
+        expect(slept).toEqual([500]);
+    });
+    it('applies full jitter — the delay is scaled by the random source', async () => {
+        const slept = [];
+        const provider = scripted([
+            () => {
+                throw httpError(500);
+            },
+            () => {
+                throw httpError(500);
+            },
+            async function* () {
+                yield chunk('ok');
+            },
+        ]);
+        const wrapped = withProviderRetry(provider, {
+            config: { initialDelayMs: 1000, maxDelayMs: 16_000 },
+            random: () => 0.5,
+            sleepFn: async (ms) => {
+                slept.push(ms);
+            },
+        });
+        await drain(wrapped.chatStream(PARAMS));
+        // attempt 0 → 0.5 * 1000, attempt 1 → 0.5 * 2000
+        expect(slept).toEqual([500, 1000]);
+    });
+    it('propagates an abort untouched so the run still settles as cancelled', async () => {
+        const controller = new AbortController();
+        controller.abort();
+        const abortErr = Object.assign(new Error('aborted'), { name: 'AbortError' });
+        const provider = scripted([
+            () => {
+                throw abortErr;
+            },
+        ]);
+        const wrapped = withProviderRetry(provider, { sleepFn: noSleep });
+        await expect(drain(wrapped.chatStream({ ...PARAMS, signal: controller.signal }))).rejects.toBe(abortErr);
+        expect(provider.calls).toBe(1);
+    });
+    it('returns the provider untouched when retrying is disabled', () => {
+        const provider = scripted([]);
+        expect(withProviderRetry(provider, { config: { maxRetries: 0 } })).toBe(provider);
+    });
+    it('is transparent to identity and capability negotiation', () => {
+        const base = {
+            id: 'anthropic',
+            name: 'Anthropic',
+            capabilities: { supportsTools: true, supportsVision: false },
+            chatStream: async function* () { },
+            listModels: vi.fn(async () => []),
+        };
+        const wrapped = withProviderRetry(base);
+        expect(wrapped.id).toBe('anthropic');
+        expect(wrapped.name).toBe('Anthropic');
+        expect(wrapped.capabilities).toEqual({ supportsTools: true, supportsVision: false });
+        expect(typeof wrapped.listModels).toBe('function');
+        expect(wrapped.healthCheck).toBeUndefined();
+    });
+});
+//# sourceMappingURL=retry.test.js.map

package/dist/provider/__tests__/retry.test.js.map

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

package/dist/provider/capabilities.d.ts

@@ -8,6 +8,7 @@ export interface ResolvedProviderCapabilities {
     supportsStreaming: boolean;
     supportsFunctionCalling: boolean;
     supportsVision: boolean;
+    supportsDocuments: boolean;
     maxOutputTokens?: number;
 }
 /**

package/dist/provider/capabilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/provider/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAwB,MAAM,4BAA4B,CAAA;AAEnF;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IAC5C,aAAa,EAAE,OAAO,CAAA;IACtB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,uBAAuB,EAAE,OAAO,CAAA;IAChC,cAAc,EAAE,OAAO,CAAA;IACvB,eAAe,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,EAAE,4BAK9C,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAC1C,QAAQ,EAAE,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,GACzC,4BAA4B,CAW9B"}
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/provider/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAwB,MAAM,4BAA4B,CAAA;AAEnF;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IAC5C,aAAa,EAAE,OAAO,CAAA;IACtB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,uBAAuB,EAAE,OAAO,CAAA;IAChC,cAAc,EAAE,OAAO,CAAA;IACvB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,EAAE,4BAM9C,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAC1C,QAAQ,EAAE,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,GACzC,4BAA4B,CAa9B"}

package/dist/provider/capabilities.js

@@ -9,6 +9,7 @@ export const PERMISSIVE_PROVIDER_CAPABILITIES = {
     supportsStreaming: true,
     supportsFunctionCalling: true,
     supportsVision: true,
+    supportsDocuments: true,
 };
 /**
  * Resolve a provider's declared capabilities against the permissive
@@ -23,6 +24,7 @@ export function resolveProviderCapabilities(provider) {
         supportsStreaming: declared?.supportsStreaming ?? PERMISSIVE_PROVIDER_CAPABILITIES.supportsStreaming,
         supportsFunctionCalling: declared?.supportsFunctionCalling ?? PERMISSIVE_PROVIDER_CAPABILITIES.supportsFunctionCalling,
         supportsVision: declared?.supportsVision ?? PERMISSIVE_PROVIDER_CAPABILITIES.supportsVision,
+        supportsDocuments: declared?.supportsDocuments ?? PERMISSIVE_PROVIDER_CAPABILITIES.supportsDocuments,
         maxOutputTokens: declared?.maxOutputTokens,
     };
 }

package/dist/provider/capabilities.js.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/provider/capabilities.ts"],"names":[],"mappings":"AAcA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAiC;IAC7E,aAAa,EAAE,IAAI;IACnB,iBAAiB,EAAE,IAAI;IACvB,uBAAuB,EAAE,IAAI;IAC7B,cAAc,EAAE,IAAI;CACpB,CAAA;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CAC1C,QAA2C;IAE3C,MAAM,QAAQ,GAAqC,QAAQ,CAAC,YAAY,CAAA;IACxE,OAAO;QACN,aAAa,EAAE,QAAQ,EAAE,aAAa,IAAI,gCAAgC,CAAC,aAAa;QACxF,iBAAiB,EAChB,QAAQ,EAAE,iBAAiB,IAAI,gCAAgC,CAAC,iBAAiB;QAClF,uBAAuB,EACtB,QAAQ,EAAE,uBAAuB,IAAI,gCAAgC,CAAC,uBAAuB;QAC9F,cAAc,EAAE,QAAQ,EAAE,cAAc,IAAI,gCAAgC,CAAC,cAAc;QAC3F,eAAe,EAAE,QAAQ,EAAE,eAAe;KAC1C,CAAA;AACF,CAAC"}
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/provider/capabilities.ts"],"names":[],"mappings":"AAeA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAiC;IAC7E,aAAa,EAAE,IAAI;IACnB,iBAAiB,EAAE,IAAI;IACvB,uBAAuB,EAAE,IAAI;IAC7B,cAAc,EAAE,IAAI;IACpB,iBAAiB,EAAE,IAAI;CACvB,CAAA;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CAC1C,QAA2C;IAE3C,MAAM,QAAQ,GAAqC,QAAQ,CAAC,YAAY,CAAA;IACxE,OAAO;QACN,aAAa,EAAE,QAAQ,EAAE,aAAa,IAAI,gCAAgC,CAAC,aAAa;QACxF,iBAAiB,EAChB,QAAQ,EAAE,iBAAiB,IAAI,gCAAgC,CAAC,iBAAiB;QAClF,uBAAuB,EACtB,QAAQ,EAAE,uBAAuB,IAAI,gCAAgC,CAAC,uBAAuB;QAC9F,cAAc,EAAE,QAAQ,EAAE,cAAc,IAAI,gCAAgC,CAAC,cAAc;QAC3F,iBAAiB,EAChB,QAAQ,EAAE,iBAAiB,IAAI,gCAAgC,CAAC,iBAAiB;QAClF,eAAe,EAAE,QAAQ,EAAE,eAAe;KAC1C,CAAA;AACF,CAAC"}

package/dist/provider/collect.d.ts

@@ -15,7 +15,7 @@ import type { StreamChunk } from '../types/provider/stream.js';
  * - tool calls are bucketed by `index` into the existing
  *   `Array<{ id, function: { name, arguments } }>` shape;
  * - usage and finishReason fall back to safe defaults when the provider
- *   omits them (defensive — see anthropics/anthropic-sdk-typescript#842
+ *   omits them (defensive — a known vendor-SDK failure mode
  *   where `message_stop` is occasionally dropped on connection close).
  *
  * The orchestrator does NOT call this helper — it consumes the stream

package/dist/provider/collect.js

@@ -14,7 +14,7 @@ import { mergeTokenUsage } from '../types/common/index.js';
  * - tool calls are bucketed by `index` into the existing
  *   `Array<{ id, function: { name, arguments } }>` shape;
  * - usage and finishReason fall back to safe defaults when the provider
- *   omits them (defensive — see anthropics/anthropic-sdk-typescript#842
+ *   omits them (defensive — a known vendor-SDK failure mode
  *   where `message_stop` is occasionally dropped on connection close).
  *
  * The orchestrator does NOT call this helper — it consumes the stream

package/dist/provider/collect.test.d.ts

@@ -11,7 +11,7 @@
  *   `arguments` fragments for that index.
  * - Latest-wins for `finishReason` and `usage`; defaults
  *   `finishReason: 'stop'` and zero usage if the provider omits them
- *   (defensive — see anthropics/anthropic-sdk-typescript#842).
+ *   (defensive — a vendor SDK has shipped this shape before).
  * - Throws if any chunk surfaces a `chunk.error`.
  *
  * Phase 2 swaps every internal `provider.chat()` call site for

package/dist/provider/collect.test.js

@@ -11,7 +11,7 @@
  *   `arguments` fragments for that index.
  * - Latest-wins for `finishReason` and `usage`; defaults
  *   `finishReason: 'stop'` and zero usage if the provider omits them
- *   (defensive — see anthropics/anthropic-sdk-typescript#842).
+ *   (defensive — a vendor SDK has shipped this shape before).
  * - Throws if any chunk surfaces a `chunk.error`.
  *
  * Phase 2 swaps every internal `provider.chat()` call site for

package/dist/provider/index.d.ts

@@ -5,4 +5,7 @@ export { MockLLMProvider } from './mock.js';
 export { registerMock, MOCK_CAPABILITIES } from './mock-register.js';
 export { PERMISSIVE_PROVIDER_CAPABILITIES, resolveProviderCapabilities, } from './capabilities.js';
 export type { ResolvedProviderCapabilities } from './capabilities.js';
+export { ProviderError, classifyProviderError, isAbortError, isProviderError, } from '../types/provider/errors.js';
+export { DEFAULT_PROVIDER_RETRY, withProviderRetry } from './retry.js';
+export type { ProviderRetryConfig, WithProviderRetryOptions } from './retry.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/provider/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/provider/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,GACnB,MAAM,aAAa,CAAA;AACpB,YAAY,EACX,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,GACxB,MAAM,aAAa,CAAA;AACpB,OAAO,EACN,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,2BAA2B,GAC3B,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACpE,OAAO,EACN,gCAAgC,EAChC,2BAA2B,GAC3B,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/provider/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,GACnB,MAAM,aAAa,CAAA;AACpB,YAAY,EACX,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,GACxB,MAAM,aAAa,CAAA;AACpB,OAAO,EACN,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,2BAA2B,GAC3B,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACpE,OAAO,EACN,gCAAgC,EAChC,2BAA2B,GAC3B,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAA;AACrE,OAAO,EACN,aAAa,EACb,qBAAqB,EACrB,YAAY,EACZ,eAAe,GACf,MAAM,6BAA6B,CAAA;AACpC,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AACtE,YAAY,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAA"}

package/dist/provider/index.js

@@ -3,4 +3,6 @@ export { ProviderRegistry, UnknownProviderError, DuplicateProviderError, LazyPro
 export { MockLLMProvider } from './mock.js';
 export { registerMock, MOCK_CAPABILITIES } from './mock-register.js';
 export { PERMISSIVE_PROVIDER_CAPABILITIES, resolveProviderCapabilities, } from './capabilities.js';
+export { ProviderError, classifyProviderError, isAbortError, isProviderError, } from '../types/provider/errors.js';
+export { DEFAULT_PROVIDER_RETRY, withProviderRetry } from './retry.js';
 //# sourceMappingURL=index.js.map

package/dist/provider/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/provider/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,GACnB,MAAM,aAAa,CAAA;AAMpB,OAAO,EACN,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,2BAA2B,GAC3B,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACpE,OAAO,EACN,gCAAgC,EAChC,2BAA2B,GAC3B,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/provider/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,GACnB,MAAM,aAAa,CAAA;AAMpB,OAAO,EACN,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,2BAA2B,GAC3B,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACpE,OAAO,EACN,gCAAgC,EAChC,2BAA2B,GAC3B,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EACN,aAAa,EACb,qBAAqB,EACrB,YAAY,EACZ,eAAe,GACf,MAAM,6BAA6B,CAAA;AACpC,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA"}

package/dist/provider/mock-register.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mock-register.d.ts","sourceRoot":"","sources":["../../src/provider/mock-register.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAItE,eAAO,MAAM,iBAAiB,EAAE,oBAI/B,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAInC"}
+{"version":3,"file":"mock-register.d.ts","sourceRoot":"","sources":["../../src/provider/mock-register.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAOtE,eAAO,MAAM,iBAAiB,EAAE,oBAI/B,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAInC"}

package/dist/provider/mock-register.js

@@ -1,9 +1,12 @@
 import { MockLLMProvider } from './mock.js';
 import { ProviderRegistry } from './registry.js';
+// The mock can script tool calls, so declaring otherwise made
+// capability negotiation strip the tool surface before a request was even
+// built — which is why no consumer could test a tool through the loop.
 export const MOCK_CAPABILITIES = {
-    supportsTools: false,
+    supportsTools: true,
     supportsStreaming: true,
-    supportsFunctionCalling: false,
+    supportsFunctionCalling: true,
 };
 /**
  * Register the built-in MockLLMProvider under type `'mock'`.

package/dist/provider/mock-register.js.map

@@ -1 +1 @@
-{"version":3,"file":"mock-register.js","sourceRoot":"","sources":["../../src/provider/mock-register.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAEhD,MAAM,CAAC,MAAM,iBAAiB,GAAyB;IACtD,aAAa,EAAE,KAAK;IACpB,iBAAiB,EAAE,IAAI;IACvB,uBAAuB,EAAE,KAAK;CAC9B,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY;IAC3B,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3C,gBAAgB,CAAC,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,iBAAiB,CAAC,CAAA;IACtE,CAAC;AACF,CAAC;AAED,+DAA+D;AAC/D,gFAAgF;AAChF,YAAY,EAAE,CAAA"}
+{"version":3,"file":"mock-register.js","sourceRoot":"","sources":["../../src/provider/mock-register.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAEhD,8DAA8D;AAC9D,0EAA0E;AAC1E,uEAAuE;AACvE,MAAM,CAAC,MAAM,iBAAiB,GAAyB;IACtD,aAAa,EAAE,IAAI;IACnB,iBAAiB,EAAE,IAAI;IACvB,uBAAuB,EAAE,IAAI;CAC7B,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY;IAC3B,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3C,gBAAgB,CAAC,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,iBAAiB,CAAC,CAAA;IACtE,CAAC;AACF,CAAC;AAED,+DAA+D;AAC/D,gFAAgF;AAChF,YAAY,EAAE,CAAA"}

package/dist/provider/mock.d.ts

@@ -1,14 +1,44 @@
-import type { ChatCompletionParams, LLMProvider, MockProviderConfig, StreamChunk } from '../types/provider/index.js';
+import type { ChatCompletionParams, LLMProvider, MockScript, ProviderCapabilities, StreamChunk } from '../types/provider/index.js';
+/**
+ * A model you script.
+ *
+ * The previous mock could only emit text: it never yielded
+ * `delta.toolCalls`, and `MOCK_CAPABILITIES.supportsTools` was `false`, so
+ * capability negotiation stripped the tool surface before a request was
+ * even built. A consumer writing a custom tool therefore had no supported
+ * way to test that the agent loop calls it — and namzu's own maintainers
+ * hand-rolled eight `implements LLMProvider` fakes across seven test files
+ * to work around exactly that, each re-implementing the delta bucketing
+ * and `toolCallEnd` framing that `streamProviderTurn` exists to hide.
+ *
+ * Scripted turns are emitted with the same frame sequence a real driver
+ * produces — per-tool `index`, id and name first, then argument fragments,
+ * then the block-close signal — so a test exercises the real consumer path
+ * rather than a shortcut through it.
+ */
 export declare class MockLLMProvider implements LLMProvider {
     readonly id = "mock";
     readonly name = "Mock LLM Provider";
+    readonly capabilities: ProviderCapabilities | undefined;
     private readonly model;
-    private readonly responseText;
     private readonly responseDelayMs;
-    constructor(config: MockProviderConfig);
-    private buildUsage;
+    private readonly turns;
+    private readonly nextTurn?;
+    private readonly onRequest?;
+    private turnIndex;
+    /** Every request this provider has received, in order. */
+    readonly requests: ChatCompletionParams[];
+    constructor(config?: MockScript);
+    /** Reset the script pointer and captured requests between cases. */
+    reset(): void;
     private delay;
-    private normalizeResponse;
+    /**
+     * The turn to play. A script shorter than the run repeats its last
+     * entry, so a test that only cares about the first two turns does not
+     * have to pad the rest — and a loop bug shows up as repetition rather
+     * than an exhausted-script crash.
+     */
+    private resolveTurn;
     chatStream(params: ChatCompletionParams): AsyncIterable<StreamChunk>;
     listModels(): Promise<{
         id: string;

package/dist/provider/mock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../src/provider/mock.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,oBAAoB,EAEpB,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,MAAM,4BAA4B,CAAA;AAEnC,qBAAa,eAAgB,YAAW,WAAW;IAClD,QAAQ,CAAC,EAAE,UAAS;IACpB,QAAQ,CAAC,IAAI,uBAAsB;IAEnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;IACrC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAQ;gBAE5B,MAAM,EAAE,kBAAkB;IAMtC,OAAO,CAAC,UAAU;YAUJ,KAAK;IAKnB,OAAO,CAAC,iBAAiB;IAalB,UAAU,CAAC,MAAM,EAAE,oBAAoB,GAAG,aAAa,CAAC,WAAW,CAAC;IAuBrE,UAAU;;;;;;;;;;IAeV,WAAW;CAIjB"}
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../src/provider/mock.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,oBAAoB,EACpB,WAAW,EACX,UAAU,EAEV,oBAAoB,EACpB,WAAW,EACX,MAAM,4BAA4B,CAAA;AAUnC;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,eAAgB,YAAW,WAAW;IAClD,QAAQ,CAAC,EAAE,UAAS;IACpB,QAAQ,CAAC,IAAI,uBAAsB;IACnC,QAAQ,CAAC,YAAY,EAAE,oBAAoB,GAAG,SAAS,CAAA;IAEvD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAQ;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAA+D;IACzF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAwC;IACnE,OAAO,CAAC,SAAS,CAAI;IAErB,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,EAAE,CAAK;gBAElC,MAAM,GAAE,UAAe;IASnC,oEAAoE;IACpE,KAAK,IAAI,IAAI;YAKC,KAAK;IAKnB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAMZ,UAAU,CAAC,MAAM,EAAE,oBAAoB,GAAG,aAAa,CAAC,WAAW,CAAC;IA2ErE,UAAU;;;;;;;;;;IAeV,WAAW;CAIjB"}

package/dist/provider/mock.js

@@ -1,59 +1,131 @@
 import { FALLBACK_MOCK_MODEL } from '../constants/provider/index.js';
+const EMPTY_USAGE = {
+    promptTokens: 0,
+    completionTokens: 0,
+    totalTokens: 0,
+    cachedTokens: 0,
+    cacheWriteTokens: 0,
+};
+/**
+ * A model you script.
+ *
+ * The previous mock could only emit text: it never yielded
+ * `delta.toolCalls`, and `MOCK_CAPABILITIES.supportsTools` was `false`, so
+ * capability negotiation stripped the tool surface before a request was
+ * even built. A consumer writing a custom tool therefore had no supported
+ * way to test that the agent loop calls it — and namzu's own maintainers
+ * hand-rolled eight `implements LLMProvider` fakes across seven test files
+ * to work around exactly that, each re-implementing the delta bucketing
+ * and `toolCallEnd` framing that `streamProviderTurn` exists to hide.
+ *
+ * Scripted turns are emitted with the same frame sequence a real driver
+ * produces — per-tool `index`, id and name first, then argument fragments,
+ * then the block-close signal — so a test exercises the real consumer path
+ * rather than a shortcut through it.
+ */
 export class MockLLMProvider {
     id = 'mock';
     name = 'Mock LLM Provider';
+    capabilities;
     model;
-    responseText;
     responseDelayMs;
-    constructor(config) {
+    turns;
+    nextTurn;
+    onRequest;
+    turnIndex = 0;
+    /** Every request this provider has received, in order. */
+    requests = [];
+    constructor(config = {}) {
+        this.capabilities = config.capabilities;
         this.model = config.model ?? FALLBACK_MOCK_MODEL;
-        this.responseText = config.responseText ?? 'Mock provider response';
         this.responseDelayMs = config.responseDelayMs ?? 0;
+        this.onRequest = config.onRequest;
+        this.nextTurn = config.nextTurn;
+        this.turns = config.turns ?? [{ text: config.responseText ?? 'Mock provider response' }]; // Back-compat: the old single-string config becomes a one-turn script.
     }
-    buildUsage() {
-        return {
-            promptTokens: 0,
-            completionTokens: 0,
-            totalTokens: 0,
-            cachedTokens: 0,
-            cacheWriteTokens: 0,
-        };
+    /** Reset the script pointer and captured requests between cases. */
+    reset() {
+        this.turnIndex = 0;
+        this.requests.length = 0;
     }
     async delay() {
         if (this.responseDelayMs <= 0)
             return;
         await new Promise((resolve) => setTimeout(resolve, this.responseDelayMs));
     }
-    normalizeResponse(params, message) {
-        return {
-            id: `mock-${Date.now()}-${Math.floor(Math.random() * 1_000_000)}`,
-            model: params.model ?? this.model,
-            message: {
-                role: 'assistant',
-                content: message,
-            },
-            finishReason: 'stop',
-            usage: this.buildUsage(),
-        };
+    /**
+     * The turn to play. A script shorter than the run repeats its last
+     * entry, so a test that only cares about the first two turns does not
+     * have to pad the rest — and a loop bug shows up as repetition rather
+     * than an exhausted-script crash.
+     */
+    resolveTurn(params) {
+        const index = this.turnIndex++;
+        if (this.nextTurn)
+            return this.nextTurn(params, index);
+        return this.turns[Math.min(index, this.turns.length - 1)] ?? { text: '' };
     }
     async *chatStream(params) {
         await this.delay();
-        const response = this.normalizeResponse(params, this.responseText);
-        const content = response.message.content ?? '';
-        const chunkSize = 8;
-        for (let i = 0; i < content.length; i += chunkSize) {
+        this.requests.push(params);
+        this.onRequest?.(params);
+        const turn = this.resolveTurn(params);
+        const id = `mock-${this.turnIndex}`;
+        if (turn.error !== undefined) {
+            // Surfaced as a thrown error, the way a driver reports a request
+            // that never produced a stream.
+            throw Object.assign(new Error(turn.error.message), {
+                ...(turn.error.status !== undefined ? { status: turn.error.status } : {}),
+            });
+        }
+        // Before the text, as the wire does: a citation names the passage an
+        // upcoming sentence rests on.
+        for (const citation of turn.citations ?? []) {
+            yield { id, delta: { citation } };
+        }
+        const text = turn.text ?? '';
+        const chunkSize = turn.chunkSize ?? 8;
+        let emitted = 0;
+        for (let i = 0; i < text.length; i += chunkSize) {
+            if (turn.throwAfterChunks !== undefined && emitted >= turn.throwAfterChunks) {
+                throw new Error(turn.throwMessage ?? 'mock stream failure');
+            }
+            yield { id, delta: { content: text.slice(i, i + chunkSize) } };
+            emitted++;
+        }
+        const toolCalls = turn.toolCalls ?? [];
+        for (const [index, call] of toolCalls.entries()) {
+            const callId = call.id ?? `call_${this.turnIndex}_${index}`;
             yield {
-                id: response.id,
+                id,
                 delta: {
-                    content: content.slice(i, i + chunkSize),
+                    toolCalls: [
+                        { index, id: callId, type: 'function', function: { name: call.name, arguments: '' } },
+                    ],
                 },
             };
+            // Arguments arrive as JSON fragments, which is what forces the
+            // consumer's partial-JSON buffering to be exercised.
+            const args = call.rawArguments ?? JSON.stringify(call.args ?? {});
+            const step = call.argChunkSize ?? Math.max(1, Math.ceil(args.length / 3));
+            for (let i = 0; i < args.length; i += step) {
+                yield {
+                    id,
+                    delta: { toolCalls: [{ index, function: { arguments: args.slice(i, i + step) } }] },
+                };
+            }
+            if (call.throwAfterArguments !== undefined) {
+                throw new Error(call.throwAfterArguments);
+            }
+            if (call.truncateArguments !== true) {
+                yield { id, delta: { toolCallEnd: { index, id: callId } } };
+            }
         }
         yield {
-            id: response.id,
+            id,
             delta: {},
-            finishReason: 'stop',
-            usage: response.usage,
+            finishReason: turn.finishReason ?? (toolCalls.length > 0 ? 'tool_calls' : 'stop'),
+            usage: { ...EMPTY_USAGE, ...turn.usage },
         };
     }
     async listModels() {
@@ -65,7 +137,7 @@ export class MockLLMProvider {
                 maxOutputTokens: 8_000,
                 inputPrice: 0,
                 outputPrice: 0,
-                supportsToolUse: false,
+                supportsToolUse: true,
                 supportsStreaming: true,
             },
         ];