@ai-devkit/agent-manager 0.29.0 → 0.30.0

package/dist/utils/ClaudeSessionParser.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/utils/ClaudeSessionParser.ts"],"sourcesContent":["import * as fs from 'fs';\nimport * as path from 'path';\nimport type { ConversationMessage } from '../adapters/AgentAdapter.js';\nimport { AgentStatus } from '../adapters/AgentAdapter.js';\n\n/**\n * Content block within a Claude Code JSONL message entry.\n * Handles text, tool_use, and tool_result block types.\n */\nexport interface ContentBlock {\n    type?: string;\n    text?: string;\n    content?: string;\n    name?: string;\n    input?: Record<string, unknown>;\n    tool_use_id?: string;\n    is_error?: boolean;\n}\n\n/**\n * A single line entry in a Claude Code session JSONL file.\n *\n * Each line is an independent JSON object with a type discriminator:\n * - \"user\" / \"assistant\" / \"system\" — conversation turns\n * - \"progress\" / \"thinking\" — intermediate agent state\n * - \"last-prompt\" / \"file-history-snapshot\" — metadata (not conversation state)\n */\nexport interface SessionEntry {\n    type?: string;\n    timestamp?: string;\n    cwd?: string;\n    message?: {\n        content?: string | ContentBlock[];\n    };\n}\n\n/**\n * Parsed session state extracted from a JSONL file.\n * Aggregates data from all entries into a single summary.\n */\nexport interface ClaudeSession {\n    sessionId: string;\n    projectPath: string;\n    lastCwd?: string;\n    sessionStart: Date;\n    lastActive: Date;\n    lastEntryType?: string;\n    isInterrupted: boolean;\n    lastUserMessage?: string;\n    /** First meaningful user prompt in the session (post noise filter) */\n    firstUserMessage?: string;\n}\n\n/**\n * Top-level JSONL entry types that represent conversation/agent state.\n *\n * Only these types update `lastEntryType` for status determination. All\n * other types Claude Code emits (`attachment`, `permission-mode`,\n * `ai-title`, `queued_command`, `tools_changed`, `model_changed`,\n * `hook_progress`, …) are UI-state events that must not overwrite the\n * last conversation turn — otherwise polling between writes lands on a\n * UI-state entry and `determineStatus` falls through to UNKNOWN.\n */\nconst CONVERSATION_ENTRY_TYPES = new Set([\n    'user',\n    'assistant',\n    'system',\n    'progress',\n    'thinking',\n]);\n\n/**\n * Parses Claude Code session JSONL files into structured data.\n *\n * Session files live at ~/.claude/projects/<encoded-cwd>/<session-id>.jsonl\n * and contain one JSON object per line, each representing a conversation\n * event (user turn, assistant response, tool call, etc.).\n */\nexport class ClaudeSessionParser {\n    /**\n     * Parse a session JSONL file into a ClaudeSession summary.\n     *\n     * Iterates all lines to extract: session start time (from first entry),\n     * last activity timestamp, last entry type (for status), whether the\n     * session was interrupted, and the last meaningful user message.\n     *\n     * Returns null if the file is unreadable or empty.\n     */\n    readSession(filePath: string, projectPath: string): ClaudeSession | null {\n        const sessionId = path.basename(filePath, '.jsonl');\n\n        let content: string;\n        try {\n            content = fs.readFileSync(filePath, 'utf-8');\n        } catch {\n            return null;\n        }\n\n        const allLines = content.trim().split('\\n');\n        if (allLines.length === 0) {\n            return null;\n        }\n\n        const sessionStart = this.parseSessionStart(allLines[0]);\n\n        let lastEntryType: string | undefined;\n        let lastActive: Date | undefined;\n        let lastCwd: string | undefined;\n        let isInterrupted = false;\n        let lastUserMessage: string | undefined;\n        let firstUserMessage: string | undefined;\n\n        for (const line of allLines) {\n            try {\n                const entry: SessionEntry = JSON.parse(line);\n\n                if (entry.timestamp) {\n                    const ts = new Date(entry.timestamp);\n                    if (!Number.isNaN(ts.getTime())) {\n                        lastActive = ts;\n                    }\n                }\n\n                if (typeof entry.cwd === 'string' && entry.cwd.trim().length > 0) {\n                    lastCwd = entry.cwd;\n                }\n\n                if (entry.type && CONVERSATION_ENTRY_TYPES.has(entry.type)) {\n                    lastEntryType = entry.type;\n\n                    if (entry.type === 'user') {\n                        const msgContent = entry.message?.content;\n                        isInterrupted =\n                            Array.isArray(msgContent) &&\n                            msgContent.some(\n                                (c) =>\n                                    (c.type === 'text' &&\n                                        c.text?.includes('[Request interrupted')) ||\n                                    (c.type === 'tool_result' &&\n                                        c.content?.includes('[Request interrupted')),\n                            );\n\n                        const text = this.extractUserMessageText(msgContent);\n                        if (text) {\n                            lastUserMessage = text;\n                            if (!firstUserMessage) {\n                                firstUserMessage = text;\n                            }\n                        }\n                    } else {\n                        isInterrupted = false;\n                    }\n                }\n            } catch {\n                continue;\n            }\n        }\n\n        return {\n            sessionId,\n            projectPath: projectPath || lastCwd || '',\n            lastCwd,\n            sessionStart: sessionStart || lastActive || new Date(),\n            lastActive: lastActive || new Date(),\n            lastEntryType,\n            isInterrupted,\n            lastUserMessage,\n            firstUserMessage,\n        };\n    }\n\n    /**\n     * Determine agent status from parsed session state.\n     *\n     * Status mapping:\n     * - \"user\" + interrupted → WAITING (agent finished, awaiting new input)\n     * - \"user\" + not interrupted → RUNNING (agent is processing)\n     * - \"progress\" / \"thinking\" → RUNNING\n     * - \"assistant\" → WAITING (agent responded, awaiting user)\n     * - \"system\" → IDLE\n     */\n    determineStatus(session: ClaudeSession): AgentStatus {\n        if (!session.lastEntryType) {\n            return AgentStatus.UNKNOWN;\n        }\n\n        if (session.lastEntryType === 'user') {\n            return session.isInterrupted\n                ? AgentStatus.WAITING\n                : AgentStatus.RUNNING;\n        }\n\n        if (\n            session.lastEntryType === 'progress' ||\n            session.lastEntryType === 'thinking'\n        ) {\n            return AgentStatus.RUNNING;\n        }\n\n        if (session.lastEntryType === 'assistant') {\n            return AgentStatus.WAITING;\n        }\n\n        if (session.lastEntryType === 'system') {\n            return AgentStatus.IDLE;\n        }\n\n        return AgentStatus.UNKNOWN;\n    }\n\n    /**\n     * Read the full conversation from a session JSONL file.\n     *\n     * Default mode returns only text content from user/assistant/system messages.\n     * Verbose mode also includes tool_use and tool_result blocks.\n     */\n    getConversation(sessionFilePath: string, options?: { verbose?: boolean }): ConversationMessage[] {\n        const verbose = options?.verbose ?? false;\n\n        let content: string;\n        try {\n            content = fs.readFileSync(sessionFilePath, 'utf-8');\n        } catch {\n            return [];\n        }\n\n        const lines = content.trim().split('\\n');\n        const messages: ConversationMessage[] = [];\n\n        for (const line of lines) {\n            let entry: SessionEntry;\n            try {\n                entry = JSON.parse(line);\n            } catch {\n                continue;\n            }\n\n            let role: ConversationMessage['role'];\n            if (entry.type === 'user') {\n                role = 'user';\n            } else if (entry.type === 'assistant') {\n                role = 'assistant';\n            } else if (entry.type === 'system') {\n                role = 'system';\n            } else {\n                continue;\n            }\n\n            const text = this.extractConversationContent(entry.message?.content, role, verbose);\n            if (!text) continue;\n\n            messages.push({\n                role,\n                content: text,\n                timestamp: entry.timestamp,\n            });\n        }\n\n        return messages;\n    }\n\n    /**\n     * Parse session start time from the first JSONL line.\n     *\n     * Claude Code may emit a \"file-history-snapshot\" as the first entry,\n     * which stores its timestamp inside \"snapshot.timestamp\" rather than\n     * at the root level.\n     */\n    private parseSessionStart(firstLine: string): Date | null {\n        try {\n            const firstEntry = JSON.parse(firstLine);\n            const rawTs: string | undefined =\n                firstEntry.timestamp || firstEntry.snapshot?.timestamp;\n            if (rawTs) {\n                const ts = new Date(rawTs);\n                if (!Number.isNaN(ts.getTime())) {\n                    return ts;\n                }\n            }\n        } catch {\n            /* malformed first line */\n        }\n        return null;\n    }\n\n    /**\n     * Extract meaningful text from a user message content field.\n     *\n     * Handles multiple formats:\n     * - Plain string content\n     * - Array of content blocks (extracts first text block)\n     * - Skill slash-commands (<command-message> tags)\n     * - Expanded skill content (extracts ARGUMENTS line)\n     * - Filters noise messages (interruptions, tool loaded, session continued)\n     */\n    private extractUserMessageText(\n        content: string | Array<{ type?: string; text?: string }> | undefined,\n    ): string | undefined {\n        if (!content) {\n            return undefined;\n        }\n\n        let raw: string | undefined;\n\n        if (typeof content === 'string') {\n            raw = content.trim();\n        } else if (Array.isArray(content)) {\n            for (const block of content) {\n                if (block.type === 'text' && block.text?.trim()) {\n                    raw = block.text.trim();\n                    break;\n                }\n            }\n        }\n\n        if (!raw) {\n            return undefined;\n        }\n\n        if (raw.startsWith('<command-message>')) {\n            return this.parseCommandMessage(raw);\n        }\n\n        if (raw.startsWith('Base directory for this skill:')) {\n            const argsMatch = raw.match(/\\nARGUMENTS:\\s*(.+)/);\n            return argsMatch?.[1]?.trim() || undefined;\n        }\n\n        if (isNoiseMessage(raw)) {\n            return undefined;\n        }\n\n        return raw;\n    }\n\n    /**\n     * Parse a <command-message> string into \"/command args\" format.\n     */\n    private parseCommandMessage(raw: string): string | undefined {\n        const nameMatch = raw.match(/<command-name>([^<]+)<\\/command-name>/);\n        const argsMatch = raw.match(/<command-args>([^<]+)<\\/command-args>/);\n        const name = nameMatch?.[1]?.trim();\n        if (!name) {\n            return undefined;\n        }\n        const args = argsMatch?.[1]?.trim();\n        return args ? `${name} ${args}` : name;\n    }\n\n    /**\n     * Extract displayable content from a message content field for conversation output.\n     */\n    private extractConversationContent(\n        content: string | ContentBlock[] | undefined,\n        role: ConversationMessage['role'],\n        verbose: boolean,\n    ): string | undefined {\n        if (!content) return undefined;\n\n        if (typeof content === 'string') {\n            const cleaned = stripHarnessTags(content);\n            if (role === 'user' && isNoiseMessage(cleaned)) return undefined;\n            return cleaned || undefined;\n        }\n\n        if (!Array.isArray(content)) return undefined;\n\n        const parts: string[] = [];\n\n        for (const block of content) {\n            if (block.type === 'text' && block.text?.trim()) {\n                const cleaned = stripHarnessTags(block.text);\n                if (!cleaned) continue;\n                if (role === 'user' && isNoiseMessage(cleaned)) continue;\n                parts.push(cleaned);\n            } else if (block.type === 'tool_use' && verbose) {\n                const inputSummary = block.input?.file_path || block.input?.pattern || block.input?.command || '';\n                parts.push(`[Tool: ${block.name}]${inputSummary ? ' ' + inputSummary : ''}`);\n            } else if (block.type === 'tool_result' && verbose) {\n                const truncated = truncateToolResult(block.content || '');\n                const prefix = block.is_error ? '[Tool Error]' : '[Tool Result]';\n                parts.push(`${prefix} ${truncated}`);\n            }\n        }\n\n        return parts.length > 0 ? parts.join('\\n') : undefined;\n    }\n}\n\n/**\n * Tags whose entire block (including content) should be dropped — they are\n * harness-injected prompt context (system reminders, hook output, command\n * stdout), not meaningful conversation content.\n */\nconst HARNESS_DROP_TAGS = [\n    'system-reminder',\n    'local-command-stdout',\n    'local-command-stderr',\n    'user-prompt-submit-hook',\n    'command-stdout',\n    'command-stderr',\n    'bash-input',\n    'bash-stdout',\n    'bash-stderr',\n    'command-message',\n] as const;\n\nconst HARNESS_DROP_RE = new RegExp(\n    `<(${HARNESS_DROP_TAGS.join('|')})>[\\\\s\\\\S]*?</\\\\1>`,\n    'g',\n);\n\nconst COMMAND_INVOCATION_RE =\n    /<command-name>([^<]+)<\\/command-name>(?:\\s*<command-args>([\\s\\S]*?)<\\/command-args>)?/g;\n\n/**\n * Remove harness-injected XML blocks from message text and collapse\n * <command-name>/<command-args> pairs into a \"/name args\" shorthand.\n *\n * Returns the cleaned, trimmed text. Returns an empty string if nothing\n * survives stripping.\n */\nfunction stripHarnessTags(text: string): string {\n    let out = text.replace(HARNESS_DROP_RE, '');\n\n    out = out.replace(COMMAND_INVOCATION_RE, (_match, rawName: string, rawArgs?: string) => {\n        const name = rawName.trim();\n        const args = rawArgs?.trim();\n        return args ? `${name} ${args}` : name;\n    });\n\n    return out.replace(/\\n{3,}/g, '\\n\\n').trim();\n}\n\n/** Check if a message is noise (not a meaningful user intent). */\nfunction isNoiseMessage(text: string): boolean {\n    return (\n        text.startsWith('[Request interrupted') ||\n        text === 'Tool loaded.' ||\n        text.startsWith('This session is being continued')\n    );\n}\n\nfunction truncateToolResult(content: string, maxLength = 200): string {\n    const firstLine = content.split('\\n')[0] || '';\n    if (firstLine.length <= maxLength) return firstLine;\n    return firstLine.slice(0, maxLength - 3) + '...';\n}\n"],"names":["fs","path","AgentStatus","CONVERSATION_ENTRY_TYPES","Set","ClaudeSessionParser","readSession","filePath","projectPath","sessionId","basename","content","readFileSync","allLines","trim","split","length","sessionStart","parseSessionStart","lastEntryType","lastActive","lastCwd","isInterrupted","lastUserMessage","firstUserMessage","line","entry","JSON","parse","timestamp","ts","Date","Number","isNaN","getTime","cwd","type","has","msgContent","message","Array","isArray","some","c","text","includes","extractUserMessageText","determineStatus","session","UNKNOWN","WAITING","RUNNING","IDLE","getConversation","sessionFilePath","options","verbose","lines","messages","role","extractConversationContent","push","firstLine","firstEntry","rawTs","snapshot","undefined","raw","block","startsWith","parseCommandMessage","argsMatch","match","isNoiseMessage","nameMatch","name","args","cleaned","stripHarnessTags","parts","inputSummary","input","file_path","pattern","command","truncated","truncateToolResult","prefix","is_error","join","HARNESS_DROP_TAGS","HARNESS_DROP_RE","RegExp","COMMAND_INVOCATION_RE","out","replace","_match","rawName","rawArgs","maxLength","slice"],"mappings":"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"}

