@executioncontrolprotocol/runtime 0.3.0

package/dist/testing/mock-agent-transport.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Mock agent transport for deterministic testing.
+ *
+ * Pre-programmed delegation results keyed by executor name.
+ *
+ * @category Testing
+ */
+import type { AgentTransport, AgentRef, AgentCapabilities, DelegatedTask, DelegationResult } from "../protocols/agent-transport.js";
+/**
+ * A pre-programmed agent response for delegation.
+ *
+ * @category Testing
+ */
+export interface MockAgentResponse {
+    output: Record<string, unknown>;
+    success?: boolean;
+    error?: string;
+}
+/**
+ * A recorded delegation made to the mock transport.
+ *
+ * @category Testing
+ */
+export interface RecordedDelegation {
+    agent: AgentRef;
+    task: DelegatedTask;
+    timestamp: string;
+}
+/**
+ * Mock implementation of {@link AgentTransport} for unit testing.
+ *
+ * @category Testing
+ */
+export declare class MockAgentTransport implements AgentTransport {
+    readonly name = "mock-agent-transport";
+    private responses;
+    private callIndices;
+    readonly delegations: RecordedDelegation[];
+    /**
+     * Register a response for a specific executor name.
+     * Multiple responses are consumed in FIFO order.
+     */
+    addResponse(executorName: string, response: MockAgentResponse): this;
+    capabilities(agent: AgentRef): Promise<AgentCapabilities>;
+    delegate(agent: AgentRef, task: DelegatedTask): Promise<DelegationResult>;
+    close(): Promise<void>;
+    reset(): void;
+}
+//# sourceMappingURL=mock-agent-transport.d.ts.map

package/dist/testing/mock-agent-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-agent-transport.d.ts","sourceRoot":"","sources":["../../src/testing/mock-agent-transport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,QAAQ,EACR,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EACjB,MAAM,iCAAiC,CAAC;AAEzC;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,QAAQ,CAAC;IAChB,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACvD,QAAQ,CAAC,IAAI,0BAA0B;IAEvC,OAAO,CAAC,SAAS,CAA0C;IAC3D,OAAO,CAAC,WAAW,CAA6B;IAChD,QAAQ,CAAC,WAAW,EAAE,kBAAkB,EAAE,CAAM;IAEhD;;;OAGG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAQ9D,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAQzD,QAAQ,CACZ,KAAK,EAAE,QAAQ,EACf,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,gBAAgB,CAAC;IAgCtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAE5B,KAAK,IAAI,IAAI;CAKd"}

package/dist/testing/mock-agent-transport.js

@@ -0,0 +1,71 @@
+/**
+ * Mock agent transport for deterministic testing.
+ *
+ * Pre-programmed delegation results keyed by executor name.
+ *
+ * @category Testing
+ */
+/**
+ * Mock implementation of {@link AgentTransport} for unit testing.
+ *
+ * @category Testing
+ */
+export class MockAgentTransport {
+    name = "mock-agent-transport";
+    responses = new Map();
+    callIndices = new Map();
+    delegations = [];
+    /**
+     * Register a response for a specific executor name.
+     * Multiple responses are consumed in FIFO order.
+     */
+    addResponse(executorName, response) {
+        if (!this.responses.has(executorName)) {
+            this.responses.set(executorName, []);
+        }
+        this.responses.get(executorName).push(response);
+        return this;
+    }
+    async capabilities(agent) {
+        return {
+            name: agent.name,
+            skills: ["mock-skill"],
+            supportsStreaming: false,
+        };
+    }
+    async delegate(agent, task) {
+        this.delegations.push({
+            agent,
+            task,
+            timestamp: new Date().toISOString(),
+        });
+        const responses = this.responses.get(task.executorName) ?? [];
+        const idx = this.callIndices.get(task.executorName) ?? 0;
+        const responseIdx = Math.min(idx, responses.length - 1);
+        const response = responses[responseIdx];
+        this.callIndices.set(task.executorName, idx + 1);
+        if (!response) {
+            return {
+                taskId: task.id,
+                executorName: task.executorName,
+                output: {},
+                success: false,
+                error: `No mock response configured for "${task.executorName}"`,
+            };
+        }
+        return {
+            taskId: task.id,
+            executorName: task.executorName,
+            output: response.output,
+            success: response.success ?? true,
+            error: response.error,
+        };
+    }
+    async close() { }
+    reset() {
+        this.responses.clear();
+        this.callIndices.clear();
+        this.delegations.length = 0;
+    }
+}
+//# sourceMappingURL=mock-agent-transport.js.map

