@namzu/sdk 0.4.2 → 0.4.4

package/dist/bridge/sse/mapper.test.js

@@ -0,0 +1,271 @@
+/**
+ * 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.
+ */
+import { describe, expect, it } from 'vitest';
+import { mapRunToStreamEvent, mapSessionToStreamEvent } from './mapper.js';
+const RID = 'run_1';
+describe('mapRunToStreamEvent — mapped variants', () => {
+    it('run_started → run.started', () => {
+        const r = mapRunToStreamEvent({ type: 'run_started', runId: RID, systemPrompt: 'be terse' }, RID);
+        expect(r?.wire).toBe('run.started');
+        expect(r?.data).toMatchObject({ run_id: RID, system_prompt: 'be terse' });
+    });
+    it('run_started with no systemPrompt → system_prompt: null', () => {
+        const r = mapRunToStreamEvent({ type: 'run_started', runId: RID }, RID);
+        expect(r?.data).toMatchObject({ system_prompt: null });
+    });
+    it('iteration_started / iteration_completed carry iteration number', () => {
+        const a = mapRunToStreamEvent({ type: 'iteration_started', runId: RID, iteration: 2 }, RID);
+        expect(a).toEqual({ wire: 'iteration.started', data: { run_id: RID, iteration: 2 } });
+        const b = mapRunToStreamEvent({ type: 'iteration_completed', runId: RID, iteration: 2, hasToolCalls: false }, RID);
+        expect(b).toEqual({ wire: 'iteration.completed', data: { run_id: RID, iteration: 2 } });
+    });
+    it('llm_response → message.delta with content + has_tool_calls', () => {
+        const r = mapRunToStreamEvent({ type: 'llm_response', runId: RID, content: 'hi', hasToolCalls: false }, RID);
+        expect(r).toEqual({
+            wire: 'message.delta',
+            data: { run_id: RID, content: 'hi', has_tool_calls: false },
+        });
+    });
+    it('llm_response with null content → content: null', () => {
+        const r = mapRunToStreamEvent({ type: 'llm_response', runId: RID, content: null, hasToolCalls: true }, RID);
+        expect(r?.data).toMatchObject({ content: null, has_tool_calls: true });
+    });
+    it('tool_executing / tool_completed carry tool_name + input/result', () => {
+        const exec = mapRunToStreamEvent({ type: 'tool_executing', runId: RID, toolName: 'read_file', input: { path: '/a' } }, RID);
+        expect(exec?.wire).toBe('tool.executing');
+        expect(exec?.data).toMatchObject({ tool_name: 'read_file', input: { path: '/a' } });
+        const done = mapRunToStreamEvent({ type: 'tool_completed', runId: RID, toolName: 'read_file', result: 'ok' }, RID);
+        expect(done?.wire).toBe('tool.completed');
+        expect(done?.data).toMatchObject({ tool_name: 'read_file', result: 'ok' });
+    });
+    it('tool_review_requested / tool_review_completed carry review fields', () => {
+        const a = mapRunToStreamEvent({
+            type: 'tool_review_requested',
+            runId: RID,
+            iteration: 1,
+            toolCalls: [{ id: 'tc1', name: 'write_file', input: {}, isDestructive: true }],
+        }, RID);
+        expect(a?.wire).toBe('review.requested');
+        expect(a?.data.iteration).toBe(1);
+        const b = mapRunToStreamEvent({ type: 'tool_review_completed', runId: RID, decision: 'modified' }, RID);
+        expect(b).toEqual({ wire: 'review.completed', data: { run_id: RID, decision: 'modified' } });
+    });
+    it('checkpoint_created → checkpoint.created', () => {
+        const r = mapRunToStreamEvent({
+            type: 'checkpoint_created',
+            runId: RID,
+            checkpointId: 'ckpt_1',
+            iteration: 1,
+        }, RID);
+        expect(r?.wire).toBe('checkpoint.created');
+        expect(r?.data).toMatchObject({ checkpoint_id: 'ckpt_1', iteration: 1 });
+    });
+    it('run_paused / run_resuming carry checkpoint fields', () => {
+        const p = mapRunToStreamEvent({
+            type: 'run_paused',
+            runId: RID,
+            checkpointId: 'ckpt_2',
+            reason: 'input required',
+        }, RID);
+        expect(p?.wire).toBe('run.paused');
+        expect(p?.data).toMatchObject({ checkpoint_id: 'ckpt_2', reason: 'input required' });
+        const r = mapRunToStreamEvent({ type: 'run_resuming', runId: RID, fromCheckpointId: 'ckpt_2' }, RID);
+        expect(r).toEqual({
+            wire: 'run.resuming',
+            data: { run_id: RID, from_checkpoint_id: 'ckpt_2' },
+        });
+    });
+    it('plan_* events carry plan_id', () => {
+        const ready = mapRunToStreamEvent({
+            type: 'plan_ready',
+            runId: RID,
+            planId: 'plan_1',
+            title: 't',
+            summary: 's',
+            steps: [],
+        }, RID);
+        expect(ready?.wire).toBe('plan.ready');
+        expect(mapRunToStreamEvent({ type: 'plan_approved', runId: RID, planId: 'plan_1' }, RID)
+            ?.wire).toBe('plan.approved');
+        expect(mapRunToStreamEvent({ type: 'plan_rejected', runId: RID, planId: 'plan_1', reason: 'nope' }, RID)?.wire).toBe('plan.rejected');
+        expect(mapRunToStreamEvent({
+            type: 'plan_step_updated',
+            runId: RID,
+            planId: 'plan_1',
+            stepId: 's1',
+            status: 'completed',
+        }, RID)?.wire).toBe('plan.step_updated');
+    });
+    it('agent_* events carry task_id', () => {
+        const pending = mapRunToStreamEvent({
+            type: 'agent_pending',
+            runId: RID,
+            taskId: 'task_1',
+            parentAgentId: 'a',
+            childAgentId: 'b',
+            depth: 1,
+        }, RID);
+        expect(pending?.wire).toBe('agent.pending');
+        expect(pending?.data).toMatchObject({ task_id: 'task_1', depth: 1 });
+        expect(mapRunToStreamEvent({
+            type: 'agent_completed',
+            runId: RID,
+            taskId: 'task_1',
+            result: {
+                runId: RID,
+                status: 'completed',
+                iterations: 1,
+                durationMs: 1,
+                messages: [],
+                usage: {
+                    promptTokens: 0,
+                    completionTokens: 0,
+                    totalTokens: 0,
+                    cachedTokens: 0,
+                    cacheWriteTokens: 0,
+                },
+                cost: {
+                    inputCostPer1M: 0,
+                    outputCostPer1M: 0,
+                    totalCost: 0,
+                    cacheDiscount: 0,
+                },
+            },
+        }, RID)?.wire).toBe('agent.completed');
+        expect(mapRunToStreamEvent({ type: 'agent_failed', runId: RID, taskId: 'task_1', error: 'e' }, RID)?.wire).toBe('agent.failed');
+        expect(mapRunToStreamEvent({ type: 'agent_canceled', runId: RID, taskId: 'task_1' }, RID)
+            ?.wire).toBe('agent.canceled');
+    });
+    it('task_created / task_updated map cleanly', () => {
+        const a = mapRunToStreamEvent({
+            type: 'task_created',
+            runId: RID,
+            taskId: 'task_1',
+            subject: 's',
+            status: 'pending',
+        }, RID);
+        expect(a?.wire).toBe('task.created');
+        const b = mapRunToStreamEvent({
+            type: 'task_updated',
+            runId: RID,
+            taskId: 'task_1',
+            subject: 's',
+            status: 'completed',
+        }, RID);
+        expect(b?.wire).toBe('task.updated');
+        expect(b?.data.owner).toBe(null); // undefined owner → null
+    });
+    it('plugin_hook_* + sandbox_* + activity_* events map cleanly', () => {
+        expect(mapRunToStreamEvent({
+            type: 'plugin_hook_executing',
+            runId: RID,
+            pluginId: 'plugin_x',
+            hookEvent: 'pre_tool_use',
+        }, RID)?.wire).toBe('plugin.hook_executing');
+        expect(mapRunToStreamEvent({
+            type: 'plugin_hook_completed',
+            runId: RID,
+            pluginId: 'plugin_x',
+            hookEvent: 'pre_tool_use',
+            result: { action: 'continue' },
+        }, RID)?.wire).toBe('plugin.hook_completed');
+        expect(mapRunToStreamEvent({
+            type: 'sandbox_created',
+            runId: RID,
+            sandboxId: 'sbx_1',
+            environment: 'basic',
+        }, RID)?.wire).toBe('sandbox.created');
+        expect(mapRunToStreamEvent({
+            type: 'sandbox_exec',
+            runId: RID,
+            sandboxId: 'sbx_1',
+            command: 'ls',
+            exitCode: 0,
+            durationMs: 10,
+        }, RID)?.wire).toBe('sandbox.exec');
+        expect(mapRunToStreamEvent({ type: 'sandbox_destroyed', runId: RID, sandboxId: 'sbx_1' }, RID)?.wire).toBe('sandbox.destroyed');
+        expect(mapRunToStreamEvent({
+            type: 'activity_created',
+            runId: RID,
+            activityId: 'act_1',
+            activityType: 'tool_call',
+            description: 'd',
+        }, RID)?.wire).toBe('activity.created');
+        expect(mapRunToStreamEvent({
+            type: 'activity_updated',
+            runId: RID,
+            activityId: 'act_1',
+            status: 'completed',
+        }, RID)?.wire).toBe('activity.updated');
+    });
+    it('token_usage_updated → token.usage with usage + cost passed through', () => {
+        const usage = {
+            promptTokens: 10,
+            completionTokens: 20,
+            totalTokens: 30,
+            cachedTokens: 0,
+            cacheWriteTokens: 0,
+        };
+        const cost = {
+            inputCostPer1M: 1,
+            outputCostPer1M: 2,
+            totalCost: 0.01,
+            cacheDiscount: 0,
+        };
+        const r = mapRunToStreamEvent({ type: 'token_usage_updated', runId: RID, usage, cost }, RID);
+        expect(r?.wire).toBe('token.usage');
+        expect(r?.data).toMatchObject({ usage, cost });
+    });
+    it('source_agent_id + parent_task_id are mirrored when present on the event', () => {
+        const event = {
+            type: 'run_started',
+            runId: RID,
+            sourceAgentId: 'sub_agent_1',
+            parentTaskId: 'task_42',
+        };
+        const r = mapRunToStreamEvent(event, RID);
+        expect(r?.data).toMatchObject({ source_agent_id: 'sub_agent_1', parent_task_id: 'task_42' });
+    });
+});
+describe('mapRunToStreamEvent — explicit null set', () => {
+    it.each([
+        [{ type: 'run_completed', runId: RID, result: 'ok' }],
+        [{ type: 'run_failed', runId: RID, error: 'boom' }],
+    ])('%o returns null', (event) => {
+        expect(mapRunToStreamEvent(event, RID)).toBeNull();
+    });
+});
+describe('mapSessionToStreamEvent (deprecated alias)', () => {
+    it('is the same function reference as mapRunToStreamEvent', () => {
+        // Identity check is deterministic. toEqual on paired calls
+        // would work here (SSE mapper doesn't touch the clock), but
+        // we mirror the a2a mapper test pattern for consistency —
+        // the deprecation shim is literal assignment, so identity is
+        // the strictest possible assertion.
+        expect(mapSessionToStreamEvent).toBe(mapRunToStreamEvent);
+    });
+});
+//# sourceMappingURL=mapper.test.js.map