package/src/durable/ClaudePrintAgentService.ts

@@ -1,94 +0,0 @@
-import type { DurableAgent, ProcessIdentity } from './DurableAgent.js';
-import { ClaudePrintError, DurableAgentNotFoundError } from './DurableAgent.js';
-import { ClaudeCliProbe } from './ClaudeCliProbe.js';
-import { ClaudePrintRunner, type ClaudePrintRunResult } from './ClaudePrintRunner.js';
-import { DurableAgentRepository, type CreateDurableAgentInput, type DurableRunCompletion } from './DurableAgentRepository.js';
-
-interface RepositoryLike {
-    create(input: CreateDurableAgentInput): Promise<DurableAgent>;
-    list(): Promise<DurableAgent[]>;
-    resolve(reference: string): Promise<DurableAgent | DurableAgent[] | null>;
-    acquireRun(id: string): Promise<{ agent: DurableAgent; token: string }>;
-    recordProviderProcess(id: string, token: string, identity: ProcessIdentity): Promise<void>;
-    completeRun(id: string, token: string, result: DurableRunCompletion): Promise<DurableAgent>;
-}
-
-interface ProbeLike { validate(): Promise<{ executable: string; version: string }> }
-interface RunnerLike { run(request: Parameters<ClaudePrintRunner['run']>[0]): Promise<ClaudePrintRunResult> }
-
-export interface ClaudePrintAgentServiceOptions {
-    repository?: RepositoryLike;
-    probe?: ProbeLike;
-    runner?: RunnerLike;
-    executable?: string;
-}
-
-export interface ClaudePrintSendResult extends ClaudePrintRunResult {
-    agentId: string;
-    agentName: string;
-}
-
-export class ClaudePrintAgentService {
-    readonly repository: RepositoryLike;
-    private readonly probe: ProbeLike;
-    private readonly runner: RunnerLike;
-    private readonly executable?: string;
-
-    constructor(options: ClaudePrintAgentServiceOptions = {}) {
-        this.repository = options.repository ?? new DurableAgentRepository();
-        this.probe = options.probe ?? new ClaudeCliProbe();
-        this.runner = options.runner ?? new ClaudePrintRunner();
-        this.executable = options.executable;
-    }
-
-    async create(input: CreateDurableAgentInput): Promise<DurableAgent> {
-        await this.probe.validate();
-        return this.repository.create(input);
-    }
-
-    async send(reference: string, prompt: string): Promise<ClaudePrintSendResult> {
-        const resolved = await this.repository.resolve(reference);
-        if (!resolved) throw new DurableAgentNotFoundError(reference);
-        if (Array.isArray(resolved)) {
-            throw new ClaudePrintError(`Multiple durable agents match "${reference}".`, 'DURABLE_AGENT_AMBIGUOUS');
-        }
-        const acquired = await this.repository.acquireRun(resolved.id);
-        try {
-            const result = await this.runner.run({
-                agent: acquired.agent,
-                prompt,
-                executable: this.executable,
-                firstRun: acquired.agent.sessionHealth === 'uninitialized',
-                onSpawn: (identity) => this.repository.recordProviderProcess(resolved.id, acquired.token, identity),
-            });
-            await this.repository.completeRun(resolved.id, acquired.token, {
-                status: 'succeeded',
-                exitCode: result.exitCode,
-                summary: sanitize(result.result, 4096),
-                sessionHealth: 'healthy',
-            });
-            return { ...result, agentId: resolved.id, agentName: resolved.name };
-        } catch (error) {
-            const failure = error instanceof Error ? error : new Error(String(error));
-            const sessionHealth = error instanceof ClaudePrintError && error.code === 'CLAUDE_SESSION_MISMATCH'
-                ? 'mismatch' as const
-                : 'unknown' as const;
-            await this.repository.completeRun(resolved.id, acquired.token, {
-                status: 'failed',
-                exitCode: null,
-                summary: sanitize(failure.message, 4096),
-                sessionHealth,
-            });
-            throw error;
-        }
-    }
-}
-
-function sanitize(value: string, max: number): string {
-    return Array.from(value, (character) => {
-        const code = character.charCodeAt(0);
-        return (code <= 8 || code === 11 || code === 12 || (code >= 14 && code <= 31) || code === 127)
-            ? ' '
-            : character;
-    }).join('').trim().slice(0, max);
-}

