@seawork/server 1.0.0

package/dist/server/server/agent/providers/claude-agent.js

@@ -0,0 +1,3452 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { randomUUID } from "node:crypto";
+import fs from "node:fs";
+import { promises } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { query, } from "@anthropic-ai/claude-agent-sdk";
+import { mapClaudeCanceledToolCall, mapClaudeCompletedToolCall, mapClaudeFailedToolCall, mapClaudeRunningToolCall, } from "./claude/tool-call-mapper.js";
+import { mapTaskNotificationSystemRecordToToolCall, mapTaskNotificationUserContentToToolCall, } from "./claude/task-notification-tool-call.js";
+import { getClaudeModels, normalizeClaudeRuntimeModelId } from "./claude/claude-models.js";
+import { parsePartialJsonObject } from "./claude/partial-json.js";
+import { ClaudeSidechainTracker } from "./claude/sidechain-tracker.js";
+import { formatDiagnosticStatus, formatProviderDiagnostic, formatProviderDiagnosticError, toDiagnosticErrorMessage, } from "./diagnostic-utils.js";
+import { applyProviderEnv } from "../provider-launch-config.js";
+import { findExecutable } from "../../../utils/executable.js";
+import { spawnProcess } from "../../../utils/spawn.js";
+import { getOrchestratorModeInstructions } from "../orchestrator-instructions.js";
+const fsPromises = promises;
+const execFileAsync = promisify(execFile);
+const CLAUDE_SETTING_SOURCES = ["user", "project"];
+const CLAUDE_CAPABILITIES = {
+    supportsStreaming: true,
+    supportsSessionPersistence: true,
+    supportsDynamicModes: true,
+    supportsMcpServers: true,
+    supportsReasoningStream: true,
+    supportsToolInvocations: true,
+};
+const DEFAULT_MODES = [
+    {
+        id: "default",
+        label: "Always Ask",
+        description: "Prompts for permission the first time a tool is used",
+    },
+    {
+        id: "acceptEdits",
+        label: "Accept File Edits",
+        description: "Automatically approves edit-focused tools without prompting",
+    },
+    {
+        id: "plan",
+        label: "Plan Mode",
+        description: "Analyze the codebase without executing tools or edits",
+    },
+    {
+        id: "bypassPermissions",
+        label: "Bypass",
+        description: "Skip all permission prompts (use with caution)",
+    },
+];
+const VALID_CLAUDE_MODES = new Set(DEFAULT_MODES.map((mode) => mode.id));
+const REWIND_COMMAND_NAME = "rewind";
+const REWIND_COMMAND = {
+    name: REWIND_COMMAND_NAME,
+    description: "Rewind tracked files to a previous user message",
+    argumentHint: "[user_message_uuid]",
+};
+const INTERRUPT_TOOL_USE_PLACEHOLDER = "[Request interrupted by user for tool use]";
+const INTERRUPT_PLACEHOLDER_PATTERN = /^\[Request interrupted by user(?:[^\]]*)\]$/;
+const NO_RESPONSE_REQUESTED_PLACEHOLDER = "No response requested.";
+const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+function resolveClaudeSpawnCommand(spawnOptions, runtimeSettings) {
+    const commandConfig = runtimeSettings?.command;
+    if (!commandConfig || commandConfig.mode === "default") {
+        return {
+            command: spawnOptions.command,
+            args: [...spawnOptions.args],
+        };
+    }
+    if (commandConfig.mode === "append") {
+        return {
+            command: spawnOptions.command,
+            args: [...spawnOptions.args, ...(commandConfig.args ?? [])],
+        };
+    }
+    return {
+        command: commandConfig.argv[0],
+        args: [...commandConfig.argv.slice(1), ...spawnOptions.args],
+    };
+}
+function applyRuntimeSettingsToClaudeOptions(options, runtimeSettings, launchEnv) {
+    return {
+        ...options,
+        spawnClaudeCodeProcess: (spawnOptions) => {
+            const resolved = resolveClaudeSpawnCommand(spawnOptions, runtimeSettings);
+            // When the SDK passes a default JS runtime ("node"/"bun"), replace it with
+            // process.execPath — the actual node binary running the daemon. This avoids
+            // PATH lookup failures in the managed runtime bundle.
+            // When the SDK passes a native binary path (from pathToClaudeCodeExecutable)
+            // or the user overrides the command via runtime settings, use that directly.
+            const isDefaultRuntime = resolved.command === "node" || resolved.command === "bun";
+            const command = isDefaultRuntime ? process.execPath : resolved.command;
+            const child = spawnProcess(command, resolved.args, {
+                cwd: spawnOptions.cwd,
+                env: {
+                    ...applyProviderEnv(spawnOptions.env, runtimeSettings),
+                    ...(launchEnv ?? {}),
+                },
+                signal: spawnOptions.signal,
+                stdio: ["pipe", "pipe", "pipe"],
+                // Bypass cmd.exe on Windows: the SDK passes --mcp-config with inline JSON
+                // containing double quotes, which cmd.exe mangles (strips quotes, breaks parsing).
+                // The command is always a resolved binary path, so shell routing is unnecessary.
+                shell: false,
+            });
+            if (typeof options.stderr === "function") {
+                child.stderr?.on("data", (chunk) => {
+                    options.stderr?.(chunk.toString());
+                });
+            }
+            return child;
+        },
+    };
+}
+function isClaudeThinkingEffort(value) {
+    return value === "low" || value === "medium" || value === "high" || value === "max";
+}
+const MAX_RECENT_STDERR_CHARS = 4000;
+const STDERR_FLUSH_WAIT_MS = 150;
+const STDERR_FLUSH_POLL_INTERVAL_MS = 10;
+function summarizeClaudeOptionsForLog(options) {
+    const systemPromptRaw = options.systemPrompt;
+    const systemPromptSummary = (() => {
+        if (!systemPromptRaw) {
+            return { mode: "none", preset: null };
+        }
+        if (typeof systemPromptRaw === "string") {
+            return { mode: "string", preset: null };
+        }
+        const prompt = systemPromptRaw;
+        const promptType = typeof prompt.type === "string" ? prompt.type : "custom";
+        return {
+            mode: promptType === "preset" ? "preset" : "custom",
+            preset: typeof prompt.preset === "string" && prompt.preset.length > 0 ? prompt.preset : null,
+        };
+    })();
+    const mcpServerNames = options.mcpServers ? Object.keys(options.mcpServers).sort() : [];
+    return {
+        cwd: typeof options.cwd === "string" ? options.cwd : null,
+        permissionMode: typeof options.permissionMode === "string" ? options.permissionMode : null,
+        model: typeof options.model === "string" ? options.model : null,
+        includePartialMessages: options.includePartialMessages === true,
+        settingSources: Array.isArray(options.settingSources) ? options.settingSources : [],
+        enableFileCheckpointing: options.enableFileCheckpointing === true,
+        hasResume: typeof options.resume === "string" && options.resume.length > 0,
+        maxThinkingTokens: typeof options.maxThinkingTokens === "number" ? options.maxThinkingTokens : null,
+        hasEnv: !!options.env,
+        envKeyCount: Object.keys(options.env ?? {}).length,
+        hasMcpServers: mcpServerNames.length > 0,
+        mcpServerNames,
+        systemPromptMode: systemPromptSummary.mode,
+        systemPromptPreset: systemPromptSummary.preset,
+        hasCanUseTool: typeof options.canUseTool === "function",
+        hasSpawnOverride: typeof options.spawnClaudeCodeProcess === "function",
+        hasStderrHandler: typeof options.stderr === "function",
+        pathToClaudeCodeExecutable: typeof options.pathToClaudeCodeExecutable === "string"
+            ? options.pathToClaudeCodeExecutable
+            : null,
+    };
+}
+function isToolResultTextBlock(value) {
+    return (!!value &&
+        typeof value === "object" &&
+        value.type === "text" &&
+        typeof value.text === "string");
+}
+function normalizeForDeterministicString(value, seen) {
+    if (value === null ||
+        typeof value === "string" ||
+        typeof value === "number" ||
+        typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "bigint") {
+        return value.toString();
+    }
+    if (typeof value === "function") {
+        return "[function]";
+    }
+    if (typeof value === "symbol") {
+        return value.toString();
+    }
+    if (typeof value === "undefined") {
+        return "[undefined]";
+    }
+    if (Array.isArray(value)) {
+        return value.map((entry) => normalizeForDeterministicString(entry, seen));
+    }
+    if (typeof value === "object") {
+        const objectValue = value;
+        if (seen.has(objectValue)) {
+            return "[circular]";
+        }
+        seen.add(objectValue);
+        const record = value;
+        const normalized = {};
+        for (const key of Object.keys(record).sort()) {
+            normalized[key] = normalizeForDeterministicString(record[key], seen);
+        }
+        seen.delete(objectValue);
+        return normalized;
+    }
+    return String(value);
+}
+function deterministicStringify(value) {
+    if (typeof value === "undefined") {
+        return "";
+    }
+    try {
+        const normalized = normalizeForDeterministicString(value, new WeakSet());
+        if (typeof normalized === "string") {
+            return normalized;
+        }
+        return JSON.stringify(normalized);
+    }
+    catch {
+        try {
+            return String(value);
+        }
+        catch {
+            return "[unserializable]";
+        }
+    }
+}
+function coerceToolResultContentToString(content) {
+    if (typeof content === "string") {
+        return content;
+    }
+    if (Array.isArray(content) && content.every((block) => isToolResultTextBlock(block))) {
+        return content.map((block) => block.text).join("");
+    }
+    return deterministicStringify(content);
+}
+function normalizeClaudeTranscriptText(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const normalized = value.trim();
+    return normalized.length > 0 ? normalized : null;
+}
+function isClaudeInterruptPlaceholderText(value) {
+    const normalized = normalizeClaudeTranscriptText(value);
+    return normalized !== null && INTERRUPT_PLACEHOLDER_PATTERN.test(normalized);
+}
+function isClaudeNoResponsePlaceholderText(value) {
+    return normalizeClaudeTranscriptText(value) === NO_RESPONSE_REQUESTED_PLACEHOLDER;
+}
+const LOCAL_COMMAND_STDOUT_PATTERN = /^\s*<local-command-stdout>[\s\S]*<\/local-command-stdout>\s*$/;
+function isClaudeLocalCommandStdout(value) {
+    const normalized = normalizeClaudeTranscriptText(value);
+    return normalized !== null && LOCAL_COMMAND_STDOUT_PATTERN.test(normalized);
+}
+function isClaudeTranscriptNoiseText(value) {
+    return (isClaudeInterruptPlaceholderText(value) ||
+        isClaudeNoResponsePlaceholderText(value) ||
+        isClaudeLocalCommandStdout(value));
+}
+function collectClaudeTextContentParts(content) {
+    if (typeof content === "string") {
+        const normalized = normalizeClaudeTranscriptText(content);
+        return normalized ? [normalized] : [];
+    }
+    if (!Array.isArray(content)) {
+        return [];
+    }
+    const parts = [];
+    for (const block of content) {
+        if (!block || typeof block !== "object") {
+            continue;
+        }
+        const text = normalizeClaudeTranscriptText(block.text);
+        if (text) {
+            parts.push(text);
+            continue;
+        }
+        const input = normalizeClaudeTranscriptText(block.input);
+        if (input) {
+            parts.push(input);
+        }
+    }
+    return parts;
+}
+function isClaudeTranscriptNoiseContent(content) {
+    const parts = collectClaudeTextContentParts(content);
+    return parts.length > 0 && parts.every((part) => isClaudeTranscriptNoiseText(part));
+}
+export function extractUserMessageText(content) {
+    if (typeof content === "string") {
+        const normalized = content.trim();
+        if (!normalized || isClaudeTranscriptNoiseText(normalized)) {
+            return null;
+        }
+        return normalized;
+    }
+    if (!Array.isArray(content)) {
+        return null;
+    }
+    const parts = [];
+    for (const block of content) {
+        if (!block || typeof block !== "object") {
+            continue;
+        }
+        const text = typeof block.text === "string" ? block.text : undefined;
+        if (text && text.trim()) {
+            const trimmed = text.trim();
+            if (!isClaudeTranscriptNoiseText(trimmed)) {
+                parts.push(trimmed);
+            }
+            continue;
+        }
+        const input = typeof block.input === "string" ? block.input : undefined;
+        if (input && input.trim()) {
+            const trimmed = input.trim();
+            if (!isClaudeTranscriptNoiseText(trimmed)) {
+                parts.push(trimmed);
+            }
+        }
+    }
+    if (parts.length === 0) {
+        return null;
+    }
+    const combined = parts.join("\n\n").trim();
+    return combined.length > 0 ? combined : null;
+}
+function isMetadata(value) {
+    return typeof value === "object" && value !== null;
+}
+function readTrimmedString(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function isMcpServerConfig(value) {
+    if (!isMetadata(value)) {
+        return false;
+    }
+    const type = value.type;
+    if (type === "stdio") {
+        return typeof value.command === "string";
+    }
+    if (type === "http" || type === "sse") {
+        return typeof value.url === "string";
+    }
+    return false;
+}
+function isMcpServersRecord(value) {
+    if (!isMetadata(value)) {
+        return false;
+    }
+    for (const config of Object.values(value)) {
+        if (!isMcpServerConfig(config)) {
+            return false;
+        }
+    }
+    return true;
+}
+function isPermissionMode(value) {
+    return typeof value === "string" && VALID_CLAUDE_MODES.has(value);
+}
+function coerceSessionMetadata(metadata) {
+    if (!isMetadata(metadata)) {
+        return {};
+    }
+    const result = {};
+    if (metadata.provider === "claude" || metadata.provider === "codex") {
+        result.provider = metadata.provider;
+    }
+    if (typeof metadata.cwd === "string") {
+        result.cwd = metadata.cwd;
+    }
+    if (typeof metadata.modeId === "string") {
+        result.modeId = metadata.modeId;
+    }
+    if (typeof metadata.model === "string") {
+        result.model = metadata.model;
+    }
+    if (typeof metadata.title === "string" || metadata.title === null) {
+        result.title = metadata.title;
+    }
+    if (typeof metadata.approvalPolicy === "string") {
+        result.approvalPolicy = metadata.approvalPolicy;
+    }
+    if (typeof metadata.sandboxMode === "string") {
+        result.sandboxMode = metadata.sandboxMode;
+    }
+    if (typeof metadata.networkAccess === "boolean") {
+        result.networkAccess = metadata.networkAccess;
+    }
+    if (typeof metadata.webSearch === "boolean") {
+        result.webSearch = metadata.webSearch;
+    }
+    if (isMetadata(metadata.extra)) {
+        const extra = {};
+        if (isMetadata(metadata.extra.codex)) {
+            extra.codex = metadata.extra.codex;
+        }
+        if (isClaudeExtra(metadata.extra.claude)) {
+            extra.claude = metadata.extra.claude;
+        }
+        if (extra.codex || extra.claude) {
+            result.extra = extra;
+        }
+    }
+    if (typeof metadata.systemPrompt === "string") {
+        result.systemPrompt = metadata.systemPrompt;
+    }
+    if (isMcpServersRecord(metadata.mcpServers)) {
+        result.mcpServers = metadata.mcpServers;
+    }
+    return result;
+}
+function toClaudeSdkMcpConfig(config) {
+    switch (config.type) {
+        case "stdio":
+            return {
+                type: "stdio",
+                command: config.command,
+                args: config.args,
+                env: config.env,
+            };
+        case "http":
+            return {
+                type: "http",
+                url: config.url,
+                headers: config.headers,
+            };
+        case "sse":
+            return {
+                type: "sse",
+                url: config.url,
+                headers: config.headers,
+            };
+    }
+}
+function isClaudeContentChunk(value) {
+    return isMetadata(value) && typeof value.type === "string";
+}
+function isClaudeExtra(value) {
+    return isMetadata(value);
+}
+function isPermissionUpdate(value) {
+    if (!isMetadata(value)) {
+        return false;
+    }
+    const type = value.type;
+    if (type !== "addRules" && type !== "replaceRules" && type !== "removeRules") {
+        return false;
+    }
+    const rules = value.rules;
+    const behavior = value.behavior;
+    const destination = value.destination;
+    return Array.isArray(rules) && typeof behavior === "string" && typeof destination === "string";
+}
+function resolvePermissionKind(toolName, input) {
+    if (toolName === "ExitPlanMode")
+        return "plan";
+    if (toolName === "AskUserQuestion" && Array.isArray(input.questions)) {
+        return "question";
+    }
+    return "tool";
+}
+function getClaudeModeLabel(modeId) {
+    return DEFAULT_MODES.find((mode) => mode.id === modeId)?.label ?? modeId;
+}
+function buildClaudePlanPermissionActions(resumeMode) {
+    const actions = [
+        {
+            id: "reject",
+            label: "Reject",
+            behavior: "deny",
+            variant: "danger",
+            intent: "dismiss",
+        },
+        {
+            id: "implement",
+            label: "Implement",
+            behavior: "allow",
+            variant: "primary",
+            intent: "implement",
+        },
+    ];
+    if (resumeMode === "bypassPermissions") {
+        actions.push({
+            id: "implement_resume",
+            label: `Implement with ${getClaudeModeLabel(resumeMode)}`,
+            behavior: "allow",
+            variant: "secondary",
+            intent: "implement_resume",
+        });
+    }
+    return actions;
+}
+class TimelineAssembler {
+    constructor() {
+        this.messages = new Map();
+        this.finalizedMessageIds = new Set();
+        this.activeMessageByRun = new Map();
+        this.syntheticMessageCounter = 0;
+    }
+    consume(input) {
+        if (input.message.type === "assistant") {
+            return this.consumeAssistantMessage(input.message, input.runId, input.messageIdHint ?? null);
+        }
+        if (input.message.type === "stream_event") {
+            return this.consumeStreamEvent(input.message, input.runId, input.messageIdHint ?? null);
+        }
+        return [];
+    }
+    consumeAssistantMessage(message, runId, messageIdHint) {
+        const messageId = this.readMessageIdFromAssistantMessage(message) ??
+            messageIdHint ??
+            this.resolveMessageId({ runId, createIfMissing: true, messageId: null });
+        if (!messageId) {
+            return [];
+        }
+        if (this.finalizedMessageIds.has(messageId)) {
+            return [];
+        }
+        const state = this.ensureMessageState(messageId, runId);
+        const fragments = this.extractFragments(message.message?.content);
+        return this.applyAbsoluteFragments(state, fragments);
+    }
+    consumeStreamEvent(message, runId, messageIdHint) {
+        const event = message.event;
+        const eventType = readTrimmedString(event.type);
+        const streamEventMessageId = this.readMessageIdFromStreamEvent(event) ?? messageIdHint;
+        if (eventType === "message_start") {
+            const messageId = this.resolveMessageId({
+                runId,
+                createIfMissing: true,
+                messageId: streamEventMessageId,
+            });
+            if (!messageId) {
+                return [];
+            }
+            this.ensureMessageState(messageId, runId);
+            return [];
+        }
+        if (eventType === "message_stop") {
+            const messageId = this.resolveMessageId({
+                runId,
+                createIfMissing: false,
+                messageId: streamEventMessageId,
+            });
+            if (!messageId) {
+                return [];
+            }
+            return this.finalizeMessage(messageId, runId);
+        }
+        if (eventType === "content_block_start") {
+            return this.consumeDeltaContent(event.content_block, runId, streamEventMessageId);
+        }
+        if (eventType === "content_block_delta") {
+            return this.consumeDeltaContent(event.delta, runId, streamEventMessageId);
+        }
+        return [];
+    }
+    consumeDeltaContent(content, runId, messageIdHint) {
+        const fragments = this.extractFragments(content);
+        if (fragments.length === 0) {
+            return [];
+        }
+        const messageId = this.resolveMessageId({
+            runId,
+            createIfMissing: true,
+            messageId: messageIdHint,
+        });
+        if (!messageId) {
+            return [];
+        }
+        const state = this.ensureMessageState(messageId, runId);
+        return this.appendFragments(state, fragments);
+    }
+    appendFragments(state, fragments) {
+        for (const fragment of fragments) {
+            if (fragment.kind === "assistant") {
+                state.assistantText += fragment.text;
+            }
+            else {
+                state.reasoningText += fragment.text;
+            }
+        }
+        return this.emitNewContent(state);
+    }
+    applyAbsoluteFragments(state, fragments) {
+        const assistantText = fragments
+            .filter((fragment) => fragment.kind === "assistant")
+            .map((fragment) => fragment.text)
+            .join("");
+        const reasoningText = fragments
+            .filter((fragment) => fragment.kind === "reasoning")
+            .map((fragment) => fragment.text)
+            .join("");
+        if (assistantText.length > 0) {
+            if (!assistantText.startsWith(state.assistantText)) {
+                state.emittedAssistantLength = 0;
+            }
+            state.assistantText = assistantText;
+        }
+        if (reasoningText.length > 0) {
+            if (!reasoningText.startsWith(state.reasoningText)) {
+                state.emittedReasoningLength = 0;
+            }
+            state.reasoningText = reasoningText;
+        }
+        return this.emitNewContent(state);
+    }
+    finalizeMessage(messageId, runId) {
+        const state = this.messages.get(messageId);
+        if (!state) {
+            return [];
+        }
+        state.stopped = true;
+        const items = this.emitNewContent(state);
+        if (runId && this.activeMessageByRun.get(runId) === messageId) {
+            this.activeMessageByRun.delete(runId);
+        }
+        this.finalizedMessageIds.add(messageId);
+        this.messages.delete(messageId);
+        return items;
+    }
+    emitNewContent(state) {
+        const items = [];
+        const nextAssistantText = state.assistantText.slice(state.emittedAssistantLength);
+        if (nextAssistantText.length > 0 &&
+            nextAssistantText !== INTERRUPT_TOOL_USE_PLACEHOLDER &&
+            !isClaudeTranscriptNoiseText(nextAssistantText)) {
+            state.emittedAssistantLength = state.assistantText.length;
+            items.push({ type: "assistant_message", text: nextAssistantText });
+        }
+        const nextReasoningText = state.reasoningText.slice(state.emittedReasoningLength);
+        if (nextReasoningText.length > 0) {
+            state.emittedReasoningLength = state.reasoningText.length;
+            items.push({ type: "reasoning", text: nextReasoningText });
+        }
+        return items;
+    }
+    ensureMessageState(messageId, runId) {
+        const existing = this.messages.get(messageId);
+        if (existing) {
+            existing.stopped = false;
+            if (runId) {
+                this.activeMessageByRun.set(runId, messageId);
+            }
+            return existing;
+        }
+        const created = {
+            id: messageId,
+            assistantText: "",
+            reasoningText: "",
+            emittedAssistantLength: 0,
+            emittedReasoningLength: 0,
+            stopped: false,
+        };
+        this.messages.set(messageId, created);
+        if (runId) {
+            this.activeMessageByRun.set(runId, messageId);
+        }
+        return created;
+    }
+    resolveMessageId(input) {
+        if (input.messageId) {
+            return input.messageId;
+        }
+        if (input.runId) {
+            const active = this.activeMessageByRun.get(input.runId);
+            if (active) {
+                return active;
+            }
+        }
+        if (!input.createIfMissing) {
+            return null;
+        }
+        const synthetic = `synthetic-message-${++this.syntheticMessageCounter}`;
+        if (input.runId) {
+            this.activeMessageByRun.set(input.runId, synthetic);
+        }
+        return synthetic;
+    }
+    extractFragments(content) {
+        if (typeof content === "string") {
+            if (content.length === 0) {
+                return [];
+            }
+            return [{ kind: "assistant", text: content }];
+        }
+        const blocks = Array.isArray(content) ? content : [content];
+        const fragments = [];
+        for (const rawBlock of blocks) {
+            if (!isClaudeContentChunk(rawBlock)) {
+                continue;
+            }
+            if ((rawBlock.type === "text" || rawBlock.type === "text_delta") &&
+                typeof rawBlock.text === "string" &&
+                rawBlock.text.length > 0) {
+                fragments.push({ kind: "assistant", text: rawBlock.text });
+            }
+            if ((rawBlock.type === "thinking" || rawBlock.type === "thinking_delta") &&
+                typeof rawBlock.thinking === "string" &&
+                rawBlock.thinking.length > 0) {
+                fragments.push({ kind: "reasoning", text: rawBlock.thinking });
+            }
+        }
+        return fragments;
+    }
+    readMessageIdFromAssistantMessage(message) {
+        const candidate = message;
+        return (readTrimmedString(candidate.message_id) ?? readTrimmedString(candidate.message?.id) ?? null);
+    }
+    readMessageIdFromStreamEvent(event) {
+        const message = event.message;
+        return readTrimmedString(event.message_id) ?? readTrimmedString(message?.id) ?? null;
+    }
+}
+function isSyntheticUserEntry(entry) {
+    if (!entry || typeof entry !== "object") {
+        return false;
+    }
+    const candidate = entry;
+    return candidate.isSynthetic === true || candidate.isMeta === true;
+}
+export function readEventIdentifiers(message) {
+    const root = message;
+    const messageType = readTrimmedString(root.type);
+    const streamEvent = root.event;
+    const streamEventMessage = streamEvent?.message;
+    const messageContainer = root.message;
+    return {
+        taskId: readTrimmedString(root.task_id) ??
+            readTrimmedString(streamEvent?.task_id) ??
+            readTrimmedString(streamEventMessage?.task_id) ??
+            readTrimmedString(messageContainer?.task_id) ??
+            null,
+        parentMessageId: readTrimmedString(root.parent_message_id) ??
+            readTrimmedString(streamEvent?.parent_message_id) ??
+            readTrimmedString(streamEventMessage?.parent_message_id) ??
+            readTrimmedString(messageContainer?.parent_message_id) ??
+            null,
+        messageId: readTrimmedString(root.message_id) ??
+            readTrimmedString(streamEvent?.message_id) ??
+            readTrimmedString(streamEventMessage?.id) ??
+            readTrimmedString(streamEventMessage?.message_id) ??
+            readTrimmedString(messageContainer?.id) ??
+            readTrimmedString(messageContainer?.message_id) ??
+            (messageType === "user" ? readTrimmedString(root.uuid) : null) ??
+            null,
+    };
+}
+const claudeDebug = process.env.SEAWORK_CLAUDE_DEBUG === "1";
+export class ClaudeAgentClient {
+    constructor(options) {
+        this.provider = "claude";
+        this.capabilities = CLAUDE_CAPABILITIES;
+        this.defaults = options.defaults;
+        this.logger = options.logger.child({ module: "agent", provider: "claude" });
+        this.runtimeSettings = options.runtimeSettings;
+        this.queryFactory = options.queryFactory ?? query;
+    }
+    async createSession(config, launchContext) {
+        const claudeConfig = this.assertConfig(config);
+        return new ClaudeAgentSession(claudeConfig, {
+            defaults: this.defaults,
+            runtimeSettings: this.runtimeSettings,
+            launchEnv: launchContext?.env,
+            logger: this.logger,
+            queryFactory: this.queryFactory,
+        });
+    }
+    async resumeSession(handle, overrides, launchContext) {
+        const metadata = coerceSessionMetadata(handle.metadata);
+        const merged = { ...metadata, ...overrides };
+        if (!merged.cwd) {
+            throw new Error("Claude resume requires the original working directory in metadata");
+        }
+        const mergedConfig = { ...merged, provider: "claude", cwd: merged.cwd };
+        const claudeConfig = this.assertConfig(mergedConfig);
+        return new ClaudeAgentSession(claudeConfig, {
+            defaults: this.defaults,
+            runtimeSettings: this.runtimeSettings,
+            handle,
+            launchEnv: launchContext?.env,
+            logger: this.logger,
+            queryFactory: this.queryFactory,
+        });
+    }
+    async listModels(_options) {
+        return getClaudeModels();
+    }
+    async listPersistedAgents(options) {
+        const configDir = process.env.CLAUDE_CONFIG_DIR ?? path.join(os.homedir(), ".claude");
+        const projectsRoot = path.join(configDir, "projects");
+        if (!(await pathExists(projectsRoot))) {
+            return [];
+        }
+        const limit = options?.limit ?? 20;
+        const candidates = await collectRecentClaudeSessions(projectsRoot, limit * 3);
+        const descriptors = [];
+        for (const candidate of candidates) {
+            const descriptor = await parseClaudeSessionDescriptor(candidate.path, candidate.mtime);
+            if (descriptor) {
+                descriptors.push(descriptor);
+            }
+            if (descriptors.length >= limit) {
+                break;
+            }
+        }
+        return descriptors;
+    }
+    async isAvailable() {
+        const command = this.runtimeSettings?.command;
+        if (command?.mode === "replace") {
+            return fs.existsSync(command.argv[0]);
+        }
+        return true;
+    }
+    async getDiagnostic() {
+        try {
+            const resolvedBinary = (await findExecutable("claude")) ?? "not found";
+            const available = await this.isAvailable();
+            const version = await resolveClaudeVersion(this.runtimeSettings);
+            let modelsValue = "Not checked";
+            let status = formatDiagnosticStatus(available);
+            if (available) {
+                try {
+                    const models = await this.listModels();
+                    modelsValue = String(models.length);
+                }
+                catch (error) {
+                    modelsValue = `Error - ${toDiagnosticErrorMessage(error)}`;
+                    status = formatDiagnosticStatus(available, {
+                        source: "model fetch",
+                        cause: error,
+                    });
+                }
+            }
+            return {
+                diagnostic: formatProviderDiagnostic("Claude Code", [
+                    { label: "Binary", value: resolvedBinary },
+                    ...(version ? [{ label: "Version", value: version }] : []),
+                    { label: "Models", value: modelsValue },
+                    { label: "Status", value: status },
+                ]),
+            };
+        }
+        catch (error) {
+            return {
+                diagnostic: formatProviderDiagnosticError("Claude Code", error),
+            };
+        }
+    }
+    assertConfig(config) {
+        if (config.provider !== "claude") {
+            throw new Error(`ClaudeAgentClient received config for provider '${config.provider}'`);
+        }
+        return { ...config, provider: "claude" };
+    }
+}
+async function resolveClaudeVersion(runtimeSettings) {
+    const command = runtimeSettings?.command;
+    try {
+        if (command?.mode === "replace") {
+            const { stdout } = await execFileAsync(command.argv[0], [...command.argv.slice(1), "--version"], {
+                encoding: "utf8",
+                timeout: 5000,
+                windowsHide: true,
+            });
+            return stdout.trim() || null;
+        }
+        const executable = await findExecutable("claude");
+        if (!executable) {
+            return null;
+        }
+        const { stdout } = await execFileAsync(executable, ["--version"], {
+            encoding: "utf8",
+            timeout: 5000,
+            windowsHide: true,
+        });
+        return stdout.trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+function extractContextWindowSize(modelUsage) {
+    if (!modelUsage || typeof modelUsage !== "object") {
+        return undefined;
+    }
+    let maxContextWindow;
+    for (const value of Object.values(modelUsage)) {
+        if (!value || typeof value !== "object") {
+            continue;
+        }
+        const contextWindow = value.contextWindow;
+        if (typeof contextWindow !== "number" ||
+            !Number.isFinite(contextWindow) ||
+            contextWindow <= 0) {
+            continue;
+        }
+        maxContextWindow = Math.max(maxContextWindow ?? 0, contextWindow);
+    }
+    return maxContextWindow;
+}
+function readUsageTotalTokens(usage) {
+    if (!usage || typeof usage !== "object") {
+        return undefined;
+    }
+    const totalTokens = usage.total_tokens;
+    if (typeof totalTokens !== "number" || !Number.isFinite(totalTokens) || totalTokens < 0) {
+        return undefined;
+    }
+    return totalTokens;
+}
+function readContextWindowUsedTokensFromTaskProgress(message) {
+    return readUsageTotalTokens(message.usage);
+}
+function readUsageFromTaskNotification(message) {
+    return readUsageTotalTokens(message.usage);
+}
+function readStreamRequestInputTokens(event) {
+    const messageUsage = event.message?.usage;
+    if (!messageUsage || typeof messageUsage !== "object") {
+        return undefined;
+    }
+    const usage = messageUsage;
+    const inputTokens = typeof usage.input_tokens === "number" && Number.isFinite(usage.input_tokens)
+        ? usage.input_tokens
+        : undefined;
+    const cacheCreationInputTokens = typeof usage.cache_creation_input_tokens === "number" &&
+        Number.isFinite(usage.cache_creation_input_tokens)
+        ? usage.cache_creation_input_tokens
+        : 0;
+    const cacheReadInputTokens = typeof usage.cache_read_input_tokens === "number" &&
+        Number.isFinite(usage.cache_read_input_tokens)
+        ? usage.cache_read_input_tokens
+        : 0;
+    if (typeof inputTokens !== "number" || inputTokens < 0) {
+        return undefined;
+    }
+    return inputTokens + cacheCreationInputTokens + cacheReadInputTokens;
+}
+function readStreamRequestOutputTokens(event) {
+    const outputTokens = event.usage?.output_tokens;
+    if (typeof outputTokens !== "number" || !Number.isFinite(outputTokens) || outputTokens < 0) {
+        return undefined;
+    }
+    return outputTokens;
+}
+class ClaudeAgentSession {
+    constructor(config, options) {
+        this.provider = "claude";
+        this.capabilities = CLAUDE_CAPABILITIES;
+        this.query = null;
+        this.input = null;
+        this.planResumeMode = null;
+        this.availableModes = DEFAULT_MODES;
+        this.toolUseCache = new Map();
+        this.toolUseIndexToId = new Map();
+        this.toolUseInputBuffers = new Map();
+        this.pendingPermissions = new Map();
+        this.activeForegroundTurnId = null;
+        this.autonomousTurn = null;
+        this.subscribers = new Set();
+        this.timelineAssembler = new TimelineAssembler();
+        this.sidechainTracker = new ClaudeSidechainTracker({
+            getToolInput: (toolUseId) => this.toolUseCache.get(toolUseId)?.input ?? null,
+        });
+        this.persistedHistory = [];
+        this.historyPending = false;
+        this.turnState = "idle";
+        this.nextTurnOrdinal = 1;
+        this.cancelCurrentTurn = null;
+        this.cachedRuntimeInfo = null;
+        this.lastOptionsModel = null;
+        this.lastRuntimeModel = null;
+        this.compacting = false;
+        this.queryPumpPromise = null;
+        this.queryRestartNeeded = false;
+        this.pendingInterruptAbort = false;
+        this.lastForegroundPromptText = null;
+        this.foregroundHasVisibleActivity = false;
+        this.userMessageIds = [];
+        this.recentStderr = "";
+        this.closed = false;
+        this.handlePermissionRequest = async (toolName, input, options) => {
+            const requestId = `permission-${randomUUID()}`;
+            const kind = resolvePermissionKind(toolName, input);
+            const metadata = {};
+            if (options.toolUseID) {
+                metadata.toolUseId = options.toolUseID;
+            }
+            if (toolName === "ExitPlanMode" && typeof input.plan === "string") {
+                metadata.planText = input.plan;
+            }
+            const toolDetail = kind === "tool"
+                ? mapClaudeRunningToolCall({
+                    name: toolName,
+                    callId: options.toolUseID ?? requestId,
+                    input,
+                    output: null,
+                })?.detail
+                : undefined;
+            const request = {
+                id: requestId,
+                provider: "claude",
+                name: toolName,
+                kind,
+                input,
+                detail: toolDetail,
+                suggestions: options.suggestions?.map((suggestion) => ({ ...suggestion })),
+                actions: kind === "plan" ? buildClaudePlanPermissionActions(this.planResumeMode) : undefined,
+                metadata: Object.keys(metadata).length ? metadata : undefined,
+            };
+            this.pushEvent({ type: "permission_requested", provider: "claude", request });
+            return await new Promise((resolve, reject) => {
+                const cleanupFns = [];
+                const cleanup = () => {
+                    while (cleanupFns.length) {
+                        const fn = cleanupFns.pop();
+                        try {
+                            fn?.();
+                        }
+                        catch {
+                            // ignore cleanup errors
+                        }
+                    }
+                };
+                const abortHandler = () => {
+                    this.pendingPermissions.delete(requestId);
+                    cleanup();
+                    reject(new Error("Permission request aborted"));
+                };
+                if (options?.signal) {
+                    if (options.signal.aborted) {
+                        abortHandler();
+                        return;
+                    }
+                    options.signal.addEventListener("abort", abortHandler, { once: true });
+                    cleanupFns.push(() => options.signal?.removeEventListener("abort", abortHandler));
+                }
+                this.pendingPermissions.set(requestId, {
+                    request,
+                    resolve,
+                    reject,
+                    cleanup,
+                });
+            });
+        };
+        this.config = config;
+        this.launchEnv = options.launchEnv;
+        this.defaults = options.defaults;
+        this.runtimeSettings = options.runtimeSettings;
+        this.logger = options.logger;
+        this.queryFactory = options.queryFactory ?? query;
+        const handle = options.handle;
+        if (handle) {
+            if (!handle.sessionId) {
+                throw new Error("Cannot resume: persistence handle has no sessionId");
+            }
+            this.claudeSessionId = handle.sessionId;
+            this.persistence = handle;
+            this.loadPersistedHistory(handle.sessionId);
+        }
+        else {
+            this.claudeSessionId = null;
+            this.persistence = null;
+        }
+        // Validate mode if provided
+        if (config.modeId && !VALID_CLAUDE_MODES.has(config.modeId)) {
+            const validModesList = Array.from(VALID_CLAUDE_MODES).join(", ");
+            throw new Error(`Invalid mode '${config.modeId}' for Claude provider. Valid modes: ${validModesList}`);
+        }
+        this.currentMode = isPermissionMode(config.modeId) ? config.modeId : "default";
+        if (this.currentMode !== "plan") {
+            this.planResumeMode = this.currentMode;
+        }
+    }
+    get id() {
+        return this.claudeSessionId;
+    }
+    async getRuntimeInfo() {
+        if (this.cachedRuntimeInfo) {
+            return { ...this.cachedRuntimeInfo };
+        }
+        const info = {
+            provider: "claude",
+            sessionId: this.claudeSessionId,
+            model: this.lastOptionsModel,
+            modeId: this.currentMode ?? null,
+            ...(this.lastRuntimeModel
+                ? {
+                    extra: {
+                        runtimeModel: this.lastRuntimeModel,
+                    },
+                }
+                : {}),
+        };
+        this.cachedRuntimeInfo = info;
+        return { ...info };
+    }
+    async run(prompt, options) {
+        const timeline = [];
+        let finalText = "";
+        let usage;
+        let turnId = null;
+        const bufferedEvents = [];
+        let settled = false;
+        let resolveCompletion;
+        let rejectCompletion;
+        const processEvent = (event) => {
+            if (settled) {
+                return;
+            }
+            const eventTurnId = event.turnId;
+            if (turnId && eventTurnId && eventTurnId !== turnId) {
+                return;
+            }
+            if (event.type === "timeline") {
+                timeline.push(event.item);
+                if (event.item.type === "assistant_message") {
+                    if (!finalText) {
+                        finalText = event.item.text;
+                    }
+                    else if (event.item.text.startsWith(finalText)) {
+                        finalText = event.item.text;
+                    }
+                    else {
+                        finalText += event.item.text;
+                    }
+                }
+                return;
+            }
+            if (event.type === "turn_completed") {
+                usage = event.usage;
+                settled = true;
+                resolveCompletion();
+                return;
+            }
+            if (event.type === "turn_failed") {
+                settled = true;
+                rejectCompletion(new Error(event.error));
+                return;
+            }
+            if (event.type === "turn_canceled") {
+                settled = true;
+                resolveCompletion();
+            }
+        };
+        const completion = new Promise((resolve, reject) => {
+            resolveCompletion = resolve;
+            rejectCompletion = reject;
+        });
+        const unsubscribe = this.subscribe((event) => {
+            if (!turnId) {
+                bufferedEvents.push(event);
+                return;
+            }
+            processEvent(event);
+        });
+        try {
+            const result = await this.startTurn(prompt, options);
+            turnId = result.turnId;
+            for (const event of bufferedEvents) {
+                processEvent(event);
+            }
+            if (!settled) {
+                await completion;
+            }
+        }
+        finally {
+            unsubscribe();
+        }
+        this.cachedRuntimeInfo = {
+            provider: "claude",
+            sessionId: this.claudeSessionId,
+            model: this.lastOptionsModel,
+            modeId: this.currentMode ?? null,
+        };
+        if (!this.claudeSessionId) {
+            throw new Error("Session ID not set after run completed");
+        }
+        return {
+            sessionId: this.claudeSessionId,
+            finalText,
+            usage,
+            timeline,
+        };
+    }
+    async startTurn(prompt, _options) {
+        if (this.closed) {
+            throw new Error("Claude session is closed");
+        }
+        if (this.activeForegroundTurnId) {
+            throw new Error("A foreground turn is already active");
+        }
+        const slashCommand = this.resolveSlashCommandInvocation(prompt);
+        if (slashCommand?.commandName === REWIND_COMMAND_NAME) {
+            const turnId = this.createTurnId("foreground");
+            this.activeForegroundTurnId = turnId;
+            this.transitionTurnState("foreground", "rewind command");
+            void this.executeRewindTurn(turnId, slashCommand);
+            return { turnId };
+        }
+        if (this.autonomousTurn) {
+            this.completeAutonomousTurn();
+        }
+        const sdkMessage = this.toSdkUserMessage(prompt);
+        this.lastForegroundPromptText = this.extractPromptText(prompt);
+        const turnId = this.createTurnId("foreground");
+        this.activeForegroundTurnId = turnId;
+        this.foregroundHasVisibleActivity = false;
+        this.transitionTurnState("foreground", "foreground turn started");
+        this.clearRecentStderr();
+        let cancelIssued = false;
+        const requestCancel = () => {
+            if (cancelIssued) {
+                return;
+            }
+            cancelIssued = true;
+            if (this.cancelCurrentTurn === requestCancel) {
+                this.cancelCurrentTurn = null;
+            }
+            this.rejectAllPendingPermissions(new Error("Permission request aborted"));
+            this.finishForegroundTurn({
+                type: "turn_canceled",
+                provider: "claude",
+                reason: "Interrupted",
+            });
+            void this.interruptActiveTurn().catch((error) => {
+                this.logger.warn({ err: error }, "Failed to interrupt during cancel");
+            });
+        };
+        this.cancelCurrentTurn = requestCancel;
+        this.notifySubscribers({ type: "turn_started", provider: "claude" });
+        try {
+            await this.ensureQuery();
+            if (!this.input) {
+                throw new Error("Claude session input stream not initialized");
+            }
+            this.startQueryPump();
+            this.input.push(sdkMessage);
+        }
+        catch (error) {
+            this.finishForegroundTurn(this.buildTurnFailedEvent(error instanceof Error ? error.message : "Claude stream failed"));
+        }
+        return { turnId };
+    }
+    subscribe(callback) {
+        this.subscribers.add(callback);
+        return () => {
+            this.subscribers.delete(callback);
+        };
+    }
+    async interrupt() {
+        if (this.cancelCurrentTurn) {
+            this.cancelCurrentTurn();
+            return;
+        }
+        if (this.autonomousTurn) {
+            this.flushPendingToolCalls();
+            this.completeAutonomousTurn();
+        }
+        await this.interruptActiveTurn();
+    }
+    async *streamHistory() {
+        if (!this.historyPending || this.persistedHistory.length === 0) {
+            return;
+        }
+        const history = this.persistedHistory;
+        this.persistedHistory = [];
+        this.historyPending = false;
+        for (const item of history) {
+            yield { type: "timeline", item, provider: "claude" };
+        }
+    }
+    async getAvailableModes() {
+        return this.availableModes;
+    }
+    async getCurrentMode() {
+        return this.currentMode ?? null;
+    }
+    async setMode(modeId) {
+        // Validate mode
+        if (!VALID_CLAUDE_MODES.has(modeId)) {
+            const validModesList = Array.from(VALID_CLAUDE_MODES).join(", ");
+            throw new Error(`Invalid mode '${modeId}' for Claude provider. Valid modes: ${validModesList}`);
+        }
+        const normalized = isPermissionMode(modeId) ? modeId : "default";
+        const previousMode = this.currentMode;
+        const query = await this.ensureQuery();
+        await query.setPermissionMode(normalized);
+        if (normalized === "plan") {
+            if (previousMode !== "plan") {
+                this.planResumeMode = previousMode;
+            }
+        }
+        else {
+            this.planResumeMode = normalized;
+        }
+        this.currentMode = normalized;
+    }
+    async setModel(modelId) {
+        const normalizedModelId = typeof modelId === "string" && modelId.trim().length > 0 ? modelId : null;
+        const query = await this.ensureQuery();
+        await query.setModel(normalizedModelId ?? undefined);
+        this.config.model = normalizedModelId ?? undefined;
+        this.lastOptionsModel = normalizedModelId ?? this.lastOptionsModel;
+        this.lastRuntimeModel = null;
+        this.cachedRuntimeInfo = null;
+        // Model change affects persistence metadata, so invalidate cached handle.
+        this.persistence = null;
+    }
+    async setThinkingOption(thinkingOptionId) {
+        const normalizedThinkingOptionId = typeof thinkingOptionId === "string" && thinkingOptionId.trim().length > 0
+            ? thinkingOptionId
+            : null;
+        if (!normalizedThinkingOptionId || normalizedThinkingOptionId === "default") {
+            this.config.thinkingOptionId = undefined;
+        }
+        else if (isClaudeThinkingEffort(normalizedThinkingOptionId)) {
+            this.config.thinkingOptionId = normalizedThinkingOptionId;
+        }
+        else {
+            throw new Error(`Unknown thinking option: ${normalizedThinkingOptionId}`);
+        }
+        this.queryRestartNeeded = true;
+    }
+    getPendingPermissions() {
+        return Array.from(this.pendingPermissions.values()).map((entry) => entry.request);
+    }
+    async respondToPermission(requestId, response) {
+        const pending = this.pendingPermissions.get(requestId);
+        if (!pending) {
+            throw new Error(`No pending permission request with id '${requestId}'`);
+        }
+        this.pendingPermissions.delete(requestId);
+        pending.cleanup?.();
+        if (response.behavior === "allow") {
+            if (pending.request.kind === "plan") {
+                const selectedActionId = response.selectedActionId;
+                const shouldResumePriorMode = selectedActionId === "implement_resume" && this.planResumeMode === "bypassPermissions";
+                const targetMode = shouldResumePriorMode
+                    ? "bypassPermissions"
+                    : "acceptEdits";
+                await this.setMode(targetMode);
+                this.pushToolCall(mapClaudeCompletedToolCall({
+                    name: "plan_approval",
+                    callId: pending.request.id,
+                    input: pending.request.input ?? null,
+                    output: {
+                        approved: true,
+                        actionId: selectedActionId ?? "implement",
+                    },
+                }));
+            }
+            const result = {
+                behavior: "allow",
+                updatedInput: response.updatedInput ?? pending.request.input ?? {},
+                updatedPermissions: this.normalizePermissionUpdates(response.updatedPermissions),
+            };
+            pending.resolve(result);
+        }
+        else {
+            if (pending.request.kind === "tool") {
+                this.pushToolCall(mapClaudeFailedToolCall({
+                    name: pending.request.name,
+                    callId: (typeof pending.request.metadata?.toolUseId === "string"
+                        ? pending.request.metadata.toolUseId
+                        : null) ?? pending.request.id,
+                    input: pending.request.input ?? null,
+                    output: null,
+                    error: { message: response.message ?? "Permission denied" },
+                }));
+            }
+            const result = {
+                behavior: "deny",
+                message: response.message ?? "Permission request denied",
+                interrupt: response.interrupt,
+            };
+            pending.resolve(result);
+        }
+        this.pushEvent({
+            type: "permission_resolved",
+            provider: "claude",
+            requestId,
+            resolution: response,
+        });
+    }
+    describePersistence() {
+        if (this.persistence) {
+            return this.persistence;
+        }
+        if (!this.claudeSessionId) {
+            return null;
+        }
+        this.persistence = {
+            provider: "claude",
+            sessionId: this.claudeSessionId,
+            nativeHandle: this.claudeSessionId,
+            metadata: { ...this.config },
+        };
+        return this.persistence;
+    }
+    async close() {
+        this.logger.trace({
+            claudeSessionId: this.claudeSessionId,
+            turnState: this.turnState,
+            hasQuery: Boolean(this.query),
+            hasInput: Boolean(this.input),
+            hasActiveForegroundTurnId: Boolean(this.activeForegroundTurnId),
+        }, "Claude session close: start");
+        this.closed = true;
+        this.rejectAllPendingPermissions(new Error("Claude session closed"));
+        this.cancelCurrentTurn?.();
+        this.subscribers.clear();
+        this.activeForegroundTurnId = null;
+        this.autonomousTurn = null;
+        this.cancelCurrentTurn = null;
+        this.turnState = "idle";
+        this.sidechainTracker.clear();
+        this.input?.end();
+        this.query?.close?.();
+        await this.awaitWithTimeout(this.query?.interrupt?.(), "close query interrupt");
+        await this.awaitWithTimeout(this.query?.return?.(), "close query return");
+        this.query = null;
+        this.input = null;
+        this.logger.trace({ claudeSessionId: this.claudeSessionId, turnState: this.turnState }, "Claude session close: completed");
+    }
+    async listCommands() {
+        const q = await this.ensureQuery();
+        const commands = await q.supportedCommands();
+        const commandMap = new Map();
+        for (const cmd of commands) {
+            if (!commandMap.has(cmd.name)) {
+                commandMap.set(cmd.name, {
+                    name: cmd.name,
+                    description: cmd.description,
+                    argumentHint: cmd.argumentHint,
+                });
+            }
+        }
+        if (!commandMap.has(REWIND_COMMAND_NAME)) {
+            commandMap.set(REWIND_COMMAND_NAME, REWIND_COMMAND);
+        }
+        return Array.from(commandMap.values()).sort((a, b) => a.name.localeCompare(b.name));
+    }
+    resolveSlashCommandInvocation(prompt) {
+        if (typeof prompt !== "string") {
+            return null;
+        }
+        const parsed = this.parseSlashCommandInput(prompt);
+        if (!parsed) {
+            return null;
+        }
+        return parsed.commandName === REWIND_COMMAND_NAME ? parsed : null;
+    }
+    parseSlashCommandInput(text) {
+        const trimmed = text.trim();
+        if (!trimmed.startsWith("/") || trimmed.length <= 1) {
+            return null;
+        }
+        const withoutPrefix = trimmed.slice(1);
+        const firstWhitespaceIdx = withoutPrefix.search(/\s/);
+        const commandName = firstWhitespaceIdx === -1 ? withoutPrefix : withoutPrefix.slice(0, firstWhitespaceIdx);
+        if (!commandName || commandName.includes("/")) {
+            return null;
+        }
+        const rawArgs = firstWhitespaceIdx === -1 ? "" : withoutPrefix.slice(firstWhitespaceIdx + 1).trim();
+        return rawArgs.length > 0
+            ? { commandName, args: rawArgs, rawInput: trimmed }
+            : { commandName, rawInput: trimmed };
+    }
+    buildRewindSuccessMessage(targetUserMessageId, rewindResult) {
+        const fileCount = Array.isArray(rewindResult.filesChanged)
+            ? rewindResult.filesChanged.length
+            : undefined;
+        const stats = [];
+        if (typeof fileCount === "number") {
+            stats.push(`${fileCount} file${fileCount === 1 ? "" : "s"}`);
+        }
+        if (typeof rewindResult.insertions === "number") {
+            stats.push(`${rewindResult.insertions} insertions`);
+        }
+        if (typeof rewindResult.deletions === "number") {
+            stats.push(`${rewindResult.deletions} deletions`);
+        }
+        if (stats.length > 0) {
+            return `Rewound tracked files to message ${targetUserMessageId} (${stats.join(", ")}).`;
+        }
+        return `Rewound tracked files to message ${targetUserMessageId}.`;
+    }
+    async attemptRewind(args) {
+        if (typeof args === "string" && args.trim().length > 0) {
+            const candidate = args.trim().split(/\s+/)[0] ?? "";
+            if (!UUID_PATTERN.test(candidate)) {
+                return {
+                    messageId: null,
+                    error: "Invalid message UUID. Usage: /rewind <user_message_uuid> or /rewind",
+                };
+            }
+            const rewindResult = await this.rewindFilesOnce(candidate);
+            if (rewindResult.canRewind) {
+                return { messageId: candidate, result: rewindResult };
+            }
+            return {
+                messageId: null,
+                error: rewindResult.error ?? `No file checkpoint found for message ${candidate}.`,
+            };
+        }
+        const candidates = this.getRewindCandidateUserMessageIds();
+        if (candidates.length === 0) {
+            return {
+                messageId: null,
+                error: "No prior user message available to rewind. Use /rewind <user_message_uuid>.",
+            };
+        }
+        let lastError;
+        for (const candidate of candidates) {
+            try {
+                const rewindResult = await this.rewindFilesOnce(candidate);
+                if (rewindResult.canRewind) {
+                    return { messageId: candidate, result: rewindResult };
+                }
+                if (rewindResult.error) {
+                    lastError = rewindResult.error;
+                }
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error.message : "Failed to rewind tracked files.";
+            }
+        }
+        return {
+            messageId: null,
+            error: lastError ?? "No rewind checkpoints are currently available for this session.",
+        };
+    }
+    async rewindFilesOnce(messageId) {
+        try {
+            const query = await this.ensureFreshQuery();
+            return await query.rewindFiles(messageId, { dryRun: false });
+        }
+        catch (error) {
+            // The Claude SDK transport can close after a rewind call.
+            // If that happens, mark the query stale so a follow-up attempt uses a fresh query.
+            this.queryRestartNeeded = true;
+            throw error;
+        }
+    }
+    async ensureFreshQuery() {
+        if (this.query) {
+            this.queryRestartNeeded = true;
+        }
+        return this.ensureQuery();
+    }
+    getRewindCandidateUserMessageIds() {
+        const candidates = [];
+        const pushUnique = (value) => {
+            if (typeof value === "string" && value.length > 0 && !candidates.includes(value)) {
+                candidates.push(value);
+            }
+        };
+        const historyIds = this.readUserMessageIdsFromHistoryFile();
+        for (let idx = historyIds.length - 1; idx >= 0; idx -= 1) {
+            pushUnique(historyIds[idx]);
+        }
+        for (let idx = this.persistedHistory.length - 1; idx >= 0; idx -= 1) {
+            const item = this.persistedHistory[idx];
+            if (item?.type === "user_message") {
+                pushUnique(item.messageId);
+            }
+        }
+        for (let idx = this.userMessageIds.length - 1; idx >= 0; idx -= 1) {
+            pushUnique(this.userMessageIds[idx]);
+        }
+        return candidates;
+    }
+    readUserMessageIdsFromHistoryFile() {
+        if (!this.claudeSessionId) {
+            return [];
+        }
+        const historyPath = this.resolveHistoryPath(this.claudeSessionId);
+        if (!historyPath || !fs.existsSync(historyPath)) {
+            return [];
+        }
+        try {
+            const ids = [];
+            const content = fs.readFileSync(historyPath, "utf8");
+            for (const line of content.split(/\n+/)) {
+                const trimmed = line.trim();
+                if (!trimmed)
+                    continue;
+                try {
+                    const entry = JSON.parse(trimmed);
+                    if (entry?.type === "user" && typeof entry.uuid === "string") {
+                        ids.push(entry.uuid);
+                    }
+                }
+                catch {
+                    // ignore malformed lines
+                }
+            }
+            return ids;
+        }
+        catch {
+            return [];
+        }
+    }
+    rememberUserMessageId(messageId) {
+        if (typeof messageId !== "string" || messageId.length === 0) {
+            return;
+        }
+        const last = this.userMessageIds[this.userMessageIds.length - 1];
+        if (last === messageId) {
+            return;
+        }
+        this.userMessageIds.push(messageId);
+    }
+    async ensureQuery() {
+        if (this.query && !this.queryRestartNeeded) {
+            return this.query;
+        }
+        if (this.queryRestartNeeded && this.query) {
+            const oldQuery = this.query;
+            const oldInput = this.input;
+            // Null out query/input BEFORE awaiting the old iterator's return so the
+            // old pump sees this.query !== activeQuery and skips failActiveTurns.
+            this.query = null;
+            this.input = null;
+            this.queryPumpPromise = null;
+            this.queryRestartNeeded = false;
+            // Reset session identity for explicit restarts so the new query starts
+            // a fresh session rather than resuming the previous one.
+            this.claudeSessionId = null;
+            oldInput?.end();
+            oldQuery.close?.();
+            try {
+                await oldQuery.return?.();
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        // When the pump died unexpectedly (query became null, e.g. after a session
+        // ID overwrite error), preserve claudeSessionId so buildOptions() passes
+        // resume: sessionId and the new query auto-resumes the previous session.
+        // For explicit restarts above, claudeSessionId was already cleared.
+        this.persistence = null;
+        const input = createAsyncMessageInput();
+        const options = await this.buildOptions();
+        this.logger.debug({ options: summarizeClaudeOptionsForLog(options) }, "claude query");
+        this.input = input;
+        this.query = this.queryFactory({ prompt: input.iterable, options });
+        // Do not kick off background control-plane queries here. Methods like
+        // supportedCommands()/setPermissionMode() may execute immediately after
+        // ensureQuery() (for listCommands()/setMode()), and sharing the same query
+        // control plane can cause those calls to wait behind supportedModels().
+        return this.query;
+    }
+    async awaitWithTimeout(promise, label) {
+        if (!promise) {
+            this.logger.trace({ label }, "Claude query operation skipped (no promise)");
+            return;
+        }
+        const startedAt = Date.now();
+        this.logger.trace({ label }, "Claude query operation wait start");
+        try {
+            await Promise.race([
+                promise,
+                new Promise((_, reject) => {
+                    setTimeout(() => reject(new Error("timeout")), 3000);
+                }),
+            ]);
+            this.logger.trace({ label, durationMs: Date.now() - startedAt }, "Claude query operation settled");
+        }
+        catch (error) {
+            this.logger.warn({ err: error, label }, "Claude query operation did not settle cleanly");
+        }
+    }
+    async buildOptions() {
+        const thinkingOptionId = this.config.thinkingOptionId && this.config.thinkingOptionId !== "default"
+            ? this.config.thinkingOptionId
+            : undefined;
+        let thinking;
+        let effort;
+        if (thinkingOptionId && isClaudeThinkingEffort(thinkingOptionId)) {
+            thinking = { type: "adaptive" };
+            effort = thinkingOptionId;
+        }
+        const appendedSystemPrompt = [
+            getOrchestratorModeInstructions(),
+            this.config.systemPrompt?.trim(),
+        ]
+            .filter((entry) => typeof entry === "string" && entry.length > 0)
+            .join("\n\n");
+        const claudeBinary = await findExecutable("claude");
+        this.logger.debug({
+            claudeBinary,
+            pathEnvKey: process.env["Path"] !== undefined
+                ? "Path"
+                : process.env["PATH"] !== undefined
+                    ? "PATH"
+                    : null,
+            pathIncludesClaudeLocalBin: (process.env["Path"] ?? process.env["PATH"] ?? "")
+                .toLowerCase()
+                .includes("\\.local\\bin"),
+        }, "Resolved Claude executable");
+        const base = {
+            cwd: this.config.cwd,
+            includePartialMessages: true,
+            permissionMode: this.currentMode,
+            // Dynamic mode switching can recreate the underlying Claude query. Keep the
+            // bypass launch capability available so later setPermissionMode("bypassPermissions")
+            // calls do not fail after a model/thinking/rewind-driven restart.
+            allowDangerouslySkipPermissions: true,
+            agents: this.defaults?.agents,
+            canUseTool: this.handlePermissionRequest,
+            ...(claudeBinary ? { pathToClaudeCodeExecutable: claudeBinary } : {}),
+            // Use Claude Code preset system prompt and load CLAUDE.md files
+            // Append provider-agnostic system prompt and orchestrator instructions for agents.
+            systemPrompt: {
+                type: "preset",
+                preset: "claude_code",
+                append: appendedSystemPrompt,
+            },
+            settingSources: CLAUDE_SETTING_SOURCES,
+            stderr: (data) => {
+                this.captureStderr(data);
+                this.logger.error({ stderr: data.trim() }, "Claude Agent SDK stderr");
+            },
+            env: {
+                ...process.env,
+                // Increase MCP timeouts for long-running tool calls (10 minutes)
+                MCP_TIMEOUT: "600000",
+                MCP_TOOL_TIMEOUT: "600000",
+                ...(this.launchEnv ?? {}),
+            },
+            // Required for provider-level /rewind support.
+            enableFileCheckpointing: true,
+            // If we have a session ID from a previous query (e.g., after interrupt),
+            // resume that session to continue the conversation history.
+            ...(this.claudeSessionId ? { resume: this.claudeSessionId } : {}),
+            ...(thinking ? { thinking } : {}),
+            ...(effort ? { effort } : {}),
+            ...this.config.extra?.claude,
+        };
+        if (this.config.mcpServers) {
+            base.mcpServers = this.normalizeMcpServers(this.config.mcpServers);
+        }
+        if (this.config.model) {
+            base.model = this.config.model;
+        }
+        this.lastOptionsModel = base.model ?? null;
+        if (this.claudeSessionId) {
+            base.resume = this.claudeSessionId;
+        }
+        return this.applyRuntimeSettings(base);
+    }
+    applyRuntimeSettings(options) {
+        return applyRuntimeSettingsToClaudeOptions(options, this.runtimeSettings, this.launchEnv);
+    }
+    normalizeMcpServers(servers) {
+        const result = {};
+        for (const [name, config] of Object.entries(servers)) {
+            result[name] = toClaudeSdkMcpConfig(config);
+        }
+        return result;
+    }
+    toSdkUserMessage(prompt) {
+        const content = [];
+        if (Array.isArray(prompt)) {
+            for (const chunk of prompt) {
+                if (chunk.type === "text") {
+                    content.push({ type: "text", text: chunk.text });
+                }
+                else if (chunk.type === "image") {
+                    content.push({
+                        type: "image",
+                        source: {
+                            type: "base64",
+                            media_type: chunk.mimeType,
+                            data: chunk.data,
+                        },
+                    });
+                }
+            }
+        }
+        else {
+            content.push({ type: "text", text: prompt });
+        }
+        const messageId = randomUUID();
+        this.rememberUserMessageId(messageId);
+        return {
+            type: "user",
+            message: {
+                role: "user",
+                content,
+            },
+            parent_tool_use_id: null,
+            uuid: messageId,
+            session_id: this.claudeSessionId ?? "",
+        };
+    }
+    transitionTurnState(next, reason) {
+        if (this.turnState === next) {
+            return;
+        }
+        this.logger.debug({ from: this.turnState, to: next, reason }, "Claude turn state transition");
+        this.turnState = next;
+    }
+    syncTurnState(reason) {
+        if (this.activeForegroundTurnId) {
+            this.transitionTurnState("foreground", reason);
+            return;
+        }
+        if (this.autonomousTurn) {
+            this.transitionTurnState("autonomous", reason);
+            return;
+        }
+        this.transitionTurnState("idle", reason);
+    }
+    isAbortError(message) {
+        const errors = "errors" in message && Array.isArray(message.errors) ? message.errors : [];
+        return errors.some((e) => /\baborted\b/i.test(e));
+    }
+    buildTurnFailedEvent(errorMessage) {
+        const normalized = errorMessage.trim() || "Claude run failed";
+        const exitCodeMatch = normalized.match(/\bcode\s+(\d+)\b/i);
+        const code = exitCodeMatch ? exitCodeMatch[1] : undefined;
+        const diagnostic = this.getRecentStderrDiagnostic();
+        return {
+            type: "turn_failed",
+            provider: "claude",
+            error: normalized,
+            ...(code ? { code } : {}),
+            ...(diagnostic ? { diagnostic } : {}),
+        };
+    }
+    captureStderr(data) {
+        const text = data.trim();
+        if (!text) {
+            return;
+        }
+        const combined = this.recentStderr ? `${this.recentStderr}\n${text}` : text;
+        this.recentStderr = combined.slice(-MAX_RECENT_STDERR_CHARS);
+    }
+    clearRecentStderr() {
+        this.recentStderr = "";
+    }
+    getRecentStderrDiagnostic() {
+        return this.recentStderr.trim() || undefined;
+    }
+    async awaitRecentStderrAfterProcessExit(error) {
+        if (this.getRecentStderrDiagnostic()) {
+            return;
+        }
+        const message = typeof error === "string" ? error : error instanceof Error ? error.message : "";
+        if (!/\bprocess exited with code\b/i.test(message) &&
+            !/\bterminated by signal\b/i.test(message)) {
+            return;
+        }
+        const startedAt = Date.now();
+        while (!this.closed && !this.getRecentStderrDiagnostic()) {
+            if (Date.now() - startedAt >= STDERR_FLUSH_WAIT_MS) {
+                return;
+            }
+            await new Promise((resolve) => setTimeout(resolve, STDERR_FLUSH_POLL_INTERVAL_MS));
+        }
+    }
+    createTurnId(owner) {
+        return `${owner}-turn-${this.nextTurnOrdinal++}`;
+    }
+    isTerminalTurnEvent(event) {
+        return (event.type === "turn_completed" ||
+            event.type === "turn_failed" ||
+            event.type === "turn_canceled");
+    }
+    extractPromptText(prompt) {
+        if (typeof prompt === "string") {
+            return prompt;
+        }
+        const textParts = prompt
+            .filter((block) => block.type === "text")
+            .map((block) => block.text);
+        return textParts.length > 0 ? textParts.join("\n") : null;
+    }
+    async executeRewindTurn(_turnId, invocation) {
+        this.notifySubscribers({ type: "turn_started", provider: "claude" });
+        try {
+            const rewindAttempt = await this.attemptRewind(invocation.args);
+            if (!rewindAttempt.messageId || !rewindAttempt.result) {
+                this.finishForegroundTurn({
+                    type: "turn_failed",
+                    provider: "claude",
+                    error: rewindAttempt.error ??
+                        "No prior user message available to rewind. Use /rewind <user_message_uuid>.",
+                });
+                return;
+            }
+            this.notifySubscribers({
+                type: "timeline",
+                provider: "claude",
+                item: {
+                    type: "assistant_message",
+                    text: this.buildRewindSuccessMessage(rewindAttempt.messageId, rewindAttempt.result),
+                },
+            });
+            this.finishForegroundTurn({ type: "turn_completed", provider: "claude" });
+        }
+        catch (error) {
+            this.finishForegroundTurn({
+                type: "turn_failed",
+                provider: "claude",
+                error: error instanceof Error ? error.message : "Failed to rewind tracked files",
+            });
+        }
+    }
+    shouldRecoverInterruptedQueryAbort(error, consecutiveRecoveries) {
+        if (consecutiveRecoveries >= 3) {
+            return false;
+        }
+        const message = typeof error === "string"
+            ? error
+            : error instanceof Error
+                ? `${error.message}\n${error.stack ?? ""}`
+                : JSON.stringify(error);
+        return message.toLowerCase().includes("request was aborted");
+    }
+    finishForegroundTurn(event) {
+        if (event.type === "turn_failed" || event.type === "turn_canceled") {
+            this.flushPendingToolCalls();
+        }
+        this.notifySubscribers(event);
+        this.activeForegroundTurnId = null;
+        this.lastForegroundPromptText = null;
+        this.cancelCurrentTurn = null;
+        this.syncTurnState("foreground turn terminal");
+    }
+    dispatchEvents(events) {
+        let terminalSeen = false;
+        for (const event of events) {
+            this.notifySubscribers(event);
+            terminalSeen || (terminalSeen = this.isTerminalTurnEvent(event));
+        }
+        if (terminalSeen) {
+            if (this.activeForegroundTurnId) {
+                this.activeForegroundTurnId = null;
+                this.lastForegroundPromptText = null;
+                this.cancelCurrentTurn = null;
+                this.syncTurnState("foreground turn terminal");
+            }
+            else if (this.autonomousTurn) {
+                this.autonomousTurn = null;
+                this.syncTurnState("autonomous turn terminal");
+            }
+        }
+    }
+    startAutonomousTurn() {
+        if (this.autonomousTurn) {
+            return;
+        }
+        this.autonomousTurn = {
+            id: this.createTurnId("autonomous"),
+        };
+        this.notifySubscribers({ type: "turn_started", provider: "claude" });
+        this.syncTurnState("autonomous turn started");
+    }
+    completeAutonomousTurn() {
+        if (!this.autonomousTurn) {
+            return;
+        }
+        this.notifySubscribers({ type: "turn_completed", provider: "claude" });
+        this.autonomousTurn = null;
+        this.syncTurnState("autonomous turn completed");
+    }
+    failActiveTurns(errorMessage) {
+        const failure = this.buildTurnFailedEvent(errorMessage);
+        this.flushPendingToolCalls();
+        if (this.activeForegroundTurnId) {
+            this.finishForegroundTurn(failure);
+            return;
+        }
+        if (this.autonomousTurn) {
+            this.dispatchEvents([failure]);
+        }
+    }
+    startQueryPump() {
+        if (this.closed || this.queryPumpPromise) {
+            return;
+        }
+        const pump = this.runQueryPump().catch((error) => {
+            this.logger.trace({ err: error }, "Claude query pump exited unexpectedly");
+        });
+        this.queryPumpPromise = pump;
+        pump.finally(() => {
+            if (this.queryPumpPromise === pump) {
+                this.queryPumpPromise = null;
+            }
+        });
+    }
+    async runQueryPump() {
+        let activeQuery;
+        try {
+            activeQuery = await this.ensureQuery();
+        }
+        catch (error) {
+            this.logger.trace({ err: error }, "Failed to initialize Claude query pump");
+            this.failActiveTurns(error instanceof Error ? error.message : "Claude stream failed");
+            return;
+        }
+        let consecutiveInterruptAbortRecoveries = 0;
+        try {
+            while (!this.closed && this.query === activeQuery) {
+                try {
+                    for await (const message of activeQuery) {
+                        if (claudeDebug) {
+                            this.logger.trace({
+                                claudeSessionId: this.claudeSessionId,
+                                messageType: message.type,
+                                messageSubtype: "subtype" in message ? message.subtype : undefined,
+                                messageUuid: "uuid" in message ? message.uuid : undefined,
+                            }, "Claude query pump: raw SDK message");
+                        }
+                        consecutiveInterruptAbortRecoveries = 0;
+                        if (await this.handleMissingResumedConversation(message, activeQuery)) {
+                            return;
+                        }
+                        this.routeSdkMessageFromPump(message);
+                    }
+                    if (!this.closed && this.query === activeQuery) {
+                        this.failActiveTurns("Claude stream ended before terminal result");
+                    }
+                    return;
+                }
+                catch (error) {
+                    if (!this.closed &&
+                        this.query === activeQuery &&
+                        this.shouldRecoverInterruptedQueryAbort(error, consecutiveInterruptAbortRecoveries)) {
+                        consecutiveInterruptAbortRecoveries += 1;
+                        this.logger.debug({ recoveries: consecutiveInterruptAbortRecoveries }, "Recovering Claude query pump after interrupt abort");
+                        continue;
+                    }
+                    if (!this.closed && this.query === activeQuery) {
+                        await this.awaitRecentStderrAfterProcessExit(error);
+                        this.failActiveTurns(error instanceof Error ? error.message : "Claude stream failed");
+                    }
+                    return;
+                }
+            }
+        }
+        finally {
+            if (this.query === activeQuery) {
+                this.query = null;
+                this.input = null;
+            }
+        }
+    }
+    routeSdkMessageFromPump(message) {
+        // Suppress stale results from interrupted requests. The cancel path already
+        // emitted the terminal event; this result is leftover from the killed API
+        // request. Consume the flag on ANY result so it doesn't linger.
+        if (message.type === "result" && this.pendingInterruptAbort) {
+            this.pendingInterruptAbort = false;
+            if (message.subtype !== "success") {
+                this.logger.debug("Suppressing stale non-success result from interrupted request");
+                return;
+            }
+        }
+        if (message.type === "result" && message.subtype !== "success" && this.isAbortError(message)) {
+            this.logger.debug("Suppressing abort result by content");
+            return;
+        }
+        const isForeground = Boolean(this.activeForegroundTurnId);
+        const assistantishMessage = message.type === "assistant" ||
+            message.type === "stream_event" ||
+            message.type === "tool_progress" ||
+            (message.type === "system" && message.subtype === "task_notification");
+        if (!isForeground && assistantishMessage) {
+            this.startAutonomousTurn();
+        }
+        if (!isForeground && !this.autonomousTurn && message.type === "result") {
+            return;
+        }
+        const turnId = this.activeForegroundTurnId ?? this.autonomousTurn?.id ?? null;
+        const identifiers = readEventIdentifiers(message);
+        if (claudeDebug) {
+            this.logger.trace({
+                claudeSessionId: this.claudeSessionId,
+                messageType: message.type,
+                turnId,
+            }, "Claude query pump: SDK message");
+        }
+        const messageEvents = this.translateMessageToEvents(message, {
+            suppressAssistantText: true,
+            suppressReasoning: true,
+        });
+        const assistantTimelineEvents = this.timelineAssembler
+            .consume({
+            message,
+            runId: turnId,
+            messageIdHint: identifiers.messageId,
+        })
+            .map((item) => ({
+            type: "timeline",
+            item,
+            provider: "claude",
+        }));
+        // User message dedup: suppress echoed user messages that match the foreground prompt
+        const filteredMessageEvents = messageEvents.filter((event) => {
+            if (event.type === "timeline" &&
+                event.item.type === "user_message" &&
+                this.activeForegroundTurnId &&
+                this.lastForegroundPromptText) {
+                if (event.item.text.trim() === this.lastForegroundPromptText.trim()) {
+                    return false;
+                }
+            }
+            return true;
+        });
+        const events = [...filteredMessageEvents, ...assistantTimelineEvents];
+        if (events.length === 0) {
+            return;
+        }
+        if (this.pendingInterruptAbort &&
+            message.type === "result" &&
+            events.some((event) => event.type === "turn_completed" || event.type === "turn_failed") &&
+            (!this.activeForegroundTurnId || !this.foregroundHasVisibleActivity)) {
+            this.pendingInterruptAbort = false;
+            this.logger.debug("Suppressing stale Claude interrupt terminal result");
+            return;
+        }
+        if (this.activeForegroundTurnId &&
+            events.some((event) => event.type === "timeline" ||
+                event.type === "permission_requested" ||
+                event.type === "permission_resolved")) {
+            this.foregroundHasVisibleActivity = true;
+        }
+        this.dispatchEvents(events);
+    }
+    async handleMissingResumedConversation(message, query) {
+        const staleResumeError = this.readMissingResumedConversationError(message);
+        if (!staleResumeError) {
+            return false;
+        }
+        this.logger.warn({
+            claudeSessionId: this.claudeSessionId,
+            error: staleResumeError,
+        }, "Claude resumed session no longer exists; invalidating persisted session");
+        this.failActiveTurns(staleResumeError);
+        this.input?.end();
+        await this.awaitWithTimeout(query.return?.(), "query pump return on missing resumed conversation");
+        if (this.query === query) {
+            this.query = null;
+            this.input = null;
+        }
+        this.claudeSessionId = null;
+        this.persistence = null;
+        this.persistedHistory = [];
+        this.historyPending = false;
+        this.cachedRuntimeInfo = null;
+        this.queryRestartNeeded = false;
+        this.autonomousTurn = null;
+        this.activeForegroundTurnId = null;
+        this.syncTurnState("missing resumed conversation");
+        return true;
+    }
+    async interruptActiveTurn() {
+        const queryToInterrupt = this.query;
+        if (!queryToInterrupt || typeof queryToInterrupt.interrupt !== "function") {
+            this.logger.trace("interruptActiveTurn: no query to interrupt");
+            return;
+        }
+        this.pendingInterruptAbort = true;
+        try {
+            await this.awaitWithTimeout(queryToInterrupt.interrupt(), "interruptActiveTurn query.interrupt()");
+        }
+        catch (error) {
+            this.logger.warn({ err: error }, "Failed to interrupt active turn");
+        }
+    }
+    translateMessageToEvents(message, options) {
+        const parentToolUseId = "parent_tool_use_id" in message
+            ? message.parent_tool_use_id
+            : null;
+        if (parentToolUseId) {
+            return this.sidechainTracker.handleMessage(message, parentToolUseId);
+        }
+        const events = [];
+        const fallbackThreadSessionId = this.captureSessionIdFromMessage(message);
+        if (fallbackThreadSessionId) {
+            events.push({
+                type: "thread_started",
+                provider: "claude",
+                sessionId: fallbackThreadSessionId,
+            });
+        }
+        switch (message.type) {
+            case "system":
+                if (message.subtype === "init") {
+                    const threadSessionId = this.handleSystemMessage(message);
+                    if (threadSessionId) {
+                        events.push({
+                            type: "thread_started",
+                            provider: "claude",
+                            sessionId: threadSessionId,
+                        });
+                    }
+                }
+                else if (message.subtype === "status") {
+                    const status = message.status;
+                    if (status === "compacting") {
+                        this.compacting = true;
+                        events.push({
+                            type: "timeline",
+                            item: { type: "compaction", status: "loading" },
+                            provider: "claude",
+                        });
+                    }
+                }
+                else if (message.subtype === "compact_boundary") {
+                    const compactMetadata = readCompactionMetadata(message);
+                    events.push({
+                        type: "timeline",
+                        item: {
+                            type: "compaction",
+                            status: "completed",
+                            trigger: compactMetadata?.trigger === "manual" ? "manual" : "auto",
+                            preTokens: compactMetadata?.preTokens,
+                        },
+                        provider: "claude",
+                    });
+                }
+                else if (message.subtype === "task_notification") {
+                    const taskNotificationItem = mapTaskNotificationSystemRecordToToolCall(message);
+                    if (taskNotificationItem) {
+                        events.push({
+                            type: "timeline",
+                            item: taskNotificationItem,
+                            provider: "claude",
+                        });
+                    }
+                    const usage = readUsageFromTaskNotification(message);
+                    if (typeof usage === "number") {
+                        this.lastContextWindowUsedTokens = usage;
+                        events.push(this.createUsageUpdatedEvent(usage));
+                    }
+                }
+                else if (message.subtype === "task_progress") {
+                    this.lastContextWindowUsedTokens =
+                        readContextWindowUsedTokensFromTaskProgress(message) ??
+                            this.lastContextWindowUsedTokens;
+                    if (typeof this.lastContextWindowUsedTokens === "number") {
+                        events.push(this.createUsageUpdatedEvent(this.lastContextWindowUsedTokens));
+                    }
+                }
+                break;
+            case "user": {
+                if (isSyntheticUserEntry(message)) {
+                    break;
+                }
+                if (this.compacting) {
+                    this.compacting = false;
+                    break;
+                }
+                const messageId = typeof message.uuid === "string" && message.uuid.length > 0 ? message.uuid : undefined;
+                this.rememberUserMessageId(messageId);
+                const content = message.message?.content;
+                const taskNotificationItem = mapTaskNotificationUserContentToToolCall({
+                    content,
+                    messageId,
+                });
+                if (taskNotificationItem) {
+                    events.push({
+                        type: "timeline",
+                        item: taskNotificationItem,
+                        provider: "claude",
+                    });
+                    break;
+                }
+                if (typeof content === "string" && content.length > 0) {
+                    if (!isClaudeTranscriptNoiseText(content)) {
+                        events.push({
+                            type: "timeline",
+                            item: {
+                                type: "user_message",
+                                text: content,
+                                ...(messageId ? { messageId } : {}),
+                            },
+                            provider: "claude",
+                        });
+                    }
+                }
+                else if (Array.isArray(content)) {
+                    const timelineItems = this.mapBlocksToTimeline(content, {
+                        textMessageType: "user_message",
+                    });
+                    for (const item of timelineItems) {
+                        if (item.type === "user_message" && messageId && !item.messageId) {
+                            events.push({
+                                type: "timeline",
+                                item: { ...item, messageId },
+                                provider: "claude",
+                            });
+                            continue;
+                        }
+                        events.push({ type: "timeline", item, provider: "claude" });
+                    }
+                }
+                break;
+            }
+            case "assistant": {
+                const timelineItems = this.mapBlocksToTimeline(message.message.content, {
+                    suppressAssistantText: options?.suppressAssistantText ?? false,
+                    suppressReasoning: options?.suppressReasoning ?? false,
+                });
+                for (const item of timelineItems) {
+                    events.push({ type: "timeline", item, provider: "claude" });
+                }
+                break;
+            }
+            case "stream_event": {
+                const usageUpdatedEvent = this.trackStreamEventUsage(message.event);
+                if (usageUpdatedEvent) {
+                    events.push(usageUpdatedEvent);
+                }
+                const timelineItems = this.mapPartialEvent(message.event, {
+                    suppressAssistantText: options?.suppressAssistantText ?? false,
+                    suppressReasoning: options?.suppressReasoning ?? false,
+                });
+                for (const item of timelineItems) {
+                    events.push({ type: "timeline", item, provider: "claude" });
+                }
+                break;
+            }
+            case "result": {
+                const usage = this.convertUsage(message, message.modelUsage);
+                if (message.subtype === "success") {
+                    events.push({ type: "turn_completed", provider: "claude", usage });
+                }
+                else {
+                    const errorMessage = "errors" in message && Array.isArray(message.errors) && message.errors.length > 0
+                        ? message.errors.join("\n")
+                        : "Claude run failed";
+                    events.push(this.buildTurnFailedEvent(errorMessage));
+                }
+                break;
+            }
+            default:
+                break;
+        }
+        return events;
+    }
+    captureSessionIdFromMessage(message) {
+        const msg = message;
+        const sessionIdRaw = typeof msg.session_id === "string"
+            ? msg.session_id
+            : typeof msg.sessionId === "string"
+                ? msg.sessionId
+                : typeof msg.session?.id === "string"
+                    ? msg.session.id
+                    : "";
+        const sessionId = sessionIdRaw.trim();
+        if (!sessionId) {
+            return null;
+        }
+        if (this.claudeSessionId === null) {
+            this.claudeSessionId = sessionId;
+            this.persistence = null;
+            return sessionId;
+        }
+        if (this.claudeSessionId === sessionId) {
+            return null;
+        }
+        // Session ID changed mid-stream (e.g. a hook caused Claude to restart
+        // with a new session). Accept the new ID and continue — the turn should
+        // not be failed just because the underlying subprocess cycled.
+        this.logger.warn({ existingSessionId: this.claudeSessionId, newSessionId: sessionId }, "Claude session ID changed in message; accepting new session");
+        this.claudeSessionId = sessionId;
+        this.persistence = null;
+        return sessionId;
+    }
+    handleSystemMessage(message) {
+        if (message.subtype !== "init") {
+            return null;
+        }
+        const msg = message;
+        const newSessionIdRaw = typeof msg.session_id === "string"
+            ? msg.session_id
+            : typeof msg.sessionId === "string"
+                ? msg.sessionId
+                : typeof msg.session?.id === "string"
+                    ? msg.session.id
+                    : "";
+        const newSessionId = newSessionIdRaw.trim();
+        if (!newSessionId) {
+            return null;
+        }
+        const existingSessionId = this.claudeSessionId;
+        let threadStartedSessionId = null;
+        if (existingSessionId === null) {
+            this.claudeSessionId = newSessionId;
+            threadStartedSessionId = newSessionId;
+            this.logger.debug({ sessionId: newSessionId }, "Claude session ID set for the first time");
+        }
+        else if (existingSessionId === newSessionId) {
+            this.logger.debug({ sessionId: newSessionId }, "Claude session ID unchanged (same value)");
+        }
+        else {
+            // Session ID changed in an init message (e.g. a hook restarted Claude
+            // with a new session mid-turn). Accept the new ID and continue.
+            this.logger.warn({ existingSessionId, newSessionId }, "Claude session ID changed in init message; accepting new session");
+            this.claudeSessionId = newSessionId;
+            threadStartedSessionId = newSessionId;
+        }
+        this.availableModes = DEFAULT_MODES;
+        this.currentMode = message.permissionMode;
+        if (this.currentMode !== "plan") {
+            this.planResumeMode = this.currentMode;
+        }
+        this.persistence = null;
+        if (message.model) {
+            const normalizedRuntimeModel = normalizeClaudeRuntimeModelId(message.model);
+            this.logger.debug({ runtimeModel: message.model, normalizedRuntimeModel }, "Captured runtime model from SDK init");
+            if (normalizedRuntimeModel) {
+                this.lastOptionsModel = normalizedRuntimeModel;
+            }
+            else if (!this.lastOptionsModel) {
+                this.lastOptionsModel = this.config.model ?? null;
+            }
+            this.lastRuntimeModel = message.model;
+            this.cachedRuntimeInfo = null;
+        }
+        return threadStartedSessionId;
+    }
+    readMissingResumedConversationError(message) {
+        if (message.type !== "result" || message.subtype !== "error_during_execution") {
+            return null;
+        }
+        if (!this.claudeSessionId) {
+            return null;
+        }
+        const errors = "errors" in message && Array.isArray(message.errors) ? message.errors : [];
+        for (const entry of errors) {
+            if (typeof entry !== "string") {
+                continue;
+            }
+            const match = entry.match(/^No conversation found with session ID:\s*(.+)$/);
+            if (!match) {
+                continue;
+            }
+            if (match[1]?.trim() === this.claudeSessionId) {
+                return entry.trim();
+            }
+        }
+        return null;
+    }
+    convertUsage(message, modelUsage) {
+        if (!message.usage) {
+            return undefined;
+        }
+        const usage = {
+            inputTokens: message.usage.input_tokens,
+            cachedInputTokens: message.usage.cache_read_input_tokens,
+            outputTokens: message.usage.output_tokens,
+            totalCostUsd: message.total_cost_usd,
+        };
+        const contextWindowMaxTokens = extractContextWindowSize(modelUsage ?? message.modelUsage);
+        if (contextWindowMaxTokens !== undefined) {
+            this.lastContextWindowMaxTokens = contextWindowMaxTokens;
+            usage.contextWindowMaxTokens = contextWindowMaxTokens;
+        }
+        else if (this.lastContextWindowMaxTokens !== undefined) {
+            usage.contextWindowMaxTokens = this.lastContextWindowMaxTokens;
+        }
+        if (typeof this.lastContextWindowUsedTokens === "number") {
+            // task_progress.total_tokens is the accurate context window fill level.
+            // Prefer it over result.usage which contains accumulated session totals.
+            usage.contextWindowUsedTokens = this.lastContextWindowUsedTokens;
+        }
+        else if (typeof this.lastStreamRequestInputTokens === "number" &&
+            typeof this.lastStreamRequestOutputTokens === "number") {
+            usage.contextWindowUsedTokens =
+                this.lastStreamRequestInputTokens + this.lastStreamRequestOutputTokens;
+        }
+        else if (message.usage) {
+            // Fallback: derive from result.usage when no task_progress has been
+            // received yet. These values are accumulated across all API calls, but
+            // for the first turn they equal the per-call values so the estimate is
+            // reasonable. Once a task_progress arrives it takes over permanently.
+            const usageWithCacheCreation = message.usage;
+            const derived = (message.usage.input_tokens ?? 0) +
+                (usageWithCacheCreation.cache_creation_input_tokens ?? 0) +
+                (message.usage.cache_read_input_tokens ?? 0) +
+                (message.usage.output_tokens ?? 0);
+            if (Number.isFinite(derived) && derived > 0) {
+                usage.contextWindowUsedTokens = derived;
+            }
+        }
+        return usage;
+    }
+    createUsageUpdatedEvent(contextWindowUsedTokens) {
+        const usage = {
+            contextWindowUsedTokens,
+        };
+        if (this.lastContextWindowMaxTokens !== undefined) {
+            usage.contextWindowMaxTokens = this.lastContextWindowMaxTokens;
+        }
+        return {
+            type: "usage_updated",
+            provider: "claude",
+            usage,
+        };
+    }
+    trackStreamEventUsage(event) {
+        if (!event || typeof event !== "object") {
+            return null;
+        }
+        const streamEvent = event;
+        const eventType = readTrimmedString(streamEvent.type);
+        if (eventType === "message_start") {
+            const inputTokens = readStreamRequestInputTokens(streamEvent);
+            if (typeof inputTokens !== "number") {
+                return null;
+            }
+            this.lastStreamRequestInputTokens = inputTokens;
+            this.lastStreamRequestOutputTokens = 0;
+        }
+        else if (eventType === "message_delta") {
+            const outputTokens = readStreamRequestOutputTokens(streamEvent);
+            if (typeof outputTokens !== "number") {
+                return null;
+            }
+            this.lastStreamRequestOutputTokens = outputTokens;
+        }
+        else {
+            return null;
+        }
+        if (typeof this.lastStreamRequestInputTokens !== "number" ||
+            typeof this.lastStreamRequestOutputTokens !== "number") {
+            return null;
+        }
+        return this.createUsageUpdatedEvent(this.lastStreamRequestInputTokens + this.lastStreamRequestOutputTokens);
+    }
+    enqueueTimeline(item) {
+        this.pushEvent({ type: "timeline", item, provider: "claude" });
+    }
+    flushPendingToolCalls() {
+        for (const [id, entry] of this.toolUseCache) {
+            if (entry.started) {
+                this.pushToolCall(mapClaudeCanceledToolCall({
+                    name: entry.name,
+                    callId: id,
+                    input: entry.input ?? null,
+                    output: null,
+                }));
+            }
+        }
+        this.toolUseCache.clear();
+        this.sidechainTracker.clear();
+    }
+    pushToolCall(item, target) {
+        if (!item) {
+            return;
+        }
+        if (target) {
+            target.push(item);
+            return;
+        }
+        this.enqueueTimeline(item);
+    }
+    pushEvent(event) {
+        this.notifySubscribers(event);
+    }
+    notifySubscribers(event) {
+        const turnId = this.activeForegroundTurnId ?? this.autonomousTurn?.id;
+        const tagged = turnId ? { ...event, turnId } : event;
+        for (const callback of this.subscribers) {
+            try {
+                callback(tagged);
+            }
+            catch (error) {
+                this.logger.warn({ err: error }, "Subscriber callback threw");
+            }
+        }
+    }
+    normalizePermissionUpdates(updates) {
+        if (!updates || updates.length === 0) {
+            return undefined;
+        }
+        const normalized = updates.filter(isPermissionUpdate);
+        return normalized.length > 0 ? normalized : undefined;
+    }
+    rejectAllPendingPermissions(error) {
+        for (const [id, pending] of this.pendingPermissions) {
+            pending.cleanup?.();
+            pending.reject(error);
+            this.pendingPermissions.delete(id);
+        }
+    }
+    loadPersistedHistory(sessionId) {
+        try {
+            const historyPath = this.resolveHistoryPath(sessionId);
+            if (!historyPath || !fs.existsSync(historyPath)) {
+                return;
+            }
+            this.ingestPersistedHistory(fs.readFileSync(historyPath, "utf8"));
+        }
+        catch (error) {
+            // ignore history load failures
+        }
+    }
+    ingestPersistedHistory(content) {
+        if (!content) {
+            return;
+        }
+        const timeline = [];
+        for (const line of content.split(/\r?\n/)) {
+            this.ingestPersistedHistoryLine(line, timeline);
+        }
+        if (timeline.length > 0) {
+            this.persistedHistory = [...this.persistedHistory, ...timeline];
+            this.historyPending = true;
+        }
+    }
+    ingestPersistedHistoryLine(line, timeline) {
+        const trimmed = line.trim();
+        if (!trimmed) {
+            return;
+        }
+        let entry;
+        try {
+            entry = JSON.parse(trimmed);
+        }
+        catch {
+            return;
+        }
+        if (entry.isSidechain) {
+            return;
+        }
+        if (entry.type === "user" && typeof entry.uuid === "string") {
+            this.rememberUserMessageId(entry.uuid);
+        }
+        const items = this.convertHistoryEntry(entry);
+        if (items.length > 0) {
+            timeline.push(...items);
+        }
+    }
+    resolveHistoryPath(sessionId) {
+        const cwd = this.config.cwd;
+        if (!cwd)
+            return null;
+        // Match Claude CLI's path sanitization: replace slashes, dots, and underscores with dashes
+        const sanitized = cwd.replace(/[\\/\.]/g, "-").replace(/_/g, "-");
+        const configDir = process.env.CLAUDE_CONFIG_DIR ?? path.join(os.homedir(), ".claude");
+        const dir = path.join(configDir, "projects", sanitized);
+        return path.join(dir, `${sessionId}.jsonl`);
+    }
+    convertHistoryEntry(entry) {
+        return convertClaudeHistoryEntry(entry, (content) => this.mapBlocksToTimeline(content));
+    }
+    // Maps Claude content blocks into AgentTimelineItems.
+    //
+    // textMessageType controls what type text blocks emit:
+    //   - "assistant_message" (default): one item per text block (streaming granularity)
+    //   - "user_message": coalesces all text blocks into a single user_message
+    //     (matches extractUserMessageText semantics: trim each block, join with "\n\n")
+    //
+    // suppressAssistantText only applies when textMessageType is "assistant_message" — user text
+    // must never be suppressed since the TimelineAssembler only handles assistant text.
+    //
+    // NOTE: convertClaudeHistoryEntry uses extractUserMessageText directly instead of this function
+    // for user entries. Both paths must produce equivalent user_message items.
+    mapBlocksToTimeline(content, options) {
+        const textMessageType = options?.textMessageType ?? "assistant_message";
+        const suppressText = textMessageType === "assistant_message" && (options?.suppressAssistantText ?? false);
+        const suppressReasoning = options?.suppressReasoning ?? false;
+        if (typeof content === "string") {
+            if (!content ||
+                content === INTERRUPT_TOOL_USE_PLACEHOLDER ||
+                isClaudeTranscriptNoiseText(content)) {
+                return [];
+            }
+            if (suppressText) {
+                return [];
+            }
+            return [{ type: textMessageType, text: content }];
+        }
+        const items = [];
+        // User SDK entries can arrive as multiple text blocks, but Seawork treats them as one message.
+        const userTextParts = [];
+        for (const block of content) {
+            switch (block.type) {
+                case "text":
+                case "text_delta":
+                    if (block.text &&
+                        block.text !== INTERRUPT_TOOL_USE_PLACEHOLDER &&
+                        !isClaudeTranscriptNoiseText(block.text)) {
+                        if (textMessageType === "user_message") {
+                            const trimmed = block.text.trim();
+                            if (trimmed) {
+                                userTextParts.push(trimmed);
+                            }
+                        }
+                        else if (!suppressText) {
+                            items.push({ type: "assistant_message", text: block.text });
+                        }
+                    }
+                    break;
+                case "thinking":
+                case "thinking_delta":
+                    if (block.thinking) {
+                        if (!suppressReasoning) {
+                            items.push({ type: "reasoning", text: block.thinking });
+                        }
+                    }
+                    break;
+                case "tool_use":
+                case "server_tool_use":
+                case "mcp_tool_use": {
+                    this.handleToolUseStart(block, items);
+                    break;
+                }
+                case "tool_result":
+                case "mcp_tool_result":
+                case "web_fetch_tool_result":
+                case "web_search_tool_result":
+                case "code_execution_tool_result":
+                case "bash_code_execution_tool_result":
+                case "text_editor_code_execution_tool_result": {
+                    this.handleToolResult(block, items);
+                    break;
+                }
+                default:
+                    break;
+            }
+        }
+        if (textMessageType === "user_message" && userTextParts.length > 0) {
+            items.unshift({
+                type: "user_message",
+                text: userTextParts.join("\n\n"),
+            });
+        }
+        return items;
+    }
+    handleToolUseStart(block, items) {
+        const entry = this.upsertToolUseEntry(block);
+        if (!entry) {
+            return;
+        }
+        if (entry.started) {
+            return;
+        }
+        entry.started = true;
+        this.toolUseCache.set(entry.id, entry);
+        this.pushToolCall(mapClaudeRunningToolCall({
+            name: entry.name,
+            callId: entry.id,
+            input: entry.input ?? this.normalizeToolInput(block.input) ?? null,
+            output: null,
+        }), items);
+    }
+    handleToolResult(block, items) {
+        const entry = typeof block.tool_use_id === "string" ? this.toolUseCache.get(block.tool_use_id) : undefined;
+        const toolName = entry?.name ?? block.tool_name ?? "tool";
+        const callId = typeof block.tool_use_id === "string" && block.tool_use_id.length > 0
+            ? block.tool_use_id
+            : (entry?.id ?? null);
+        // Extract output from block.content (SDK always returns content in string form)
+        const output = this.buildToolOutput(block, entry);
+        if (block.is_error) {
+            this.pushToolCall(mapClaudeFailedToolCall({
+                name: toolName,
+                callId,
+                input: entry?.input ?? null,
+                output: output ?? null,
+                error: block,
+            }), items);
+        }
+        else {
+            this.pushToolCall(mapClaudeCompletedToolCall({
+                name: toolName,
+                callId,
+                input: entry?.input ?? null,
+                output: output ?? null,
+            }), items);
+        }
+        if (typeof block.tool_use_id === "string") {
+            this.toolUseCache.delete(block.tool_use_id);
+            this.sidechainTracker.delete(block.tool_use_id);
+        }
+    }
+    buildToolOutput(block, entry) {
+        if (block.is_error) {
+            return undefined;
+        }
+        const server = entry?.server ?? block.server ?? "tool";
+        const tool = entry?.name ?? block.tool_name ?? "tool";
+        const content = coerceToolResultContentToString(block.content);
+        const input = entry?.input;
+        // Build structured result based on tool type
+        const structured = this.buildStructuredToolResult(server, tool, content, input);
+        if (structured) {
+            return structured;
+        }
+        // Fallback format - try to parse JSON first
+        const result = {};
+        if (content.length > 0) {
+            try {
+                // If content is a JSON string, parse it
+                result.output = JSON.parse(content);
+            }
+            catch {
+                // If not JSON, return unchanged (no extra wrapping)
+                result.output = content;
+            }
+        }
+        // Preserve file changes tracked during tool execution
+        if (entry?.files?.length) {
+            result.files = entry.files;
+        }
+        return Object.keys(result).length > 0 ? result : undefined;
+    }
+    buildStructuredToolResult(server, tool, output, input) {
+        const normalizedServer = server.toLowerCase();
+        const normalizedTool = tool.toLowerCase();
+        // Command execution tools
+        if (normalizedServer.includes("bash") ||
+            normalizedServer.includes("shell") ||
+            normalizedServer.includes("command") ||
+            normalizedTool.includes("bash") ||
+            normalizedTool.includes("shell") ||
+            normalizedTool.includes("command") ||
+            (input && (typeof input.command === "string" || Array.isArray(input.command)))) {
+            const command = this.extractCommandText(input ?? {}) ?? "command";
+            return {
+                type: "command",
+                command,
+                output,
+                cwd: typeof input?.cwd === "string" ? input.cwd : undefined,
+            };
+        }
+        // File write tools (new files or complete replacements)
+        if (normalizedTool.includes("write") ||
+            normalizedTool === "write_file" ||
+            normalizedTool === "create_file") {
+            if (input && typeof input.file_path === "string") {
+                return {
+                    type: "file_write",
+                    filePath: input.file_path,
+                    oldContent: "",
+                    newContent: typeof input.content === "string" ? input.content : output,
+                };
+            }
+        }
+        // File edit/patch tools
+        if (normalizedTool.includes("edit") ||
+            normalizedTool.includes("patch") ||
+            normalizedTool === "apply_patch" ||
+            normalizedTool === "apply_diff") {
+            if (input && typeof input.file_path === "string") {
+                // Support both old_str/new_str and old_string/new_string parameter names
+                const oldContent = typeof input.old_str === "string"
+                    ? input.old_str
+                    : typeof input.old_string === "string"
+                        ? input.old_string
+                        : undefined;
+                const newContent = typeof input.new_str === "string"
+                    ? input.new_str
+                    : typeof input.new_string === "string"
+                        ? input.new_string
+                        : undefined;
+                return {
+                    type: "file_edit",
+                    filePath: input.file_path,
+                    diff: typeof input.patch === "string"
+                        ? input.patch
+                        : typeof input.diff === "string"
+                            ? input.diff
+                            : undefined,
+                    oldContent,
+                    newContent,
+                };
+            }
+        }
+        // File read tools
+        if (normalizedTool.includes("read") ||
+            normalizedTool === "read_file" ||
+            normalizedTool === "view_file") {
+            if (input && typeof input.file_path === "string") {
+                return {
+                    type: "file_read",
+                    filePath: input.file_path,
+                    content: output,
+                };
+            }
+        }
+        return undefined;
+    }
+    mapPartialEvent(event, options) {
+        if (event.type === "content_block_start") {
+            const block = isClaudeContentChunk(event.content_block) ? event.content_block : null;
+            if (block?.type === "tool_use" &&
+                typeof event.index === "number" &&
+                typeof block.id === "string") {
+                this.toolUseIndexToId.set(event.index, block.id);
+                this.toolUseInputBuffers.delete(block.id);
+            }
+        }
+        else if (event.type === "content_block_delta") {
+            const delta = isClaudeContentChunk(event.delta) ? event.delta : null;
+            if (delta?.type === "input_json_delta") {
+                const partialJson = typeof delta.partial_json === "string" ? delta.partial_json : undefined;
+                this.handleToolInputDelta(event.index, partialJson);
+                return [];
+            }
+        }
+        else if (event.type === "content_block_stop" && typeof event.index === "number") {
+            const toolId = this.toolUseIndexToId.get(event.index);
+            if (toolId) {
+                this.toolUseIndexToId.delete(event.index);
+                this.toolUseInputBuffers.delete(toolId);
+            }
+        }
+        switch (event.type) {
+            case "content_block_start":
+                return isClaudeContentChunk(event.content_block)
+                    ? this.mapBlocksToTimeline([event.content_block], {
+                        suppressAssistantText: options?.suppressAssistantText,
+                        suppressReasoning: options?.suppressReasoning,
+                    })
+                    : [];
+            case "content_block_delta":
+                return isClaudeContentChunk(event.delta)
+                    ? this.mapBlocksToTimeline([event.delta], {
+                        suppressAssistantText: options?.suppressAssistantText,
+                        suppressReasoning: options?.suppressReasoning,
+                    })
+                    : [];
+            default:
+                return [];
+        }
+    }
+    upsertToolUseEntry(block) {
+        const id = typeof block.id === "string" ? block.id : undefined;
+        if (!id) {
+            return null;
+        }
+        const existing = this.toolUseCache.get(id) ??
+            {
+                id,
+                name: typeof block.name === "string" && block.name.length > 0 ? block.name : "tool",
+                server: typeof block.server === "string" && block.server.length > 0
+                    ? block.server
+                    : typeof block.name === "string" && block.name.length > 0
+                        ? block.name
+                        : "tool",
+                classification: "generic",
+                started: false,
+            };
+        if (typeof block.name === "string" && block.name.length > 0) {
+            existing.name = block.name;
+        }
+        if (typeof block.server === "string" && block.server.length > 0) {
+            existing.server = block.server;
+        }
+        else if (!existing.server) {
+            existing.server = existing.name;
+        }
+        if (block.type === "tool_use" ||
+            block.type === "mcp_tool_use" ||
+            block.type === "server_tool_use") {
+            const input = this.normalizeToolInput(block.input);
+            if (input) {
+                this.applyToolInput(existing, input);
+            }
+        }
+        this.toolUseCache.set(id, existing);
+        return existing;
+    }
+    handleToolInputDelta(index, partialJson) {
+        if (typeof index !== "number" || typeof partialJson !== "string") {
+            return;
+        }
+        const toolId = this.toolUseIndexToId.get(index);
+        if (!toolId) {
+            return;
+        }
+        const buffer = (this.toolUseInputBuffers.get(toolId) ?? "") + partialJson;
+        this.toolUseInputBuffers.set(toolId, buffer);
+        const entry = this.toolUseCache.get(toolId);
+        const parsed = parsePartialJsonObject(buffer);
+        if (!entry || !parsed) {
+            return;
+        }
+        const normalized = this.normalizeToolInput(parsed.value);
+        if (!normalized) {
+            return;
+        }
+        if (!parsed.complete && Object.keys(normalized).length === 0) {
+            return;
+        }
+        if (this.areToolInputsEqual(entry.input ?? undefined, normalized)) {
+            return;
+        }
+        this.applyToolInput(entry, normalized);
+        this.toolUseCache.set(toolId, entry);
+        this.pushToolCall(mapClaudeRunningToolCall({
+            name: entry.name,
+            callId: toolId,
+            input: normalized,
+            output: null,
+        }));
+    }
+    normalizeToolInput(input) {
+        if (!isMetadata(input)) {
+            return null;
+        }
+        return input;
+    }
+    areToolInputsEqual(left, right) {
+        if (!left) {
+            return false;
+        }
+        const leftKeys = Object.keys(left);
+        const rightKeys = Object.keys(right);
+        if (leftKeys.length !== rightKeys.length) {
+            return false;
+        }
+        return rightKeys.every((key) => left[key] === right[key]);
+    }
+    applyToolInput(entry, input) {
+        entry.input = input;
+        if (this.isCommandTool(entry.name, input)) {
+            entry.classification = "command";
+            entry.commandText = this.extractCommandText(input) ?? entry.commandText;
+        }
+        else {
+            const files = this.extractFileChanges(input);
+            if (files?.length) {
+                entry.classification = "file_change";
+                entry.files = files;
+            }
+        }
+    }
+    isCommandTool(name, input) {
+        const normalized = name.toLowerCase();
+        if (normalized.includes("bash") ||
+            normalized.includes("shell") ||
+            normalized.includes("terminal") ||
+            normalized.includes("command")) {
+            return true;
+        }
+        if (typeof input.command === "string" || Array.isArray(input.command)) {
+            return true;
+        }
+        return false;
+    }
+    extractCommandText(input) {
+        const command = input.command;
+        if (typeof command === "string" && command.length > 0) {
+            return command;
+        }
+        if (Array.isArray(command)) {
+            const tokens = command.filter((value) => typeof value === "string");
+            if (tokens.length > 0) {
+                return tokens.join(" ");
+            }
+        }
+        if (typeof input.description === "string" && input.description.length > 0) {
+            return input.description;
+        }
+        return undefined;
+    }
+    extractFileChanges(input) {
+        if (typeof input.file_path === "string" && input.file_path.length > 0) {
+            const relative = this.relativizePath(input.file_path);
+            if (relative) {
+                return [{ path: relative, kind: this.detectFileKind(input.file_path) }];
+            }
+        }
+        if (typeof input.patch === "string" && input.patch.length > 0) {
+            const files = this.parsePatchFileList(input.patch);
+            if (files.length > 0) {
+                return files.map((entry) => ({
+                    path: this.relativizePath(entry.path) ?? entry.path,
+                    kind: entry.kind,
+                }));
+            }
+        }
+        if (Array.isArray(input.files)) {
+            const files = [];
+            for (const value of input.files) {
+                if (typeof value === "string" && value.length > 0) {
+                    files.push({
+                        path: this.relativizePath(value) ?? value,
+                        kind: this.detectFileKind(value),
+                    });
+                }
+            }
+            if (files.length > 0) {
+                return files;
+            }
+        }
+        return undefined;
+    }
+    detectFileKind(filePath) {
+        try {
+            return fs.existsSync(filePath) ? "update" : "add";
+        }
+        catch {
+            return "update";
+        }
+    }
+    relativizePath(target) {
+        if (!target) {
+            return undefined;
+        }
+        const cwd = this.config.cwd;
+        if (cwd && target.startsWith(cwd)) {
+            const relative = path.relative(cwd, target);
+            return relative.length > 0 ? relative : path.basename(target);
+        }
+        return target;
+    }
+    parsePatchFileList(patch) {
+        const files = [];
+        const seen = new Set();
+        for (const line of patch.split(/\r?\n/)) {
+            const trimmed = line.trim();
+            let kind = null;
+            let parsedPath = null;
+            if (trimmed.startsWith("*** Add File:")) {
+                kind = "add";
+                parsedPath = trimmed.replace("*** Add File:", "").trim();
+            }
+            else if (trimmed.startsWith("*** Delete File:")) {
+                kind = "delete";
+                parsedPath = trimmed.replace("*** Delete File:", "").trim();
+            }
+            else if (trimmed.startsWith("*** Update File:")) {
+                kind = "update";
+                parsedPath = trimmed.replace("*** Update File:", "").trim();
+            }
+            if (kind && parsedPath && !seen.has(`${kind}:${parsedPath}`)) {
+                seen.add(`${kind}:${parsedPath}`);
+                files.push({ path: parsedPath, kind });
+            }
+        }
+        return files;
+    }
+}
+function hasToolLikeBlock(block) {
+    if (!block || typeof block !== "object") {
+        return false;
+    }
+    const type = typeof block.type === "string" ? block.type.toLowerCase() : "";
+    return type.includes("tool");
+}
+function readCompactionMetadata(source) {
+    const candidates = [source.compact_metadata, source.compactMetadata, source.compactionMetadata];
+    for (const candidate of candidates) {
+        if (!candidate || typeof candidate !== "object") {
+            continue;
+        }
+        const metadata = candidate;
+        const trigger = typeof metadata.trigger === "string" ? metadata.trigger : undefined;
+        const preTokensRaw = metadata.preTokens ?? metadata.pre_tokens;
+        const preTokens = typeof preTokensRaw === "number" ? preTokensRaw : undefined;
+        return { trigger, preTokens };
+    }
+    return null;
+}
+function normalizeHistoryBlocks(content) {
+    if (Array.isArray(content)) {
+        const blocks = content.filter((entry) => isClaudeContentChunk(entry));
+        return blocks.length > 0 ? blocks : null;
+    }
+    if (isClaudeContentChunk(content)) {
+        return [content];
+    }
+    return null;
+}
+export function convertClaudeHistoryEntry(entry, mapBlocks) {
+    if (entry.type === "system" && entry.subtype === "compact_boundary") {
+        const compactMetadata = readCompactionMetadata(entry);
+        return [
+            {
+                type: "compaction",
+                status: "completed",
+                trigger: compactMetadata?.trigger === "manual" ? "manual" : "auto",
+                preTokens: compactMetadata?.preTokens,
+            },
+        ];
+    }
+    const taskNotificationItem = mapTaskNotificationSystemRecordToToolCall(entry);
+    if (taskNotificationItem) {
+        return [taskNotificationItem];
+    }
+    if (entry.isCompactSummary) {
+        return [];
+    }
+    if (entry.type === "user" && isSyntheticUserEntry(entry)) {
+        return [];
+    }
+    const message = entry?.message;
+    if (!message || !("content" in message)) {
+        return [];
+    }
+    const content = message.content;
+    if ((entry.type === "user" || entry.type === "assistant") &&
+        isClaudeTranscriptNoiseContent(content)) {
+        return [];
+    }
+    const normalizedBlocks = normalizeHistoryBlocks(content);
+    const contentValue = typeof content === "string" ? content : normalizedBlocks;
+    const hasToolBlock = normalizedBlocks?.some((block) => hasToolLikeBlock(block)) ?? false;
+    const userMessageId = entry.type === "user" && typeof entry.uuid === "string" && entry.uuid.length > 0
+        ? entry.uuid
+        : null;
+    if (entry.type === "user") {
+        const taskNotificationItem = mapTaskNotificationUserContentToToolCall({
+            content,
+            messageId: userMessageId,
+        });
+        if (taskNotificationItem) {
+            return [taskNotificationItem];
+        }
+    }
+    const timeline = [];
+    if (entry.type === "user") {
+        const text = extractUserMessageText(content);
+        if (text) {
+            timeline.push({
+                type: "user_message",
+                text,
+                ...(userMessageId ? { messageId: userMessageId } : {}),
+            });
+        }
+    }
+    if (hasToolBlock && normalizedBlocks) {
+        const mapped = mapBlocks(normalizedBlocks);
+        if (entry.type === "user") {
+            const toolItems = mapped.filter((item) => item.type === "tool_call");
+            return timeline.length ? [...timeline, ...toolItems] : toolItems;
+        }
+        return mapped;
+    }
+    if (entry.type === "assistant" && contentValue) {
+        return mapBlocks(contentValue);
+    }
+    return timeline;
+}
+function createAsyncMessageInput() {
+    const queue = [];
+    const resolvers = [];
+    let closed = false;
+    return {
+        push(item) {
+            if (closed) {
+                return;
+            }
+            const resolve = resolvers.shift();
+            if (resolve) {
+                resolve({ value: item, done: false });
+                return;
+            }
+            queue.push(item);
+        },
+        end() {
+            closed = true;
+            while (resolvers.length > 0) {
+                const resolve = resolvers.shift();
+                resolve?.({ value: undefined, done: true });
+            }
+        },
+        iterable: {
+            [Symbol.asyncIterator]() {
+                return {
+                    next: () => {
+                        if (queue.length > 0) {
+                            const value = queue.shift();
+                            if (value !== undefined) {
+                                return Promise.resolve({ value, done: false });
+                            }
+                        }
+                        if (closed) {
+                            return Promise.resolve({ value: undefined, done: true });
+                        }
+                        return new Promise((resolve) => {
+                            resolvers.push(resolve);
+                        });
+                    },
+                };
+            },
+        },
+    };
+}
+async function pathExists(target) {
+    try {
+        await fsPromises.access(target);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function collectRecentClaudeSessions(root, limit) {
+    let projectDirs;
+    try {
+        projectDirs = await fsPromises.readdir(root);
+    }
+    catch {
+        return [];
+    }
+    const candidates = [];
+    for (const dirName of projectDirs) {
+        const projectPath = path.join(root, dirName);
+        let stats;
+        try {
+            stats = await fsPromises.stat(projectPath);
+        }
+        catch {
+            continue;
+        }
+        if (!stats.isDirectory()) {
+            continue;
+        }
+        let files;
+        try {
+            files = await fsPromises.readdir(projectPath);
+        }
+        catch {
+            continue;
+        }
+        for (const file of files) {
+            if (!file.endsWith(".jsonl")) {
+                continue;
+            }
+            const fullPath = path.join(projectPath, file);
+            try {
+                const fileStats = await fsPromises.stat(fullPath);
+                candidates.push({ path: fullPath, mtime: fileStats.mtime });
+            }
+            catch {
+                // ignore stat errors for individual files
+            }
+        }
+    }
+    return candidates.sort((a, b) => b.mtime.getTime() - a.mtime.getTime()).slice(0, limit);
+}
+async function parseClaudeSessionDescriptor(filePath, mtime) {
+    let content;
+    try {
+        content = await fsPromises.readFile(filePath, "utf8");
+    }
+    catch {
+        return null;
+    }
+    let sessionId = null;
+    let cwd = null;
+    let title = null;
+    const timeline = [];
+    for (const rawLine of content.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (!line)
+            continue;
+        let entry;
+        try {
+            entry = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (entry?.isSidechain) {
+            continue;
+        }
+        if (entry?.type === "user" && isSyntheticUserEntry(entry)) {
+            continue;
+        }
+        if (!sessionId && typeof entry.sessionId === "string") {
+            sessionId = entry.sessionId;
+        }
+        if (!cwd && typeof entry.cwd === "string") {
+            cwd = entry.cwd;
+        }
+        if (entry.type === "user" && entry.message) {
+            const text = extractClaudeUserText(entry.message);
+            if (text) {
+                if (!title) {
+                    title = text;
+                }
+                timeline.push({ type: "user_message", text });
+            }
+        }
+        else if (entry.type === "assistant" && entry.message) {
+            const text = extractClaudeUserText(entry.message);
+            if (text) {
+                timeline.push({ type: "assistant_message", text });
+            }
+        }
+        if (sessionId && cwd && title) {
+            break;
+        }
+    }
+    if (!sessionId || !cwd) {
+        return null;
+    }
+    const persistence = {
+        provider: "claude",
+        sessionId,
+        nativeHandle: sessionId,
+        metadata: {
+            provider: "claude",
+            cwd,
+        },
+    };
+    return {
+        provider: "claude",
+        sessionId,
+        cwd,
+        title: (title ?? "").trim() || `Claude session ${sessionId.slice(0, 8)}`,
+        lastActivityAt: mtime,
+        persistence,
+        timeline,
+    };
+}
+function extractClaudeUserText(message) {
+    if (!message) {
+        return null;
+    }
+    if (typeof message.content === "string") {
+        const normalized = message.content.trim();
+        return normalized && !isClaudeTranscriptNoiseText(normalized) ? normalized : null;
+    }
+    if (typeof message.text === "string") {
+        const normalized = message.text.trim();
+        return normalized && !isClaudeTranscriptNoiseText(normalized) ? normalized : null;
+    }
+    if (Array.isArray(message.content)) {
+        for (const block of message.content) {
+            if (block && typeof block.text === "string") {
+                const normalized = block.text.trim();
+                if (normalized && !isClaudeTranscriptNoiseText(normalized)) {
+                    return normalized;
+                }
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=claude-agent.js.map