@getpaseo/server 0.1.2

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

@@ -0,0 +1,2056 @@
+import { execSync, spawn } from "node:child_process";
+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 { applyProviderEnv, isProviderCommandAvailable, } from "../provider-launch-config.js";
+import { getOrchestratorModeInstructions } from "../orchestrator-instructions.js";
+const fsPromises = promises;
+function normalizeClaudeModelLabel(model) {
+    const fallback = model.displayName?.trim() || model.value;
+    const prefix = model.description?.split(/[·•]/)[0]?.trim() || "";
+    if (!prefix)
+        return fallback;
+    // Prefer concrete versioned labels from description (e.g. "Opus 4.6",
+    // "Sonnet 4.5"), especially when displayName is generic like
+    // "Default (recommended)".
+    if (/\d/.test(prefix)) {
+        return prefix;
+    }
+    return fallback;
+}
+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));
+function resolveClaudeBinary() {
+    try {
+        const claudePath = execSync("which claude", { encoding: "utf8" }).trim();
+        if (claudePath) {
+            return claudePath;
+        }
+    }
+    catch {
+        // fall through
+    }
+    throw new Error("Claude CLI not found. Install claude or configure agents.providers.claude.command.mode='replace'.");
+}
+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: [...(commandConfig.args ?? []), ...spawnOptions.args],
+        };
+    }
+    return {
+        command: commandConfig.argv[0],
+        args: [...commandConfig.argv.slice(1), ...spawnOptions.args],
+    };
+}
+export function extractUserMessageText(content) {
+    if (typeof content === "string") {
+        const normalized = content.trim();
+        return normalized.length > 0 ? normalized : null;
+    }
+    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()) {
+            parts.push(text.trim());
+            continue;
+        }
+        const input = typeof block.input === "string" ? block.input : undefined;
+        if (input && input.trim()) {
+            parts.push(input.trim());
+        }
+    }
+    if (parts.length === 0) {
+        return null;
+    }
+    const combined = parts.join("\n\n").trim();
+    return combined.length > 0 ? combined : null;
+}
+const DEFAULT_PERMISSION_TIMEOUT_MS = 120000;
+function isMetadata(value) {
+    return typeof value === "object" && value !== null;
+}
+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";
+}
+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;
+        try {
+            this.claudePath = execSync("which claude", { encoding: "utf8" }).trim() || null;
+        }
+        catch {
+            this.claudePath = null;
+        }
+    }
+    applyRuntimeSettings(options) {
+        const hasEnvOverrides = Object.keys(this.runtimeSettings?.env ?? {}).length > 0;
+        const commandMode = this.runtimeSettings?.command?.mode;
+        const needsCustomSpawn = hasEnvOverrides || commandMode === "append" || commandMode === "replace";
+        if (!needsCustomSpawn) {
+            return options;
+        }
+        return {
+            ...options,
+            spawnClaudeCodeProcess: (spawnOptions) => {
+                const resolved = resolveClaudeSpawnCommand(spawnOptions, this.runtimeSettings);
+                return spawn(resolved.command, resolved.args, {
+                    cwd: spawnOptions.cwd,
+                    env: applyProviderEnv(spawnOptions.env, this.runtimeSettings),
+                    signal: spawnOptions.signal,
+                    stdio: ["pipe", "pipe", "pipe"],
+                });
+            },
+        };
+    }
+    async createSession(config) {
+        const claudeConfig = this.assertConfig(config);
+        return new ClaudeAgentSession(claudeConfig, {
+            defaults: this.defaults,
+            claudePath: this.claudePath,
+            runtimeSettings: this.runtimeSettings,
+            logger: this.logger,
+        });
+    }
+    async resumeSession(handle, overrides) {
+        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,
+            claudePath: this.claudePath,
+            runtimeSettings: this.runtimeSettings,
+            handle,
+            logger: this.logger,
+        });
+    }
+    async listModels(options) {
+        const prompt = (async function* empty() { })();
+        const claudeOptions = {
+            cwd: options?.cwd ?? process.cwd(),
+            permissionMode: "plan",
+            includePartialMessages: false,
+            ...(this.claudePath ? { pathToClaudeCodeExecutable: this.claudePath } : {}),
+        };
+        const claudeQuery = query({
+            prompt,
+            options: this.applyRuntimeSettings(claudeOptions),
+        });
+        try {
+            const models = await claudeQuery.supportedModels();
+            return models.map((model) => ({
+                provider: "claude",
+                id: model.value,
+                label: normalizeClaudeModelLabel(model),
+                description: model.description,
+                thinkingOptions: [
+                    { id: "off", label: "Off", isDefault: true },
+                    { id: "on", label: "On" },
+                ],
+                defaultThinkingOptionId: "off",
+                metadata: {
+                    description: model.description,
+                },
+            }));
+        }
+        finally {
+            if (typeof claudeQuery.return === "function") {
+                try {
+                    await claudeQuery.return();
+                }
+                catch {
+                    // ignore shutdown errors
+                }
+            }
+        }
+    }
+    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 commandConfig = this.runtimeSettings?.command;
+        if (commandConfig?.mode === "replace") {
+            return isProviderCommandAvailable(commandConfig, resolveClaudeBinary);
+        }
+        return this.claudePath !== null;
+    }
+    assertConfig(config) {
+        if (config.provider !== "claude") {
+            throw new Error(`ClaudeAgentClient received config for provider '${config.provider}'`);
+        }
+        return { ...config, provider: "claude" };
+    }
+}
+class ClaudeAgentSession {
+    constructor(config, options) {
+        this.provider = "claude";
+        this.capabilities = CLAUDE_CAPABILITIES;
+        this.query = null;
+        this.input = null;
+        this.availableModes = DEFAULT_MODES;
+        this.toolUseCache = new Map();
+        this.toolUseIndexToId = new Map();
+        this.toolUseInputBuffers = new Map();
+        this.pendingPermissions = new Map();
+        this.eventQueue = null;
+        this.persistedHistory = [];
+        this.historyPending = false;
+        this.turnCancelRequested = false;
+        // NOTE: streamedAssistantTextThisTurn and streamedReasoningThisTurn were removed
+        // These flags are now tracked per-turn via TurnContext to prevent race conditions
+        // when multiple stream() calls overlap (e.g., interrupt + new message)
+        this.cancelCurrentTurn = null;
+        // Track the pending interrupt promise so we can await it in processPrompt
+        // This ensures the interrupt's response is consumed before we call query.next()
+        this.pendingInterruptPromise = null;
+        // Track the current turn ID and active turn promise to serialize concurrent stream() calls
+        // and prevent race conditions where two processPrompt() loops run against the same query
+        this.currentTurnId = 0;
+        this.activeTurnPromise = null;
+        this.cachedRuntimeInfo = null;
+        this.lastOptionsModel = null;
+        this.activeSidechains = new Map();
+        this.compacting = false;
+        this.queryRestartNeeded = 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 detail = 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,
+                suggestions: options.suggestions?.map((suggestion) => ({ ...suggestion })),
+                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 timeout = setTimeout(() => {
+                    this.pendingPermissions.delete(requestId);
+                    cleanup();
+                    const error = new Error("Permission request timed out");
+                    this.pushEvent({
+                        type: "permission_resolved",
+                        provider: "claude",
+                        requestId,
+                        resolution: { behavior: "deny", message: "timeout" },
+                    });
+                    reject(error);
+                }, DEFAULT_PERMISSION_TIMEOUT_MS);
+                cleanupFns.push(() => clearTimeout(timeout));
+                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.defaults = options.defaults;
+        this.claudePath = options.claudePath;
+        this.runtimeSettings = options.runtimeSettings;
+        this.logger = options.logger;
+        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";
+    }
+    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.cachedRuntimeInfo = info;
+        return { ...info };
+    }
+    async run(prompt, options) {
+        const events = this.stream(prompt, options);
+        const timeline = [];
+        let finalText = "";
+        let usage;
+        for await (const event of events) {
+            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;
+                    }
+                }
+            }
+            else if (event.type === "turn_completed") {
+                usage = event.usage;
+            }
+            else if (event.type === "turn_failed") {
+                throw new Error(event.error);
+            }
+        }
+        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 *stream(prompt, options) {
+        void options;
+        // Increment turn ID to invalidate any in-flight processPrompt() loops from previous turns.
+        // This prevents race conditions where an interrupted turn's events get mixed with the new turn.
+        const turnId = ++this.currentTurnId;
+        // Cancel the previous turn if one exists. The caller of interrupt() is responsible
+        // for awaiting completion - the new turn just signals cancellation and proceeds.
+        if (this.cancelCurrentTurn) {
+            this.cancelCurrentTurn();
+        }
+        // Reset cancel flag at the start of each turn to prevent stale state from previous turns
+        this.turnCancelRequested = false;
+        const sdkMessage = this.toSdkUserMessage(prompt);
+        const queue = new Pushable();
+        this.eventQueue = queue;
+        let finishedNaturally = false;
+        let cancelIssued = false;
+        const requestCancel = () => {
+            if (cancelIssued) {
+                return;
+            }
+            cancelIssued = true;
+            this.turnCancelRequested = true;
+            // Store the interrupt promise so processPrompt can await it before calling query.next()
+            this.pendingInterruptPromise = this.interruptActiveTurn().catch((error) => {
+                this.logger.warn({ err: error }, "Failed to interrupt during cancel");
+            });
+            this.flushPendingToolCalls();
+            // Push turn_canceled before ending the queue so consumers get proper lifecycle signals
+            queue.push({
+                type: "turn_canceled",
+                provider: "claude",
+                reason: "Interrupted",
+            });
+            queue.end();
+        };
+        this.cancelCurrentTurn = requestCancel;
+        if (this.historyPending && this.persistedHistory.length > 0) {
+            for (const item of this.persistedHistory) {
+                queue.push({ type: "timeline", item, provider: "claude" });
+            }
+            this.historyPending = false;
+            this.persistedHistory = [];
+        }
+        // Start forwarding events and track the promise so future turns can wait for completion
+        const forwardPromise = this.forwardPromptEvents(sdkMessage, queue, turnId);
+        this.activeTurnPromise = forwardPromise;
+        forwardPromise.catch((error) => {
+            this.logger.error({ err: error }, "Unexpected error in forwardPromptEvents");
+        });
+        try {
+            for await (const event of queue) {
+                yield event;
+                if (event.type === "turn_completed" ||
+                    event.type === "turn_failed" ||
+                    event.type === "turn_canceled") {
+                    finishedNaturally = true;
+                    break;
+                }
+            }
+        }
+        finally {
+            if (!finishedNaturally && !cancelIssued) {
+                requestCancel();
+            }
+            if (this.eventQueue === queue) {
+                this.eventQueue = null;
+            }
+            if (this.cancelCurrentTurn === requestCancel) {
+                this.cancelCurrentTurn = null;
+            }
+            // Clear the active turn promise if it's still ours
+            if (this.activeTurnPromise === forwardPromise) {
+                this.activeTurnPromise = null;
+            }
+        }
+    }
+    async interrupt() {
+        this.cancelCurrentTurn?.();
+    }
+    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 query = await this.ensureQuery();
+        await query.setPermissionMode(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.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 (normalizedThinkingOptionId === "on") {
+            this.config.thinkingOptionId = "on";
+        }
+        else if (normalizedThinkingOptionId === "off") {
+            this.config.thinkingOptionId = "off";
+        }
+        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") {
+                await this.setMode("acceptEdits");
+                this.pushToolCall(mapClaudeCompletedToolCall({
+                    name: "plan_approval",
+                    callId: pending.request.id,
+                    input: pending.request.input ?? null,
+                    output: { approved: true },
+                }));
+            }
+            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.rejectAllPendingPermissions(new Error("Claude session closed"));
+        this.input?.end();
+        await this.query?.interrupt?.();
+        await this.query?.return?.();
+        this.query = null;
+        this.input = null;
+    }
+    async listCommands() {
+        const q = await this.ensureQuery();
+        const commands = await q.supportedCommands();
+        return commands.map((cmd) => ({
+            name: cmd.name,
+            description: cmd.description,
+            argumentHint: cmd.argumentHint,
+        }));
+    }
+    async executeCommand(commandName, args) {
+        const commandPrompt = args ? `/${commandName} ${args}` : `/${commandName}`;
+        // Commands return their output in a user message with <local-command-stdout> tags,
+        // NOT as an assistant message. We need to extract that specifically.
+        const events = this.stream(commandPrompt);
+        const timeline = [];
+        let commandOutput = "";
+        let usage;
+        for await (const event of events) {
+            if (event.type === "timeline") {
+                timeline.push(event.item);
+                // Check for command output in user messages
+                if (event.item.type === "user_message") {
+                    const text = event.item.text;
+                    const match = text.match(/<local-command-stdout>([\s\S]*?)<\/local-command-stdout>/);
+                    if (match) {
+                        commandOutput = match[1].trim();
+                    }
+                }
+                // Also capture assistant messages (some commands may produce both)
+                if (event.item.type === "assistant_message" && !commandOutput) {
+                    commandOutput = event.item.text;
+                }
+            }
+            else if (event.type === "turn_completed") {
+                usage = event.usage;
+            }
+            else if (event.type === "turn_failed") {
+                throw new Error(event.error);
+            }
+        }
+        return {
+            text: commandOutput,
+            timeline,
+            usage,
+        };
+    }
+    async ensureQuery() {
+        if (this.query && !this.queryRestartNeeded) {
+            return this.query;
+        }
+        if (this.queryRestartNeeded && this.query) {
+            this.input?.end();
+            try {
+                await this.query.return?.();
+            }
+            catch { /* ignore */ }
+            this.query = null;
+            this.input = null;
+            this.queryRestartNeeded = false;
+        }
+        const input = new Pushable();
+        const options = this.buildOptions();
+        this.logger.debug({ options }, "claude query");
+        this.input = input;
+        this.query = query({ prompt: input, options });
+        await this.query.setPermissionMode(this.currentMode);
+        return this.query;
+    }
+    buildOptions() {
+        const configuredThinkingOptionId = this.config.thinkingOptionId;
+        const thinkingOptionId = configuredThinkingOptionId && configuredThinkingOptionId !== "default"
+            ? configuredThinkingOptionId
+            : "off";
+        let maxThinkingTokens;
+        if (thinkingOptionId === "on") {
+            maxThinkingTokens = 10000;
+        }
+        else if (thinkingOptionId === "off") {
+            maxThinkingTokens = 0;
+        }
+        const appendedSystemPrompt = [
+            getOrchestratorModeInstructions(),
+            this.config.systemPrompt?.trim(),
+        ]
+            .filter((entry) => typeof entry === "string" && entry.length > 0)
+            .join("\n\n");
+        const base = {
+            cwd: this.config.cwd,
+            includePartialMessages: true,
+            permissionMode: this.currentMode,
+            agents: this.defaults?.agents,
+            canUseTool: this.handlePermissionRequest,
+            ...(this.claudePath ? { pathToClaudeCodeExecutable: this.claudePath } : {}),
+            // 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: ["user", "project"],
+            stderr: (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",
+            },
+            // 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 } : {}),
+            ...(maxThinkingTokens !== undefined ? { maxThinkingTokens } : {}),
+            ...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) {
+        const hasEnvOverrides = Object.keys(this.runtimeSettings?.env ?? {}).length > 0;
+        const commandMode = this.runtimeSettings?.command?.mode;
+        const needsCustomSpawn = hasEnvOverrides || commandMode === "append" || commandMode === "replace";
+        if (!needsCustomSpawn) {
+            return options;
+        }
+        return {
+            ...options,
+            spawnClaudeCodeProcess: (spawnOptions) => {
+                const resolved = resolveClaudeSpawnCommand(spawnOptions, this.runtimeSettings);
+                return spawn(resolved.command, resolved.args, {
+                    cwd: spawnOptions.cwd,
+                    env: applyProviderEnv(spawnOptions.env, this.runtimeSettings),
+                    signal: spawnOptions.signal,
+                    stdio: ["pipe", "pipe", "pipe"],
+                });
+            },
+        };
+    }
+    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 });
+        }
+        return {
+            type: "user",
+            message: {
+                role: "user",
+                content,
+            },
+            parent_tool_use_id: null,
+            session_id: this.claudeSessionId ?? "",
+        };
+    }
+    async *processPrompt(sdkMessage, turnId) {
+        // If there's a pending interrupt, await it BEFORE calling ensureQuery().
+        // interruptActiveTurn() clears this.query after interrupt() returns,
+        // so we must wait for it to complete before we try to get the query.
+        if (this.pendingInterruptPromise) {
+            await this.pendingInterruptPromise;
+            this.pendingInterruptPromise = null;
+        }
+        // Check if we were superseded while waiting for the interrupt
+        if (this.currentTurnId !== turnId) {
+            return;
+        }
+        const query = await this.ensureQuery();
+        if (!this.input) {
+            throw new Error("Claude session input stream not initialized");
+        }
+        this.input.push(sdkMessage);
+        while (true) {
+            // Check if this turn has been superseded by a new one.
+            if (this.currentTurnId !== turnId) {
+                break;
+            }
+            const { value, done } = await query.next();
+            if (done) {
+                break;
+            }
+            if (!value) {
+                continue;
+            }
+            // Double-check turn ID after awaiting, in case a new turn started while we waited
+            if (this.currentTurnId !== turnId) {
+                break;
+            }
+            yield value;
+            if (value.type === "result") {
+                break;
+            }
+        }
+    }
+    async forwardPromptEvents(message, queue, turnId) {
+        // Create a turn-local context to track streaming state.
+        // This prevents race conditions when a new stream() call interrupts a running one.
+        const turnContext = {
+            streamedAssistantTextThisTurn: false,
+            streamedReasoningThisTurn: false,
+        };
+        let completedNormally = false;
+        try {
+            for await (const sdkEvent of this.processPrompt(message, turnId)) {
+                // Check if this turn has been superseded before pushing events
+                if (this.currentTurnId !== turnId) {
+                    break;
+                }
+                const events = this.translateMessageToEvents(sdkEvent, turnContext);
+                for (const event of events) {
+                    queue.push(event);
+                    if (event.type === "turn_completed") {
+                        completedNormally = true;
+                    }
+                }
+            }
+        }
+        catch (error) {
+            if (!this.turnCancelRequested && this.currentTurnId === turnId) {
+                queue.push({
+                    type: "turn_failed",
+                    provider: "claude",
+                    error: error instanceof Error ? error.message : "Claude stream failed",
+                });
+            }
+        }
+        finally {
+            // Emit terminal event for superseded turns so consumers get proper lifecycle signals.
+            // Use turn_canceled (not turn_failed) to distinguish intentional interruption from errors.
+            // Only emit if not already emitted by requestCancel() (indicated by turnCancelRequested).
+            const wasSuperseded = this.currentTurnId !== turnId;
+            if (wasSuperseded && !completedNormally && !this.turnCancelRequested) {
+                this.flushPendingToolCalls();
+                queue.push({
+                    type: "turn_canceled",
+                    provider: "claude",
+                    reason: "Interrupted by new message",
+                });
+            }
+            this.turnCancelRequested = false;
+            queue.end();
+        }
+    }
+    async interruptActiveTurn() {
+        const queryToInterrupt = this.query;
+        if (!queryToInterrupt || typeof queryToInterrupt.interrupt !== "function") {
+            this.logger.info("interruptActiveTurn: no query to interrupt");
+            return;
+        }
+        try {
+            this.logger.info("interruptActiveTurn: calling query.interrupt()...");
+            const t0 = Date.now();
+            await queryToInterrupt.interrupt();
+            this.logger.info({ durationMs: Date.now() - t0 }, "interruptActiveTurn: query.interrupt() returned");
+            // After interrupt(), the query iterator is done (returns done: true).
+            // Clear it so ensureQuery() creates a fresh query for the next turn.
+            // Also end the input stream and call return() to clean up the SDK process.
+            this.input?.end();
+            this.logger.info("interruptActiveTurn: calling query.return()...");
+            const t1 = Date.now();
+            await queryToInterrupt.return?.();
+            this.logger.info({ durationMs: Date.now() - t1 }, "interruptActiveTurn: query.return() returned");
+            this.query = null;
+            this.input = null;
+            this.queryRestartNeeded = false;
+        }
+        catch (error) {
+            this.logger.warn({ err: error }, "Failed to interrupt active turn");
+        }
+    }
+    handleSidechainMessage(message, parentToolUseId) {
+        let toolName;
+        if (message.type === "assistant") {
+            const content = message.message?.content;
+            if (Array.isArray(content)) {
+                for (const block of content) {
+                    if (isClaudeContentChunk(block) &&
+                        (block.type === "tool_use" || block.type === "mcp_tool_use" || block.type === "server_tool_use") &&
+                        typeof block.name === "string") {
+                        toolName = block.name;
+                        break;
+                    }
+                }
+            }
+        }
+        else if (message.type === "stream_event") {
+            const event = message.event;
+            if (event.type === "content_block_start") {
+                const cb = isClaudeContentChunk(event.content_block) ? event.content_block : null;
+                if (cb?.type === "tool_use" && typeof cb.name === "string") {
+                    toolName = cb.name;
+                }
+            }
+        }
+        else if (message.type === "tool_progress") {
+            toolName = message.tool_name;
+        }
+        if (!toolName) {
+            return [];
+        }
+        const prev = this.activeSidechains.get(parentToolUseId);
+        if (prev === toolName) {
+            return [];
+        }
+        this.activeSidechains.set(parentToolUseId, toolName);
+        return [
+            {
+                type: "timeline",
+                item: mapClaudeRunningToolCall({
+                    name: "Task",
+                    callId: parentToolUseId,
+                    input: null,
+                    output: null,
+                    metadata: { subAgentActivity: toolName },
+                }),
+                provider: "claude",
+            },
+        ];
+    }
+    translateMessageToEvents(message, turnContext) {
+        const parentToolUseId = "parent_tool_use_id" in message
+            ? message.parent_tool_use_id
+            : null;
+        if (parentToolUseId) {
+            return this.handleSidechainMessage(message, parentToolUseId);
+        }
+        const events = [];
+        switch (message.type) {
+            case "system":
+                if (message.subtype === "init") {
+                    this.handleSystemMessage(message);
+                }
+                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 meta = message.compact_metadata;
+                    events.push({
+                        type: "timeline",
+                        item: {
+                            type: "compaction",
+                            status: "completed",
+                            trigger: meta?.trigger === "manual" ? "manual" : "auto",
+                            preTokens: meta?.pre_tokens,
+                        },
+                        provider: "claude",
+                    });
+                }
+                break;
+            case "user": {
+                if (this.compacting) {
+                    this.compacting = false;
+                    break;
+                }
+                const content = message.message?.content;
+                if (typeof content === "string" && content.length > 0) {
+                    // String content from user messages (e.g., local command output)
+                    events.push({
+                        type: "timeline",
+                        item: { type: "user_message", text: content },
+                        provider: "claude",
+                    });
+                }
+                else if (Array.isArray(content)) {
+                    const timelineItems = this.mapBlocksToTimeline(content, { turnContext });
+                    for (const item of timelineItems) {
+                        events.push({ type: "timeline", item, provider: "claude" });
+                    }
+                }
+                break;
+            }
+            case "assistant": {
+                const timelineItems = this.mapBlocksToTimeline(message.message.content, {
+                    turnContext,
+                    suppressAssistantText: turnContext.streamedAssistantTextThisTurn,
+                    suppressReasoning: turnContext.streamedReasoningThisTurn,
+                });
+                for (const item of timelineItems) {
+                    events.push({ type: "timeline", item, provider: "claude" });
+                }
+                break;
+            }
+            case "stream_event": {
+                const timelineItems = this.mapPartialEvent(message.event, turnContext);
+                for (const item of timelineItems) {
+                    events.push({ type: "timeline", item, provider: "claude" });
+                }
+                break;
+            }
+            case "result": {
+                const usage = this.convertUsage(message);
+                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({ type: "turn_failed", provider: "claude", error: errorMessage });
+                }
+                break;
+            }
+            default:
+                break;
+        }
+        return events;
+    }
+    handleSystemMessage(message) {
+        if (message.subtype !== "init") {
+            return;
+        }
+        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;
+        }
+        const existingSessionId = this.claudeSessionId;
+        if (existingSessionId === null) {
+            // First time setting session ID (empty → filled) - this is expected
+            this.claudeSessionId = newSessionId;
+            this.logger.debug({ sessionId: newSessionId }, "Claude session ID set for the first time");
+        }
+        else if (existingSessionId === newSessionId) {
+            // Same session ID - no-op, but log for visibility
+            this.logger.debug({ sessionId: newSessionId }, "Claude session ID unchanged (same value)");
+        }
+        else {
+            // CRITICAL: Session ID is being overwritten with a different value
+            // This should NEVER happen and indicates a serious bug
+            throw new Error(`CRITICAL: Claude session ID overwrite detected! ` +
+                `Existing: ${existingSessionId}, New: ${newSessionId}. ` +
+                `This indicates a session identity corruption bug.`);
+        }
+        this.availableModes = DEFAULT_MODES;
+        this.currentMode = message.permissionMode;
+        this.persistence = null;
+        // Capture actual model from SDK init message (not just the configured model)
+        if (message.model) {
+            this.logger.debug({ model: message.model }, "Captured model from SDK init");
+            this.lastOptionsModel = message.model;
+            // Invalidate cached runtime info so it picks up the new model
+            this.cachedRuntimeInfo = null;
+        }
+    }
+    convertUsage(message) {
+        if (!message.usage) {
+            return undefined;
+        }
+        return {
+            inputTokens: message.usage.input_tokens,
+            cachedInputTokens: message.usage.cache_read_input_tokens,
+            outputTokens: message.usage.output_tokens,
+            totalCostUsd: message.total_cost_usd,
+        };
+    }
+    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();
+    }
+    pushToolCall(item, target) {
+        if (target) {
+            target.push(item);
+            return;
+        }
+        this.enqueueTimeline(item);
+    }
+    pushEvent(event) {
+        if (this.eventQueue) {
+            this.eventQueue.push(event);
+        }
+    }
+    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;
+            }
+            const content = fs.readFileSync(historyPath, "utf8");
+            const timeline = [];
+            for (const line of content.split(/\n+/)) {
+                const trimmed = line.trim();
+                if (!trimmed)
+                    continue;
+                try {
+                    const entry = JSON.parse(trimmed);
+                    if (entry.isSidechain) {
+                        continue;
+                    }
+                    const items = this.convertHistoryEntry(entry);
+                    if (items.length > 0) {
+                        timeline.push(...items);
+                    }
+                }
+                catch (error) {
+                    // ignore malformed history line
+                }
+            }
+            if (timeline.length > 0) {
+                this.persistedHistory = timeline;
+                this.historyPending = true;
+            }
+        }
+        catch (error) {
+            // ignore history load failures
+        }
+    }
+    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, { context: "history" }));
+    }
+    mapBlocksToTimeline(content, options) {
+        const context = options?.context ?? "live";
+        const turnContext = options?.turnContext;
+        const suppressAssistant = options?.suppressAssistantText ?? false;
+        const suppressReasoning = options?.suppressReasoning ?? false;
+        if (typeof content === "string") {
+            if (!content || content === "[Request interrupted by user for tool use]") {
+                return [];
+            }
+            if (context === "live" && turnContext) {
+                turnContext.streamedAssistantTextThisTurn = true;
+            }
+            if (suppressAssistant) {
+                return [];
+            }
+            return [{ type: "assistant_message", text: content }];
+        }
+        const items = [];
+        for (const block of content) {
+            switch (block.type) {
+                case "text":
+                case "text_delta":
+                    if (block.text && block.text !== "[Request interrupted by user for tool use]") {
+                        if (context === "live" && turnContext) {
+                            turnContext.streamedAssistantTextThisTurn = true;
+                        }
+                        if (!suppressAssistant) {
+                            items.push({ type: "assistant_message", text: block.text });
+                        }
+                    }
+                    break;
+                case "thinking":
+                case "thinking_delta":
+                    if (block.thinking) {
+                        if (context === "live" && turnContext) {
+                            turnContext.streamedReasoningThisTurn = true;
+                        }
+                        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;
+            }
+        }
+        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);
+        }
+    }
+    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 = typeof block.content === "string" ? 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, turnContext) {
+        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], { turnContext })
+                    : [];
+            case "content_block_delta":
+                return isClaudeContentChunk(event.delta) ? this.mapBlocksToTimeline([event.delta], { turnContext }) : [];
+            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);
+        let parsed;
+        try {
+            parsed = JSON.parse(buffer);
+        }
+        catch {
+            return;
+        }
+        const entry = this.toolUseCache.get(toolId);
+        const normalized = this.normalizeToolInput(parsed);
+        if (!entry || !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;
+    }
+    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 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") {
+        return [{
+                type: "compaction",
+                status: "completed",
+                trigger: entry.compactMetadata?.trigger === "manual" ? "manual" : "auto",
+                preTokens: entry.compactMetadata?.preTokens,
+            }];
+    }
+    if (entry.isCompactSummary) {
+        return [];
+    }
+    const message = entry?.message;
+    if (!message || !("content" in message)) {
+        return [];
+    }
+    const content = message.content;
+    const normalizedBlocks = normalizeHistoryBlocks(content);
+    const contentValue = typeof content === "string"
+        ? content
+        : normalizedBlocks;
+    const hasToolBlock = normalizedBlocks?.some((block) => hasToolLikeBlock(block)) ?? false;
+    const timeline = [];
+    if (entry.type === "user") {
+        const text = extractUserMessageText(content);
+        if (text) {
+            timeline.push({
+                type: "user_message",
+                text,
+            });
+        }
+    }
+    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;
+}
+class Pushable {
+    constructor() {
+        this.queue = [];
+        this.resolvers = [];
+        this.closed = false;
+    }
+    push(item) {
+        if (this.closed) {
+            return;
+        }
+        if (this.resolvers.length > 0) {
+            const resolve = this.resolvers.shift();
+            resolve({ value: item, done: false });
+        }
+        else {
+            this.queue.push(item);
+        }
+    }
+    end() {
+        this.closed = true;
+        while (this.resolvers.length > 0) {
+            const resolve = this.resolvers.shift();
+            resolve({ value: undefined, done: true });
+        }
+    }
+    [Symbol.asyncIterator]() {
+        return {
+            next: () => {
+                if (this.queue.length > 0) {
+                    const value = this.queue.shift();
+                    if (value !== undefined) {
+                        return Promise.resolve({ value, done: false });
+                    }
+                }
+                if (this.closed) {
+                    return Promise.resolve({ value: undefined, done: true });
+                }
+                return new Promise((resolve) => {
+                    this.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 (!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") {
+        return message.content.trim();
+    }
+    if (typeof message.text === "string") {
+        return message.text.trim();
+    }
+    if (Array.isArray(message.content)) {
+        for (const block of message.content) {
+            if (block && typeof block.text === "string") {
+                return block.text.trim();
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=claude-agent.js.map