@studio-foundation/runner 0.4.0-beta → 0.6.0

package/dist/providers/claude-code-mcp-server.test.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const claude_code_mcp_server_js_1 = require("./claude-code-mcp-server.js");
+const TOOLS = [
+    {
+        name: 'repo_manager-read_file',
+        description: 'Read a file',
+        parameters: {
+            type: 'object',
+            properties: { path: { type: 'string' } },
+            required: ['path'],
+        },
+    },
+];
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+async function jsonRpc(port, method, params, id = 1) {
+    const body = { jsonrpc: '2.0', method, params };
+    if (id !== undefined)
+        body.id = id;
+    const res = await fetch(`http://127.0.0.1:${port}`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(body),
+    });
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+    return res.json();
+}
+(0, vitest_1.describe)('ClaudeCodeMcpServer', () => {
+    let server;
+    let executeTool;
+    (0, vitest_1.beforeEach)(() => {
+        executeTool = vitest_1.vi.fn();
+        server = new claude_code_mcp_server_js_1.ClaudeCodeMcpServer(TOOLS, executeTool);
+    });
+    (0, vitest_1.afterEach)(async () => {
+        await server.stop();
+    });
+    (0, vitest_1.it)('starts and returns a port number', async () => {
+        const port = await server.start();
+        (0, vitest_1.expect)(port).toBeGreaterThan(1024);
+        (0, vitest_1.expect)(port).toBeLessThan(65536);
+    });
+    (0, vitest_1.it)('responds to initialize with server capabilities', async () => {
+        const port = await server.start();
+        const res = await jsonRpc(port, 'initialize', {
+            protocolVersion: '2024-11-05',
+            capabilities: {},
+            clientInfo: { name: 'claude', version: '1.0' },
+        });
+        (0, vitest_1.expect)(res.result.capabilities).toBeDefined();
+        (0, vitest_1.expect)(res.result.serverInfo.name).toBe('studio');
+    });
+    (0, vitest_1.it)('responds to notifications/initialized (no id) with null', async () => {
+        const port = await server.start();
+        const res = await jsonRpc(port, 'notifications/initialized', {}, undefined);
+        (0, vitest_1.expect)(res).toBeNull();
+    });
+    (0, vitest_1.it)('lists tools in MCP format', async () => {
+        const port = await server.start();
+        const res = await jsonRpc(port, 'tools/list', {});
+        (0, vitest_1.expect)(res.result.tools).toHaveLength(1);
+        (0, vitest_1.expect)(res.result.tools[0].name).toBe('repo_manager-read_file');
+        (0, vitest_1.expect)(res.result.tools[0].inputSchema).toBeDefined();
+    });
+    (0, vitest_1.it)('calls executeTool and returns result on tools/call', async () => {
+        const outcome = { result: 'file contents' };
+        executeTool.mockResolvedValueOnce(outcome);
+        const port = await server.start();
+        const res = await jsonRpc(port, 'tools/call', {
+            name: 'repo_manager-read_file',
+            arguments: { path: 'src/foo.ts' },
+        });
+        (0, vitest_1.expect)(executeTool).toHaveBeenCalledWith('repo_manager-read_file', { path: 'src/foo.ts' }, vitest_1.expect.any(String));
+        (0, vitest_1.expect)(res.result.content[0].text).toBe(JSON.stringify('file contents'));
+    });
+    (0, vitest_1.it)('returns MCP error content when executeTool returns an error', async () => {
+        const outcome = { error: 'file not found' };
+        executeTool.mockResolvedValueOnce(outcome);
+        const port = await server.start();
+        const res = await jsonRpc(port, 'tools/call', {
+            name: 'repo_manager-read_file',
+            arguments: { path: 'missing.ts' },
+        });
+        (0, vitest_1.expect)(res.result.content[0].text).toContain('file not found');
+        (0, vitest_1.expect)(res.result.isError).toBe(true);
+    });
+    (0, vitest_1.it)('returns JSON-RPC error for unknown method', async () => {
+        const port = await server.start();
+        const res = await jsonRpc(port, 'unknown/method', {});
+        (0, vitest_1.expect)(res.error).toBeDefined();
+        (0, vitest_1.expect)(res.error.code).toBe(-32601);
+    });
+    (0, vitest_1.it)('returns JSON-RPC error -32602 when tools/call params are missing', async () => {
+        const port = await server.start();
+        const res = await jsonRpc(port, 'tools/call', { name: 'repo_manager-read_file' });
+        (0, vitest_1.expect)(res.error).toBeDefined();
+        (0, vitest_1.expect)(res.error.code).toBe(-32602);
+    });
+    (0, vitest_1.it)('records tool call with error when executeTool throws', async () => {
+        executeTool.mockRejectedValueOnce(new Error('unexpected crash'));
+        const port = await server.start();
+        const res = await jsonRpc(port, 'tools/call', {
+            name: 'repo_manager-read_file',
+            arguments: { path: 'f.ts' },
+        });
+        (0, vitest_1.expect)(res.result.isError).toBe(true);
+        (0, vitest_1.expect)(res.result.content[0].text).toContain('unexpected crash');
+        const calls = server.getToolCalls();
+        (0, vitest_1.expect)(calls).toHaveLength(1);
+        (0, vitest_1.expect)(calls[0].error).toBe('unexpected crash');
+    });
+    (0, vitest_1.it)('accumulates tool calls in getToolCalls()', async () => {
+        executeTool.mockResolvedValueOnce({ result: 'ok' });
+        const port = await server.start();
+        await jsonRpc(port, 'tools/call', { name: 'repo_manager-read_file', arguments: { path: 'f.ts' } });
+        const calls = server.getToolCalls();
+        (0, vitest_1.expect)(calls).toHaveLength(1);
+        (0, vitest_1.expect)(calls[0].name).toBe('repo_manager-read_file');
+        (0, vitest_1.expect)(calls[0].result).toBe('ok');
+    });
+});
+//# sourceMappingURL=claude-code-mcp-server.test.js.map

