@namzu/sdk 0.4.2 → 0.4.4

package/dist/connector/mcp/adapter.test.js

@@ -0,0 +1,199 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 5):
+ *
+ *   - `mcpJsonSchemaToZod(schema)`:
+ *     - Empty / no-properties object → passthrough `z.object({})`.
+ *     - Maps primitive types (string, number, integer, boolean, array,
+ *       object) to zod equivalents.
+ *     - Unknown / null property types → `z.unknown()`.
+ *     - Fields not in `required[]` are `.optional()`.
+ *   - `zodToMCPJsonSchema(zodSchema)` wraps `zodToJsonSchema` with
+ *     `type: 'object'` prefixed.
+ *   - `mcpToolToToolDefinition(tool, client, serverName)` produces a
+ *     ToolDefinition:
+ *     - name = `mcp_<server>_<tool.name>`
+ *     - description prefixed `[MCP:<server>] <tool.description or name>`
+ *     - category = 'network', permissions = ['network_access']
+ *     - readOnly + destructive reflect MCP annotations; concurrency
+ *       safe defaults to true.
+ *     - `execute(input, ctx)` calls `client.callTool(tool.name, input)`
+ *       and adapts the MCPToolResult.
+ *   - `toolDefinitionToMCPTool(tool)` projects name/description +
+ *     converts inputSchema + copies annotations.
+ *   - `mcpToolResultToToolResult`:
+ *     - success = !isError.
+ *     - output = text content joined with '\n' (non-text blocks
+ *       kept in `data` only).
+ *     - error = same joined text when isError, else undefined.
+ *   - `toolResultToMCPToolResult`:
+ *     - success + output → single text block.
+ *     - failure + error → single text block + isError.
+ *     - Empty output on success → single empty-text block.
+ */
+import { describe, expect, it, vi } from 'vitest';
+import { z } from 'zod';
+import { mcpJsonSchemaToZod, mcpToolResultToToolResult, mcpToolToToolDefinition, toolDefinitionToMCPTool, toolResultToMCPToolResult, zodToMCPJsonSchema, } from './adapter.js';
+function mockClient(result) {
+    return {
+        callTool: vi.fn(async () => result),
+    };
+}
+describe('mcpJsonSchemaToZod', () => {
+    it('empty schema → passthrough empty object', () => {
+        const schema = mcpJsonSchemaToZod({ type: 'object' });
+        expect(() => schema.parse({ extra: 'x' })).not.toThrow();
+    });
+    it('maps primitive types', () => {
+        const schema = mcpJsonSchemaToZod({
+            type: 'object',
+            required: ['s', 'n', 'b', 'arr', 'obj'],
+            properties: {
+                s: { type: 'string' },
+                n: { type: 'number' },
+                b: { type: 'boolean' },
+                arr: { type: 'array' },
+                obj: { type: 'object' },
+            },
+        });
+        expect(() => schema.parse({ s: 'x', n: 1, b: true, arr: [], obj: {} })).not.toThrow();
+        expect(() => schema.parse({ s: 123, n: 1, b: true, arr: [], obj: {} })).toThrow();
+    });
+    it('optional fields are not required', () => {
+        const schema = mcpJsonSchemaToZod({
+            type: 'object',
+            required: ['a'],
+            properties: {
+                a: { type: 'string' },
+                b: { type: 'string' },
+            },
+        });
+        expect(() => schema.parse({ a: 'x' })).not.toThrow();
+    });
+    it('unknown property types map to z.unknown (pass any value)', () => {
+        const schema = mcpJsonSchemaToZod({
+            type: 'object',
+            required: ['x'],
+            properties: { x: { type: 'weird' } },
+        });
+        expect(() => schema.parse({ x: { nested: [1, 2] } })).not.toThrow();
+    });
+});
+describe('zodToMCPJsonSchema', () => {
+    it('wraps zod schema with type: object', () => {
+        const out = zodToMCPJsonSchema(z.object({ a: z.string() }));
+        expect(out.type).toBe('object');
+    });
+});
+describe('mcpToolToToolDefinition', () => {
+    it('prefixes name + description with the server handle', () => {
+        const tool = mcpToolToToolDefinition({
+            name: 'search',
+            description: 'search docs',
+            inputSchema: { type: 'object' },
+        }, mockClient({ content: [{ type: 'text', text: 'ok' }], isError: false }), 'serverA');
+        expect(tool.name).toBe('mcp_serverA_search');
+        expect(tool.description).toBe('[MCP:serverA] search docs');
+        expect(tool.category).toBe('network');
+    });
+    it('uses tool.name as description fallback when no description', () => {
+        const tool = mcpToolToToolDefinition({ name: 'search', inputSchema: { type: 'object' } }, mockClient({ content: [{ type: 'text', text: 'ok' }], isError: false }), 'serverA');
+        expect(tool.description).toBe('[MCP:serverA] search');
+    });
+    it('reflects MCP annotations into tool flags', () => {
+        const tool = mcpToolToToolDefinition({
+            name: 't',
+            inputSchema: { type: 'object' },
+            annotations: { readOnlyHint: true, destructiveHint: true },
+        }, mockClient({ content: [], isError: false }), 's');
+        expect(tool.isReadOnly?.({})).toBe(true);
+        expect(tool.isDestructive?.({})).toBe(true);
+        expect(tool.isConcurrencySafe?.({})).toBe(true);
+    });
+    it('default flags when annotations are absent', () => {
+        const tool = mcpToolToToolDefinition({ name: 't', inputSchema: { type: 'object' } }, mockClient({ content: [], isError: false }), 's');
+        expect(tool.isReadOnly?.({})).toBe(false);
+        expect(tool.isDestructive?.({})).toBe(false);
+    });
+    it('execute calls client.callTool(tool.name, input) and adapts result', async () => {
+        const client = mockClient({
+            content: [{ type: 'text', text: 'hello' }],
+            isError: false,
+        });
+        const tool = mcpToolToToolDefinition({ name: 'search', inputSchema: { type: 'object' } }, client, 's');
+        const result = await tool.execute({ q: 'hi' }, {});
+        expect(client.callTool).toHaveBeenCalledWith('search', { q: 'hi' });
+        expect(result.success).toBe(true);
+        expect(result.output).toBe('hello');
+    });
+});
+describe('toolDefinitionToMCPTool', () => {
+    it('projects name / description / inputSchema / annotations', () => {
+        const tool = {
+            name: 't',
+            description: 'd',
+            inputSchema: z.object({ a: z.string() }),
+            async execute() {
+                return { success: true, output: '' };
+            },
+            isReadOnly: () => true,
+            isDestructive: () => false,
+        };
+        const out = toolDefinitionToMCPTool(tool);
+        expect(out.name).toBe('t');
+        expect(out.description).toBe('d');
+        expect(out.inputSchema.type).toBe('object');
+        expect(out.annotations).toEqual({ readOnlyHint: true, destructiveHint: false });
+    });
+});
+describe('mcpToolResultToToolResult', () => {
+    it('joins text blocks with \\n for output', () => {
+        const result = mcpToolResultToToolResult({
+            content: [
+                { type: 'text', text: 'line 1' },
+                { type: 'text', text: 'line 2' },
+            ],
+            isError: false,
+        });
+        expect(result.output).toBe('line 1\nline 2');
+        expect(result.success).toBe(true);
+    });
+    it('filters out non-text blocks from output but keeps them in data', () => {
+        const result = mcpToolResultToToolResult({
+            content: [
+                { type: 'text', text: 'text' },
+                { type: 'image', data: 'b64', mimeType: 'image/png' },
+            ],
+            isError: false,
+        });
+        expect(result.output).toBe('text');
+        expect(Array.isArray(result.data)).toBe(true);
+    });
+    it('sets error field when isError is true', () => {
+        const result = mcpToolResultToToolResult({
+            content: [{ type: 'text', text: 'boom' }],
+            isError: true,
+        });
+        expect(result.success).toBe(false);
+        expect(result.error).toBe('boom');
+    });
+});
+describe('toolResultToMCPToolResult', () => {
+    it('success + output → single text block', () => {
+        const result = { success: true, output: 'ok' };
+        const out = toolResultToMCPToolResult(result);
+        expect(out.content).toEqual([{ type: 'text', text: 'ok' }]);
+        expect(out.isError).toBe(false);
+    });
+    it('failure + error → text block + isError', () => {
+        const result = { success: false, output: '', error: 'boom' };
+        const out = toolResultToMCPToolResult(result);
+        expect(out.content.some((b) => b.type === 'text' && b.text === 'boom')).toBe(true);
+        expect(out.isError).toBe(true);
+    });
+    it('success with empty output → one empty-text block', () => {
+        const result = { success: true, output: '' };
+        const out = toolResultToMCPToolResult(result);
+        expect(out.content).toEqual([{ type: 'text', text: '' }]);
+    });
+});
+//# sourceMappingURL=adapter.test.js.map

