@namzu/sdk 0.4.3 → 0.4.4

package/dist/probe/registry.test.js

@@ -0,0 +1,310 @@
+/**
+ * Ratified §9 of docs.local/sessions/ses_007-probe-and-doctor/design.md.
+ * These tests pin the contract documented there — not an internal
+ * implementation detail. If the semantics change, update §9 first.
+ */
+import { describe, expect, it, vi } from 'vitest';
+import { buildProbeContext } from './context.js';
+import { ProbeNameCollisionError } from './errors.js';
+import { createProbeRegistry } from './registry.js';
+function makeLogger() {
+    const self = {
+        info: vi.fn(),
+        warn: vi.fn(),
+        error: vi.fn(),
+        debug: vi.fn(),
+        child: vi.fn(),
+    };
+    self.child = vi.fn(() => self);
+    return self;
+}
+describe('ProbeRegistry — typed dispatch', () => {
+    it('fires a typed probe when the event kind matches', () => {
+        const reg = createProbeRegistry();
+        const seen = [];
+        reg.on('tool_executing', (event) => {
+            seen.push(event.toolName);
+        });
+        reg.dispatch({
+            type: 'tool_executing',
+            runId: 'run_1',
+            toolName: 'fs.read',
+            input: {},
+        }, buildProbeContext());
+        expect(seen).toEqual(['fs.read']);
+    });
+    it('does not fire a typed probe for a different event kind', () => {
+        const reg = createProbeRegistry();
+        const handler = vi.fn();
+        reg.on('tool_executing', handler);
+        reg.dispatch({ type: 'tool_completed', runId: 'r', toolName: 't', result: 'ok' }, buildProbeContext());
+        expect(handler).not.toHaveBeenCalled();
+    });
+    it('supports array-of-kinds registration', () => {
+        const reg = createProbeRegistry();
+        const seen = [];
+        reg.on(['tool_executing', 'tool_completed'], (event) => {
+            seen.push(event.type);
+        });
+        reg.dispatch({ type: 'tool_executing', runId: 'r', toolName: 't', input: {} }, buildProbeContext());
+        reg.dispatch({ type: 'tool_completed', runId: 'r', toolName: 't', result: 'ok' }, buildProbeContext());
+        expect(seen).toEqual(['tool_executing', 'tool_completed']);
+    });
+    it('applies the where filter before the handler', () => {
+        const reg = createProbeRegistry();
+        const handler = vi.fn();
+        reg.on('tool_executing', handler, {
+            where: (event) => event.toolName === 'fs.write',
+        });
+        reg.dispatch({ type: 'tool_executing', runId: 'r', toolName: 'fs.read', input: {} }, buildProbeContext());
+        expect(handler).not.toHaveBeenCalled();
+        reg.dispatch({ type: 'tool_executing', runId: 'r', toolName: 'fs.write', input: {} }, buildProbeContext());
+        expect(handler).toHaveBeenCalledTimes(1);
+    });
+});
+describe('ProbeRegistry — ordering', () => {
+    it('fires probes in ascending priority; ties break by registration order', () => {
+        const reg = createProbeRegistry();
+        const order = [];
+        reg.on('tool_executing', () => order.push('a'), { priority: 10, name: 'a' });
+        reg.on('tool_executing', () => order.push('b'), { priority: 5, name: 'b' });
+        reg.on('tool_executing', () => order.push('c'), { priority: 10, name: 'c' });
+        reg.on('tool_executing', () => order.push('d'), { priority: 0, name: 'd' });
+        reg.dispatch({ type: 'tool_executing', runId: 'r', toolName: 't', input: {} }, buildProbeContext());
+        expect(order).toEqual(['d', 'b', 'a', 'c']);
+    });
+    it('typed probes fire BEFORE the between-tier callback; catch-all fires AFTER', () => {
+        const reg = createProbeRegistry();
+        const order = [];
+        reg.on('tool_executing', () => order.push('typed'));
+        reg.onAny(() => order.push('any'));
+        reg.dispatch({ type: 'tool_executing', runId: 'r', toolName: 't', input: {} }, buildProbeContext(), () => order.push('between'));
+        expect(order).toEqual(['typed', 'between', 'any']);
+    });
+});
+describe('ProbeRegistry — name collision + override', () => {
+    it('throws ProbeNameCollisionError on duplicate name without override', () => {
+        const reg = createProbeRegistry();
+        reg.on('tool_executing', () => { }, { name: 'dup' });
+        expect(() => reg.on('tool_executing', () => { }, { name: 'dup' })).toThrow(ProbeNameCollisionError);
+    });
+    it('allows replacing when override: true', () => {
+        const reg = createProbeRegistry();
+        const first = vi.fn();
+        const second = vi.fn();
+        reg.on('tool_executing', first, { name: 'x' });
+        reg.on('tool_executing', second, { name: 'x', override: true });
+        reg.dispatch({ type: 'tool_executing', runId: 'r', toolName: 't', input: {} }, buildProbeContext());
+        expect(first).not.toHaveBeenCalled();
+        expect(second).toHaveBeenCalledTimes(1);
+    });
+    it('unsubscribes the previous entry on override so the name can be reused', () => {
+        const reg = createProbeRegistry();
+        reg.on('tool_executing', () => { }, { name: 'x' });
+        reg.on('tool_executing', () => { }, { name: 'x', override: true });
+        expect(() => reg.on('tool_executing', () => { }, { name: 'x' })).toThrow(ProbeNameCollisionError);
+    });
+});
+describe('ProbeRegistry — throw isolation', () => {
+    it('a throwing probe does not suppress later probes', () => {
+        const reg = createProbeRegistry();
+        reg.setLogger(makeLogger());
+        const seen = [];
+        reg.on('tool_executing', () => {
+            throw new Error('boom');
+        }, { priority: 0, name: 'bad' });
+        reg.on('tool_executing', () => seen.push('ran'), { priority: 10, name: 'good' });
+        reg.dispatch({ type: 'tool_executing', runId: 'r', toolName: 't', input: {} }, buildProbeContext());
+        expect(seen).toEqual(['ran']);
+    });
+    it('a throwing probe does not suppress the between-tier callback or the catch-all', () => {
+        const reg = createProbeRegistry();
+        reg.setLogger(makeLogger());
+        const order = [];
+        reg.on('tool_executing', () => {
+            throw new Error('boom');
+        }, { name: 'bad' });
+        reg.onAny(() => order.push('any'));
+        reg.dispatch({ type: 'tool_executing', runId: 'r', toolName: 't', input: {} }, buildProbeContext(), () => order.push('between'));
+        expect(order).toEqual(['between', 'any']);
+    });
+});
+describe('ProbeRegistry — frozen event boundary', () => {
+    it('freezes the event before fan-out so probes cannot mutate it', () => {
+        const reg = createProbeRegistry();
+        reg.on('tool_executing', (event) => {
+            expect(() => {
+                ;
+                event.toolName = 'mutated';
+            }).toThrow();
+        });
+        reg.dispatch({ type: 'tool_executing', runId: 'r', toolName: 't', input: {} }, buildProbeContext());
+    });
+    it('later probes see the original event value, not a mutation from an earlier probe', () => {
+        const reg = createProbeRegistry();
+        reg.setLogger(makeLogger());
+        const tampered = [];
+        reg.on('tool_executing', (event) => {
+            try {
+                ;
+                event.toolName = 'mutated';
+            }
+            catch {
+                // expected — frozen
+            }
+        }, { priority: 0 });
+        reg.on('tool_executing', (event) => {
+            tampered.push(event.toolName);
+        }, { priority: 10 });
+        reg.dispatch({ type: 'tool_executing', runId: 'r', toolName: 'original', input: {} }, buildProbeContext());
+        expect(tampered).toEqual(['original']);
+    });
+});
+describe('ProbeRegistry — unsubscribe', () => {
+    it('unsub removes the probe from subsequent dispatches', () => {
+        const reg = createProbeRegistry();
+        const handler = vi.fn();
+        const unsub = reg.on('tool_executing', handler);
+        reg.dispatch({ type: 'tool_executing', runId: 'r', toolName: 't', input: {} }, buildProbeContext());
+        unsub();
+        reg.dispatch({ type: 'tool_executing', runId: 'r', toolName: 't', input: {} }, buildProbeContext());
+        expect(handler).toHaveBeenCalledTimes(1);
+    });
+    it('unsub on an array-kind probe removes it from every kind it was registered for', () => {
+        const reg = createProbeRegistry();
+        const handler = vi.fn();
+        const unsub = reg.on(['tool_executing', 'tool_completed'], handler);
+        unsub();
+        reg.dispatch({ type: 'tool_executing', runId: 'r', toolName: 't', input: {} }, buildProbeContext());
+        reg.dispatch({ type: 'tool_completed', runId: 'r', toolName: 't', result: 'ok' }, buildProbeContext());
+        expect(handler).not.toHaveBeenCalled();
+    });
+});
+describe('ProbeRegistry — catch-all', () => {
+    it('onAny receives every event regardless of kind', () => {
+        const reg = createProbeRegistry();
+        const seen = [];
+        reg.onAny((event) => seen.push(event.type));
+        reg.dispatch({ type: 'tool_executing', runId: 'r', toolName: 't', input: {} }, buildProbeContext());
+        reg.dispatch({ type: 'lock_acquired', lockId: 'lock_1', filePath: '/x', owner: 'r' }, buildProbeContext());
+        expect(seen).toEqual(['tool_executing', 'lock_acquired']);
+    });
+});
+describe('ProbeRegistry — ctx.isReplay', () => {
+    it('defaults to false when unset', () => {
+        const reg = createProbeRegistry();
+        let seenReplay;
+        reg.on('tool_executing', (_event, ctx) => {
+            seenReplay = ctx.isReplay;
+        });
+        reg.dispatch({ type: 'tool_executing', runId: 'r', toolName: 't', input: {} }, buildProbeContext());
+        expect(seenReplay).toBe(false);
+    });
+    it('carries isReplay:true when the event is from a replayed run', () => {
+        const reg = createProbeRegistry();
+        let seenReplay;
+        reg.on('tool_executing', (_event, ctx) => {
+            seenReplay = ctx.isReplay;
+        });
+        reg.dispatch({ type: 'tool_executing', runId: 'r', toolName: 't', input: {} }, buildProbeContext({ isReplay: true }));
+        expect(seenReplay).toBe(true);
+    });
+});
+describe('ProbeRegistry — veto API', () => {
+    it('returns allow when no veto handlers registered', () => {
+        const reg = createProbeRegistry();
+        const outcome = reg.queryVeto({ type: 'tool_executing', runId: 'r', toolName: 't', input: {} }, buildProbeContext());
+        expect(outcome.action).toBe('allow');
+        expect(outcome.probeName).toBeUndefined();
+    });
+    it('returns deny when a veto handler returns "deny"', () => {
+        const reg = createProbeRegistry();
+        reg.veto('tool_executing', () => 'deny', { name: 'fs-guard' });
+        const outcome = reg.queryVeto({ type: 'tool_executing', runId: 'r', toolName: 'fs.write', input: {} }, buildProbeContext());
+        expect(outcome.action).toBe('deny');
+        expect(outcome.probeName).toBe('fs-guard');
+    });
+    it('returns deny + reason when handler returns { action: "deny", reason }', () => {
+        const reg = createProbeRegistry();
+        reg.veto('tool_executing', () => ({ action: 'deny', reason: 'outside workspace' }), {
+            name: 'sandbox',
+        });
+        const outcome = reg.queryVeto({ type: 'tool_executing', runId: 'r', toolName: 'fs.write', input: {} }, buildProbeContext());
+        expect(outcome.action).toBe('deny');
+        expect(outcome.probeName).toBe('sandbox');
+        expect(outcome.reason).toBe('outside workspace');
+    });
+    it('first-deny-wins by ascending priority; subsequent veto handlers still run for audit', () => {
+        const reg = createProbeRegistry();
+        const audit = [];
+        reg.veto('tool_executing', () => {
+            audit.push('high-priority-allow');
+            return 'allow';
+        }, { priority: 0, name: 'p0-allow' });
+        reg.veto('tool_executing', () => {
+            audit.push('mid-priority-deny');
+            return { action: 'deny', reason: 'first' };
+        }, { priority: 5, name: 'p5-deny' });
+        reg.veto('tool_executing', () => {
+            audit.push('low-priority-deny');
+            return { action: 'deny', reason: 'second' };
+        }, { priority: 10, name: 'p10-deny' });
+        const outcome = reg.queryVeto({ type: 'tool_executing', runId: 'r', toolName: 't', input: {} }, buildProbeContext());
+        expect(outcome.action).toBe('deny');
+        expect(outcome.probeName).toBe('p5-deny');
+        expect(outcome.reason).toBe('first');
+        expect(audit).toEqual(['high-priority-allow', 'mid-priority-deny', 'low-priority-deny']);
+    });
+    it('a throwing veto handler defaults to allow for that probe; aggregate unaffected', () => {
+        const reg = createProbeRegistry();
+        reg.setLogger(makeLogger());
+        const audit = [];
+        reg.veto('tool_executing', () => {
+            audit.push('throw');
+            throw new Error('boom');
+        }, { priority: 0, name: 'bad' });
+        reg.veto('tool_executing', () => {
+            audit.push('allow');
+            return 'allow';
+        }, { priority: 5, name: 'good' });
+        const outcome = reg.queryVeto({ type: 'tool_executing', runId: 'r', toolName: 't', input: {} }, buildProbeContext());
+        expect(outcome.action).toBe('allow');
+        expect(audit).toEqual(['throw', 'allow']);
+    });
+    it('observe-tier dispatch is independent — veto registration does not fire on dispatch', () => {
+        const reg = createProbeRegistry();
+        const vetoCalls = [];
+        reg.veto('tool_executing', () => {
+            vetoCalls.push(1);
+            return 'deny';
+        }, { name: 'v' });
+        reg.dispatch({ type: 'tool_executing', runId: 'r', toolName: 't', input: {} }, buildProbeContext());
+        expect(vetoCalls).toEqual([]);
+    });
+    it('honors where filter on veto registrations', () => {
+        const reg = createProbeRegistry();
+        reg.veto('tool_executing', () => 'deny', {
+            name: 'writes-only',
+            where: (event) => event.toolName.startsWith('fs.write'),
+        });
+        const allow = reg.queryVeto({ type: 'tool_executing', runId: 'r', toolName: 'fs.read', input: {} }, buildProbeContext());
+        const deny = reg.queryVeto({ type: 'tool_executing', runId: 'r', toolName: 'fs.write.x', input: {} }, buildProbeContext());
+        expect(allow.action).toBe('allow');
+        expect(deny.action).toBe('deny');
+    });
+    it('unsubscribing a veto handler removes it from subsequent queries', () => {
+        const reg = createProbeRegistry();
+        const unsub = reg.veto('tool_executing', () => 'deny', { name: 'g' });
+        const denied = reg.queryVeto({ type: 'tool_executing', runId: 'r', toolName: 't', input: {} }, buildProbeContext());
+        expect(denied.action).toBe('deny');
+        unsub();
+        const allowed = reg.queryVeto({ type: 'tool_executing', runId: 'r', toolName: 't', input: {} }, buildProbeContext());
+        expect(allowed.action).toBe('allow');
+    });
+    it('name collision applies across observe + veto tiers', () => {
+        const reg = createProbeRegistry();
+        reg.on('tool_executing', () => { }, { name: 'shared' });
+        expect(() => reg.veto('tool_executing', () => 'allow', { name: 'shared' })).toThrow(ProbeNameCollisionError);
+    });
+});
+//# sourceMappingURL=registry.test.js.map

