@namzu/sdk 0.4.2 → 0.4.3

package/dist/bridge/a2a/message.test.js

@@ -0,0 +1,116 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 2):
+ *
+ *   - `messageToA2A(msg)` role mapping: user → user; assistant / system /
+ *     tool → agent. Any other MessageRole triggers the exhaustive-check
+ *     throw (unreachable via types).
+ *   - Non-empty `content` produces one text part.
+ *   - Assistant with `toolCalls`: one data part per tool call with
+ *     mimeType `application/x-namzu-tool-call` and fields
+ *     `{toolCallId, name, arguments}`.
+ *   - If the message would produce zero parts (null content, no tool
+ *     calls), a fallback empty-text part is added.
+ *   - `extractTextFromA2AMessage(msg)` joins text parts with '\n' and
+ *     ignores non-text parts entirely.
+ *   - `a2aMessageToInput` is a pure alias for `extractTextFromA2AMessage`.
+ *   - Only SDK → A2A direction is covered (design.md §2.7: no reverse
+ *     mapper exists).
+ */
+import { describe, expect, it } from 'vitest';
+import { a2aMessageToInput, extractTextFromA2AMessage, messageToA2A } from './message.js';
+describe('messageToA2A', () => {
+    it('maps user role to user', () => {
+        const msg = { role: 'user', content: 'hi' };
+        expect(messageToA2A(msg).role).toBe('user');
+    });
+    it.each([['system'], ['assistant'], ['tool']])('maps %s role to agent', (role) => {
+        const msg = { role, content: 'x', ...(role === 'tool' && { toolCallId: 'c' }) };
+        expect(messageToA2A(msg).role).toBe('agent');
+    });
+    it('emits a single text part for content-only messages', () => {
+        const msg = { role: 'user', content: 'hello' };
+        const a2a = messageToA2A(msg);
+        expect(a2a.parts).toEqual([{ kind: 'text', text: 'hello' }]);
+    });
+    it('emits text + data parts when the assistant has tool calls', () => {
+        const msg = {
+            role: 'assistant',
+            content: 'let me check',
+            toolCalls: [
+                { id: 'tc1', type: 'function', function: { name: 'read_file', arguments: '{"p":"/a"}' } },
+                { id: 'tc2', type: 'function', function: { name: 'list_dir', arguments: '{}' } },
+            ],
+        };
+        const a2a = messageToA2A(msg);
+        expect(a2a.parts).toEqual([
+            { kind: 'text', text: 'let me check' },
+            {
+                kind: 'data',
+                data: { toolCallId: 'tc1', name: 'read_file', arguments: '{"p":"/a"}' },
+                mimeType: 'application/x-namzu-tool-call',
+            },
+            {
+                kind: 'data',
+                data: { toolCallId: 'tc2', name: 'list_dir', arguments: '{}' },
+                mimeType: 'application/x-namzu-tool-call',
+            },
+        ]);
+    });
+    it('emits ONLY data parts (no text part) when content is null and tool calls exist', () => {
+        const msg = {
+            role: 'assistant',
+            content: null,
+            toolCalls: [{ id: 'tc1', type: 'function', function: { name: 'x', arguments: '{}' } }],
+        };
+        const a2a = messageToA2A(msg);
+        expect(a2a.parts.some((p) => p.kind === 'text')).toBe(false);
+        expect(a2a.parts.some((p) => p.kind === 'data')).toBe(true);
+    });
+    it('fallbacks to an empty text part when content is null and no tool calls', () => {
+        const msg = { role: 'assistant', content: null };
+        expect(messageToA2A(msg).parts).toEqual([{ kind: 'text', text: '' }]);
+    });
+});
+describe('extractTextFromA2AMessage', () => {
+    it('joins every text part with a newline', () => {
+        const msg = {
+            role: 'user',
+            parts: [
+                { kind: 'text', text: 'line 1' },
+                { kind: 'text', text: 'line 2' },
+            ],
+        };
+        expect(extractTextFromA2AMessage(msg)).toBe('line 1\nline 2');
+    });
+    it('ignores non-text parts', () => {
+        const msg = {
+            role: 'agent',
+            parts: [
+                { kind: 'text', text: 'hello' },
+                { kind: 'data', data: { foo: 1 }, mimeType: 'application/json' },
+            ],
+        };
+        expect(extractTextFromA2AMessage(msg)).toBe('hello');
+    });
+    it('returns empty string when there are no text parts', () => {
+        const msg = {
+            role: 'agent',
+            parts: [{ kind: 'data', data: {}, mimeType: 'x' }],
+        };
+        expect(extractTextFromA2AMessage(msg)).toBe('');
+    });
+});
+describe('a2aMessageToInput', () => {
+    it('behaves identically to extractTextFromA2AMessage', () => {
+        const msg = {
+            role: 'user',
+            parts: [
+                { kind: 'text', text: 'a' },
+                { kind: 'text', text: 'b' },
+                { kind: 'data', data: {}, mimeType: 'x' },
+            ],
+        };
+        expect(a2aMessageToInput(msg)).toBe(extractTextFromA2AMessage(msg));
+    });
+});
+//# sourceMappingURL=message.test.js.map