package/dist/providers/claude-code-mcp-server.test.js.map

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

package/dist/providers/claude-code.d.ts

@@ -0,0 +1,23 @@
+import type { LLMRequest, LLMResponse } from '@studio-foundation/contracts';
+import type { AgentLoopProvider, AgentLoopResult, ToolCallOutcome } from './provider.js';
+export interface ClaudeCodeConfig {
+    model?: string;
+}
+export declare class ClaudeCodeProvider implements AgentLoopProvider {
+    readonly name = "claude-code";
+    private readonly model;
+    constructor(config?: ClaudeCodeConfig);
+    /**
+     * Resolve the model to spawn `claude` with. The per-agent model — resolved by
+     * the engine into request.model (STU-429) — takes precedence. The
+     * construction-time model (config.claudeCode.model, i.e. defaults.model) is
+     * only a FALLBACK, for direct callers that omit or blank out request.model.
+     * `||` (not `??`) so an empty string also falls back, never reaching the CLI
+     * as a broken `--model ""`.
+     */
+    private resolveModel;
+    call(request: LLMRequest, onToken?: (token: string) => void, signal?: AbortSignal): Promise<LLMResponse>;
+    runAgentLoop(request: LLMRequest, executeTool: (name: string, args: Record<string, unknown>, callId: string) => Promise<ToolCallOutcome>, onToken?: (token: string) => void, signal?: AbortSignal): Promise<AgentLoopResult>;
+    private spawnClaude;
+}
+//# sourceMappingURL=claude-code.d.ts.map

package/dist/providers/claude-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../src/providers/claude-code.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGzF,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,kBAAmB,YAAW,iBAAiB;IAC1D,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,MAAM,GAAE,gBAAqB;IAIzC;;;;;;;OAOG;IACH,OAAO,CAAC,YAAY;IAId,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;IAUxG,YAAY,CAChB,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;IA6B3B,OAAO,CAAC,WAAW;CA8GpB"}

package/dist/providers/claude-code.js