package/dist/testing/mock-agent-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-agent-transport.js","sourceRoot":"","sources":["../../src/testing/mock-agent-transport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgCH;;;;GAIG;AACH,MAAM,OAAO,kBAAkB;IACpB,IAAI,GAAG,sBAAsB,CAAC;IAE/B,SAAS,GAAG,IAAI,GAAG,EAA+B,CAAC;IACnD,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,WAAW,GAAyB,EAAE,CAAC;IAEhD;;;OAGG;IACH,WAAW,CAAC,YAAoB,EAAE,QAA2B;QAC3D,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAe;QAChC,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,CAAC,YAAY,CAAC;YACtB,iBAAiB,EAAE,KAAK;SACzB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,KAAe,EACf,IAAmB;QAEnB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;YACpB,KAAK;YACL,IAAI;YACJ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACzD,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;QACxC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;QAEjD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO;gBACL,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,MAAM,EAAE,EAAE;gBACV,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,oCAAoC,IAAI,CAAC,YAAY,GAAG;aAChE,CAAC;QACJ,CAAC;QAED,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,IAAI;YACjC,KAAK,EAAE,QAAQ,CAAC,KAAK;SACtB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK,KAAmB,CAAC;IAE/B,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9B,CAAC;CACF"}

package/dist/testing/mock-model-provider.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Mock model provider for deterministic testing.
+ *
+ * Supports pre-programmed responses, tool call sequences, and
+ * cassette-based record/replay.
+ *
+ * @category Testing
+ */
+import type { ModelProvider, GenerateOptions, GenerateResult, TokenUsage } from "../providers/model-provider.js";
+/**
+ * A pre-programmed response the mock will return for a given call.
+ *
+ * @category Testing
+ */
+export interface MockResponse {
+    content: string;
+    toolCalls?: GenerateResult["toolCalls"];
+    finishReason?: GenerateResult["finishReason"];
+    usage?: Partial<TokenUsage>;
+}
+/**
+ * A recorded call made to the mock provider.
+ *
+ * @category Testing
+ */
+export interface RecordedCall {
+    messages: GenerateOptions["messages"];
+    model?: string;
+    tools?: GenerateOptions["tools"];
+    temperature?: number;
+    timestamp: string;
+}
+/**
+ * Mock implementation of {@link ModelProvider} for unit testing.
+ *
+ * Responses are queued and returned in FIFO order. If no responses
+ * are queued, returns a default empty response.
+ *
+ * @category Testing
+ */
+export declare class MockModelProvider implements ModelProvider {
+    readonly name = "mock";
+    private responses;
+    private callIndex;
+    readonly calls: RecordedCall[];
+    /**
+     * Queue one or more responses that will be returned in order.
+     */
+    addResponses(...responses: MockResponse[]): this;
+    /**
+     * Queue a simple text response.
+     */
+    addTextResponse(content: string): this;
+    /**
+     * Queue a JSON response (stringified automatically).
+     */
+    addJsonResponse(data: Record<string, unknown>): this;
+    /**
+     * Queue a tool-call response.
+     */
+    addToolCallResponse(toolCalls: GenerateResult["toolCalls"], content?: string): this;
+    supportsToolCalling(): boolean;
+    generate(options: GenerateOptions): Promise<GenerateResult>;
+    /**
+     * Reset all queued responses and recorded calls.
+     */
+    reset(): void;
+}
+//# sourceMappingURL=mock-model-provider.d.ts.map

package/dist/testing/mock-model-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-model-provider.d.ts","sourceRoot":"","sources":["../../src/testing/mock-model-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,cAAc,EACd,UAAU,EACX,MAAM,gCAAgC,CAAC;AAExC;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC;IACxC,YAAY,CAAC,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;IAC9C,KAAK,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IACrD,QAAQ,CAAC,IAAI,UAAU;IAEvB,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,SAAS,CAAK;IACtB,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,CAAM;IAEpC;;OAEG;IACH,YAAY,CAAC,GAAG,SAAS,EAAE,YAAY,EAAE,GAAG,IAAI;IAKhD;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAItC;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIpD;;OAEG;IACH,mBAAmB,CACjB,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC,EACtC,OAAO,SAAK,GACX,IAAI;IAQP,mBAAmB,IAAI,OAAO;IAIxB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAiCjE;;OAEG;IACH,KAAK,IAAI,IAAI;CAKd"}