package/dist/probe/registry.test.js.map

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

package/dist/provider/instrumentation.d.ts

@@ -0,0 +1,9 @@
+import { type ProbeRegistry } from '../probe/registry.js';
+import type { RunId } from '../types/ids/index.js';
+import type { LLMProvider } from '../types/provider/interface.js';
+export interface ProviderInstrumentationOptions {
+    readonly probes?: ProbeRegistry;
+    readonly runId?: RunId;
+}
+export declare function wrapProviderWithProbes(provider: LLMProvider, opts?: ProviderInstrumentationOptions): LLMProvider;
+//# sourceMappingURL=instrumentation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.d.ts","sourceRoot":"","sources":["../../src/provider/instrumentation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,aAAa,EAAiC,MAAM,sBAAsB,CAAA;AAExF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AAElD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAA;AAGjE,MAAM,WAAW,8BAA8B;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAA;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CACtB;AAoBD,wBAAgB,sBAAsB,CACrC,QAAQ,EAAE,WAAW,EACrB,IAAI,GAAE,8BAAmC,GACvC,WAAW,CAwGb"}

package/dist/provider/instrumentation.js

@@ -0,0 +1,104 @@
+import { buildProbeContext } from '../probe/context.js';
+import { probe as defaultProbeRegistry } from '../probe/registry.js';
+let providerCallCounter = 0;
+function nextCallId() {
+    providerCallCounter += 1;
+    return `pcall_${Date.now().toString(36)}${providerCallCounter.toString(36)}`;
+}
+function extractUsage(response) {
+    const usage = response.usage;
+    if (!usage)
+        return undefined;
+    return {
+        inputTokens: usage.inputTokens,
+        outputTokens: usage.outputTokens,
+        totalTokens: usage.totalTokens,
+        costUsd: usage.costUsd,
+    };
+}
+export function wrapProviderWithProbes(provider, opts = {}) {
+    const probes = opts.probes ?? defaultProbeRegistry;
+    const runId = opts.runId;
+    const wrapped = {
+        id: provider.id,
+        name: provider.name,
+        listModels: provider.listModels?.bind(provider),
+        healthCheck: provider.healthCheck?.bind(provider),
+        async chat(params) {
+            const callId = nextCallId();
+            const ctx = buildProbeContext({ runId });
+            const startedAt = Date.now();
+            probes.dispatch({
+                type: 'provider_call_start',
+                providerId: provider.id,
+                model: params.model,
+                callId,
+                runId,
+            }, ctx);
+            try {
+                const response = await provider.chat(params);
+                probes.dispatch({
+                    type: 'provider_call_completed',
+                    providerId: provider.id,
+                    model: params.model,
+                    callId,
+                    runId,
+                    durationMs: Date.now() - startedAt,
+                    usage: extractUsage(response),
+                }, ctx);
+                return response;
+            }
+            catch (error) {
+                probes.dispatch({
+                    type: 'provider_call_failed',
+                    providerId: provider.id,
+                    model: params.model,
+                    callId,
+                    runId,
+                    durationMs: Date.now() - startedAt,
+                    error: error instanceof Error ? error.message : String(error),
+                }, ctx);
+                throw error;
+            }
+        },
+        async *chatStream(params) {
+            const callId = nextCallId();
+            const ctx = buildProbeContext({ runId });
+            const startedAt = Date.now();
+            probes.dispatch({
+                type: 'provider_call_start',
+                providerId: provider.id,
+                model: params.model,
+                callId,
+                runId,
+            }, ctx);
+            try {
+                for await (const chunk of provider.chatStream(params)) {
+                    yield chunk;
+                }
+                probes.dispatch({
+                    type: 'provider_call_completed',
+                    providerId: provider.id,
+                    model: params.model,
+                    callId,
+                    runId,
+                    durationMs: Date.now() - startedAt,
+                }, ctx);
+            }
+            catch (error) {
+                probes.dispatch({
+                    type: 'provider_call_failed',
+                    providerId: provider.id,
+                    model: params.model,
+                    callId,
+                    runId,
+                    durationMs: Date.now() - startedAt,
+                    error: error instanceof Error ? error.message : String(error),
+                }, ctx);
+                throw error;
+            }
+        },
+    };
+    return wrapped;
+}
+//# sourceMappingURL=instrumentation.js.map