package/dist/bridge/sse/mapper.test.js.map

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

package/dist/bridge/tools/connector/adapter.d.ts

@@ -12,13 +12,13 @@ declare const ConnectorRouterInputSchema: z.ZodObject<{
     method: z.ZodString;
     input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 }, "strip", z.ZodTypeAny, {
-    method: string;
     input: Record<string, unknown>;
+    method: string;
     connectorId: string;
     instanceId: string;
 }, {
-    method: string;
     input: Record<string, unknown>;
+    method: string;
     connectorId: string;
     instanceId: string;
 }>;

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

@@ -0,0 +1,28 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 2):
+ *
+ *   - `connectorMethodToTool(connectorId, instanceId, method, manager)`
+ *     produces a `ToolDefinition` with:
+ *     - `name: '<connectorId>_<methodName>'`
+ *     - `description: '[<connectorId>] <method.description>'`
+ *     - `category: 'network'`, `permissions: ['network_access']`,
+ *       all read/destructive/concurrency flags set (readOnly:false,
+ *       destructive:false, concurrencySafe:true) — current behavior,
+ *       regardless of what the underlying method actually does.
+ *     - `execute(input, ctx)` calls `manager.execute` and wraps the
+ *       result; output is JSON-stringified on success, empty string
+ *       on failure; `_context` is ignored (§2.7).
+ *   - `connectorInstanceToTools(instanceId, manager)` throws when the
+ *     instance is missing; returns one tool per method otherwise.
+ *   - `allConnectorTools(manager)` enumerates
+ *     `manager.listConnectedInstances()` and flattens per-instance tool
+ *     lists.
+ *   - `createConnectorRouterTool(manager)` returns a single
+ *     `connector_execute` tool that routes by
+ *     `{connectorId, instanceId, method, input}`; returns
+ *     `{success: false}` results (not thrown errors) for missing
+ *     instance or connectorId mismatch. The description enumerates
+ *     currently connected instances.
+ */
+export {};
+//# sourceMappingURL=adapter.test.d.ts.map

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

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

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