package/dist/testing/mock-model-provider.js

@@ -0,0 +1,92 @@
+/**
+ * Mock model provider for deterministic testing.
+ *
+ * Supports pre-programmed responses, tool call sequences, and
+ * cassette-based record/replay.
+ *
+ * @category Testing
+ */
+/**
+ * Mock implementation of {@link ModelProvider} for unit testing.
+ *
+ * Responses are queued and returned in FIFO order. If no responses
+ * are queued, returns a default empty response.
+ *
+ * @category Testing
+ */
+export class MockModelProvider {
+    name = "mock";
+    responses = [];
+    callIndex = 0;
+    calls = [];
+    /**
+     * Queue one or more responses that will be returned in order.
+     */
+    addResponses(...responses) {
+        this.responses.push(...responses);
+        return this;
+    }
+    /**
+     * Queue a simple text response.
+     */
+    addTextResponse(content) {
+        return this.addResponses({ content });
+    }
+    /**
+     * Queue a JSON response (stringified automatically).
+     */
+    addJsonResponse(data) {
+        return this.addResponses({ content: JSON.stringify(data) });
+    }
+    /**
+     * Queue a tool-call response.
+     */
+    addToolCallResponse(toolCalls, content = "") {
+        return this.addResponses({
+            content,
+            toolCalls,
+            finishReason: "tool-calls",
+        });
+    }
+    supportsToolCalling() {
+        return true;
+    }
+    async generate(options) {
+        this.calls.push({
+            messages: options.messages,
+            model: options.model,
+            tools: options.tools,
+            temperature: options.temperature,
+            timestamp: new Date().toISOString(),
+        });
+        const response = this.responses[this.callIndex];
+        this.callIndex++;
+        if (!response) {
+            return {
+                content: '{"error": "no mock response configured"}',
+                toolCalls: [],
+                finishReason: "stop",
+                usage: { promptTokens: 0, completionTokens: 0, totalTokens: 0 },
+            };
+        }
+        return {
+            content: response.content,
+            toolCalls: response.toolCalls ?? [],
+            finishReason: response.finishReason ?? "stop",
+            usage: {
+                promptTokens: response.usage?.promptTokens ?? 100,
+                completionTokens: response.usage?.completionTokens ?? 50,
+                totalTokens: response.usage?.totalTokens ?? 150,
+            },
+        };
+    }
+    /**
+     * Reset all queued responses and recorded calls.
+     */
+    reset() {
+        this.responses = [];
+        this.callIndex = 0;
+        this.calls.length = 0;
+    }
+}
+//# sourceMappingURL=mock-model-provider.js.map

package/dist/testing/mock-model-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-model-provider.js","sourceRoot":"","sources":["../../src/testing/mock-model-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAkCH;;;;;;;GAOG;AACH,MAAM,OAAO,iBAAiB;IACnB,IAAI,GAAG,MAAM,CAAC;IAEf,SAAS,GAAmB,EAAE,CAAC;IAC/B,SAAS,GAAG,CAAC,CAAC;IACb,KAAK,GAAmB,EAAE,CAAC;IAEpC;;OAEG;IACH,YAAY,CAAC,GAAG,SAAyB;QACvC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,OAAe;QAC7B,OAAO,IAAI,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,IAA6B;QAC3C,OAAO,IAAI,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,mBAAmB,CACjB,SAAsC,EACtC,OAAO,GAAG,EAAE;QAEZ,OAAO,IAAI,CAAC,YAAY,CAAC;YACvB,OAAO;YACP,SAAS;YACT,YAAY,EAAE,YAAY;SAC3B,CAAC,CAAC;IACL,CAAC;IAED,mBAAmB;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAwB;QACrC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YACd,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAChD,IAAI,CAAC,SAAS,EAAE,CAAC;QAEjB,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO;gBACL,OAAO,EAAE,0CAA0C;gBACnD,SAAS,EAAE,EAAE;gBACb,YAAY,EAAE,MAAM;gBACpB,KAAK,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE;aAChE,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,SAAS,EAAE,QAAQ,CAAC,SAAS,IAAI,EAAE;YACnC,YAAY,EAAE,QAAQ,CAAC,YAAY,IAAI,MAAM;YAC7C,KAAK,EAAE;gBACL,YAAY,EAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,IAAI,GAAG;gBACjD,gBAAgB,EAAE,QAAQ,CAAC,KAAK,EAAE,gBAAgB,IAAI,EAAE;gBACxD,WAAW,EAAE,QAAQ,CAAC,KAAK,EAAE,WAAW,IAAI,GAAG;aAChD;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QACpB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACxB,CAAC;CACF"}