package/dist/provider/instrumentation.js.map

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=instrumentation.test.d.ts.map

package/dist/provider/instrumentation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.test.d.ts","sourceRoot":"","sources":["../../src/provider/instrumentation.test.ts"],"names":[],"mappings":""}

package/dist/provider/instrumentation.test.js

@@ -0,0 +1,152 @@
+import { describe, expect, it, vi } from 'vitest';
+import { buildProbeContext } from '../probe/context.js';
+import { createProbeRegistry } from '../probe/registry.js';
+import { wrapProviderWithProbes } from './instrumentation.js';
+function makeFakeProvider(overrides = {}) {
+    const defaultChat = async (_params) => {
+        return {
+            content: 'ok',
+            usage: { inputTokens: 10, outputTokens: 5, totalTokens: 15 },
+        };
+    };
+    const defaultStream = async function* (_params) {
+        yield { delta: 'hi' };
+    };
+    return {
+        id: 'p1',
+        name: 'Provider 1',
+        chat: overrides.chat ?? defaultChat,
+        chatStream: overrides.chatStream ?? defaultStream,
+    };
+}
+const params = { model: 'm1', messages: [] };
+describe('wrapProviderWithProbes — chat', () => {
+    it('emits provider_call_start before the chat call and provider_call_completed after', async () => {
+        const reg = createProbeRegistry();
+        const seen = [];
+        reg.onAny((event) => seen.push(event));
+        const wrapped = wrapProviderWithProbes(makeFakeProvider(), { probes: reg });
+        await wrapped.chat(params);
+        expect(seen.map((e) => e.type)).toEqual(['provider_call_start', 'provider_call_completed']);
+        const start = seen[0];
+        const completed = seen[1];
+        expect(start.providerId).toBe('p1');
+        expect(start.model).toBe('m1');
+        expect(completed.callId).toBe(start.callId);
+        expect(completed.usage).toEqual({ inputTokens: 10, outputTokens: 5, totalTokens: 15 });
+        expect(completed.durationMs).toBeGreaterThanOrEqual(0);
+    });
+    it('emits provider_call_failed and re-throws when chat throws', async () => {
+        const reg = createProbeRegistry();
+        const seen = [];
+        reg.onAny((event) => seen.push(event));
+        const failing = makeFakeProvider({
+            chat: async () => {
+                throw new Error('boom');
+            },
+        });
+        const wrapped = wrapProviderWithProbes(failing, { probes: reg });
+        await expect(wrapped.chat(params)).rejects.toThrow('boom');
+        expect(seen.map((e) => e.type)).toEqual(['provider_call_start', 'provider_call_failed']);
+        const failed = seen[1];
+        expect(failed.error).toBe('boom');
+    });
+    it('correlates start and completed by callId', async () => {
+        const reg = createProbeRegistry();
+        const ids = [];
+        reg.on('provider_call_start', (event) => ids.push(`s:${event.callId}`));
+        reg.on('provider_call_completed', (event) => ids.push(`c:${event.callId}`));
+        const wrapped = wrapProviderWithProbes(makeFakeProvider(), { probes: reg });
+        await wrapped.chat(params);
+        await wrapped.chat(params);
+        expect(ids.length).toBe(4);
+        expect(ids[0]?.split(':')[1]).toBe(ids[1]?.split(':')[1]);
+        expect(ids[2]?.split(':')[1]).toBe(ids[3]?.split(':')[1]);
+        expect(ids[0]).not.toBe(ids[2]);
+    });
+    it('forwards optional methods (listModels, healthCheck) to the inner provider', () => {
+        const listModels = vi.fn();
+        const healthCheck = vi.fn();
+        const inner = { ...makeFakeProvider(), listModels, healthCheck };
+        const wrapped = wrapProviderWithProbes(inner);
+        wrapped.listModels?.();
+        wrapped.healthCheck?.();
+        expect(listModels).toHaveBeenCalledTimes(1);
+        expect(healthCheck).toHaveBeenCalledTimes(1);
+    });
+});
+describe('wrapProviderWithProbes — chatStream', () => {
+    it('emits provider_call_start before iteration and provider_call_completed after', async () => {
+        const reg = createProbeRegistry();
+        const seen = [];
+        reg.onAny((event) => seen.push(event));
+        const wrapped = wrapProviderWithProbes(makeFakeProvider(), { probes: reg });
+        const chunks = [];
+        for await (const chunk of wrapped.chatStream(params)) {
+            chunks.push(chunk);
+        }
+        expect(chunks.length).toBe(1);
+        expect(seen.map((e) => e.type)).toEqual(['provider_call_start', 'provider_call_completed']);
+    });
+    it('emits provider_call_failed when the underlying stream throws mid-iteration', async () => {
+        const reg = createProbeRegistry();
+        const seen = [];
+        reg.onAny((event) => seen.push(event));
+        const failing = makeFakeProvider({
+            chatStream: async function* (_params) {
+                yield { delta: 'a' };
+                throw new Error('stream-boom');
+            },
+        });
+        const wrapped = wrapProviderWithProbes(failing, { probes: reg });
+        await expect(async () => {
+            for await (const _chunk of wrapped.chatStream(params)) {
+                // noop
+            }
+        }).rejects.toThrow('stream-boom');
+        expect(seen.map((e) => e.type)).toEqual(['provider_call_start', 'provider_call_failed']);
+    });
+});
+describe('wrapProviderWithProbes — runId propagation', () => {
+    it('attaches runId to each emitted event when supplied', async () => {
+        const reg = createProbeRegistry();
+        let observedRunId;
+        reg.on('provider_call_start', (event, ctx) => {
+            observedRunId = event.runId ?? ctx.runId;
+        });
+        const wrapped = wrapProviderWithProbes(makeFakeProvider(), {
+            probes: reg,
+            runId: 'run_42',
+        });
+        await wrapped.chat(params);
+        expect(observedRunId).toBe('run_42');
+    });
+});
+describe('wrapProviderWithProbes — uses singleton when no probes opt provided', () => {
+    it('still wraps successfully without throwing (smoke)', async () => {
+        // Use a fresh inner provider; we just want to verify the default path
+        // instantiates and runs. Singleton dispatch is exercised in registry tests.
+        const wrapped = wrapProviderWithProbes(makeFakeProvider());
+        await expect(wrapped.chat(params)).resolves.toBeDefined();
+    });
+});
+describe('wrapProviderWithProbes — context still flows through buildProbeContext', () => {
+    it('handler receives a frozen ctx', async () => {
+        const reg = createProbeRegistry();
+        let captured;
+        reg.on('provider_call_start', (_event, ctx) => {
+            captured = ctx;
+        });
+        const wrapped = wrapProviderWithProbes(makeFakeProvider(), { probes: reg });
+        await wrapped.chat(params);
+        expect(captured).toBeDefined();
+        expect(Object.isFrozen(captured)).toBe(true);
+        expect(captured?.isReplay).toBe(false);
+    });
+    it('buildProbeContext used internally returns a frozen ProbeContext (sanity check)', () => {
+        const ctx = buildProbeContext({ isReplay: true });
+        expect(ctx.isReplay).toBe(true);
+        expect(Object.isFrozen(ctx)).toBe(true);
+    });
+});
+//# sourceMappingURL=instrumentation.test.js.map

package/dist/provider/instrumentation.test.js.map

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