@autonome-research/thread-phase-agents 3.0.0

package/dist/anthropic/adapter.js

@@ -0,0 +1,259 @@
+/**
+ * Anthropic adapter — in-process via `@anthropic-ai/sdk`.
+ *
+ * Single-turn. The adapter streams from `client.messages.stream(...)`,
+ * translates Anthropic's RawMessageStreamEvent union to canonical
+ * `AgentEvent`s, and returns when the stream ends. Tool-use loops are
+ * the caller's responsibility — the adapter surfaces `tool_call` events
+ * but does not execute tools; on subsequent calls the caller passes the
+ * tool result back in `messages` as a user `tool_result` block.
+ *
+ * Capabilities:
+ *   streaming        'text'
+ *   cancellation     'cooperative'  (Anthropic SDK accepts an AbortSignal)
+ *   resumption       'none'         (no native session id; pass history)
+ *   structuredOutput 'prompted'     (uses thread-phase's <response> parser)
+ *
+ * Extended thinking surfaces as canonical `thinking` events. Vision /
+ * citations / cache-control blocks pass through transparently in
+ * config.messages; we don't intercept them.
+ *
+ * @internal
+ */
+import Anthropic from '@anthropic-ai/sdk';
+import { applyStructuredOutputPrompt, composeAbort, createEventQueue, defineAgentAdapter, lazyEvents, parseStructuredFromText, serializeError, TurnAccumulator, } from '@autonome-research/thread-phase/agents';
+const ADAPTER_ID = 'anthropic';
+/** @internal */
+export const anthropicAgent = defineAgentAdapter({
+    id: ADAPTER_ID,
+    capabilities: {
+        streaming: 'text',
+        cancellation: 'cooperative',
+        resumption: 'none',
+        structuredOutput: 'prompted',
+    },
+    adapter: createAnthropicAdapter,
+});
+function createAnthropicAdapter(config, options = {}) {
+    const source = ADAPTER_ID;
+    const traceId = options.traceId;
+    const { signal: compositeSignal, controller } = composeAbort(options.signal);
+    const queue = createEventQueue(options.eventBus);
+    const turns = new TurnAccumulator(queue.push, source, traceId);
+    let started = false;
+    let runPromise = null;
+    const startIfNeeded = () => {
+        if (runPromise)
+            return runPromise;
+        started = true;
+        runPromise = runOnce();
+        return runPromise;
+    };
+    async function runOnce() {
+        queue.push({ type: 'agent_start', source, traceId });
+        const client = config.client ?? new Anthropic({
+            apiKey: config.apiKey,
+            baseURL: config.baseURL,
+        });
+        const systemPrompt = config.outputSchema
+            ? applyStructuredOutputPrompt(config.systemPrompt ?? '', config.outputSchema)
+            : config.systemPrompt;
+        let assembledText = '';
+        let stopReason = null;
+        let inputTokens = 0;
+        let outputTokens = 0;
+        const executedToolCalls = [];
+        const blocks = {};
+        try {
+            const stream = client.messages.stream({
+                model: config.model,
+                max_tokens: config.maxTokens ?? 4096,
+                messages: config.messages,
+                ...(systemPrompt !== undefined ? { system: systemPrompt } : {}),
+                ...(config.tools !== undefined ? { tools: config.tools } : {}),
+                ...(config.toolChoice !== undefined ? { tool_choice: config.toolChoice } : {}),
+                ...(config.temperature !== undefined ? { temperature: config.temperature } : {}),
+                ...(config.thinking !== undefined ? { thinking: config.thinking } : {}),
+            }, { signal: compositeSignal });
+            for await (const event of stream) {
+                switch (event.type) {
+                    case 'message_start': {
+                        const m = event.message;
+                        if (m?.usage) {
+                            inputTokens = m.usage.input_tokens ?? inputTokens;
+                        }
+                        break;
+                    }
+                    case 'content_block_start': {
+                        const cb = event.content_block;
+                        if (cb.type === 'tool_use') {
+                            blocks[event.index] = {
+                                type: 'tool_use',
+                                toolId: cb.id,
+                                toolName: cb.name,
+                                jsonAcc: '',
+                            };
+                        }
+                        else if (cb.type === 'thinking') {
+                            blocks[event.index] = { type: 'thinking' };
+                        }
+                        else if (cb.type === 'text') {
+                            blocks[event.index] = { type: 'text' };
+                        }
+                        else {
+                            blocks[event.index] = { type: 'other' };
+                            turns.native('anthropic:content_block_start', cb);
+                        }
+                        break;
+                    }
+                    case 'content_block_delta': {
+                        const block = blocks[event.index];
+                        if (!block)
+                            break;
+                        const delta = event.delta;
+                        if (delta.type === 'text_delta') {
+                            assembledText += delta.text;
+                            turns.text(delta.text);
+                        }
+                        else if (delta.type === 'thinking_delta') {
+                            turns.thinking(delta.thinking);
+                        }
+                        else if (delta.type === 'input_json_delta') {
+                            block.jsonAcc = (block.jsonAcc ?? '') + delta.partial_json;
+                        }
+                        else {
+                            // signature_delta, citations_delta, etc. — surface as native.
+                            turns.native(`anthropic:${delta.type}`, delta);
+                        }
+                        break;
+                    }
+                    case 'content_block_stop': {
+                        const block = blocks[event.index];
+                        if (block?.type === 'tool_use' && block.toolId && block.toolName) {
+                            let parsedInput = {};
+                            if (block.jsonAcc && block.jsonAcc.length > 0) {
+                                try {
+                                    const j = JSON.parse(block.jsonAcc);
+                                    if (j !== null && typeof j === 'object' && !Array.isArray(j)) {
+                                        parsedInput = j;
+                                    }
+                                }
+                                catch {
+                                    parsedInput = { _rawJson: block.jsonAcc };
+                                }
+                            }
+                            turns.toolCall(block.toolId, block.toolName, parsedInput);
+                            executedToolCalls.push({
+                                id: block.toolId,
+                                name: block.toolName,
+                                input: parsedInput,
+                            });
+                        }
+                        delete blocks[event.index];
+                        break;
+                    }
+                    case 'message_delta': {
+                        if (event.delta?.stop_reason) {
+                            stopReason = event.delta.stop_reason;
+                        }
+                        if (event.usage) {
+                            outputTokens = event.usage.output_tokens ?? outputTokens;
+                        }
+                        break;
+                    }
+                    case 'message_stop': {
+                        // Stream ends after this. Final usage was on message_delta.
+                        break;
+                    }
+                    default: {
+                        // Forward-compat for new event types.
+                        turns.native(`anthropic:${event.type ?? 'unknown'}`, event);
+                        break;
+                    }
+                }
+            }
+        }
+        catch (err) {
+            const aborted = compositeSignal.aborted;
+            turns.close();
+            queue.push({
+                type: 'error',
+                source,
+                traceId,
+                error: serializeError(err),
+                transient: false,
+            });
+            const reason = aborted ? 'aborted' : 'error';
+            queue.push({ type: 'agent_end', source, traceId, reason });
+            queue.close();
+            return {
+                text: assembledText,
+                finishReason: reason,
+                usage: {
+                    promptTokens: inputTokens,
+                    completionTokens: outputTokens,
+                    totalTokens: inputTokens + outputTokens,
+                },
+                executedToolCalls,
+            };
+        }
+        turns.close();
+        const finishReason = mapStopReason(stopReason, compositeSignal.aborted);
+        let parsed = undefined;
+        let parseError = undefined;
+        if (config.outputSchema) {
+            try {
+                parsed = parseStructuredFromText(assembledText, config.outputSchema);
+            }
+            catch (err) {
+                parseError = serializeError(err);
+            }
+        }
+        queue.push({ type: 'agent_end', source, traceId, reason: finishReason });
+        queue.close();
+        return {
+            text: assembledText,
+            finishReason,
+            usage: {
+                promptTokens: inputTokens,
+                completionTokens: outputTokens,
+                totalTokens: inputTokens + outputTokens,
+            },
+            executedToolCalls,
+            parsed,
+            parseError,
+        };
+    }
+    return {
+        events: lazyEvents(queue.events, startIfNeeded),
+        get result() {
+            return startIfNeeded();
+        },
+        abort(reason) {
+            controller.abort(reason);
+            if (!started)
+                startIfNeeded();
+        },
+    };
+}
+function mapStopReason(reason, aborted) {
+    if (aborted)
+        return 'aborted';
+    switch (reason) {
+        case 'end_turn':
+        case 'stop_sequence':
+            return 'stop';
+        case 'max_tokens':
+            return 'length';
+        case 'tool_use':
+            return 'tool_calls';
+        case 'refusal':
+            return 'content_filter';
+        case 'pause_turn':
+        case null:
+            return 'unknown';
+        default:
+            return 'unknown';
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/anthropic/adapter.js.map

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

package/dist/anthropic/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Anthropic adapter entry. In-process; requires @anthropic-ai/sdk and a
+ * valid ANTHROPIC_API_KEY (or a pre-built client passed in config).
+ *
+ * @internal
+ */
+export { anthropicAgent, type AnthropicAgentConfig } from './adapter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/anthropic/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,cAAc,CAAC"}

package/dist/anthropic/index.js

@@ -0,0 +1,8 @@
+/**
+ * Anthropic adapter entry. In-process; requires @anthropic-ai/sdk and a
+ * valid ANTHROPIC_API_KEY (or a pre-built client passed in config).
+ *
+ * @internal
+ */
+export { anthropicAgent } from './adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/anthropic/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/anthropic/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAA6B,MAAM,cAAc,CAAC"}

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

@@ -0,0 +1,56 @@
+/**
+ * Claude Code adapter — wraps the `claude` CLI in stream-json mode.
+ *
+ * Spawns the CLI, parses NDJSON output, translates known event shapes
+ * to canonical AgentEvents, and surfaces unknown shapes as native
+ * events. The Claude Code CLI surface changes with releases — the
+ * adapter is forgiving by design: unrecognized lines become
+ * `native { kind: 'claude-code:<type>' }` events rather than errors.
+ *
+ * Default invocation:
+ *   claude --print --output-format stream-json --verbose [<prompt>]
+ *
+ * With `resumeSessionId`:
+ *   claude --print --output-format stream-json --verbose --resume <id> [<prompt>]
+ *
+ * Override `claudeArgs` to take full control of argv when the CLI
+ * version on PATH expects a different shape.
+ *
+ * Capabilities:
+ *   streaming        'text'
+ *   cancellation     'forceful'
+ *   resumption       'opaque'      (session id as the resume token)
+ *   structuredOutput 'prompted'
+ *
+ * @internal
+ */
+import { type AgentAdapterMeta, type StructuredOutputConfig } from '@autonome-research/thread-phase/agents';
+/** @internal */
+export interface ClaudeCodeAgentConfig {
+    /** Working directory passed as the subprocess cwd. */
+    cwd: string;
+    /** Prompt sent to the agent. Becomes the trailing positional arg by default. */
+    prompt: string;
+    /** Executable. Default 'claude'. */
+    claudeExecutable?: string;
+    /**
+     * Full argv override. When set, takes precedence over all defaults
+     * including --print, --output-format, --resume, and the prompt
+     * positional. Useful when wrapping a different CLI version.
+     */
+    claudeArgs?: string[];
+    /**
+     * Resume a prior session by id. Adds `--resume <id>` to the default
+     * args (ignored if `claudeArgs` is set).
+     */
+    resumeSessionId?: string;
+    /** Environment overrides merged with process.env. */
+    env?: Record<string, string>;
+    /** SIGTERM-then-SIGKILL grace in ms; default 3000. */
+    killGraceMs?: number;
+    /** Optional structured-output spec (prompted path). */
+    outputSchema?: StructuredOutputConfig;
+}
+/** @internal */
+export declare const claudeCodeAgent: AgentAdapterMeta<ClaudeCodeAgentConfig>;
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/claude-code/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAKH,OAAO,EASL,KAAK,gBAAgB,EAMrB,KAAK,sBAAsB,EAC5B,MAAM,wCAAwC,CAAC;AAKhD,gBAAgB;AAChB,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,GAAG,EAAE,MAAM,CAAC;IACZ,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,YAAY,CAAC,EAAE,sBAAsB,CAAC;CACvC;AAED,gBAAgB;AAChB,eAAO,MAAM,eAAe,EAAE,gBAAgB,CAAC,qBAAqB,CASlE,CAAC"}

package/dist/claude-code/adapter.js

@@ -0,0 +1,319 @@
+/**
+ * Claude Code adapter — wraps the `claude` CLI in stream-json mode.
+ *
+ * Spawns the CLI, parses NDJSON output, translates known event shapes
+ * to canonical AgentEvents, and surfaces unknown shapes as native
+ * events. The Claude Code CLI surface changes with releases — the
+ * adapter is forgiving by design: unrecognized lines become
+ * `native { kind: 'claude-code:<type>' }` events rather than errors.
+ *
+ * Default invocation:
+ *   claude --print --output-format stream-json --verbose [<prompt>]
+ *
+ * With `resumeSessionId`:
+ *   claude --print --output-format stream-json --verbose --resume <id> [<prompt>]
+ *
+ * Override `claudeArgs` to take full control of argv when the CLI
+ * version on PATH expects a different shape.
+ *
+ * Capabilities:
+ *   streaming        'text'
+ *   cancellation     'forceful'
+ *   resumption       'opaque'      (session id as the resume token)
+ *   structuredOutput 'prompted'
+ *
+ * @internal
+ */
+import { spawn } from 'node:child_process';
+import { applyStructuredOutputPrompt, composeAbort, createEventQueue, defineAgentAdapter, lazyEvents, parseStructuredFromText, serializeError, TurnAccumulator, } from '@autonome-research/thread-phase/agents';
+const ADAPTER_ID = 'claude-code';
+/** @internal */
+export const claudeCodeAgent = defineAgentAdapter({
+    id: ADAPTER_ID,
+    capabilities: {
+        streaming: 'text',
+        cancellation: 'forceful',
+        resumption: 'opaque',
+        structuredOutput: 'prompted',
+    },
+    adapter: createClaudeCodeAdapter,
+});
+function createClaudeCodeAdapter(config, options = {}) {
+    const source = ADAPTER_ID;
+    const traceId = options.traceId;
+    const killGraceMs = config.killGraceMs ?? 3000;
+    const { signal: compositeSignal, controller } = composeAbort(options.signal);
+    const queue = createEventQueue(options.eventBus);
+    const turns = new TurnAccumulator(queue.push, source, traceId);
+    let started = false;
+    let runPromise = null;
+    const startIfNeeded = () => {
+        if (runPromise)
+            return runPromise;
+        started = true;
+        runPromise = runOnce();
+        return runPromise;
+    };
+    async function runOnce() {
+        let resumeToken = config.resumeSessionId
+            ? { kind: 'opaque', data: config.resumeSessionId }
+            : undefined;
+        queue.push({ type: 'agent_start', source, traceId, resumeToken });
+        const effectivePrompt = config.outputSchema
+            ? `${config.prompt}\n\n${applyStructuredOutputPrompt('', config.outputSchema)}`
+            : config.prompt;
+        const args = config.claudeArgs ?? buildDefaultArgs(effectivePrompt, config.resumeSessionId);
+        const env = config.env ? { ...process.env, ...config.env } : process.env;
+        const executable = config.claudeExecutable ?? 'claude';
+        let child;
+        try {
+            child = spawn(executable, args, {
+                cwd: config.cwd,
+                env,
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+        }
+        catch (err) {
+            turns.close();
+            queue.push({
+                type: 'error',
+                source,
+                traceId,
+                error: serializeError(err),
+                transient: false,
+            });
+            queue.push({ type: 'agent_end', source, traceId, reason: 'error', resumeToken });
+            queue.close();
+            return {
+                text: '',
+                finishReason: 'error',
+                usage: { promptTokens: 0, completionTokens: 0, totalTokens: 0 },
+                executedToolCalls: [],
+                resumeToken,
+            };
+        }
+        let stdoutBuf = '';
+        let assembledText = '';
+        let sessionId = config.resumeSessionId;
+        const executedToolCalls = [];
+        const parseLine = (line) => {
+            let msg;
+            try {
+                msg = JSON.parse(line);
+            }
+            catch {
+                turns.native('claude-code:non-json', line);
+                return;
+            }
+            if (msg === null || typeof msg !== 'object') {
+                turns.native('claude-code:non-object', msg);
+                return;
+            }
+            handleMessage(msg);
+        };
+        const handleMessage = (msg) => {
+            const type = typeof msg.type === 'string' ? msg.type : 'unknown';
+            // Capture session_id whenever it surfaces.
+            const sid = typeof msg.session_id === 'string' ? msg.session_id : undefined;
+            if (sid) {
+                sessionId = sid;
+                resumeToken = { kind: 'opaque', data: sid };
+            }
+            if (type === 'system') {
+                // init / config / etc — surface as native; session_id already captured.
+                turns.native(`claude-code:system:${msg.subtype ?? 'unknown'}`, msg);
+                return;
+            }
+            if (type === 'assistant') {
+                const message = msg.message;
+                const content = Array.isArray(message?.content) ? message?.content : [];
+                for (const raw of content) {
+                    if (raw === null || typeof raw !== 'object')
+                        continue;
+                    const block = raw;
+                    const blockType = typeof block.type === 'string' ? block.type : 'unknown';
+                    if (blockType === 'text' && typeof block.text === 'string') {
+                        assembledText += block.text;
+                        turns.text(block.text);
+                    }
+                    else if (blockType === 'thinking' && typeof block.thinking === 'string') {
+                        turns.thinking(block.thinking);
+                    }
+                    else if (blockType === 'tool_use') {
+                        const id = typeof block.id === 'string' ? block.id : `tu_${executedToolCalls.length}`;
+                        const name = typeof block.name === 'string' ? block.name : 'tool';
+                        const input = (typeof block.input === 'object' && block.input !== null && !Array.isArray(block.input))
+                            ? block.input
+                            : {};
+                        turns.toolCall(id, name, input);
+                        executedToolCalls.push({ id, name, input });
+                    }
+                    else {
+                        turns.native(`claude-code:assistant-block:${blockType}`, block);
+                    }
+                }
+                return;
+            }
+            if (type === 'user') {
+                const message = msg.message;
+                const content = Array.isArray(message?.content) ? message?.content : [];
+                for (const raw of content) {
+                    if (raw === null || typeof raw !== 'object')
+                        continue;
+                    const block = raw;
+                    if (block.type === 'tool_result') {
+                        const id = typeof block.tool_use_id === 'string' ? block.tool_use_id : '';
+                        const isError = block.is_error === true;
+                        const out = block.content ?? null;
+                        turns.toolResult(id, 'tool', out, isError);
+                    }
+                    else {
+                        turns.native(`claude-code:user-block:${block.type ?? 'unknown'}`, block);
+                    }
+                }
+                return;
+            }
+            if (type === 'result') {
+                // Final summary. Captured as native; the close-handler synthesizes
+                // the canonical agent_end based on exit code + collected text.
+                turns.native('claude-code:result', msg);
+                return;
+            }
+            turns.native(`claude-code:${type}`, msg);
+        };
+        const onAbortSignal = () => {
+            if (child.exitCode !== null || child.signalCode !== null)
+                return;
+            try {
+                child.kill('SIGTERM');
+            }
+            catch {
+                // already gone
+            }
+            setTimeout(() => {
+                if (child.exitCode === null && child.signalCode === null) {
+                    try {
+                        child.kill('SIGKILL');
+                    }
+                    catch {
+                        // already gone
+                    }
+                }
+            }, killGraceMs);
+        };
+        if (compositeSignal.aborted) {
+            onAbortSignal();
+        }
+        else {
+            compositeSignal.addEventListener('abort', onAbortSignal, { once: true });
+        }
+        return new Promise((resolve) => {
+            child.stdout.setEncoding('utf8');
+            child.stdout.on('data', (chunk) => {
+                stdoutBuf += chunk;
+                let nl;
+                while ((nl = stdoutBuf.indexOf('\n')) !== -1) {
+                    const line = stdoutBuf.slice(0, nl);
+                    stdoutBuf = stdoutBuf.slice(nl + 1);
+                    if (line.trim().length > 0)
+                        parseLine(line);
+                }
+            });
+            child.stderr.setEncoding('utf8');
+            child.stderr.on('data', (chunk) => {
+                queue.push({
+                    type: 'native',
+                    source,
+                    traceId,
+                    kind: 'claude-code:stderr',
+                    payload: chunk,
+                });
+            });
+            child.on('error', (err) => {
+                queue.push({
+                    type: 'error',
+                    source,
+                    traceId,
+                    error: serializeError(err),
+                    transient: false,
+                });
+            });
+            child.on('close', (code, signal) => {
+                if (stdoutBuf.trim().length > 0)
+                    parseLine(stdoutBuf.trim());
+                turns.close();
+                const aborted = compositeSignal.aborted;
+                let finishReason;
+                if (aborted)
+                    finishReason = 'aborted';
+                else if (code === 0)
+                    finishReason = executedToolCalls.length > 0 ? 'tool_calls' : 'stop';
+                else
+                    finishReason = 'error';
+                // Non-zero exit with no prior 'error' event would leave the
+                // event stream without a diagnostic. Synthesize one — the
+                // conformance suite asserts an error event precedes agent_end
+                // on the error path, and consumers expect to see why the run
+                // failed without combing through native stderr events.
+                if (finishReason === 'error') {
+                    queue.push({
+                        type: 'error',
+                        source,
+                        traceId,
+                        error: {
+                            name: 'ClaudeCodeExitError',
+                            message: signal
+                                ? `claude-code exited via signal ${signal}`
+                                : `claude-code exited with code ${code ?? 'null'}`,
+                        },
+                        transient: false,
+                    });
+                }
+                if (sessionId) {
+                    resumeToken = { kind: 'opaque', data: sessionId };
+                }
+                let parsed = undefined;
+                let parseError = undefined;
+                if (config.outputSchema && finishReason === 'stop') {
+                    try {
+                        parsed = parseStructuredFromText(assembledText, config.outputSchema);
+                    }
+                    catch (err) {
+                        parseError = serializeError(err);
+                    }
+                }
+                queue.push({ type: 'agent_end', source, traceId, reason: finishReason, resumeToken });
+                queue.close();
+                resolve({
+                    text: assembledText,
+                    finishReason,
+                    usage: { promptTokens: 0, completionTokens: 0, totalTokens: 0 },
+                    executedToolCalls,
+                    parsed,
+                    parseError,
+                    resumeToken,
+                });
+            });
+        });
+    }
+    return {
+        events: lazyEvents(queue.events, startIfNeeded),
+        get result() {
+            return startIfNeeded();
+        },
+        abort(reason) {
+            controller.abort(reason);
+            if (!started)
+                startIfNeeded();
+        },
+    };
+}
+function buildDefaultArgs(prompt, resumeSessionId) {
+    const args = ['--print', '--output-format', 'stream-json', '--verbose'];
+    if (resumeSessionId) {
+        args.push('--resume', resumeSessionId);
+    }
+    args.push(prompt);
+    return args;
+}
+//# sourceMappingURL=adapter.js.map