package/dist/testing/mock-tool-invoker.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Mock tool invoker for deterministic testing.
+ *
+ * Pre-programmed tool responses keyed by `server:tool` name.
+ *
+ * @category Testing
+ */
+import type { ToolInvoker, ToolServerConfig, DiscoveredTool, ToolResult } from "../protocols/tool-invoker.js";
+/**
+ * A pre-programmed tool that the mock will expose.
+ *
+ * @category Testing
+ */
+export interface MockTool {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    responses: MockToolResponse[];
+}
+/**
+ * A pre-programmed response for a tool call.
+ * Responses are consumed in FIFO order; the last one is reused indefinitely.
+ *
+ * @category Testing
+ */
+export interface MockToolResponse {
+    content: unknown;
+    isError?: boolean;
+}
+/**
+ * A recorded tool call made to the mock invoker.
+ *
+ * @category Testing
+ */
+export interface RecordedToolCall {
+    serverName: string;
+    toolName: string;
+    args: Record<string, unknown>;
+    timestamp: string;
+}
+/**
+ * Mock implementation of {@link ToolInvoker} for unit testing.
+ *
+ * @category Testing
+ */
+export declare class MockToolInvoker implements ToolInvoker {
+    readonly name = "mock-tool-invoker";
+    private servers;
+    readonly calls: RecordedToolCall[];
+    /**
+     * Register a mock tool on a server.
+     */
+    addTool(serverName: string, tool: MockTool): this;
+    /**
+     * Convenience: register a tool that always returns the same data.
+     */
+    addSimpleTool(serverName: string, toolName: string, response: unknown): this;
+    connect(_config: ToolServerConfig): Promise<void>;
+    listTools(serverName: string): Promise<DiscoveredTool[]>;
+    callTool(serverName: string, toolName: string, args: Record<string, unknown>): Promise<ToolResult>;
+    disconnect(_serverName: string): Promise<void>;
+    disconnectAll(): Promise<void>;
+    reset(): void;
+}
+//# sourceMappingURL=mock-tool-invoker.d.ts.map

package/dist/testing/mock-tool-invoker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-tool-invoker.d.ts","sourceRoot":"","sources":["../../src/testing/mock-tool-invoker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,UAAU,EACX,MAAM,8BAA8B,CAAC;AAEtC;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,SAAS,EAAE,gBAAgB,EAAE,CAAC;CAC/B;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD,QAAQ,CAAC,IAAI,uBAAuB;IAEpC,OAAO,CAAC,OAAO,CAAyE;IACxF,QAAQ,CAAC,KAAK,EAAE,gBAAgB,EAAE,CAAM;IAExC;;OAEG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI;IAQjD;;OAEG;IACH,aAAa,CACX,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,OAAO,GAChB,IAAI;IASD,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAWxD,QAAQ,CACZ,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,UAAU,CAAC;IAiChB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAC9C,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAEpC,KAAK,IAAI,IAAI;CAId"}

package/dist/testing/mock-tool-invoker.js

