@executioncontrolprotocol/runtime 0.3.0

package/dist/providers/ollama/ollama-provider.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Ollama implementation of the {@link ModelProvider} interface.
+ *
+ * Uses Ollama's native REST API (`/api/chat`) so there is no dependency
+ * on the OpenAI SDK. Supports JSON-mode output and tool/function calling.
+ *
+ * @category Providers
+ */
+import type { GenerateOptions, GenerateResult, ModelProvider } from "../model-provider.js";
+/**
+ * Configuration for the Ollama provider.
+ *
+ * @category Providers
+ */
+export interface OllamaProviderConfig {
+    /** Base URL for the Ollama server. Defaults to `http://localhost:11434`. */
+    baseURL?: string;
+    /** Default model to use (e.g. `"gemma3:1b"`). */
+    defaultModel?: string;
+    /** Request timeout in milliseconds. Defaults to 120 000 (2 min). */
+    timeoutMs?: number;
+}
+/**
+ * Ollama model provider implementation.
+ *
+ * Connects to a locally-running (or remote) Ollama instance via its
+ * native HTTP API. Ideal for CI pipelines and local development with
+ * open-weight models.
+ *
+ * @category Providers
+ */
+export declare class OllamaProvider implements ModelProvider {
+    readonly name = "ollama";
+    private readonly baseURL;
+    private readonly defaultModel;
+    private readonly timeoutMs;
+    constructor(config?: OllamaProviderConfig);
+    supportsToolCalling(): boolean;
+    generate(options: GenerateOptions): Promise<GenerateResult>;
+}
+//# sourceMappingURL=ollama-provider.d.ts.map

package/dist/providers/ollama/ollama-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama-provider.d.ts","sourceRoot":"","sources":["../../../src/providers/ollama/ollama-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAEV,eAAe,EACf,cAAc,EACd,aAAa,EAId,MAAM,sBAAsB,CAAC;AAE9B;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA6ED;;;;;;;;GAQG;AACH,qBAAa,cAAe,YAAW,aAAa;IAClD,QAAQ,CAAC,IAAI,YAAY;IAEzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,GAAE,oBAAyB;IAS7C,mBAAmB,IAAI,OAAO;IAIxB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;CAyDlE"}

package/dist/providers/ollama/ollama-provider.js

