@studio-foundation/runner 0.3.0-beta.1

package/dist/prompt-builder.js

@@ -0,0 +1,263 @@
+"use strict";
+/**
+ * Prompt builder - constructs messages for LLM with retry escalation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildPrompt = buildPrompt;
+/**
+ * Build prompt messages with retry escalation support
+ */
+function buildPrompt(config) {
+    const { agent, task, context, executionContext } = config;
+    const messages = [];
+    // Build system message
+    let systemContent = agent.system_prompt || 'You are a helpful AI assistant.';
+    // Add output format with concrete schema when available
+    const contract = config.outputContract;
+    if (contract?.schema?.required_fields?.length) {
+        const fields = contract.schema.required_fields;
+        const requiresToolCalls = (contract.tool_calls?.minimum ?? 0) > 0;
+        systemContent += `
+
+## REQUIRED OUTPUT FORMAT
+
+You MUST ${requiresToolCalls ? 'end with' : 'respond with'} a valid JSON object. ${requiresToolCalls ? 'Your final message (after all tool calls)' : 'Your entire response'} must be parseable JSON — no markdown, no code blocks, no explanatory text${requiresToolCalls ? ' in that final message' : ' before or after'}.
+
+The JSON object MUST contain these fields:
+${fields.map((f) => `- "${f}" — ${getFieldTypeHint(f)}`).join('\n')}
+
+Example structure:
+{
+${fields.map((f) => `  "${f}": ${getFieldExample(f)}`).join(',\n')}
+}
+
+CRITICAL: If your response is not valid JSON with ALL required fields, it will be rejected and you will be asked to retry.
+Pay attention to field types: arrays must be arrays, objects must be objects. Do NOT flatten structured fields into plain strings.`;
+        // Inject accepted values for rejection detection fields
+        const rd = contract.post_validation?.rejection_detection;
+        if (rd?.field && rd?.approved_values?.length) {
+            systemContent += `
+
+The "${rd.field}" field MUST be one of: ${rd.approved_values.map((v) => `"${v}"`).join(', ')}.
+Any other value means rejection.`;
+        }
+    }
+    else if (task.contract_name || task.expected_output) {
+        systemContent += `
+
+## Output Format
+
+${task.expected_output || `Provide your response according to the ${task.contract_name} contract.`}
+`;
+    }
+    // Inject prompt snippets from active tool plugins
+    if (config.promptSnippets && config.promptSnippets.length > 0) {
+        systemContent += '\n\n' + config.promptSnippets.join('\n\n');
+    }
+    // Inject skills (.studio/skills/*.skill.md) declared by the agent
+    if (config.skills && config.skills.length > 0) {
+        const skillChunks = config.skills.map(s => `## Skill: ${s.name}\n\n${s.content}`);
+        systemContent += '\n\n' + skillChunks.join('\n\n---\n\n');
+    }
+    messages.push({
+        role: 'system',
+        content: systemContent
+    });
+    // Build user message with context
+    let userContent = '';
+    // Group feedback FIRST — must be the most prominent thing the model sees
+    if (context.group_feedback) {
+        const fb = context.group_feedback;
+        userContent += `## ⚠️ REVISION REQUIRED — Iteration ${fb.iteration + 1}/${fb.max_iterations}\n\n`;
+        userContent += `Your previous implementation was **REJECTED**. You MUST address ALL issues below before proceeding.\n\n`;
+        userContent += `**Reason:** ${fb.rejection_reason}\n\n`;
+        if (fb.rejection_details?.length) {
+            userContent += `**Issues to fix:**\n`;
+            for (const detail of fb.rejection_details) {
+                userContent += `- ${detail}\n`;
+            }
+            userContent += '\n';
+        }
+        userContent += `DO NOT repeat the same approach. Each issue above MUST be resolved in your new implementation.\n\n---\n\n`;
+    }
+    // Add previous outputs if any
+    if (context.previous_outputs && Object.keys(context.previous_outputs).length > 0) {
+        userContent += '## Previous Stage Outputs\n\n';
+        for (const [stage, output] of Object.entries(context.previous_outputs)) {
+            userContent += `### ${stage}\n\`\`\`json\n${JSON.stringify(output, null, 2)}\n\`\`\`\n\n`;
+        }
+    }
+    // Add repository context if provided
+    if (context.repo_files && context.repo_files.length > 0) {
+        userContent += `## Repository Files\n\nRelevant files:\n${context.repo_files.map(f => `- ${f}`).join('\n')}\n\n`;
+    }
+    // Add additional context
+    if (context.additional_context) {
+        userContent += `## Additional Context\n\n${context.additional_context}\n\n`;
+    }
+    // Add stage name (used in parallel groups so agents can identify their slot)
+    if (context.stage_name) {
+        userContent += `## Stage Name\n\n${context.stage_name}\n\n`;
+    }
+    // Render pipeline startup context — each key as a ### section
+    if (context.startup_context && Object.keys(context.startup_context).length > 0) {
+        userContent += '## Pipeline Startup Context\n\n';
+        for (const [key, value] of Object.entries(context.startup_context)) {
+            userContent += `### ${key}\n\`\`\`\n${value}\n\`\`\`\n\n`;
+        }
+    }
+    // Add context packs — each as a top-level ## section, sections as ###
+    if (context.context_packs?.length) {
+        for (const pack of context.context_packs) {
+            userContent += `## ${pack.name}`;
+            if (pack.description)
+                userContent += ` — ${pack.description}`;
+            userContent += '\n\n';
+            for (const section of pack.sections) {
+                userContent += `### ${section.title}\n\n${section.content}\n\n`;
+            }
+        }
+    }
+    // Add previous stage tool results (discoveries) — placed last before the task
+    // so they have high recency salience for the LLM
+    if (context.previous_tool_results && Object.keys(context.previous_tool_results).length > 0) {
+        userContent += renderToolResults(context.previous_tool_results);
+    }
+    // Add task description
+    userContent += `## Task\n\n${task.description}`;
+    // Add retry escalation if this is a retry attempt
+    if (executionContext && executionContext.attempt > 1) {
+        userContent += getRetryEscalationMessage(executionContext);
+    }
+    messages.push({
+        role: 'user',
+        content: userContent
+    });
+    return messages;
+}
+/**
+ * Get retry escalation message based on attempt number
+ * Progressively stronger messaging to enforce tool usage
+ */
+function getRetryEscalationMessage(executionContext) {
+    const { attempt, previous_failures } = executionContext;
+    let message = '\n\n---\n\n';
+    const hasStringError = previous_failures?.some(f => f.error.includes('Expected object output, got string'));
+    const hasMissingTool = previous_failures?.some(f => f.error.includes('Required tool'));
+    if (attempt === 2) {
+        message += `⚠️ **RETRY ATTEMPT ${attempt}**
+
+Your previous attempt failed. Please review the errors below and fix the issues:
+
+`;
+        previous_failures?.forEach((failure, idx) => {
+            message += `Attempt ${idx + 1}: ${failure.error}\n`;
+            if (failure.tool_calls_count === 0) {
+                message += `  → Problem: No tool calls were made. You need to use the available tools.\n`;
+            }
+        });
+        if (hasStringError) {
+            message += `\n⚠️ Your response was plain text, not JSON. Your FINAL message (after all tool calls) must be ONLY a raw JSON object — no explanations, no markdown.`;
+        }
+        if (hasMissingTool) {
+            message += `\n⚠️ You must use the required tools to make the actual changes, not just read or explore.`;
+        }
+        message += `\nMake sure to use the tools available to you to complete the task.`;
+    }
+    else if (attempt === 3) {
+        message += `🚨 **CRITICAL: RETRY ATTEMPT ${attempt}**
+
+Multiple previous attempts have failed. This is your ${attempt}rd attempt.
+
+Previous errors:
+`;
+        previous_failures?.forEach((failure, idx) => {
+            message += `- Attempt ${idx + 1}: ${failure.error} (tool_calls: ${failure.tool_calls_count})\n`;
+        });
+        message += `
+**YOU MUST:**
+1. Use the available tools to make the requested changes — reading and exploring is NOT enough
+2. After all tool calls are done, send ONE final message that is ONLY a raw JSON object
+3. No markdown, no explanations, no code fences — just {"summary": "...", ...}
+
+DO NOT just provide instructions or descriptions. EXECUTE the changes, then return JSON.`;
+    }
+    else if (attempt >= 4) {
+        message += `⛔ **FINAL WARNING: RETRY ATTEMPT ${attempt}**
+
+This is attempt ${attempt}. Previous attempts all failed:
+
+`;
+        previous_failures?.forEach((failure, idx) => {
+            message += `Attempt ${idx + 1}:\n  Error: ${failure.error}\n  Tool calls made: ${failure.tool_calls_count}\n\n`;
+        });
+        message += `
+🔴 **ABSOLUTE REQUIREMENTS:**
+
+1. Use the required tools to make the actual changes — DO NOT just describe them
+2. tool_calls = 0 is an AUTOMATIC FAILURE
+3. You must make ACTUAL changes, not describe them
+4. Read existing files before modifying them
+5. Your FINAL message must be ONLY a JSON object
+6. If your final message contains ANY text outside the JSON, it WILL be rejected
+
+If you do not make real tool calls AND return valid JSON, this task will fail permanently.`;
+    }
+    return message;
+}
+/** Known field type hints for required_fields schema injection */
+const FIELD_TYPE_HINTS = {
+    summary: 'string',
+    requirements: 'array of objects, each with relevant keys (e.g. {id, description, priority})',
+    acceptance_criteria: 'array of strings',
+    files_changed: 'array of objects with {path, status, changes}',
+    files_to_modify: 'array of strings (file paths)',
+    steps: 'array of strings',
+    issues: 'array of strings or objects',
+};
+/** Known field example values for required_fields schema injection */
+const FIELD_EXAMPLES = {
+    summary: '"A concise summary of the result"',
+    requirements: '[{"id": "REQ-1", "description": "...", "priority": "high"}]',
+    acceptance_criteria: '["criterion 1", "criterion 2"]',
+    files_changed: '[{"path": "src/file.tsx", "status": "modified", "changes": "description of changes"}]',
+    files_to_modify: '["src/file.tsx", "src/utils/helper.ts"]',
+    steps: '["step 1", "step 2", "step 3"]',
+    issues: '["issue 1", "issue 2"]',
+};
+const TOOL_RESULT_MAX_CHARS = 2000;
+function renderToolResults(previous_tool_results) {
+    let out = '';
+    for (const [stage, toolCalls] of Object.entries(previous_tool_results)) {
+        out += `## Previous Stage Discoveries (${stage})\n\n`;
+        for (const tc of toolCalls) {
+            // Use first string argument value as the display label
+            const label = Object.values(tc.arguments).find(v => typeof v === 'string') ?? JSON.stringify(tc.arguments);
+            out += `### ${tc.name}(${label})\n`;
+            if (tc.error) {
+                out += `Error: ${tc.error}\n\n`;
+            }
+            else {
+                // For write operations, render the content being written from arguments
+                // (the result is just {written: true} which is not useful for reviewers).
+                // For all other operations, render the result as usual.
+                const writeContent = typeof tc.arguments?.content === 'string'
+                    ? tc.arguments.content
+                    : null;
+                const raw = writeContent ?? JSON.stringify(tc.result, null, 2);
+                const body = raw.length > TOOL_RESULT_MAX_CHARS
+                    ? raw.slice(0, TOOL_RESULT_MAX_CHARS) + '\n[truncated]'
+                    : raw;
+                out += `\`\`\`\n${body}\n\`\`\`\n\n`;
+            }
+        }
+    }
+    return out;
+}
+function getFieldTypeHint(field) {
+    return FIELD_TYPE_HINTS[field] || 'string';
+}
+function getFieldExample(field) {
+    return FIELD_EXAMPLES[field] || '"..."';
+}
+//# sourceMappingURL=prompt-builder.js.map