package/dist/bridge/a2a/message.test.js.map

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

package/dist/bridge/a2a/task.test.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 2):
+ *
+ *   - `isTerminalState(state)` returns true iff state ∈ {completed,
+ *     failed, canceled, rejected}.
+ *   - `runStatusToA2AState(status)` is a table lookup:
+ *     queued → pending; running → running; completed → completed;
+ *     failed → failed; cancelled → canceled; cancelling → running;
+ *     expired → failed.
+ *   - `runToA2ATask(run, messages?)`:
+ *     - `id` comes from `run.id`; `contextId` comes from
+ *       `run.project_id ?? undefined`.
+ *     - `status.timestamp` picks the first defined of
+ *       `completed_at`, `started_at`, `created_at` (in that order).
+ *     - `status.message` is agent-text of `run.result` if present,
+ *       else of `run.last_error` if present, else undefined.
+ *     - `artifacts` is present iff `run.result` is present; the single
+ *       artifact carries a subset of usage + timing metadata.
+ *     - `history` is mapped through `messageToA2A` only when `messages`
+ *       is supplied.
+ *     - Top-level `metadata` carries agent_id, agent_name, stop_reason
+ *       (even if undefined).
+ *   - `a2aMessageToCreateRun(agentId, params)` only sets a metadata
+ *     field on `config` when the source value has the expected type
+ *     (string for model/systemPrompt; number for numeric fields;
+ *     'plan' | 'auto' for permissionMode). Everything else is omitted.
+ */
+export {};
+//# sourceMappingURL=task.test.d.ts.map

package/dist/bridge/a2a/task.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.test.d.ts","sourceRoot":"","sources":["../../../src/bridge/a2a/task.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG"}

package/dist/bridge/a2a/task.test.js