@@ -0,0 +1,187 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClaudeCodeProvider = void 0;
+const node_child_process_1 = require("node:child_process");
+const promises_1 = require("node:fs/promises");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const node_crypto_1 = require("node:crypto");
+const claude_code_mcp_server_js_1 = require("./claude-code-mcp-server.js");
+class ClaudeCodeProvider {
+    name = 'claude-code';
+    model;
+    constructor(config = {}) {
+        this.model = config.model ?? 'claude-sonnet-4-5';
+    }
+    /**
+     * Resolve the model to spawn `claude` with. The per-agent model — resolved by
+     * the engine into request.model (STU-429) — takes precedence. The
+     * construction-time model (config.claudeCode.model, i.e. defaults.model) is
+     * only a FALLBACK, for direct callers that omit or blank out request.model.
+     * `||` (not `??`) so an empty string also falls back, never reaching the CLI
+     * as a broken `--model ""`.
+     */
+    resolveModel(request) {
+        return request.model || this.model;
+    }
+    async call(request, onToken, signal) {
+        const result = await this.runAgentLoop(request, async () => ({ result: null }), onToken, signal);
+        return {
+            content: result.content,
+            tool_calls: result.tool_calls,
+            finish_reason: result.finish_reason,
+            usage: result.usage,
+        };
+    }
+    async runAgentLoop(request, executeTool, onToken, signal) {
+        const tools = request.tools ?? [];
+        const prompt = buildPrompt(request);
+        const model = this.resolveModel(request);
+        // No tools → no MCP server. Attaching the HTTP MCP server makes the claude CLI
+        // hang on the streamable-http handshake, and a tool-less agent has nothing to
+        // call anyway, so run a plain --print invocation with no --mcp-config.
+        if (tools.length === 0) {
+            const result = await this.spawnClaude(model, prompt, undefined, onToken, signal);
+            return { ...result, tool_calls: [] };
+        }
+        const mcpServer = new claude_code_mcp_server_js_1.ClaudeCodeMcpServer(tools, executeTool);
+        const port = await mcpServer.start();
+        const mcpConfig = { mcpServers: { studio: { type: 'http', url: `http://127.0.0.1:${port}` } } };
+        const mcpConfigPath = (0, node_path_1.join)((0, node_os_1.tmpdir)(), `studio-mcp-${(0, node_crypto_1.randomUUID)()}.json`);
+        await (0, promises_1.writeFile)(mcpConfigPath, JSON.stringify(mcpConfig), 'utf-8');
+        try {
+            const result = await this.spawnClaude(model, prompt, mcpConfigPath, onToken, signal);
+            return { ...result, tool_calls: mcpServer.getToolCalls() };
+        }
+        finally {
+            await mcpServer.stop();
+            await (0, promises_1.unlink)(mcpConfigPath).catch(() => { });
+        }
+    }
+    spawnClaude(model, prompt, mcpConfigPath, onToken, signal) {
+        return new Promise((resolve, reject) => {
+            if (signal?.aborted)
+                return reject(new DOMException('Aborted', 'AbortError'));
+            const args = [
+                '--print',
+                '--output-format', 'stream-json',
+                '--model', model,
+                // With tools: expose them via the MCP server. Without tools: disable the
+                // CLI's built-in tools (`--tools ""`) so this is a single-turn pure
+                // completion — otherwise claude would run an unbounded agentic loop
+                // (reading files, running commands) instead of just answering.
+                // `--tools` is variadic, so it must be followed by another flag (--verbose),
+                // never by the positional prompt.
+                ...(mcpConfigPath ? ['--mcp-config', mcpConfigPath] : ['--tools', '']),
+                // --strict-mcp-config: use ONLY the MCP servers we pass (the studio server,
+                // or none for tool-less agents) and ignore the user's GLOBAL MCP servers
+                // (claude.ai Gmail/Drive/Linear/Notion/Figma/…). Without this, the spawned
+                // `claude` loads those at startup; their streamable-http handshake can hang
+                // the whole --print subprocess (→ Studio cancels with 0 tool calls / 0
+                // tokens) and injects ~88k tokens of tool defs into every call (~15x cost).
+                '--strict-mcp-config',
+                // stream-json output with --print REQUIRES --verbose. (The old
+                // --no-verbose flag was removed from the claude CLI and now errors.)
+                '--verbose',
+                '--dangerously-skip-permissions',
+            ];
+            const startedAt = Date.now();
+            logCC('spawn', { model, hasMcp: !!mcpConfigPath, flags: args, promptChars: prompt.length });
+            // The prompt goes on stdin, never in argv. Linux caps ONE argv entry at
+            // MAX_ARG_STRLEN (32 pages = 131072 bytes — not the ARG_MAX getconf reports),
+            // so a positional prompt makes spawn throw E2BIG for every agent whose payload
+            // outgrows 128 KiB, before the process exists (STU-561).
+            // What stdin must never be is an open pipe nobody closes: claude 2.1.37 blocks
+            // waiting for its EOF and never emits output. `end()` below is what delivers it.
+            const proc = (0, node_child_process_1.spawn)('claude', args, { stdio: ['pipe', 'pipe', 'pipe'] });
+            logCC('spawned', { pid: proc.pid });
+            proc.stdin.on('error', () => {
+                // The CLI can exit before reading it all; `close` already reports that.
+            });
+            proc.stdin.end(prompt);
+            if (signal) {
+                signal.addEventListener('abort', () => {
+                    proc.kill('SIGTERM');
+                    reject(new DOMException('Aborted', 'AbortError'));
+                }, { once: true });
+            }
+            let resultContent;
+            let stderrContent = '';
+            let buffer = '';
+            proc.stdout.on('data', (chunk) => {
+                buffer += chunk.toString('utf-8');
+                const lines = buffer.split('\n');
+                buffer = lines.pop() ?? '';
+                for (const line of lines) {
+                    if (!line.trim())
+                        continue;
+                    try {
+                        const event = JSON.parse(line);
+                        logCC('event', { type: event.type, subtype: event.subtype });
+                        if (event.type === 'assistant') {
+                            const msg = event.message;
+                            for (const block of msg.content ?? []) {
+                                if (block.type === 'text' && block.text) {
+                                    onToken?.(block.text);
+                                }
+                            }
+                        }
+                        if (event.type === 'result' && event.subtype === 'success') {
+                            resultContent = String(event.result ?? '');
+                        }
+                    }
+                    catch {
+                        // ignore non-JSON lines
+                    }
+                }
+            });
+            proc.stderr.on('data', (chunk) => {
+                const s = chunk.toString('utf-8');
+                stderrContent += s;
+                logCC('stderr', s.trim());
+            });
+            proc.on('close', (code) => {
+                logCC('close', { code, ms: Date.now() - startedAt, gotResult: resultContent !== undefined });
+                if (signal?.aborted)
+                    return;
+                if (resultContent !== undefined) {
+                    resolve({ content: resultContent, finish_reason: 'stop', usage: undefined });
+                }
+                else {
+                    const errDetail = stderrContent.trim() ? `: ${stderrContent.trim()}` : '';
+                    reject(new Error(`claude -p exited with code ${code}${errDetail}`));
+                }
+            });
+            proc.on('error', (err) => {
+                reject(new Error(`Failed to spawn claude: ${err.message}. Is Claude Code installed?`));
+            });
+        });
+    }
+}
+exports.ClaudeCodeProvider = ClaudeCodeProvider;
+/**
+ * Diagnostic logging for the claude-code provider, gated by the
+ * STUDIO_LOG_CLAUDE_CODE env var (set it to any non-empty value to enable).
+ * Writes to STDERR only — stdout carries the stream-json/result payload that
+ * callers (e.g. `studio run --json`) parse, so it must never be polluted.
+ * Lets you see, during a hang, exactly which lifecycle step stalls: spawn →
+ * spawned(pid) → event(type)… → close(code, ms, gotResult).
+ */
+function logCC(stage, detail) {
+    if (!process.env.STUDIO_LOG_CLAUDE_CODE)
+        return;
+    let rendered;
+    try {
+        rendered = typeof detail === 'string' ? detail : JSON.stringify(detail);
+    }
+    catch {
+        rendered = String(detail);
+    }
+    process.stderr.write(`[claude-code] ${stage} ${rendered}\n`);
+}
+function buildPrompt(request) {
+    const system = request.messages.filter(m => m.role === 'system').map(m => m.content).join('\n\n');
+    const user = request.messages.filter(m => m.role !== 'system').map(m => m.content).join('\n\n');
+    return system ? `<system>\n${system}\n</system>\n\n${user}` : user;
+}
+//# sourceMappingURL=claude-code.js.map