package/dist/prompt-builder.js.map

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

package/dist/prompt-builder.test.d.ts

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

package/dist/prompt-builder.test.d.ts.map

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

package/dist/prompt-builder.test.js

@@ -0,0 +1,154 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const prompt_builder_js_1 = require("./prompt-builder.js");
+const AGENT = {
+    name: 'test-agent',
+    provider: 'anthropic',
+    model: 'claude-haiku-4-5-20251001',
+    system_prompt: 'You are a helpful assistant.',
+};
+const TASK = { description: 'Do the thing.' };
+(0, vitest_1.describe)('buildPrompt — previous_tool_results', () => {
+    (0, vitest_1.it)('renders write_file content from tc.arguments.content', () => {
+        const messages = (0, prompt_builder_js_1.buildPrompt)({
+            agent: AGENT,
+            task: TASK,
+            context: {
+                previous_tool_results: {
+                    'code-generation': [
+                        {
+                            id: '1',
+                            name: 'repo_manager-write_file',
+                            arguments: { path: 'src/foo.ts', content: 'const x = 1;' },
+                            result: { written: true },
+                        },
+                    ],
+                },
+            },
+        });
+        const userMsg = messages.find(m => m.role === 'user').content;
+        (0, vitest_1.expect)(userMsg).toContain('Previous Stage Discoveries (code-generation)');
+        (0, vitest_1.expect)(userMsg).toContain('const x = 1;');
+        // Should NOT show the useless {written: true} result as the body
+        (0, vitest_1.expect)(userMsg).not.toContain('"written": true');
+    });
+    (0, vitest_1.it)('renders read_file content from tc.result', () => {
+        const messages = (0, prompt_builder_js_1.buildPrompt)({
+            agent: AGENT,
+            task: TASK,
+            context: {
+                previous_tool_results: {
+                    'brief-analysis': [
+                        {
+                            id: '1',
+                            name: 'repo_manager-read_file',
+                            arguments: { path: 'src/foo.ts' },
+                            result: { path: 'src/foo.ts', content: 'const y = 2;' },
+                        },
+                    ],
+                },
+            },
+        });
+        const userMsg = messages.find(m => m.role === 'user').content;
+        (0, vitest_1.expect)(userMsg).toContain('Previous Stage Discoveries (brief-analysis)');
+        (0, vitest_1.expect)(userMsg).toContain('const y = 2;');
+    });
+    (0, vitest_1.it)('omits the section when previous_tool_results is absent', () => {
+        const messages = (0, prompt_builder_js_1.buildPrompt)({ agent: AGENT, task: TASK, context: {} });
+        const userMsg = messages.find(m => m.role === 'user').content;
+        (0, vitest_1.expect)(userMsg).not.toContain('Previous Stage Discoveries');
+    });
+});
+(0, vitest_1.describe)('buildPrompt — startup_context', () => {
+    (0, vitest_1.it)('renders each startup_context key as a ### section under ## Pipeline Startup Context', () => {
+        const messages = (0, prompt_builder_js_1.buildPrompt)({
+            agent: AGENT,
+            task: TASK,
+            context: {
+                startup_context: {
+                    git_status: 'M src/foo.ts',
+                    recent_commits: 'abc123 feat: stuff',
+                },
+            },
+        });
+        const userMsg = messages.find(m => m.role === 'user').content;
+        (0, vitest_1.expect)(userMsg).toContain('## Pipeline Startup Context');
+        (0, vitest_1.expect)(userMsg).toContain('### git_status');
+        (0, vitest_1.expect)(userMsg).toContain('M src/foo.ts');
+        (0, vitest_1.expect)(userMsg).toContain('### recent_commits');
+        (0, vitest_1.expect)(userMsg).toContain('abc123 feat: stuff');
+    });
+    (0, vitest_1.it)('omits the section when startup_context is absent', () => {
+        const messages = (0, prompt_builder_js_1.buildPrompt)({
+            agent: AGENT,
+            task: TASK,
+            context: {},
+        });
+        const userMsg = messages.find(m => m.role === 'user').content;
+        (0, vitest_1.expect)(userMsg).not.toContain('Pipeline Startup Context');
+    });
+    (0, vitest_1.it)('omits the section when startup_context is empty', () => {
+        const messages = (0, prompt_builder_js_1.buildPrompt)({
+            agent: AGENT,
+            task: TASK,
+            context: { startup_context: {} },
+        });
+        const userMsg = messages.find(m => m.role === 'user').content;
+        (0, vitest_1.expect)(userMsg).not.toContain('Pipeline Startup Context');
+    });
+});
+(0, vitest_1.describe)('buildPrompt — skills injection', () => {
+    (0, vitest_1.it)('injects a single skill into the system prompt', () => {
+        const skills = [
+            { name: 'commit-conventions', content: '# Commit Conventions\n\nUse conventional commits.' },
+        ];
+        const messages = (0, prompt_builder_js_1.buildPrompt)({ agent: AGENT, task: TASK, context: {}, skills });
+        const sysMsg = messages.find(m => m.role === 'system').content;
+        (0, vitest_1.expect)(sysMsg).toContain('## Skill: commit-conventions');
+        (0, vitest_1.expect)(sysMsg).toContain('Use conventional commits.');
+    });
+    (0, vitest_1.it)('injects multiple skills separated by ---', () => {
+        const skills = [
+            { name: 'commit-conventions', content: 'Commit content.' },
+            { name: 'react-patterns', content: 'React content.' },
+        ];
+        const messages = (0, prompt_builder_js_1.buildPrompt)({ agent: AGENT, task: TASK, context: {}, skills });
+        const sysMsg = messages.find(m => m.role === 'system').content;
+        (0, vitest_1.expect)(sysMsg).toContain('## Skill: commit-conventions');
+        (0, vitest_1.expect)(sysMsg).toContain('## Skill: react-patterns');
+        (0, vitest_1.expect)(sysMsg).toContain('---');
+    });
+    (0, vitest_1.it)('omits skill section when skills array is empty', () => {
+        const messages = (0, prompt_builder_js_1.buildPrompt)({ agent: AGENT, task: TASK, context: {}, skills: [] });
+        const sysMsg = messages.find(m => m.role === 'system').content;
+        (0, vitest_1.expect)(sysMsg).not.toContain('## Skill:');
+    });
+    (0, vitest_1.it)('omits skill section when skills is not provided', () => {
+        const messages = (0, prompt_builder_js_1.buildPrompt)({ agent: AGENT, task: TASK, context: {} });
+        const sysMsg = messages.find(m => m.role === 'system').content;
+        (0, vitest_1.expect)(sysMsg).not.toContain('## Skill:');
+    });
+});
+(0, vitest_1.describe)('buildPrompt — stage_name', () => {
+    (0, vitest_1.it)('renders ## Stage Name section when stage_name is provided', () => {
+        const messages = (0, prompt_builder_js_1.buildPrompt)({
+            agent: AGENT,
+            task: TASK,
+            context: { stage_name: 'recipe-1' },
+        });
+        const userMsg = messages.find(m => m.role === 'user').content;
+        (0, vitest_1.expect)(userMsg).toContain('## Stage Name');
+        (0, vitest_1.expect)(userMsg).toContain('recipe-1');
+    });
+    (0, vitest_1.it)('does not render ## Stage Name when stage_name is absent', () => {
+        const messages = (0, prompt_builder_js_1.buildPrompt)({
+            agent: AGENT,
+            task: TASK,
+            context: {},
+        });
+        const userMsg = messages.find(m => m.role === 'user').content;
+        (0, vitest_1.expect)(userMsg).not.toContain('## Stage Name');
+    });
+});
+//# sourceMappingURL=prompt-builder.test.js.map

