@aexol/spectral 0.9.166 → 0.9.169

package/dist/sdk/coding-agent/core/agent-session.js

@@ -18,18 +18,19 @@ import { clampThinkingLevel, cleanupSessionResources, getSupportedThinkingLevels
 import { stripFrontmatter } from "../utils/frontmatter.js";
 import { resolvePath } from "../utils/paths.js";
 import { sleep } from "../utils/sleep.js";
-import { formatNoApiKeyFoundMessage, formatNoModelSelectedMessage } from "./auth-guidance.js";
+import { formatNoApiKeyFoundMessage, formatNoModelSelectedMessage, } from "./auth-guidance.js";
 import { executeBashWithOperations } from "./bash-executor.js";
 import { calculateContextTokens, collectEntriesForBranchSummary, compactDcpLite, estimateContextTokens, estimateCompactionTokenMetrics, getManualCompactionSettings, normalizeCompactionPolicy, normalizeManualKeepRecentTokens, generateBranchSummary, prepareCompaction, shouldCompact, } from "./compaction/index.js";
+import { enrichDcpCompaction, mergeCompactionObservations } from "./compaction/llm-compaction.js";
 import { DEFAULT_THINKING_LEVEL } from "./defaults.js";
 import { ExtensionRunner, wrapRegisteredTools, } from "./extensions/index.js";
 import { emitSessionShutdownEvent } from "./extensions/runner.js";
-import { expandPromptTemplate } from "./prompt-templates.js";
-import { CURRENT_SESSION_VERSION, getLatestCompactionEntry } from "./session-manager.js";
+import { expandPromptTemplate, } from "./prompt-templates.js";
+import { CURRENT_SESSION_VERSION, getLatestCompactionEntry, } from "./session-manager.js";
 import { createSyntheticSourceInfo } from "./source-info.js";
-import { buildSystemPrompt } from "./system-prompt.js";
-import { mutateSystemPrompt } from "./system-prompt-mutator.js";
-import { createLocalBashOperations } from "./tools/bash.js";
+import { buildSystemPrompt, } from "./system-prompt.js";
+import { mutateSystemPrompt, } from "./system-prompt-mutator.js";
+import { createLocalBashOperations, } from "./tools/bash.js";
 import { createAllToolDefinitions } from "./tools/index.js";
 import { createToolDefinitionFromAgentTool } from "./tools/tool-definition-wrapper.js";
 /**
@@ -73,7 +74,8 @@ function createVirtualPhaseBoundaryEntry(pathEntries) {
     };
 }
 function isDcpLitePhaseBoundaryEntry(entry) {
-    return entry?.type === "custom_message" && entry.customType === DCP_LITE_PHASE_BOUNDARY_CUSTOM_TYPE;
+    return (entry?.type === "custom_message" &&
+        entry.customType === DCP_LITE_PHASE_BOUNDARY_CUSTOM_TYPE);
 }
 function isRecord(value) {
     return Boolean(value) && typeof value === "object" && !Array.isArray(value);
@@ -135,9 +137,9 @@ function getNonShrinkingSkipMessage(result) {
         return "Compaction skipped: no eligible history to compact.";
     }
     if ((tokensRemoved ?? 0) <= 0 || summaryTokens >= tokensCompacted) {
-        return `Compaction skipped: generated summary would not shrink context (` +
+        return (`Compaction skipped: generated summary would not shrink context (` +
             `compacted ~${tokensCompacted.toLocaleString()} tokens, ` +
-            `summary +~${summaryTokens.toLocaleString()} tokens).`;
+            `summary +~${summaryTokens.toLocaleString()} tokens).`);
     }
     return undefined;
 }
@@ -153,7 +155,13 @@ function markCompactionSkipped(result, skipReason, message) {
 // Constants
 // ============================================================================
 /** Standard thinking levels */
-const THINKING_LEVELS = ["off", "minimal", "low", "medium", "high"];
+const THINKING_LEVELS = [
+    "off",
+    "minimal",
+    "low",
+    "medium",
+    "high",
+];
 const LENGTH_CONTINUATION_PROMPT = "Your previous assistant response ended because the provider hit its maximum output length. Continue exactly from where it stopped. Do not repeat, recap, or summarize earlier content. If the previous response ended mid-sentence, resume with the next missing word; otherwise continue with the next missing content.";
 // ============================================================================
 // AgentSession Class
@@ -176,6 +184,8 @@ export class AgentSession {
     _compactionAbortController = undefined;
     _autoCompactionAbortController = undefined;
     _compactionInProgress = false;
+    _requestTimeJobs = new Map();
+    _requestTimeControllers = new Map();
     _overflowRecoveryAttempted = false;
     // Branch summarization state
     _branchSummaryAbortController = undefined;
@@ -232,9 +242,14 @@ export class AgentSession {
         this._modelRegistry = config.modelRegistry;
         this._extensionRunnerRef = config.extensionRunnerRef;
         this._initialActiveToolNames = config.initialActiveToolNames;
-        this._allowedToolNames = config.allowedToolNames ? new Set(config.allowedToolNames) : undefined;
+        this._allowedToolNames = config.allowedToolNames
+            ? new Set(config.allowedToolNames)
+            : undefined;
         this._baseToolsOverride = config.baseToolsOverride;
-        this._sessionStartEvent = config.sessionStartEvent ?? { type: "session_start", reason: "startup" };
+        this._sessionStartEvent = config.sessionStartEvent ?? {
+            type: "session_start",
+            reason: "startup",
+        };
         // Always subscribe to agent events for internal handling
         // (session persistence, extensions, auto-compaction, retry logic)
         this._unsubscribeAgent = this.agent.subscribe(this._handleAgentEvent);
@@ -243,6 +258,14 @@ export class AgentSession {
             activeToolNames: this._initialActiveToolNames,
             includeAllExtensionTools: true,
         });
+        // Recover journaled request-time workers after a process reload. The
+        // journal is authoritative; only pending/running jobs are resumed.
+        for (const job of this.sessionManager.getRequestTimeCompactionJobs()) {
+            this._requestTimeJobs.set(job.snapshot.compactionId, job);
+            const controller = new AbortController();
+            this._requestTimeControllers.set(job.snapshot.compactionId, controller);
+            void this._runRequestTimeCompaction(job, controller).catch(() => undefined);
+        }
     }
     /** Model registry for API key resolution and model discovery */
     get modelRegistry() {
@@ -366,7 +389,9 @@ export class AgentSession {
         // Emit to extensions first
         await this._emitExtensionEvent(event);
         // Notify all listeners
-        this._emit(event.type === "agent_end" ? { ...event, willRetry: this._willRetryAfterAgentEnd(event) } : event);
+        this._emit(event.type === "agent_end"
+            ? { ...event, willRetry: this._willRetryAfterAgentEnd(event) }
+            : event);
         // Handle session persistence
         if (event.type === "message_end") {
             this._persistMessageEnd(event.message);
@@ -397,7 +422,8 @@ export class AgentSession {
             // Persist as CustomMessageEntry
             this.sessionManager.appendCustomMessageEntry(message.customType, message.content, message.display, message.details);
         }
-        else if ((message.role === "user" && !this._shouldSkipMessagePersistence(message)) ||
+        else if ((message.role === "user" &&
+            !this._shouldSkipMessagePersistence(message)) ||
             message.role === "assistant" ||
             message.role === "toolResult") {
             // Regular LLM message - persist as SessionMessageEntry
@@ -405,7 +431,8 @@ export class AgentSession {
         }
     }
     _handleUserMessageStart(messageText, message) {
-        const isInternalLengthContinuation = messageText === LENGTH_CONTINUATION_PROMPT && this._pendingInternalLengthContinuationMessages > 0;
+        const isInternalLengthContinuation = messageText === LENGTH_CONTINUATION_PROMPT &&
+            this._pendingInternalLengthContinuationMessages > 0;
         if (isInternalLengthContinuation) {
             this._pendingInternalLengthContinuationMessages--;
             this._internalLengthContinuationUserMessages.add(message);
@@ -483,7 +510,10 @@ export class AgentSession {
             await this._extensionRunner.emit({ type: "agent_start" });
         }
         else if (event.type === "agent_end") {
-            await this._extensionRunner.emit({ type: "agent_end", messages: event.messages });
+            await this._extensionRunner.emit({
+                type: "agent_end",
+                messages: event.messages,
+            });
         }
         else if (event.type === "turn_start") {
             const extensionEvent = {
@@ -755,7 +785,9 @@ export class AgentSession {
         }
         const loaderSystemPrompt = this._resourceLoader.getSystemPrompt();
         const loaderAppendSystemPrompt = this._resourceLoader.getAppendSystemPrompt();
-        const appendSystemPrompt = loaderAppendSystemPrompt.length > 0 ? loaderAppendSystemPrompt.join("\n\n") : undefined;
+        const appendSystemPrompt = loaderAppendSystemPrompt.length > 0
+            ? loaderAppendSystemPrompt.join("\n\n")
+            : undefined;
         const loadedSkills = this._resourceLoader.getSkills().skills;
         const loadedContextFiles = this._resourceLoader.getAgentsFiles().agentsFiles;
         this._baseSystemPromptOptions = {
@@ -843,9 +875,19 @@ export class AgentSession {
         }
         return await this._checkCompaction(msg);
     }
+    _shouldRequestTimeCompact(message) {
+        const policy = this._getCompactionPolicy();
+        if (!this._isAutoOlderHistoryCompactionEnabled(policy) || message.stopReason === "error")
+            return false;
+        const contextWindow = this.model?.contextWindow ?? 0;
+        if (!contextWindow)
+            return false;
+        return shouldCompact(calculateContextTokens(message.usage), contextWindow, this._getAutoOlderHistoryCompactionSettings(policy));
+    }
     _getCompactionPolicy() {
         const manager = this.settingsManager;
-        return manager.getCompactionPolicy?.() ?? normalizeCompactionPolicy(manager.getCompactionSettings());
+        return (manager.getCompactionPolicy?.() ??
+            normalizeCompactionPolicy(manager.getCompactionSettings()));
     }
     _shouldAutoContinueLengthStop(message) {
         if (message.stopReason !== "length")
@@ -878,7 +920,9 @@ export class AgentSession {
             this._lastLengthContinuationReason = undefined;
             return false;
         }
-        this._lastLengthContinuationReason = truncatedToolCall ? "truncated_tool_call" : undefined;
+        this._lastLengthContinuationReason = truncatedToolCall
+            ? "truncated_tool_call"
+            : undefined;
         return true;
     }
     _getAssistantOutputTokens(message) {
@@ -937,7 +981,9 @@ export class AgentSession {
             // All values empty/blank => the arguments were only partially emitted.
             return keys.every((key) => {
                 const value = args[key];
-                return value === undefined || value === null || (typeof value === "string" && value.trim() === "");
+                return (value === undefined ||
+                    value === null ||
+                    (typeof value === "string" && value.trim() === ""));
             });
         });
     }
@@ -994,7 +1040,9 @@ export class AgentSession {
             let expandedText = currentText;
             if (expandPromptTemplates) {
                 expandedText = this._expandSkillCommand(expandedText);
-                expandedText = expandPromptTemplate(expandedText, [...this.promptTemplates]);
+                expandedText = expandPromptTemplate(expandedText, [
+                    ...this.promptTemplates,
+                ]);
             }
             // If streaming, queue via steer() or followUp() based on option
             if (this.isStreaming) {
@@ -1027,7 +1075,20 @@ export class AgentSession {
             }
             // Check if we need to compact before sending (catches aborted responses)
             const lastAssistant = this._findLastAssistantMessage();
-            if (lastAssistant && (await this._checkCompaction(lastAssistant, false))) {
+            // This is the production request-time cut point: the previous agent run
+            // has ended, but the next request has not started. Snapshotting here is
+            // non-blocking and leaves overflow recovery on its existing path.
+            const requestTimeScheduled = lastAssistant !== undefined &&
+                lastAssistant.stopReason !== "aborted" &&
+                this._shouldRequestTimeCompact(lastAssistant);
+            if (requestTimeScheduled) {
+                this.requestTimeCompact({
+                    targetTurnId: this.sessionManager.getLeafId() ?? undefined,
+                });
+            }
+            if (lastAssistant &&
+                !requestTimeScheduled &&
+                (await this._checkCompaction(lastAssistant, false))) {
                 try {
                     await this.agent.continue();
                     while (await this._handlePostAgentRun()) {
@@ -1041,7 +1102,9 @@ export class AgentSession {
             // Build messages array (custom message if any, then user message)
             messages = [];
             // Add user message
-            const userContent = [{ type: "text", text: expandedText }];
+            const userContent = [
+                { type: "text", text: expandedText },
+            ];
             if (currentImages) {
                 userContent.push(...currentImages);
             }
@@ -1127,7 +1190,9 @@ export class AgentSession {
         const spaceIndex = text.indexOf(" ");
         const skillName = spaceIndex === -1 ? text.slice(7) : text.slice(7, spaceIndex);
         const args = spaceIndex === -1 ? "" : text.slice(spaceIndex + 1).trim();
-        const skill = this.resourceLoader.getSkills().skills.find((s) => s.name === skillName);
+        const skill = this.resourceLoader
+            .getSkills()
+            .skills.find((s) => s.name === skillName);
         if (!skill)
             return text; // Unknown skill, pass through
         try {
@@ -1161,7 +1226,9 @@ export class AgentSession {
         }
         // Expand skill commands and prompt templates
         let expandedText = this._expandSkillCommand(text);
-        expandedText = expandPromptTemplate(expandedText, [...this.promptTemplates]);
+        expandedText = expandPromptTemplate(expandedText, [
+            ...this.promptTemplates,
+        ]);
         await this._queueSteer(expandedText, images);
     }
     /**
@@ -1178,7 +1245,9 @@ export class AgentSession {
         }
         // Expand skill commands and prompt templates
         let expandedText = this._expandSkillCommand(text);
-        expandedText = expandPromptTemplate(expandedText, [...this.promptTemplates]);
+        expandedText = expandPromptTemplate(expandedText, [
+            ...this.promptTemplates,
+        ]);
         await this._queueFollowUp(expandedText, images);
     }
     /**
@@ -1392,7 +1461,9 @@ export class AgentSession {
         if (currentIndex === -1)
             currentIndex = 0;
         const len = scopedModels.length;
-        const nextIndex = direction === "forward" ? (currentIndex + 1) % len : (currentIndex - 1 + len) % len;
+        const nextIndex = direction === "forward"
+            ? (currentIndex + 1) % len
+            : (currentIndex - 1 + len) % len;
         const next = scopedModels[nextIndex];
         const thinkingLevel = this._getThinkingLevelForModelSwitch(next.thinkingLevel);
         // Apply model
@@ -1405,7 +1476,11 @@ export class AgentSession {
         // setThinkingLevel clamps to model capabilities.
         this.setThinkingLevel(thinkingLevel);
         await this._emitModelSelect(next.model, currentModel, "cycle");
-        return { model: next.model, thinkingLevel: this.thinkingLevel, isScoped: true };
+        return {
+            model: next.model,
+            thinkingLevel: this.thinkingLevel,
+            isScoped: true,
+        };
     }
     async _cycleAvailableModel(direction) {
         const availableModels = await this._modelRegistry.getAvailable();
@@ -1416,7 +1491,9 @@ export class AgentSession {
         if (currentIndex === -1)
             currentIndex = 0;
         const len = availableModels.length;
-        const nextIndex = direction === "forward" ? (currentIndex + 1) % len : (currentIndex - 1 + len) % len;
+        const nextIndex = direction === "forward"
+            ? (currentIndex + 1) % len
+            : (currentIndex - 1 + len) % len;
         const nextModel = availableModels[nextIndex];
         const thinkingLevel = this._getThinkingLevelForModelSwitch();
         this.agent.state.model = nextModel;
@@ -1425,7 +1502,11 @@ export class AgentSession {
         // Re-clamp thinking level for new model's capabilities
         this.setThinkingLevel(thinkingLevel);
         await this._emitModelSelect(nextModel, currentModel, "cycle");
-        return { model: nextModel, thinkingLevel: this.thinkingLevel, isScoped: false };
+        return {
+            model: nextModel,
+            thinkingLevel: this.thinkingLevel,
+            isScoped: false,
+        };
     }
     // =========================================================================
     // Thinking Level Management
@@ -1437,7 +1518,9 @@ export class AgentSession {
      */
     setThinkingLevel(level) {
         const availableLevels = this.getAvailableThinkingLevels();
-        const effectiveLevel = availableLevels.includes(level) ? level : this._clampThinkingLevel(level, availableLevels);
+        const effectiveLevel = availableLevels.includes(level)
+            ? level
+            : this._clampThinkingLevel(level, availableLevels);
         // Only persist if actually changing
         const previousLevel = this.agent.state.thinkingLevel;
         const isChanging = effectiveLevel !== previousLevel;
@@ -1489,12 +1572,14 @@ export class AgentSession {
             return explicitLevel;
         }
         if (!this.supportsThinking()) {
-            return this.settingsManager.getDefaultThinkingLevel() ?? DEFAULT_THINKING_LEVEL;
+            return (this.settingsManager.getDefaultThinkingLevel() ?? DEFAULT_THINKING_LEVEL);
         }
         return this.thinkingLevel;
     }
     _clampThinkingLevel(level, _availableLevels) {
-        return this.model ? clampThinkingLevel(this.model, level) : "off";
+        return this.model
+            ? clampThinkingLevel(this.model, level)
+            : "off";
     }
     // =========================================================================
     // Queue Mode Management
@@ -1549,6 +1634,149 @@ export class AgentSession {
     _buildDcpCompactionResult(preparation, extensionCompaction) {
         return preserveDcpHookMemoryDetails(compactDcpLite(preparation), extensionCompaction);
     }
+    /**
+     * Schedule a durable request-time overlay. Snapshot and commit are short,
+     * synchronous sections; summary generation never holds the normal compaction
+     * lock and therefore cannot delay the next provider request.
+     */
+    requestTimeCompact(options = {}) {
+        const snapshot = this.sessionManager.createRequestTimeSnapshot(options.targetTurnId);
+        const previous = this._requestTimeJobs.get(snapshot.compactionId);
+        if (previous)
+            return previous;
+        const job = { snapshot, status: "pending" };
+        this._requestTimeJobs.set(snapshot.compactionId, job);
+        this.sessionManager.persistRequestTimeCompactionJob(job);
+        const controller = new AbortController();
+        this._requestTimeControllers.set(snapshot.compactionId, controller);
+        if (options.signal) {
+            if (options.signal.aborted)
+                controller.abort();
+            else
+                options.signal.addEventListener("abort", () => controller.abort(), {
+                    once: true,
+                });
+        }
+        void this._runRequestTimeCompaction(job, controller).catch(() => undefined);
+        return job;
+    }
+    async _runRequestTimeCompaction(job, controller) {
+        job.status = "running";
+        this.sessionManager.persistRequestTimeCompactionJob(job);
+        try {
+            if (controller.signal.aborted) {
+                job.status = "aborted";
+                return;
+            }
+            const settings = this._getAutoOlderHistoryCompactionSettings(this._getCompactionPolicy());
+            const entries = job.snapshot.entries;
+            const preparation = prepareCompaction(entries, settings, {
+                phaseBoundary: false,
+            });
+            if (!preparation) {
+                job.status = "failed";
+                return;
+            }
+            // DCP-lite is deterministic and safe to execute away from the session
+            // lock. Hook observations, when registered, are folded into details.
+            let hook;
+            let lastError;
+            for (let attempt = 0; attempt < 3; attempt++) {
+                if (controller.signal.aborted) {
+                    job.status = "aborted";
+                    this.sessionManager.persistRequestTimeCompactionJob(job);
+                    return;
+                }
+                try {
+                    hook = await this._emitSessionBeforeCompact(preparation, entries, undefined, controller.signal, () => undefined);
+                    lastError = undefined;
+                    break;
+                }
+                catch (error) {
+                    lastError = error;
+                    if (!this._isRequestTimeRetryable(error) || attempt === 2)
+                        break;
+                    await sleep(50 * 2 ** attempt, controller.signal);
+                }
+            }
+            if (lastError !== undefined)
+                throw lastError;
+            if (controller.signal.aborted) {
+                job.status = "aborted";
+                return;
+            }
+            const result = this._buildDcpCompactionResult(preparation, hook?.cancel ? undefined : hook?.compaction);
+            if (this._markIfNonShrinking(result)) {
+                job.status = "failed";
+                return;
+            }
+            const llmSettings = this.settingsManager.getLlmCompactionSettings();
+            const persistedObservations = entries
+                .filter((entry) => entry.type === "compaction")
+                .flatMap((entry) => this._extractCompactionObservations(entry.details));
+            const durableObservations = mergeCompactionObservations(persistedObservations, this._extractCompactionObservations(hook?.compaction?.details));
+            const finalResult = await enrichDcpCompaction(result, durableObservations, llmSettings, async () => {
+                try {
+                    const configured = llmSettings.provider && llmSettings.modelId
+                        ? this._modelRegistry.find(llmSettings.provider, llmSettings.modelId)
+                        : this.model;
+                    if (!configured)
+                        return undefined;
+                    const auth = await this._modelRegistry.getApiKeyAndHeaders(configured);
+                    return auth.ok && auth.apiKey ? { model: configured, apiKey: auth.apiKey, headers: auth.headers } : undefined;
+                }
+                catch {
+                    return undefined;
+                }
+            }, controller.signal);
+            const committed = this.sessionManager.commitRequestTimeCompaction(job.snapshot, finalResult);
+            job.status = committed.status === "stale" ? "stale" : "committed";
+            this.sessionManager.persistRequestTimeCompactionJob(job);
+            if (committed.status === "committed") {
+                // Refresh provider state only after the durable entry exists. UI callers
+                // continue to use getFullHistory(), which remains append-only.
+                this.agent.state.messages =
+                    this.sessionManager.buildSessionContext().messages;
+            }
+        }
+        catch (error) {
+            job.status =
+                controller.signal.aborted ||
+                    (error instanceof Error && error.name === "AbortError")
+                    ? "aborted"
+                    : "failed";
+            this.sessionManager.persistRequestTimeCompactionJob(job);
+        }
+        finally {
+            this._requestTimeControllers.delete(job.snapshot.compactionId);
+        }
+    }
+    _extractCompactionObservations(details) {
+        if (!isRecord(details) || !Array.isArray(details.observations))
+            return [];
+        return details.observations.filter((item) => isRecord(item) && typeof item.content === "string").map((item) => ({
+            id: typeof item.id === "string" ? item.id : undefined,
+            content: item.content,
+            relevance: typeof item.relevance === "string" ? item.relevance : undefined,
+            sourceEntryIds: Array.isArray(item.sourceEntryIds) ? item.sourceEntryIds.filter((id) => typeof id === "string") : undefined,
+        }));
+    }
+    _isRequestTimeRetryable(error) {
+        if (error instanceof Error && error.name === "AbortError")
+            return false;
+        const text = error instanceof Error ? error.message : String(error);
+        return /timeout|temporar|network|rate.?limit|429|500|502|503|504|overload/i.test(text);
+    }
+    abortRequestTimeCompaction(compactionId) {
+        const controller = this._requestTimeControllers.get(compactionId);
+        if (!controller)
+            return false;
+        controller.abort();
+        return true;
+    }
+    getRequestTimeCompaction(compactionId) {
+        return this._requestTimeJobs.get(compactionId);
+    }
     _emitCompactionResultSummary(result) {
         if (result.summary) {
             this._emit({
@@ -1560,7 +1788,9 @@ export class AgentSession {
     }
     _markIfNonShrinking(result) {
         const message = getNonShrinkingSkipMessage(result);
-        return message ? markCompactionSkipped(result, "non_shrinking", message) : undefined;
+        return message
+            ? markCompactionSkipped(result, "non_shrinking", message)
+            : undefined;
     }
     async _emitSessionBeforeCompact(preparation, branchEntries, customInstructions, signal, emitProgress) {
         const runner = this._extensionRunner;
@@ -1579,7 +1809,7 @@ export class AgentSession {
      * Execute a manual compaction under the compaction lock.
      */
     async _executeCompaction(options) {
-        const { customInstructions, phaseBoundary, keepRecentTokens, memoryHookMode } = normalizeManualCompactionOptions(options);
+        const { customInstructions, phaseBoundary, keepRecentTokens, memoryHookMode, } = normalizeManualCompactionOptions(options);
         this._disconnectFromAgent();
         await this.abort();
         this._compactionAbortController = new AbortController();
@@ -1588,14 +1818,23 @@ export class AgentSession {
             let pathEntries = this.sessionManager.getBranch();
             const policy = this._getCompactionPolicy();
             let settings = getManualCompactionSettings(policy.conversation, policy.manual);
-            if (typeof keepRecentTokens === "number" && Number.isFinite(keepRecentTokens) && keepRecentTokens > 0) {
+            if (typeof keepRecentTokens === "number" &&
+                Number.isFinite(keepRecentTokens) &&
+                keepRecentTokens > 0) {
                 const normalizedKeepRecentTokens = normalizeManualKeepRecentTokens(keepRecentTokens, policy.manual);
                 if (normalizedKeepRecentTokens > 0) {
-                    settings = { ...settings, keepRecentTokens: normalizedKeepRecentTokens };
+                    settings = {
+                        ...settings,
+                        keepRecentTokens: normalizedKeepRecentTokens,
+                    };
                 }
             }
-            if (phaseBoundary && !isDcpLitePhaseBoundaryEntry(pathEntries[pathEntries.length - 1])) {
-                const preflightEntries = [...pathEntries, createVirtualPhaseBoundaryEntry(pathEntries)];
+            if (phaseBoundary &&
+                !isDcpLitePhaseBoundaryEntry(pathEntries[pathEntries.length - 1])) {
+                const preflightEntries = [
+                    ...pathEntries,
+                    createVirtualPhaseBoundaryEntry(pathEntries),
+                ];
                 const preflightPreparation = prepareCompaction(preflightEntries, settings, { phaseBoundary: true });
                 if (!preflightPreparation) {
                     const lastEntry = pathEntries[pathEntries.length - 1];
@@ -1626,7 +1865,9 @@ export class AgentSession {
                 });
                 pathEntries = this.sessionManager.getBranch();
             }
-            const preparation = prepareCompaction(pathEntries, settings, { phaseBoundary });
+            const preparation = prepareCompaction(pathEntries, settings, {
+                phaseBoundary,
+            });
             if (!preparation) {
                 // Check why we can't compact
                 const lastEntry = pathEntries[pathEntries.length - 1];
@@ -1641,7 +1882,8 @@ export class AgentSession {
                 const emitExtensionProgress = (delta, content) => {
                     if (!delta && !content)
                         return;
-                    extensionProgressContent = content ?? `${extensionProgressContent}${delta}`;
+                    extensionProgressContent =
+                        content ?? `${extensionProgressContent}${delta}`;
                     this._emit({
                         type: "compaction_delta",
                         delta,
@@ -1698,7 +1940,8 @@ export class AgentSession {
         }
         catch (error) {
             const message = error instanceof Error ? error.message : String(error);
-            const aborted = message === "Compaction cancelled" || (error instanceof Error && error.name === "AbortError");
+            const aborted = message === "Compaction cancelled" ||
+                (error instanceof Error && error.name === "AbortError");
             this._emit({
                 type: "compaction_end",
                 reason: "manual",
@@ -1750,12 +1993,16 @@ export class AgentSession {
         // This handles the case where user switched from a smaller-context model (e.g. opus)
         // to a larger-context model (e.g. codex) - the overflow error from the old model
         // shouldn't trigger compaction for the new model.
-        const sameModel = this.model && assistantMessage.provider === this.model.provider && assistantMessage.model === this.model.id;
+        const sameModel = this.model &&
+            assistantMessage.provider === this.model.provider &&
+            assistantMessage.model === this.model.id;
         // Skip compaction checks if this assistant message is older than the latest
         // compaction boundary. This prevents a stale pre-compaction usage/error
         // from retriggering compaction on the first prompt after compaction.
         const compactionEntry = getLatestCompactionEntry(this.sessionManager.getBranch());
-        const assistantIsFromBeforeCompaction = compactionEntry !== null && assistantMessage.timestamp <= new Date(compactionEntry.timestamp).getTime();
+        const assistantIsFromBeforeCompaction = compactionEntry !== null &&
+            assistantMessage.timestamp <=
+                new Date(compactionEntry.timestamp).getTime();
         if (assistantIsFromBeforeCompaction) {
             return false;
         }
@@ -1776,7 +2023,8 @@ export class AgentSession {
             // Remove the error message from agent state (it IS saved to session for history,
             // but we don't want it in context for the retry)
             const messages = this.agent.state.messages;
-            if (messages.length > 0 && messages[messages.length - 1].role === "assistant") {
+            if (messages.length > 0 &&
+                messages[messages.length - 1].role === "assistant") {
                 this.agent.state.messages = messages.slice(0, -1);
             }
             return await this._runAutoCompaction("overflow", true);
@@ -1796,7 +2044,8 @@ export class AgentSession {
             const usageMsg = messages[estimate.lastUsageIndex];
             if (compactionEntry &&
                 usageMsg.role === "assistant" &&
-                usageMsg.timestamp <= new Date(compactionEntry.timestamp).getTime()) {
+                usageMsg.timestamp <=
+                    new Date(compactionEntry.timestamp).getTime()) {
                 return false;
             }
             contextTokens = estimate.tokens;
@@ -1832,7 +2081,8 @@ export class AgentSession {
         if (!this._isAutoOlderHistoryCompactionEnabled(policy)) {
             return false;
         }
-        if (reason === "threshold" && this._autoOlderHistoryCooldownTurnsRemaining > 0) {
+        if (reason === "threshold" &&
+            this._autoOlderHistoryCooldownTurnsRemaining > 0) {
             return false;
         }
         if (this._compactionInProgress) {
@@ -1851,7 +2101,9 @@ export class AgentSession {
         this._autoCompactionAbortController = new AbortController();
         try {
             const pathEntries = this.sessionManager.getBranch();
-            const preparation = prepareCompaction(pathEntries, settings, { phaseBoundary: false });
+            const preparation = prepareCompaction(pathEntries, settings, {
+                phaseBoundary: false,
+            });
             if (!preparation) {
                 this._emit({
                     type: "compaction_end",
@@ -1864,8 +2116,10 @@ export class AgentSession {
             }
             const compactableTokens = estimateCompactionTokenMetrics(preparation, "").tokensCompacted ?? 0;
             if (compactableTokens < policy.autoOlderHistory.minRawTokens) {
-                this._lastAutoOlderHistorySkipSignature = this._autoOlderHistorySkipSignature(pathEntries, compactableTokens);
-                this._autoOlderHistoryCooldownTurnsRemaining = policy.autoOlderHistory.cooldownTurns;
+                this._lastAutoOlderHistorySkipSignature =
+                    this._autoOlderHistorySkipSignature(pathEntries, compactableTokens);
+                this._autoOlderHistoryCooldownTurnsRemaining =
+                    policy.autoOlderHistory.cooldownTurns;
                 this._emit({
                     type: "compaction_end",
                     reason,
@@ -1878,8 +2132,10 @@ export class AgentSession {
                 return false;
             }
             const skipSignature = this._autoOlderHistorySkipSignature(pathEntries, compactableTokens);
-            if (reason === "threshold" && this._lastAutoOlderHistorySkipSignature === skipSignature) {
-                this._autoOlderHistoryCooldownTurnsRemaining = policy.autoOlderHistory.cooldownTurns;
+            if (reason === "threshold" &&
+                this._lastAutoOlderHistorySkipSignature === skipSignature) {
+                this._autoOlderHistoryCooldownTurnsRemaining =
+                    policy.autoOlderHistory.cooldownTurns;
                 this._emit({
                     type: "compaction_end",
                     reason,
@@ -1894,7 +2150,8 @@ export class AgentSession {
             const emitExtensionProgress = (delta, content) => {
                 if (!delta && !content)
                     return;
-                extensionProgressContent = content ?? `${extensionProgressContent}${delta}`;
+                extensionProgressContent =
+                    content ?? `${extensionProgressContent}${delta}`;
                 this._emit({
                     type: "compaction_delta",
                     delta,
@@ -1902,7 +2159,9 @@ export class AgentSession {
                 });
             };
             const beforeCompactResult = await this._emitSessionBeforeCompact(preparation, pathEntries, undefined, this._autoCompactionAbortController.signal, emitExtensionProgress);
-            const extensionCompaction = beforeCompactResult?.cancel ? undefined : beforeCompactResult?.compaction;
+            const extensionCompaction = beforeCompactResult?.cancel
+                ? undefined
+                : beforeCompactResult?.compaction;
             const compactResult = this._buildDcpCompactionResult(preparation, extensionCompaction);
             if (this._autoCompactionAbortController.signal.aborted) {
                 this._emit({
@@ -1917,7 +2176,8 @@ export class AgentSession {
             const skippedResult = this._markIfNonShrinking(compactResult);
             if (skippedResult) {
                 this._lastAutoOlderHistorySkipSignature = skipSignature;
-                this._autoOlderHistoryCooldownTurnsRemaining = policy.autoOlderHistory.cooldownTurns;
+                this._autoOlderHistoryCooldownTurnsRemaining =
+                    policy.autoOlderHistory.cooldownTurns;
                 this._emit({
                     type: "compaction_end",
                     reason,
@@ -1931,7 +2191,8 @@ export class AgentSession {
                 return false;
             }
             this._lastAutoOlderHistorySkipSignature = undefined;
-            this._autoOlderHistoryCooldownTurnsRemaining = policy.autoOlderHistory.cooldownTurns;
+            this._autoOlderHistoryCooldownTurnsRemaining =
+                policy.autoOlderHistory.cooldownTurns;
             this._emitCompactionResultSummary(compactResult);
             const { summary, firstKeptEntryId, tokensBefore, details } = compactResult;
             this.sessionManager.appendCompaction(summary, firstKeptEntryId, tokensBefore, details, false);
@@ -1948,11 +2209,18 @@ export class AgentSession {
                 });
             }
             const result = { ...compactResult, details };
-            this._emit({ type: "compaction_end", reason, result, aborted: false, willRetry });
+            this._emit({
+                type: "compaction_end",
+                reason,
+                result,
+                aborted: false,
+                willRetry,
+            });
             if (willRetry) {
                 const messages = this.agent.state.messages;
                 const lastMsg = messages[messages.length - 1];
-                if (lastMsg?.role === "assistant" && lastMsg.stopReason === "error") {
+                if (lastMsg?.role === "assistant" &&
+                    lastMsg.stopReason === "error") {
                     this.agent.state.messages = messages.slice(0, -1);
                 }
                 return true;
@@ -2015,7 +2283,9 @@ export class AgentSession {
             return;
         }
         const { skillPaths, promptPaths, themePaths } = await this._extensionRunner.emitResourcesDiscover(this._cwd, reason);
-        if (skillPaths.length === 0 && promptPaths.length === 0 && themePaths.length === 0) {
+        if (skillPaths.length === 0 &&
+            promptPaths.length === 0 &&
+            themePaths.length === 0) {
             return;
         }
         const extensionPaths = {
@@ -2030,7 +2300,9 @@ export class AgentSession {
     buildExtensionResourcePaths(entries) {
         return entries.map((entry) => {
             const source = this.getExtensionSourceLabel(entry.extensionPath);
-            const baseDir = entry.extensionPath.startsWith("<") ? undefined : dirname(entry.extensionPath);
+            const baseDir = entry.extensionPath.startsWith("<")
+                ? undefined
+                : dirname(entry.extensionPath);
             return {
                 path: entry.path,
                 metadata: {
@@ -2071,7 +2343,9 @@ export class AgentSession {
     }
     _bindExtensionCore(runner) {
         const getCommands = () => {
-            const extensionCommands = runner.getRegisteredCommands().map((command) => ({
+            const extensionCommands = runner
+                .getRegisteredCommands()
+                .map((command) => ({
                 name: command.invocationName,
                 description: command.description,
                 source: "extension",
@@ -2083,7 +2357,9 @@ export class AgentSession {
                 source: "prompt",
                 sourceInfo: template.sourceInfo,
             }));
-            const skills = this._resourceLoader.getSkills().skills.map((skill) => ({
+            const skills = this._resourceLoader
+                .getSkills()
+                .skills.map((skill) => ({
                 name: `skill:${skill.name}`,
                 description: skill.description,
                 source: "skill",
@@ -2192,7 +2468,9 @@ export class AgentSession {
             ...registeredTools,
             ...this._customTools.map((definition) => ({
                 definition,
-                sourceInfo: createSyntheticSourceInfo(`<sdk:${definition.name}>`, { source: "sdk" }),
+                sourceInfo: createSyntheticSourceInfo(`<sdk:${definition.name}>`, {
+                    source: "sdk",
+                }),
             })),
         ].filter((tool) => isAllowedTool(tool.definition.name));
         const definitionRegistry = new Map(Array.from(this._baseToolDefinitions.entries())
@@ -2201,7 +2479,9 @@ export class AgentSession {
             name,
             {
                 definition,
-                sourceInfo: createSyntheticSourceInfo(`<builtin:${name}>`, { source: "builtin" }),
+                sourceInfo: createSyntheticSourceInfo(`<builtin:${name}>`, {
+                    source: "builtin",
+                }),
             },
         ]));
         for (const tool of allCustomTools) {
@@ -2220,7 +2500,9 @@ export class AgentSession {
         this._toolPromptGuidelines = new Map(Array.from(definitionRegistry.values())
             .map(({ definition }) => {
             const guidelines = this._normalizePromptGuidelines(definition.promptGuidelines);
-            return guidelines.length > 0 ? [definition.name, guidelines] : undefined;
+            return guidelines.length > 0
+                ? [definition.name, guidelines]
+                : undefined;
         })
             .filter((entry) => entry !== undefined));
         const runner = this._extensionRunner;
@@ -2236,7 +2518,9 @@ export class AgentSession {
             toolRegistry.set(tool.name, tool);
         }
         this._toolRegistry = toolRegistry;
-        const nextActiveToolNames = (options?.activeToolNames ? [...options.activeToolNames] : [...previousActiveToolNames]).filter((name) => isAllowedTool(name));
+        const nextActiveToolNames = (options?.activeToolNames
+            ? [...options.activeToolNames]
+            : [...previousActiveToolNames]).filter((name) => isAllowedTool(name));
         if (allowedToolNames) {
             for (const toolName of this._toolRegistry.keys()) {
                 if (allowedToolNames.has(toolName)) {
@@ -2271,7 +2555,10 @@ export class AgentSession {
                 read: { autoResizeImages },
                 bash: { commandPrefix: shellCommandPrefix, shellPath },
             });
-        this._baseToolDefinitions = new Map(Object.entries(baseToolDefinitions).map(([name, tool]) => [name, tool]));
+        this._baseToolDefinitions = new Map(Object.entries(baseToolDefinitions).map(([name, tool]) => [
+            name,
+            tool,
+        ]));
         const extensionsResult = this._resourceLoader.getExtensions();
         if (options.flagValues) {
             for (const [name, value] of options.flagValues) {
@@ -2295,7 +2582,10 @@ export class AgentSession {
     }
     async reload() {
         const previousFlagValues = this._extensionRunner.getFlagValues();
-        await emitSessionShutdownEvent(this._extensionRunner, { type: "session_shutdown", reason: "reload" });
+        await emitSessionShutdownEvent(this._extensionRunner, {
+            type: "session_shutdown",
+            reason: "reload",
+        });
         await this.settingsManager.reload();
         resetApiProviders();
         await this._resourceLoader.reload();
@@ -2309,7 +2599,10 @@ export class AgentSession {
             this._extensionShutdownHandler ||
             this._extensionErrorListener;
         if (hasBindings) {
-            await this._extensionRunner.emit({ type: "session_start", reason: "reload" });
+            await this._extensionRunner.emit({
+                type: "session_start",
+                reason: "reload",
+            });
             await this.extendResourcesFromExtensions("reload");
         }
     }
@@ -2329,7 +2622,7 @@ export class AgentSession {
             return false;
         const err = message.errorMessage;
         // Match: overloaded_error, provider returned error, rate limit, 429, 500, 502, 503, 504, service unavailable, network/connection errors (including connection lost), WebSocket transport closes/errors, fetch failed, premature stream endings, HTTP/2 closed before response, terminated, retry delay exceeded
-        return /overloaded|provider.?returned.?error|rate.?limit|too many requests|429|500|502|503|504|service.?unavailable|server.?error|internal.?error|network.?error|connection.?error|connection.?refused|connection.?lost|websocket.?closed|websocket.?error|other side closed|fetch failed|upstream.?connect|reset before headers|socket hang up|ended without|stream ended before message_stop|http2 request did not get a response|timed? out|timeout|terminated|retry delay/i.test(err);
+        return /overloaded|provider.?returned.?error|rate.?limit|too many requests|429|500|502|503|504|service.?unavailable|server.?error|internal.?error|network.?error|connection.?error|connection.?refused|connection.?lost|connection.?closed|connection.?reset|websocket.?closed|websocket.?error|other side closed|socket connection was closed|fetch failed|upstream.?connect|reset before headers|socket hang up|ended without|stream ended before message_stop|http2 request did not get a response|timed? out|timeout|terminated|retry delay/i.test(err);
     }
     /**
      * Prepare a retryable error for continuation with exponential backoff.
@@ -2356,7 +2649,8 @@ export class AgentSession {
         });
         // Remove error message from agent state (keep in session for history)
         const messages = this.agent.state.messages;
-        if (messages.length > 0 && messages[messages.length - 1].role === "assistant") {
+        if (messages.length > 0 &&
+            messages[messages.length - 1].role === "assistant") {
             this.agent.state.messages = messages.slice(0, -1);
         }
         // Wait with exponential backoff (abortable)
@@ -2495,7 +2789,10 @@ export class AgentSession {
      */
     setSessionName(name) {
         this.sessionManager.appendSessionInfo(name);
-        this._emit({ type: "session_info_changed", name: this.sessionManager.getSessionName() });
+        this._emit({
+            type: "session_info_changed",
+            name: this.sessionManager.getSessionName(),
+        });
     }
     // =========================================================================
     // Tree Navigation
@@ -2574,7 +2871,9 @@ export class AgentSession {
             // Run default summarizer if needed
             let summaryText;
             let summaryDetails;
-            if (options.summarize && entriesToSummarize.length > 0 && !extensionSummary) {
+            if (options.summarize &&
+                entriesToSummarize.length > 0 &&
+                !extensionSummary) {
                 const model = this.model;
                 const { apiKey, headers } = await this._getRequiredRequestAuth(model);
                 const branchSummarySettings = this.settingsManager.getBranchSummarySettings();
@@ -2606,7 +2905,8 @@ export class AgentSession {
             // Determine the new leaf position based on target type
             let newLeafId;
             let editorText;
-            if (targetEntry.type === "message" && targetEntry.message.role === "user") {
+            if (targetEntry.type === "message" &&
+                targetEntry.message.role === "user") {
                 // User message: leaf = parent (null if root), text goes to editor
                 newLeafId = targetEntry.parentId;
                 editorText = this._extractUserMessageText(targetEntry.message.content);
@@ -2761,7 +3061,8 @@ export class AgentSession {
                 const entry = branchEntries[i];
                 if (entry.type === "message" && entry.message.role === "assistant") {
                     const assistant = entry.message;
-                    if (assistant.stopReason !== "aborted" && assistant.stopReason !== "error") {
+                    if (assistant.stopReason !== "aborted" &&
+                        assistant.stopReason !== "error") {
                         const contextTokens = calculateContextTokens(assistant.usage);
                         if (contextTokens > 0) {
                             hasPostCompactionUsage = true;
@@ -2797,7 +3098,8 @@ export class AgentSession {
      * @returns The resolved output file path.
      */
     exportToJsonl(outputPath) {
-        const filePath = resolvePath(outputPath ?? `session-${new Date().toISOString().replace(/[:.]/g, "-")}.jsonl`, process.cwd());
+        const filePath = resolvePath(outputPath ??
+            `session-${new Date().toISOString().replace(/[:.]/g, "-")}.jsonl`, process.cwd());
         const dir = dirname(filePath);
         if (!existsSync(dir)) {
             mkdirSync(dir, { recursive: true });