package/dist/connector/mcp/adapter.test.js.map

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

package/dist/probe/context.d.ts

@@ -0,0 +1,8 @@
+import type { RunId } from '../types/ids/index.js';
+import type { ProbeContext } from '../types/probe/index.js';
+export interface ProbeContextInput {
+    readonly runId?: RunId;
+    readonly isReplay?: boolean;
+}
+export declare function buildProbeContext(input?: ProbeContextInput): ProbeContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/probe/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/probe/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAE3D,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED,wBAAgB,iBAAiB,CAAC,KAAK,GAAE,iBAAsB,GAAG,YAAY,CAK7E"}

package/dist/probe/context.js

@@ -0,0 +1,7 @@
+export function buildProbeContext(input = {}) {
+    return Object.freeze({
+        runId: input.runId,
+        isReplay: input.isReplay ?? false,
+    });
+}
+//# sourceMappingURL=context.js.map

package/dist/probe/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/probe/context.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,iBAAiB,CAAC,QAA2B,EAAE;IAC9D,OAAO,MAAM,CAAC,MAAM,CAAC;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,KAAK;KACjC,CAAC,CAAA;AACH,CAAC"}

package/dist/probe/errors.d.ts

@@ -0,0 +1,12 @@
+import type { VetoableEventKind } from '../types/probe/index.js';
+export declare class ProbeNameCollisionError extends Error {
+    readonly probeName: string;
+    constructor(probeName: string);
+}
+export declare class ProbeVetoError extends Error {
+    readonly probeName: string;
+    readonly reason: string;
+    readonly eventKind: VetoableEventKind;
+    constructor(probeName: string, reason: string, eventKind: VetoableEventKind);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/probe/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/probe/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAEhE,qBAAa,uBAAwB,SAAQ,KAAK;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;gBAEd,SAAS,EAAE,MAAM;CAO7B;AAED,qBAAa,cAAe,SAAQ,KAAK;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAA;gBAEzB,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB;CAO3E"}

package/dist/probe/errors.js

@@ -0,0 +1,21 @@
+export class ProbeNameCollisionError extends Error {
+    probeName;
+    constructor(probeName) {
+        super(`Probe name "${probeName}" is already registered. Pass { override: true } to replace, or pick a different name.`);
+        this.name = 'ProbeNameCollisionError';
+        this.probeName = probeName;
+    }
+}
+export class ProbeVetoError extends Error {
+    probeName;
+    reason;
+    eventKind;
+    constructor(probeName, reason, eventKind) {
+        super(`Operation denied by probe "${probeName}" on ${eventKind}: ${reason}`);
+        this.name = 'ProbeVetoError';
+        this.probeName = probeName;
+        this.reason = reason;
+        this.eventKind = eventKind;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/probe/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/probe/errors.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACxC,SAAS,CAAQ;IAE1B,YAAY,SAAiB;QAC5B,KAAK,CACJ,eAAe,SAAS,wFAAwF,CAChH,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAA;QACrC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;IAC3B,CAAC;CACD;AAED,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC/B,SAAS,CAAQ;IACjB,MAAM,CAAQ;IACd,SAAS,CAAmB;IAErC,YAAY,SAAiB,EAAE,MAAc,EAAE,SAA4B;QAC1E,KAAK,CAAC,8BAA8B,SAAS,QAAQ,SAAS,KAAK,MAAM,EAAE,CAAC,CAAA;QAC5E,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;QAC5B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;IAC3B,CAAC;CACD"}

package/dist/probe/index.d.ts

@@ -0,0 +1,5 @@
+export { ProbeNameCollisionError, ProbeVetoError } from './errors.js';
+export { buildProbeContext } from './context.js';
+export type { ProbeContextInput } from './context.js';
+export { ProbeRegistry, createProbeRegistry, probe } from './registry.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/probe/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAChD,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA"}

package/dist/probe/index.js

@@ -0,0 +1,4 @@
+export { ProbeNameCollisionError, ProbeVetoError } from './errors.js';
+export { buildProbeContext } from './context.js';
+export { ProbeRegistry, createProbeRegistry, probe } from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/probe/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/probe/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAEhD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA"}

package/dist/probe/registry.d.ts

@@ -0,0 +1,24 @@
+import type { ProbeContext, ProbeEvent, ProbeEventKind, ProbeEventOf, ProbeHandler, ProbeOptions, Unsubscribe, VetoHandler, VetoOutcome, VetoableEventKind } from '../types/probe/index.js';
+import type { Logger } from '../utils/logger.js';
+export declare class ProbeRegistry {
+    private readonly typedByKind;
+    private readonly vetoByKind;
+    private readonly catchAll;
+    private readonly byName;
+    private nextId;
+    private log?;
+    setLogger(log: Logger): void;
+    on<K extends ProbeEventKind>(kind: K | readonly K[], handler: ProbeHandler<K>, opts?: ProbeOptions<K>): Unsubscribe;
+    onAny(handler: (event: ProbeEvent, ctx: ProbeContext) => void, opts?: ProbeOptions): Unsubscribe;
+    dispatch(event: ProbeEvent, ctx: ProbeContext, betweenTier?: () => void): void;
+    veto<K extends VetoableEventKind>(kind: K, handler: VetoHandler<K>, opts?: ProbeOptions<K>): Unsubscribe;
+    queryVeto<K extends VetoableEventKind>(event: ProbeEventOf<K>, ctx: ProbeContext): VetoOutcome;
+    clear(): void;
+    private runTier;
+    private makeEntry;
+    private removeAnywhere;
+    private logThrow;
+}
+export declare const probe: ProbeRegistry;
+export declare function createProbeRegistry(): ProbeRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/probe/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/probe/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,YAAY,EACZ,UAAU,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,EAEX,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAoEhD,qBAAa,aAAa;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+C;IAC3E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiD;IAC5E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiD;IACxE,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,GAAG,CAAC,CAAQ;IAEpB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI5B,EAAE,CAAC,CAAC,SAAS,cAAc,EAC1B,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC,EAAE,EACtB,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EACxB,IAAI,GAAE,YAAY,CAAC,CAAC,CAAM,GACxB,WAAW;IAyBd,KAAK,CACJ,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,YAAY,KAAK,IAAI,EACvD,IAAI,GAAE,YAAiB,GACrB,WAAW;IASd,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,YAAY,EAAE,WAAW,CAAC,EAAE,MAAM,IAAI,GAAG,IAAI;IAa9E,IAAI,CAAC,CAAC,SAAS,iBAAiB,EAC/B,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,EACvB,IAAI,GAAE,YAAY,CAAC,CAAC,CAAM,GACxB,WAAW;IAgCd,SAAS,CAAC,CAAC,SAAS,iBAAiB,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,YAAY,GAAG,WAAW;IA6B9F,KAAK,IAAI,IAAI;IAOb,OAAO,CAAC,OAAO;IAWf,OAAO,CAAC,SAAS;IAwBjB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,QAAQ;CAQhB;AAED,eAAO,MAAM,KAAK,EAAE,aAAmC,CAAA;AAEvD,wBAAgB,mBAAmB,IAAI,aAAa,CAEnD"}

package/dist/probe/registry.js

@@ -0,0 +1,228 @@
+import { ProbeNameCollisionError } from './errors.js';
+function compareVeto(a, b) {
+    if (a.priority !== b.priority)
+        return a.priority - b.priority;
+    return a.id - b.id;
+}
+function insertSortedVeto(list, entry) {
+    let lo = 0;
+    let hi = list.length;
+    while (lo < hi) {
+        const mid = (lo + hi) >>> 1;
+        if (compareVeto(list[mid], entry) <= 0)
+            lo = mid + 1;
+        else
+            hi = mid;
+    }
+    list.splice(lo, 0, entry);
+}
+function removeVeto(list, entry) {
+    const idx = list.indexOf(entry);
+    if (idx >= 0)
+        list.splice(idx, 1);
+}
+function normalizeDecision(decision) {
+    if (decision === 'allow')
+        return { allow: true };
+    if (decision === 'deny')
+        return { allow: false };
+    return { allow: false, reason: decision.reason };
+}
+function compareEntries(a, b) {
+    if (a.priority !== b.priority)
+        return a.priority - b.priority;
+    return a.id - b.id;
+}
+function insertSorted(list, entry) {
+    let lo = 0;
+    let hi = list.length;
+    while (lo < hi) {
+        const mid = (lo + hi) >>> 1;
+        if (compareEntries(list[mid], entry) <= 0)
+            lo = mid + 1;
+        else
+            hi = mid;
+    }
+    list.splice(lo, 0, entry);
+}
+function removeEntry(list, entry) {
+    const idx = list.indexOf(entry);
+    if (idx >= 0)
+        list.splice(idx, 1);
+}
+export class ProbeRegistry {
+    typedByKind = new Map();
+    vetoByKind = new Map();
+    catchAll = [];
+    byName = new Map();
+    nextId = 1;
+    log;
+    setLogger(log) {
+        this.log = log.child({ component: 'ProbeRegistry' });
+    }
+    on(kind, handler, opts = {}) {
+        const kinds = Array.isArray(kind) ? kind : [kind];
+        const entry = this.makeEntry(handler, opts);
+        for (const k of kinds) {
+            let bucket = this.typedByKind.get(k);
+            if (!bucket) {
+                bucket = [];
+                this.typedByKind.set(k, bucket);
+            }
+            insertSorted(bucket, entry);
+        }
+        return () => {
+            for (const k of kinds) {
+                const bucket = this.typedByKind.get(k);
+                if (bucket)
+                    removeEntry(bucket, entry);
+            }
+            if (entry.name)
+                this.byName.delete(entry.name);
+        };
+    }
+    onAny(handler, opts = {}) {
+        const entry = this.makeEntry(handler, opts);
+        insertSorted(this.catchAll, entry);
+        return () => {
+            removeEntry(this.catchAll, entry);
+            if (entry.name)
+                this.byName.delete(entry.name);
+        };
+    }
+    dispatch(event, ctx, betweenTier) {
+        const frozen = Object.isFrozen(event) ? event : Object.freeze(event);
+        this.runTier(this.typedByKind.get(frozen.type) ?? [], frozen, ctx);
+        if (betweenTier) {
+            try {
+                betweenTier();
+            }
+            catch (error) {
+                this.logThrow('between-tier', frozen.type, error);
+            }
+        }
+        this.runTier(this.catchAll, frozen, ctx);
+    }
+    veto(kind, handler, opts = {}) {
+        if (opts.name !== undefined) {
+            const existing = this.byName.get(opts.name);
+            if (existing && !opts.override) {
+                throw new ProbeNameCollisionError(opts.name);
+            }
+            if (existing && opts.override)
+                this.removeAnywhere(existing);
+        }
+        const entry = {
+            id: this.nextId++,
+            name: opts.name,
+            priority: opts.priority ?? 0,
+            handler: handler,
+            where: opts.where,
+        };
+        let bucket = this.vetoByKind.get(kind);
+        if (!bucket) {
+            bucket = [];
+            this.vetoByKind.set(kind, bucket);
+        }
+        insertSortedVeto(bucket, entry);
+        if (entry.name)
+            this.byName.set(entry.name, entry);
+        return () => {
+            const list = this.vetoByKind.get(kind);
+            if (list)
+                removeVeto(list, entry);
+            if (entry.name)
+                this.byName.delete(entry.name);
+        };
+    }
+    queryVeto(event, ctx) {
+        const wide = event;
+        const frozen = Object.isFrozen(wide) ? wide : Object.freeze(wide);
+        const bucket = this.vetoByKind.get(frozen.type);
+        if (!bucket || bucket.length === 0)
+            return { action: 'allow' };
+        let firstDeny;
+        for (const entry of bucket) {
+            if (entry.where && !entry.where(frozen))
+                continue;
+            let decision;
+            try {
+                decision = entry.handler(frozen, ctx);
+            }
+            catch (error) {
+                this.logThrow(entry.name ?? 'unnamed', frozen.type, error);
+                continue;
+            }
+            const normalized = normalizeDecision(decision);
+            if (!normalized.allow && firstDeny === undefined) {
+                firstDeny = {
+                    action: 'deny',
+                    probeName: entry.name,
+                    reason: normalized.reason,
+                };
+            }
+        }
+        return firstDeny ?? { action: 'allow' };
+    }
+    clear() {
+        this.typedByKind.clear();
+        this.vetoByKind.clear();
+        this.catchAll.length = 0;
+        this.byName.clear();
+    }
+    runTier(entries, event, ctx) {
+        for (const entry of entries) {
+            if (entry.where && !entry.where(event))
+                continue;
+            try {
+                entry.handler(event, ctx);
+            }
+            catch (error) {
+                this.logThrow(entry.name ?? 'unnamed', event.type, error);
+            }
+        }
+    }
+    makeEntry(handler, opts) {
+        if (opts.name !== undefined) {
+            const existing = this.byName.get(opts.name);
+            if (existing && !opts.override) {
+                throw new ProbeNameCollisionError(opts.name);
+            }
+            if (existing && opts.override)
+                this.removeAnywhere(existing);
+        }
+        const entry = {
+            id: this.nextId++,
+            name: opts.name,
+            priority: opts.priority ?? 0,
+            handler,
+            where: opts.where,
+        };
+        if (entry.name)
+            this.byName.set(entry.name, entry);
+        return entry;
+    }
+    removeAnywhere(entry) {
+        for (const bucket of this.typedByKind.values())
+            removeEntry(bucket, entry);
+        removeEntry(this.catchAll, entry);
+        for (const bucket of this.vetoByKind.values())
+            removeVeto(bucket, entry);
+        if (entry.name)
+            this.byName.delete(entry.name);
+    }
+    logThrow(probeName, eventType, error) {
+        if (!this.log)
+            return;
+        this.log.error('probe handler threw', {
+            probeName,
+            eventType,
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+export const probe = new ProbeRegistry();
+export function createProbeRegistry() {
+    return new ProbeRegistry();
+}
+//# sourceMappingURL=registry.js.map

package/dist/probe/registry.js.map

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

package/dist/probe/registry.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 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.
+ */
+export {};
+//# sourceMappingURL=registry.test.d.ts.map

package/dist/probe/registry.test.d.ts.map

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