@@ -0,0 +1,198 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 2):
+ *
+ *   - `isTerminalState(state)` returns true iff state ∈ {completed,
+ *     failed, canceled, rejected}.
+ *   - `runStatusToA2AState(status)` is a table lookup:
+ *     queued → pending; running → running; completed → completed;
+ *     failed → failed; cancelled → canceled; cancelling → running;
+ *     expired → failed.
+ *   - `runToA2ATask(run, messages?)`:
+ *     - `id` comes from `run.id`; `contextId` comes from
+ *       `run.project_id ?? undefined`.
+ *     - `status.timestamp` picks the first defined of
+ *       `completed_at`, `started_at`, `created_at` (in that order).
+ *     - `status.message` is agent-text of `run.result` if present,
+ *       else of `run.last_error` if present, else undefined.
+ *     - `artifacts` is present iff `run.result` is present; the single
+ *       artifact carries a subset of usage + timing metadata.
+ *     - `history` is mapped through `messageToA2A` only when `messages`
+ *       is supplied.
+ *     - Top-level `metadata` carries agent_id, agent_name, stop_reason
+ *       (even if undefined).
+ *   - `a2aMessageToCreateRun(agentId, params)` only sets a metadata
+ *     field on `config` when the source value has the expected type
+ *     (string for model/systemPrompt; number for numeric fields;
+ *     'plan' | 'auto' for permissionMode). Everything else is omitted.
+ */
+import { describe, expect, it } from 'vitest';
+import { a2aMessageToCreateRun, isTerminalState, runStatusToA2AState, runToA2ATask, } from './task.js';
+const baseRun = {
+    id: 'run_1',
+    project_id: null,
+    agent_id: 'coder',
+    status: 'running',
+    created_at: '2026-04-21T12:00:00Z',
+    config: {},
+};
+describe('isTerminalState', () => {
+    const terminals = ['completed', 'failed', 'canceled', 'rejected'];
+    const nonTerminals = ['input-required', 'running', 'pending'];
+    it.each(terminals.map((s) => [s]))('%s is terminal', (state) => {
+        expect(isTerminalState(state)).toBe(true);
+    });
+    it.each(nonTerminals.map((s) => [s]))('%s is not terminal', (state) => {
+        expect(isTerminalState(state)).toBe(false);
+    });
+});
+describe('runStatusToA2AState', () => {
+    it.each([
+        ['queued', 'pending'],
+        ['running', 'running'],
+        ['completed', 'completed'],
+        ['failed', 'failed'],
+        ['cancelled', 'canceled'],
+        ['cancelling', 'running'],
+        ['expired', 'failed'],
+    ])('%s → %s', (wire, a2a) => {
+        expect(runStatusToA2AState(wire)).toBe(a2a);
+    });
+});
+describe('runToA2ATask', () => {
+    it('sets id + contextId from run.id + run.project_id', () => {
+        const task = runToA2ATask({ ...baseRun, project_id: 'proj_9' });
+        expect(task.id).toBe('run_1');
+        expect(task.contextId).toBe('proj_9');
+    });
+    it('contextId is undefined when project_id is null', () => {
+        const task = runToA2ATask(baseRun);
+        expect(task.contextId).toBeUndefined();
+    });
+    it('timestamp prefers completed_at > started_at > created_at', () => {
+        const created = '2026-04-21T10:00:00Z';
+        const started = '2026-04-21T10:05:00Z';
+        const completed = '2026-04-21T10:10:00Z';
+        expect(runToA2ATask({
+            ...baseRun,
+            created_at: created,
+            started_at: started,
+            completed_at: completed,
+        }).status.timestamp).toBe(completed);
+        expect(runToA2ATask({ ...baseRun, created_at: created, started_at: started }).status.timestamp).toBe(started);
+        expect(runToA2ATask({ ...baseRun, created_at: created }).status.timestamp).toBe(created);
+    });
+    it('status.message is the result text when result is present', () => {
+        const task = runToA2ATask({ ...baseRun, status: 'completed', result: 'all done' });
+        expect(task.status.message?.parts).toEqual([{ kind: 'text', text: 'all done' }]);
+        expect(task.status.message?.role).toBe('agent');
+    });
+    it('status.message falls back to last_error when result is absent', () => {
+        const task = runToA2ATask({ ...baseRun, status: 'failed', last_error: 'boom' });
+        expect(task.status.message?.parts).toEqual([{ kind: 'text', text: 'boom' }]);
+    });
+    it('status.message is undefined when neither result nor last_error is set', () => {
+        const task = runToA2ATask(baseRun);
+        expect(task.status.message).toBeUndefined();
+    });
+    it('attaches an artifact iff result is present', () => {
+        expect(runToA2ATask(baseRun).artifacts).toBeUndefined();
+        const withResult = runToA2ATask({
+            ...baseRun,
+            status: 'completed',
+            result: 'done',
+            model: 'claude-opus-4-7',
+            iterations: 3,
+            duration_ms: 1200,
+            usage: { input_tokens: 10, output_tokens: 20, total_tokens: 30, total_cost_usd: 0.05 },
+        });
+        expect(withResult.artifacts).toHaveLength(1);
+        const artifact = withResult.artifacts?.[0];
+        expect(artifact?.artifactId).toBe('run_1-result');
+        expect(artifact?.name).toBe('Agent Response');
+        expect(artifact?.parts).toEqual([{ kind: 'text', text: 'done' }]);
+        expect(artifact?.metadata).toMatchObject({
+            model: 'claude-opus-4-7',
+            iterations: 3,
+            duration_ms: 1200,
+            input_tokens: 10,
+            output_tokens: 20,
+            total_cost_usd: 0.05,
+        });
+    });
+    it('history is undefined when messages are not supplied', () => {
+        expect(runToA2ATask(baseRun).history).toBeUndefined();
+    });
+    it('history maps through messageToA2A for every message', () => {
+        const task = runToA2ATask(baseRun, [
+            { role: 'user', content: 'hi' },
+            { role: 'assistant', content: 'ack' },
+        ]);
+        expect(task.history).toHaveLength(2);
+        expect(task.history?.[0]?.role).toBe('user');
+        expect(task.history?.[1]?.role).toBe('agent');
+    });
+    it('top-level metadata carries agent_id + stop_reason', () => {
+        const task = runToA2ATask({ ...baseRun, agent_name: 'Coder', stop_reason: 'end_turn' });
+        expect(task.metadata).toMatchObject({
+            agent_id: 'coder',
+            agent_name: 'Coder',
+            stop_reason: 'end_turn',
+        });
+    });
+});
+describe('a2aMessageToCreateRun', () => {
+    const baseMsg = { role: 'user', parts: [{ kind: 'text', text: 'do a thing' }] };
+    it('extracts input text from the message', () => {
+        const params = { message: baseMsg };
+        const result = a2aMessageToCreateRun('agent_1', params);
+        expect(result.agentId).toBe('agent_1');
+        expect(result.input).toBe('do a thing');
+        expect(result.config).toEqual({});
+    });
+    it('threads contextId from params into projectId', () => {
+        const params = { message: baseMsg, contextId: 'proj_2' };
+        expect(a2aMessageToCreateRun('agent_1', params).projectId).toBe('proj_2');
+    });
+    it('only includes typed metadata fields in config', () => {
+        const params = {
+            message: baseMsg,
+            metadata: {
+                model: 'opus',
+                tokenBudget: 1000,
+                timeoutMs: 5000,
+                temperature: 0.2,
+                maxResponseTokens: 2048,
+                permissionMode: 'plan',
+                systemPrompt: 'be terse',
+            },
+        };
+        const config = a2aMessageToCreateRun('a', params).config;
+        expect(config).toEqual({
+            model: 'opus',
+            tokenBudget: 1000,
+            timeoutMs: 5000,
+            temperature: 0.2,
+            maxResponseTokens: 2048,
+            permissionMode: 'plan',
+            systemPrompt: 'be terse',
+        });
+    });
+    it('drops metadata fields with wrong types', () => {
+        const params = {
+            message: baseMsg,
+            metadata: {
+                model: 123, // wrong type → dropped
+                tokenBudget: 'big', // wrong type → dropped
+                permissionMode: 'invalid', // not 'plan'|'auto' → dropped
+            },
+        };
+        expect(a2aMessageToCreateRun('a', params).config).toEqual({});
+    });
+    it('accepts permissionMode only for "plan" or "auto"', () => {
+        for (const mode of ['plan', 'auto']) {
+            const params = { message: baseMsg, metadata: { permissionMode: mode } };
+            expect(a2aMessageToCreateRun('a', params).config.permissionMode).toBe(mode);
+        }
+    });
+});
+//# sourceMappingURL=task.test.js.map