@@ -0,0 +1,85 @@
+/**
+ * Mock tool invoker for deterministic testing.
+ *
+ * Pre-programmed tool responses keyed by `server:tool` name.
+ *
+ * @category Testing
+ */
+/**
+ * Mock implementation of {@link ToolInvoker} for unit testing.
+ *
+ * @category Testing
+ */
+export class MockToolInvoker {
+    name = "mock-tool-invoker";
+    servers = new Map();
+    calls = [];
+    /**
+     * Register a mock tool on a server.
+     */
+    addTool(serverName, tool) {
+        if (!this.servers.has(serverName)) {
+            this.servers.set(serverName, new Map());
+        }
+        this.servers.get(serverName).set(tool.name, { tool, callIndex: 0 });
+        return this;
+    }
+    /**
+     * Convenience: register a tool that always returns the same data.
+     */
+    addSimpleTool(serverName, toolName, response) {
+        return this.addTool(serverName, {
+            name: toolName,
+            description: `Mock ${toolName}`,
+            inputSchema: { type: "object" },
+            responses: [{ content: response }],
+        });
+    }
+    async connect(_config) {
+        // no-op for mock
+    }
+    async listTools(serverName) {
+        const server = this.servers.get(serverName);
+        if (!server)
+            return [];
+        return [...server.values()].map((entry) => ({
+            name: entry.tool.name,
+            description: entry.tool.description,
+            inputSchema: entry.tool.inputSchema,
+        }));
+    }
+    async callTool(serverName, toolName, args) {
+        this.calls.push({
+            serverName,
+            toolName,
+            args,
+            timestamp: new Date().toISOString(),
+        });
+        const server = this.servers.get(serverName);
+        const entry = server?.get(toolName);
+        if (!entry) {
+            return {
+                content: { error: `Mock tool ${serverName}:${toolName} not found` },
+                isError: true,
+            };
+        }
+        const { tool, callIndex } = entry;
+        const responseIdx = Math.min(callIndex, tool.responses.length - 1);
+        const response = tool.responses[responseIdx];
+        entry.callIndex++;
+        if (!response) {
+            return { content: null, isError: true };
+        }
+        return {
+            content: response.content,
+            isError: response.isError ?? false,
+        };
+    }
+    async disconnect(_serverName) { }
+    async disconnectAll() { }
+    reset() {
+        this.servers.clear();
+        this.calls.length = 0;
+    }
+}
+//# sourceMappingURL=mock-tool-invoker.js.map

package/dist/testing/mock-tool-invoker.js.map

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

package/dist/tracing/collector.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Trace collector — accumulates spans during a Context execution
+ * and produces a complete {@link ExecutionTrace}.
+ *
+ * @category Tracing
+ */
+import type { ExecutionTrace, TraceSpan, SpanType, SpanTokenUsage, TraceExporter } from "./types.js";
+/**
+ * Collects trace spans during an execution run.
+ *
+ * Call {@link startSpan} at the beginning of each unit of work and
+ * {@link endSpan} when it completes. After the run finishes, call
+ * {@link buildTrace} to produce the finalized {@link ExecutionTrace},
+ * then {@link exportAll} to push it to all registered exporters.
+ *
+ * @category Tracing
+ */
+export declare class TraceCollector {
+    private spans;
+    private openSpans;
+    private stepCounter;
+    private readonly exporters;
+    /**
+     * Register one or more trace exporters.
+     */
+    addExporters(...exporters: TraceExporter[]): this;
+    /**
+     * Begin a new span. Returns the span ID for later reference.
+     */
+    startSpan(opts: {
+        type: SpanType;
+        executorName: string;
+        parentId?: string;
+        model?: string;
+        toolName?: string;
+        toolArgs?: Record<string, unknown>;
+        mountName?: string;
+        mountStage?: string;
+    }): string;
+    /**
+     * End an open span, recording its results.
+     */
+    endSpan(spanId: string, result?: {
+        output?: unknown;
+        reasoning?: string;
+        tokens?: SpanTokenUsage;
+        toolResult?: unknown;
+        toolIsError?: boolean;
+        mountItemCount?: number;
+        error?: string;
+    }): void;
+    /**
+     * Build the finalized execution trace.
+     */
+    buildTrace(meta: {
+        executionId: string;
+        contextName: string;
+        contextVersion: string;
+        strategy: string;
+        startedAt: string;
+        endedAt: string;
+        durationMs: number;
+        success: boolean;
+        error?: string;
+    }): ExecutionTrace;
+    /**
+     * Export the trace to all registered exporters.
+     */
+    exportAll(trace: ExecutionTrace): Promise<void>;
+    /**
+     * Return the current collected spans (for testing).
+     */
+    getSpans(): ReadonlyArray<TraceSpan>;
+}
+//# sourceMappingURL=collector.d.ts.map