package/src/durable/ClaudePrintRunner.ts

@@ -1,139 +0,0 @@
-import { spawn as nodeSpawn, type ChildProcessWithoutNullStreams, type SpawnOptionsWithoutStdio } from 'child_process';
-import type { DurableAgent, ProcessIdentity } from './DurableAgent.js';
-import { ClaudePrintError } from './DurableAgent.js';
-import { LocalProcessInspector, type ProcessInspector } from './DurableAgentRepository.js';
-
-type Spawn = (
-    command: string,
-    args: readonly string[],
-    options: SpawnOptionsWithoutStdio & { stdio: ['pipe', 'pipe', 'pipe'] },
-) => ChildProcessWithoutNullStreams;
-
-export interface ClaudePrintRunRequest {
-    agent: DurableAgent;
-    prompt: string;
-    executable?: string;
-    firstRun: boolean;
-    onSpawn(identity: ProcessIdentity): Promise<void>;
-}
-
-export interface ClaudePrintRunResult {
-    sessionId: string;
-    result: string;
-    exitCode: number;
-}
-
-export interface ClaudePrintRunnerOptions {
-    spawn?: Spawn;
-    processInspector?: ProcessInspector;
-    maxLineBytes?: number;
-}
-
-export class ClaudePrintRunner {
-    private readonly spawn: Spawn;
-    private readonly processInspector: ProcessInspector;
-    private readonly maxLineBytes: number;
-
-    constructor(options: ClaudePrintRunnerOptions = {}) {
-        this.spawn = options.spawn ?? (nodeSpawn as Spawn);
-        this.processInspector = options.processInspector ?? new LocalProcessInspector();
-        this.maxLineBytes = options.maxLineBytes ?? 1024 * 1024;
-    }
-
-    async run(request: ClaudePrintRunRequest): Promise<ClaudePrintRunResult> {
-        const sessionArgs = request.firstRun
-            ? ['--session-id', request.agent.providerSessionId]
-            : ['--resume', request.agent.providerSessionId];
-        const args = ['-p', ...sessionArgs, '--output-format', 'stream-json', '--verbose'];
-        const child = this.spawn(request.executable ?? 'claude', args, {
-            cwd: request.agent.cwd,
-            shell: false,
-            stdio: ['pipe', 'pipe', 'pipe'],
-        });
-        if (!child.pid) {
-            child.kill();
-            throw new ClaudePrintError('Claude process did not provide a PID.', 'CLAUDE_PROCESS_IDENTITY');
-        }
-        const identity = this.processInspector.getIdentity(child.pid);
-        if (!identity) {
-            child.kill();
-            throw new ClaudePrintError('Cannot verify Claude process identity.', 'CLAUDE_PROCESS_IDENTITY');
-        }
-
-        let buffer = Buffer.alloc(0);
-        let terminal: ClaudePrintRunResult | null = null;
-        let protocolError: ClaudePrintError | null = null;
-
-        child.stdout.on('data', (chunk: Buffer | string) => {
-            if (protocolError) return;
-            buffer = Buffer.concat([buffer, Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk)]);
-            if (buffer.length > this.maxLineBytes && buffer.indexOf(0x0a) < 0) {
-                protocolError = new ClaudePrintError('Claude stream line exceeded the safety limit.', 'CLAUDE_STREAM_OVERSIZED');
-                return;
-            }
-            let newline: number;
-            while ((newline = buffer.indexOf(0x0a)) >= 0) {
-                const line = buffer.subarray(0, newline);
-                buffer = buffer.subarray(newline + 1);
-                if (line.length === 0) continue;
-                if (line.length > this.maxLineBytes) {
-                    protocolError = new ClaudePrintError('Claude stream line exceeded the safety limit.', 'CLAUDE_STREAM_OVERSIZED');
-                    return;
-                }
-                try {
-                    const value = JSON.parse(line.toString('utf8')) as unknown;
-                    if (!value || typeof value !== 'object' || Array.isArray(value)) {
-                        throw new ClaudePrintError('Claude emitted a non-object stream message.', 'CLAUDE_STREAM_INVALID');
-                    }
-                    const event = value as Record<string, unknown>;
-                    if (typeof event.session_id === 'string' && event.session_id !== request.agent.providerSessionId) {
-                        throw new ClaudePrintError('Claude returned a different session identity.', 'CLAUDE_SESSION_MISMATCH');
-                    }
-                    if (event.type === 'result') {
-                        if (terminal) throw new ClaudePrintError('Claude emitted more than one terminal result.', 'CLAUDE_STREAM_INVALID');
-                        if (typeof event.session_id !== 'string' || typeof event.result !== 'string') {
-                            throw new ClaudePrintError('Claude emitted an invalid terminal result.', 'CLAUDE_STREAM_INVALID');
-                        }
-                        terminal = { sessionId: event.session_id, result: event.result, exitCode: 0 };
-                    }
-                } catch (error) {
-                    protocolError = error instanceof ClaudePrintError
-                        ? error
-                        : new ClaudePrintError('Claude emitted malformed stream JSON.', 'CLAUDE_STREAM_INVALID');
-                    return;
-                }
-            }
-        });
-        // Drain provider diagnostics without reflecting potentially sensitive prompt/tool data.
-        child.stderr.resume();
-
-        const closed = new Promise<{ code: number | null; signal: NodeJS.Signals | null }>((resolve, reject) => {
-            child.once('error', reject);
-            child.once('close', (code, signal) => resolve({ code, signal }));
-        });
-
-        try {
-            await request.onSpawn(identity);
-        } catch (error) {
-            child.kill();
-            throw error;
-        }
-
-        child.stdin.end(request.prompt);
-        const { code, signal } = await closed;
-
-        if (protocolError) throw protocolError;
-        if (buffer.length > 0) {
-            throw new ClaudePrintError('Claude stream ended with incomplete JSON.', 'CLAUDE_STREAM_INVALID');
-        }
-        if (code !== 0) {
-            throw new ClaudePrintError(
-                `Claude print run failed${signal ? ` (${signal})` : '.'}`,
-                'CLAUDE_PROCESS_FAILED',
-            );
-        }
-        if (!terminal) throw new ClaudePrintError('Claude stream ended without a terminal result.', 'CLAUDE_RESULT_MISSING');
-        const finalResult = terminal as ClaudePrintRunResult;
-        return { sessionId: finalResult.sessionId, result: finalResult.result, exitCode: code };
-    }
-}