package/dist/bridge/a2a/task.test.js.map

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

package/dist/bridge/mcp/connector/adapter.test.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 2):
+ *
+ *   - `MCPConnectorBridge` wraps a `ConnectorManager` and exposes
+ *     connector methods as MCP tools with a name pattern
+ *     `<prefix>_<connectorId>_<methodName>`; prefix defaults to 'namzu'.
+ *   - `listTools()` with no instanceId iterates
+ *     `manager.listConnectedInstances()`; `listTools(instanceId)` uses
+ *     `manager.getInstance(instanceId)` and filters Boolean (missing
+ *     instance → empty output).
+ *   - `listTools()` rebuilds `mappings` from scratch on each call.
+ *   - Schema conversion via `zodToJsonSchema` is best-effort; on
+ *     conversion failure the schema falls back to `{type: 'object'}`.
+ *   - `getMappings()` returns a COPY (mutation of the returned array
+ *     does not affect internal state).
+ *   - `callTool(name, args)`:
+ *     - Returns `{content: [text], isError: true}` for unknown tools.
+ *     - On manager success, returns `{content: [text], isError: false}`
+ *       with the output stringified if non-string.
+ *     - On manager failure, returns `{content: [text with error],
+ *       isError: true}`; falls back to 'Unknown error' when the
+ *       manager error is undefined.
+ *   - Method descriptions include the connector DEFINITION name
+ *     bracketed (not the instance name): `[<def.name>] <method.description>`.
+ */
+export {};
+//# sourceMappingURL=adapter.test.d.ts.map