package/dist/providers/claude-code.js.map

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

package/dist/providers/claude-code.test.d.ts

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

package/dist/providers/claude-code.test.d.ts.map

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

package/dist/providers/claude-code.test.js

@@ -0,0 +1,259 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const claude_code_js_1 = require("./claude-code.js");
+const node_events_1 = require("node:events");
+const node_stream_1 = require("node:stream");
+const { mockSpawn, MockClaudeCodeMcpServer } = vitest_1.vi.hoisted(() => {
+    const mockSpawn = vitest_1.vi.fn();
+    function MockClaudeCodeMcpServer() {
+        return {
+            start: vitest_1.vi.fn().mockResolvedValue(9999),
+            stop: vitest_1.vi.fn().mockResolvedValue(undefined),
+            getToolCalls: vitest_1.vi.fn().mockReturnValue([]),
+        };
+    }
+    return { mockSpawn, MockClaudeCodeMcpServer };
+});
+vitest_1.vi.mock('node:child_process', () => ({ spawn: mockSpawn }));
+vitest_1.vi.mock('./claude-code-mcp-server.js', () => ({ ClaudeCodeMcpServer: MockClaudeCodeMcpServer }));
+vitest_1.vi.mock('node:fs/promises', () => {
+    return {
+        writeFile: vitest_1.vi.fn().mockResolvedValue(undefined),
+        unlink: vitest_1.vi.fn().mockResolvedValue(undefined),
+    };
+});
+function makeFakeProcess(lines, exitCode = 0) {
+    const proc = new node_events_1.EventEmitter();
+    proc.stdout = new node_stream_1.Readable({ read() { } });
+    proc.stderr = new node_stream_1.Readable({ read() { } });
+    proc.stdinWritten = '';
+    proc.stdin = new node_stream_1.Writable({ write(chunk, _enc, cb) { proc.stdinWritten += String(chunk); cb(); } });
+    proc.kill = vitest_1.vi.fn();
+    setTimeout(() => {
+        for (const line of lines) {
+            proc.stdout.push(line + '\n');
+        }
+        proc.stdout.push(null);
+        proc.emit('close', exitCode);
+    }, 0);
+    return proc;
+}
+const BASE_REQUEST = {
+    model: 'claude-sonnet-4-5',
+    messages: [
+        { role: 'system', content: 'You are helpful.' },
+        { role: 'user', content: 'Hello' },
+    ],
+};
+(0, vitest_1.describe)('ClaudeCodeProvider', () => {
+    (0, vitest_1.beforeEach)(() => {
+        vitest_1.vi.clearAllMocks();
+    });
+    (0, vitest_1.it)('has name "claude-code"', () => {
+        const provider = new claude_code_js_1.ClaudeCodeProvider();
+        (0, vitest_1.expect)(provider.name).toBe('claude-code');
+    });
+    (0, vitest_1.it)('runAgentLoop returns content from result event', async () => {
+        const lines = [
+            JSON.stringify({ type: 'assistant', message: { content: [{ type: 'text', text: '{"summary":"done"}' }] } }),
+            JSON.stringify({ type: 'result', subtype: 'success', result: '{"summary":"done"}' }),
+        ];
+        mockSpawn.mockReturnValueOnce(makeFakeProcess(lines));
+        const provider = new claude_code_js_1.ClaudeCodeProvider({ model: 'claude-sonnet-4-5' });
+        const result = await provider.runAgentLoop(BASE_REQUEST, vitest_1.vi.fn());
+        (0, vitest_1.expect)(result.content).toBe('{"summary":"done"}');
+        (0, vitest_1.expect)(result.finish_reason).toBe('stop');
+    });
+    (0, vitest_1.it)('streams tokens via onToken from assistant events', async () => {
+        const lines = [
+            JSON.stringify({ type: 'assistant', message: { content: [{ type: 'text', text: 'Hello' }] } }),
+            JSON.stringify({ type: 'assistant', message: { content: [{ type: 'text', text: ' world' }] } }),
+            JSON.stringify({ type: 'result', subtype: 'success', result: 'Hello world' }),
+        ];
+        mockSpawn.mockReturnValueOnce(makeFakeProcess(lines));
+        const provider = new claude_code_js_1.ClaudeCodeProvider({ model: 'claude-sonnet-4-5' });
+        const tokens = [];
+        await provider.runAgentLoop(BASE_REQUEST, vitest_1.vi.fn(), t => tokens.push(t));
+        (0, vitest_1.expect)(tokens).toEqual(['Hello', ' world']);
+    });
+    (0, vitest_1.it)('spawns claude with --output-format stream-json, --model, and --mcp-config when tools are present', async () => {
+        const lines = [JSON.stringify({ type: 'result', subtype: 'success', result: 'ok' })];
+        mockSpawn.mockReturnValueOnce(makeFakeProcess(lines));
+        const provider = new claude_code_js_1.ClaudeCodeProvider({ model: 'claude-sonnet-4-5' });
+        const requestWithTools = {
+            ...BASE_REQUEST,
+            tools: [{ name: 'echo', description: 'echo', parameters: { type: 'object', properties: {} } }],
+        };
+        await provider.runAgentLoop(requestWithTools, vitest_1.vi.fn());
+        const [cmd, args] = mockSpawn.mock.calls[0];
+        (0, vitest_1.expect)(cmd).toBe('claude');
+        (0, vitest_1.expect)(args).toContain('--output-format');
+        (0, vitest_1.expect)(args).toContain('stream-json');
+        (0, vitest_1.expect)(args).toContain('--model');
+        (0, vitest_1.expect)(args).toContain('claude-sonnet-4-5');
+        (0, vitest_1.expect)(args).toContain('--mcp-config');
+        // --strict-mcp-config pins the spawned claude to ONLY the studio MCP server,
+        // ignoring the user's global MCP servers (claude.ai Gmail/Drive/Linear/etc.)
+        // whose startup handshake otherwise hangs the subprocess and balloons cost.
+        (0, vitest_1.expect)(args).toContain('--strict-mcp-config');
+        // --output-format stream-json with --print REQUIRES --verbose; the old
+        // --no-verbose flag was removed from the claude CLI and now errors out.
+        (0, vitest_1.expect)(args).toContain('--verbose');
+        (0, vitest_1.expect)(args).not.toContain('--no-verbose');
+    });
+    (0, vitest_1.it)('sends the prompt on stdin and closes it, never in argv', async () => {
+        const lines = [JSON.stringify({ type: 'result', subtype: 'success', result: 'ok' })];
+        const proc = makeFakeProcess(lines);
+        mockSpawn.mockReturnValueOnce(proc);
+        const provider = new claude_code_js_1.ClaudeCodeProvider({ model: 'claude-sonnet-4-5' });
+        await provider.runAgentLoop(BASE_REQUEST, vitest_1.vi.fn());
+        const [, args, options] = mockSpawn.mock.calls[0];
+        // A positional prompt caps every agent at MAX_ARG_STRLEN and fails with E2BIG
+        // before the process exists (STU-561) — the last arg must stay a flag.
+        (0, vitest_1.expect)(args.some(arg => arg.includes('Hello'))).toBe(false);
+        (0, vitest_1.expect)(args.at(-1)).toBe('--dangerously-skip-permissions');
+        (0, vitest_1.expect)(options.stdio[0]).toBe('pipe');
+        (0, vitest_1.expect)(proc.stdinWritten).toContain('Hello');
+        (0, vitest_1.expect)(proc.stdinWritten).toContain('You are helpful.');
+        // claude blocks forever on a pipe nobody closes; end() is what delivers the EOF.
+        (0, vitest_1.expect)(proc.stdin.writableEnded).toBe(true);
+    });
+    (0, vitest_1.it)('a prompt past MAX_ARG_STRLEN reaches a real process on stdin and cannot on argv', async () => {
+        // The reason the test above exists, against the real kernel rather than a mock:
+        // Linux caps one argv entry at 32 pages, so the old positional prompt made
+        // spawn throw E2BIG for any agent whose payload outgrew it (STU-561). This is
+        // not a Claude limit and no CLI flag lifts it — stdin is the only way through.
+        const { spawn: realSpawn } = await vitest_1.vi.importActual('node:child_process');
+        const huge = 'x'.repeat(512 * 1024);
+        (0, vitest_1.expect)(() => realSpawn('/bin/cat', [huge], { stdio: 'ignore' })).toThrow(/E2BIG/);
+        const received = await new Promise((resolve, reject) => {
+            const proc = realSpawn('/bin/cat', [], { stdio: ['pipe', 'pipe', 'ignore'] });
+            let out = 0;
+            proc.stdout.on('data', (chunk) => { out += chunk.length; });
+            proc.on('close', () => resolve(out));
+            proc.on('error', reject);
+            proc.stdin.end(huge);
+        });
+        (0, vitest_1.expect)(received).toBe(huge.length);
+    });
+    (0, vitest_1.it)('honors the per-agent model from request.model over the construction-time default', async () => {
+        // STU-429: the construction-time model (from config.claudeCode.model, i.e.
+        // defaults.model) is only a FALLBACK. When a stage's agent declares its own
+        // model, the engine resolves it into request.model — the provider must spawn
+        // claude with THAT model, not the default it was constructed with.
+        const lines = [JSON.stringify({ type: 'result', subtype: 'success', result: 'ok' })];
+        mockSpawn.mockReturnValueOnce(makeFakeProcess(lines));
+        const provider = new claude_code_js_1.ClaudeCodeProvider({ model: 'claude-sonnet-4-5' }); // default
+        const requestWithModel = { ...BASE_REQUEST, model: 'claude-opus-4-1' }; // per-agent override
+        await provider.runAgentLoop(requestWithModel, vitest_1.vi.fn());
+        const [, args] = mockSpawn.mock.calls[0];
+        const modelIdx = args.indexOf('--model');
+        (0, vitest_1.expect)(modelIdx).toBeGreaterThanOrEqual(0);
+        (0, vitest_1.expect)(args[modelIdx + 1]).toBe('claude-opus-4-1');
+    });
+    (0, vitest_1.it)('falls back to the construction-time default when request.model is absent', async () => {
+        // Direct callers (not the runner) may omit model; the construction default
+        // still applies as the fallback.
+        const lines = [JSON.stringify({ type: 'result', subtype: 'success', result: 'ok' })];
+        mockSpawn.mockReturnValueOnce(makeFakeProcess(lines));
+        const provider = new claude_code_js_1.ClaudeCodeProvider({ model: 'claude-sonnet-4-5' });
+        const requestNoModel = { ...BASE_REQUEST, model: undefined };
+        await provider.runAgentLoop(requestNoModel, vitest_1.vi.fn());
+        const [, args] = mockSpawn.mock.calls[0];
+        const modelIdx = args.indexOf('--model');
+        (0, vitest_1.expect)(args[modelIdx + 1]).toBe('claude-sonnet-4-5');
+    });
+    (0, vitest_1.it)('skips the MCP server and --mcp-config when there are no tools', async () => {
+        // Attaching the HTTP MCP server makes the claude CLI hang on the streamable-http
+        // handshake; a tool-less agent (e.g. a pure classifier) needs no MCP server.
+        const lines = [JSON.stringify({ type: 'result', subtype: 'success', result: 'ok' })];
+        mockSpawn.mockReturnValueOnce(makeFakeProcess(lines));
+        const provider = new claude_code_js_1.ClaudeCodeProvider({ model: 'claude-sonnet-4-5' });
+        const result = await provider.runAgentLoop(BASE_REQUEST, vitest_1.vi.fn()); // BASE_REQUEST has no tools
+        const [, args] = mockSpawn.mock.calls[0];
+        (0, vitest_1.expect)(args).not.toContain('--mcp-config');
+        // No --mcp-config here, but --strict-mcp-config still matters: it stops the
+        // CLI from loading the user's global MCP servers, which otherwise inject ~88k
+        // tokens of tool defs per call (~15x cost) and can hang on their handshake.
+        (0, vitest_1.expect)(args).toContain('--strict-mcp-config');
+        (0, vitest_1.expect)(args).toContain('--verbose');
+        // built-in tools disabled for a single-turn pure completion (no agentic roaming),
+        // and the empty value must sit before a flag so the variadic doesn't eat the prompt.
+        const toolsIdx = args.indexOf('--tools');
+        (0, vitest_1.expect)(toolsIdx).toBeGreaterThanOrEqual(0);
+        (0, vitest_1.expect)(args[toolsIdx + 1]).toBe('');
+        (0, vitest_1.expect)(args[toolsIdx + 2]).toMatch(/^--/);
+        (0, vitest_1.expect)(result.tool_calls).toEqual([]);
+    });
+    (0, vitest_1.it)('never leaves claude an open stdin pipe (else --print hangs waiting for EOF)', async () => {
+        // ROOT CAUSE of the studio classify hang: an open, non-TTY stdin nobody closes.
+        // claude 2.1.37 blocks waiting for its EOF and never emits output, so Studio
+        // cancels it (0 tool calls / 0 tokens). The prompt now travels on that pipe, so
+        // the guard is no longer stdio[0]='ignore' — it is that the pipe always ends.
+        const lines = [JSON.stringify({ type: 'result', subtype: 'success', result: 'ok' })];
+        const proc = makeFakeProcess(lines);
+        mockSpawn.mockReturnValueOnce(proc);
+        await new claude_code_js_1.ClaudeCodeProvider().runAgentLoop(BASE_REQUEST, vitest_1.vi.fn());
+        (0, vitest_1.expect)(proc.stdin.writableEnded).toBe(true);
+    });
+    (0, vitest_1.it)('logs lifecycle to stderr only when STUDIO_LOG_CLAUDE_CODE is set', async () => {
+        const lines = [JSON.stringify({ type: 'result', subtype: 'success', result: 'ok' })];
+        const writes = [];
+        const spy = vitest_1.vi.spyOn(process.stderr, 'write').mockImplementation(((s) => {
+            writes.push(String(s));
+            return true;
+        }));
+        try {
+            // Off by default: no diagnostic lines.
+            delete process.env.STUDIO_LOG_CLAUDE_CODE;
+            mockSpawn.mockReturnValueOnce(makeFakeProcess(lines));
+            await new claude_code_js_1.ClaudeCodeProvider().runAgentLoop(BASE_REQUEST, vitest_1.vi.fn());
+            (0, vitest_1.expect)(writes.some(w => w.includes('[claude-code]'))).toBe(false);
+            // On when the env var is set: spawn + close lifecycle lines on stderr.
+            process.env.STUDIO_LOG_CLAUDE_CODE = '1';
+            mockSpawn.mockReturnValueOnce(makeFakeProcess(lines));
+            await new claude_code_js_1.ClaudeCodeProvider().runAgentLoop(BASE_REQUEST, vitest_1.vi.fn());
+            (0, vitest_1.expect)(writes.some(w => w.includes('[claude-code] spawn'))).toBe(true);
+            (0, vitest_1.expect)(writes.some(w => w.includes('[claude-code] close'))).toBe(true);
+        }
+        finally {
+            delete process.env.STUDIO_LOG_CLAUDE_CODE;
+            spy.mockRestore();
+        }
+    });
+    (0, vitest_1.it)('throws when claude exits non-zero with no result event', async () => {
+        mockSpawn.mockReturnValueOnce(makeFakeProcess([], 1));
+        const provider = new claude_code_js_1.ClaudeCodeProvider();
+        await (0, vitest_1.expect)(provider.runAgentLoop(BASE_REQUEST, vitest_1.vi.fn())).rejects.toThrow(/claude -p exited/i);
+    });
+    (0, vitest_1.it)('aborts child process when signal fires', async () => {
+        const controller = new AbortController();
+        // Long-running proc that never closes on its own
+        const proc = new node_events_1.EventEmitter();
+        proc.stdout = new node_stream_1.Readable({ read() { } });
+        proc.stderr = new node_stream_1.Readable({ read() { } });
+        proc.stdin = new node_stream_1.Writable({ write(_c, _e, cb) { cb(); } });
+        proc.kill = vitest_1.vi.fn();
+        mockSpawn.mockReturnValueOnce(proc);
+        const provider = new claude_code_js_1.ClaudeCodeProvider();
+        const promise = provider.runAgentLoop(BASE_REQUEST, vitest_1.vi.fn(), undefined, controller.signal);
+        // Wait for spawn to be called and listeners to be set up
+        await Promise.resolve();
+        await Promise.resolve();
+        controller.abort();
+        // Simulate OS sending signal back as close event
+        proc.emit('close', 130);
+        await (0, vitest_1.expect)(promise).rejects.toThrow(/aborted/i);
+        (0, vitest_1.expect)(proc.kill).toHaveBeenCalled();
+    });
+    (0, vitest_1.it)('call() delegates to runAgentLoop and returns LLMResponse shape', async () => {
+        const lines = [JSON.stringify({ type: 'result', subtype: 'success', result: '{"answer":42}' })];
+        mockSpawn.mockReturnValueOnce(makeFakeProcess(lines));
+        const provider = new claude_code_js_1.ClaudeCodeProvider({ model: 'claude-sonnet-4-5' });
+        const result = await provider.call(BASE_REQUEST);
+        (0, vitest_1.expect)(result.content).toBe('{"answer":42}');
+        (0, vitest_1.expect)(result.finish_reason).toBe('stop');
+    });
+});
+//# sourceMappingURL=claude-code.test.js.map