@@ -0,0 +1,182 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 2):
+ *
+ *   - `connectorMethodToTool(connectorId, instanceId, method, manager)`
+ *     produces a `ToolDefinition` with:
+ *     - `name: '<connectorId>_<methodName>'`
+ *     - `description: '[<connectorId>] <method.description>'`
+ *     - `category: 'network'`, `permissions: ['network_access']`,
+ *       all read/destructive/concurrency flags set (readOnly:false,
+ *       destructive:false, concurrencySafe:true) — current behavior,
+ *       regardless of what the underlying method actually does.
+ *     - `execute(input, ctx)` calls `manager.execute` and wraps the
+ *       result; output is JSON-stringified on success, empty string
+ *       on failure; `_context` is ignored (§2.7).
+ *   - `connectorInstanceToTools(instanceId, manager)` throws when the
+ *     instance is missing; returns one tool per method otherwise.
+ *   - `allConnectorTools(manager)` enumerates
+ *     `manager.listConnectedInstances()` and flattens per-instance tool
+ *     lists.
+ *   - `createConnectorRouterTool(manager)` returns a single
+ *     `connector_execute` tool that routes by
+ *     `{connectorId, instanceId, method, input}`; returns
+ *     `{success: false}` results (not thrown errors) for missing
+ *     instance or connectorId mismatch. The description enumerates
+ *     currently connected instances.
+ */
+import { describe, expect, it, vi } from 'vitest';
+import { z } from 'zod';
+import { allConnectorTools, connectorInstanceToTools, connectorMethodToTool, createConnectorRouterTool, } from './adapter.js';
+const CID = 'conn_http';
+const IID1 = 'ci_abc123';
+const IID2 = 'ci_def456';
+function makeMethod(name, description = `${name} description`) {
+    return { name, description, inputSchema: z.object({}) };
+}
+function makeManager(overrides = {}) {
+    const execute = vi.fn();
+    const def = {
+        id: CID,
+        name: 'HTTP',
+        description: 'HTTP connector',
+        connectionType: 'http',
+        configSchema: z.object({}),
+        methods: [makeMethod('request'), makeMethod('send')],
+    };
+    const registry = {
+        getOrThrow: vi.fn(() => def),
+        get: vi.fn(() => def),
+    };
+    const instance = {
+        id: IID1,
+        connectorId: CID,
+        config: { connectorId: CID, name: 'default' },
+        status: 'connected',
+        createdAt: Date.now(),
+    };
+    return {
+        getInstance: vi.fn(() => instance),
+        getRegistry: vi.fn(() => registry),
+        listConnectedInstances: vi.fn(() => [instance]),
+        listInstances: vi.fn(() => [instance]),
+        execute,
+        ...overrides,
+    };
+}
+const ctx = {};
+describe('connectorMethodToTool', () => {
+    it('produces the expected name + description + flags', () => {
+        const manager = makeManager();
+        const tool = connectorMethodToTool(CID, IID1, makeMethod('request'), manager);
+        expect(tool.name).toBe(`${CID}_request`);
+        expect(tool.description).toBe(`[${CID}] request description`);
+        expect(tool.category).toBe('network');
+        expect(tool.permissions).toEqual(['network_access']);
+        expect(tool.isReadOnly?.({})).toBe(false);
+        expect(tool.isDestructive?.({})).toBe(false);
+        expect(tool.isConcurrencySafe?.({})).toBe(true);
+    });
+    it('execute wraps manager.execute success into a ToolResult with stringified output', async () => {
+        const manager = makeManager();
+        vi.mocked(manager.execute).mockResolvedValueOnce({
+            success: true,
+            output: { answer: 42 },
+            durationMs: 10,
+        });
+        const tool = connectorMethodToTool(CID, IID1, makeMethod('request'), manager);
+        const result = await tool.execute({}, ctx);
+        expect(result.success).toBe(true);
+        expect(result.output).toBe(JSON.stringify({ answer: 42 }, null, 2));
+        expect(result.data).toEqual({ answer: 42 });
+    });
+    it('execute carries through failure, leaves output as empty string', async () => {
+        const manager = makeManager();
+        vi.mocked(manager.execute).mockResolvedValueOnce({
+            success: false,
+            output: undefined,
+            durationMs: 5,
+            error: 'boom',
+        });
+        const tool = connectorMethodToTool(CID, IID1, makeMethod('request'), manager);
+        const result = await tool.execute({}, ctx);
+        expect(result.success).toBe(false);
+        expect(result.output).toBe('');
+        expect(result.error).toBe('boom');
+    });
+});
+describe('connectorInstanceToTools', () => {
+    it('returns one tool per method on the definition', () => {
+        const manager = makeManager();
+        const tools = connectorInstanceToTools(IID1, manager);
+        expect(tools.map((t) => t.name)).toEqual([`${CID}_request`, `${CID}_send`]);
+    });
+    it('throws when the instance is not found', () => {
+        const manager = makeManager({
+            getInstance: vi.fn(() => undefined),
+        });
+        expect(() => connectorInstanceToTools(IID2, manager)).toThrow(/not found/);
+    });
+});
+describe('allConnectorTools', () => {
+    it('enumerates every connected instance', () => {
+        const manager = makeManager();
+        const tools = allConnectorTools(manager);
+        expect(tools).toHaveLength(2);
+        expect(manager.listConnectedInstances).toHaveBeenCalled();
+    });
+    it('returns empty array when no connected instances', () => {
+        const manager = makeManager({
+            listConnectedInstances: vi.fn(() => []),
+        });
+        expect(allConnectorTools(manager)).toEqual([]);
+    });
+});
+describe('createConnectorRouterTool', () => {
+    it('returns a single connector_execute tool', () => {
+        const tool = createConnectorRouterTool(makeManager());
+        expect(tool.name).toBe('connector_execute');
+        expect(tool.category).toBe('network');
+    });
+    it('description enumerates currently connected instances', () => {
+        const tool = createConnectorRouterTool(makeManager());
+        expect(tool.description).toContain(CID);
+        expect(tool.description).toContain(IID1);
+        expect(tool.description).toContain('request');
+    });
+    it('description notes "No connectors are currently connected" when empty', () => {
+        const manager = makeManager({
+            listConnectedInstances: vi.fn(() => []),
+        });
+        const tool = createConnectorRouterTool(manager);
+        expect(tool.description).toContain('No connectors are currently connected');
+    });
+    it('execute returns {success: false} when instance is missing', async () => {
+        const manager = makeManager({
+            getInstance: vi.fn(() => undefined),
+        });
+        const tool = createConnectorRouterTool(manager);
+        const result = await tool.execute({ connectorId: CID, instanceId: IID2, method: 'request', input: {} }, ctx);
+        expect(result.success).toBe(false);
+        expect(result.error).toMatch(/not found/);
+    });
+    it('execute returns {success: false} when connectorId mismatches the instance', async () => {
+        const manager = makeManager();
+        const tool = createConnectorRouterTool(manager);
+        const result = await tool.execute({ connectorId: 'conn_other', instanceId: IID1, method: 'request', input: {} }, ctx);
+        expect(result.success).toBe(false);
+        expect(result.error).toMatch(/belongs to connector/);
+    });
+    it('execute delegates to manager.execute on happy path', async () => {
+        const manager = makeManager();
+        vi.mocked(manager.execute).mockResolvedValueOnce({
+            success: true,
+            output: 'hello',
+            durationMs: 1,
+        });
+        const tool = createConnectorRouterTool(manager);
+        const result = await tool.execute({ connectorId: CID, instanceId: IID1, method: 'request', input: { k: 'v' } }, ctx);
+        expect(result.success).toBe(true);
+        expect(result.data).toBe('hello');
+    });
+});
+//# sourceMappingURL=adapter.test.js.map

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

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

package/dist/bridge/tools/connector/definitions.test.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 2):
+ *
+ *   - `createConnectorExecuteTool(config)` returns a `defineTool`-wrapped
+ *     tool named `connector_execute` that:
+ *     - Returns `{success: false, error: '... not found'}` when instance
+ *       is missing.
+ *     - Returns `{success: false, error: '... not connected'}` when the
+ *       instance exists but `status !== 'connected'`.
+ *     - Returns `{success: false, error: ...}` when `manager.execute`
+ *       itself reports failure; falls back to 'Connector execution
+ *       failed' when the execute error is undefined.
+ *     - On success, stringifies non-string outputs to JSON; strings pass
+ *       through as-is.
+ *     - Attaches `data: { durationMs, metadata }` on success.
+ *   - `createConnectorListTool(config)` returns a tool named
+ *     `connector_list` that:
+ *     - Emits "No connector instances configured." when none exist.
+ *     - Lists each instance with `- <id> (<connectorId>): <name> [<status>]`.
+ *   - `createConnectorTools(config)` returns the pair of tools above.
+ */
+export {};
+//# sourceMappingURL=definitions.test.d.ts.map

package/dist/bridge/tools/connector/definitions.test.d.ts.map

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