@studio-foundation/runner 0.3.0-beta.1

package/dist/providers/openai-responses.js

@@ -0,0 +1,175 @@
+"use strict";
+/**
+ * OpenAI Responses API provider — supports models only available on /v1/responses
+ * (e.g. gpt-5.1-codex-mini).
+ *
+ * Implements AgentLoopProvider to own the multi-turn tool-calling loop,
+ * because the Responses API uses typed function_call / function_call_output
+ * items that cannot be expressed as plain text messages.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIResponsesProvider = void 0;
+const openai_1 = __importDefault(require("openai"));
+class OpenAIResponsesProvider {
+    name = 'openai-responses';
+    client;
+    constructor(apiKey) {
+        this.client = new openai_1.default({ apiKey: apiKey || process.env.OPENAI_API_KEY });
+    }
+    // Satisfy Provider interface for simple (no-tool) calls
+    async call(request, _onToken, signal) {
+        const input = messagesToInput(request.messages);
+        const response = await this.client.responses.create({
+            model: request.model,
+            input,
+            temperature: request.temperature,
+            max_output_tokens: request.max_tokens ?? undefined,
+        }, { signal });
+        // NOTE: call() is for tool-free requests only.
+        // Tool calls in the response are intentionally discarded.
+        // For agentic tool-calling, use runAgentLoop() instead.
+        return {
+            content: response.output_text ?? '',
+            tool_calls: [],
+            finish_reason: 'stop',
+            usage: response.usage
+                ? {
+                    prompt_tokens: response.usage.input_tokens,
+                    completion_tokens: response.usage.output_tokens,
+                    total_tokens: response.usage.total_tokens,
+                }
+                : undefined,
+        };
+    }
+    async runAgentLoop(request, executeTool, onToken, signal) {
+        const tools = (request.tools ?? []).map(t => ({
+            type: 'function',
+            name: t.name,
+            description: t.description ?? null,
+            parameters: t.parameters,
+            strict: null,
+        }));
+        let input = messagesToInput(request.messages);
+        const allToolCalls = [];
+        const tokenAccumulator = { prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 };
+        const MAX_ITERATIONS = 20;
+        for (let i = 0; i < MAX_ITERATIONS; i++) {
+            if (signal?.aborted) {
+                throw new DOMException('The operation was aborted', 'AbortError');
+            }
+            let outputItems;
+            let responseText = '';
+            if (onToken) {
+                // Streaming path — emit text deltas as they arrive, then get the completed response
+                const stream = this.client.responses.stream({
+                    model: request.model,
+                    input,
+                    tools: tools.length > 0 ? tools : undefined,
+                    temperature: request.temperature,
+                    max_output_tokens: request.max_tokens ?? undefined,
+                });
+                for await (const event of stream) {
+                    if (event.type === 'response.output_text.delta') {
+                        onToken(event.delta);
+                        responseText += event.delta;
+                    }
+                }
+                const finalResponse = await stream.finalResponse();
+                if (finalResponse.usage) {
+                    tokenAccumulator.prompt_tokens += finalResponse.usage.input_tokens;
+                    tokenAccumulator.completion_tokens += finalResponse.usage.output_tokens;
+                    tokenAccumulator.total_tokens += finalResponse.usage.total_tokens;
+                }
+                outputItems = finalResponse.output;
+                // Find all function calls in the output
+                const functionCalls = outputItems.filter((item) => item.type === 'function_call');
+                if (functionCalls.length === 0) {
+                    // No tool calls — done
+                    return {
+                        content: responseText,
+                        tool_calls: allToolCalls,
+                        finish_reason: 'stop',
+                        usage: tokenAccumulator.total_tokens > 0 ? tokenAccumulator : undefined,
+                    };
+                }
+                // Execute all tool calls
+                const toolOutputs = [];
+                for (const fc of functionCalls) {
+                    const args = JSON.parse(fc.arguments);
+                    const outcome = await executeTool(fc.name, args, fc.call_id);
+                    allToolCalls.push({ id: fc.call_id, name: fc.name, arguments: args, ...outcome });
+                    toolOutputs.push({
+                        type: 'function_call_output',
+                        call_id: fc.call_id,
+                        output: outcome.error ? `Error: ${outcome.error}` : JSON.stringify(outcome.result),
+                    });
+                }
+                // Extend input: previous input + this response's output items + tool results
+                // ResponseOutputItem is a subset of the ResponseInputItem union, so the cast is safe
+                input = [
+                    ...input,
+                    ...outputItems,
+                    ...toolOutputs,
+                ];
+            }
+            else {
+                // Non-streaming path
+                const response = await this.client.responses.create({
+                    model: request.model,
+                    input,
+                    tools: tools.length > 0 ? tools : undefined,
+                    temperature: request.temperature,
+                    max_output_tokens: request.max_tokens ?? undefined,
+                }, { signal });
+                if (response.usage) {
+                    tokenAccumulator.prompt_tokens += response.usage.input_tokens;
+                    tokenAccumulator.completion_tokens += response.usage.output_tokens;
+                    tokenAccumulator.total_tokens += response.usage.total_tokens;
+                }
+                // Find all function calls in the output
+                const functionCalls = response.output.filter((item) => item.type === 'function_call');
+                if (functionCalls.length === 0) {
+                    // No tool calls — done
+                    return {
+                        content: response.output_text ?? '',
+                        tool_calls: allToolCalls,
+                        finish_reason: 'stop',
+                        usage: tokenAccumulator.total_tokens > 0 ? tokenAccumulator : undefined,
+                    };
+                }
+                // Execute all tool calls
+                const toolOutputs = [];
+                for (const fc of functionCalls) {
+                    const args = JSON.parse(fc.arguments);
+                    const outcome = await executeTool(fc.name, args, fc.call_id);
+                    allToolCalls.push({ id: fc.call_id, name: fc.name, arguments: args, ...outcome });
+                    toolOutputs.push({
+                        type: 'function_call_output',
+                        call_id: fc.call_id,
+                        output: outcome.error ? `Error: ${outcome.error}` : JSON.stringify(outcome.result),
+                    });
+                }
+                // Extend input: previous input + this response's output items + tool results
+                // ResponseOutputItem is a subset of the ResponseInputItem union, so the cast is safe
+                input = [
+                    ...input,
+                    ...response.output,
+                    ...toolOutputs,
+                ];
+            }
+        }
+        throw new Error(`Maximum tool calling iterations (${MAX_ITERATIONS}) reached.`);
+    }
+}
+exports.OpenAIResponsesProvider = OpenAIResponsesProvider;
+function messagesToInput(messages) {
+    return messages.map(msg => ({
+        type: 'message',
+        role: msg.role,
+        content: msg.content,
+    }));
+}
+//# sourceMappingURL=openai-responses.js.map

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

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

package/dist/providers/openai.d.ts

@@ -0,0 +1,16 @@
+/**
+ * OpenAI provider implementation with full tool calling support
+ */
+import type { LLMRequest, LLMResponse } from '@studio-foundation/contracts';
+import type { Provider } from './provider.js';
+export declare class OpenAIProvider implements Provider {
+    private baseUrl?;
+    readonly name = "openai";
+    private client;
+    constructor(apiKey?: string, baseUrl?: string | undefined);
+    call(request: LLMRequest, onToken?: (token: string) => void, signal?: AbortSignal): Promise<LLMResponse>;
+    private callStreaming;
+    private buildMessages;
+    private buildTools;
+}
+//# sourceMappingURL=openai.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/providers/openai.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAI9C,qBAAa,cAAe,YAAW,QAAQ;IAIhB,OAAO,CAAC,OAAO,CAAC;IAH7C,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,CAAC,EAAE,MAAM,EAAU,OAAO,CAAC,EAAE,MAAM,YAAA;IAO/C,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;YAsChG,aAAa;IA6D3B,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,UAAU;CAUnB"}