package/dist/tracing/collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../src/tracing/collector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EACT,QAAQ,EACR,cAAc,EACd,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;GASG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,SAAS,CAAsE;IACvF,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IAEjD;;OAEG;IACH,YAAY,CAAC,GAAG,SAAS,EAAE,aAAa,EAAE,GAAG,IAAI;IAKjD;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE;QACd,IAAI,EAAE,QAAQ,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,MAAM;IAyBV;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE;QAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,cAAc,CAAC;QACxB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,KAAK,CAAC,EAAE,MAAM,CAAC;KACX,GAAG,IAAI;IAsBb;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,cAAc;IAOlB;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAYrD;;OAEG;IACH,QAAQ,IAAI,aAAa,CAAC,SAAS,CAAC;CAGrC"}

package/dist/tracing/collector.js

@@ -0,0 +1,106 @@
+/**
+ * Trace collector — accumulates spans during a Context execution
+ * and produces a complete {@link ExecutionTrace}.
+ *
+ * @category Tracing
+ */
+/**
+ * Collects trace spans during an execution run.
+ *
+ * Call {@link startSpan} at the beginning of each unit of work and
+ * {@link endSpan} when it completes. After the run finishes, call
+ * {@link buildTrace} to produce the finalized {@link ExecutionTrace},
+ * then {@link exportAll} to push it to all registered exporters.
+ *
+ * @category Tracing
+ */
+export class TraceCollector {
+    spans = [];
+    openSpans = new Map();
+    stepCounter = 0;
+    exporters = [];
+    /**
+     * Register one or more trace exporters.
+     */
+    addExporters(...exporters) {
+        this.exporters.push(...exporters);
+        return this;
+    }
+    /**
+     * Begin a new span. Returns the span ID for later reference.
+     */
+    startSpan(opts) {
+        this.stepCounter++;
+        const id = `span_${this.stepCounter}_${Date.now()}`;
+        const now = Date.now();
+        this.openSpans.set(id, {
+            span: {
+                id,
+                parentId: opts.parentId,
+                type: opts.type,
+                executorName: opts.executorName,
+                startedAt: new Date(now).toISOString(),
+                step: this.stepCounter,
+                model: opts.model,
+                toolName: opts.toolName,
+                toolArgs: opts.toolArgs,
+                mountName: opts.mountName,
+                mountStage: opts.mountStage,
+            },
+            startTime: now,
+        });
+        return id;
+    }
+    /**
+     * End an open span, recording its results.
+     */
+    endSpan(spanId, result = {}) {
+        const entry = this.openSpans.get(spanId);
+        if (!entry)
+            return;
+        const now = Date.now();
+        const span = {
+            ...entry.span,
+            endedAt: new Date(now).toISOString(),
+            durationMs: now - entry.startTime,
+            output: result.output,
+            reasoning: result.reasoning,
+            tokens: result.tokens,
+            toolResult: result.toolResult,
+            toolIsError: result.toolIsError,
+            mountItemCount: result.mountItemCount,
+            error: result.error,
+        };
+        this.spans.push(span);
+        this.openSpans.delete(spanId);
+    }
+    /**
+     * Build the finalized execution trace.
+     */
+    buildTrace(meta) {
+        return {
+            ...meta,
+            spans: [...this.spans],
+        };
+    }
+    /**
+     * Export the trace to all registered exporters.
+     */
+    async exportAll(trace) {
+        for (const exporter of this.exporters) {
+            try {
+                await exporter.export(trace);
+            }
+            catch (err) {
+                console.error(`[ECP TRACE] Exporter "${exporter.name}" failed: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+    /**
+     * Return the current collected spans (for testing).
+     */
+    getSpans() {
+        return this.spans;
+    }
+}
+//# sourceMappingURL=collector.js.map

package/dist/tracing/collector.js.map

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

package/dist/tracing/exporters/console.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Console trace exporter — prints a human-readable execution trace
+ * to stderr.
+ *
+ * @category Tracing
+ */
+import type { ExecutionTrace, TraceExporter } from "../types.js";
+/**
+ * Exports execution traces as formatted text to the console.
+ *
+ * @category Tracing
+ */
+export declare class ConsoleTraceExporter implements TraceExporter {
+    readonly name = "console";
+    export(trace: ExecutionTrace): Promise<void>;
+}
+//# sourceMappingURL=console.d.ts.map