praxis-agent 0.33.0 → 0.35.0

package/dist/application/session-service.js

@@ -6,6 +6,7 @@ import { isPathWithin } from '../platform/path-containment.js';
 import { AGENT_COLOR_DEFAULT, agentColorMessage, getClaudeEffectiveAgentColor, } from '../compatibility/claude/agent-color.js';
 import { createClaudeCompactEntries, formatClaudeCompactSummary, getCumulativeDroppedTokens, } from '../compatibility/claude/compaction.js';
 import { discoverClaudeProjectRoot, isClaudeSessionId, resolveClaudePaths, resolveClaudeScheduledTaskFile, } from '../compatibility/claude/paths.js';
+import { isClaudeAgentId } from '../compatibility/claude/sidechain.js';
 import { resolveDataPlanePaths, resolveScheduledTaskFile, } from '../persistence/data-plane.js';
 import { downloadClaudeFileResources, } from '../compatibility/claude/file-resources.js';
 import { createClaudeNativeFork } from '../compatibility/claude/fork.js';
@@ -20,17 +21,21 @@ import { createClaudeAgentSettingEntry, createClaudeHookAttachmentEntries, creat
 import { AgentRunCancelledError, AgentRuntime, ModelProviderError, } from '../core/runtime.js';
 import { resolveToolSchedulingPolicy } from '../core/tool-scheduling-policy.js';
 import { BackgroundTaskRuntime, } from './background-task-runtime.js';
+import { backgroundAgentNotificationMarkers, } from './background-agent-manager.js';
 import { usageCostUsd } from '../core/usage.js';
 import { ContextBudget, ContextRecoveryPlanner, contextRecoveryMadeProgress, estimateModelRequestTokens, isPromptTooLongError, } from '../core/context-budget.js';
-import { injectFirstUserMessageContext, } from '../core/context.js';
+import { injectFirstUserMessageContext, projectContextSnapshot, } from '../core/context.js';
+import { assembleContextSnapshot } from '../core/prompt-composer.js';
 import { ClaudeHookToolCoordinator } from '../hooks/claude-hook-tools.js';
 import { ClaudeFileChangeWatcher } from '../hooks/claude-file-change-watcher.js';
 import { ClaudeTranscriptStore, } from '../persistence/claude-transcript-store.js';
 import { ClaudeSessionIndexCandidateError, readClaudeSessionIndexes, } from '../persistence/claude-session-index.js';
 import { InMemoryTranscriptStore } from '../persistence/in-memory-transcript-store.js';
+import { SubagentLifecycleStore } from '../persistence/subagent-lifecycle-store.js';
 import { ModelCompactor } from './model-compactor.js';
 import { agentMemoryPrompt, ClaudeSubagentExecutor, StructuredOutputRegistry, } from './subagent-service.js';
 import { ScheduledPromptManager, } from './scheduled-prompt-manager.js';
+import { TurnTerminalController } from './turn-lifecycle.js';
 import { ClaudeScheduledToolRegistry } from '../tools/claude-scheduled-tools.js';
 import { ClaudeTaskToolRegistry } from '../tools/claude-task-tools.js';
 import { ClaudeWorkflowToolRegistry } from '../tools/claude-workflow-tools.js';
@@ -43,7 +48,7 @@ import { SessionMemoryController, SessionMemoryStateError, SessionMemoryStore, }
 import { FilteredToolRegistry } from '../tools/filtered-tool-registry.js';
 import { ClaudeCapabilityToolRegistry, resolveClaudeToolCapabilities, } from '../tools/claude-capabilities.js';
 import { generateToolUseSummary } from './tool-use-summary.js';
-import { ClaudeUserMessageToolRegistry, CLAUDE_USER_MESSAGE_PROMPT, } from '../tools/claude-user-message.js';
+import { ClaudeUserMessageToolRegistry, } from '../tools/claude-user-message.js';
 function agentPermissionMode(mode) {
     return mode === undefined || mode === 'manual' ? 'default' : mode;
 }
@@ -51,6 +56,15 @@ function agentToolName(rule) {
     const opening = rule.indexOf('(');
     return (opening < 0 ? rule : rule.slice(0, opening)).trim();
 }
+function transcriptContainsBackgroundAgentNotification(entries, notification) {
+    const markers = backgroundAgentNotificationMarkers(notification);
+    return entries.some((entry) => {
+        if (entry.type !== 'user')
+            return false;
+        const source = JSON.stringify(entry.message);
+        return markers.every((marker) => source.includes(marker));
+    });
+}
 function mainAgentToolNames(tools, agent) {
     const requested = agent.tools ? new Set(agent.tools.map(agentToolName)) : null;
     if (requested && agent.memory) {
@@ -636,8 +650,14 @@ export class ClaudeSessionService {
     explicitResumeLeafUuids = new Map();
     sessionPermissionUpdates = new Map();
     hostedSubagents = new Set();
+    subagentExecutors = new Set();
     hostedSubagentsByRegistry = new WeakMap();
+    subagentExecutorSessions = new WeakMap();
+    hostedSubagentNotificationPumps = new WeakMap();
+    hostedSubagentPumpPromises = new Set();
+    hostedSubagentNotificationReservations = new WeakSet();
     backgroundNotificationWrites = new Map();
+    closing = false;
     downloadedFileResourceSessions = new Set();
     detachedHookRuns = new Map();
     activeProvider;
@@ -795,6 +815,56 @@ export class ClaudeSessionService {
     stopTask(sessionId, taskId) {
         return this.backgroundTasks.stop(sessionId, taskId);
     }
+    backgroundForegroundTask(sessionId) {
+        return this.backgroundTasks.backgroundForeground(sessionId);
+    }
+    sendOwnedBackgroundAgent(sessionId, agentId, message, summary, toolUseId) {
+        const sent = this.backgroundTasks.sendAgentWithOwner(sessionId, agentId, message, summary, toolUseId);
+        if (!sent)
+            return null;
+        const hosted = [...this.hostedSubagents].find((executor) => executor === sent.owner);
+        if (hosted)
+            this.startHostedSubagentNotificationPump(sessionId, hosted);
+        return sent.content;
+    }
+    sessionSubagentExecutors(sessionId, includeHosted = false) {
+        return [...this.subagentExecutors].filter((executor) => this.subagentExecutorSessions.get(executor) === sessionId &&
+            (includeHosted ||
+                (!this.hostedSubagentNotificationPumps.has(executor) &&
+                    !this.hostedSubagentNotificationReservations.has(executor))));
+    }
+    async collectSubagentNotifications(sessionId, waitForExecutor) {
+        const executors = this.sessionSubagentExecutors(sessionId);
+        if (executors.length === 0)
+            return null;
+        const poll = () => Promise.all(executors.map((executor) => executor.notifications(false, false)));
+        let batches = await poll();
+        if (batches.every(({ messages }) => messages.length === 0)) {
+            if (waitForExecutor &&
+                executors.includes(waitForExecutor) &&
+                waitForExecutor.notificationClaimAgentIds().length > 0) {
+                await waitForExecutor.notifications(true, false);
+                batches = await poll();
+            }
+        }
+        const durationSeen = batches.some(({ durationApiMs, durationApiWithoutRetriesMs }) => durationApiMs !== undefined ||
+            durationApiWithoutRetriesMs !== undefined);
+        const modelUsage = mergeSessionRawModelUsage(...batches.map((batch) => batch.modelUsage));
+        return {
+            messages: batches.flatMap(({ messages }) => messages),
+            usage: batches.reduce((total, { usage }) => mergeUsage(total, usage), {
+                inputTokens: 0,
+                outputTokens: 0,
+            }),
+            ...(modelUsage ? { modelUsage } : {}),
+            ...(durationSeen
+                ? {
+                    durationApiMs: batches.reduce((total, batch) => addApiDuration(batch.durationApiMs, total, 'durationApiMs'), 0),
+                    durationApiWithoutRetriesMs: batches.reduce((total, batch) => addApiDuration(batch.durationApiWithoutRetriesMs ?? batch.durationApiMs, total, 'durationApiWithoutRetriesMs'), 0),
+                }
+                : {}),
+        };
+    }
     async applyPermissionUpdates(sessionId, updates) {
         if (updates.length === 0)
             return;
@@ -808,16 +878,19 @@ export class ClaudeSessionService {
         }
     }
     async close() {
+        this.closing = true;
         await this.fileChangeWatcher?.close(5_000);
         await this.hookLifecycle.close();
         await this.drainDetachedHookRuns(5_000);
         await this.options.hooks?.drainAsync(5_000);
         this.scheduledPrompts?.close();
         await this.options.projectMemoryExtraction?.close(5_000);
-        await Promise.all([...this.hostedSubagents].map((executor) => executor.close()));
+        await Promise.all([...this.subagentExecutors].map((executor) => executor.close()));
+        await Promise.allSettled([...this.hostedSubagentPumpPromises]);
         await Promise.resolve();
         await Promise.all([...this.backgroundNotificationWrites.values()]);
         this.hostedSubagents.clear();
+        this.subagentExecutors.clear();
         this.backgroundTasks.clear();
         await Promise.all([...this.sessionMemoryControllers.values()].map((controller) => controller.close()));
         this.sessionMemoryControllers.clear();
@@ -1050,11 +1123,15 @@ export class ClaudeSessionService {
                         backgroundTaskNotifications: (waitForRunning) => taskTools.notifications(waitForRunning),
                     }
                     : {}),
+                stopOwnedBackgroundAgent: (ownerSessionId, agentId) => this.backgroundTasks.stopAgent(ownerSessionId, agentId),
+                outputOwnedBackgroundAgent: (ownerSessionId, agentId, options) => this.backgroundTasks.outputAgent(ownerSessionId, agentId, options),
+                sendOwnedBackgroundAgent: (ownerSessionId, agentId, message, summary, toolUseId) => this.sendOwnedBackgroundAgent(ownerSessionId, agentId, message, summary, toolUseId),
             })
             : null;
-        if (subagentExecutor)
-            this.hostedSubagents.add(subagentExecutor);
         if (subagentExecutor) {
+            this.hostedSubagents.add(subagentExecutor);
+            this.subagentExecutors.add(subagentExecutor);
+            this.subagentExecutorSessions.set(subagentExecutor, sessionId);
             this.backgroundTasks.registerAgents(sessionId, subagentExecutor);
         }
         const agentTools = subagentExecutor
@@ -1157,19 +1234,67 @@ export class ClaudeSessionService {
     }
     async run(prompt, signal, sessionId = randomUUID(), name, images, documents) {
         this.worktreeManager?.bindSession(sessionId);
-        return this.executeTurn(sessionId, prompt, false, signal, name, images, documents);
+        return this.executeTurn({
+            activation: {
+                kind: 'start',
+                sessionId,
+                ...(name !== undefined ? { name } : {}),
+            },
+            submission: {
+                kind: 'prompt',
+                text: prompt,
+                ...(images ? { images } : {}),
+                ...(documents ? { documents } : {}),
+            },
+            ...(signal ? { signal } : {}),
+        });
     }
     async runShell(command, signal, sessionId = randomUUID(), name) {
         this.worktreeManager?.bindSession(sessionId);
-        return this.executeTurn(sessionId, `! ${command}`, false, signal, name, [], [], undefined, command);
+        return this.executeTurn({
+            activation: {
+                kind: 'start',
+                sessionId,
+                ...(name !== undefined ? { name } : {}),
+            },
+            submission: { kind: 'shell', command },
+            ...(signal ? { signal } : {}),
+        });
     }
     async resume(sessionId, prompt, signal, name, images, documents, resumeSessionAt) {
         this.worktreeManager?.bindSession(sessionId);
-        return this.executeTurn(sessionId, prompt, true, signal, name, images, documents, resumeSessionAt);
+        return this.executeTurn({
+            activation: {
+                kind: 'resume',
+                sessionId,
+                ...(name !== undefined ? { name } : {}),
+                ...(resumeSessionAt !== undefined
+                    ? { atMessageId: resumeSessionAt }
+                    : {}),
+            },
+            submission: {
+                kind: 'prompt',
+                text: prompt,
+                ...(images ? { images } : {}),
+                ...(documents ? { documents } : {}),
+            },
+            ...(signal ? { signal } : {}),
+        });
     }
     async resumeShell(sessionId, command, signal, name, resumeSessionAt) {
         this.worktreeManager?.bindSession(sessionId);
-        return this.executeTurn(sessionId, `! ${command}`, true, signal, name, [], [], resumeSessionAt, command);
+        return this.executeTurn({
+            activation: {
+                kind: 'resume',
+                sessionId,
+                ...(name !== undefined ? { name } : {}),
+                ...(resumeSessionAt !== undefined
+                    ? { atMessageId: resumeSessionAt }
+                    : {}),
+            },
+            submission: { kind: 'shell', command },
+            ...(signal ? { signal } : {}),
+        });
     }
     async answerSideQuestion(sessionId, question, signal, onDelta, permissionMode = 'default') {
         const prompt = question.trim();
@@ -1195,16 +1320,17 @@ export class ClaudeSessionService {
             entries = loaded.value.entries;
             this.restoreWorktree(entries);
         }
-        const assembledContext = await this.options.contextAssembler?.assemble({
+        const assembledContext = await assembleContextSnapshot(this.options.contextAssembler, {
             cwd: this.activeCwd(),
             lifecycleId: activeSessionId,
         });
+        const contextProjection = projectContextSnapshot(assembledContext);
         const messages = [
-            ...(assembledContext?.systemMessages ?? []),
+            ...contextProjection.systemMessages,
             ...injectFirstUserMessageContext([
                 ...projectClaudeModelMessages(entries),
                 { role: 'user', content: prompt },
-            ], assembledContext?.firstUserMessageContext),
+            ], contextProjection.firstUserMessageContext),
         ];
         const budget = this.contextBudget(provider);
         if (budget)
@@ -1215,6 +1341,7 @@ export class ClaudeSessionService {
             : 'praxis/provider';
         const metrics = await completeMeteredModelRequest(provider, {
             messages,
+            stableSystemMessageCount: contextProjection.stableSystemSectionCount,
             ...(this.options.effort ? { effort: this.options.effort } : {}),
             ...(signal ? { signal } : {}),
         }, {
@@ -1257,6 +1384,9 @@ export class ClaudeSessionService {
             .join('-')
             .slice(0, 64) || 'side-question';
         const registry = this.createHostedToolRegistry(sessionId);
+        const executor = this.hostedSubagentsByRegistry.get(registry);
+        if (executor)
+            this.hostedSubagentNotificationReservations.add(executor);
         const call = {
             id: randomUUID(),
             name: 'Agent',
@@ -1272,26 +1402,69 @@ export class ClaudeSessionService {
             cwd: this.activeCwd(),
             ...(signal ? { signal } : {}),
         };
-        const prepared = await registry.prepare(call, context);
-        const result = await registry.execute(prepared, context);
-        const agentId = result.nativeToolUseResult?.agentId;
-        if (result.isError || typeof agentId !== 'string') {
-            throw new Error(result.content || 'Could not fork side question');
+        try {
+            const prepared = await registry.prepare(call, context);
+            const result = await registry.execute(prepared, context);
+            const agentId = result.nativeToolUseResult?.agentId;
+            if (result.isError || typeof agentId !== 'string') {
+                throw new Error(result.content || 'Could not fork side question');
+            }
+            await this.appendSystemLocalCommand(sessionId, 'btw', prompt, `⑂ forked ${name} (${agentId.slice(-4)})`);
+            if (executor) {
+                this.startHostedSubagentNotificationPump(sessionId, executor);
+            }
+            return { agentId, name };
         }
-        await this.appendSystemLocalCommand(sessionId, 'btw', prompt, `⑂ forked ${name} (${agentId.slice(-4)})`);
-        const executor = this.hostedSubagentsByRegistry.get(registry);
-        if (executor) {
-            void executor
-                .notifications(true)
-                .then(({ messages }) => this.enqueueBackgroundNotifications(sessionId, messages))
-                .catch((error) => this.options.eventSink?.({
-                type: 'warning',
-                message: error instanceof Error
-                    ? error.message
-                    : `Could not persist background notification: ${String(error)}`,
-            }));
+        catch (error) {
+            if (executor) {
+                this.hostedSubagentNotificationReservations.delete(executor);
+            }
+            throw error;
         }
-        return { agentId, name };
+    }
+    startHostedSubagentNotificationPump(sessionId, executor) {
+        this.hostedSubagentNotificationReservations.delete(executor);
+        if (this.hostedSubagentNotificationPumps.has(executor))
+            return;
+        const pump = (async () => {
+            while (!this.closing) {
+                const reconciled = await this.turnStore(sessionId).withLease(async (lease) => {
+                    const snapshot = await lease.load();
+                    await executor.reconcileDetachedNotifications((notification) => transcriptContainsBackgroundAgentNotification(snapshot.entries, notification));
+                });
+                if (reconciled.status !== 'completed') {
+                    await new Promise((resolve) => setTimeout(resolve, 25));
+                    continue;
+                }
+                const { messages } = await executor.notifications(true, false);
+                if (messages.length === 0)
+                    return;
+                await executor.prepareNotificationsDetached(messages);
+                if (!(await this.enqueueBackgroundNotifications(sessionId, messages, async (message) => {
+                    await executor.confirmNotificationsDetached([message]);
+                    await executor.acknowledgeNotifications([message]);
+                }))) {
+                    return;
+                }
+                if (executor.notificationClaimAgentIds().length === 0)
+                    return;
+            }
+        })()
+            .catch((error) => this.options.eventSink?.({
+            type: 'warning',
+            message: error instanceof Error
+                ? error.message
+                : `Could not persist background notification: ${String(error)}`,
+        }))
+            .finally(() => {
+            if (this.hostedSubagentNotificationPumps.get(executor) === pump) {
+                this.hostedSubagentNotificationPumps.delete(executor);
+            }
+            this.hostedSubagentPumpPromises.delete(pump);
+        });
+        this.hostedSubagentNotificationPumps.set(executor, pump);
+        this.hostedSubagentPumpPromises.add(pump);
+        void pump;
     }
     async promptSuggestion(sessionId, signal) {
         const loaded = this.options.sessionPersistence === false
@@ -1309,27 +1482,21 @@ export class ClaudeSessionService {
         const provider = this.providerForAgent(agent);
         this.activeProvider = provider;
         const agentSystem = await this.mainAgentSystemPrompt(agent);
-        const assembledContext = await this.options.contextAssembler?.assemble({
+        const assembledContext = await assembleContextSnapshot(this.options.contextAssembler, {
             cwd: this.activeCwd(),
             lifecycleId: sessionId,
-            ...(agentSystem ? { mode: 'agent', baseSystemPrompt: agentSystem } : {}),
+            ...(agentSystem
+                ? { mode: 'agent', baseSystemPrompt: agentSystem }
+                : {}),
         });
-        const hasPromptManifest = assembledContext?.promptSections !== undefined;
-        const assembledSystemMessages = hasPromptManifest
-            ? (assembledContext?.systemMessages ?? [])
-            : this.assembledSystemMessages(agent, assembledContext?.systemMessages ?? []);
-        const contextMessages = [
-            ...(!hasPromptManifest && agentSystem
-                ? [{ role: 'system', content: agentSystem }]
-                : []),
-            ...assembledSystemMessages,
-        ];
+        const contextProjection = projectContextSnapshot(assembledContext);
+        const contextMessages = [...contextProjection.systemMessages];
         const messages = [
             ...contextMessages,
             ...injectFirstUserMessageContext([
                 ...projectClaudeModelMessages(entries.entries),
                 { role: 'user', content: PROMPT_SUGGESTION_INSTRUCTION },
-            ], assembledContext?.firstUserMessageContext),
+            ], contextProjection.firstUserMessageContext),
         ];
         const suggestionTools = agent && this.options.tools
             ? new FilteredToolRegistry(this.options.tools, {
@@ -1339,6 +1506,7 @@ export class ClaudeSessionService {
         await this.activateSessionCostTracker(sessionId);
         const metrics = await completeMeteredModelRequest(provider, {
             messages,
+            stableSystemMessageCount: contextProjection.stableSystemSectionCount,
             ...(provider.capabilities.tools
                 ? { tools: suggestionTools?.definitions() ?? [] }
                 : {}),
@@ -1866,7 +2034,11 @@ export class ClaudeSessionService {
     }
     async retryRecentlyDenied(sessionId, display, signal) {
         await this.appendPermissionGrant(sessionId, display, true);
-        return this.executeTurn(sessionId, '/permissions', true, signal, undefined, [], [], undefined, undefined, true);
+        return this.executeTurn({
+            activation: { kind: 'resume', sessionId },
+            submission: { kind: 'retry', prompt: '/permissions' },
+            ...(signal ? { signal } : {}),
+        });
     }
     async recordBtwUsage(sessionId, permissionMode = 'default') {
         const activeSessionId = await this.ensureLocalSession(sessionId, permissionMode);
@@ -2428,8 +2600,9 @@ export class ClaudeSessionService {
     }
     async costSnapshot(sessionId) {
         const existing = this.sessionCostTrackers.get(sessionId);
-        if (existing)
-            return existing.snapshot();
+        if (existing) {
+            return this.withDetachedSubagentUsage(sessionId, existing.snapshot());
+        }
         const store = this.options.costStateStore;
         const loaded = store ? await store.load(sessionId) : null;
         const tracker = new ClaudeSessionCostTracker({
@@ -2437,1679 +2610,1727 @@ export class ClaudeSessionService {
             ...(loaded ? { restored: loaded } : {}),
         });
         this.sessionCostTrackers.set(sessionId, tracker);
-        return tracker.snapshot();
+        return this.withDetachedSubagentUsage(sessionId, tracker.snapshot());
     }
-    async executeTurn(sessionId, prompt, requireExisting, signal, name, images = [], documents = [], resumeSessionAt, shellCommand, skipUserPrompt = false) {
-        this.assertWritable();
-        if (prompt.length === 0 && images.length === 0 && documents.length === 0)
-            throw new Error('Prompt must not be empty');
-        if (name !== undefined && name.length === 0) {
-            throw new Error('Session name must not be empty');
-        }
-        if (shellCommand !== undefined && shellCommand.trim().length === 0) {
-            throw new Error('Shell command must not be empty');
+    async withDetachedSubagentUsage(sessionId, base) {
+        const tracker = new ClaudeSessionCostTracker({
+            sessionId,
+            restored: base,
+        });
+        const directory = join(this.paths(sessionId).praxisRoot, 'subagent-lifecycle', sessionId);
+        let entries;
+        try {
+            entries = await readdir(directory);
         }
-        await this.activateSessionCostTracker(sessionId);
-        if (this.options.sessionPersistence !== false) {
-            this.durableMetadataSessions.add(sessionId);
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return base;
+            throw error;
         }
-        await this.ensureFileResources(sessionId, signal);
-        this.worktreeManager?.bindSession(sessionId);
-        if (this.options.initialWorktree) {
-            await this.worktreeManager?.ensureInitial(this.options.initialWorktreeName);
-        }
-        const pinnedCwd = this.sessionCwds.get(sessionId) ?? this.activeCwd();
-        this.sessionCwds.set(sessionId, pinnedCwd);
-        if (this.options.workspace?.cwd() !== pinnedCwd) {
-            this.options.workspace?.setCwd(pinnedCwd);
-        }
-        this.runtimeCwd = pinnedCwd;
-        if (requireExisting) {
-            await this.discoverProjectRoot(sessionId);
-        }
-        const sessionPaths = this.paths(sessionId);
-        const toolResultDirectory = join(sessionPaths.projectRoot, sessionId, 'tool-results');
-        const store = this.turnStore(sessionId);
-        const leaseResult = await store.withLease(async (lease) => {
-            if (!requireExisting) {
-                const initialization = name === undefined
-                    ? await store.reserve()
-                    : await store.create(this.sessionNameEntries(sessionId, name));
-                if (initialization.status === 'conflict') {
-                    throw new Error(`Session ID ${sessionId} is already in use`);
+        for (const file of entries) {
+            const agentId = file.endsWith('.json') ? file.slice(0, -5) : '';
+            if (!isClaudeAgentId(agentId))
+                continue;
+            try {
+                const lifecycle = await new SubagentLifecycleStore(this.paths(sessionId).praxisRoot, sessionId, agentId).read();
+                for (const notification of lifecycle?.notifications ?? []) {
+                    if (notification.accounting?.kind !== 'detached' ||
+                        !notification.accounting.delivered ||
+                        notification.result === null) {
+                        continue;
+                    }
+                    const rows = Object.entries(notification.result.modelUsage ?? {
+                        [notification.accounting.model]: notification.result.usage,
+                    });
+                    if (rows.length === 0) {
+                        tracker.recordDurations({
+                            ...(notification.result.durationApiMs === undefined
+                                ? {}
+                                : { apiDurationMs: notification.result.durationApiMs }),
+                            ...(notification.result.durationApiWithoutRetriesMs === undefined
+                                ? {}
+                                : {
+                                    durationApiWithoutRetriesMs: notification.result.durationApiWithoutRetriesMs,
+                                }),
+                        });
+                        continue;
+                    }
+                    for (const [index, [model, usage]] of rows.entries()) {
+                        const pricing = this.options.pricing?.resolve(model);
+                        const costUsd = pricing ? usageCostUsd(usage, pricing) : undefined;
+                        tracker.recordTurn({
+                            model,
+                            usage,
+                            ...(costUsd === undefined ? {} : { costUsd }),
+                            ...(usage.webSearchRequests === undefined
+                                ? {}
+                                : { webSearchRequests: usage.webSearchRequests }),
+                            ...(index === 0
+                                ? {
+                                    apiDurationMs: notification.result.durationApiMs,
+                                    apiDurationWithoutRetriesMs: notification.result.durationApiWithoutRetriesMs,
+                                }
+                                : {}),
+                        });
+                    }
                 }
             }
-            let snapshot = await lease.load();
-            let automaticReplayPrompt;
-            if (requireExisting &&
-                this.options.sessionPersistence === false &&
-                snapshot.entries.length === 0) {
-                const persisted = await this.store(sessionId).load();
-                if (persisted.entries.length > 0) {
-                    const imported = await store.create(persisted.entries);
-                    if (imported.status === 'created')
-                        snapshot = await lease.load();
-                }
+            catch (error) {
+                this.options.eventSink?.({
+                    type: 'warning',
+                    message: `Could not account detached subagent ${agentId}: ${error instanceof Error ? error.message : String(error)}`,
+                });
             }
-            if (requireExisting && snapshot.entries.length === 0) {
-                throw new Error(`Claude session not found: ${sessionId}`);
+        }
+        return tracker.snapshot();
+    }
+    async executeTurn(request) {
+        const { activation, submission, signal } = request;
+        const sessionId = activation.sessionId;
+        const requireExisting = activation.kind === 'resume';
+        const name = activation.name;
+        const resumeSessionAt = activation.kind === 'resume' ? activation.atMessageId : undefined;
+        const prompt = submission.kind === 'shell'
+            ? `! ${submission.command}`
+            : submission.kind === 'retry'
+                ? submission.prompt
+                : submission.text;
+        const images = submission.kind === 'prompt' ? (submission.images ?? []) : [];
+        const documents = submission.kind === 'prompt' ? (submission.documents ?? []) : [];
+        const shellCommand = submission.kind === 'shell' ? submission.command : undefined;
+        const skipUserPrompt = submission.kind === 'retry';
+        const controller = new TurnTerminalController(this.options.eventSink ?? (() => undefined));
+        try {
+            this.assertWritable();
+            if (prompt.length === 0 && images.length === 0 && documents.length === 0)
+                throw new Error('Prompt must not be empty');
+            if (name !== undefined && name.length === 0) {
+                throw new Error('Session name must not be empty');
             }
-            this.rememberDurableMetadata(sessionId, snapshot.entries);
-            if (resumeSessionAt !== undefined) {
-                snapshot = {
-                    entries: selectClaudeTranscriptAtMessage(snapshot.entries, resumeSessionAt),
-                    tail: { ...snapshot.tail, branchParentUuid: resumeSessionAt },
-                };
+            if (shellCommand !== undefined && shellCommand.trim().length === 0) {
+                throw new Error('Shell command must not be empty');
             }
-            else if (this.explicitResumeLeafUuids.has(sessionId)) {
-                const selected = selectClaudeTranscriptFromNewestLeaf(snapshot.entries);
-                this.explicitResumeLeafUuids.set(sessionId, selected.leafUuid);
-                snapshot = {
-                    entries: selected.entries,
-                    tail: { ...snapshot.tail, branchParentUuid: selected.leafUuid },
-                };
+            await this.activateSessionCostTracker(sessionId);
+            if (this.options.sessionPersistence !== false) {
+                this.durableMetadataSessions.add(sessionId);
             }
-            if (requireExisting &&
-                resumeSessionAt === undefined &&
-                this.options.resumeInterruptedTurn === true &&
-                shellCommand === undefined &&
-                !skipUserPrompt &&
-                !(this.options.approveRecovery !== undefined &&
-                    findUnresolvedClaudeToolCalls(snapshot.entries).length > 0)) {
-                const interruption = classifyClaudeInterruption(snapshot.entries);
-                if ((interruption.kind === 'interrupted-prompt' ||
-                    interruption.kind === 'interrupted-turn') &&
-                    interruption.prompt !== undefined &&
-                    interruption.replayEntries !== undefined) {
-                    automaticReplayPrompt = interruption.prompt;
-                    snapshot = {
-                        entries: interruption.replayEntries,
-                        tail: {
-                            ...snapshot.tail,
-                            branchParentUuid: interruption.replayParentUuid ?? null,
-                        },
-                    };
-                }
+            await this.ensureFileResources(sessionId, signal);
+            this.worktreeManager?.bindSession(sessionId);
+            if (this.options.initialWorktree) {
+                await this.worktreeManager?.ensureInitial(this.options.initialWorktreeName);
             }
-            const initialTransition = this.worktreeManager?.consumeTransition('__initial__');
-            if (initialTransition && snapshot.entries.length === 0) {
-                const stateEntry = {
-                    type: 'worktree-state',
-                    worktreeSession: initialTransition.state,
-                    sessionId,
-                };
-                const stateTail = await this.append(lease, snapshot.tail, stateEntry);
-                snapshot = {
-                    entries: [...snapshot.entries, stateEntry],
-                    tail: stateTail,
-                };
-                this.rememberDurableMetadata(sessionId, snapshot.entries);
+            const pinnedCwd = this.sessionCwds.get(sessionId) ?? this.activeCwd();
+            this.sessionCwds.set(sessionId, pinnedCwd);
+            if (this.options.workspace?.cwd() !== pinnedCwd) {
+                this.options.workspace?.setCwd(pinnedCwd);
             }
-            this.restoreWorktree(snapshot.entries);
-            this.options.interactiveTools?.restore(sessionId, snapshot.entries);
-            if (requireExisting &&
-                name !== undefined &&
-                !this.hasSessionName(snapshot.entries, name)) {
-                const entries = this.sessionNameEntries(sessionId, name);
-                const appendResult = await lease.appendMany(snapshot.tail, entries);
-                if (appendResult.status === 'conflict') {
-                    throw new Error(`Claude transcript append conflict: ${appendResult.reason}`);
+            this.runtimeCwd = pinnedCwd;
+            if (requireExisting) {
+                await this.discoverProjectRoot(sessionId);
+            }
+            const sessionPaths = this.paths(sessionId);
+            const toolResultDirectory = join(sessionPaths.projectRoot, sessionId, 'tool-results');
+            const store = this.turnStore(sessionId);
+            const leaseResult = await store.withLease(async (lease) => {
+                if (!requireExisting) {
+                    const initialization = name === undefined
+                        ? await store.reserve()
+                        : await store.create(this.sessionNameEntries(sessionId, name));
+                    if (initialization.status === 'conflict') {
+                        throw new Error(`Session ID ${sessionId} is already in use`);
+                    }
+                }
+                let snapshot = await lease.load();
+                let automaticReplayPrompt;
+                if (requireExisting &&
+                    this.options.sessionPersistence === false &&
+                    snapshot.entries.length === 0) {
+                    const persisted = await this.store(sessionId).load();
+                    if (persisted.entries.length > 0) {
+                        const imported = await store.create(persisted.entries);
+                        if (imported.status === 'created')
+                            snapshot = await lease.load();
+                    }
+                }
+                if (requireExisting && snapshot.entries.length === 0) {
+                    throw new Error(`Claude session not found: ${sessionId}`);
                 }
-                snapshot = {
-                    entries: [...snapshot.entries, ...entries],
-                    tail: appendResult.tail,
-                };
                 this.rememberDurableMetadata(sessionId, snapshot.entries);
-            }
-            const agentName = this.options.agent ?? getClaudeAgentSetting(snapshot.entries);
-            const agent = this.resolveAgent(agentName);
-            const provider = this.providerForAgent(agent);
-            this.activeProvider = provider;
-            const effectivePrompt = automaticReplayPrompt ??
-                (!requireExisting &&
-                    !skipUserPrompt &&
-                    !this.options.agentInitialPromptHandledExternally &&
+                if (resumeSessionAt !== undefined) {
+                    snapshot = {
+                        entries: selectClaudeTranscriptAtMessage(snapshot.entries, resumeSessionAt),
+                        tail: { ...snapshot.tail, branchParentUuid: resumeSessionAt },
+                    };
+                }
+                else if (this.explicitResumeLeafUuids.has(sessionId)) {
+                    const selected = selectClaudeTranscriptFromNewestLeaf(snapshot.entries);
+                    this.explicitResumeLeafUuids.set(sessionId, selected.leafUuid);
+                    snapshot = {
+                        entries: selected.entries,
+                        tail: { ...snapshot.tail, branchParentUuid: selected.leafUuid },
+                    };
+                }
+                if (requireExisting &&
+                    resumeSessionAt === undefined &&
+                    this.options.resumeInterruptedTurn === true &&
                     shellCommand === undefined &&
-                    agent?.initialPrompt
-                    ? `${agent.initialPrompt}\n\n${prompt}`
-                    : prompt);
-            const projectMemoryRecallTurn = !skipUserPrompt && shellCommand === undefined
-                ? this.options.projectMemoryRecall?.prefetch({
-                    sessionId,
-                    turnId: randomUUID(),
-                    prompt: effectivePrompt,
-                    ...(signal ? { signal } : {}),
-                })
-                : undefined;
-            const initialPricing = this.options.pricing?.resolve(provider.model ?? 'praxis/provider');
-            if (this.options.maxBudgetUsd !== undefined && !initialPricing) {
-                throw new Error(`Cannot enforce --max-budget-usd: no pricing is configured for model ${provider.model ?? 'praxis/provider'}`);
-            }
-            const shellInputUuid = shellCommand === undefined ? null : randomUUID();
-            let currentPromptId = shellInputUuid;
-            let lastAssistantUuid = null;
-            const fileHistory = this.options.fileCheckpointing &&
-                this.options.sessionPersistence !== false
-                ? new ClaudeFileHistory(this.options.configRoot, sessionId, [
-                    this.activeCwd(),
-                    ...(this.options.fileRewindRoots ?? []),
-                ])
-                : null;
-            const unresolvedToolCalls = findUnresolvedClaudeToolCalls(snapshot.entries);
-            const pendingRecoveryToolCallIds = new Set(unresolvedToolCalls.map((call) => call.id));
-            const pendingRecoveryHookOutcomes = [];
-            const currentHookCwd = () => this.activeCwd();
-            const hookSession = {
-                session_id: sessionId,
-                transcript_path: sessionPaths.sessionFile,
-                get cwd() {
-                    return currentHookCwd();
-                },
-                permission_mode: 'default',
-            };
-            const appendHookOutcome = async (outcome) => {
-                for (const entry of createClaudeHookAttachmentEntries(outcome, this.translationContext(sessionId, snapshot))) {
-                    const tail = await this.append(lease, snapshot.tail, entry);
-                    snapshot = { entries: [...snapshot.entries, entry], tail };
+                    !skipUserPrompt &&
+                    !(this.options.approveRecovery !== undefined &&
+                        findUnresolvedClaudeToolCalls(snapshot.entries).length > 0)) {
+                    const interruption = classifyClaudeInterruption(snapshot.entries);
+                    if ((interruption.kind === 'interrupted-prompt' ||
+                        interruption.kind === 'interrupted-turn') &&
+                        interruption.prompt !== undefined &&
+                        interruption.replayEntries !== undefined) {
+                        automaticReplayPrompt = interruption.prompt;
+                        snapshot = {
+                            entries: interruption.replayEntries,
+                            tail: {
+                                ...snapshot.tail,
+                                branchParentUuid: interruption.replayParentUuid ?? null,
+                            },
+                        };
+                    }
                 }
-            };
-            const recordHookOutcome = async (outcome, deferUntilApproval = false) => {
-                if (deferUntilApproval) {
-                    pendingRecoveryHookOutcomes.push(outcome);
-                    return;
+                const initialTransition = this.worktreeManager?.consumeTransition('__initial__');
+                if (initialTransition && snapshot.entries.length === 0) {
+                    const stateEntry = {
+                        type: 'worktree-state',
+                        worktreeSession: initialTransition.state,
+                        sessionId,
+                    };
+                    const stateTail = await this.append(lease, snapshot.tail, stateEntry);
+                    snapshot = {
+                        entries: [...snapshot.entries, stateEntry],
+                        tail: stateTail,
+                    };
+                    this.rememberDurableMetadata(sessionId, snapshot.entries);
                 }
-                await appendHookOutcome(outcome);
-            };
-            const flushRecoveryHookOutcomes = async () => {
-                const entries = [];
-                let history = snapshot.entries;
-                let parentUuid = this.logicalTailUuid(snapshot.tail);
-                for (const outcome of pendingRecoveryHookOutcomes) {
-                    const outcomeEntries = createClaudeHookAttachmentEntries(outcome, {
-                        ...this.translationContext(sessionId, snapshot),
-                        parentUuid,
-                        history,
-                    });
-                    entries.push(...outcomeEntries);
-                    history = [...history, ...outcomeEntries];
-                    const lastEntry = outcomeEntries.at(-1);
-                    if (typeof lastEntry?.uuid === 'string')
-                        parentUuid = lastEntry.uuid;
+                this.restoreWorktree(snapshot.entries);
+                this.options.interactiveTools?.restore(sessionId, snapshot.entries);
+                if (requireExisting &&
+                    name !== undefined &&
+                    !this.hasSessionName(snapshot.entries, name)) {
+                    const entries = this.sessionNameEntries(sessionId, name);
+                    const appendResult = await lease.appendMany(snapshot.tail, entries);
+                    if (appendResult.status === 'conflict') {
+                        throw new Error(`Claude transcript append conflict: ${appendResult.reason}`);
+                    }
+                    snapshot = {
+                        entries: [...snapshot.entries, ...entries],
+                        tail: appendResult.tail,
+                    };
+                    this.rememberDurableMetadata(sessionId, snapshot.entries);
                 }
-                if (entries.length === 0) {
-                    pendingRecoveryHookOutcomes.length = 0;
-                    return;
+                const agentName = this.options.agent ?? getClaudeAgentSetting(snapshot.entries);
+                const agent = this.resolveAgent(agentName);
+                const provider = this.providerForAgent(agent);
+                this.activeProvider = provider;
+                const effectivePrompt = automaticReplayPrompt ??
+                    (!requireExisting &&
+                        !skipUserPrompt &&
+                        !this.options.agentInitialPromptHandledExternally &&
+                        shellCommand === undefined &&
+                        agent?.initialPrompt
+                        ? `${agent.initialPrompt}\n\n${prompt}`
+                        : prompt);
+                const projectMemoryRecallTurn = !skipUserPrompt && shellCommand === undefined
+                    ? this.options.projectMemoryRecall?.prefetch({
+                        sessionId,
+                        turnId: randomUUID(),
+                        prompt: effectivePrompt,
+                        ...(signal ? { signal } : {}),
+                    })
+                    : undefined;
+                const initialPricing = this.options.pricing?.resolve(provider.model ?? 'praxis/provider');
+                if (this.options.maxBudgetUsd !== undefined && !initialPricing) {
+                    throw new Error(`Cannot enforce --max-budget-usd: no pricing is configured for model ${provider.model ?? 'praxis/provider'}`);
                 }
-                const appendResult = await lease.appendMany(snapshot.tail, entries);
-                if (appendResult.status === 'conflict') {
-                    throw new Error(`Claude transcript append conflict: ${appendResult.reason}`);
+                const shellInputUuid = shellCommand === undefined ? null : randomUUID();
+                let currentPromptId = shellInputUuid;
+                let lastAssistantUuid = null;
+                const fileHistory = this.options.fileCheckpointing &&
+                    this.options.sessionPersistence !== false
+                    ? new ClaudeFileHistory(this.options.configRoot, sessionId, [
+                        this.activeCwd(),
+                        ...(this.options.fileRewindRoots ?? []),
+                    ])
+                    : null;
+                const unresolvedToolCalls = findUnresolvedClaudeToolCalls(snapshot.entries);
+                const pendingRecoveryToolCallIds = new Set(unresolvedToolCalls.map((call) => call.id));
+                const pendingRecoveryHookOutcomes = [];
+                const currentHookCwd = () => this.activeCwd();
+                const hookSession = {
+                    session_id: sessionId,
+                    transcript_path: sessionPaths.sessionFile,
+                    get cwd() {
+                        return currentHookCwd();
+                    },
+                    permission_mode: 'default',
+                };
+                const appendHookOutcome = async (outcome) => {
+                    for (const entry of createClaudeHookAttachmentEntries(outcome, this.translationContext(sessionId, snapshot))) {
+                        const tail = await this.append(lease, snapshot.tail, entry);
+                        snapshot = { entries: [...snapshot.entries, entry], tail };
+                    }
+                };
+                const recordHookOutcome = async (outcome, deferUntilApproval = false) => {
+                    if (deferUntilApproval) {
+                        pendingRecoveryHookOutcomes.push(outcome);
+                        return;
+                    }
+                    await appendHookOutcome(outcome);
+                };
+                const flushRecoveryHookOutcomes = async () => {
+                    const entries = [];
+                    let history = snapshot.entries;
+                    let parentUuid = this.logicalTailUuid(snapshot.tail);
+                    for (const outcome of pendingRecoveryHookOutcomes) {
+                        const outcomeEntries = createClaudeHookAttachmentEntries(outcome, {
+                            ...this.translationContext(sessionId, snapshot),
+                            parentUuid,
+                            history,
+                        });
+                        entries.push(...outcomeEntries);
+                        history = [...history, ...outcomeEntries];
+                        const lastEntry = outcomeEntries.at(-1);
+                        if (typeof lastEntry?.uuid === 'string')
+                            parentUuid = lastEntry.uuid;
+                    }
+                    if (entries.length === 0) {
+                        pendingRecoveryHookOutcomes.length = 0;
+                        return;
+                    }
+                    const appendResult = await lease.appendMany(snapshot.tail, entries);
+                    if (appendResult.status === 'conflict') {
+                        throw new Error(`Claude transcript append conflict: ${appendResult.reason}`);
+                    }
+                    snapshot = { entries: history, tail: appendResult.tail };
+                    pendingRecoveryHookOutcomes.length = 0;
+                };
+                const capabilities = this.toolCapabilities();
+                const taskToolNames = this.capabilityToolNames(this.options.taskToolNames, capabilities);
+                const scheduledToolNames = this.capabilityToolNames(this.options.scheduledToolNames, capabilities);
+                const taskTools = this.options.tools && taskToolNames.length > 0
+                    ? new ClaudeTaskToolRegistry({
+                        base: this.options.tools,
+                        cwd: this.activeCwd(),
+                        cwdProvider: () => this.activeCwd(),
+                        praxisRoot: sessionPaths.praxisRoot,
+                        sessionId,
+                        taskRoot: sessionPaths.taskRoot,
+                        ...(this.options.eventSink
+                            ? { eventSink: this.options.eventSink }
+                            : {}),
+                        enabledTools: taskToolNames,
+                        ...(this.options.hooks
+                            ? {
+                                taskHooks: {
+                                    created: async (task, taskSignal) => {
+                                        const outcome = await this.options.hooks?.run({
+                                            ...hookSession,
+                                            hook_event_name: 'TaskCreated',
+                                            task_id: task.id,
+                                            task_subject: task.subject,
+                                            task_description: task.description,
+                                        }, undefined, taskSignal);
+                                        if (!outcome)
+                                            return;
+                                        await recordHookOutcome(outcome);
+                                        if (outcome.blockedReason) {
+                                            throw new Error(`TaskCreated hook error: ${outcome.blockedReason}`);
+                                        }
+                                    },
+                                    completed: async (task, taskSignal) => {
+                                        const outcome = await this.options.hooks?.run({
+                                            ...hookSession,
+                                            hook_event_name: 'TaskCompleted',
+                                            task_id: task.id,
+                                            task_subject: task.subject,
+                                            task_description: task.description,
+                                        }, undefined, taskSignal);
+                                        if (!outcome)
+                                            return;
+                                        await recordHookOutcome(outcome);
+                                        if (outcome.blockedReason) {
+                                            throw new Error(`TaskCompleted hook error: ${outcome.blockedReason}`);
+                                        }
+                                    },
+                                },
+                            }
+                            : {}),
+                    })
+                    : null;
+                const scheduledTools = this.scheduledPrompts &&
+                    this.options.tools &&
+                    scheduledToolNames.length > 0
+                    ? new ClaudeScheduledToolRegistry({
+                        base: taskTools ?? this.options.tools,
+                        manager: this.scheduledPrompts,
+                        sessionId,
+                        enabledTools: scheduledToolNames,
+                        dataPlane: this.options.dataPlane ?? 'claude',
+                    })
+                    : null;
+                const baseTools = scheduledTools ?? taskTools ?? this.options.tools;
+                const turnPermissions = this.options.interactiveTools?.permissions(sessionId) ??
+                    this.options.permissions;
+                const subagentExecutor = (this.options.enableSubagents || this.options.enableWorkflows) &&
+                    baseTools &&
+                    turnPermissions
+                    ? new ClaudeSubagentExecutor({
+                        configRoot: this.options.configRoot,
+                        dataPlane: this.options.dataPlane ?? 'claude',
+                        cwd: this.activeCwd(),
+                        cwdProvider: () => this.activeCwd(),
+                        claudeVersion: this.options.claudeVersion,
+                        provider,
+                        persistence: this.options.sessionPersistence === false ? 'memory' : 'disk',
+                        ...(this.options.providerForModel
+                            ? { providerForModel: this.options.providerForModel }
+                            : {}),
+                        baseTools,
+                        permissions: turnPermissions,
+                        ...(this.options.permissionResolverForMode
+                            ? {
+                                permissionResolverForMode: this.options.permissionResolverForMode,
+                            }
+                            : {}),
+                        parentPermissionMode: () => agentPermissionMode(this.options.interactiveTools?.mode(sessionId) ??
+                            this.options.permissionMode),
+                        ...(this.options.subagentToolNames
+                            ? {
+                                toolNames: this.capabilityToolNames(this.options.subagentToolNames, capabilities),
+                            }
+                            : {}),
+                        ...(this.options.extensions
+                            ? { extensions: this.options.extensions }
+                            : {}),
+                        ...(this.options.mcp ? { mcp: this.options.mcp } : {}),
+                        ...(this.options.hooks ? { hooks: this.options.hooks } : {}),
+                        ...(this.options.contextAssembler
+                            ? { contextAssembler: this.options.contextAssembler }
+                            : {}),
+                        ...((this.options.contextBudget?.reserveTokens ??
+                            this.options.contextReserveTokens) === undefined
+                            ? {}
+                            : {
+                                contextReserveTokens: this.options.contextBudget?.reserveTokens ??
+                                    this.options.contextReserveTokens,
+                            }),
+                        ...(this.options.approveTool
+                            ? { approveTool: this.options.approveTool }
+                            : {}),
+                        permissionUpdates: () => this.sessionPermissionUpdates.get(sessionId) ?? [],
+                        onPermissionUpdates: (updates) => this.applyPermissionUpdates(sessionId, updates),
+                        onLineChanges: (changes) => {
+                            const tracker = this.sessionCostTrackers.get(sessionId);
+                            if (!tracker) {
+                                throw new Error(`Session cost tracker is not active for session ${sessionId}`);
+                            }
+                            tracker.recordLineChanges(changes);
+                        },
+                        ...(this.options.eventSink
+                            ? { eventSink: this.options.eventSink }
+                            : {}),
+                        ...(taskTools
+                            ? {
+                                backgroundTaskNotifications: (waitForRunning) => taskTools.notifications(waitForRunning),
+                            }
+                            : {}),
+                        notificationDelivered: (notification) => transcriptContainsBackgroundAgentNotification(snapshot.entries, notification),
+                        stopOwnedBackgroundAgent: (ownerSessionId, agentId) => this.backgroundTasks.stopAgent(ownerSessionId, agentId),
+                        outputOwnedBackgroundAgent: (ownerSessionId, agentId, options) => this.backgroundTasks.outputAgent(ownerSessionId, agentId, options),
+                        sendOwnedBackgroundAgent: (ownerSessionId, agentId, message, summary, toolUseId) => this.sendOwnedBackgroundAgent(ownerSessionId, agentId, message, summary, toolUseId),
+                    })
+                    : null;
+                if (subagentExecutor) {
+                    this.subagentExecutors.add(subagentExecutor);
+                    this.subagentExecutorSessions.set(subagentExecutor, sessionId);
+                    this.backgroundTasks.registerAgents(sessionId, subagentExecutor);
                 }
-                snapshot = { entries: history, tail: appendResult.tail };
-                pendingRecoveryHookOutcomes.length = 0;
-            };
-            const capabilities = this.toolCapabilities();
-            const taskToolNames = this.capabilityToolNames(this.options.taskToolNames, capabilities);
-            const scheduledToolNames = this.capabilityToolNames(this.options.scheduledToolNames, capabilities);
-            const taskTools = this.options.tools && taskToolNames.length > 0
-                ? new ClaudeTaskToolRegistry({
-                    base: this.options.tools,
-                    cwd: this.activeCwd(),
-                    cwdProvider: () => this.activeCwd(),
-                    praxisRoot: sessionPaths.praxisRoot,
-                    sessionId,
-                    taskRoot: sessionPaths.taskRoot,
-                    ...(this.options.eventSink
-                        ? { eventSink: this.options.eventSink }
+                const agentTools = subagentExecutor
+                    ? subagentExecutor.registry(sessionId, 0, (callId) => currentPromptId ??
+                        this.promptIdForToolCall(snapshot.entries, callId))
+                    : baseTools;
+                const turnTools = this.workflowManager && subagentExecutor && agentTools
+                    ? new ClaudeWorkflowToolRegistry({
+                        base: agentTools,
+                        manager: this.workflowManager,
+                        executor: subagentExecutor,
+                        cwd: this.activeCwd(),
+                        cwdProvider: () => this.activeCwd(),
+                        configRoot: this.options.configRoot,
+                        sessionId,
+                        promptIdForCall: (callId) => currentPromptId ??
+                            this.promptIdForToolCall(snapshot.entries, callId),
+                        defaultModel: provider.model ?? 'praxis/provider',
+                        tokenBudget: workflowTokenTarget(effectivePrompt),
+                        enabled: capabilities.has('Workflow'),
+                        dataPlane: this.options.dataPlane ?? 'claude',
+                    })
+                    : agentTools;
+                const workspaceTools = this.worktreeManager &&
+                    turnTools &&
+                    this.options.workspace &&
+                    (this.options.worktreeToolNames?.length ?? 0) > 0
+                    ? new ClaudeWorktreeToolRegistry({
+                        base: turnTools,
+                        manager: this.worktreeManager,
+                        workspace: this.options.workspace,
+                        enabledTools: this.options.worktreeToolNames ?? [],
+                        dataPlane: this.options.dataPlane ?? 'claude',
+                    })
+                    : turnTools;
+                const messageTools = this.options.brief && workspaceTools
+                    ? new ClaudeUserMessageToolRegistry(workspaceTools, (message) => this.options.eventSink?.({
+                        type: 'user-message',
+                        message: message.message,
+                        status: message.status,
+                        ...(message.attachments.length
+                            ? { attachments: message.attachments }
+                            : {}),
+                    }))
+                    : workspaceTools;
+                const interactiveMessageTools = this.options.interactiveTools && messageTools
+                    ? this.options.interactiveTools.registry(messageTools, sessionId)
+                    : messageTools;
+                const fileHistoryTools = fileHistory && interactiveMessageTools
+                    ? {
+                        definitions: () => interactiveMessageTools.definitions(),
+                        schedulingPolicy: (call) => ({
+                            ...resolveToolSchedulingPolicy(interactiveMessageTools, call),
+                            startAfterAssistant: true,
+                        }),
+                        prepare: (call, context) => interactiveMessageTools.prepare(call, context),
+                        execute: async (call, context) => {
+                            const path = call.name === 'Write' || call.name === 'Edit'
+                                ? call.input.file_path
+                                : call.name === 'NotebookEdit'
+                                    ? call.input.notebook_path
+                                    : undefined;
+                            if (typeof path !== 'string') {
+                                return interactiveMessageTools.execute(call, context);
+                            }
+                            if ((call.name === 'Write' || call.name === 'Edit') &&
+                                (await this.options.interactiveTools?.isPlanFile(sessionId, path))) {
+                                return interactiveMessageTools.execute(call, context);
+                            }
+                            const snapshotMessageId = currentPromptId ??
+                                this.promptIdForToolCall(snapshot.entries, call.id);
+                            const assistantMessageId = lastAssistantUuid ??
+                                this.assistantIdForToolCall(snapshot.entries, call.id);
+                            if (!snapshotMessageId || !assistantMessageId) {
+                                throw new Error('Claude file history could not link tool call');
+                            }
+                            const prepared = await fileHistory.prepareMutation(snapshot.entries, snapshotMessageId, path);
+                            let result;
+                            try {
+                                result = await interactiveMessageTools.execute(call, context);
+                            }
+                            catch (error) {
+                                await prepared.rollback();
+                                throw error;
+                            }
+                            if (result.isError) {
+                                await prepared.rollback();
+                                return result;
+                            }
+                            const entry = prepared.commit(assistantMessageId);
+                            if (entry) {
+                                const tail = await this.append(lease, snapshot.tail, entry);
+                                snapshot = { entries: [...snapshot.entries, entry], tail };
+                            }
+                            return result;
+                        },
+                    }
+                    : interactiveMessageTools;
+                const capabilityTools = fileHistoryTools
+                    ? new ClaudeCapabilityToolRegistry(fileHistoryTools, capabilities)
+                    : undefined;
+                const structuredCapture = this.options.structuredOutputSchema
+                    ? { calls: 0, value: undefined }
+                    : undefined;
+                const agentScopedTools = agent && capabilityTools
+                    ? new FilteredToolRegistry(capabilityTools, {
+                        tools: mainAgentToolNames(capabilityTools, agent),
+                    })
+                    : capabilityTools;
+                const structuredTools = this.options.structuredOutputSchema && structuredCapture
+                    ? new StructuredOutputRegistry(agentScopedTools ?? this.options.tools ?? emptyToolRegistry, this.options.structuredOutputSchema, structuredCapture)
+                    : agentScopedTools;
+                const hookTools = this.options.hooks && structuredTools && turnPermissions
+                    ? new ClaudeHookToolCoordinator({
+                        tools: structuredTools,
+                        permissions: turnPermissions,
+                        hooks: this.options.hooks,
+                        session: hookSession,
+                        recordOutcome: recordHookOutcome,
+                        ...(this.options.eventSink
+                            ? {
+                                warn: (message) => this.options.eventSink?.({
+                                    type: 'warning',
+                                    message,
+                                }),
+                            }
+                            : {}),
+                        deferPreToolUseOutcome: (call) => pendingRecoveryToolCallIds.has(call.id),
+                    })
+                    : null;
+                const runtime = new AgentRuntime(provider, controller.emit, {
+                    emitInitialContextState: false,
+                    ...(this.options.emitToolUseSummaries
+                        ? {
+                            generateToolUseSummary: ({ tools, lastAssistantText, signal: summarySignal, }) => generateToolUseSummary(provider, tools, summarySignal, lastAssistantText, (metrics) => this.recordAuxiliaryMetrics(sessionId, metrics)),
+                        }
                         : {}),
-                    enabledTools: taskToolNames,
-                    ...(this.options.hooks
+                    ...(this.options.pricing
                         ? {
-                            taskHooks: {
-                                created: async (task, taskSignal) => {
-                                    const outcome = await this.options.hooks?.run({
-                                        ...hookSession,
-                                        hook_event_name: 'TaskCreated',
-                                        task_id: task.id,
-                                        task_subject: task.subject,
-                                        task_description: task.description,
-                                    }, undefined, taskSignal);
-                                    if (!outcome)
-                                        return;
-                                    await recordHookOutcome(outcome);
-                                    if (outcome.blockedReason) {
-                                        throw new Error(`TaskCreated hook error: ${outcome.blockedReason}`);
-                                    }
-                                },
-                                completed: async (task, taskSignal) => {
-                                    const outcome = await this.options.hooks?.run({
-                                        ...hookSession,
-                                        hook_event_name: 'TaskCompleted',
-                                        task_id: task.id,
-                                        task_subject: task.subject,
-                                        task_description: task.description,
-                                    }, undefined, taskSignal);
-                                    if (!outcome)
-                                        return;
-                                    await recordHookOutcome(outcome);
-                                    if (outcome.blockedReason) {
-                                        throw new Error(`TaskCompleted hook error: ${outcome.blockedReason}`);
-                                    }
-                                },
+                            costUsd: (usage) => {
+                                const pricing = this.options.pricing?.resolve(provider.model ?? 'praxis/provider');
+                                return pricing ? usageCostUsd(usage, pricing) : undefined;
                             },
                         }
                         : {}),
-                })
-                : null;
-            const scheduledTools = this.scheduledPrompts &&
-                this.options.tools &&
-                scheduledToolNames.length > 0
-                ? new ClaudeScheduledToolRegistry({
-                    base: taskTools ?? this.options.tools,
-                    manager: this.scheduledPrompts,
-                    sessionId,
-                    enabledTools: scheduledToolNames,
-                    dataPlane: this.options.dataPlane ?? 'claude',
-                })
-                : null;
-            const baseTools = scheduledTools ?? taskTools ?? this.options.tools;
-            const turnPermissions = this.options.interactiveTools?.permissions(sessionId) ??
-                this.options.permissions;
-            const subagentExecutor = (this.options.enableSubagents || this.options.enableWorkflows) &&
-                baseTools &&
-                turnPermissions
-                ? new ClaudeSubagentExecutor({
-                    configRoot: this.options.configRoot,
-                    dataPlane: this.options.dataPlane ?? 'claude',
-                    cwd: this.activeCwd(),
-                    cwdProvider: () => this.activeCwd(),
-                    claudeVersion: this.options.claudeVersion,
-                    provider,
-                    persistence: this.options.sessionPersistence === false ? 'memory' : 'disk',
-                    ...(this.options.providerForModel
-                        ? { providerForModel: this.options.providerForModel }
-                        : {}),
-                    baseTools,
-                    permissions: turnPermissions,
-                    ...(this.options.permissionResolverForMode
-                        ? {
-                            permissionResolverForMode: this.options.permissionResolverForMode,
-                        }
-                        : {}),
-                    parentPermissionMode: () => agentPermissionMode(this.options.interactiveTools?.mode(sessionId) ??
-                        this.options.permissionMode),
-                    ...(this.options.subagentToolNames
-                        ? {
-                            toolNames: this.capabilityToolNames(this.options.subagentToolNames, capabilities),
-                        }
-                        : {}),
-                    ...(this.options.extensions
-                        ? { extensions: this.options.extensions }
-                        : {}),
-                    ...(this.options.mcp ? { mcp: this.options.mcp } : {}),
-                    ...(this.options.hooks ? { hooks: this.options.hooks } : {}),
-                    ...(this.options.contextAssembler
-                        ? { contextAssembler: this.options.contextAssembler }
-                        : {}),
-                    ...((this.options.contextBudget?.reserveTokens ??
-                        this.options.contextReserveTokens) === undefined
+                    ...(this.options.maxBudgetUsd === undefined
                         ? {}
+                        : { maxBudgetUsd: this.options.maxBudgetUsd }),
+                    ...(hookTools
+                        ? { tools: hookTools, permissions: hookTools }
                         : {
-                            contextReserveTokens: this.options.contextBudget?.reserveTokens ??
-                                this.options.contextReserveTokens,
+                            ...(structuredTools ? { tools: structuredTools } : {}),
+                            ...(turnPermissions ? { permissions: turnPermissions } : {}),
                         }),
-                    ...(this.options.approveTool
-                        ? { approveTool: this.options.approveTool }
-                        : {}),
-                    permissionUpdates: () => this.sessionPermissionUpdates.get(sessionId) ?? [],
-                    onPermissionUpdates: (updates) => this.applyPermissionUpdates(sessionId, updates),
-                    onLineChanges: (changes) => {
-                        const tracker = this.sessionCostTrackers.get(sessionId);
-                        if (!tracker) {
-                            throw new Error(`Session cost tracker is not active for session ${sessionId}`);
-                        }
-                        tracker.recordLineChanges(changes);
+                });
+                let currentTurnUserMessages = null;
+                let currentTurnToolCalls = 0;
+                let projectMemoryMaintained = false;
+                let projectMemoryRecallMessages = [];
+                const observer = {
+                    assistantCompleted: async (message) => {
+                        const [entry] = translateProviderEvents([
+                            {
+                                type: 'assistant-message',
+                                text: message.content,
+                                ...(message.thinkingBlocks
+                                    ? { thinkingBlocks: message.thinkingBlocks }
+                                    : {}),
+                                toolCalls: message.toolCalls ?? [],
+                                providerMessageId: `msg_${randomUUID().replaceAll('-', '')}`,
+                                model: provider.model ?? 'praxis/provider',
+                            },
+                        ], this.translationContext(sessionId, snapshot));
+                        if (!entry)
+                            throw new Error('Could not translate assistant response');
+                        const tail = await this.append(lease, snapshot.tail, entry);
+                        snapshot = { entries: [...snapshot.entries, entry], tail };
+                        lastAssistantUuid =
+                            typeof entry.uuid === 'string' ? entry.uuid : lastAssistantUuid;
                     },
-                    ...(this.options.eventSink
-                        ? { eventSink: this.options.eventSink }
-                        : {}),
-                    ...(taskTools
-                        ? {
-                            backgroundTaskNotifications: (waitForRunning) => taskTools.notifications(waitForRunning),
-                        }
-                        : {}),
-                })
-                : null;
-            const agentTools = subagentExecutor
-                ? subagentExecutor.registry(sessionId, 0, (callId) => currentPromptId ??
-                    this.promptIdForToolCall(snapshot.entries, callId))
-                : baseTools;
-            const turnTools = this.workflowManager && subagentExecutor && agentTools
-                ? new ClaudeWorkflowToolRegistry({
-                    base: agentTools,
-                    manager: this.workflowManager,
-                    executor: subagentExecutor,
-                    cwd: this.activeCwd(),
-                    cwdProvider: () => this.activeCwd(),
-                    configRoot: this.options.configRoot,
-                    sessionId,
-                    promptIdForCall: (callId) => currentPromptId ??
-                        this.promptIdForToolCall(snapshot.entries, callId),
-                    defaultModel: provider.model ?? 'praxis/provider',
-                    tokenBudget: workflowTokenTarget(effectivePrompt),
-                    enabled: capabilities.has('Workflow'),
-                    dataPlane: this.options.dataPlane ?? 'claude',
-                })
-                : agentTools;
-            const workspaceTools = this.worktreeManager &&
-                turnTools &&
-                this.options.workspace &&
-                (this.options.worktreeToolNames?.length ?? 0) > 0
-                ? new ClaudeWorktreeToolRegistry({
-                    base: turnTools,
-                    manager: this.worktreeManager,
-                    workspace: this.options.workspace,
-                    enabledTools: this.options.worktreeToolNames ?? [],
-                    dataPlane: this.options.dataPlane ?? 'claude',
-                })
-                : turnTools;
-            const messageTools = this.options.brief && workspaceTools
-                ? new ClaudeUserMessageToolRegistry(workspaceTools, (message) => this.options.eventSink?.({
-                    type: 'user-message',
-                    message: message.message,
-                    status: message.status,
-                    ...(message.attachments.length
-                        ? { attachments: message.attachments }
-                        : {}),
-                }))
-                : workspaceTools;
-            const interactiveMessageTools = this.options.interactiveTools && messageTools
-                ? this.options.interactiveTools.registry(messageTools, sessionId)
-                : messageTools;
-            const fileHistoryTools = fileHistory && interactiveMessageTools
-                ? {
-                    definitions: () => interactiveMessageTools.definitions(),
-                    schedulingPolicy: (call) => ({
-                        ...resolveToolSchedulingPolicy(interactiveMessageTools, call),
-                        startAfterAssistant: true,
-                    }),
-                    prepare: (call, context) => interactiveMessageTools.prepare(call, context),
-                    execute: async (call, context) => {
-                        const path = call.name === 'Write' || call.name === 'Edit'
-                            ? call.input.file_path
-                            : call.name === 'NotebookEdit'
-                                ? call.input.notebook_path
-                                : undefined;
-                        if (typeof path !== 'string') {
-                            return interactiveMessageTools.execute(call, context);
-                        }
-                        if ((call.name === 'Write' || call.name === 'Edit') &&
-                            (await this.options.interactiveTools?.isPlanFile(sessionId, path))) {
-                            return interactiveMessageTools.execute(call, context);
-                        }
-                        const snapshotMessageId = currentPromptId ??
-                            this.promptIdForToolCall(snapshot.entries, call.id);
-                        const assistantMessageId = lastAssistantUuid ??
-                            this.assistantIdForToolCall(snapshot.entries, call.id);
-                        if (!snapshotMessageId || !assistantMessageId) {
-                            throw new Error('Claude file history could not link tool call');
-                        }
-                        const prepared = await fileHistory.prepareMutation(snapshot.entries, snapshotMessageId, path);
-                        let result;
-                        try {
-                            result = await interactiveMessageTools.execute(call, context);
-                        }
-                        catch (error) {
-                            await prepared.rollback();
-                            throw error;
-                        }
-                        if (result.isError) {
-                            await prepared.rollback();
-                            return result;
-                        }
-                        const entry = prepared.commit(assistantMessageId);
-                        if (entry) {
-                            const tail = await this.append(lease, snapshot.tail, entry);
-                            snapshot = { entries: [...snapshot.entries, entry], tail };
+                    toolCompleted: async (call, toolResult) => {
+                        currentTurnToolCalls += 1;
+                        const transition = this.worktreeManager?.consumeTransition(call.id);
+                        if (transition) {
+                            this.options.contextAssembler?.invalidate?.({
+                                lifecycleId: sessionId,
+                                reason: 'worktree',
+                            });
+                            const stateEntry = {
+                                type: 'worktree-state',
+                                worktreeSession: transition.state,
+                                sessionId,
+                            };
+                            const stateTail = await this.append(lease, snapshot.tail, stateEntry);
+                            snapshot = {
+                                entries: [...snapshot.entries, stateEntry],
+                                tail: stateTail,
+                            };
                         }
-                        return result;
-                    },
-                }
-                : interactiveMessageTools;
-            const capabilityTools = fileHistoryTools
-                ? new ClaudeCapabilityToolRegistry(fileHistoryTools, capabilities)
-                : undefined;
-            const structuredCapture = this.options.structuredOutputSchema
-                ? { calls: 0, value: undefined }
-                : undefined;
-            const agentScopedTools = agent && capabilityTools
-                ? new FilteredToolRegistry(capabilityTools, {
-                    tools: mainAgentToolNames(capabilityTools, agent),
-                })
-                : capabilityTools;
-            const structuredTools = this.options.structuredOutputSchema && structuredCapture
-                ? new StructuredOutputRegistry(agentScopedTools ?? this.options.tools ?? emptyToolRegistry, this.options.structuredOutputSchema, structuredCapture)
-                : agentScopedTools;
-            const hookTools = this.options.hooks && structuredTools && turnPermissions
-                ? new ClaudeHookToolCoordinator({
-                    tools: structuredTools,
-                    permissions: turnPermissions,
-                    hooks: this.options.hooks,
-                    session: hookSession,
-                    recordOutcome: recordHookOutcome,
-                    ...(this.options.eventSink
-                        ? {
-                            warn: (message) => this.options.eventSink?.({ type: 'warning', message }),
+                        const permissionMode = this.options.interactiveTools?.consumeTransition(call.id);
+                        if (permissionMode) {
+                            const modeEntry = {
+                                type: 'permission-mode',
+                                permissionMode,
+                                sessionId,
+                            };
+                            const modeTail = await this.append(lease, snapshot.tail, modeEntry);
+                            snapshot = {
+                                entries: [...snapshot.entries, modeEntry],
+                                tail: modeTail,
+                            };
                         }
-                        : {}),
-                    deferPreToolUseOutcome: (call) => pendingRecoveryToolCallIds.has(call.id),
-                })
-                : null;
-            const runtime = new AgentRuntime(provider, this.options.eventSink, {
-                emitInitialContextState: false,
-                ...(this.options.emitToolUseSummaries
-                    ? {
-                        generateToolUseSummary: ({ tools, lastAssistantText, signal }) => generateToolUseSummary(provider, tools, signal, lastAssistantText, (metrics) => this.recordAuxiliaryMetrics(sessionId, metrics)),
-                    }
-                    : {}),
-                ...(this.options.pricing
-                    ? {
-                        costUsd: (usage) => {
-                            const pricing = this.options.pricing?.resolve(provider.model ?? 'praxis/provider');
-                            return pricing ? usageCostUsd(usage, pricing) : undefined;
-                        },
-                    }
-                    : {}),
-                ...(this.options.maxBudgetUsd === undefined
-                    ? {}
-                    : { maxBudgetUsd: this.options.maxBudgetUsd }),
-                ...(hookTools
-                    ? { tools: hookTools, permissions: hookTools }
-                    : {
-                        ...(structuredTools ? { tools: structuredTools } : {}),
-                        ...(turnPermissions ? { permissions: turnPermissions } : {}),
-                    }),
-            });
-            let currentTurnUserMessages = null;
-            let currentTurnToolCalls = 0;
-            let projectMemoryMaintained = false;
-            let projectMemoryRecallMessages = [];
-            const observer = {
-                assistantCompleted: async (message) => {
-                    const [entry] = translateProviderEvents([
-                        {
-                            type: 'assistant-message',
-                            text: message.content,
-                            ...(message.thinkingBlocks
-                                ? { thinkingBlocks: message.thinkingBlocks }
-                                : {}),
-                            toolCalls: message.toolCalls ?? [],
-                            providerMessageId: `msg_${randomUUID().replaceAll('-', '')}`,
-                            model: provider.model ?? 'praxis/provider',
-                        },
-                    ], this.translationContext(sessionId, snapshot));
-                    if (!entry)
-                        throw new Error('Could not translate assistant response');
-                    const tail = await this.append(lease, snapshot.tail, entry);
-                    snapshot = { entries: [...snapshot.entries, entry], tail };
-                    lastAssistantUuid =
-                        typeof entry.uuid === 'string' ? entry.uuid : lastAssistantUuid;
-                },
-                toolCompleted: async (call, toolResult) => {
-                    currentTurnToolCalls += 1;
-                    const transition = this.worktreeManager?.consumeTransition(call.id);
-                    if (transition) {
-                        this.options.contextAssembler?.invalidate?.({
-                            lifecycleId: sessionId,
-                            reason: 'worktree',
-                        });
-                        const stateEntry = {
-                            type: 'worktree-state',
-                            worktreeSession: transition.state,
-                            sessionId,
-                        };
-                        const stateTail = await this.append(lease, snapshot.tail, stateEntry);
-                        snapshot = {
-                            entries: [...snapshot.entries, stateEntry],
-                            tail: stateTail,
-                        };
-                    }
-                    const permissionMode = this.options.interactiveTools?.consumeTransition(call.id);
-                    if (permissionMode) {
-                        const modeEntry = {
-                            type: 'permission-mode',
-                            permissionMode,
-                            sessionId,
-                        };
-                        const modeTail = await this.append(lease, snapshot.tail, modeEntry);
-                        snapshot = {
-                            entries: [...snapshot.entries, modeEntry],
-                            tail: modeTail,
-                        };
-                    }
-                    const [entry] = translateProviderEvents([
-                        {
-                            type: 'tool-result',
-                            toolCallId: call.id,
-                            content: toolResult.content,
-                            ...(toolResult.contentBlocks
-                                ? { contentBlocks: toolResult.contentBlocks }
-                                : {}),
-                            ...(toolResult.images ? { images: toolResult.images } : {}),
-                            ...(toolResult.documents
-                                ? { documents: toolResult.documents }
-                                : {}),
-                            isError: toolResult.isError,
-                            ...(toolResult.nativeToolUseResult
-                                ? { nativeToolUseResult: toolResult.nativeToolUseResult }
-                                : {}),
-                            ...(toolResult.nativeMcpMeta
-                                ? { nativeMcpMeta: toolResult.nativeMcpMeta }
-                                : {}),
-                        },
-                    ], this.translationContext(sessionId, snapshot));
-                    if (!entry)
-                        throw new Error('Could not translate tool result');
-                    const tail = await this.append(lease, snapshot.tail, entry);
-                    snapshot = { entries: [...snapshot.entries, entry], tail };
-                    if (!toolResult.isError && this.options.projectMemoryDirectory) {
-                        const pathValue = call.input.file_path;
-                        const path = typeof pathValue === 'string'
-                            ? resolve(this.activeCwd(), pathValue)
-                            : null;
-                        if (path &&
-                            isPathWithin(this.options.projectMemoryDirectory, path)) {
-                            if (call.name === 'Read') {
-                                this.options.projectMemoryRecall?.recordRead(sessionId, path);
+                        const [entry] = translateProviderEvents([
+                            {
+                                type: 'tool-result',
+                                toolCallId: call.id,
+                                content: toolResult.content,
+                                ...(toolResult.contentBlocks
+                                    ? { contentBlocks: toolResult.contentBlocks }
+                                    : {}),
+                                ...(toolResult.images ? { images: toolResult.images } : {}),
+                                ...(toolResult.documents
+                                    ? { documents: toolResult.documents }
+                                    : {}),
+                                isError: toolResult.isError,
+                                ...(toolResult.nativeToolUseResult
+                                    ? { nativeToolUseResult: toolResult.nativeToolUseResult }
+                                    : {}),
+                                ...(toolResult.nativeMcpMeta
+                                    ? { nativeMcpMeta: toolResult.nativeMcpMeta }
+                                    : {}),
+                            },
+                        ], this.translationContext(sessionId, snapshot));
+                        if (!entry)
+                            throw new Error('Could not translate tool result');
+                        const tail = await this.append(lease, snapshot.tail, entry);
+                        snapshot = { entries: [...snapshot.entries, entry], tail };
+                        if (!toolResult.isError && this.options.projectMemoryDirectory) {
+                            const pathValue = call.input.file_path;
+                            const path = typeof pathValue === 'string'
+                                ? resolve(this.activeCwd(), pathValue)
+                                : null;
+                            if (path &&
+                                isPathWithin(this.options.projectMemoryDirectory, path)) {
+                                if (call.name === 'Read') {
+                                    this.options.projectMemoryRecall?.recordRead(sessionId, path);
+                                }
+                                else if (call.name === 'Write' || call.name === 'Edit') {
+                                    projectMemoryMaintained = true;
+                                }
                             }
-                            else if (call.name === 'Write' || call.name === 'Edit') {
-                                projectMemoryMaintained = true;
+                            if (call.name === 'Read') {
+                                for (const accessedPath of toolResult.accessedPaths ?? []) {
+                                    const resolvedAccessedPath = resolve(this.activeCwd(), accessedPath);
+                                    if (isPathWithin(this.options.projectMemoryDirectory, resolvedAccessedPath)) {
+                                        this.options.projectMemoryRecall?.recordRead(sessionId, resolvedAccessedPath);
+                                    }
+                                }
                             }
                         }
-                        if (call.name === 'Read') {
-                            for (const accessedPath of toolResult.accessedPaths ?? []) {
-                                const resolvedAccessedPath = resolve(this.activeCwd(), accessedPath);
-                                if (isPathWithin(this.options.projectMemoryDirectory, resolvedAccessedPath)) {
-                                    this.options.projectMemoryRecall?.recordRead(sessionId, resolvedAccessedPath);
-                                }
+                        if (toolResult.isError ||
+                            call.name !== 'Read' ||
+                            !this.options.conditionalRuleResolver ||
+                            !toolResult.accessedPaths) {
+                            return;
+                        }
+                        const attachedRulePaths = this.attachedRulePaths(snapshot.entries);
+                        for (const filePath of toolResult.accessedPaths) {
+                            const rules = await this.options.conditionalRuleResolver.resolve(filePath, [...attachedRulePaths]);
+                            for (const rule of rules) {
+                                const attachment = createClaudeRuleAttachmentEntry(rule, this.displayRulePath(rule.path), this.translationContext(sessionId, snapshot));
+                                const attachmentTail = await this.append(lease, snapshot.tail, attachment);
+                                snapshot = {
+                                    entries: [...snapshot.entries, attachment],
+                                    tail: attachmentTail,
+                                };
+                                attachedRulePaths.add(rule.path);
+                                await this.instructionLoaded(sessionId, {
+                                    path: rule.path,
+                                    memoryType: rule.scope === 'user'
+                                        ? 'User'
+                                        : rule.scope === 'local'
+                                            ? 'Local'
+                                            : 'Project',
+                                    globs: rule.globs,
+                                    triggerFilePath: filePath,
+                                    ...(rule.importedFrom === undefined
+                                        ? {}
+                                        : { parentFilePath: rule.importedFrom }),
+                                }, 'path_glob_match');
                             }
                         }
-                    }
-                    if (toolResult.isError ||
-                        call.name !== 'Read' ||
-                        !this.options.conditionalRuleResolver ||
-                        !toolResult.accessedPaths) {
-                        return;
-                    }
-                    const attachedRulePaths = this.attachedRulePaths(snapshot.entries);
-                    for (const filePath of toolResult.accessedPaths) {
-                        const rules = await this.options.conditionalRuleResolver.resolve(filePath, [...attachedRulePaths]);
-                        for (const rule of rules) {
-                            const attachment = createClaudeRuleAttachmentEntry(rule, this.displayRulePath(rule.path), this.translationContext(sessionId, snapshot));
-                            const attachmentTail = await this.append(lease, snapshot.tail, attachment);
+                    },
+                    followUpUserMessagesCompleted: async (messages) => {
+                        for (const content of messages) {
+                            const [followUpEntry] = translateProviderEvents([{ type: 'user-text-block', text: content }], this.translationContext(sessionId, snapshot));
+                            if (!followUpEntry) {
+                                throw new Error('Could not translate tool follow-up message');
+                            }
+                            const followUpTail = await this.append(lease, snapshot.tail, followUpEntry);
                             snapshot = {
-                                entries: [...snapshot.entries, attachment],
-                                tail: attachmentTail,
+                                entries: [...snapshot.entries, followUpEntry],
+                                tail: followUpTail,
                             };
-                            attachedRulePaths.add(rule.path);
-                            await this.instructionLoaded(sessionId, {
-                                path: rule.path,
-                                memoryType: rule.scope === 'user'
-                                    ? 'User'
-                                    : rule.scope === 'local'
-                                        ? 'Local'
-                                        : 'Project',
-                                globs: rule.globs,
-                                triggerFilePath: filePath,
-                                ...(rule.importedFrom === undefined
-                                    ? {}
-                                    : { parentFilePath: rule.importedFrom }),
-                            }, 'path_glob_match');
+                            currentTurnUserMessages?.push(content);
+                            await Promise.all(this.sessionSubagentExecutors(sessionId, true).map((executor) => executor.acknowledgeNotifications([content])));
                         }
+                    },
+                };
+                let turnCompleted = false;
+                try {
+                    const outcome = await this.hookLifecycle.start(sessionId, hookSession, requireExisting ? 'resume' : 'startup', signal);
+                    if (outcome) {
+                        await recordHookOutcome(outcome, pendingRecoveryToolCallIds.size > 0);
                     }
-                },
-                followUpUserMessagesCompleted: async (messages) => {
-                    for (const content of messages) {
-                        const [followUpEntry] = translateProviderEvents([{ type: 'user-text-block', text: content }], this.translationContext(sessionId, snapshot));
-                        if (!followUpEntry) {
-                            throw new Error('Could not translate tool follow-up message');
-                        }
-                        const followUpTail = await this.append(lease, snapshot.tail, followUpEntry);
+                    const approveRecovery = this.options.approveRecovery;
+                    const recoveryRequest = {
+                        cwd: this.activeCwd(),
+                        toolResultDirectory,
+                        messages: projectClaudeModelMessages(snapshot.entries),
+                        observer,
+                        permissionUpdates: this.sessionPermissionUpdates.get(sessionId) ?? [],
+                        onPermissionUpdates: (updates) => this.applyPermissionUpdates(sessionId, updates),
+                        ...(signal ? { signal } : {}),
+                        ...(approveRecovery
+                            ? {
+                                approveRecovery: async (call) => {
+                                    if (!(await approveRecovery(call))) {
+                                        throw new Error(`Claude session tool call ${call.id} recovery was declined`);
+                                    }
+                                    if (signal?.aborted)
+                                        throw new AgentRunCancelledError();
+                                    await flushRecoveryHookOutcomes();
+                                    pendingRecoveryToolCallIds.delete(call.id);
+                                    return true;
+                                },
+                                approveTool: () => true,
+                            }
+                            : {}),
+                    };
+                    const unresolvedToolCall = unresolvedToolCalls[0];
+                    if (unresolvedToolCall && !approveRecovery) {
+                        throw new Error(`Claude session tool call ${unresolvedToolCall.id} requires explicit recovery approval`);
+                    }
+                    const recoveryResults = await runtime.recoverToolCalls(unresolvedToolCalls, recoveryRequest);
+                    const recoveryUsage = recoveryResults.reduce((usage, result) => result.usage ? mergeUsage(usage, result.usage) : usage, { inputTokens: 0, outputTokens: 0 });
+                    const recoveryModelUsage = mergeSessionRawModelUsage(...recoveryResults.map((result) => result.isError ? undefined : result.modelUsage));
+                    const foregroundLineChanges = createLineCountAccumulator();
+                    for (const result of recoveryResults) {
+                        foregroundLineChanges.add(result);
+                    }
+                    if (this.options.agent &&
+                        agent &&
+                        getClaudeAgentSetting(snapshot.entries) !== this.options.agent) {
+                        const agentSetting = createClaudeAgentSettingEntry(sessionId, this.options.agent);
+                        const settingTail = await this.append(lease, snapshot.tail, agentSetting);
                         snapshot = {
-                            entries: [...snapshot.entries, followUpEntry],
-                            tail: followUpTail,
+                            entries: [...snapshot.entries, agentSetting],
+                            tail: settingTail,
                         };
-                        currentTurnUserMessages?.push(content);
                     }
-                },
-            };
-            let turnCompleted = false;
-            try {
-                const outcome = await this.hookLifecycle.start(sessionId, hookSession, requireExisting ? 'resume' : 'startup', signal);
-                if (outcome) {
-                    await recordHookOutcome(outcome, pendingRecoveryToolCallIds.size > 0);
-                }
-                const approveRecovery = this.options.approveRecovery;
-                const recoveryRequest = {
-                    cwd: this.activeCwd(),
-                    toolResultDirectory,
-                    messages: projectClaudeModelMessages(snapshot.entries),
-                    observer,
-                    permissionUpdates: this.sessionPermissionUpdates.get(sessionId) ?? [],
-                    onPermissionUpdates: (updates) => this.applyPermissionUpdates(sessionId, updates),
-                    ...(signal ? { signal } : {}),
-                    ...(approveRecovery
-                        ? {
-                            approveRecovery: async (call) => {
-                                if (!(await approveRecovery(call))) {
-                                    throw new Error(`Claude session tool call ${call.id} recovery was declined`);
-                                }
-                                if (signal?.aborted)
-                                    throw new AgentRunCancelledError();
-                                await flushRecoveryHookOutcomes();
-                                pendingRecoveryToolCallIds.delete(call.id);
-                                return true;
+                    const sessionMemory = this.sessionMemoryController(sessionId);
+                    let agentSystem = null;
+                    let planModeMessage;
+                    let sessionMemoryMessage = null;
+                    let contextMessages = [];
+                    let contextProjection = {
+                        systemMessages: [],
+                        stableSystemSectionCount: 0,
+                    };
+                    let stableSystemMessageCount = 0;
+                    const refreshRuntimeContext = async () => {
+                        agentSystem = await this.mainAgentSystemPrompt(agent);
+                        planModeMessage =
+                            this.options.interactiveTools?.contextMessage(sessionId);
+                        sessionMemoryMessage = sessionMemory
+                            ? this.sessionMemoryMessage(await sessionMemory.summary())
+                            : null;
+                        const assembledContext = await assembleContextSnapshot(this.options.contextAssembler, {
+                            cwd: this.activeCwd(),
+                            lifecycleId: sessionId,
+                            ...(agentSystem
+                                ? { mode: 'agent', baseSystemPrompt: agentSystem }
+                                : {}),
+                            turn: {
+                                ...(planModeMessage ? { planMode: planModeMessage } : {}),
+                                ...(sessionMemoryMessage
+                                    ? { sessionMemory: sessionMemoryMessage }
+                                    : {}),
+                                ...(this.options.brief ? { briefOutput: true } : {}),
+                                ...(this.options.structuredOutputSchema
+                                    ? { structuredOutput: true }
+                                    : {}),
                             },
-                            approveTool: () => true,
-                        }
-                        : {}),
-                };
-                const unresolvedToolCall = unresolvedToolCalls[0];
-                if (unresolvedToolCall && !approveRecovery) {
-                    throw new Error(`Claude session tool call ${unresolvedToolCall.id} requires explicit recovery approval`);
-                }
-                const recoveryResults = await runtime.recoverToolCalls(unresolvedToolCalls, recoveryRequest);
-                const recoveryUsage = recoveryResults.reduce((usage, result) => result.usage ? mergeUsage(usage, result.usage) : usage, { inputTokens: 0, outputTokens: 0 });
-                const recoveryModelUsage = mergeSessionRawModelUsage(...recoveryResults.map((result) => result.isError ? undefined : result.modelUsage));
-                const foregroundLineChanges = createLineCountAccumulator();
-                for (const result of recoveryResults) {
-                    foregroundLineChanges.add(result);
-                }
-                if (this.options.agent &&
-                    agent &&
-                    getClaudeAgentSetting(snapshot.entries) !== this.options.agent) {
-                    const agentSetting = createClaudeAgentSettingEntry(sessionId, this.options.agent);
-                    const settingTail = await this.append(lease, snapshot.tail, agentSetting);
-                    snapshot = {
-                        entries: [...snapshot.entries, agentSetting],
-                        tail: settingTail,
+                        });
+                        contextProjection = projectContextSnapshot(assembledContext);
+                        stableSystemMessageCount =
+                            contextProjection.stableSystemSectionCount;
+                        contextMessages = [...contextProjection.systemMessages];
                     };
-                }
-                const sessionMemory = this.sessionMemoryController(sessionId);
-                let assembledContext;
-                let agentSystem = null;
-                let planModeMessage;
-                let sessionMemoryMessage = null;
-                let contextMessages = [];
-                let stableSystemMessageCount;
-                const refreshRuntimeContext = async () => {
-                    agentSystem = await this.mainAgentSystemPrompt(agent);
-                    planModeMessage =
-                        this.options.interactiveTools?.contextMessage(sessionId);
-                    sessionMemoryMessage = sessionMemory
-                        ? this.sessionMemoryMessage(await sessionMemory.summary())
-                        : null;
-                    const additionalSections = [
-                        ...(planModeMessage
-                            ? [
-                                {
-                                    id: 'plan-mode',
-                                    placement: 'system',
-                                    stability: 'volatile',
-                                    content: planModeMessage,
-                                },
-                            ]
-                            : []),
-                        ...(sessionMemoryMessage
-                            ? [
-                                {
-                                    id: 'session-memory',
-                                    placement: 'system',
-                                    stability: 'volatile',
-                                    content: sessionMemoryMessage,
-                                },
-                            ]
-                            : []),
-                        ...(this.options.brief
-                            ? [
-                                {
-                                    id: 'brief-output',
-                                    placement: 'system',
-                                    stability: 'volatile',
-                                    content: CLAUDE_USER_MESSAGE_PROMPT,
-                                },
-                            ]
-                            : []),
-                        ...(this.options.structuredOutputSchema
-                            ? [
-                                {
-                                    id: 'structured-output',
-                                    placement: 'system',
-                                    stability: 'volatile',
-                                    content: 'You MUST call StructuredOutput exactly once at the end with a value matching the requested JSON Schema.',
-                                },
-                            ]
-                            : []),
-                    ];
-                    assembledContext = await this.options.contextAssembler?.assemble({
-                        cwd: this.activeCwd(),
-                        lifecycleId: sessionId,
-                        ...(agentSystem
-                            ? { mode: 'agent', baseSystemPrompt: agentSystem }
-                            : {}),
-                        additionalSections,
+                    await refreshRuntimeContext();
+                    const expansion = skipUserPrompt
+                        ? { userMessages: [] }
+                        : shellCommand === undefined
+                            ? this.options.extensions
+                                ? await this.options.extensions.expandPromptAsync(effectivePrompt, signal, toolResultDirectory)
+                                : { userMessages: [effectivePrompt] }
+                            : {
+                                userMessages: [`<bash-input>${shellCommand}</bash-input>`],
+                            };
+                    const expansionMessages = 'messages' in expansion ? expansion.messages : undefined;
+                    const userMessages = 'userMessages' in expansion ? expansion.userMessages : [];
+                    const expandedMessages = expansionMessages ?? userMessages.map((text) => ({ text }));
+                    const attachmentIndex = expansionMessages
+                        ? expandedMessages.length - 1
+                        : 0;
+                    currentTurnUserMessages = [...expansion.userMessages];
+                    this.options.eventSink?.({
+                        type: 'state',
+                        state: 'assembling-context',
                     });
-                    const hasPromptManifest = assembledContext?.promptSections !== undefined;
-                    stableSystemMessageCount = hasPromptManifest
-                        ? assembledContext?.stableSystemSectionCount
-                        : undefined;
-                    const assembledSystemMessages = hasPromptManifest
-                        ? (assembledContext?.systemMessages ?? [])
-                        : this.assembledSystemMessages(agent, assembledContext?.systemMessages ?? []);
-                    contextMessages = [
-                        ...(!hasPromptManifest && agentSystem
-                            ? [{ role: 'system', content: agentSystem }]
-                            : []),
-                        ...assembledSystemMessages,
-                        ...(!hasPromptManifest && planModeMessage
-                            ? [{ role: 'system', content: planModeMessage }]
-                            : []),
-                        ...(!hasPromptManifest && sessionMemoryMessage
-                            ? [{ role: 'system', content: sessionMemoryMessage }]
-                            : []),
-                        ...(!hasPromptManifest && this.options.brief
-                            ? [
-                                {
-                                    role: 'system',
-                                    content: CLAUDE_USER_MESSAGE_PROMPT,
-                                },
-                            ]
-                            : []),
-                        ...(!hasPromptManifest && this.options.structuredOutputSchema
-                            ? [
-                                {
-                                    role: 'system',
-                                    content: 'You MUST call StructuredOutput exactly once at the end with a value matching the requested JSON Schema.',
-                                },
-                            ]
-                            : []),
-                    ];
-                };
-                await refreshRuntimeContext();
-                const expansion = skipUserPrompt
-                    ? { userMessages: [] }
-                    : shellCommand === undefined
-                        ? this.options.extensions
-                            ? await this.options.extensions.expandPromptAsync(effectivePrompt, signal, toolResultDirectory)
-                            : { userMessages: [effectivePrompt] }
-                        : {
-                            userMessages: [`<bash-input>${shellCommand}</bash-input>`],
-                        };
-                const expandedMessages = expansion.messages ?? expansion.userMessages.map((text) => ({ text }));
-                const attachmentIndex = expansion.messages
-                    ? expandedMessages.length - 1
-                    : 0;
-                currentTurnUserMessages = [...expansion.userMessages];
-                this.options.eventSink?.({
-                    type: 'state',
-                    state: 'assembling-context',
-                });
-                let compactionUsage = {
-                    inputTokens: 0,
-                    outputTokens: 0,
-                };
-                let compactionDurationMs;
-                let compactionDurationWithoutRetriesMs;
-                let compactionModelUsage;
-                const definitions = provider.capabilities.tools
-                    ? (structuredTools?.definitions() ?? [])
-                    : [];
-                const budget = this.contextBudget(provider);
-                const recoveryPlanner = new ContextRecoveryPlanner();
-                const pendingUserMessages = expandedMessages.map((message, index) => ({
-                    role: 'user',
-                    content: message.text,
-                    ...(message.contentBlocks?.length
-                        ? { contentBlocks: message.contentBlocks }
-                        : {}),
-                    ...((index === attachmentIndex && images.length > 0) ||
-                        message.images?.length
-                        ? {
-                            images: [
-                                ...(index === attachmentIndex ? images : []),
-                                ...(message.images ?? []),
-                            ],
-                        }
-                        : {}),
-                    ...(index === attachmentIndex && documents.length > 0
-                        ? { documents }
-                        : {}),
-                }));
-                const agentMentionMessages = shellCommand === undefined && !skipUserPrompt
-                    ? (this.options.extensions?.agentMentionMessages(effectivePrompt) ??
-                        [])
-                    : [];
-                const injectAgentMentionContext = (messages) => {
-                    if (agentMentionMessages.length === 0)
-                        return [...messages];
-                    let insertionIndex = messages.length;
-                    let foundPrompt = false;
-                    for (let index = messages.length - 1; index >= 0; index -= 1) {
-                        const message = messages[index];
-                        if (message?.role === 'user' &&
-                            typeof message.content === 'string' &&
-                            message.content.endsWith(effectivePrompt)) {
-                            insertionIndex = index;
-                            foundPrompt = true;
-                            break;
+                    let compactionUsage = {
+                        inputTokens: 0,
+                        outputTokens: 0,
+                    };
+                    let compactionDurationMs;
+                    let compactionDurationWithoutRetriesMs;
+                    let compactionModelUsage;
+                    const definitions = provider.capabilities.tools
+                        ? (structuredTools?.definitions() ?? [])
+                        : [];
+                    const budget = this.contextBudget(provider);
+                    const recoveryPlanner = new ContextRecoveryPlanner();
+                    const pendingUserMessages = expandedMessages.map((message, index) => ({
+                        role: 'user',
+                        content: message.text,
+                        ...(message.contentBlocks?.length
+                            ? { contentBlocks: message.contentBlocks }
+                            : {}),
+                        ...((index === attachmentIndex && images.length > 0) ||
+                            message.images?.length
+                            ? {
+                                images: [
+                                    ...(index === attachmentIndex ? images : []),
+                                    ...(message.images ?? []),
+                                ],
+                            }
+                            : {}),
+                        ...(index === attachmentIndex && documents.length > 0
+                            ? { documents }
+                            : {}),
+                    }));
+                    const agentMentionMessages = shellCommand === undefined && !skipUserPrompt
+                        ? (this.options.extensions?.agentMentionMessages(effectivePrompt) ?? [])
+                        : [];
+                    const injectAgentMentionContext = (messages) => {
+                        if (agentMentionMessages.length === 0)
+                            return [...messages];
+                        let insertionIndex = messages.length;
+                        let foundPrompt = false;
+                        for (let index = messages.length - 1; index >= 0; index -= 1) {
+                            const message = messages[index];
+                            if (message?.role === 'user' &&
+                                typeof message.content === 'string' &&
+                                message.content.endsWith(effectivePrompt)) {
+                                insertionIndex = index;
+                                foundPrompt = true;
+                                break;
+                            }
                         }
-                    }
-                    if (!foundPrompt)
-                        return [...messages];
-                    return [
-                        ...messages.slice(0, insertionIndex),
-                        ...agentMentionMessages.map((content) => ({
-                            role: 'user',
-                            content,
-                        })),
-                        ...messages.slice(insertionIndex),
-                    ];
-                };
-                const injectDynamicContext = (messages) => injectFirstUserMessageContext(messages, assembledContext?.firstUserMessageContext);
-                const injectTurnContext = (messages) => injectAgentMentionContext(injectDynamicContext(messages));
-                let compactionAnchorUuid = this.lastMessageUuid(snapshot.entries);
-                const compactIfNeeded = async (pendingMessages = [], preservedUserMessages = [], options = {}) => {
-                    if (!budget || this.options.autoCompact === false)
-                        return;
-                    const historyMessages = [
-                        ...projectClaudeModelMessages(snapshot.entries),
-                        ...projectMemoryRecallMessages,
-                    ];
-                    const predicted = budget.evaluate([
-                        ...contextMessages,
-                        ...injectTurnContext([...historyMessages, ...pendingMessages]),
-                    ], definitions, options);
-                    if (!predicted.shouldCompact)
-                        return;
-                    const irreducibleMessages = [
-                        ...contextMessages,
-                        ...injectTurnContext([
-                            ...pendingMessages,
-                            ...preservedUserMessages.map((content) => ({
+                        if (!foundPrompt)
+                            return [...messages];
+                        return [
+                            ...messages.slice(0, insertionIndex),
+                            ...agentMentionMessages.map((content) => ({
                                 role: 'user',
                                 content,
                             })),
-                        ]),
-                    ];
-                    const irreducible = budget.evaluate(irreducibleMessages, definitions);
-                    budget.assertFits(irreducible);
-                    let logicalParentUuid = compactionAnchorUuid;
-                    if (!logicalParentUuid || historyMessages.length === 0) {
-                        budget.assertFits(predicted);
-                        throw new Error('Cannot compact an empty Claude transcript');
-                    }
-                    if (findUnresolvedClaudeToolCalls(snapshot.entries).length > 0) {
-                        throw new Error('Cannot compact a Claude session with unresolved tool calls');
-                    }
-                    const preCompact = await this.runAdvisoryHook(sessionId, 'PreCompact', { trigger: 'auto', custom_instructions: null }, 'auto', signal);
-                    const memorySelection = sessionMemory
-                        ? await this.selectMemoryPreservedCompact(sessionId, selectClaudeActiveTranscript(snapshot.entries))
-                        : null;
-                    const compactorMessages = memorySelection
-                        ? [
-                            memorySelection.memoryMessage,
-                            ...projectClaudeModelMessages(memorySelection.compactedEntries),
-                        ]
-                        : historyMessages;
-                    compactorMessages.push(...successfulHookOutput(preCompact).map((content) => ({
-                        role: 'user',
-                        content: `Additional summarization context: ${content}`,
-                    })));
-                    if (memorySelection) {
-                        logicalParentUuid = memorySelection.logicalParentUuid;
-                    }
-                    this.options.eventSink?.({ type: 'state', state: 'compacting' });
-                    const compactEnvelope = budget.evaluate([
-                        ...irreducibleMessages,
-                        {
+                            ...messages.slice(insertionIndex),
+                        ];
+                    };
+                    const injectDynamicContext = (messages) => injectFirstUserMessageContext(messages, contextProjection.firstUserMessageContext);
+                    const injectTurnContext = (messages) => injectAgentMentionContext(injectDynamicContext(messages));
+                    let compactionAnchorUuid = this.lastMessageUuid(snapshot.entries);
+                    const compactIfNeeded = async (pendingMessages = [], preservedUserMessages = [], options = {}) => {
+                        if (!budget || this.options.autoCompact === false)
+                            return;
+                        const historyMessages = [
+                            ...projectClaudeModelMessages(snapshot.entries),
+                            ...projectMemoryRecallMessages,
+                        ];
+                        const predicted = budget.evaluate([
+                            ...contextMessages,
+                            ...injectTurnContext([...historyMessages, ...pendingMessages]),
+                        ], definitions, options);
+                        if (!predicted.shouldCompact)
+                            return;
+                        const irreducibleMessages = [
+                            ...contextMessages,
+                            ...injectTurnContext([
+                                ...pendingMessages,
+                                ...preservedUserMessages.map((content) => ({
+                                    role: 'user',
+                                    content,
+                                })),
+                            ]),
+                        ];
+                        const irreducible = budget.evaluate(irreducibleMessages, definitions);
+                        budget.assertFits(irreducible);
+                        let logicalParentUuid = compactionAnchorUuid;
+                        if (!logicalParentUuid || historyMessages.length === 0) {
+                            budget.assertFits(predicted);
+                            throw new Error('Cannot compact an empty Claude transcript');
+                        }
+                        if (findUnresolvedClaudeToolCalls(snapshot.entries).length > 0) {
+                            throw new Error('Cannot compact a Claude session with unresolved tool calls');
+                        }
+                        const preCompact = await this.runAdvisoryHook(sessionId, 'PreCompact', { trigger: 'auto', custom_instructions: null }, 'auto', signal);
+                        const memorySelection = sessionMemory
+                            ? await this.selectMemoryPreservedCompact(sessionId, selectClaudeActiveTranscript(snapshot.entries))
+                            : null;
+                        const compactorMessages = memorySelection
+                            ? [
+                                memorySelection.memoryMessage,
+                                ...projectClaudeModelMessages(memorySelection.compactedEntries),
+                            ]
+                            : historyMessages;
+                        compactorMessages.push(...successfulHookOutput(preCompact).map((content) => ({
                             role: 'user',
-                            content: formatClaudeCompactSummary(''),
-                        },
-                    ], definitions);
-                    let targetTokens = Math.min(8192, compactEnvelope.availableTokens - compactEnvelope.estimatedTokens);
-                    if (targetTokens < 1) {
-                        budget.assertFits(budget.evaluate([
+                            content: `Additional summarization context: ${content}`,
+                        })));
+                        if (memorySelection) {
+                            logicalParentUuid = memorySelection.logicalParentUuid;
+                        }
+                        this.options.eventSink?.({ type: 'state', state: 'compacting' });
+                        const compactEnvelope = budget.evaluate([
                             ...irreducibleMessages,
                             {
                                 role: 'user',
-                                content: formatClaudeCompactSummary('a'),
+                                content: formatClaudeCompactSummary(''),
                             },
-                        ], definitions));
-                        targetTokens = 1;
-                    }
-                    const compacted = await (this.options.compactor ?? new ModelCompactor(provider)).compact({
-                        messages: compactorMessages,
-                        targetTokens,
-                        contextWindowTokens: budget.contextWindowTokens,
-                        ...(signal ? { signal } : {}),
-                    });
-                    const { durationMs: compactedDurationMs, durationWithoutRetriesMs: compactedDurationWithoutRetriesMs, } = requireCompactionDurations(compacted);
-                    const proposedCompactionDurationMs = (compactionDurationMs ?? 0) + compactedDurationMs;
-                    if (!Number.isFinite(proposedCompactionDurationMs)) {
-                        throw new TypeError('compaction durationMs total overflow');
-                    }
-                    const proposedCompactionDurationWithoutRetriesMs = (compactionDurationWithoutRetriesMs ?? 0) +
-                        compactedDurationWithoutRetriesMs;
-                    if (!Number.isFinite(proposedCompactionDurationWithoutRetriesMs)) {
-                        throw new TypeError('compaction durationWithoutRetriesMs total overflow');
-                    }
-                    const boundaryUuid = randomUUID();
-                    const summaryUuid = randomUUID();
-                    const timestamp = new Date().toISOString();
-                    const preTokens = budget.evaluate([...contextMessages, ...injectTurnContext(historyMessages)], definitions).estimatedTokens;
-                    const compactEntries = (postTokens) => {
-                        const uuids = [boundaryUuid, summaryUuid];
-                        return createClaudeCompactEntries({
+                        ], definitions);
+                        let targetTokens = Math.min(8192, compactEnvelope.availableTokens - compactEnvelope.estimatedTokens);
+                        if (targetTokens < 1) {
+                            budget.assertFits(budget.evaluate([
+                                ...irreducibleMessages,
+                                {
+                                    role: 'user',
+                                    content: formatClaudeCompactSummary('a'),
+                                },
+                            ], definitions));
+                            targetTokens = 1;
+                        }
+                        const compacted = await (this.options.compactor ?? new ModelCompactor(provider)).compact({
+                            messages: compactorMessages,
+                            targetTokens,
+                            contextWindowTokens: budget.contextWindowTokens,
+                            ...(signal ? { signal } : {}),
+                        });
+                        const { durationMs: compactedDurationMs, durationWithoutRetriesMs: compactedDurationWithoutRetriesMs, } = requireCompactionDurations(compacted);
+                        const proposedCompactionDurationMs = (compactionDurationMs ?? 0) + compactedDurationMs;
+                        if (!Number.isFinite(proposedCompactionDurationMs)) {
+                            throw new TypeError('compaction durationMs total overflow');
+                        }
+                        const proposedCompactionDurationWithoutRetriesMs = (compactionDurationWithoutRetriesMs ?? 0) +
+                            compactedDurationWithoutRetriesMs;
+                        if (!Number.isFinite(proposedCompactionDurationWithoutRetriesMs)) {
+                            throw new TypeError('compaction durationWithoutRetriesMs total overflow');
+                        }
+                        const boundaryUuid = randomUUID();
+                        const summaryUuid = randomUUID();
+                        const timestamp = new Date().toISOString();
+                        const preTokens = budget.evaluate([...contextMessages, ...injectTurnContext(historyMessages)], definitions).estimatedTokens;
+                        const compactEntries = (postTokens) => {
+                            const uuids = [boundaryUuid, summaryUuid];
+                            return createClaudeCompactEntries({
+                                sessionId,
+                                logicalParentUuid,
+                                summary: compacted.summary,
+                                preTokens,
+                                postTokens,
+                                previousCumulativeDroppedTokens: getCumulativeDroppedTokens(snapshot.entries),
+                                durationMs: compactedDurationMs,
+                                cwd: this.activeCwd(),
+                                claudeVersion: this.options.claudeVersion,
+                                gitBranch: null,
+                                ...(memorySelection
+                                    ? {
+                                        preservedUuids: memorySelection.preservedEntries.flatMap((entry) => typeof entry.uuid === 'string' ? [entry.uuid] : []),
+                                    }
+                                    : {}),
+                                createUuid: () => uuids.shift() ?? randomUUID(),
+                                now: () => timestamp,
+                            });
+                        };
+                        const provisionalEntries = compactEntries(0);
+                        const compactSummaryUuid = provisionalEntries.at(-1)?.uuid;
+                        if (typeof compactSummaryUuid !== 'string') {
+                            throw new Error('Could not create Claude compact summary');
+                        }
+                        const replayUuids = preservedUserMessages.map(() => randomUUID());
+                        const replayEntries = translateProviderEvents(preservedUserMessages.map((text, index) => index === 0
+                            ? { type: 'user-text', text }
+                            : { type: 'user-text-block', text }), {
                             sessionId,
-                            logicalParentUuid,
-                            summary: compacted.summary,
-                            preTokens,
-                            postTokens,
-                            previousCumulativeDroppedTokens: getCumulativeDroppedTokens(snapshot.entries),
-                            durationMs: compactedDurationMs,
+                            parentUuid: compactSummaryUuid,
                             cwd: this.activeCwd(),
                             claudeVersion: this.options.claudeVersion,
                             gitBranch: null,
-                            ...(memorySelection
-                                ? {
-                                    preservedUuids: memorySelection.preservedEntries.flatMap((entry) => typeof entry.uuid === 'string' ? [entry.uuid] : []),
-                                }
-                                : {}),
-                            createUuid: () => uuids.shift() ?? randomUUID(),
+                            history: [...snapshot.entries, ...provisionalEntries],
+                            createUuid: () => replayUuids.shift() ?? randomUUID(),
                             now: () => timestamp,
                         });
-                    };
-                    const provisionalEntries = compactEntries(0);
-                    const compactSummaryUuid = provisionalEntries.at(-1)?.uuid;
-                    if (typeof compactSummaryUuid !== 'string') {
-                        throw new Error('Could not create Claude compact summary');
-                    }
-                    const replayUuids = preservedUserMessages.map(() => randomUUID());
-                    const replayEntries = translateProviderEvents(preservedUserMessages.map((text, index) => index === 0
-                        ? { type: 'user-text', text }
-                        : { type: 'user-text-block', text }), {
-                        sessionId,
-                        parentUuid: compactSummaryUuid,
-                        cwd: this.activeCwd(),
-                        claudeVersion: this.options.claudeVersion,
-                        gitBranch: null,
-                        history: [...snapshot.entries, ...provisionalEntries],
-                        createUuid: () => replayUuids.shift() ?? randomUUID(),
-                        now: () => timestamp,
-                    });
-                    const compactedHistory = [
-                        ...projectClaudeModelMessages([
-                            ...snapshot.entries,
-                            ...provisionalEntries,
+                        const compactedHistory = [
+                            ...projectClaudeModelMessages([
+                                ...snapshot.entries,
+                                ...provisionalEntries,
+                                ...replayEntries,
+                            ]),
+                            ...projectMemoryRecallMessages,
+                        ];
+                        const afterHistory = budget.evaluate([...contextMessages, ...injectTurnContext(compactedHistory)], definitions);
+                        const afterPending = budget.evaluate([
+                            ...contextMessages,
+                            ...injectTurnContext([...compactedHistory, ...pendingMessages]),
+                        ], definitions);
+                        budget.assertFits(afterPending);
+                        if (options.promptTooLong === true &&
+                            !contextRecoveryMadeProgress({
+                                beforeOccupancyTokens: predicted.occupancyTokens,
+                                afterOccupancyTokens: afterPending.occupancyTokens,
+                            })) {
+                            throw new Error('Reactive context compaction made no occupancy progress');
+                        }
+                        const entries = [
+                            ...compactEntries(afterHistory.estimatedTokens),
                             ...replayEntries,
-                        ]),
-                        ...projectMemoryRecallMessages,
-                    ];
-                    const afterHistory = budget.evaluate([...contextMessages, ...injectTurnContext(compactedHistory)], definitions);
-                    const afterPending = budget.evaluate([
-                        ...contextMessages,
-                        ...injectTurnContext([...compactedHistory, ...pendingMessages]),
-                    ], definitions);
-                    budget.assertFits(afterPending);
-                    if (options.promptTooLong === true &&
-                        !contextRecoveryMadeProgress({
-                            beforeOccupancyTokens: predicted.occupancyTokens,
-                            afterOccupancyTokens: afterPending.occupancyTokens,
-                        })) {
-                        throw new Error('Reactive context compaction made no occupancy progress');
-                    }
-                    const entries = [
-                        ...compactEntries(afterHistory.estimatedTokens),
-                        ...replayEntries,
-                    ];
-                    if (signal?.aborted)
-                        throw new AgentRunCancelledError();
-                    // Construct the exact tracker mutations for this single committed
-                    // boundary and preflight them against a clone of the live tracker so
-                    // invalid input or cumulative overflow rejects before the compact
-                    // boundary is appended rather than after a half-commit.
-                    const tracker = this.sessionCostTrackers.get(sessionId);
-                    if (!tracker) {
-                        throw new Error(`Session cost tracker is not active for session ${sessionId}`);
-                    }
-                    const compactModel = compacted.model !== undefined && compacted.model.trim() !== ''
-                        ? compacted.model
-                        : provider.model;
-                    const compactModelNonBlank = compactModel !== undefined && compactModel.trim() !== '';
-                    if (hasNonZeroUsage(compacted.usage) && !compactModelNonBlank) {
-                        throw new Error('Auto compact usage requires a nonblank model identity');
-                    }
-                    let meteringTurnInput;
-                    if (compactModelNonBlank && hasNonZeroUsage(compacted.usage)) {
-                        const pricing = this.options.pricing?.resolve(compactModel);
-                        const costUsd = pricing
-                            ? usageCostUsd(compacted.usage, pricing)
-                            : undefined;
-                        meteringTurnInput = {
-                            model: compactModel,
-                            usage: compacted.usage,
-                            ...(costUsd === undefined ? {} : { costUsd }),
-                            ...(compacted.usage.webSearchRequests === undefined
-                                ? {}
-                                : { webSearchRequests: compacted.usage.webSearchRequests }),
-                        };
-                    }
-                    let meteringDurationsInput;
-                    if (compactedDurationMs > 0 ||
-                        compactedDurationWithoutRetriesMs > 0) {
-                        meteringDurationsInput = {
-                            ...(compactedDurationMs === 0
-                                ? {}
-                                : { apiDurationMs: compactedDurationMs }),
-                            apiDurationWithoutRetriesMs: compactedDurationWithoutRetriesMs,
-                        };
-                    }
-                    if (meteringTurnInput !== undefined ||
-                        meteringDurationsInput !== undefined) {
-                        const preflight = new ClaudeSessionCostTracker({
-                            sessionId,
-                            restored: tracker.snapshot(),
-                        });
-                        if (meteringTurnInput !== undefined) {
-                            preflight.recordTurn(meteringTurnInput);
+                        ];
+                        if (signal?.aborted)
+                            throw new AgentRunCancelledError();
+                        // Construct the exact tracker mutations for this single committed
+                        // boundary and preflight them against a clone of the live tracker so
+                        // invalid input or cumulative overflow rejects before the compact
+                        // boundary is appended rather than after a half-commit.
+                        const tracker = this.sessionCostTrackers.get(sessionId);
+                        if (!tracker) {
+                            throw new Error(`Session cost tracker is not active for session ${sessionId}`);
                         }
-                        if (meteringDurationsInput !== undefined) {
-                            preflight.recordDurations(meteringDurationsInput);
+                        const compactModel = compacted.model !== undefined && compacted.model.trim() !== ''
+                            ? compacted.model
+                            : provider.model;
+                        const compactModelNonBlank = compactModel !== undefined && compactModel.trim() !== '';
+                        if (hasNonZeroUsage(compacted.usage) && !compactModelNonBlank) {
+                            throw new Error('Auto compact usage requires a nonblank model identity');
                         }
-                    }
-                    const appendResult = await lease.appendMany(snapshot.tail, entries);
-                    if (appendResult.status === 'conflict') {
-                        throw new Error(`Claude transcript append conflict: ${appendResult.reason}`);
-                    }
-                    snapshot = {
-                        entries: [...snapshot.entries, ...entries],
-                        tail: appendResult.tail,
-                    };
-                    const metadataEntries = createClaudeDurableMetadataSnapshot(snapshot.entries, sessionId);
-                    if (metadataEntries.length > 0) {
-                        const metadataAppend = await lease.appendMany(snapshot.tail, metadataEntries);
-                        if (metadataAppend.status === 'conflict') {
-                            throw new Error(`Claude metadata snapshot conflict: ${metadataAppend.reason}`);
+                        let meteringTurnInput;
+                        if (compactModelNonBlank && hasNonZeroUsage(compacted.usage)) {
+                            const pricing = this.options.pricing?.resolve(compactModel);
+                            const costUsd = pricing
+                                ? usageCostUsd(compacted.usage, pricing)
+                                : undefined;
+                            meteringTurnInput = {
+                                model: compactModel,
+                                usage: compacted.usage,
+                                ...(costUsd === undefined ? {} : { costUsd }),
+                                ...(compacted.usage.webSearchRequests === undefined
+                                    ? {}
+                                    : { webSearchRequests: compacted.usage.webSearchRequests }),
+                            };
+                        }
+                        let meteringDurationsInput;
+                        if (compactedDurationMs > 0 ||
+                            compactedDurationWithoutRetriesMs > 0) {
+                            meteringDurationsInput = {
+                                ...(compactedDurationMs === 0
+                                    ? {}
+                                    : { apiDurationMs: compactedDurationMs }),
+                                apiDurationWithoutRetriesMs: compactedDurationWithoutRetriesMs,
+                            };
+                        }
+                        if (meteringTurnInput !== undefined ||
+                            meteringDurationsInput !== undefined) {
+                            const preflight = new ClaudeSessionCostTracker({
+                                sessionId,
+                                restored: tracker.snapshot(),
+                            });
+                            if (meteringTurnInput !== undefined) {
+                                preflight.recordTurn(meteringTurnInput);
+                            }
+                            if (meteringDurationsInput !== undefined) {
+                                preflight.recordDurations(meteringDurationsInput);
+                            }
+                        }
+                        const appendResult = await lease.appendMany(snapshot.tail, entries);
+                        if (appendResult.status === 'conflict') {
+                            throw new Error(`Claude transcript append conflict: ${appendResult.reason}`);
                         }
                         snapshot = {
-                            entries: [...snapshot.entries, ...metadataEntries],
-                            tail: metadataAppend.tail,
-                        };
-                    }
-                    this.rememberDurableMetadata(sessionId, snapshot.entries);
-                    await this.runAdvisoryHook(sessionId, 'PostCompact', { trigger: 'auto', compact_summary: compacted.summary }, 'auto', signal);
-                    // The boundary is durable: mirror Claude's full-compact behavior by
-                    // rerunning SessionStart with source compact and refreshing the
-                    // runtime-only context so the next request retains current
-                    // instructions, plan state, session memory, and hook context.
-                    if (this.options.hooks) {
-                        const outcome = await this.hookLifecycle.refresh(sessionId, hookSession, signal);
-                        if (outcome)
-                            await recordHookOutcome(outcome);
-                    }
-                    this.options.contextAssembler?.invalidate?.({
-                        lifecycleId: sessionId,
-                        reason: 'compact',
-                    });
-                    this.options.projectMemoryRecall?.recordCompact(sessionId);
-                    await refreshRuntimeContext();
-                    this.options.eventSink?.({
-                        type: 'compact-boundary',
-                        trigger: 'auto',
-                        preTokens,
-                        uuid: boundaryUuid,
-                    });
-                    compactionAnchorUuid = compactSummaryUuid;
-                    compactionUsage = mergeUsage(compactionUsage, compacted.usage);
-                    compactionDurationMs = proposedCompactionDurationMs;
-                    compactionDurationWithoutRetriesMs =
-                        proposedCompactionDurationWithoutRetriesMs;
-                    if (meteringTurnInput !== undefined) {
-                        compactionModelUsage = mergeSessionRawModelUsage(compactionModelUsage, { [meteringTurnInput.model]: compacted.usage });
-                    }
-                    // Commit the preflighted mutations once the boundary is durable so a
-                    // later main-provider failure or cancellation cannot lose the
-                    // compactor's usage/cost/API durations.
-                    if (meteringTurnInput !== undefined) {
-                        tracker.recordTurn(meteringTurnInput);
-                    }
-                    if (meteringDurationsInput !== undefined) {
-                        tracker.recordDurations(meteringDurationsInput);
-                    }
-                };
-                await compactIfNeeded(pendingUserMessages);
-                for (const [index, message] of expandedMessages.entries()) {
-                    if (shellCommand !== undefined)
-                        break;
-                    const messageImages = [
-                        ...(index === attachmentIndex ? images : []),
-                        ...(message.images ?? []),
-                    ];
-                    const persistenceEvent = messageImages.length > 0 ||
-                        (index === attachmentIndex && documents.length > 0)
-                        ? {
-                            type: 'user-message',
-                            text: message.text,
-                            images: messageImages,
-                            ...(index === attachmentIndex && documents.length > 0
-                                ? { documents }
-                                : {}),
+                            entries: [...snapshot.entries, ...entries],
+                            tail: appendResult.tail,
+                        };
+                        const metadataEntries = createClaudeDurableMetadataSnapshot(snapshot.entries, sessionId);
+                        if (metadataEntries.length > 0) {
+                            const metadataAppend = await lease.appendMany(snapshot.tail, metadataEntries);
+                            if (metadataAppend.status === 'conflict') {
+                                throw new Error(`Claude metadata snapshot conflict: ${metadataAppend.reason}`);
+                            }
+                            snapshot = {
+                                entries: [...snapshot.entries, ...metadataEntries],
+                                tail: metadataAppend.tail,
+                            };
                         }
-                        : index === 0
-                            ? { type: 'user-text', text: message.text }
-                            : { type: 'user-text-block', text: message.text };
-                    const [userEntry] = translateProviderEvents([persistenceEvent], this.translationContext(sessionId, snapshot));
-                    if (!userEntry)
-                        throw new Error('Could not translate user prompt');
-                    if (currentPromptId === null && typeof userEntry.uuid === 'string') {
-                        currentPromptId = userEntry.uuid;
-                        compactionAnchorUuid ??= userEntry.uuid;
-                    }
-                    const userTail = await this.append(lease, snapshot.tail, userEntry);
-                    snapshot = {
-                        entries: [...snapshot.entries, userEntry],
-                        tail: userTail,
-                    };
-                }
-                if (fileHistory && currentPromptId) {
-                    const historySnapshot = await fileHistory.snapshot(snapshot.entries, currentPromptId);
-                    const historyTail = await this.append(lease, snapshot.tail, historySnapshot);
-                    snapshot = {
-                        entries: [...snapshot.entries, historySnapshot],
-                        tail: historyTail,
-                    };
-                }
-                if (this.options.hooks && !skipUserPrompt) {
-                    const outcome = await this.options.hooks.run({
-                        ...hookSession,
-                        hook_event_name: 'UserPromptSubmit',
-                        prompt_id: currentPromptId ?? randomUUID(),
-                        prompt: effectivePrompt,
-                    }, undefined, signal);
-                    await recordHookOutcome(outcome);
-                    if (outcome.blockedReason) {
-                        throw new Error(`UserPromptSubmit hook error: ${outcome.blockedReason}`);
-                    }
-                }
-                let shellUsage = { inputTokens: 0, outputTokens: 0 };
-                let shellModelUsage;
-                if (shellCommand !== undefined) {
-                    const call = {
-                        id: `shell_${randomUUID().replaceAll('-', '')}`,
-                        name: 'Bash',
-                        input: { command: shellCommand },
-                    };
-                    this.options.eventSink?.({
-                        type: 'shell-command',
-                        callId: call.id,
-                        command: shellCommand,
-                    });
-                    let shellResult;
-                    try {
-                        shellResult = await runtime.executeDirectToolCall(call, {
-                            cwd: this.activeCwd(),
-                            sessionId,
-                            toolResultDirectory,
-                            messages: projectClaudeModelMessages(snapshot.entries),
-                            observer: {
-                                assistantCompleted: async () => undefined,
-                                toolCompleted: async () => undefined,
-                                followUpUserMessagesCompleted: observer.followUpUserMessagesCompleted,
-                            },
-                            ...(this.options.approveTool
-                                ? { approveTool: this.options.approveTool }
-                                : {}),
-                            permissionUpdates: this.sessionPermissionUpdates.get(sessionId) ?? [],
-                            onPermissionUpdates: (updates) => this.applyPermissionUpdates(sessionId, updates),
-                            ...(signal ? { signal } : {}),
+                        this.rememberDurableMetadata(sessionId, snapshot.entries);
+                        await this.runAdvisoryHook(sessionId, 'PostCompact', { trigger: 'auto', compact_summary: compacted.summary }, 'auto', signal);
+                        // The boundary is durable: mirror Claude's full-compact behavior by
+                        // rerunning SessionStart with source compact and refreshing the
+                        // runtime-only context so the next request retains current
+                        // instructions, plan state, session memory, and hook context.
+                        if (this.options.hooks) {
+                            const outcome = await this.hookLifecycle.refresh(sessionId, hookSession, signal);
+                            if (outcome)
+                                await recordHookOutcome(outcome);
+                        }
+                        this.options.contextAssembler?.invalidate?.({
+                            lifecycleId: sessionId,
+                            reason: 'compact',
                         });
-                    }
-                    catch (error) {
+                        this.options.projectMemoryRecall?.recordCompact(sessionId);
+                        await refreshRuntimeContext();
                         this.options.eventSink?.({
-                            type: 'shell-cancelled',
-                            callId: call.id,
+                            type: 'compact-boundary',
+                            trigger: 'auto',
+                            preTokens,
+                            uuid: boundaryUuid,
                         });
-                        throw error;
-                    }
-                    shellUsage = shellResult.usage ?? shellUsage;
-                    if (!shellResult.isError) {
-                        shellModelUsage = shellResult.modelUsage;
-                        foregroundLineChanges.add(shellResult);
-                    }
-                    const stdout = shellResult.processOutput?.stdout ??
-                        (shellResult.isError ? '' : shellResult.content);
-                    const stderr = shellResult.processOutput?.stderr ??
-                        (shellResult.isError ? shellResult.content : '');
-                    const shellUuids = [shellInputUuid ?? randomUUID(), randomUUID()];
-                    const [inputEntry, outputEntry] = translateProviderEvents([
-                        { type: 'bash-input', command: shellCommand },
-                        { type: 'bash-output', stdout, stderr },
-                    ], {
-                        ...this.translationContext(sessionId, snapshot),
-                        createUuid: () => shellUuids.shift() ?? randomUUID(),
-                    });
-                    if (!inputEntry || !outputEntry) {
-                        throw new Error('Could not translate shell command result');
-                    }
-                    const shellAppend = await lease.appendMany(snapshot.tail, [
-                        inputEntry,
-                        outputEntry,
-                    ]);
-                    if (shellAppend.status === 'conflict') {
-                        throw new Error(`Claude transcript append conflict: ${shellAppend.reason}`);
-                    }
-                    snapshot = {
-                        entries: [...snapshot.entries, inputEntry, outputEntry],
-                        tail: shellAppend.tail,
-                    };
-                    currentTurnUserMessages.push(`<bash-stdout>${stdout}</bash-stdout><bash-stderr>${stderr}</bash-stderr>`);
-                    this.options.eventSink?.({
-                        type: 'shell-result',
-                        callId: call.id,
-                        stdout,
-                        stderr,
-                        isError: shellResult.isError,
-                    });
-                }
-                if (budget) {
-                    await compactIfNeeded([], currentTurnUserMessages ?? []);
-                    budget.assertFits(budget.evaluate([
-                        ...contextMessages,
-                        ...injectTurnContext(projectClaudeModelMessages(snapshot.entries)),
-                    ], definitions));
-                }
-                let stopHookActive = false;
-                const runtimeRequest = {
-                    sessionId,
-                    messages: [
-                        ...contextMessages,
-                        ...injectTurnContext(projectClaudeModelMessages(snapshot.entries)),
-                    ],
-                    ...(stableSystemMessageCount === undefined
-                        ? {}
-                        : { stableSystemMessageCount }),
-                    cwd: this.activeCwd(),
-                    toolResultDirectory,
-                    observer,
-                    ...(this.options.effort ? { effort: this.options.effort } : {}),
-                    ...(this.options.maxModelTurns !== undefined
-                        ? { maxModelTurns: this.options.maxModelTurns }
-                        : {}),
-                    ...(this.options.betas?.length ? { betas: this.options.betas } : {}),
-                    ...(this.options.collectMetrics || this.options.costStateStore
-                        ? { collectMetrics: true }
-                        : {}),
-                    ...(budget
-                        ? { deferFailureKinds: ['prompt_too_long'] }
-                        : {}),
-                    reloadMessages: async () => {
-                        const recalled = projectMemoryRecallTurn?.consumeIfSettled();
-                        if (recalled) {
-                            projectMemoryRecallMessages = [
-                                { role: 'user', content: recalled.content },
-                            ];
+                        compactionAnchorUuid = compactSummaryUuid;
+                        compactionUsage = mergeUsage(compactionUsage, compacted.usage);
+                        compactionDurationMs = proposedCompactionDurationMs;
+                        compactionDurationWithoutRetriesMs =
+                            proposedCompactionDurationWithoutRetriesMs;
+                        if (meteringTurnInput !== undefined) {
+                            compactionModelUsage = mergeSessionRawModelUsage(compactionModelUsage, { [meteringTurnInput.model]: compacted.usage });
                         }
-                        await compactIfNeeded([], currentTurnUserMessages ?? []);
-                        if (stableSystemMessageCount === undefined) {
-                            delete runtimeRequest.stableSystemMessageCount;
+                        // Commit the preflighted mutations once the boundary is durable so a
+                        // later main-provider failure or cancellation cannot lose the
+                        // compactor's usage/cost/API durations.
+                        if (meteringTurnInput !== undefined) {
+                            tracker.recordTurn(meteringTurnInput);
                         }
-                        else {
-                            runtimeRequest.stableSystemMessageCount = stableSystemMessageCount;
+                        if (meteringDurationsInput !== undefined) {
+                            tracker.recordDurations(meteringDurationsInput);
                         }
-                        return [
-                            ...contextMessages,
-                            ...injectTurnContext([
-                                ...projectClaudeModelMessages(snapshot.entries),
-                                ...projectMemoryRecallMessages,
-                            ]),
+                    };
+                    await compactIfNeeded(pendingUserMessages);
+                    for (const [index, message] of expandedMessages.entries()) {
+                        if (shellCommand !== undefined)
+                            break;
+                        const messageImages = [
+                            ...(index === attachmentIndex ? images : []),
+                            ...(message.images ?? []),
                         ];
-                    },
-                    ...(this.options.hooks ||
-                        subagentExecutor ||
-                        taskTools ||
-                        this.scheduledPrompts ||
-                        this.workflowManager
-                        ? {
-                            onStop: async (text) => {
-                                const messages = [];
-                                const outcome = await this.options.hooks?.run({
-                                    ...hookSession,
-                                    hook_event_name: 'Stop',
-                                    stop_hook_active: stopHookActive,
-                                    last_assistant_message: text,
-                                }, undefined, signal);
-                                if (outcome) {
-                                    await recordHookOutcome(outcome);
-                                    if (outcome.blockedReason) {
-                                        stopHookActive = true;
-                                        messages.push(`Stop hook error: ${outcome.blockedReason}`);
-                                    }
-                                }
-                                const background = await subagentExecutor?.notifications(true);
-                                if (background)
-                                    messages.push(...background.messages);
-                                const workflow = await this.workflowManager?.notifications(true);
-                                if (workflow)
-                                    messages.push(...workflow.messages);
-                                const bashMessages = await taskTools?.notifications(true);
-                                if (bashMessages)
-                                    messages.push(...bashMessages);
-                                const scheduled = await this.scheduledPrompts?.drainDue();
-                                if (scheduled) {
-                                    messages.push(...scheduled.map(({ prompt }) => prompt));
-                                }
-                                const batchUsage = background || workflow
-                                    ? mergeUsage(background?.usage ?? {
-                                        inputTokens: 0,
-                                        outputTokens: 0,
-                                    }, workflow?.usage ?? {
-                                        inputTokens: 0,
-                                        outputTokens: 0,
-                                    })
-                                    : undefined;
-                                const batchModelUsage = mergeSessionRawModelUsage(background?.modelUsage, workflow?.modelUsage);
-                                const batchDurationApiMs = addApiDuration(workflow?.durationApiMs, addApiDuration(background?.durationApiMs, 0, 'durationApiMs'), 'durationApiMs');
-                                const backgroundDurationWithoutRetries = background?.durationApiWithoutRetriesMs ??
-                                    background?.durationApiMs;
-                                const workflowDurationWithoutRetries = workflow?.durationApiWithoutRetriesMs ??
-                                    workflow?.durationApiMs;
-                                const batchDurationApiWithoutRetriesMs = addApiDuration(workflowDurationWithoutRetries, addApiDuration(backgroundDurationWithoutRetries, 0, 'durationApiWithoutRetriesMs'), 'durationApiWithoutRetriesMs');
-                                const hasBatchDuration = background?.durationApiMs !== undefined ||
-                                    background?.durationApiWithoutRetriesMs !== undefined ||
-                                    workflow?.durationApiMs !== undefined ||
-                                    workflow?.durationApiWithoutRetriesMs !== undefined;
-                                return {
-                                    messages,
-                                    ...(batchUsage
-                                        ? {
-                                            usage: batchUsage,
-                                            ...(batchModelUsage
-                                                ? { modelUsage: batchModelUsage }
-                                                : {}),
-                                        }
-                                        : {}),
-                                    ...(hasBatchDuration
-                                        ? {
-                                            durationApiMs: batchDurationApiMs,
-                                            durationApiWithoutRetriesMs: batchDurationApiWithoutRetriesMs,
-                                        }
-                                        : {}),
-                                };
-                            },
+                        const persistenceEvent = messageImages.length > 0 ||
+                            (index === attachmentIndex && documents.length > 0)
+                            ? {
+                                type: 'user-message',
+                                text: message.text,
+                                images: messageImages,
+                                ...(index === attachmentIndex && documents.length > 0
+                                    ? { documents }
+                                    : {}),
+                            }
+                            : index === 0
+                                ? { type: 'user-text', text: message.text }
+                                : { type: 'user-text-block', text: message.text };
+                        const [userEntry] = translateProviderEvents([persistenceEvent], this.translationContext(sessionId, snapshot));
+                        if (!userEntry)
+                            throw new Error('Could not translate user prompt');
+                        if (currentPromptId === null &&
+                            typeof userEntry.uuid === 'string') {
+                            currentPromptId = userEntry.uuid;
+                            compactionAnchorUuid ??= userEntry.uuid;
                         }
-                        : {}),
-                    ...(this.options.approveTool
-                        ? { approveTool: this.options.approveTool }
-                        : {}),
-                    permissionUpdates: this.sessionPermissionUpdates.get(sessionId) ?? [],
-                    onPermissionUpdates: (updates) => this.applyPermissionUpdates(sessionId, updates),
-                };
-                const attemptMainTurn = () => signal
-                    ? runtime.run({ ...runtimeRequest, signal })
-                    : runtime.run(runtimeRequest);
-                const surfaceExhaustedRecovery = (error) => {
-                    this.options.eventSink?.({
-                        type: 'failed',
-                        message: error.message,
-                        retryable: false,
-                    });
-                };
-                let result;
-                try {
-                    try {
-                        result = await attemptMainTurn();
+                        const userTail = await this.append(lease, snapshot.tail, userEntry);
+                        snapshot = {
+                            entries: [...snapshot.entries, userEntry],
+                            tail: userTail,
+                        };
                     }
-                    catch (error) {
-                        if (!budget || !isPromptTooLongError(error))
-                            throw error;
-                        if (recoveryPlanner.reactiveRetriesRemaining === 0) {
-                            surfaceExhaustedRecovery(error);
-                            throw error;
+                    if (fileHistory && currentPromptId) {
+                        const historySnapshot = await fileHistory.snapshot(snapshot.entries, currentPromptId);
+                        const historyTail = await this.append(lease, snapshot.tail, historySnapshot);
+                        snapshot = {
+                            entries: [...snapshot.entries, historySnapshot],
+                            tail: historyTail,
+                        };
+                    }
+                    if (this.options.hooks && !skipUserPrompt) {
+                        const outcome = await this.options.hooks.run({
+                            ...hookSession,
+                            hook_event_name: 'UserPromptSubmit',
+                            prompt_id: currentPromptId ?? randomUUID(),
+                            prompt: effectivePrompt,
+                        }, undefined, signal);
+                        await recordHookOutcome(outcome);
+                        if (outcome.blockedReason) {
+                            throw new Error(`UserPromptSubmit hook error: ${outcome.blockedReason}`);
                         }
-                        const beforeRecovery = budget.evaluate(runtimeRequest.messages, definitions);
+                    }
+                    let shellUsage = { inputTokens: 0, outputTokens: 0 };
+                    let shellModelUsage;
+                    if (shellCommand !== undefined) {
+                        const call = {
+                            id: `shell_${randomUUID().replaceAll('-', '')}`,
+                            name: 'Bash',
+                            input: { command: shellCommand },
+                        };
+                        this.options.eventSink?.({
+                            type: 'shell-command',
+                            callId: call.id,
+                            command: shellCommand,
+                        });
+                        let shellResult;
                         try {
-                            await compactIfNeeded([], currentTurnUserMessages ?? [], {
-                                promptTooLong: true,
+                            shellResult = await runtime.executeDirectToolCall(call, {
+                                cwd: this.activeCwd(),
+                                sessionId,
+                                toolResultDirectory,
+                                messages: projectClaudeModelMessages(snapshot.entries),
+                                observer: {
+                                    assistantCompleted: async () => undefined,
+                                    toolCompleted: async () => undefined,
+                                    followUpUserMessagesCompleted: observer.followUpUserMessagesCompleted,
+                                },
+                                ...(this.options.approveTool
+                                    ? { approveTool: this.options.approveTool }
+                                    : {}),
+                                permissionUpdates: this.sessionPermissionUpdates.get(sessionId) ?? [],
+                                onPermissionUpdates: (updates) => this.applyPermissionUpdates(sessionId, updates),
+                                ...(signal ? { signal } : {}),
                             });
                         }
-                        catch (compactionError) {
-                            if (signal?.aborted ||
-                                compactionError instanceof AgentRunCancelledError) {
-                                throw new AgentRunCancelledError();
-                            }
-                            // Compaction could not free the provider-bounded context; surface
-                            // the original prompt-too-long error rather than the compaction
-                            // failure.
-                            surfaceExhaustedRecovery(error);
+                        catch (error) {
+                            this.options.eventSink?.({
+                                type: 'shell-cancelled',
+                                callId: call.id,
+                            });
                             throw error;
                         }
-                        // The single reactive retry must use the compacted transcript, not
-                        // the stale request copy captured before the compact boundary.
-                        runtimeRequest.messages = [
-                            ...contextMessages,
-                            ...injectTurnContext([
-                                ...projectClaudeModelMessages(snapshot.entries),
-                                ...projectMemoryRecallMessages,
-                            ]),
-                        ];
-                        if (stableSystemMessageCount === undefined) {
-                            delete runtimeRequest.stableSystemMessageCount;
+                        shellUsage = shellResult.usage ?? shellUsage;
+                        if (!shellResult.isError) {
+                            shellModelUsage = shellResult.modelUsage;
+                            foregroundLineChanges.add(shellResult);
                         }
-                        else {
-                            runtimeRequest.stableSystemMessageCount = stableSystemMessageCount;
+                        const stdout = shellResult.processOutput?.stdout ??
+                            (shellResult.isError ? '' : shellResult.content);
+                        const stderr = shellResult.processOutput?.stderr ??
+                            (shellResult.isError ? shellResult.content : '');
+                        const shellUuids = [shellInputUuid ?? randomUUID(), randomUUID()];
+                        const [inputEntry, outputEntry] = translateProviderEvents([
+                            { type: 'bash-input', command: shellCommand },
+                            { type: 'bash-output', stdout, stderr },
+                        ], {
+                            ...this.translationContext(sessionId, snapshot),
+                            createUuid: () => shellUuids.shift() ?? randomUUID(),
+                        });
+                        if (!inputEntry || !outputEntry) {
+                            throw new Error('Could not translate shell command result');
                         }
-                        const afterRecovery = budget.evaluate(runtimeRequest.messages, definitions);
-                        if (recoveryPlanner.consumeReactiveRetry({
-                            beforeOccupancyTokens: beforeRecovery.occupancyTokens,
-                            afterOccupancyTokens: afterRecovery.occupancyTokens,
-                        }) !== 'reactive-retry') {
-                            surfaceExhaustedRecovery(error);
-                            throw error;
+                        const shellAppend = await lease.appendMany(snapshot.tail, [
+                            inputEntry,
+                            outputEntry,
+                        ]);
+                        if (shellAppend.status === 'conflict') {
+                            throw new Error(`Claude transcript append conflict: ${shellAppend.reason}`);
                         }
-                        runtimeRequest.deferFailureKinds = true;
+                        snapshot = {
+                            entries: [...snapshot.entries, inputEntry, outputEntry],
+                            tail: shellAppend.tail,
+                        };
+                        currentTurnUserMessages.push(`<bash-stdout>${stdout}</bash-stdout><bash-stderr>${stderr}</bash-stderr>`);
+                        this.options.eventSink?.({
+                            type: 'shell-result',
+                            callId: call.id,
+                            stdout,
+                            stderr,
+                            isError: shellResult.isError,
+                        });
+                    }
+                    if (budget) {
+                        await compactIfNeeded([], currentTurnUserMessages ?? []);
+                        budget.assertFits(budget.evaluate([
+                            ...contextMessages,
+                            ...injectTurnContext(projectClaudeModelMessages(snapshot.entries)),
+                        ], definitions));
+                    }
+                    let stopHookActive = false;
+                    const runtimeRequest = {
+                        sessionId,
+                        messages: [
+                            ...contextMessages,
+                            ...injectTurnContext(projectClaudeModelMessages(snapshot.entries)),
+                        ],
+                        stableSystemMessageCount,
+                        cwd: this.activeCwd(),
+                        toolResultDirectory,
+                        observer,
+                        ...(this.options.effort ? { effort: this.options.effort } : {}),
+                        ...(this.options.maxModelTurns !== undefined
+                            ? { maxModelTurns: this.options.maxModelTurns }
+                            : {}),
+                        ...(this.options.betas?.length
+                            ? { betas: this.options.betas }
+                            : {}),
+                        ...(this.options.collectMetrics || this.options.costStateStore
+                            ? { collectMetrics: true }
+                            : {}),
+                        ...(budget
+                            ? { deferFailureKinds: ['prompt_too_long'] }
+                            : {}),
+                        reloadMessages: async () => {
+                            const recalled = projectMemoryRecallTurn?.consumeIfSettled();
+                            if (recalled) {
+                                projectMemoryRecallMessages = [
+                                    { role: 'user', content: recalled.content },
+                                ];
+                            }
+                            await compactIfNeeded([], currentTurnUserMessages ?? []);
+                            runtimeRequest.stableSystemMessageCount = stableSystemMessageCount;
+                            return [
+                                ...contextMessages,
+                                ...injectTurnContext([
+                                    ...projectClaudeModelMessages(snapshot.entries),
+                                    ...projectMemoryRecallMessages,
+                                ]),
+                            ];
+                        },
+                        ...(this.options.hooks ||
+                            subagentExecutor ||
+                            taskTools ||
+                            this.scheduledPrompts ||
+                            this.workflowManager
+                            ? {
+                                onStop: async (text) => {
+                                    const messages = [];
+                                    const outcome = await this.options.hooks?.run({
+                                        ...hookSession,
+                                        hook_event_name: 'Stop',
+                                        stop_hook_active: stopHookActive,
+                                        last_assistant_message: text,
+                                    }, undefined, signal);
+                                    if (outcome) {
+                                        await recordHookOutcome(outcome);
+                                        if (outcome.blockedReason) {
+                                            stopHookActive = true;
+                                            messages.push(`Stop hook error: ${outcome.blockedReason}`);
+                                        }
+                                    }
+                                    const claimedAgentIds = new Set(this.sessionSubagentExecutors(sessionId, true).flatMap((executor) => executor.notificationClaimAgentIds()));
+                                    await Promise.all(this.sessionSubagentExecutors(sessionId, true).map((executor) => {
+                                        const delivered = (notification) => transcriptContainsBackgroundAgentNotification(snapshot.entries, notification);
+                                        return this.hostedSubagents.has(executor)
+                                            ? executor.reconcileDetachedNotifications(delivered)
+                                            : executor.reconcileDeliveredNotifications(delivered);
+                                    }));
+                                    await subagentExecutor?.hydratePersistedTasks(sessionId, this.activeCwd(), claimedAgentIds);
+                                    const background = await this.collectSubagentNotifications(sessionId, subagentExecutor ?? undefined);
+                                    if (background)
+                                        messages.push(...background.messages);
+                                    const workflow = await this.workflowManager?.notifications(true);
+                                    if (workflow)
+                                        messages.push(...workflow.messages);
+                                    const bashMessages = await taskTools?.notifications(true);
+                                    if (bashMessages)
+                                        messages.push(...bashMessages);
+                                    const scheduled = await this.scheduledPrompts?.drainDue();
+                                    if (scheduled) {
+                                        messages.push(...scheduled.map(({ prompt }) => prompt));
+                                    }
+                                    const batchUsage = background || workflow
+                                        ? mergeUsage(background?.usage ?? {
+                                            inputTokens: 0,
+                                            outputTokens: 0,
+                                        }, workflow?.usage ?? {
+                                            inputTokens: 0,
+                                            outputTokens: 0,
+                                        })
+                                        : undefined;
+                                    const batchModelUsage = mergeSessionRawModelUsage(background?.modelUsage, workflow?.modelUsage);
+                                    const batchDurationApiMs = addApiDuration(workflow?.durationApiMs, addApiDuration(background?.durationApiMs, 0, 'durationApiMs'), 'durationApiMs');
+                                    const backgroundDurationWithoutRetries = background?.durationApiWithoutRetriesMs ??
+                                        background?.durationApiMs;
+                                    const workflowDurationWithoutRetries = workflow?.durationApiWithoutRetriesMs ??
+                                        workflow?.durationApiMs;
+                                    const batchDurationApiWithoutRetriesMs = addApiDuration(workflowDurationWithoutRetries, addApiDuration(backgroundDurationWithoutRetries, 0, 'durationApiWithoutRetriesMs'), 'durationApiWithoutRetriesMs');
+                                    const hasBatchDuration = background?.durationApiMs !== undefined ||
+                                        background?.durationApiWithoutRetriesMs !== undefined ||
+                                        workflow?.durationApiMs !== undefined ||
+                                        workflow?.durationApiWithoutRetriesMs !== undefined;
+                                    return {
+                                        messages,
+                                        ...(batchUsage
+                                            ? {
+                                                usage: batchUsage,
+                                                ...(batchModelUsage
+                                                    ? { modelUsage: batchModelUsage }
+                                                    : {}),
+                                            }
+                                            : {}),
+                                        ...(hasBatchDuration
+                                            ? {
+                                                durationApiMs: batchDurationApiMs,
+                                                durationApiWithoutRetriesMs: batchDurationApiWithoutRetriesMs,
+                                            }
+                                            : {}),
+                                    };
+                                },
+                            }
+                            : {}),
+                        ...(this.options.approveTool
+                            ? { approveTool: this.options.approveTool }
+                            : {}),
+                        permissionUpdates: this.sessionPermissionUpdates.get(sessionId) ?? [],
+                        onPermissionUpdates: (updates) => this.applyPermissionUpdates(sessionId, updates),
+                    };
+                    const attemptMainTurn = () => signal
+                        ? runtime.run({ ...runtimeRequest, signal })
+                        : runtime.run(runtimeRequest);
+                    const surfaceExhaustedRecovery = (error) => {
+                        this.options.eventSink?.({
+                            type: 'failed',
+                            message: error.message,
+                            retryable: false,
+                        });
+                    };
+                    let result;
+                    try {
                         try {
                             result = await attemptMainTurn();
                         }
-                        catch (retryError) {
-                            // Exactly one reactive retry is consumed; fail deterministically
-                            // and surface the original prompt-too-long error.
-                            recoveryPlanner.recordFailure();
-                            if (signal?.aborted ||
-                                retryError instanceof AgentRunCancelledError) {
-                                throw new AgentRunCancelledError();
+                        catch (error) {
+                            if (!budget || !isPromptTooLongError(error))
+                                throw error;
+                            if (recoveryPlanner.reactiveRetriesRemaining === 0) {
+                                surfaceExhaustedRecovery(error);
+                                throw error;
+                            }
+                            const beforeRecovery = budget.evaluate(runtimeRequest.messages, definitions);
+                            try {
+                                await compactIfNeeded([], currentTurnUserMessages ?? [], {
+                                    promptTooLong: true,
+                                });
+                            }
+                            catch (compactionError) {
+                                if (signal?.aborted ||
+                                    compactionError instanceof AgentRunCancelledError) {
+                                    throw new AgentRunCancelledError();
+                                }
+                                // Compaction could not free the provider-bounded context; surface
+                                // the original prompt-too-long error rather than the compaction
+                                // failure.
+                                surfaceExhaustedRecovery(error);
+                                throw error;
+                            }
+                            // The single reactive retry must use the compacted transcript, not
+                            // the stale request copy captured before the compact boundary.
+                            runtimeRequest.messages = [
+                                ...contextMessages,
+                                ...injectTurnContext([
+                                    ...projectClaudeModelMessages(snapshot.entries),
+                                    ...projectMemoryRecallMessages,
+                                ]),
+                            ];
+                            runtimeRequest.stableSystemMessageCount = stableSystemMessageCount;
+                            const afterRecovery = budget.evaluate(runtimeRequest.messages, definitions);
+                            if (recoveryPlanner.consumeReactiveRetry({
+                                beforeOccupancyTokens: beforeRecovery.occupancyTokens,
+                                afterOccupancyTokens: afterRecovery.occupancyTokens,
+                            }) !== 'reactive-retry') {
+                                surfaceExhaustedRecovery(error);
+                                throw error;
+                            }
+                            runtimeRequest.deferFailureKinds = true;
+                            try {
+                                result = await attemptMainTurn();
+                            }
+                            catch (retryError) {
+                                // Exactly one reactive retry is consumed; fail deterministically
+                                // and surface the original prompt-too-long error.
+                                recoveryPlanner.recordFailure();
+                                if (signal?.aborted ||
+                                    retryError instanceof AgentRunCancelledError) {
+                                    throw new AgentRunCancelledError();
+                                }
+                                surfaceExhaustedRecovery(error);
+                                throw error;
                             }
-                            surfaceExhaustedRecovery(error);
-                            throw error;
                         }
                     }
-                }
-                catch (error) {
-                    if (!signal?.aborted &&
-                        !(error instanceof AgentRunCancelledError) &&
-                        !(error instanceof ModelProviderError && error.kind === 'cancelled')) {
-                        const failureKind = error instanceof ModelProviderError
-                            ? claudeStopFailureError(error.kind)
-                            : 'unknown';
-                        await this.runAdvisoryHook(sessionId, 'StopFailure', {
-                            error: failureKind,
-                            error_details: error instanceof Error ? error.message : String(error),
-                        }, failureKind, signal);
+                    catch (error) {
+                        if (!signal?.aborted &&
+                            !(error instanceof AgentRunCancelledError) &&
+                            !(error instanceof ModelProviderError &&
+                                error.kind === 'cancelled')) {
+                            const failureKind = error instanceof ModelProviderError
+                                ? claudeStopFailureError(error.kind)
+                                : 'unknown';
+                            await this.runAdvisoryHook(sessionId, 'StopFailure', {
+                                error: failureKind,
+                                error_details: error instanceof Error ? error.message : String(error),
+                            }, failureKind, signal);
+                        }
+                        throw error;
                     }
-                    throw error;
-                }
-                recoveryPlanner.recordSuccess();
-                const mainModel = provider.model !== undefined && provider.model.trim() !== ''
-                    ? provider.model
-                    : undefined;
-                const observedUsage = (mainModel !== undefined
-                    ? result.modelUsage?.[mainModel]
-                    : undefined) ??
-                    Object.values(result.modelUsage ?? {})[0] ??
-                    result.usage;
-                budget?.observeUsage(observedUsage, runtimeRequest.messages, definitions);
-                if (structuredCapture && structuredCapture.calls !== 1) {
-                    throw new Error(`StructuredOutput must be called exactly once (received ${structuredCapture.calls})`);
-                }
-                const finalLeafUuid = lastAssistantUuid;
-                if (!finalLeafUuid) {
-                    throw new Error('Could not locate final assistant response');
-                }
-                if (!skipUserPrompt) {
-                    const lastPrompt = createClaudeLastPromptEntry({
-                        sessionId,
-                        lastPrompt: effectivePrompt,
-                        leafUuid: finalLeafUuid,
-                    });
-                    const tail = await this.append(lease, snapshot.tail, lastPrompt);
-                    snapshot = {
-                        entries: [...snapshot.entries, lastPrompt],
-                        tail,
-                    };
-                }
-                this.rememberDurableMetadata(sessionId, snapshot.entries);
-                const totalUsage = mergeUsage(mergeUsage(mergeUsage(recoveryUsage, compactionUsage), shellUsage), result.usage);
-                const tracker = this.sessionCostTrackers.get(sessionId);
-                if (!tracker) {
-                    throw new Error(`Session cost tracker is not active for session ${sessionId}`);
-                }
-                const turnModelUsage = mergeSessionRawModelUsage(recoveryModelUsage, compactionModelUsage, shellModelUsage, result.modelUsage);
-                const combinedDurationMs = compactionDurationMs === undefined &&
-                    result.durationApiMs === undefined
-                    ? undefined
-                    : (compactionDurationMs ?? 0) + (result.durationApiMs ?? 0);
-                let rawCostUsd;
-                if (turnModelUsage) {
-                    for (const [model, usage] of Object.entries(turnModelUsage)) {
-                        const pricing = this.options.pricing?.resolve(model);
-                        const costUsd = pricing ? usageCostUsd(usage, pricing) : undefined;
-                        if (costUsd !== undefined)
-                            rawCostUsd = (rawCostUsd ?? 0) + costUsd;
+                    recoveryPlanner.recordSuccess();
+                    const mainModel = provider.model !== undefined && provider.model.trim() !== ''
+                        ? provider.model
+                        : undefined;
+                    const observedUsage = (mainModel !== undefined
+                        ? result.modelUsage?.[mainModel]
+                        : undefined) ??
+                        Object.values(result.modelUsage ?? {})[0] ??
+                        result.usage;
+                    budget?.observeUsage(observedUsage, runtimeRequest.messages, definitions);
+                    if (structuredCapture && structuredCapture.calls !== 1) {
+                        throw new Error(`StructuredOutput must be called exactly once (received ${structuredCapture.calls})`);
                     }
-                }
-                // Auto-compaction metering was already recorded atomically with each
-                // committed boundary, and externally metered tool-summary metrics were
-                // committed through the summary callback, so the live tracker receives
-                // only the unrecorded subset here. The inclusive public aggregates
-                // above still contain every row and duration.
-                const trackedModelUsage = mergeSessionRawModelUsage(recoveryModelUsage, shellModelUsage, result.unrecordedModelUsage ?? result.modelUsage);
-                if (trackedModelUsage) {
-                    for (const [model, usage] of Object.entries(trackedModelUsage)) {
-                        const pricing = this.options.pricing?.resolve(model);
-                        const costUsd = pricing ? usageCostUsd(usage, pricing) : undefined;
-                        tracker.recordTurn({
-                            model,
-                            usage,
-                            ...(costUsd === undefined ? {} : { costUsd }),
-                            ...(usage.webSearchRequests === undefined
-                                ? {}
-                                : { webSearchRequests: usage.webSearchRequests }),
+                    const finalLeafUuid = lastAssistantUuid;
+                    if (!finalLeafUuid) {
+                        throw new Error('Could not locate final assistant response');
+                    }
+                    if (!skipUserPrompt) {
+                        const lastPrompt = createClaudeLastPromptEntry({
+                            sessionId,
+                            lastPrompt: effectivePrompt,
+                            leafUuid: finalLeafUuid,
                         });
+                        const tail = await this.append(lease, snapshot.tail, lastPrompt);
+                        snapshot = {
+                            entries: [...snapshot.entries, lastPrompt],
+                            tail,
+                        };
                     }
-                }
-                let combinedToolDurationMs = 0;
-                for (const recoveryResult of recoveryResults) {
-                    combinedToolDurationMs = addToolDuration(recoveryResult.durationToolMs, combinedToolDurationMs);
-                }
-                combinedToolDurationMs = addToolDuration(result.durationToolMs, combinedToolDurationMs);
-                const trackedDurationApiMs = result.unrecordedDurationApiMs ?? result.durationApiMs;
-                const trackedDurationApiWithoutRetriesMs = result.unrecordedDurationApiWithoutRetriesMs ??
-                    result.durationApiWithoutRetriesMs;
-                tracker.recordDurations({
-                    ...(trackedDurationApiMs === undefined
-                        ? {}
-                        : { apiDurationMs: trackedDurationApiMs }),
-                    ...(trackedDurationApiWithoutRetriesMs === undefined
-                        ? {}
-                        : {
-                            apiDurationWithoutRetriesMs: trackedDurationApiWithoutRetriesMs,
-                        }),
-                    ...(combinedToolDurationMs === 0
-                        ? {}
-                        : { toolDurationMs: combinedToolDurationMs }),
-                });
-                foregroundLineChanges.add({
-                    isError: false,
-                    ...(result.linesAdded === undefined
-                        ? {}
-                        : { linesAdded: result.linesAdded }),
-                    ...(result.linesRemoved === undefined
-                        ? {}
-                        : { linesRemoved: result.linesRemoved }),
-                });
-                if (foregroundLineChanges.linesAdded !== 0 ||
-                    foregroundLineChanges.linesRemoved !== 0) {
-                    tracker.recordLineChanges({
-                        ...(foregroundLineChanges.linesAdded === 0
+                    this.rememberDurableMetadata(sessionId, snapshot.entries);
+                    const totalUsage = mergeUsage(mergeUsage(mergeUsage(recoveryUsage, compactionUsage), shellUsage), result.usage);
+                    const tracker = this.sessionCostTrackers.get(sessionId);
+                    if (!tracker) {
+                        throw new Error(`Session cost tracker is not active for session ${sessionId}`);
+                    }
+                    const turnModelUsage = mergeSessionRawModelUsage(recoveryModelUsage, compactionModelUsage, shellModelUsage, result.modelUsage);
+                    const combinedDurationMs = compactionDurationMs === undefined &&
+                        result.durationApiMs === undefined
+                        ? undefined
+                        : (compactionDurationMs ?? 0) + (result.durationApiMs ?? 0);
+                    let rawCostUsd;
+                    if (turnModelUsage) {
+                        for (const [model, usage] of Object.entries(turnModelUsage)) {
+                            const pricing = this.options.pricing?.resolve(model);
+                            const costUsd = pricing ? usageCostUsd(usage, pricing) : undefined;
+                            if (costUsd !== undefined)
+                                rawCostUsd = (rawCostUsd ?? 0) + costUsd;
+                        }
+                    }
+                    // Auto-compaction metering was already recorded atomically with each
+                    // committed boundary, and externally metered tool-summary metrics were
+                    // committed through the summary callback, so the live tracker receives
+                    // only the unrecorded subset here. The inclusive public aggregates
+                    // above still contain every row and duration.
+                    const trackedModelUsage = mergeSessionRawModelUsage(recoveryModelUsage, shellModelUsage, result.unrecordedModelUsage ?? result.modelUsage);
+                    if (trackedModelUsage) {
+                        for (const [model, usage] of Object.entries(trackedModelUsage)) {
+                            const pricing = this.options.pricing?.resolve(model);
+                            const costUsd = pricing ? usageCostUsd(usage, pricing) : undefined;
+                            tracker.recordTurn({
+                                model,
+                                usage,
+                                ...(costUsd === undefined ? {} : { costUsd }),
+                                ...(usage.webSearchRequests === undefined
+                                    ? {}
+                                    : { webSearchRequests: usage.webSearchRequests }),
+                            });
+                        }
+                    }
+                    let combinedToolDurationMs = 0;
+                    for (const recoveryResult of recoveryResults) {
+                        combinedToolDurationMs = addToolDuration(recoveryResult.durationToolMs, combinedToolDurationMs);
+                    }
+                    combinedToolDurationMs = addToolDuration(result.durationToolMs, combinedToolDurationMs);
+                    const trackedDurationApiMs = result.unrecordedDurationApiMs ?? result.durationApiMs;
+                    const trackedDurationApiWithoutRetriesMs = result.unrecordedDurationApiWithoutRetriesMs ??
+                        result.durationApiWithoutRetriesMs;
+                    tracker.recordDurations({
+                        ...(trackedDurationApiMs === undefined
                             ? {}
-                            : { linesAdded: foregroundLineChanges.linesAdded }),
-                        ...(foregroundLineChanges.linesRemoved === 0
+                            : { apiDurationMs: trackedDurationApiMs }),
+                        ...(trackedDurationApiWithoutRetriesMs === undefined
                             ? {}
-                            : { linesRemoved: foregroundLineChanges.linesRemoved }),
+                            : {
+                                apiDurationWithoutRetriesMs: trackedDurationApiWithoutRetriesMs,
+                            }),
+                        ...(combinedToolDurationMs === 0
+                            ? {}
+                            : { toolDurationMs: combinedToolDurationMs }),
                     });
-                }
-                if (sessionMemory && finalLeafUuid) {
-                    const memorySnapshot = projectClaudeModelMessages(snapshot.entries);
-                    const providerVisibleMessages = [
-                        ...contextMessages,
-                        ...injectTurnContext(memorySnapshot),
-                    ];
-                    const currentContextTokens = budget
-                        ? budget.evaluate(providerVisibleMessages, definitions)
-                            .occupancyTokens
-                        : estimateModelRequestTokens(providerVisibleMessages, definitions);
-                    try {
-                        await sessionMemory.observeContext(currentContextTokens, currentTurnToolCalls, finalLeafUuid, memorySnapshot);
-                    }
-                    catch (error) {
-                        // A failed observation must not fail the user turn; the sidecar
-                        // retains a retryable error for the next observation.
-                        this.options.eventSink?.({
-                            type: 'warning',
-                            message: `Session memory observation failed: ${error instanceof Error ? error.message : String(error)}`,
+                    foregroundLineChanges.add({
+                        isError: false,
+                        ...(result.linesAdded === undefined
+                            ? {}
+                            : { linesAdded: result.linesAdded }),
+                        ...(result.linesRemoved === undefined
+                            ? {}
+                            : { linesRemoved: result.linesRemoved }),
+                    });
+                    if (foregroundLineChanges.linesAdded !== 0 ||
+                        foregroundLineChanges.linesRemoved !== 0) {
+                        tracker.recordLineChanges({
+                            ...(foregroundLineChanges.linesAdded === 0
+                                ? {}
+                                : { linesAdded: foregroundLineChanges.linesAdded }),
+                            ...(foregroundLineChanges.linesRemoved === 0
+                                ? {}
+                                : { linesRemoved: foregroundLineChanges.linesRemoved }),
                         });
                     }
+                    if (sessionMemory && finalLeafUuid) {
+                        const memorySnapshot = projectClaudeModelMessages(snapshot.entries);
+                        const providerVisibleMessages = [
+                            ...contextMessages,
+                            ...injectTurnContext(memorySnapshot),
+                        ];
+                        const currentContextTokens = budget
+                            ? budget.evaluate(providerVisibleMessages, definitions)
+                                .occupancyTokens
+                            : estimateModelRequestTokens(providerVisibleMessages, definitions);
+                        try {
+                            await sessionMemory.observeContext(currentContextTokens, currentTurnToolCalls, finalLeafUuid, memorySnapshot);
+                        }
+                        catch (error) {
+                            // A failed observation must not fail the user turn; the sidecar
+                            // retains a retryable error for the next observation.
+                            this.options.eventSink?.({
+                                type: 'warning',
+                                message: `Session memory observation failed: ${error instanceof Error ? error.message : String(error)}`,
+                            });
+                        }
+                    }
+                    this.options.projectMemoryExtraction?.observe({
+                        sessionId,
+                        directMaintenance: projectMemoryMaintained,
+                        messages: projectMemoryMessages(snapshot.entries),
+                    });
+                    turnCompleted = true;
+                    return {
+                        sessionId,
+                        text: structuredCapture && structuredCapture.calls === 1
+                            ? JSON.stringify(structuredCapture.value)
+                            : result.text,
+                        usage: totalUsage,
+                        ...(combinedDurationMs === undefined
+                            ? {}
+                            : { durationApiMs: combinedDurationMs }),
+                        ...(rawCostUsd === undefined ? {} : { costUsd: rawCostUsd }),
+                        ...(turnModelUsage ? { modelUsage: { ...turnModelUsage } } : {}),
+                        ...(structuredCapture && structuredCapture.calls === 1
+                            ? { structuredOutput: structuredCapture.value }
+                            : {}),
+                    };
                 }
-                this.options.projectMemoryExtraction?.observe({
-                    sessionId,
-                    directMaintenance: projectMemoryMaintained,
-                    messages: projectMemoryMessages(snapshot.entries),
-                });
-                turnCompleted = true;
-                return {
-                    sessionId,
-                    text: structuredCapture && structuredCapture.calls === 1
-                        ? JSON.stringify(structuredCapture.value)
-                        : result.text,
-                    usage: totalUsage,
-                    ...(combinedDurationMs === undefined
-                        ? {}
-                        : { durationApiMs: combinedDurationMs }),
-                    ...(rawCostUsd === undefined ? {} : { costUsd: rawCostUsd }),
-                    ...(turnModelUsage ? { modelUsage: { ...turnModelUsage } } : {}),
-                    ...(structuredCapture && structuredCapture.calls === 1
-                        ? { structuredOutput: structuredCapture.value }
-                        : {}),
-                };
-            }
-            finally {
-                if (!turnCompleted) {
-                    await this.hookLifecycle.end(sessionId, 'other');
+                finally {
+                    if (!turnCompleted) {
+                        await this.hookLifecycle.end(sessionId, 'other');
+                    }
                 }
+            });
+            if (leaseResult.status === 'conflict') {
+                throw new Error(`Claude transcript append conflict: ${leaseResult.reason}`);
             }
-        });
-        if (leaseResult.status === 'conflict') {
-            throw new Error(`Claude transcript append conflict: ${leaseResult.reason}`);
+            const result = leaseResult.value;
+            controller.complete();
+            return result;
+        }
+        catch (error) {
+            controller.fail(error, signal);
+            throw error;
         }
-        return leaseResult.value;
     }
     async ensureFileResources(sessionId, signal) {
         const resources = this.options.fileResources ?? [];
@@ -4622,7 +4843,7 @@ export class ClaudeSessionService {
         }
     }
     async appendBackgroundNotification(sessionId, content) {
-        while (true) {
+        while (!this.closing) {
             const result = await this.turnStore(sessionId).withLease(async (lease) => {
                 const snapshot = await lease.load();
                 if (snapshot.entries.length === 0) {
@@ -4668,16 +4889,23 @@ export class ClaudeSessionService {
                 }
             });
             if (result.status === 'completed')
-                return;
+                return true;
             await new Promise((resolve) => setTimeout(resolve, 25));
         }
+        return false;
     }
-    enqueueBackgroundNotifications(sessionId, messages) {
+    enqueueBackgroundNotifications(sessionId, messages, onAppended) {
         const previous = this.backgroundNotificationWrites.get(sessionId);
-        const queued = (previous ?? Promise.resolve()).then(async () => {
+        const queued = (previous ?? Promise.resolve(true)).then(async (previousCompleted) => {
+            if (!previousCompleted || this.closing)
+                return false;
             for (const message of messages) {
-                await this.appendBackgroundNotification(sessionId, message);
+                if (!(await this.appendBackgroundNotification(sessionId, message))) {
+                    return false;
+                }
+                await onAppended?.(message);
             }
+            return true;
         });
         this.backgroundNotificationWrites.set(sessionId, queued);
         const cleanup = () => {
@@ -4868,13 +5096,6 @@ export class ClaudeSessionService {
         const system = memory ? `${agent.body}\n\n${memory}` : agent.body;
         return system.trim() ? system : null;
     }
-    assembledSystemMessages(agent, messages) {
-        return agent &&
-            this.options.explicitSystemPrompt &&
-            this.options.agentSystemPromptOverridesExplicit
-            ? messages.slice(1)
-            : messages;
-    }
     contextBudget(provider) {
         if (this.options.contextBudget)
             return this.options.contextBudget;