@@ -0,0 +1,113 @@
+/**
+ * Ollama implementation of the {@link ModelProvider} interface.
+ *
+ * Uses Ollama's native REST API (`/api/chat`) so there is no dependency
+ * on the OpenAI SDK. Supports JSON-mode output and tool/function calling.
+ *
+ * @category Providers
+ */
+function toOllamaMessages(messages) {
+    return messages.map((msg) => ({
+        role: msg.role,
+        content: msg.content,
+    }));
+}
+function toOllamaTools(tools) {
+    return tools.map((tool) => ({
+        type: "function",
+        function: {
+            name: tool.name,
+            description: tool.description,
+            parameters: tool.parameters,
+        },
+    }));
+}
+function extractToolCalls(response) {
+    const calls = response.message.tool_calls;
+    if (!calls?.length)
+        return [];
+    return calls.map((tc, idx) => ({
+        id: `call_${idx}`,
+        name: tc.function.name,
+        arguments: tc.function.arguments,
+    }));
+}
+function extractUsage(response) {
+    const prompt = response.prompt_eval_count ?? 0;
+    const completion = response.eval_count ?? 0;
+    return {
+        promptTokens: prompt,
+        completionTokens: completion,
+        totalTokens: prompt + completion,
+    };
+}
+/**
+ * Ollama model provider implementation.
+ *
+ * Connects to a locally-running (or remote) Ollama instance via its
+ * native HTTP API. Ideal for CI pipelines and local development with
+ * open-weight models.
+ *
+ * @category Providers
+ */
+export class OllamaProvider {
+    name = "ollama";
+    baseURL;
+    defaultModel;
+    timeoutMs;
+    constructor(config = {}) {
+        this.baseURL = (config.baseURL ?? "http://localhost:11434").replace(/\/$/, "");
+        this.defaultModel = config.defaultModel ?? "gemma3:1b";
+        this.timeoutMs = config.timeoutMs ?? 120_000;
+    }
+    supportsToolCalling() {
+        return true;
+    }
+    async generate(options) {
+        const model = options.model ?? this.defaultModel;
+        const messages = toOllamaMessages(options.messages);
+        const body = {
+            model,
+            messages,
+            stream: false,
+        };
+        if (options.tools?.length) {
+            body.tools = toOllamaTools(options.tools);
+        }
+        if (options.responseFormat) {
+            body.format = "json";
+        }
+        if (options.temperature !== undefined) {
+            body.options = { temperature: options.temperature };
+        }
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+        if (options.signal) {
+            options.signal.addEventListener("abort", () => controller.abort());
+        }
+        try {
+            const response = await fetch(`${this.baseURL}/api/chat`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const text = await response.text();
+                throw new Error(`Ollama API error (${response.status}): ${text}`);
+            }
+            const data = (await response.json());
+            const toolCalls = extractToolCalls(data);
+            return {
+                content: data.message.content ?? "",
+                toolCalls,
+                finishReason: toolCalls.length > 0 ? "tool-calls" : "stop",
+                usage: extractUsage(data),
+            };
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+//# sourceMappingURL=ollama-provider.js.map

package/dist/providers/ollama/ollama-provider.js.map

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

package/dist/providers/openai/index.d.ts

@@ -0,0 +1,3 @@
+export { OpenAIProvider } from "./openai-provider.js";
+export type { OpenAIProviderConfig } from "./openai-provider.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/openai/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/providers/openai/index.js

@@ -0,0 +1,2 @@
+export { OpenAIProvider } from "./openai-provider.js";
+//# sourceMappingURL=index.js.map

package/dist/providers/openai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/openai/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/providers/openai/openai-provider.d.ts

@@ -0,0 +1,41 @@
+/**
+ * OpenAI implementation of the {@link ModelProvider} interface.
+ *
+ * Uses the official `openai` npm package to call the Chat Completions API.
+ * Supports tool/function calling, structured JSON output, and token usage tracking.
+ *
+ * @category Providers
+ */
+import type { GenerateOptions, GenerateResult, ModelProvider } from "../model-provider.js";
+/**
+ * Configuration for the OpenAI provider.
+ *
+ * @category Providers
+ */
+export interface OpenAIProviderConfig {
+    /** OpenAI API key. Falls back to `OPENAI_API_KEY` env var if not set. */
+    apiKey?: string;
+    /** Base URL override (e.g. for Azure OpenAI or proxies). */
+    baseURL?: string;
+    /** Default model to use (e.g. `"gpt-4o"`, `"gpt-4o-mini"`). */
+    defaultModel?: string;
+    /** Default max tokens for generation. */
+    defaultMaxTokens?: number;
+    /** Organization ID for OpenAI API requests. */
+    organization?: string;
+}
+/**
+ * OpenAI model provider implementation.
+ *
+ * @category Providers
+ */
+export declare class OpenAIProvider implements ModelProvider {
+    readonly name = "openai";
+    private readonly client;
+    private readonly defaultModel;
+    private readonly defaultMaxTokens;
+    constructor(config?: OpenAIProviderConfig);
+    supportsToolCalling(): boolean;
+    generate(options: GenerateOptions): Promise<GenerateResult>;
+}
+//# sourceMappingURL=openai-provider.d.ts.map

package/dist/providers/openai/openai-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-provider.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/openai-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAEV,eAAe,EACf,cAAc,EACd,aAAa,EAId,MAAM,sBAAsB,CAAC;AAE9B;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,yCAAyC;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA6FD;;;;GAIG;AACH,qBAAa,cAAe,YAAW,aAAa;IAClD,QAAQ,CAAC,IAAI,YAAY;IAEzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAE9B,MAAM,GAAE,oBAAyB;IAU7C,mBAAmB,IAAI,OAAO;IAIxB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;CA+ClE"}

package/dist/providers/openai/openai-provider.js

@@ -0,0 +1,150 @@
+/**
+ * OpenAI implementation of the {@link ModelProvider} interface.
+ *
+ * Uses the official `openai` npm package to call the Chat Completions API.
+ * Supports tool/function calling, structured JSON output, and token usage tracking.
+ *
+ * @category Providers
+ */
+import OpenAI from "openai";
+function toOpenAIMessages(messages) {
+    return messages.map((msg) => {
+        switch (msg.role) {
+            case "system":
+                return {
+                    role: "system",
+                    content: msg.content,
+                };
+            case "user":
+                return {
+                    role: "user",
+                    content: msg.content,
+                };
+            case "assistant":
+                return {
+                    role: "assistant",
+                    content: msg.content,
+                };
+            case "tool":
+                return {
+                    role: "tool",
+                    content: msg.content,
+                    tool_call_id: msg.toolCallId ?? "",
+                };
+        }
+    });
+}
+function toOpenAITools(tools) {
+    return tools.map((tool) => ({
+        type: "function",
+        function: {
+            name: tool.name,
+            description: tool.description,
+            parameters: tool.parameters,
+        },
+    }));
+}
+function extractToolCalls(choice) {
+    const calls = choice.message.tool_calls;
+    if (!calls?.length)
+        return [];
+    return calls.map((tc) => ({
+        id: tc.id,
+        name: tc.function.name,
+        arguments: parseToolArgs(tc.function.arguments),
+    }));
+}
+function parseToolArgs(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return { _raw: raw };
+    }
+}
+function mapFinishReason(reason) {
+    switch (reason) {
+        case "stop":
+            return "stop";
+        case "tool_calls":
+            return "tool-calls";
+        case "length":
+            return "length";
+        case "content_filter":
+            return "content-filter";
+        default:
+            return "stop";
+    }
+}
+function extractUsage(usage) {
+    return {
+        promptTokens: usage?.prompt_tokens ?? 0,
+        completionTokens: usage?.completion_tokens ?? 0,
+        totalTokens: usage?.total_tokens ?? 0,
+    };
+}
+/**
+ * OpenAI model provider implementation.
+ *
+ * @category Providers
+ */
+export class OpenAIProvider {
+    name = "openai";
+    client;
+    defaultModel;
+    defaultMaxTokens;
+    constructor(config = {}) {
+        this.client = new OpenAI({
+            apiKey: config.apiKey ?? process.env.OPENAI_API_KEY,
+            baseURL: config.baseURL,
+            organization: config.organization,
+        });
+        this.defaultModel = config.defaultModel ?? "gpt-4o";
+        this.defaultMaxTokens = config.defaultMaxTokens ?? 4096;
+    }
+    supportsToolCalling() {
+        return true;
+    }
+    async generate(options) {
+        const model = options.model ?? this.defaultModel;
+        const messages = toOpenAIMessages(options.messages);
+        const params = {
+            model,
+            messages,
+            max_tokens: options.maxTokens ?? this.defaultMaxTokens,
+            temperature: options.temperature,
+        };
+        if (options.tools?.length) {
+            params.tools = toOpenAITools(options.tools);
+        }
+        if (options.responseFormat) {
+            params.response_format = {
+                type: "json_schema",
+                json_schema: {
+                    name: "response",
+                    strict: true,
+                    schema: options.responseFormat.schema,
+                },
+            };
+        }
+        const response = await this.client.chat.completions.create(params, {
+            signal: options.signal ?? undefined,
+        });
+        const choice = response.choices[0];
+        if (!choice) {
+            return {
+                content: "",
+                toolCalls: [],
+                finishReason: "error",
+                usage: extractUsage(response.usage),
+            };
+        }
+        return {
+            content: choice.message.content ?? "",
+            toolCalls: extractToolCalls(choice),
+            finishReason: mapFinishReason(choice.finish_reason),
+            usage: extractUsage(response.usage),
+        };
+    }
+}
+//# sourceMappingURL=openai-provider.js.map

package/dist/providers/openai/openai-provider.js.map

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

package/dist/testing/cassette.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Cassette record/replay system for deterministic test runs.
+ *
+ * Records all model calls, tool calls, and delegations during a run,
+ * then replays them to produce identical results without network.
+ *
+ * @category Testing
+ */
+/**
+ * A single recorded interaction in a cassette.
+ *
+ * @category Testing
+ */
+export interface CassetteEntry {
+    /** Interaction type. */
+    type: "model-call" | "tool-call" | "delegation";
+    /** Timestamp of the interaction. */
+    timestamp: string;
+    /** The request sent. */
+    request: Record<string, unknown>;
+    /** The response received. */
+    response: Record<string, unknown>;
+}
+/**
+ * A complete cassette recording of a run.
+ *
+ * @category Testing
+ */
+export interface Cassette {
+    /** The context name this cassette was recorded from. */
+    contextName: string;
+    /** When the recording was made. */
+    recordedAt: string;
+    /** Ordered sequence of interactions. */
+    entries: CassetteEntry[];
+}
+/**
+ * Load a cassette from disk.
+ *
+ * @param path - File path to the cassette JSON.
+ * @returns The loaded cassette.
+ *
+ * @category Testing
+ */
+export declare function loadCassette(path: string): Cassette;
+/**
+ * Save a cassette to disk.
+ *
+ * @param cassette - The cassette to save.
+ * @param path - File path to write to.
+ *
+ * @category Testing
+ */
+export declare function saveCassette(cassette: Cassette, path: string): void;
+/**
+ * A cassette recorder that captures interactions during a run.
+ *
+ * @category Testing
+ */
+export declare class CassetteRecorder {
+    private entries;
+    private contextName;
+    setContextName(name: string): void;
+    recordModelCall(request: Record<string, unknown>, response: Record<string, unknown>): void;
+    recordToolCall(request: Record<string, unknown>, response: Record<string, unknown>): void;
+    recordDelegation(request: Record<string, unknown>, response: Record<string, unknown>): void;
+    toCassette(): Cassette;
+    reset(): void;
+}
+/**
+ * A cassette replayer that provides pre-recorded responses.
+ *
+ * @category Testing
+ */
+export declare class CassetteReplayer {
+    private modelCallIndex;
+    private toolCallIndex;
+    private delegationIndex;
+    private readonly modelCalls;
+    private readonly toolCalls;
+    private readonly delegationCalls;
+    constructor(cassette: Cassette);
+    nextModelResponse(): Record<string, unknown> | undefined;
+    nextToolResponse(): Record<string, unknown> | undefined;
+    nextDelegationResponse(): Record<string, unknown> | undefined;
+    get exhausted(): boolean;
+}
+//# sourceMappingURL=cassette.d.ts.map

package/dist/testing/cassette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cassette.d.ts","sourceRoot":"","sources":["../../src/testing/cassette.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,IAAI,EAAE,YAAY,GAAG,WAAW,GAAG,YAAY,CAAC;IAEhD,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAElB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEjC,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IAEpB,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IAEnB,wCAAwC;IACxC,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAGnD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAMnE;AAED;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,WAAW,CAAM;IAEzB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIlC,eAAe,CACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI;IASP,cAAc,CACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI;IASP,gBAAgB,CACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI;IASP,UAAU,IAAI,QAAQ;IAQtB,KAAK,IAAI,IAAI;CAId;AAED;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkB;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;gBAEtC,QAAQ,EAAE,QAAQ;IAM9B,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAMxD,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAMvD,sBAAsB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAM7D,IAAI,SAAS,IAAI,OAAO,CAMvB;CACF"}

package/dist/testing/cassette.js

@@ -0,0 +1,123 @@
+/**
+ * Cassette record/replay system for deterministic test runs.
+ *
+ * Records all model calls, tool calls, and delegations during a run,
+ * then replays them to produce identical results without network.
+ *
+ * @category Testing
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+/**
+ * Load a cassette from disk.
+ *
+ * @param path - File path to the cassette JSON.
+ * @returns The loaded cassette.
+ *
+ * @category Testing
+ */
+export function loadCassette(path) {
+    const raw = readFileSync(path, "utf-8");
+    return JSON.parse(raw);
+}
+/**
+ * Save a cassette to disk.
+ *
+ * @param cassette - The cassette to save.
+ * @param path - File path to write to.
+ *
+ * @category Testing
+ */
+export function saveCassette(cassette, path) {
+    const dir = dirname(path);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(path, JSON.stringify(cassette, null, 2));
+}
+/**
+ * A cassette recorder that captures interactions during a run.
+ *
+ * @category Testing
+ */
+export class CassetteRecorder {
+    entries = [];
+    contextName = "";
+    setContextName(name) {
+        this.contextName = name;
+    }
+    recordModelCall(request, response) {
+        this.entries.push({
+            type: "model-call",
+            timestamp: new Date().toISOString(),
+            request,
+            response,
+        });
+    }
+    recordToolCall(request, response) {
+        this.entries.push({
+            type: "tool-call",
+            timestamp: new Date().toISOString(),
+            request,
+            response,
+        });
+    }
+    recordDelegation(request, response) {
+        this.entries.push({
+            type: "delegation",
+            timestamp: new Date().toISOString(),
+            request,
+            response,
+        });
+    }
+    toCassette() {
+        return {
+            contextName: this.contextName,
+            recordedAt: new Date().toISOString(),
+            entries: [...this.entries],
+        };
+    }
+    reset() {
+        this.entries = [];
+        this.contextName = "";
+    }
+}
+/**
+ * A cassette replayer that provides pre-recorded responses.
+ *
+ * @category Testing
+ */
+export class CassetteReplayer {
+    modelCallIndex = 0;
+    toolCallIndex = 0;
+    delegationIndex = 0;
+    modelCalls;
+    toolCalls;
+    delegationCalls;
+    constructor(cassette) {
+        this.modelCalls = cassette.entries.filter((e) => e.type === "model-call");
+        this.toolCalls = cassette.entries.filter((e) => e.type === "tool-call");
+        this.delegationCalls = cassette.entries.filter((e) => e.type === "delegation");
+    }
+    nextModelResponse() {
+        const entry = this.modelCalls[this.modelCallIndex];
+        this.modelCallIndex++;
+        return entry?.response;
+    }
+    nextToolResponse() {
+        const entry = this.toolCalls[this.toolCallIndex];
+        this.toolCallIndex++;
+        return entry?.response;
+    }
+    nextDelegationResponse() {
+        const entry = this.delegationCalls[this.delegationIndex];
+        this.delegationIndex++;
+        return entry?.response;
+    }
+    get exhausted() {
+        return (this.modelCallIndex >= this.modelCalls.length &&
+            this.toolCallIndex >= this.toolCalls.length &&
+            this.delegationIndex >= this.delegationCalls.length);
+    }
+}
+//# sourceMappingURL=cassette.js.map

package/dist/testing/cassette.js.map

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

package/dist/testing/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./mock-model-provider.js";
+export * from "./mock-tool-invoker.js";
+export * from "./mock-agent-transport.js";
+export * from "./cassette.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC"}

package/dist/testing/index.js

@@ -0,0 +1,5 @@
+export * from "./mock-model-provider.js";
+export * from "./mock-tool-invoker.js";
+export * from "./mock-agent-transport.js";
+export * from "./cassette.js";
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC"}