package/dist/providers/openai.js

@@ -0,0 +1,132 @@
+"use strict";
+/**
+ * OpenAI provider implementation with full tool calling support
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIProvider = void 0;
+const openai_1 = __importDefault(require("openai"));
+class OpenAIProvider {
+    baseUrl;
+    name = 'openai';
+    client;
+    constructor(apiKey, baseUrl) {
+        this.baseUrl = baseUrl;
+        this.client = new openai_1.default({
+            apiKey: apiKey || process.env.OPENAI_API_KEY,
+            baseURL: baseUrl
+        });
+    }
+    async call(request, onToken, signal) {
+        const openaiMessages = this.buildMessages(request);
+        const tools = this.buildTools(request);
+        if (onToken) {
+            return this.callStreaming(request, openaiMessages, tools, onToken, signal);
+        }
+        // Non-streaming path (existing behavior)
+        const completion = await this.client.chat.completions.create({
+            model: request.model,
+            messages: openaiMessages,
+            tools: tools && tools.length > 0 ? tools : undefined,
+            temperature: request.temperature,
+            max_completion_tokens: request.max_tokens
+        }, { signal });
+        const choice = completion.choices[0];
+        // Extract tool calls if any
+        const tool_calls = choice.message.tool_calls?.map(tc => ({
+            id: tc.id,
+            name: tc.function.name,
+            arguments: JSON.parse(tc.function.arguments)
+        })) || [];
+        return {
+            content: choice.message.content || '',
+            tool_calls,
+            finish_reason: choice.finish_reason,
+            usage: {
+                prompt_tokens: completion.usage?.prompt_tokens || 0,
+                completion_tokens: completion.usage?.completion_tokens || 0,
+                total_tokens: completion.usage?.total_tokens || 0
+            }
+        };
+    }
+    async callStreaming(request, openaiMessages, tools, onToken, signal) {
+        const stream = this.client.chat.completions.create({
+            model: request.model,
+            messages: openaiMessages,
+            tools: tools && tools.length > 0 ? tools : undefined,
+            temperature: request.temperature,
+            max_completion_tokens: request.max_tokens,
+            stream: true,
+            stream_options: { include_usage: true },
+        }, { signal });
+        let textContent = '';
+        const toolCallMap = new Map();
+        let finishReason = 'stop';
+        let usage;
+        for await (const chunk of stream) {
+            // KEY FIX: check signal at the start of each chunk so we don't keep
+            // consuming buffered data after Ctrl-C.
+            if (signal?.aborted)
+                throw new DOMException('Aborted', 'AbortError');
+            const delta = chunk.choices[0]?.delta;
+            if (delta?.content) {
+                textContent += delta.content;
+                onToken(delta.content);
+            }
+            if (delta?.tool_calls) {
+                for (const tc of delta.tool_calls) {
+                    if (!toolCallMap.has(tc.index)) {
+                        toolCallMap.set(tc.index, { id: '', name: '', args: '' });
+                    }
+                    const acc = toolCallMap.get(tc.index);
+                    if (tc.id)
+                        acc.id = tc.id;
+                    if (tc.function?.name)
+                        acc.name += tc.function.name;
+                    if (tc.function?.arguments)
+                        acc.args += tc.function.arguments;
+                }
+            }
+            if (chunk.choices[0]?.finish_reason)
+                finishReason = chunk.choices[0].finish_reason;
+            if (chunk.usage) {
+                usage = {
+                    prompt_tokens: chunk.usage.prompt_tokens,
+                    completion_tokens: chunk.usage.completion_tokens,
+                    total_tokens: chunk.usage.total_tokens,
+                };
+            }
+        }
+        const tool_calls = Array.from(toolCallMap.values()).map(tc => ({
+            id: tc.id,
+            name: tc.name,
+            arguments: JSON.parse(tc.args || '{}'),
+        }));
+        return { content: textContent, tool_calls, finish_reason: finishReason, usage };
+    }
+    buildMessages(request) {
+        return request.messages.map(msg => {
+            if (msg.role === 'system')
+                return { role: 'system', content: msg.content };
+            if (msg.role === 'user')
+                return { role: 'user', content: msg.content };
+            if (msg.role === 'assistant')
+                return { role: 'assistant', content: msg.content };
+            throw new Error(`Unsupported message role: ${msg.role}`);
+        });
+    }
+    buildTools(request) {
+        return request.tools?.map(tool => ({
+            type: 'function',
+            function: {
+                name: tool.name,
+                description: tool.description,
+                parameters: tool.parameters
+            }
+        }));
+    }
+}
+exports.OpenAIProvider = OpenAIProvider;
+//# sourceMappingURL=openai.js.map

package/dist/providers/openai.js.map

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=openai.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openai.test.d.ts","sourceRoot":"","sources":["../../src/providers/openai.test.ts"],"names":[],"mappings":""}

package/dist/providers/openai.test.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const openai_js_1 = require("./openai.js");
+// Fake async iterable that yields chunks with a delay between each,
+// simulating a slow stream that should be interruptible.
+async function* slowStream(chunks, delayMs = 10) {
+    for (const chunk of chunks) {
+        await new Promise((r) => setTimeout(r, delayMs));
+        yield chunk;
+    }
+}
+vitest_1.vi.mock('openai', () => {
+    return {
+        default: class FakeOpenAI {
+            chat = {
+                completions: {
+                    create: (_params, _opts) => slowStream([
+                        { choices: [{ delta: { content: 'hello' }, finish_reason: null }] },
+                        { choices: [{ delta: { content: ' world' }, finish_reason: 'stop' }] },
+                    ]),
+                },
+            };
+        },
+    };
+});
+(0, vitest_1.describe)('OpenAIProvider', () => {
+    (0, vitest_1.it)('aborts streaming when signal fires mid-iteration', async () => {
+        const provider = new openai_js_1.OpenAIProvider('test-key');
+        const controller = new AbortController();
+        const onToken = vitest_1.vi.fn();
+        const callPromise = provider.call({
+            model: 'gpt-4o',
+            messages: [{ role: 'user', content: 'hi' }],
+        }, onToken, controller.signal);
+        // Abort after first chunk has a chance to arrive
+        setTimeout(() => controller.abort(), 5);
+        await (0, vitest_1.expect)(callPromise).rejects.toSatisfy((e) => e instanceof DOMException && e.name === 'AbortError');
+    });
+    (0, vitest_1.it)('completes normally when signal is not aborted', async () => {
+        const provider = new openai_js_1.OpenAIProvider('test-key');
+        const onToken = vitest_1.vi.fn();
+        const result = await provider.call({
+            model: 'gpt-4o',
+            messages: [{ role: 'user', content: 'hi' }],
+        }, onToken);
+        (0, vitest_1.expect)(result.content).toBe('hello world');
+        (0, vitest_1.expect)(onToken).toHaveBeenCalledTimes(2);
+    });
+});
+//# sourceMappingURL=openai.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openai.test.js","sourceRoot":"","sources":["../../src/providers/openai.test.ts"],"names":[],"mappings":";;AAAA,mCAAkD;AAClD,2CAA6C;AAE7C,oEAAoE;AACpE,yDAAyD;AACzD,KAAK,SAAS,CAAC,CAAC,UAAU,CAAC,MAAiB,EAAE,OAAO,GAAG,EAAE;IACxD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QACjD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,WAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE;IACrB,OAAO;QACL,OAAO,EAAE,MAAM,UAAU;YACvB,IAAI,GAAG;gBACL,WAAW,EAAE;oBACX,MAAM,EAAE,CAAC,OAAgB,EAAE,KAA+B,EAAE,EAAE,CAC5D,UAAU,CAAC;wBACT,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE;wBACnE,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,EAAE;qBACvE,CAAC;iBACL;aACF,CAAC;SACH;KACF,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,IAAA,WAAE,EAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,QAAQ,GAAG,IAAI,0BAAc,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,WAAE,CAAC,EAAE,EAAE,CAAC;QAExB,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAC/B;YACE,KAAK,EAAE,QAAQ;YACf,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;SAC5C,EACD,OAAO,EACP,UAAU,CAAC,MAAM,CAClB,CAAC;QAEF,iDAAiD;QACjD,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;QAExC,MAAM,IAAA,eAAM,EAAC,WAAW,CAAC,CAAC,OAAO,CAAC,SAAS,CACzC,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,YAAY,YAAY,IAAK,CAAkB,CAAC,IAAI,KAAK,YAAY,CACvF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,QAAQ,GAAG,IAAI,0BAAc,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,WAAE,CAAC,EAAE,EAAE,CAAC;QAExB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAChC;YACE,KAAK,EAAE,QAAQ;YACf,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;SAC5C,EACD,OAAO,CACR,CAAC;QAEF,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC3C,IAAA,eAAM,EAAC,OAAO,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/providers/provider.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Provider interface - aligned with @studio/contracts
+ */
+import type { LLMRequest, LLMResponse } from '@studio-foundation/contracts';
+export interface Provider {
+    readonly name: string;
+    call(request: LLMRequest, onToken?: (token: string) => void, signal?: AbortSignal): Promise<LLMResponse>;
+}
+export interface ToolCallOutcome {
+    result?: unknown;
+    error?: string;
+}
+/**
+ * Extended interface for providers that own the full agent loop.
+ * Used by providers (e.g. OpenAI Responses API) where multi-turn
+ * tool calling cannot be expressed as plain text messages.
+ */
+export interface AgentLoopProvider extends Provider {
+    runAgentLoop(request: LLMRequest, executeTool: (name: string, args: Record<string, unknown>, callId: string) => Promise<ToolCallOutcome>, onToken?: (token: string) => void, signal?: AbortSignal): Promise<AgentLoopResult>;
+}
+/**
+ * Full result of an agent loop execution.
+ * Distinct from LLMResponse (in @studio/contracts) because it includes
+ * per-tool-call execution outcomes (result/error) that are only known
+ * after the runner has actually invoked each tool.
+ */
+export interface AgentLoopResult {
+    content: string;
+    tool_calls: Array<{
+        id: string;
+        name: string;
+        arguments: Record<string, unknown>;
+    } & ToolCallOutcome>;
+    finish_reason: string;
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+export declare function isAgentLoopProvider(p: Provider): p is AgentLoopProvider;
+//# sourceMappingURL=provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/providers/provider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE5E,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC1G;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAkB,SAAQ,QAAQ;IACjD,YAAY,CACV,OAAO,EAAE,UAAU,EACnB,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,EACtG,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,EACjC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,eAAe,CAAC,CAAC;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,KAAK,CAAC;QAChB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GAAG,eAAe,CAAC,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE;QACN,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,IAAI,iBAAiB,CAEvE"}

package/dist/providers/provider.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Provider interface - aligned with @studio/contracts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAgentLoopProvider = isAgentLoopProvider;
+function isAgentLoopProvider(p) {
+    return typeof p.runAgentLoop === 'function';
+}
+//# sourceMappingURL=provider.js.map

package/dist/providers/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/providers/provider.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAiDH,kDAEC;AAFD,SAAgB,mBAAmB,CAAC,CAAW;IAC7C,OAAO,OAAQ,CAAuB,CAAC,YAAY,KAAK,UAAU,CAAC;AACrE,CAAC"}

package/dist/providers/registry.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Provider registry - factory for LLM providers
+ */
+import type { Provider } from './provider.js';
+export declare class ProviderRegistry {
+    private providers;
+    /**
+     * Register a provider instance
+     */
+    register(provider: Provider): void;
+    /**
+     * Get provider by name
+     */
+    get(name: string): Provider;
+    /**
+     * Check if provider exists
+     */
+    has(name: string): boolean;
+    /**
+     * List available provider names
+     */
+    list(): string[];
+}
+/**
+ * Factory function to create a registry with default providers
+ */
+export declare function createDefaultRegistry(config: {
+    openai?: {
+        apiKey: string;
+        baseUrl?: string;
+    };
+    anthropic?: {
+        apiKey: string;
+    };
+    openaiResponses?: {
+        apiKey: string;
+    };
+    ollama?: {
+        baseUrl?: string;
+    };
+}): ProviderRegistry;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAM9C,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAoC;IAErD;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAIlC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAU3B;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,IAAI,IAAI,MAAM,EAAE;CAGjB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,MAAM,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,SAAS,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,eAAe,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/B,GAAG,gBAAgB,CAoBnB"}

package/dist/providers/registry.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * Provider registry - factory for LLM providers
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProviderRegistry = void 0;
+exports.createDefaultRegistry = createDefaultRegistry;
+const openai_js_1 = require("./openai.js");
+const anthropic_js_1 = require("./anthropic.js");
+const openai_responses_js_1 = require("./openai-responses.js");
+const ollama_js_1 = require("./ollama.js");
+class ProviderRegistry {
+    providers = new Map();
+    /**
+     * Register a provider instance
+     */
+    register(provider) {
+        this.providers.set(provider.name, provider);
+    }
+    /**
+     * Get provider by name
+     */
+    get(name) {
+        const provider = this.providers.get(name);
+        if (!provider) {
+            const available = this.list();
+            const detail = available.length > 0 ? available.join(', ') : '(none registered)';
+            throw new Error(`Provider not found: ${name}. Available providers: ${detail}`);
+        }
+        return provider;
+    }
+    /**
+     * Check if provider exists
+     */
+    has(name) {
+        return this.providers.has(name);
+    }
+    /**
+     * List available provider names
+     */
+    list() {
+        return Array.from(this.providers.keys());
+    }
+}
+exports.ProviderRegistry = ProviderRegistry;
+/**
+ * Factory function to create a registry with default providers
+ */
+function createDefaultRegistry(config) {
+    const registry = new ProviderRegistry();
+    if (config.openai) {
+        registry.register(new openai_js_1.OpenAIProvider(config.openai.apiKey, config.openai.baseUrl));
+    }
+    if (config.anthropic) {
+        registry.register(new anthropic_js_1.AnthropicProvider(config.anthropic.apiKey));
+    }
+    if (config.openaiResponses) {
+        registry.register(new openai_responses_js_1.OpenAIResponsesProvider(config.openaiResponses.apiKey));
+    }
+    if (config.ollama) {
+        registry.register(new ollama_js_1.OllamaProvider(config.ollama.baseUrl));
+    }
+    return registry;
+}
+//# sourceMappingURL=registry.js.map

package/dist/providers/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAiDH,sDAyBC;AAvED,2CAA6C;AAC7C,iDAAmD;AACnD,+DAAgE;AAChE,2CAA6C;AAE7C,MAAa,gBAAgB;IACnB,SAAS,GAA0B,IAAI,GAAG,EAAE,CAAC;IAErD;;OAEG;IACH,QAAQ,CAAC,QAAkB;QACzB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC;YACjF,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,0BAA0B,MAAM,EAAE,CAAC,CAAC;QACjF,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;CACF;AApCD,4CAoCC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,MAKrC;IACC,MAAM,QAAQ,GAAG,IAAI,gBAAgB,EAAE,CAAC;IAExC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,QAAQ,CAAC,QAAQ,CAAC,IAAI,0BAAc,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACrF,CAAC;IAED,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,QAAQ,CAAC,QAAQ,CAAC,IAAI,gCAAiB,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QAC3B,QAAQ,CAAC,QAAQ,CAAC,IAAI,6CAAuB,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;IAChF,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,QAAQ,CAAC,QAAQ,CAAC,IAAI,0BAAc,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/runner.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Main agent runner function - executes agent with LLM + tools
+ */
+import type { ResolvedAgentConfig, ToolCall, LLMResponse, OutputContract, RunnerCallbacks } from '@studio-foundation/contracts';
+import { type TaskInput, type AgentContext, type ExecutionContext } from './prompt-builder.js';
+import type { ToolRegistry } from './tools/tool-registry.js';
+import type { ProviderRegistry } from './providers/registry.js';
+import type { AnonymizationMiddleware } from './middleware/anonymization.js';
+export interface RunAgentConfig {
+    agent: ResolvedAgentConfig;
+    task: TaskInput;
+    context: AgentContext;
+    executionContext?: ExecutionContext;
+    toolRegistry: ToolRegistry;
+    providerRegistry: ProviderRegistry;
+    outputContract?: OutputContract;
+    maxToolCalls?: number;
+    anonymizationMiddleware?: AnonymizationMiddleware;
+    callbacks?: RunnerCallbacks;
+    signal?: AbortSignal;
+}
+export interface AgentRunResult {
+    output: unknown;
+    tool_calls: ToolCall[];
+    tool_calls_count: number;
+    raw_response?: LLMResponse;
+    duration_ms: number;
+    token_usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+    /** Set when the runner hit a terminal error (e.g. max tool iterations). RALPH treats this as a validation failure. */
+    error?: string;
+}
+/**
+ * Run an agent task with LLM + tool execution
+ *
+ * Flow:
+ * 1. Build prompt with context + retry info
+ * 2. Call LLM provider
+ * 3. Execute tool calls (multi-turn loop)
+ * 4. Return complete result with tracked tool calls
+ */
+export declare function runAgent(config: RunAgentConfig): Promise<AgentRunResult>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,WAAW,EAAW,cAAc,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACzI,OAAO,EAAe,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAE7E,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,mBAAmB,CAAC;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,YAAY,CAAC;IACtB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,YAAY,EAAE,YAAY,CAAC;IAC3B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;IAClD,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,QAAQ,EAAE,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE;QACZ,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,sHAAsH;IACtH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CA6T9E"}