package/dist/bridge/mcp/connector/adapter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.test.d.ts","sourceRoot":"","sources":["../../../../src/bridge/mcp/connector/adapter.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG"}

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

@@ -0,0 +1,203 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 2):
+ *
+ *   - `MCPConnectorBridge` wraps a `ConnectorManager` and exposes
+ *     connector methods as MCP tools with a name pattern
+ *     `<prefix>_<connectorId>_<methodName>`; prefix defaults to 'namzu'.
+ *   - `listTools()` with no instanceId iterates
+ *     `manager.listConnectedInstances()`; `listTools(instanceId)` uses
+ *     `manager.getInstance(instanceId)` and filters Boolean (missing
+ *     instance → empty output).
+ *   - `listTools()` rebuilds `mappings` from scratch on each call.
+ *   - Schema conversion via `zodToJsonSchema` is best-effort; on
+ *     conversion failure the schema falls back to `{type: 'object'}`.
+ *   - `getMappings()` returns a COPY (mutation of the returned array
+ *     does not affect internal state).
+ *   - `callTool(name, args)`:
+ *     - Returns `{content: [text], isError: true}` for unknown tools.
+ *     - On manager success, returns `{content: [text], isError: false}`
+ *       with the output stringified if non-string.
+ *     - On manager failure, returns `{content: [text with error],
+ *       isError: true}`; falls back to 'Unknown error' when the
+ *       manager error is undefined.
+ *   - Method descriptions include the connector DEFINITION name
+ *     bracketed (not the instance name): `[<def.name>] <method.description>`.
+ */
+import { describe, expect, it, vi } from 'vitest';
+import { z } from 'zod';
+import { MCPConnectorBridge } from './adapter.js';
+const CID = 'conn_http';
+const IID = 'ci_abc';
+function makeDefinition(overrides = {}) {
+    return {
+        id: CID,
+        name: 'HTTP',
+        description: 'HTTP connector',
+        connectionType: 'http',
+        configSchema: z.object({}),
+        methods: [
+            {
+                name: 'request',
+                description: 'make http request',
+                inputSchema: z.object({ url: z.string() }),
+            },
+        ],
+        ...overrides,
+    };
+}
+function makeInstance() {
+    return {
+        id: IID,
+        connectorId: CID,
+        config: { connectorId: CID, name: 'svc' },
+        status: 'connected',
+        createdAt: Date.now(),
+    };
+}
+function makeManager(overrides = {}) {
+    const def = makeDefinition();
+    const registry = {
+        get: vi.fn(() => def),
+    };
+    const instance = makeInstance();
+    return {
+        getInstance: vi.fn(() => instance),
+        getRegistry: vi.fn(() => registry),
+        listConnectedInstances: vi.fn(() => [instance]),
+        execute: vi.fn(),
+        ...overrides,
+    };
+}
+describe('MCPConnectorBridge.listTools', () => {
+    it('builds one MCP tool per method per connected instance with default prefix namzu', () => {
+        const bridge = new MCPConnectorBridge({ manager: makeManager() });
+        const tools = bridge.listTools();
+        expect(tools).toHaveLength(1);
+        expect(tools[0]?.name).toBe(`namzu_${CID}_request`);
+        expect(tools[0]?.description).toBe('[HTTP] make http request');
+    });
+    it('honors a custom prefix', () => {
+        const bridge = new MCPConnectorBridge({ manager: makeManager(), prefix: 'acme' });
+        expect(bridge.listTools()[0]?.name).toBe(`acme_${CID}_request`);
+    });
+    it('single-instance lookup via listTools(instanceId) uses getInstance; missing instance → empty', () => {
+        const manager = makeManager({
+            getInstance: vi.fn(() => undefined),
+        });
+        const bridge = new MCPConnectorBridge({ manager });
+        expect(bridge.listTools(IID)).toEqual([]);
+    });
+    it('mappings are rebuilt on every listTools() call (not appended)', () => {
+        const bridge = new MCPConnectorBridge({ manager: makeManager() });
+        bridge.listTools();
+        bridge.listTools();
+        expect(bridge.getMappings()).toHaveLength(1);
+    });
+    it('skips instances whose connectorId is missing in the registry', () => {
+        const manager = makeManager({
+            getRegistry: vi.fn(() => ({ get: vi.fn(() => undefined) })),
+        });
+        const bridge = new MCPConnectorBridge({ manager });
+        expect(bridge.listTools()).toEqual([]);
+    });
+    it('getMappings returns a copy — external mutation does not leak', () => {
+        const bridge = new MCPConnectorBridge({ manager: makeManager() });
+        bridge.listTools();
+        const copy = bridge.getMappings();
+        copy.length = 0;
+        expect(bridge.getMappings()).toHaveLength(1);
+    });
+    it('schema conversion falls back to {type: object} when zodToJsonSchema throws', () => {
+        const bad = makeDefinition({
+            methods: [
+                {
+                    name: 'broken',
+                    description: 'd',
+                    // Not a real zod type — intentionally misleads zodToJsonSchema.
+                    inputSchema: null,
+                },
+            ],
+        });
+        const manager = makeManager({
+            getRegistry: vi.fn(() => ({ get: vi.fn(() => bad) })),
+        });
+        const bridge = new MCPConnectorBridge({ manager });
+        const tools = bridge.listTools();
+        expect(tools[0]?.inputSchema).toEqual({ type: 'object' });
+    });
+});
+describe('MCPConnectorBridge.callTool', () => {
+    it('unknown tool → isError true + explanatory text', async () => {
+        const bridge = new MCPConnectorBridge({ manager: makeManager() });
+        const result = await bridge.callTool('nope');
+        expect(result.isError).toBe(true);
+        expect(result.content[0]).toMatchObject({ type: 'text', text: expect.stringContaining('nope') });
+    });
+    it('happy path — string output passes through as text', async () => {
+        const manager = makeManager();
+        vi.mocked(manager.execute).mockResolvedValueOnce({
+            success: true,
+            output: 'hello',
+            durationMs: 5,
+        });
+        const bridge = new MCPConnectorBridge({ manager });
+        bridge.listTools();
+        const result = await bridge.callTool(`namzu_${CID}_request`, { url: 'x' });
+        expect(result.isError).toBe(false);
+        expect(result.content[0]).toEqual({ type: 'text', text: 'hello' });
+    });
+    it('non-string success output is JSON-stringified', async () => {
+        const manager = makeManager();
+        vi.mocked(manager.execute).mockResolvedValueOnce({
+            success: true,
+            output: { status: 200 },
+            durationMs: 1,
+        });
+        const bridge = new MCPConnectorBridge({ manager });
+        bridge.listTools();
+        const result = await bridge.callTool(`namzu_${CID}_request`);
+        expect(result.content[0]).toEqual({
+            type: 'text',
+            text: JSON.stringify({ status: 200 }, null, 2),
+        });
+    });
+    it('manager failure → isError true with error text; falls back to "Unknown error" when error is undefined', async () => {
+        const manager = makeManager();
+        vi.mocked(manager.execute).mockResolvedValueOnce({
+            success: false,
+            output: undefined,
+            durationMs: 1,
+        });
+        const bridge = new MCPConnectorBridge({ manager });
+        bridge.listTools();
+        const result = await bridge.callTool(`namzu_${CID}_request`);
+        expect(result.isError).toBe(true);
+        expect(result.content[0]).toEqual({ type: 'text', text: 'Unknown error' });
+    });
+    it('carries the explicit error message when manager provides one', async () => {
+        const manager = makeManager();
+        vi.mocked(manager.execute).mockResolvedValueOnce({
+            success: false,
+            output: undefined,
+            durationMs: 1,
+            error: 'timeout',
+        });
+        const bridge = new MCPConnectorBridge({ manager });
+        bridge.listTools();
+        const result = await bridge.callTool(`namzu_${CID}_request`);
+        expect(result.content[0]).toEqual({ type: 'text', text: 'timeout' });
+    });
+    it('passes empty args through as {} when invoked without a second arg', async () => {
+        const manager = makeManager();
+        vi.mocked(manager.execute).mockResolvedValueOnce({
+            success: true,
+            output: 'ok',
+            durationMs: 1,
+        });
+        const bridge = new MCPConnectorBridge({ manager });
+        bridge.listTools();
+        await bridge.callTool(`namzu_${CID}_request`);
+        expect(manager.execute).toHaveBeenCalledWith(expect.objectContaining({ input: {} }));
+    });
+});
+//# sourceMappingURL=adapter.test.js.map

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

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