package/dist/prompt-builder.test.js.map

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

package/dist/providers/anthropic.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Anthropic provider implementation with full tool calling support
+ */
+import type { LLMRequest, LLMResponse } from '@studio-foundation/contracts';
+import type { Provider } from './provider.js';
+export declare class AnthropicProvider implements Provider {
+    readonly name = "anthropic";
+    private client;
+    constructor(apiKey?: string);
+    call(request: LLMRequest, onToken?: (token: string) => void, signal?: AbortSignal): Promise<LLMResponse>;
+    private buildParams;
+    private parseResponse;
+}
+//# sourceMappingURL=anthropic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/providers/anthropic.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;AAU9C,qBAAa,iBAAkB,YAAW,QAAQ;IAChD,QAAQ,CAAC,IAAI,eAAe;IAC5B,OAAO,CAAC,MAAM,CAAY;gBAEd,MAAM,CAAC,EAAE,MAAM;IAMrB,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;IAsB9G,OAAO,CAAC,WAAW;IAkDnB,OAAO,CAAC,aAAa;CAqCtB"}

package/dist/providers/anthropic.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * Anthropic 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.AnthropicProvider = void 0;
+const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
+const race_signal_js_1 = require("../utils/race-signal.js");
+class AnthropicProvider {
+    name = 'anthropic';
+    client;
+    constructor(apiKey) {
+        this.client = new sdk_1.default({
+            apiKey: apiKey || process.env.ANTHROPIC_API_KEY
+        });
+    }
+    async call(request, onToken, signal) {
+        const params = this.buildParams(request);
+        if (onToken) {
+            // Streaming path
+            const stream = this.client.messages.stream(params, { signal });
+            stream.on('text', (textDelta) => {
+                if (signal?.aborted)
+                    return; // guard: don't emit after abort
+                onToken(textDelta);
+            });
+            // KEY FIX: race finalMessage() against signal abort.
+            // Without this, finalMessage() hangs forever when the HTTP connection
+            // is killed mid-stream (the stream 'end' event never fires).
+            const response = await (0, race_signal_js_1.raceSignal)(stream.finalMessage(), signal);
+            return this.parseResponse(response);
+        }
+        // Non-streaming path
+        const response = await (0, race_signal_js_1.raceSignal)(this.client.messages.create(params, { signal }), signal);
+        return this.parseResponse(response);
+    }
+    buildParams(request) {
+        // Extract system messages (Anthropic handles them separately)
+        const systemMessages = request.messages.filter(m => m.role === 'system');
+        const systemContent = systemMessages.map(m => m.content).join('\n\n');
+        // Convert remaining messages to Anthropic format
+        const anthropicMessages = request.messages
+            .filter(m => m.role !== 'system')
+            .map(msg => {
+            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}`);
+        });
+        // Convert tool definitions to Anthropic format
+        // Mark the last tool with cache_control so Anthropic caches system + tools block
+        const rawTools = request.tools ?? [];
+        const tools = rawTools.length > 0
+            ? rawTools.map((tool, index) => ({
+                name: tool.name,
+                description: tool.description,
+                input_schema: {
+                    type: 'object',
+                    ...tool.parameters
+                },
+                ...(index === rawTools.length - 1
+                    ? { cache_control: { type: 'ephemeral' } }
+                    : {})
+            }))
+            : undefined;
+        // Mark system prompt with cache_control — stable across retries and group iterations
+        const systemParam = systemContent
+            ? [{ type: 'text', text: systemContent, cache_control: { type: 'ephemeral' } }]
+            : undefined;
+        return {
+            model: request.model,
+            max_tokens: request.max_tokens || 4096,
+            system: systemParam,
+            messages: anthropicMessages,
+            tools: tools,
+            temperature: request.temperature
+        };
+    }
+    parseResponse(response) {
+        // Parse tool calls and text content from response
+        const tool_calls = [];
+        let textContent = '';
+        for (const block of response.content) {
+            if (block.type === 'text') {
+                textContent += block.text;
+            }
+            else if (block.type === 'tool_use') {
+                tool_calls.push({
+                    id: block.id,
+                    name: block.name,
+                    arguments: block.input
+                });
+            }
+        }
+        const cachedInputTokens = response.usage.cache_read_input_tokens ?? 0;
+        const cacheCreationTokens = response.usage.cache_creation_input_tokens ?? 0;
+        return {
+            content: textContent,
+            tool_calls,
+            finish_reason: response.stop_reason || 'stop',
+            usage: {
+                prompt_tokens: response.usage.input_tokens,
+                completion_tokens: response.usage.output_tokens,
+                total_tokens: response.usage.input_tokens + response.usage.output_tokens,
+                cached_input_tokens: cachedInputTokens > 0 ? cachedInputTokens : undefined,
+                cache_creation_tokens: cacheCreationTokens > 0 ? cacheCreationTokens : undefined
+            }
+        };
+    }
+}
+exports.AnthropicProvider = AnthropicProvider;
+//# sourceMappingURL=anthropic.js.map

package/dist/providers/anthropic.js.map

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

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

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

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

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