@orion-agents/orion-code 0.1.9 → 0.2.2

package/dist/runtime/chat-controller.js

@@ -1,1620 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.InkChatController = exports.AgentChatController = exports.sessionMessagesToTranscriptEntries = exports.createToolEventPresenter = exports.createAssistantStreamPresenter = void 0;
-exports.loadSessionIntoRuntime = loadSessionIntoRuntime;
-exports.closeSession = closeSession;
-const commands_1 = require("../commands");
-const crypto_1 = require("crypto");
-const parser_1 = require("../commands/parser");
-const session_storage_1 = require("../services/session-storage");
-const config_1 = require("../services/config");
-const provider_resilience_1 = require("../services/provider-resilience");
-const tool_allowlist_1 = require("../services/tool-allowlist");
-const framework_1 = require("../framework");
-const prompt_1 = require("./goals/prompt");
-const harness_1 = require("../harness");
-const tools_1 = require("../tools");
-const tool_scheduler_1 = require("../framework/tool-scheduler");
-const tool_serializer_1 = require("../framework/tool-serializer");
-const tool_artifacts_1 = require("../core/tool-artifacts");
-const skills_1 = require("../skills");
-const subagents_1 = require("./subagents");
-const file_context_1 = require("../services/file-context");
-const prompt_context_1 = require("../memory/prompt-context");
-const prompt_context_2 = require("../services/prompt-context");
-const workspace_state_1 = require("../services/workspace-state");
-const verification_profile_1 = require("../services/verification-profile");
-const ui_events_1 = require("./ui-events");
-const ui_view_model_1 = require("./ui-view-model");
-const agent_status_1 = require("./agent-status");
-const loop_budget_1 = require("./loop-budget");
-const observability_1 = require("../utils/observability");
-const chat_trace_1 = require("./chat-trace");
-const chat_checkpoint_1 = require("./chat-checkpoint");
-const chat_workspace_1 = require("./chat-workspace");
-const chat_presentation_1 = require("./chat-presentation");
-const chat_effort_1 = require("./chat-effort");
-const chat_compact_1 = require("./chat-compact");
-const agent_mode_1 = require("../framework/agent-mode");
-const chat_command_scope_1 = require("./chat-command-scope");
-var chat_presentation_2 = require("./chat-presentation");
-Object.defineProperty(exports, "createAssistantStreamPresenter", { enumerable: true, get: function () { return chat_presentation_2.createAssistantStreamPresenter; } });
-Object.defineProperty(exports, "createToolEventPresenter", { enumerable: true, get: function () { return chat_presentation_2.createToolEventPresenter; } });
-Object.defineProperty(exports, "sessionMessagesToTranscriptEntries", { enumerable: true, get: function () { return chat_presentation_2.sessionMessagesToTranscriptEntries; } });
-class AgentChatController {
-    setGoalCoordinator(coord) {
-        this.goalCoordinator = coord;
-    }
-    resolveToolAllowlist() {
-        // Resolve on every evaluation, including execution. A model response can
-        // contain several serial calls prepared before the first permission prompt;
-        // once the user chooses project/global scope, the next call in that same
-        // response must observe the persisted grant instead of prompting again.
-        return (toolName, args) => (0, tool_allowlist_1.resolveProjectToolAllowlist)(this.runtime.cwd).evaluator?.(toolName, args);
-    }
-    constructor(runtime, events, controllerOptions = {}) {
-        this.runtime = runtime;
-        this.events = events;
-        this.controllerOptions = controllerOptions;
-        /** v0.2.26: optional goal coordinator for prompt injection and turn finalization. */
-        this.goalCoordinator = null;
-    }
-    setLoopStats(stats) {
-        this.runtime.store.setLastLoopStats(stats);
-        this.events.loopStatsUpdated?.(stats);
-    }
-    async runInput(input, options = {}) {
-        const text = input.trim();
-        if (!text)
-            return;
-        // Every root input owns a fresh accounting snapshot. Commands and local
-        // fast paths are known zero-provider turns; runChat changes tokenUsage to
-        // null before networking so missing provider usage remains fail-closed.
-        const storeWithState = this.runtime.store;
-        storeWithState.setState?.({
-            tokenUsage: { promptTokens: 0, completionTokens: 0 },
-            lastLoopStats: undefined,
-        });
-        const parsed = (0, parser_1.parseInput)(text);
-        if (!parsed.isCommand) {
-            const localFastPath = (0, chat_presentation_1.parseLocalFastPath)(text);
-            if (localFastPath) {
-                await this.runLocalFastPath(text, localFastPath, options);
-                return;
-            }
-            await this.runChat(text, options);
-            return;
-        }
-        const command = (0, commands_1.findCommand)(parsed.name);
-        if (!command) {
-            if ((0, skills_1.hasMatchingSkill)(text, this.runtime.cwd)) {
-                await this.runChat(text, options);
-                return;
-            }
-            const suggestions = (0, parser_1.buildCommandSuggestions)(parsed.name);
-            this.events.append({
-                role: 'error',
-                title: 'unknown command',
-                content: suggestions.length > 0
-                    ? `Unknown command: /${parsed.name}\nDid you mean: ${suggestions.map(item => `/${item}`).join(', ')}?`
-                    : `Unknown command: /${parsed.name}`,
-                errorLayer: 'runtime',
-            });
-            return;
-        }
-        const activeRenderer = this.controllerOptions.uiRenderer ?? this.runtime.config.ui?.renderer ?? 'terminal';
-        if ((0, chat_command_scope_1.rejectUnsupportedRenderer)(this.events, command, activeRenderer))
-            return;
-        if (parsed.name === 'clear') {
-            if (this.events.clearView) {
-                this.events.clearView();
-            }
-            else {
-                this.events.clearTranscript();
-            }
-            this.events.setStatus('View cleared. Conversation context is preserved.');
-            return;
-        }
-        if (parsed.name === 'exit' || parsed.name === 'quit' || parsed.name === 'q') {
-            this.events.shutdownRequested?.('user request');
-            await this.runtime.shutdown();
-            return;
-        }
-        const compatibilityAlias = command.compatibilityAliases?.find(alias => alias.name.toLowerCase() === parsed.name.toLowerCase());
-        const deprecation = compatibilityAlias?.lifecycle ??
-            (command.lifecycle.status === 'deprecated' ? command.lifecycle : undefined);
-        if (deprecation) {
-            this.events.append({
-                role: 'system',
-                title: `/${parsed.name} deprecated`,
-                content: `/${parsed.name} is deprecated${deprecation.replacement ? `; use ${deprecation.replacement}` : ''}. It will be removed in ${deprecation.removeIn ?? 'a future release'}.`,
-                statusTone: 'warning',
-                command: {
-                    id: command.id,
-                    name: command.name,
-                    source: command.source,
-                    success: true,
-                },
-            });
-        }
-        const ctx = this.createCommandContext(options.abortSignal, options.turnId);
-        let commandProviderAttempts = 0;
-        const commandProviderPreflight = async (context) => {
-            commandProviderAttempts += 1;
-            return this.controllerOptions.beforeProviderRequest
-                ? this.controllerOptions.beforeProviderRequest(context)
-                : { available: true };
-        };
-        const restoreProviderPreflight = typeof this.runtime.llm?.setProviderRequestPreflight === 'function'
-            ? this.runtime.llm.setProviderRequestPreflight(commandProviderPreflight)
-            : undefined;
-        const commandUsage = { promptTokens: 0, completionTokens: 0 };
-        let commandUsageEvents = 0;
-        const unsubscribeCommandUsage = typeof this.runtime.llm?.subscribeUsage === 'function'
-            ? this.runtime.llm.subscribeUsage(event => {
-                commandUsageEvents += 1;
-                commandUsage.promptTokens += event.usage.promptTokens;
-                commandUsage.completionTokens += event.usage.completionTokens;
-            })
-            : undefined;
-        let result;
-        let output;
-        try {
-            if (command.audience === 'primary') {
-                result = await command.execute(ctx, parsed.args);
-                output = '';
-            }
-            else {
-                ({ result, output } = await (0, chat_presentation_1.captureConsoleOutput)(() => command.execute(ctx, parsed.args)));
-            }
-        }
-        finally {
-            unsubscribeCommandUsage?.();
-            restoreProviderPreflight?.();
-            if (commandUsage.promptTokens > 0 || commandUsage.completionTokens > 0) {
-                this.runtime.store.setTokenUsage(commandUsage);
-            }
-            const providerRequests = Math.max(commandProviderAttempts, commandUsageEvents);
-            if (providerRequests > 0) {
-                const diagnostics = (0, chat_trace_1.getLastRequestDiagnostics)(this.runtime.llm);
-                const retryCount = diagnostics?.retryCount ?? 0;
-                const fallbackCount = diagnostics?.fallbackTriggered ? 1 : 0;
-                this.setLoopStats({
-                    turnsStarted: 1,
-                    llmRequests: providerRequests,
-                    toolCalls: 0,
-                    readOnlyToolCalls: 0,
-                    unsafeToolCalls: 0,
-                    toolResultBytes: 0,
-                    modelVisibleToolBytes: 0,
-                    summarizedBytes: 0,
-                    finishReason: commandUsageEvents > 0 ? 'completed' : 'failed',
-                    providerRetryCount: retryCount,
-                    providerRetryDelayMs: diagnostics?.retryDelayMs,
-                    providerRetryErrorTypes: diagnostics?.retryErrorTypes,
-                    providerLastRetryErrorType: diagnostics?.lastRetryErrorType,
-                    providerLastRetryStatus: diagnostics?.lastRetryStatus,
-                    providerFallbackCount: fallbackCount,
-                    providerFallbackFromModel: diagnostics?.fallbackFromModel,
-                    providerFallbackToModel: diagnostics?.fallbackToModel,
-                    providerFinalModel: diagnostics?.finalModel,
-                    providerUsingFallback: diagnostics?.usingFallback,
-                    singleReadOnlyStreak: 0,
-                    batchReadSuggestionCount: 0,
-                    localFastPathUsed: false,
-                });
-            }
-        }
-        const commandMeta = {
-            id: command.id,
-            name: command.name,
-            source: command.source,
-            success: result.success,
-        };
-        if (output) {
-            this.events.append({
-                role: result.success ? 'system' : 'error',
-                title: `/${command.name}`,
-                content: output,
-                command: commandMeta,
-            });
-        }
-        if (result.output) {
-            this.events.append({
-                role: result.success ? 'system' : 'error',
-                title: `/${command.name}`,
-                content: result.output,
-                command: commandMeta,
-            });
-        }
-        if (result.error) {
-            this.events.append({
-                role: 'error',
-                title: `/${command.name}`,
-                content: result.error,
-                errorLayer: 'runtime',
-                command: commandMeta,
-            });
-        }
-        if (result.sessionPicker) {
-            this.events.showSessionPicker(result.sessionPicker);
-            return;
-        }
-        if (result.modelPicker) {
-            this.events.showModelPicker?.(result.modelPicker);
-            return;
-        }
-        if (result.editPreview) {
-            this.events.showEditPreview(result.editPreview);
-            return;
-        }
-        if (result.effortEvent) {
-            this.events.effortEvent?.(result.effortEvent);
-        }
-        if (result.continueAsChat) {
-            await this.runChat(result.chatInput ?? parsed.args, options);
-        }
-    }
-    async runRequest(request, options = {}) {
-        const internalInput = request.text?.trim() ||
-            'Continue pursuing the active goal from its persisted plan and evidence.';
-        const run = () => this.runInput(internalInput, {
-            ...options,
-            persistAsUserMessage: request.persistAsUserMessage,
-            inputKind: request.inputKind,
-        });
-        if (!request.goal) {
-            await run();
-            return;
-        }
-        await chat_trace_1.goalTraceContext.run({
-            goalId: request.goal.goalId,
-            goalRevision: request.goal.revision,
-            goalInputKind: request.inputKind,
-            getStopReason: () => this.goalCoordinator?.goal?.stopReason?.message,
-        }, run);
-    }
-    async runLocalFastPath(input, action, options = {}) {
-        const activeSession = this.runtime.getSession() ??
-            this.runtime.ensureSession() ??
-            (0, session_storage_1.loadSessionMeta)(this.runtime.getSession()?.id ?? '');
-        const sessionId = activeSession?.id;
-        const turnId = (0, chat_trace_1.traceTurnId)(options.turnId);
-        (0, observability_1.setDiagnosticTraceContext)({
-            traceId: `${sessionId ?? 'local'}:${turnId}`,
-            ...(sessionId ? { sessionId } : {}),
-            turnId,
-        });
-        const localCallId = `local-${turnId}`;
-        const start = Date.now();
-        const preWorkspace = (0, workspace_state_1.captureWorkspaceSnapshot)(this.runtime.cwd);
-        const traceArgs = (0, chat_trace_1.buildTraceArgsDetails)(this.runtime.cwd, action.tool, action.args);
-        if (sessionId) {
-            (0, session_storage_1.appendSessionMessage)(sessionId, {
-                role: 'user',
-                content: input,
-                timestamp: Date.now(),
-            });
-            (0, chat_trace_1.recordTraceEvent)(this.events, sessionId, {
-                turnId,
-                type: 'turn_start',
-                inputBytes: (0, chat_trace_1.byteLength)(input),
-                localFastPathUsed: true,
-            });
-            (0, chat_workspace_1.appendWorkspaceSnapshotTrace)(this.events, sessionId, turnId, 'pre_turn', preWorkspace);
-            (0, chat_trace_1.recordTraceEvent)(this.events, sessionId, {
-                turnId,
-                type: 'local_fast_path',
-                name: action.tool,
-                ...traceArgs,
-                note: (0, chat_trace_1.compactMiddle)(action.label, 160),
-            });
-        }
-        if (options.persistAsUserMessage !== false) {
-            this.runtime.store.addMessage({ role: 'user', content: input });
-        }
-        this.events.setStatus(`Running local ${action.label}...`);
-        try {
-            const tool = (0, tools_1.getRuntimeTools)().find(candidate => candidate.name === action.tool);
-            if (!tool) {
-                throw new chat_presentation_1.LocalFastPathBlockedError(`Local fast path tool ${action.tool} is unavailable.`);
-            }
-            const effectivePermissionMode = this.runtime.store.getEffectivePermissionMode();
-            const toolAllowlist = this.resolveToolAllowlist();
-            const toolContext = {
-                cwd: this.runtime.cwd,
-                config: {
-                    name: this.runtime.config.name,
-                    mode: this.runtime.config.mode,
-                },
-                sessionId,
-                turnId,
-                permissionMode: effectivePermissionMode,
-                toolAllowlist,
-                toolConfirmation: this.runtime.config.toolConfirmation,
-                confirmToolUse: effectivePermissionMode === 'auto' ? undefined : this.controllerOptions.confirmToolUse,
-            };
-            let permission;
-            try {
-                permission = tool.checkPermissions?.(action.args, toolContext);
-            }
-            catch (error) {
-                const detail = error instanceof Error ? error.message : String(error);
-                throw new chat_presentation_1.LocalFastPathBlockedError(`Permission check failed closed: ${detail}`);
-            }
-            const effective = (0, tool_scheduler_1.resolveEffectivePermission)({
-                toolName: action.tool,
-                tool,
-                args: action.args,
-                permission,
-                permissionMode: effectivePermissionMode,
-                allowlist: toolAllowlist?.(action.tool, action.args),
-                toolConfirmation: this.runtime.config.toolConfirmation,
-            });
-            if (effective.outcome === 'deny') {
-                throw new chat_presentation_1.LocalFastPathBlockedError(effective.reason ||
-                    `Local fast path blocked by ${effective.source ?? 'permission policy'}.`);
-            }
-            if (effective.outcome === 'confirm') {
-                if (this.runtime.config.toolConfirmation === 'deny' ||
-                    !this.controllerOptions.confirmToolUse) {
-                    throw new chat_presentation_1.LocalFastPathBlockedError(effective.reason || 'Local fast path requires user confirmation.');
-                }
-                const approved = await this.controllerOptions.confirmToolUse({
-                    name: action.tool,
-                    args: action.args,
-                    reason: effective.reason,
-                    abortSignal: options.abortSignal,
-                });
-                if (!approved) {
-                    throw new chat_presentation_1.LocalFastPathBlockedError(`Local fast path ${action.tool} requires confirmation and was denied by user.`);
-                }
-            }
-            if (options.abortSignal?.aborted) {
-                throw new chat_presentation_1.LocalFastPathBlockedError('Local fast path was cancelled before tool execution.');
-            }
-            if (sessionId) {
-                (0, chat_trace_1.recordTraceEvent)(this.events, sessionId, {
-                    turnId,
-                    type: 'tool_call',
-                    name: action.tool,
-                    callId: localCallId,
-                    ...traceArgs,
-                });
-            }
-            const result = await (0, tools_1.executeTool)(action.tool, action.args, options.abortSignal, {
-                ...toolContext,
-                sessionId,
-                turnId,
-            });
-            const duration = Date.now() - start;
-            const envelope = (0, tool_serializer_1.parseToolResultEnvelope)(result);
-            const outputBytes = typeof envelope.outputBytes === 'number'
-                ? envelope.outputBytes
-                : Buffer.byteLength(result, 'utf8');
-            const formattedLocalResult = (0, chat_presentation_1.formatLocalFastPathAssistantContent)(action, result, this.runtime.cwd);
-            const assistantContent = formattedLocalResult.content;
-            const stats = (0, framework_1.createLocalFastPathLoopStats)({
-                finishReason: envelope.success ? 'completed' : 'failed',
-                toolCalls: 1,
-                readOnlyToolCalls: action.tool === 'exec_command' ? 0 : 1,
-                unsafeToolCalls: action.tool === 'exec_command' ? 1 : 0,
-                toolResultBytes: outputBytes,
-                modelVisibleToolBytes: 0,
-                summarizedBytes: outputBytes,
-            });
-            const localToolResultEvent = {
-                type: 'tool_result',
-                name: action.tool,
-                args: action.args,
-                callId: localCallId,
-                result,
-                modelVisibleResult: result,
-                duration,
-                success: envelope.success,
-                error: envelope.error,
-                summary: envelope.summary,
-                outputBytes,
-                artifactRef: formattedLocalResult.artifactRef,
-            };
-            this.events.append({
-                role: envelope.success ? 'tool' : 'error',
-                title: 'local',
-                content: (0, chat_presentation_1.toolFinishContent)(localToolResultEvent),
-                toolActivity: (0, chat_presentation_1.structuredToolFinishActivity)(localToolResultEvent, 1, {
-                    projectPath: this.runtime.cwd,
-                    turnId,
-                }),
-            });
-            this.runtime.store.addMessage({ role: 'assistant', content: assistantContent });
-            this.setLoopStats(stats);
-            if (sessionId) {
-                (0, chat_trace_1.recordTraceEvent)(this.events, sessionId, {
-                    turnId,
-                    type: 'tool_result',
-                    name: action.tool,
-                    callId: localCallId,
-                    argsSummary: traceArgs.argsSummary,
-                    argsArtifactId: traceArgs.argsArtifactId,
-                    argsBytes: traceArgs.argsBytes,
-                    success: envelope.success,
-                    duration,
-                    outputBytes,
-                    modelVisibleBytes: 0,
-                    artifactId: formattedLocalResult.artifactRef?.id,
-                    error: envelope.error ? (0, chat_trace_1.compactMiddle)(envelope.error, 240) : undefined,
-                });
-                (0, chat_workspace_1.appendPostWorkspaceTrace)(this.events, sessionId, turnId, this.runtime.cwd, preWorkspace);
-                (0, chat_trace_1.recordTraceEvent)(this.events, sessionId, {
-                    turnId,
-                    type: 'complete',
-                    finishReason: stats.finishReason,
-                    stopDecision: stats.stopDecision,
-                    llmRequests: stats.llmRequests,
-                    toolCalls: stats.toolCalls,
-                    readOnlyToolCalls: stats.readOnlyToolCalls,
-                    unsafeToolCalls: stats.unsafeToolCalls,
-                    localFastPathUsed: true,
-                });
-                (0, session_storage_1.appendSessionMessage)(sessionId, {
-                    role: 'assistant',
-                    content: assistantContent,
-                    timestamp: Date.now(),
-                });
-            }
-            this.events.setStatus(envelope.success ? `Completed local ${action.label}` : `Failed local ${action.label}`);
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            this.events.append({ role: 'error', title: 'local', content: message, errorLayer: 'tool' });
-            this.events.setStatus('Local command failed. Ready for the next input.');
-            const assistantContent = `Local fast path failed for ${action.label}.\n\n${message}`;
-            this.runtime.store.addMessage({ role: 'assistant', content: assistantContent });
-            const finishReason = error instanceof chat_presentation_1.LocalFastPathBlockedError ? 'blocked' : 'failed';
-            const stats = (0, framework_1.createLocalFastPathLoopStats)({
-                finishReason,
-                toolCalls: 0,
-            });
-            this.setLoopStats(stats);
-            if (sessionId) {
-                (0, chat_trace_1.recordTraceEvent)(this.events, sessionId, {
-                    turnId,
-                    type: 'error',
-                    name: action.tool,
-                    error: (0, chat_trace_1.compactTraceError)(error),
-                });
-                (0, chat_workspace_1.appendPostWorkspaceTrace)(this.events, sessionId, turnId, this.runtime.cwd, preWorkspace);
-                (0, chat_trace_1.recordTraceEvent)(this.events, sessionId, {
-                    turnId,
-                    type: 'complete',
-                    finishReason: stats.finishReason,
-                    stopDecision: stats.stopDecision,
-                    llmRequests: stats.llmRequests,
-                    toolCalls: stats.toolCalls,
-                    localFastPathUsed: true,
-                    note: 'local_fast_path_failed',
-                });
-                (0, session_storage_1.appendSessionMessage)(sessionId, {
-                    role: 'assistant',
-                    content: assistantContent,
-                    timestamp: Date.now(),
-                });
-            }
-        }
-    }
-    createCommandContext(abortSignal, turnId) {
-        return {
-            cwd: this.runtime.cwd,
-            config: this.runtime.config,
-            store: this.runtime.store,
-            llm: this.runtime.llm,
-            compactCoordinator: this.runtime.compactCoordinator,
-            modelCoordinator: this.runtime.modelCoordinator,
-            runtime: this.runtime.runtime,
-            sessionId: this.runtime.getSession()?.id,
-            turnId,
-            ensureSession: this.runtime.ensureSession,
-            setSession: session => {
-                this.runtime.setSession(session);
-                (0, chat_effort_1.applySessionEffort)(this.runtime, this.events, session);
-                const renderer = this.controllerOptions.uiRenderer ?? this.runtime.config.ui?.renderer ?? 'terminal';
-                this.events.replaceTranscript((0, chat_presentation_1.sessionMessagesToTranscriptEntries)(session.id, {
-                    includeToolOutputViews: renderer === 'tui',
-                }));
-            },
-            sessionRestored: event => {
-                this.events.sessionRestored?.(event);
-            },
-            getSession: this.runtime.getSession,
-            getActiveGoal: () => this.goalCoordinator?.goal ?? null,
-            abortSignal,
-            writeOutput: text => {
-                if (text.trim()) {
-                    this.events.append({ role: 'system', content: text });
-                }
-            },
-            writeLine: text => {
-                if (text?.trim()) {
-                    this.events.append({ role: 'system', content: text });
-                }
-            },
-            clearView: () => {
-                if (this.events.clearView) {
-                    this.events.clearView();
-                }
-                else {
-                    this.events.clearTranscript();
-                }
-            },
-            requestShutdown: reason => {
-                this.events.shutdownRequested?.(reason);
-            },
-            uiRenderer: this.controllerOptions.uiRenderer ?? this.runtime.config.ui?.renderer ?? 'terminal',
-            uiCapabilities: (0, ui_events_1.resolveUiRendererCapabilities)(this.controllerOptions.uiCapabilities, this.controllerOptions.uiRenderer ?? this.runtime.config.ui?.renderer),
-            agentModeLifecycle: this.controllerOptions.agentModeLifecycle,
-        };
-    }
-    /**
-     * Forward a subagent lifecycle event to the runtime event sink and session
-     * trace. Renderers consume the same event across terminal/Ink/TUI; this is
-     * the only place a subtask event touches the root loop.
-     */
-    handleSubtaskEvent(event, sessionId, turnId) {
-        // Emit the renderer-independent runtime event first so all renderers
-        // (terminal/Ink/TUI) consume the same lifecycle through one protocol.
-        this.events.subtaskEvent?.(event);
-        const stateToTraceType = {
-            queued: 'subtask_requested',
-            running: 'subtask_started',
-            completed: 'subtask_completed',
-            failed: 'subtask_failed',
-            cancelled: 'subtask_cancelled',
-            rejected: 'subtask_rejected',
-            timed_out: 'subtask_timed_out',
-        };
-        if (sessionId) {
-            const traceType = stateToTraceType[event.state];
-            if (traceType) {
-                (0, chat_trace_1.recordTraceEvent)(this.events, sessionId, {
-                    turnId: String(turnId),
-                    type: traceType,
-                    name: `${event.role}:${event.taskId}`,
-                    argsSummary: event.objective.slice(0, 160),
-                });
-            }
-        }
-        // Surface start/complete/fail/cancel summaries in the transcript so all
-        // renderers show subtask progress without renderer-local logic.
-        if (event.state === 'running') {
-            this.events.append({
-                role: 'system',
-                content: `▸ subtask ${event.role} started: ${event.objective.slice(0, 120)}`,
-            });
-        }
-        else if (event.state === 'completed' ||
-            event.state === 'failed' ||
-            event.state === 'cancelled' ||
-            event.state === 'timed_out' ||
-            event.state === 'rejected') {
-            const summary = event.summary ? ` — ${event.summary.slice(0, 200)}` : '';
-            this.events.append({
-                role: 'system',
-                content: `◂ subtask ${event.role} ${event.state}${summary}`,
-            });
-        }
-    }
-    /**
-     * Fold reconciled child aggregate usage into the root turn's loop stats so
-     * `/cost` and loop-budget accounting reflect subagent cost. Child model
-     * requests and tool calls are added to the root counters; a note records the
-     * subagent contribution so it is distinguishable from root work.
-     */
-    foldSubagentUsage(stats, bundle) {
-        if (!bundle)
-            return stats;
-        const usage = bundle.getAggregateUsage();
-        if (usage.modelRequests === 0 && usage.toolCalls === 0 && usage.usageComplete === true)
-            return stats;
-        const subtaskCount = bundle.getSubtaskCount();
-        const subagentSuffix = `subagents: ${usage.modelRequests} req/${usage.toolCalls} calls across ${subtaskCount} task(s)`;
-        return {
-            ...stats,
-            llmRequests: (stats.llmRequests ?? 0) + usage.modelRequests,
-            toolCalls: (stats.toolCalls ?? 0) + usage.toolCalls,
-            readOnlyToolCalls: (stats.readOnlyToolCalls ?? 0) + usage.toolCalls,
-            subagentPromptTokens: usage.promptTokens,
-            subagentCompletionTokens: usage.completionTokens,
-            subagentTotalTokens: usage.promptTokens + usage.completionTokens,
-            usageAccountingComplete: stats.usageAccountingComplete !== false &&
-                usage.usageComplete === true,
-            continuationHint: stats.continuationHint
-                ? `${stats.continuationHint} (${subagentSuffix})`
-                : subagentSuffix,
-        };
-    }
-    async runChat(input, options = {}) {
-        if (!input) {
-            this.events.append({
-                role: 'error',
-                content: 'Usage: /chat <message>',
-                errorLayer: 'runtime',
-            });
-            return;
-        }
-        if (!this.runtime.llm || !(0, config_1.isConfigured)(this.runtime.config)) {
-            this.events.append({
-                role: 'error',
-                content: 'LLM is not configured. Set ORION_CODE_API_KEY in ~/.orion-code/orion.json or environment.',
-                errorLayer: 'provider',
-            });
-            return;
-        }
-        // Usage belongs to a single root turn. Clear the previous snapshot before
-        // any provider request so failures without usage cannot inherit stale data.
-        this.runtime.store.setState({ tokenUsage: null });
-        const abortSignal = options.abortSignal;
-        const turnId = (0, chat_trace_1.traceTurnId)(options.turnId);
-        const activeSession = this.runtime.getSession() ??
-            this.runtime.ensureSession() ??
-            (0, session_storage_1.loadSessionMeta)(this.runtime.getSession()?.id ?? '');
-        const sessionId = activeSession?.id;
-        (0, observability_1.setDiagnosticTraceContext)({
-            traceId: `${sessionId ?? 'unsaved'}:${turnId}`,
-            ...(sessionId ? { sessionId } : {}),
-            turnId,
-        });
-        const preWorkspace = (0, workspace_state_1.captureWorkspaceSnapshot)(this.runtime.cwd);
-        const runtimeTools = (0, tools_1.getRuntimeTools)();
-        const skillResolution = (0, skills_1.resolveSkillsForTurn)({
-            cwd: this.runtime.cwd,
-            input,
-            tools: runtimeTools,
-            projectPath: activeSession?.projectPath,
-            sessionId,
-        });
-        const appliedSkillNames = skillResolution.skills.map(skill => skill.name);
-        if (sessionId && options.persistAsUserMessage !== false) {
-            (0, session_storage_1.appendSessionMessage)(sessionId, {
-                role: 'user',
-                content: input,
-                timestamp: Date.now(),
-                appliedSkills: appliedSkillNames.length > 0 ? appliedSkillNames : undefined,
-            });
-            (0, chat_trace_1.recordTraceEvent)(this.events, sessionId, {
-                turnId,
-                type: 'turn_start',
-                inputBytes: (0, chat_trace_1.byteLength)(input),
-                note: appliedSkillNames.length > 0 ? `skills=${appliedSkillNames.join(',')}` : undefined,
-            });
-            (0, chat_workspace_1.appendWorkspaceSnapshotTrace)(this.events, sessionId, turnId, 'pre_turn', preWorkspace);
-        }
-        if (options.persistAsUserMessage !== false) {
-            this.runtime.store.addMessage({ role: 'user', content: input });
-        }
-        (0, prompt_context_2.refreshProjectInstructions)(this.runtime.store, this.runtime.cwd);
-        const snapshot = this.runtime.store.getSnapshot();
-        const effectivePermissionMode = this.runtime.store.getEffectivePermissionMode();
-        const onPlanModeChange = (0, agent_mode_1.createPlanModeChangeHandler)(this.runtime.store, this.controllerOptions.agentModeLifecycle);
-        const harness = (0, harness_1.createContextHarness)({
-            cwd: this.runtime.cwd,
-            modelId: this.runtime.llm.getModel(),
-            state: snapshot.harnessState,
-            config: {
-                enabled: true,
-                driftGuard: 'warn',
-                completionGate: true,
-            },
-        });
-        const intent = harness.updateContractFromUserInput(options.inputKind === 'goal_continuation'
-            ? (this.goalCoordinator?.goal?.objective ?? input)
-            : input);
-        harness.recordAppliedSkills(skillResolution.skills);
-        // Reconcile diagnostic: when harness state is present but objective may be incomplete
-        if (snapshot.harnessState &&
-            !snapshot.harnessState.rootObjective &&
-            !snapshot.harnessState.contract?.objective) {
-            this.events.setStatus('Resume diagnostic: harness state restored but objective may be incomplete. Run /harness explain to review.');
-        }
-        const subagentConfig = this.runtime.config.subagents;
-        // The subtask capability is a root-level tool. It is exposed on normal
-        // turns, but respects an active skill scope: when a skill restricts the
-        // tool set, subtask is not appended (the skill owns the scope).
-        const projectPath = activeSession?.projectPath;
-        const subagentBundle = subagentConfig &&
-            subagentConfig.mode !== 'off' &&
-            this.runtime.llm &&
-            !skillResolution.toolScopeActive
-            ? (0, subagents_1.createSubagentBundleForTurn)({
-                config: subagentConfig,
-                cwd: this.runtime.cwd,
-                rootLlmConfig: (0, subagents_1.deriveRootLlmConfig)(this.runtime.config),
-                modelLabel: this.runtime.llm.getModel(),
-                rootObjectiveSummary: harness.toJSON()?.rootObjective ?? input,
-                abortSignal,
-                resilience: this.runtime.llm.resilience,
-                onSubtaskEvent: event => {
-                    this.handleSubtaskEvent(event, sessionId, turnId);
-                },
-                onSubtaskResult: (result, _batchId, objective, researchContext) => {
-                    if (!projectPath)
-                        return;
-                    const json = JSON.stringify(result);
-                    const artifact = (0, tool_artifacts_1.storeArtifact)(projectPath, `subtask_${result.role}`, json, Buffer.byteLength(json, 'utf8'));
-                    if (artifact) {
-                        // Record a trace event for artifact discoverability only.
-                        // The subtask state transition (subtask_completed) is already
-                        // emitted by handleSubtaskEvent above.
-                        if (sessionId) {
-                            (0, chat_trace_1.recordTraceEvent)(this.events, sessionId, {
-                                turnId: String(turnId),
-                                type: 'subtask_artifact_stored',
-                                name: `${result.role}:${result.id}`,
-                                argsSummary: result.summary.slice(0, 200),
-                                argsArtifactId: artifact.id,
-                                argsBytes: artifact.outputBytes,
-                            });
-                        }
-                    }
-                    // v0.1.4 Research-to-Evidence integration: normalize every
-                    // terminal research result (including partial/failure states),
-                    // persist it under a packet-specific CAS scope, and forward the
-                    // canonical lifecycle stream to every renderer.
-                    if (result.role !== 'research' || !sessionId)
-                        return;
-                    try {
-                        const goal = this.goalCoordinator?.goal;
-                        const objectiveRevision = goal?.contract?.objectiveRevision;
-                        const hasGoalBinding = typeof goal?.goalId === 'string' && typeof objectiveRevision === 'number';
-                        // Preserve the authoritative request produced from the
-                        // original subtask capability. Reconstruct local-only only for
-                        // legacy callers that predate the additive callback context.
-                        const baseRequest = researchContext?.request ??
-                            (0, subagents_1.createLocalResearchRequest)(objective?.trim() || result.summary || 'repository research', projectPath);
-                        const request = {
-                            ...baseRequest,
-                            scope: { ...baseRequest.scope, projectRoot: projectPath },
-                            ...(hasGoalBinding
-                                ? {
-                                    goalBinding: {
-                                        goalId: goal.goalId,
-                                        objectiveRevision,
-                                    },
-                                }
-                                : {}),
-                        };
-                        const packet = (0, subagents_1.subtaskResultToPacket)(result, request, {
-                            projectPath,
-                            sessionId,
-                            ...(hasGoalBinding ? { goalId: goal.goalId, objectiveRevision } : {}),
-                        }, {
-                            externalSources: researchContext?.web?.sources,
-                            externalNotes: researchContext?.web?.notes,
-                            externalTimedOut: researchContext?.web?.timedOut,
-                            externalAborted: researchContext?.web?.aborted,
-                        });
-                        // Citation resolution can downgrade claims and mark superseded
-                        // same-URL sources stale. Resolve before validation/persistence so
-                        // the CAS token, durable packet and renderer view describe the
-                        // exact same final state (#105).
-                        const resolution = (0, subagents_1.resolveCitations)(packet);
-                        const validation = (0, subagents_1.validatePacket)(packet);
-                        if (!validation.ok)
-                            return;
-                        const saved = (0, subagents_1.saveResearchPacket)((0, subagents_1.createFileArtifactStore)(projectPath), packet, {
-                            projectPath,
-                            sessionId,
-                            packetId: packet.packetId,
-                            ...(packet.goalId ? { goalId: packet.goalId } : {}),
-                        });
-                        const view = (0, subagents_1.buildResearchView)(packet, resolution);
-                        for (const event of (0, subagents_1.toLifecycleEvents)(view, resolution)) {
-                            this.events.researchEvent?.(event);
-                        }
-                        (0, chat_trace_1.recordTraceEvent)(this.events, sessionId, {
-                            turnId: String(turnId),
-                            type: 'subtask_artifact_stored',
-                            name: `research:${packet.packetId}`,
-                            argsSummary: `${view.stage}/${view.auditStatus}: ${packet.summary}`.slice(0, 200),
-                            argsArtifactId: `research-${saved.casToken.slice(0, 16)}`,
-                            argsBytes: Buffer.byteLength(JSON.stringify(packet), 'utf8'),
-                        });
-                    }
-                    catch {
-                        // Research persistence/rendering is observational. A storage
-                        // failure must not alter the child result or root turn state.
-                    }
-                },
-                // R6: wire live permission state so the subagent policy gate can
-                // prevent background delegation while the user is deciding a tool
-                // permission. Injected by AgentRuntimeController via chatOptions.
-                hasPendingPermission: this.controllerOptions.hasPendingPermission,
-                // R6: wire child usage callback so CostTracker records subagent
-                // token consumption. Injected by AgentRuntimeController via chatOptions.
-                onChildUsage: this.controllerOptions.onChildUsage,
-                beforeProviderRequest: this.controllerOptions.beforeProviderRequest,
-            })
-            : null;
-        const subtaskTool = subagentBundle?.tool ?? null;
-        const turnTools = subtaskTool ? [...skillResolution.tools, subtaskTool] : skillResolution.tools;
-        const memoryPrompt = (0, prompt_context_1.buildMemoryPromptContext)(input, this.runtime.cwd);
-        if (sessionId) {
-            const selected = memoryPrompt.manifest.selected.map(item => `memory:${item.name}`);
-            const omitted = memoryPrompt.manifest.omitted.map(item => `memory:${item.name}`);
-            (0, chat_trace_1.recordTraceEvent)(this.events, sessionId, {
-                turnId: String(turnId),
-                type: 'message',
-                name: 'memory_context',
-                argsSummary: JSON.stringify({
-                    budgetChars: memoryPrompt.manifest.budgetChars,
-                    usedChars: memoryPrompt.manifest.usedChars,
-                    candidateCount: memoryPrompt.manifest.candidateCount,
-                    entrypointTruncated: memoryPrompt.manifest.entrypoint.truncated,
-                    selected: selected.slice(0, 10),
-                    omitted: omitted.slice(0, 10),
-                }),
-                contentBytes: Buffer.byteLength(memoryPrompt.content, 'utf8'),
-            });
-        }
-        const promptCtx = {
-            cwd: this.runtime.cwd,
-            platform: process.platform,
-            nodeVersion: process.version,
-            tools: turnTools,
-            memoryContent: memoryPrompt.content,
-            skillsContent: snapshot.skillsContent,
-            projectInstructionsContent: snapshot.projectInstructionsContent,
-            activeSkillsContent: skillResolution.promptInjection,
-            referencedFilesContent: (0, file_context_1.buildReferencedFilesPrompt)(input, this.runtime.cwd),
-            planMode: snapshot.planMode || snapshot.agentMode === 'plan',
-            agentMode: snapshot.agentMode,
-            goalContent: this.goalCoordinator?.goal?.status === 'active'
-                ? (0, prompt_1.buildGoalContextFragment)(this.goalCoordinator.goal)?.text
-                : undefined,
-        };
-        const systemPrompt = (0, framework_1.buildSystemPrompt)(promptCtx);
-        const messages = [
-            { role: 'system', content: systemPrompt.static, cacheControl: { type: 'ephemeral' } },
-            ...(systemPrompt.dynamic ? [{ role: 'system', content: systemPrompt.dynamic }] : []),
-            ...snapshot.conversationHistory,
-            ...(options.persistAsUserMessage === false
-                ? [{ role: 'user', content: input }]
-                : []),
-        ];
-        let finalContent = '';
-        let finalUsage;
-        let finalModel = '';
-        let pendingCompleteTrace = null;
-        let pendingCompleteStats;
-        let pendingCompact;
-        const verificationResults = [];
-        const sessionMessagesToRecord = [];
-        const assistantStream = (0, chat_presentation_1.createAssistantStreamPresenter)(this.events, abortSignal);
-        const toolEvents = (0, chat_presentation_1.createToolEventPresenter)(this.events, {
-            projectPath: this.runtime.cwd,
-            turnId,
-        });
-        let checkpointSequence = 0;
-        const checkpointIds = [];
-        const streamCallbacks = {
-            onChunk: chunk => {
-                assistantStream.appendChunk(chunk);
-            },
-        };
-        const toolExecutor = async (name, args, signal) => {
-            // The runtime-bound `subtask` tool is not in the global TOOLS registry;
-            // dispatch it directly so it reaches the Supervisor closure.
-            if (name === 'subtask' && subtaskTool) {
-                const result = await subtaskTool.execute(args, {
-                    cwd: this.runtime.cwd,
-                    config: { name: this.runtime.config.name, mode: this.runtime.config.mode },
-                    abortSignal: signal,
-                    sessionId,
-                    turnId,
-                });
-                return JSON.stringify(result);
-            }
-            if (!turnTools.some(tool => tool.name === name)) {
-                return JSON.stringify({
-                    success: false,
-                    error: skillResolution.toolScopeActive
-                        ? `Tool ${name} is not available for the active skill scope. Available tools: ${skillResolution.tools.map(tool => tool.name).join(', ') || 'none'}`
-                        : `Tool ${name} is not available.`,
-                });
-            }
-            return (0, tools_1.executeTool)(name, args, signal, {
-                cwd: this.runtime.cwd,
-                config: {
-                    name: this.runtime.config.name,
-                    mode: this.runtime.config.mode,
-                },
-                sessionId,
-                turnId,
-                // Tools that fan out to other tools (batch_read) have to re-run the
-                // permission gate per sub-step; they need the mode and the allowlist.
-                permissionMode: effectivePermissionMode,
-                toolAllowlist: this.resolveToolAllowlist(),
-                toolConfirmation: this.runtime.config.toolConfirmation,
-                confirmToolUse: effectivePermissionMode === 'auto' ? undefined : this.controllerOptions.confirmToolUse,
-                onPlanModeChange,
-            });
-        };
-        const loopBudget = options.inputKind === 'goal_continuation'
-            ? (0, loop_budget_1.resolveAutonomousGoalLoopBudget)(this.runtime.config)
-            : (0, loop_budget_1.resolveRuntimeLoopBudget)(input, this.runtime.config, harness.toJSON());
-        let observedTurnsStarted = 0;
-        let observedLlmRequests = 0;
-        let observedToolCalls = 0;
-        let observedReadOnlyToolCalls = 0;
-        let observedUnsafeToolCalls = 0;
-        let observedToolResultBytes = 0;
-        let observedModelVisibleToolBytes = 0;
-        const restoreProviderPreflight = typeof this.runtime.llm.setProviderRequestPreflight === 'function'
-            ? this.runtime.llm.setProviderRequestPreflight(this.controllerOptions.beforeProviderRequest)
-            : undefined;
-        const persistInterruptedAccounting = (rootUsage, stats, usageAccountingComplete) => {
-            const accountingStats = {
-                ...stats,
-                finishReason: 'cancelled',
-                usageAccountingComplete,
-            };
-            const interruptedStats = this.foldSubagentUsage(accountingStats, subagentBundle);
-            this.setLoopStats(interruptedStats);
-            const subagentUsage = subagentBundle?.getAggregateUsage();
-            const knownZeroRootUsage = usageAccountingComplete && interruptedStats.llmRequests === 0;
-            if (rootUsage || knownZeroRootUsage) {
-                this.runtime.store.setTokenUsage({
-                    promptTokens: (rootUsage?.promptTokens ?? 0) + (subagentUsage?.promptTokens ?? 0),
-                    completionTokens: (rootUsage?.completionTokens ?? 0) + (subagentUsage?.completionTokens ?? 0),
-                });
-            }
-        };
-        try {
-            for await (const event of (0, framework_1.query)({
-                messages,
-                tools: turnTools,
-                toolExecutor,
-                llm: this.runtime.llm,
-                streamCallbacks,
-                costTracker: snapshot.costTracker,
-                permissionMode: effectivePermissionMode,
-                toolConfirmation: this.runtime.config.toolConfirmation,
-                toolAllowlist: this.resolveToolAllowlist(),
-                confirmToolUse: effectivePermissionMode === 'auto' ? undefined : this.controllerOptions.confirmToolUse,
-                toolContext: {
-                    cwd: this.runtime.cwd,
-                    config: {
-                        name: this.runtime.config.name,
-                        mode: this.runtime.config.mode,
-                    },
-                    sessionId,
-                    turnId,
-                    permissionMode: effectivePermissionMode,
-                    toolAllowlist: this.resolveToolAllowlist(),
-                    toolConfirmation: this.runtime.config.toolConfirmation,
-                    confirmToolUse: effectivePermissionMode === 'auto' ? undefined : this.controllerOptions.confirmToolUse,
-                    onPlanModeChange,
-                },
-                abortSignal,
-                harness,
-                input,
-                loopBudget,
-                onContextUsage: usage => {
-                    this.runtime.store.setContextUsage(usage);
-                },
-                compactCoordinator: this.runtime.compactCoordinator,
-                onCompactPrepare: sessionId
-                    ? () => (0, session_storage_1.prepareSessionCompactSourceReceipt)(sessionId)
-                    : undefined,
-            })) {
-                switch (event.type) {
-                    case 'request_start':
-                        observedTurnsStarted = Math.max(observedTurnsStarted, event.turn);
-                        observedLlmRequests++;
-                        assistantStream.discardSegment();
-                        this.events.setStatus((0, agent_status_1.agentStepStatus)(event.turn));
-                        if (sessionId) {
-                            (0, chat_trace_1.recordTraceEvent)(this.events, sessionId, {
-                                turnId,
-                                type: 'request_start',
-                                model: event.model,
-                                turn: event.turn,
-                            });
-                        }
-                        break;
-                    case 'prompt_assembly':
-                        if (sessionId) {
-                            (0, chat_trace_1.recordTraceEvent)(this.events, sessionId, {
-                                turnId,
-                                type: 'prompt_assembly',
-                                promptModelId: event.modelId,
-                                promptEstimatedTokens: event.estimatedTokens,
-                                promptBudgetTokens: event.budgetTokens,
-                                promptCoreTokens: event.coreTokens,
-                                promptEvidenceBudgetTokens: event.evidenceBudgetTokens,
-                                promptRecentTurnBudgetTokens: event.recentTurnBudgetTokens,
-                                promptSections: event.sections,
-                                promptIncludedEvidence: event.includedEvidence,
-                                promptOmittedEvidence: event.omittedEvidence,
-                                promptIncludedEvidenceCount: event.includedEvidenceCount,
-                                promptOmittedEvidenceCount: event.omittedEvidenceCount,
-                                promptSectionManifest: event.sectionManifest,
-                                promptOverBudget: event.overBudget,
-                                promptCapabilityProfileVersion: event.capabilityProfileVersion,
-                                promptCapabilityProfileFingerprint: event.capabilityProfileFingerprint,
-                            });
-                        }
-                        break;
-                    case 'assistant_tool_calls':
-                        assistantStream.ensureMessage(event.content || '');
-                        assistantStream.closeSegment();
-                        this.events.setStatus((0, agent_status_1.runningToolsStatus)(event.toolCalls.length));
-                        {
-                            const batchReadOnlyCount = event.toolCalls.filter(tc => {
-                                const def = skillResolution.tools.find(t => t.name === tc.function.name);
-                                const args = (0, chat_checkpoint_1.parseToolCallArgsForRuntime)(tc);
-                                return args && def?.isReadOnly?.(args) === true;
-                            }).length;
-                            const suggestion = (0, agent_status_1.batchingSuggestion)(batchReadOnlyCount);
-                            if (suggestion) {
-                                this.events.append({ role: 'status', content: suggestion });
-                            }
-                        }
-                        const checkpointId = `${turnId}-${checkpointSequence + 1}-${(0, crypto_1.randomUUID)()}`;
-                        const checkpointResult = (0, chat_checkpoint_1.createPreToolCheckpoint)(this.events, sessionId, turnId, checkpointId, this.runtime.cwd, event.toolCalls);
-                        if (checkpointResult.created) {
-                            checkpointIds.push(checkpointId);
-                            checkpointSequence++;
-                        }
-                        if (checkpointResult.created && checkpointResult.risky) {
-                            this.events.append({
-                                role: 'status',
-                                title: 'checkpoint',
-                                statusTone: 'warning',
-                                content: `Risky edit: ${checkpointResult.targetCount} files in one turn. Checkpoint ${checkpointId} created for rollback (/checkpoints restore ${checkpointId}).`,
-                            });
-                        }
-                        else if (checkpointResult.risky) {
-                            this.events.append({
-                                role: 'status',
-                                title: 'checkpoint',
-                                statusTone: 'warning',
-                                content: `Risky edit: ${checkpointResult.targetCount} files in one turn, but checkpoint creation failed. Restore any pre-existing checkpoint manually or revert via git.`,
-                            });
-                        }
-                        if (sessionId) {
-                            (0, chat_trace_1.recordTraceEvent)(this.events, sessionId, {
-                                turnId,
-                                type: 'assistant_tool_calls',
-                                toolCallCount: event.toolCalls.length,
-                                contentBytes: (0, chat_trace_1.byteLength)(event.content || ''),
-                            });
-                        }
-                        sessionMessagesToRecord.push({
-                            role: 'assistant',
-                            content: event.content || '',
-                            timestamp: Date.now(),
-                            tool_calls: event.toolCalls,
-                        });
-                        break;
-                    case 'tool_call':
-                        observedToolCalls++;
-                        {
-                            const toolDefinition = skillResolution.tools.find(tool => tool.name === event.name);
-                            if (toolDefinition?.isReadOnly?.(event.args) === true) {
-                                observedReadOnlyToolCalls++;
-                            }
-                            else {
-                                observedUnsafeToolCalls++;
-                            }
-                        }
-                        assistantStream.closeSegment();
-                        toolEvents.start(event);
-                        if (sessionId) {
-                            const traceArgs = (0, chat_trace_1.buildTraceArgsDetails)(this.runtime.cwd, event.name, event.args);
-                            (0, chat_trace_1.recordTraceEvent)(this.events, sessionId, {
-                                turnId,
-                                type: 'tool_call',
-                                name: event.name,
-                                callId: event.callId,
-                                ...traceArgs,
-                                batchCount: event.batchCount,
-                                batchIndex: event.batchIndex,
-                            });
-                        }
-                        break;
-                    case 'permission_decision':
-                        toolEvents.permission(event);
-                        if (sessionId) {
-                            (0, chat_trace_1.recordTraceEvent)(this.events, sessionId, {
-                                turnId,
-                                type: 'permission_decision',
-                                name: event.name,
-                                callId: event.callId,
-                                argsSummary: (0, chat_trace_1.compactToolArgs)(event.args),
-                                permissionBehavior: event.decision.behavior,
-                                permissionApproved: event.decision.approved,
-                                permissionSource: event.decision.source,
-                                permissionReason: event.decision.reason
-                                    ? (0, chat_trace_1.compactMiddle)(event.decision.reason, 240)
-                                    : undefined,
-                                permissionDuration: event.decision.duration,
-                                batchCount: event.batchCount,
-                                batchIndex: event.batchIndex,
-                            });
-                        }
-                        break;
-                    case 'tool_result': {
-                        observedToolResultBytes += event.outputBytes ?? (0, chat_trace_1.byteLength)(event.result);
-                        observedModelVisibleToolBytes += (0, chat_trace_1.byteLength)(event.modelVisibleResult);
-                        toolEvents.finish(event);
-                        if (sessionId) {
-                            (0, chat_trace_1.recordTraceEvent)(this.events, sessionId, {
-                                turnId,
-                                type: 'tool_result',
-                                name: event.name,
-                                callId: event.callId,
-                                argsSummary: (0, chat_trace_1.compactToolArgs)(event.args),
-                                success: event.success,
-                                duration: event.duration,
-                                outputBytes: event.outputBytes,
-                                modelVisibleBytes: (0, chat_trace_1.byteLength)(event.modelVisibleResult),
-                                artifactId: event.artifactRef?.id,
-                                error: event.error ? (0, chat_trace_1.compactMiddle)(event.error, 240) : undefined,
-                                batchCount: event.batchCount,
-                                batchIndex: event.batchIndex,
-                            });
-                        }
-                        const verificationResult = (0, verification_profile_1.collectVerificationCommandResult)({
-                            toolName: event.name,
-                            args: event.args,
-                            success: event.success,
-                            outputBytes: event.outputBytes,
-                            error: event.error,
-                        });
-                        if (verificationResult) {
-                            verificationResults.push(verificationResult);
-                            (0, chat_workspace_1.appendVerificationResultTrace)(this.events, sessionId, turnId, verificationResult);
-                        }
-                        sessionMessagesToRecord.push({
-                            role: 'tool',
-                            content: event.result,
-                            modelVisibleContent: event.modelVisibleResult,
-                            timestamp: Date.now(),
-                            toolCallId: event.callId,
-                        });
-                        break;
-                    }
-                    case 'strategy_exhausted':
-                        this.events.append({ role: 'status', content: event.suggestion });
-                        if (sessionId) {
-                            (0, chat_trace_1.recordTraceEvent)(this.events, sessionId, {
-                                turnId,
-                                type: 'strategy_exhausted',
-                                note: (0, chat_trace_1.compactMiddle)(event.suggestion, 240),
-                            });
-                        }
-                        break;
-                    case 'warning':
-                        this.events.append({
-                            role: 'status',
-                            statusTone: 'warning',
-                            title: 'harness',
-                            content: event.message,
-                        });
-                        break;
-                    case 'message':
-                        finalContent = event.content;
-                        assistantStream.ensureMessage(event.content);
-                        if (sessionId) {
-                            (0, chat_trace_1.recordTraceEvent)(this.events, sessionId, {
-                                turnId,
-                                type: 'message',
-                                contentBytes: (0, chat_trace_1.byteLength)(event.content),
-                            });
-                        }
-                        if (event.content) {
-                            sessionMessagesToRecord.push({
-                                role: 'assistant',
-                                content: event.content,
-                                timestamp: Date.now(),
-                            });
-                        }
-                        break;
-                    case 'complete':
-                        if (event.stats?.finishReason === 'blocked') {
-                            toolEvents.finalizePendingAsSkipped('permission denied');
-                        }
-                        if (event.content && !finalContent) {
-                            if (event.stats?.finishReason === 'budget_exceeded') {
-                                assistantStream.replaceMessage(event.content);
-                            }
-                            else {
-                                assistantStream.ensureMessage(event.content);
-                            }
-                            sessionMessagesToRecord.push({
-                                role: 'assistant',
-                                content: event.content,
-                                timestamp: Date.now(),
-                            });
-                        }
-                        finalContent = event.content;
-                        finalUsage = event.usage;
-                        finalModel = event.model;
-                        pendingCompact = event.compact;
-                        if (event.stats) {
-                            pendingCompleteStats = event.stats;
-                            (0, chat_trace_1.recordProviderTraceEvents)(this.events, sessionId, turnId, event.stats);
-                            pendingCompleteTrace = {
-                                turnId,
-                                type: 'complete',
-                                model: event.model,
-                                contentBytes: (0, chat_trace_1.byteLength)(event.content || ''),
-                                finishReason: event.stats.finishReason,
-                                stopDecision: event.stats.stopDecision,
-                                llmRequests: event.stats.llmRequests,
-                                toolCalls: event.stats.toolCalls,
-                                readOnlyToolCalls: event.stats.readOnlyToolCalls,
-                                unsafeToolCalls: event.stats.unsafeToolCalls,
-                                loopBudgetSource: event.stats.loopBudgetSource,
-                                loopBudgetBaseProfile: event.stats.loopBudgetBaseProfile,
-                                loopBudgetMaxLlmRequests: event.stats.loopBudgetMaxLlmRequests,
-                                loopBudgetMaxToolCalls: event.stats.loopBudgetMaxToolCalls,
-                                loopBudgetMaxReadOnlyFragmentation: event.stats.loopBudgetMaxReadOnlyFragmentation,
-                                loopBudgetMaxModelVisibleBytes: event.stats.loopBudgetMaxModelVisibleBytes,
-                                loopBudgetConfigOverride: event.stats.loopBudgetConfigOverride,
-                                budgetExceededReason: event.stats.budgetExceededReason,
-                                continuationActions: event.stats.continuationActions,
-                                continuationHint: event.stats.continuationHint,
-                                lastToolName: event.stats.lastToolName,
-                                lastToolSummary: event.stats.lastToolSummary,
-                                lastToolSuccess: event.stats.lastToolSuccess,
-                                localFastPathUsed: event.stats.localFastPathUsed,
-                            };
-                        }
-                        else {
-                            pendingCompleteTrace = {
-                                turnId,
-                                type: 'complete',
-                                model: event.model,
-                                contentBytes: (0, chat_trace_1.byteLength)(event.content || ''),
-                            };
-                        }
-                        break;
-                }
-            }
-            const wasAborted = abortSignal?.aborted === true;
-            if (wasAborted) {
-                const stats = pendingCompleteStats ??
-                    (0, framework_1.createFailedLoopStats)({
-                        loopBudget,
-                        diagnostics: observedLlmRequests > 0 ? (0, chat_trace_1.getLastRequestDiagnostics)(this.runtime.llm) : undefined,
-                        turnsStarted: observedTurnsStarted,
-                        llmRequests: observedLlmRequests,
-                        toolCalls: observedToolCalls,
-                        readOnlyToolCalls: observedReadOnlyToolCalls,
-                        unsafeToolCalls: observedUnsafeToolCalls,
-                        toolResultBytes: observedToolResultBytes,
-                        modelVisibleToolBytes: observedModelVisibleToolBytes,
-                    });
-                persistInterruptedAccounting(finalUsage, stats, finalUsage !== undefined || stats.llmRequests === 0);
-                assistantStream.discardSegment();
-                this.events.setStatus('Interrupted.');
-                (0, chat_presentation_1.removeTrailingUserMessage)(this.runtime);
-                if (sessionId) {
-                    const { delta } = (0, chat_workspace_1.appendPostWorkspaceTrace)(this.events, sessionId, turnId, this.runtime.cwd, preWorkspace, verificationResults);
-                    (0, chat_trace_1.recordTraceEvent)(this.events, sessionId, {
-                        turnId,
-                        type: 'aborted',
-                        note: 'aborted_after_query',
-                    });
-                    const recoveryNotice = (0, chat_workspace_1.workspaceDeltaHasTurnChanges)(delta)
-                        ? (0, chat_workspace_1.formatFailureRecoveryNotice)(turnId, delta, checkpointIds)
-                        : undefined;
-                    if (recoveryNotice) {
-                        this.events.append({
-                            role: 'status',
-                            title: 'recovery',
-                            statusTone: 'warning',
-                            content: recoveryNotice,
-                        });
-                    }
-                    (0, session_storage_1.removeLastIncompleteAssistantMessage)(sessionId);
-                }
-                // Persist any accumulated session messages before returning,
-                // so tool results from the interrupted turn are not lost.
-                if (sessionId && sessionMessagesToRecord.length > 0) {
-                    (0, session_storage_1.appendSessionMessages)(sessionId, sessionMessagesToRecord);
-                }
-                return;
-            }
-            assistantStream.closeSegment();
-            if (sessionId) {
-                const { profile, summary } = (0, chat_workspace_1.appendPostWorkspaceTrace)(this.events, sessionId, turnId, this.runtime.cwd, preWorkspace, verificationResults);
-                if (profile.changedFiles.length > 0 && profile.required) {
-                    this.events.setStatus((0, agent_status_1.verifyingStatus)(profile.profile));
-                    this.controllerOptions.onVerificationStateChange?.('running');
-                }
-                if ((0, chat_workspace_1.shouldRecordVerificationLoopStats)(profile, summary)) {
-                    const stats = pendingCompleteStats ?? this.runtime.store.getSnapshot().lastLoopStats;
-                    if (stats) {
-                        pendingCompleteStats = (0, chat_workspace_1.withVerificationLoopStats)(stats, summary);
-                    }
-                }
-                if ((0, verification_profile_1.shouldGateCompletion)(summary)) {
-                    this.events.setStatus((0, agent_status_1.verificationGateStatus)(summary.skippedReason ?? 'verification checks not run'));
-                    this.controllerOptions.onVerificationStateChange?.('gated');
-                    const notice = (0, verification_profile_1.formatVerificationGateNotice)(summary);
-                    this.events.append({
-                        role: 'status',
-                        title: 'verification',
-                        statusTone: 'warning',
-                        content: notice,
-                    });
-                    finalContent = finalContent ? `${finalContent}\n\n${notice}` : notice;
-                    (0, chat_trace_1.appendAssistantNotice)(sessionMessagesToRecord, notice);
-                    if (pendingCompleteTrace) {
-                        pendingCompleteTrace.finishReason = 'completion_gate';
-                        pendingCompleteTrace.contentBytes = (0, chat_trace_1.byteLength)(finalContent);
-                        pendingCompleteTrace.note = 'verification_incomplete';
-                    }
-                    const stats = pendingCompleteStats ?? this.runtime.store.getSnapshot().lastLoopStats;
-                    if (stats) {
-                        pendingCompleteStats = (0, framework_1.withLoopFinishReason)((0, chat_workspace_1.withVerificationLoopStats)(stats, summary), 'completion_gate');
-                        if (pendingCompleteTrace) {
-                            pendingCompleteTrace.stopDecision = pendingCompleteStats.stopDecision;
-                        }
-                    }
-                }
-                else if (profile.changedFiles.length > 0 && profile.required) {
-                    this.controllerOptions.onVerificationStateChange?.('passed');
-                }
-            }
-            if (pendingCompleteStats?.finishReason === 'budget_exceeded') {
-                const stats = pendingCompleteStats;
-                const budgetStop = (0, ui_view_model_1.createLoopBudgetStopView)(stats);
-                const notice = (0, ui_view_model_1.formatLoopBudgetStopView)(budgetStop, (0, ui_view_model_1.budgetStopLocaleForInput)(input));
-                this.events.append({
-                    role: 'status',
-                    title: 'budget',
-                    statusTone: 'warning',
-                    content: notice,
-                    budgetStop,
-                });
-                finalContent = finalContent ? `${finalContent}\n\n${notice}` : notice;
-                (0, chat_trace_1.appendAssistantNotice)(sessionMessagesToRecord, notice);
-                if (pendingCompleteTrace) {
-                    pendingCompleteTrace.contentBytes = (0, chat_trace_1.byteLength)(finalContent);
-                }
-            }
-            if (pendingCompleteStats) {
-                this.setLoopStats(this.foldSubagentUsage(pendingCompleteStats, subagentBundle));
-            }
-            if (finalContent) {
-                this.runtime.store.addMessage({ role: 'assistant', content: finalContent });
-            }
-            if (sessionId && sessionMessagesToRecord.length > 0) {
-                (0, session_storage_1.appendSessionMessages)(sessionId, sessionMessagesToRecord);
-            }
-            harness.ingestTurn({
-                userInput: input,
-                assistantContent: finalContent,
-                sessionMessages: sessionMessagesToRecord,
-                intent,
-            });
-            const harnessState = harness.toJSON();
-            this.runtime.store.setState({ harnessState });
-            (0, chat_trace_1.emitHarnessDiagnostics)(this.events, harnessState);
-            if (sessionId) {
-                (0, session_storage_1.updateSessionHarnessState)(sessionId, harnessState);
-            }
-            if (pendingCompact) {
-                (0, chat_compact_1.commitChatCompact)({
-                    pendingCompact,
-                    sessionId,
-                    turnId,
-                    modelId: finalModel || this.runtime.llm.getModel(),
-                    sessionMessages: sessionMessagesToRecord,
-                    harnessState,
-                    activeGoal: this.goalCoordinator?.goal,
-                    store: this.runtime.store,
-                    events: this.events,
-                });
-            }
-            if (finalUsage) {
-                // Fold subagent token usage into /cost accounting.
-                if (subagentBundle) {
-                    const subUsage = subagentBundle.getAggregateUsage();
-                    finalUsage = {
-                        promptTokens: finalUsage.promptTokens + subUsage.promptTokens,
-                        completionTokens: finalUsage.completionTokens + subUsage.completionTokens,
-                    };
-                }
-                this.runtime.store.setTokenUsage(finalUsage);
-            }
-            if (sessionId) {
-                if (pendingCompleteTrace) {
-                    (0, chat_trace_1.recordTraceEvent)(this.events, sessionId, pendingCompleteTrace);
-                }
-                (0, session_storage_1.updateSessionSkills)(sessionId, appliedSkillNames);
-            }
-            this.events.setStatus(finalModel ? `Completed with ${finalModel}` : 'Completed');
-        }
-        catch (error) {
-            // v0.2.25: Provider retry exhausted is a recoverable turn failure.
-            if (error instanceof provider_resilience_1.ProviderRetryExhaustedError) {
-                const diag = error.diagnostics;
-                const attempts = diag?.attempts?.length ?? '?';
-                const kind = diag?.attempts?.[diag.attempts.length - 1]?.failureKind ?? 'unknown';
-                this.events.setStatus(`Provider unavailable (${kind}, ${attempts} attempts). Retry exhausted — ready for next input.`);
-                this.events.append({
-                    role: 'error',
-                    title: 'provider',
-                    content: `Provider retry exhausted after ${attempts} attempts (${kind}). The turn was not completed. You can try again or wait for the provider to recover.`,
-                    errorLayer: 'provider',
-                });
-                // v0.2.25: If a goal is active, pause it on provider retry exhaustion
-                // so it doesn't auto-continue and burn retries.
-                try {
-                    const gc = this.goalCoordinator;
-                    if (gc?.goal?.status === 'active') {
-                        gc.deferContinuation();
-                    }
-                }
-                catch {
-                    /* best effort */
-                }
-                return;
-            }
-            if ((0, chat_trace_1.isAbortError)(error, abortSignal)) {
-                const interruptedStats = error instanceof framework_1.QueryLoopError
-                    ? error.stats
-                    : (0, framework_1.createFailedLoopStats)({
-                        loopBudget,
-                        diagnostics: observedLlmRequests > 0 ? (0, chat_trace_1.getLastRequestDiagnostics)(this.runtime.llm) : undefined,
-                        turnsStarted: observedTurnsStarted,
-                        llmRequests: observedLlmRequests,
-                        toolCalls: observedToolCalls,
-                        readOnlyToolCalls: observedReadOnlyToolCalls,
-                        unsafeToolCalls: observedUnsafeToolCalls,
-                        toolResultBytes: observedToolResultBytes,
-                        modelVisibleToolBytes: observedModelVisibleToolBytes,
-                    });
-                const interruptedRootUsage = error instanceof framework_1.QueryLoopError ? error.aggregateUsage : undefined;
-                // A thrown abort after a provider request started can only prove a
-                // lower bound: the in-flight request may be billable even when its
-                // final usage chunk never arrived.
-                persistInterruptedAccounting(interruptedRootUsage, interruptedStats, interruptedStats.llmRequests === 0);
-                assistantStream.discardSegment();
-                this.events.setStatus('Interrupted.');
-                (0, chat_presentation_1.removeTrailingUserMessage)(this.runtime);
-                if (sessionId) {
-                    const { delta } = (0, chat_workspace_1.appendPostWorkspaceTrace)(this.events, sessionId, turnId, this.runtime.cwd, preWorkspace, verificationResults);
-                    (0, chat_trace_1.recordTraceEvent)(this.events, sessionId, {
-                        turnId,
-                        type: 'aborted',
-                        note: 'abort_error',
-                    });
-                    const recoveryNotice = (0, chat_workspace_1.workspaceDeltaHasTurnChanges)(delta)
-                        ? (0, chat_workspace_1.formatFailureRecoveryNotice)(turnId, delta, checkpointIds)
-                        : undefined;
-                    if (recoveryNotice) {
-                        this.events.append({
-                            role: 'status',
-                            title: 'recovery',
-                            statusTone: 'warning',
-                            content: recoveryNotice,
-                        });
-                    }
-                    (0, session_storage_1.removeLastIncompleteAssistantMessage)(sessionId);
-                }
-                return;
-            }
-            assistantStream.discardSegment();
-            this.events.append({
-                role: 'error',
-                content: (0, chat_trace_1.formatChatError)(error),
-                errorLayer: (0, chat_trace_1.errorLayerForChatError)(error),
-            });
-            this.events.setStatus('Turn failed. Ready for the next input.');
-            const failedStats = this.foldSubagentUsage(error instanceof framework_1.QueryLoopError
-                ? error.stats
-                : (0, framework_1.createFailedLoopStats)({
-                    loopBudget,
-                    diagnostics: observedLlmRequests > 0 ? (0, chat_trace_1.getLastRequestDiagnostics)(this.runtime.llm) : undefined,
-                    turnsStarted: observedTurnsStarted,
-                    llmRequests: observedLlmRequests,
-                    toolCalls: observedToolCalls,
-                    readOnlyToolCalls: observedReadOnlyToolCalls,
-                    unsafeToolCalls: observedUnsafeToolCalls,
-                    toolResultBytes: observedToolResultBytes,
-                    modelVisibleToolBytes: observedModelVisibleToolBytes,
-                }), subagentBundle);
-            const rootUsage = error instanceof framework_1.QueryLoopError ? error.aggregateUsage : undefined;
-            const subagentUsage = subagentBundle?.getAggregateUsage();
-            const hasSubagentUsage = (subagentUsage?.promptTokens ?? 0) > 0 || (subagentUsage?.completionTokens ?? 0) > 0;
-            if (rootUsage || hasSubagentUsage) {
-                this.runtime.store.setTokenUsage({
-                    promptTokens: (rootUsage?.promptTokens ?? 0) + (subagentUsage?.promptTokens ?? 0),
-                    completionTokens: (rootUsage?.completionTokens ?? 0) + (subagentUsage?.completionTokens ?? 0),
-                });
-            }
-            this.setLoopStats(failedStats);
-            if (sessionId) {
-                (0, chat_trace_1.recordProviderTraceEvents)(this.events, sessionId, turnId, failedStats);
-                const { delta } = (0, chat_workspace_1.appendPostWorkspaceTrace)(this.events, sessionId, turnId, this.runtime.cwd, preWorkspace, verificationResults);
-                const recoveryNotice = (0, chat_workspace_1.workspaceDeltaHasTurnChanges)(delta)
-                    ? (0, chat_workspace_1.formatFailureRecoveryNotice)(turnId, delta, checkpointIds)
-                    : undefined;
-                if (recoveryNotice) {
-                    this.events.append({
-                        role: 'status',
-                        title: 'recovery',
-                        statusTone: 'warning',
-                        content: recoveryNotice,
-                    });
-                }
-                (0, chat_trace_1.recordTraceEvent)(this.events, sessionId, {
-                    turnId,
-                    type: 'error',
-                    error: (0, chat_trace_1.compactTraceError)(error),
-                    note: recoveryNotice,
-                });
-                (0, chat_trace_1.recordTraceEvent)(this.events, sessionId, {
-                    turnId,
-                    type: 'complete',
-                    model: failedStats.providerFinalModel ?? this.runtime.llm.getModel(),
-                    contentBytes: 0,
-                    finishReason: failedStats.finishReason,
-                    stopDecision: failedStats.stopDecision,
-                    llmRequests: failedStats.llmRequests,
-                    toolCalls: failedStats.toolCalls,
-                    readOnlyToolCalls: failedStats.readOnlyToolCalls,
-                    unsafeToolCalls: failedStats.unsafeToolCalls,
-                    loopBudgetSource: failedStats.loopBudgetSource,
-                    loopBudgetBaseProfile: failedStats.loopBudgetBaseProfile,
-                    loopBudgetMaxLlmRequests: failedStats.loopBudgetMaxLlmRequests,
-                    loopBudgetMaxToolCalls: failedStats.loopBudgetMaxToolCalls,
-                    loopBudgetMaxReadOnlyFragmentation: failedStats.loopBudgetMaxReadOnlyFragmentation,
-                    loopBudgetMaxModelVisibleBytes: failedStats.loopBudgetMaxModelVisibleBytes,
-                    loopBudgetConfigOverride: failedStats.loopBudgetConfigOverride,
-                    localFastPathUsed: failedStats.localFastPathUsed,
-                });
-                (0, session_storage_1.removeLastIncompleteAssistantMessage)(sessionId);
-                // A failed turn must not leave the user's prompt dangling in the
-                // persisted session (it would replay on resume). The in-memory history
-                // is cleaned above (2969-2972); mirror that for the on-disk transcript.
-                if (options.persistAsUserMessage !== false) {
-                    (0, session_storage_1.removeTrailingSessionUserMessage)(sessionId);
-                }
-            }
-            const history = this.runtime.store.getSnapshot().conversationHistory;
-            if (history.length > 0) {
-                this.runtime.store.setState({ conversationHistory: history.slice(0, -1) });
-            }
-        }
-        finally {
-            restoreProviderPreflight?.();
-        }
-    }
-}
-exports.AgentChatController = AgentChatController;
-exports.InkChatController = AgentChatController;
-function loadSessionIntoRuntime(runtime, sessionId) {
-    const history = (0, session_storage_1.loadSessionHistory)(sessionId);
-    runtime.store.setState({ conversationHistory: history });
-    runtime.store.setState({
-        harnessState: (0, session_storage_1.loadSessionHarnessState)(sessionId) ?? (0, session_storage_1.loadSessionMeta)(sessionId)?.harnessState,
-    });
-    return `Restored ${history.length} messages`;
-}
-function closeSession(runtime) {
-    const session = runtime.getSession();
-    if (!session)
-        return;
-    const messages = (0, session_storage_1.readSessionMessages)(session.id);
-    if (messages.length > 0) {
-        (0, session_storage_1.updateSessionSummary)(session.id, messages);
-    }
-    (0, session_storage_1.endSession)(session.id);
-}
-//# sourceMappingURL=chat-controller.js.map