package/dist/bridge/sse/mapper.test.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 2):
+ *
+ *   - `mapRunToStreamEvent(event, runId)` returns `{wire, data}` or null.
+ *   - Wire names match a fixed mapping (one per RunEvent.type):
+ *     run.started, iteration.started, iteration.completed, message.delta,
+ *     tool.executing, tool.completed, review.requested, review.completed,
+ *     checkpoint.created, run.paused, run.resuming, token.usage,
+ *     activity.created, activity.updated, plan.ready, plan.approved,
+ *     plan.rejected, plan.step_updated, agent.pending, agent.completed,
+ *     agent.failed, agent.canceled, task.created, task.updated,
+ *     plugin.hook_executing, plugin.hook_completed, sandbox.created,
+ *     sandbox.exec, sandbox.destroyed.
+ *   - `run_completed` and `run_failed` produce null (final state is
+ *     delivered by the task.* path, not the SSE delta).
+ *   - Sub-session lifecycle events (spawned / messaged / idled) produce
+ *     null — the SSE wire surface does not carry them today.
+ *   - `data.run_id` is always set from the second arg.
+ *   - `llm_response` data: `content` falls back to null when empty;
+ *     `has_tool_calls` is a boolean.
+ *   - If the event carries `sourceAgentId` or `parentTaskId` fields,
+ *     they are mirrored onto `data.source_agent_id` / `data.parent_task_id`
+ *     (snake-cased).
+ *   - `mapSessionToStreamEvent` is a deprecated alias.
+ */
+export {};
+//# sourceMappingURL=mapper.test.d.ts.map

package/dist/bridge/sse/mapper.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.test.d.ts","sourceRoot":"","sources":["../../../src/bridge/sse/mapper.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG"}