praxis-agent 0.34.0 → 0.36.0

package/dist/application/session-service.js

@@ -5,7 +5,7 @@ import { basename, dirname, extname, isAbsolute, join, relative, resolve, } from
 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 { discoverClaudeProjectRoot, 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';
@@ -23,17 +23,24 @@ 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 { isSessionId } from '../core/session.js';
+import { ContextBudget, estimateModelRequestTokens, isPromptTooLongError, } from '../core/context-budget.js';
+import { ContextEngine } from './context-engine.js';
+import { TurnMemoryCoordinator } from './turn-memory-coordinator.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 { readNativeTranscript, readNativeTranscriptIndexes, exportNativeTranscript, NativeTranscriptIndexCandidateError, } from '../persistence/native-transcript-reader.js';
+import { lastUserPrompt, projectTranscriptDisplay, } from './transcript-projection.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';
@@ -46,7 +53,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;
 }
@@ -76,6 +83,42 @@ function mainAgentToolNames(tools, agent) {
         .map(({ name }) => name)
         .filter((name) => (!requested || requested.has(name)) && !disallowed.has(name));
 }
+function sessionMetadataFields(metadata, options) {
+    const name = metadata.title ??
+        (options.agentNameFallback ? metadata.agentName : undefined);
+    const prLink = metadata.prLink;
+    return {
+        ...(name === undefined ? {} : { name }),
+        ...(metadata.tag === undefined ? {} : { tag: metadata.tag }),
+        ...(metadata.agentName === undefined
+            ? {}
+            : { agentName: metadata.agentName }),
+        ...(metadata.agentColor === undefined
+            ? {}
+            : { agentColor: metadata.agentColor }),
+        ...(metadata.agentSetting === undefined
+            ? {}
+            : { agentSetting: metadata.agentSetting }),
+        ...(metadata.permissionMode === undefined
+            ? {}
+            : { permissionMode: metadata.permissionMode }),
+        ...(metadata.mode === undefined ? {} : { mode: metadata.mode }),
+        ...(prLink === undefined
+            ? {}
+            : {
+                prNumber: prLink.prNumber,
+                ...(prLink.prUrl === undefined ? {} : { prUrl: prLink.prUrl }),
+                ...(prLink.prRepository === undefined
+                    ? {}
+                    : { prRepository: prLink.prRepository }),
+            }),
+    };
+}
+function isSessionCandidateError(error) {
+    return (error instanceof ClaudeSessionIndexCandidateError ||
+        error instanceof NativeTranscriptIndexCandidateError ||
+        ['ENOENT', 'ENOTDIR', 'ELOOP'].includes(error.code ?? ''));
+}
 const emptyToolRegistry = {
     definitions: () => [],
     schedulingPolicy: () => ({ concurrency: 'exclusive' }),
@@ -1232,19 +1275,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();
@@ -1270,16 +1361,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)
@@ -1290,6 +1382,7 @@ export class ClaudeSessionService {
             : 'praxis/provider';
         const metrics = await completeMeteredModelRequest(provider, {
             messages,
+            stableSystemMessageCount: contextProjection.stableSystemSectionCount,
             ...(this.options.effort ? { effort: this.options.effort } : {}),
             ...(signal ? { signal } : {}),
         }, {
@@ -1430,27 +1523,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, {
@@ -1460,6 +1547,7 @@ export class ClaudeSessionService {
         await this.activateSessionCostTracker(sessionId);
         const metrics = await completeMeteredModelRequest(provider, {
             messages,
+            stableSystemMessageCount: contextProjection.stableSystemSectionCount,
             ...(provider.capabilities.tools
                 ? { tools: suggestionTools?.definitions() ?? [] }
                 : {}),
@@ -1507,19 +1595,62 @@ export class ClaudeSessionService {
         }
         catch (error) {
             if (error.code === 'ENOENT')
-                return [];
-            throw error;
+                names = [];
+            else
+                throw error;
         }
         const discoveredSessionIds = names
             .filter((name) => extname(name) === '.jsonl')
             .map((name) => basename(name, '.jsonl'))
-            .filter((sessionId) => isClaudeSessionId(sessionId));
+            .filter((sessionId) => isSessionId(sessionId));
         const sessionIds = [
             ...new Set([
                 ...discoveredSessionIds,
                 ...this.explicitSessionFiles.keys(),
             ]),
         ];
+        if (this.options.dataPlane === 'native') {
+            const nativeResults = await readNativeTranscriptIndexes(sessionIds.map((sessionId) => ({
+                sessionId,
+                path: this.explicitSessionFiles.get(sessionId) ??
+                    join(projectRoot, `${sessionId}.jsonl`),
+            })));
+            const legacyResults = await readClaudeSessionIndexes(nativeResults.flatMap((result) => 'result' in result && result.result.format === 'legacy'
+                ? [{ sessionId: result.sessionId, path: result.path }]
+                : []), this.schema);
+            const legacyBySessionId = new Map(legacyResults.map((result) => [result.sessionId, result]));
+            const nativeSummaries = nativeResults.map((result) => {
+                try {
+                    if ('error' in result)
+                        throw result.error;
+                    const file = result.result;
+                    if (file.format === 'legacy') {
+                        const legacy = legacyBySessionId.get(result.sessionId);
+                        if (!legacy)
+                            throw new Error(`Missing legacy transcript index for ${result.sessionId}`);
+                        if ('error' in legacy)
+                            throw legacy.error;
+                        return this.claudeSessionSummary(result.sessionId, legacy.index);
+                    }
+                    return {
+                        sessionId: result.sessionId,
+                        lastPrompt: lastUserPrompt(file.records.map((record) => record.event)),
+                        updatedAt: file.updatedAt,
+                        status: this.nativeSessionStatus(file.issue, file.records.length),
+                        issue: file.issue,
+                    };
+                }
+                catch (error) {
+                    if (isSessionCandidateError(error))
+                        return null;
+                    throw error;
+                }
+            });
+            return nativeSummaries
+                .filter((summary) => summary !== null)
+                .sort((left, right) => right.updatedAt.localeCompare(left.updatedAt) ||
+                left.sessionId.localeCompare(right.sessionId));
+        }
         if (discoveredRoot !== undefined) {
             for (const sessionId of discoveredSessionIds) {
                 this.discoveredProjectRoots.set(sessionId, projectRoot);
@@ -1534,46 +1665,11 @@ export class ClaudeSessionService {
             try {
                 if ('error' in result)
                     throw result.error;
-                const { sessionId, index } = result;
-                const metadata = reduceClaudeSessionMetadata(index.entries, sessionId);
-                const name = metadata.title ?? metadata.agentName;
-                const prLink = metadata.prLink;
-                return {
-                    sessionId,
-                    ...(name === undefined ? {} : { name }),
-                    ...(metadata.tag === undefined ? {} : { tag: metadata.tag }),
-                    ...(metadata.agentName === undefined
-                        ? {}
-                        : { agentName: metadata.agentName }),
-                    ...(metadata.agentColor === undefined
-                        ? {}
-                        : { agentColor: metadata.agentColor }),
-                    ...(metadata.agentSetting === undefined
-                        ? {}
-                        : { agentSetting: metadata.agentSetting }),
-                    ...(metadata.permissionMode === undefined
-                        ? {}
-                        : { permissionMode: metadata.permissionMode }),
-                    ...(metadata.mode === undefined ? {} : { mode: metadata.mode }),
-                    lastPrompt: metadata.lastPrompt ?? null,
-                    updatedAt: index.updatedAt,
-                    status: this.sessionStatus(index.issue, index.entries.length),
-                    issue: index.issue,
-                    ...(prLink
-                        ? {
-                            prNumber: prLink.prNumber,
-                            prUrl: prLink.prUrl,
-                            prRepository: prLink.prRepository,
-                        }
-                        : {}),
-                };
+                return this.claudeSessionSummary(result.sessionId, result.index);
             }
             catch (error) {
-                if (error instanceof ClaudeSessionIndexCandidateError)
+                if (isSessionCandidateError(error))
                     return null;
-                if (['ENOENT', 'ENOTDIR', 'ELOOP'].includes(error.code ?? '')) {
-                    return null;
-                }
                 throw error;
             }
         });
@@ -1584,6 +1680,37 @@ export class ClaudeSessionService {
     }
     async inspect(sessionId) {
         this.assertSessionPersistence();
+        if (this.options.dataPlane === 'native') {
+            const paths = this.paths(sessionId);
+            const file = await readNativeTranscript(paths.sessionFile);
+            if (file.format === 'legacy') {
+                const recovery = await this.store(sessionId).loadReadOnly();
+                const metadata = reduceClaudeSessionMetadata(recovery.entries, sessionId);
+                return {
+                    sessionId,
+                    ...sessionMetadataFields(metadata, { agentNameFallback: false }),
+                    lastPrompt: metadata.lastPrompt ?? null,
+                    updatedAt: file.updatedAt,
+                    status: this.sessionStatus(recovery.issue, recovery.entries.length),
+                    issue: recovery.issue,
+                    writeMode: this.schema.writeMode,
+                    entryCount: recovery.entries.length,
+                    byteLength: file.byteLength,
+                    newlineTerminated: file.newlineTerminated,
+                };
+            }
+            return {
+                sessionId,
+                lastPrompt: lastUserPrompt(file.records.map((record) => record.event)),
+                updatedAt: file.updatedAt,
+                status: this.nativeSessionStatus(file.issue, file.records.length),
+                issue: file.issue,
+                writeMode: file.writeMode,
+                entryCount: file.records.length,
+                byteLength: file.byteLength,
+                newlineTerminated: file.newlineTerminated,
+            };
+        }
         await this.discoverProjectRoot(sessionId);
         const paths = this.paths(sessionId);
         let metadata;
@@ -1598,30 +1725,9 @@ export class ClaudeSessionService {
         }
         const recovery = await this.store(sessionId).loadReadOnly();
         const sessionMetadata = reduceClaudeSessionMetadata(recovery.entries, sessionId);
-        const prLink = sessionMetadata.prLink;
         return {
             sessionId,
-            ...(sessionMetadata.title === undefined
-                ? {}
-                : { name: sessionMetadata.title }),
-            ...(sessionMetadata.tag === undefined
-                ? {}
-                : { tag: sessionMetadata.tag }),
-            ...(sessionMetadata.agentName === undefined
-                ? {}
-                : { agentName: sessionMetadata.agentName }),
-            ...(sessionMetadata.agentColor === undefined
-                ? {}
-                : { agentColor: sessionMetadata.agentColor }),
-            ...(sessionMetadata.agentSetting === undefined
-                ? {}
-                : { agentSetting: sessionMetadata.agentSetting }),
-            ...(sessionMetadata.permissionMode === undefined
-                ? {}
-                : { permissionMode: sessionMetadata.permissionMode }),
-            ...(sessionMetadata.mode === undefined
-                ? {}
-                : { mode: sessionMetadata.mode }),
+            ...sessionMetadataFields(sessionMetadata, { agentNameFallback: false }),
             lastPrompt: sessionMetadata.lastPrompt ?? null,
             updatedAt: metadata.mtime.toISOString(),
             status: this.sessionStatus(recovery.issue, recovery.entries.length),
@@ -1631,13 +1737,6 @@ export class ClaudeSessionService {
             entryCount: recovery.entries.length,
             byteLength: recovery.tail.byteLength,
             newlineTerminated: recovery.tail.newlineTerminated,
-            ...(prLink
-                ? {
-                    prNumber: prLink.prNumber,
-                    prUrl: prLink.prUrl,
-                    prRepository: prLink.prRepository,
-                }
-                : {}),
         };
     }
     async readEffectiveAgentColor(sessionId) {
@@ -1647,6 +1746,8 @@ export class ClaudeSessionService {
     }
     async export(sessionId) {
         this.assertSessionPersistence();
+        if (this.options.dataPlane === 'native')
+            return exportNativeTranscript(this.paths(sessionId).sessionFile);
         await this.discoverProjectRoot(sessionId);
         try {
             return await this.store(sessionId).exportReadOnly();
@@ -1662,17 +1763,40 @@ export class ClaudeSessionService {
         this.assertSessionPersistence();
         const path = resolve(requestedPath);
         const pathMetadata = await lstat(path);
+        const dataPlaneName = this.options.dataPlane === 'native' ? 'Native' : 'Claude';
         if (!pathMetadata.isFile()) {
-            throw new Error(`Claude resume path must be a regular JSONL file: ${path}`);
+            throw new Error(`${dataPlaneName} resume path must be a regular JSONL file: ${path}`);
         }
         if (extname(path).toLowerCase() !== '.jsonl') {
-            throw new Error(`Claude resume path must end in .jsonl: ${path}`);
+            throw new Error(`${dataPlaneName} resume path must end in .jsonl: ${path}`);
         }
         const sessionId = basename(path, '.jsonl');
-        if (!isClaudeSessionId(sessionId)) {
-            throw new Error(`Claude resume path filename must be a session UUID: ${path}`);
+        if (!isSessionId(sessionId)) {
+            throw new Error(`${dataPlaneName} resume path filename must be a session UUID: ${path}`);
         }
         const canonicalPath = await realpath(path);
+        if (this.options.dataPlane === 'native') {
+            const detected = await readNativeTranscript(canonicalPath);
+            if (detected.format === 'native') {
+                if (detected.issue?.kind === 'unsupported-version')
+                    throw new Error('Native resume transcript version is unsupported');
+                if (detected.issue ||
+                    !detected.newlineTerminated ||
+                    detected.records.length === 0)
+                    throw new Error('Native resume transcript must be a complete non-empty newline-terminated file');
+                if (detected.records.some((record) => record.event.sessionId !== sessionId))
+                    throw new Error('Native resume transcript contains a different sessionId');
+                this.explicitSessionFiles.set(sessionId, canonicalPath);
+                this.discoveredProjectRoots.set(sessionId, dirname(canonicalPath));
+                return {
+                    sessionId,
+                    lastPrompt: lastUserPrompt(detected.records.map((record) => record.event)),
+                    updatedAt: detected.updatedAt,
+                    status: 'read-only',
+                    issue: detected.issue,
+                };
+            }
+        }
         const exact = this.pathsForCwd(sessionId, this.activeCwd());
         const candidate = new ClaudeTranscriptStore({
             sessionFile: canonicalPath,
@@ -1686,6 +1810,10 @@ export class ClaudeSessionService {
         if (snapshot.entries.length === 0) {
             throw new Error('Claude resume transcript must not be empty');
         }
+        if (this.options.dataPlane === 'native' &&
+            this.schema.writeMode !== 'read-write') {
+            throw new Error('Native legacy resume transcript is read-only');
+        }
         let matchingSessionIdentity = false;
         for (const entry of snapshot.entries) {
             if (entry.sessionId === sessionId)
@@ -1703,40 +1831,21 @@ export class ClaudeSessionService {
         this.explicitResumeLeafUuids.set(sessionId, selected.leafUuid);
         this.discoveredProjectRoots.set(sessionId, dirname(canonicalPath));
         const metadata = reduceClaudeSessionMetadata(snapshot.entries, sessionId);
-        const prLink = metadata.prLink;
         return {
             sessionId,
-            ...(metadata.title === undefined ? {} : { name: metadata.title }),
-            ...(metadata.tag === undefined ? {} : { tag: metadata.tag }),
-            ...(metadata.agentName === undefined
-                ? {}
-                : { agentName: metadata.agentName }),
-            ...(metadata.agentColor === undefined
-                ? {}
-                : { agentColor: metadata.agentColor }),
-            ...(metadata.agentSetting === undefined
-                ? {}
-                : { agentSetting: metadata.agentSetting }),
-            ...(metadata.permissionMode === undefined
-                ? {}
-                : { permissionMode: metadata.permissionMode }),
-            ...(metadata.mode === undefined ? {} : { mode: metadata.mode }),
+            ...sessionMetadataFields(metadata, { agentNameFallback: false }),
             lastPrompt: metadata.lastPrompt ?? null,
             updatedAt: pathMetadata.mtime.toISOString(),
             status: this.sessionStatus(null, snapshot.entries.length),
             issue: null,
-            ...(prLink === undefined
-                ? {}
-                : {
-                    prNumber: prLink.prNumber,
-                    ...(prLink.prUrl === undefined ? {} : { prUrl: prLink.prUrl }),
-                    ...(prLink.prRepository === undefined
-                        ? {}
-                        : { prRepository: prLink.prRepository }),
-                }),
         };
     }
     async transcript(sessionId, resumeSessionAt) {
+        if (this.options.dataPlane === 'native') {
+            const file = await readNativeTranscript(this.paths(sessionId).sessionFile);
+            if (file.format === 'native')
+                return projectTranscriptDisplay(file.records.map((record) => record.event), resumeSessionAt);
+        }
         await this.discoverProjectRoot(sessionId);
         try {
             const recovery = await this.store(sessionId).loadReadOnly();
@@ -1987,7 +2096,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);
@@ -2320,6 +2433,7 @@ export class ClaudeSessionService {
     }
     async fork(parentSessionId, sessionId = randomUUID(), resumeSessionAt) {
         this.assertSessionPersistence();
+        await this.assertNativeWriteTargetIsLegacy(parentSessionId);
         this.assertWritable();
         const entries = await this.nativeForkEntries(parentSessionId, sessionId, resumeSessionAt);
         const result = await this.store(sessionId).create(entries);
@@ -2633,1695 +2747,1658 @@ export class ClaudeSessionService {
         }
         return 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');
-        }
-        await this.activateSessionCostTracker(sessionId);
-        if (this.options.sessionPersistence !== false) {
-            this.durableMetadataSessions.add(sessionId);
-        }
-        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`);
-                }
-            }
-            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();
-                }
+    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 {
+            if (requireExisting)
+                await this.assertNativeWriteTargetIsLegacy(sessionId);
+            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 (requireExisting && snapshot.entries.length === 0) {
-                throw new Error(`Claude session not found: ${sessionId}`);
+            if (shellCommand !== undefined && shellCommand.trim().length === 0) {
+                throw new Error('Shell command must not be empty');
             }
-            this.rememberDurableMetadata(sessionId, snapshot.entries);
-            if (resumeSessionAt !== undefined) {
-                snapshot = {
-                    entries: selectClaudeTranscriptAtMessage(snapshot.entries, resumeSessionAt),
-                    tail: { ...snapshot.tail, branchParentUuid: resumeSessionAt },
-                };
+            await this.activateSessionCostTracker(sessionId);
+            if (this.options.sessionPersistence !== false) {
+                this.durableMetadataSessions.add(sessionId);
             }
-            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.ensureFileResources(sessionId, signal);
+            this.worktreeManager?.bindSession(sessionId);
+            if (this.options.initialWorktree) {
+                await this.worktreeManager?.ensureInitial(this.options.initialWorktreeName);
             }
-            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,
-                        },
-                    };
-                }
+            const pinnedCwd = this.sessionCwds.get(sessionId) ?? this.activeCwd();
+            this.sessionCwds.set(sessionId, pinnedCwd);
+            if (this.options.workspace?.cwd() !== pinnedCwd) {
+                this.options.workspace?.setCwd(pinnedCwd);
             }
-            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);
+            this.runtimeCwd = pinnedCwd;
+            if (requireExisting) {
+                await this.discoverProjectRoot(sessionId);
             }
-            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}`);
+            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 &&
-                    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 };
+                if (resumeSessionAt !== undefined) {
+                    snapshot = {
+                        entries: selectClaudeTranscriptAtMessage(snapshot.entries, resumeSessionAt),
+                        tail: { ...snapshot.tail, branchParentUuid: resumeSessionAt },
+                    };
                 }
-            };
-            const recordHookOutcome = async (outcome, deferUntilApproval = false) => {
-                if (deferUntilApproval) {
-                    pendingRecoveryHookOutcomes.push(outcome);
-                    return;
+                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 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 (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,
+                            },
+                        };
+                    }
                 }
-                if (entries.length === 0) {
-                    pendingRecoveryHookOutcomes.length = 0;
-                    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);
                 }
-                const appendResult = await lease.appendMany(snapshot.tail, entries);
-                if (appendResult.status === 'conflict') {
-                    throw new Error(`Claude transcript append conflict: ${appendResult.reason}`);
+                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);
                 }
-                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,
+                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 sessionMemory = this.sessionMemoryController(sessionId);
+                const turnMemory = new TurnMemoryCoordinator({
                     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),
-                        }
+                    ...(sessionMemory ? { session: sessionMemory } : {}),
+                    ...(this.options.projectMemoryRecall
+                        ? { projectRecall: this.options.projectMemoryRecall }
                         : {}),
-                    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);
-            }
-            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 }
+                    ...(this.options.projectMemoryExtraction
+                        ? { projectExtraction: this.options.projectMemoryExtraction }
                         : {}),
-                }))
-                : 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;
-                    },
+                    warn: (message) => this.options.eventSink?.({ type: 'warning', message }),
+                });
+                if (!skipUserPrompt && shellCommand === undefined) {
+                    turnMemory.prefetch({
+                        turnId: randomUUID(),
+                        prompt: effectivePrompt,
+                        ...(signal ? { signal } : {}),
+                    });
                 }
-                : 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, this.options.eventSink, {
-                emitInitialContextState: false,
-                ...(this.options.emitToolUseSummaries
-                    ? {
-                        generateToolUseSummary: ({ tools, lastAssistantText, signal }) => generateToolUseSummary(provider, tools, signal, lastAssistantText, (metrics) => this.recordAuxiliaryMetrics(sessionId, metrics)),
+                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 };
                     }
-                    : {}),
-                ...(this.options.pricing
-                    ? {
-                        costUsd: (usage) => {
-                            const pricing = this.options.pricing?.resolve(provider.model ?? 'praxis/provider');
-                            return pricing ? usageCostUsd(usage, pricing) : undefined;
-                        },
+                };
+                const recordHookOutcome = async (outcome, deferUntilApproval = false) => {
+                    if (deferUntilApproval) {
+                        pendingRecoveryHookOutcomes.push(outcome);
+                        return;
                     }
-                    : {}),
-                ...(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',
+                    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,
                         });
-                        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,
-                        };
+                        entries.push(...outcomeEntries);
+                        history = [...history, ...outcomeEntries];
+                        const lastEntry = outcomeEntries.at(-1);
+                        if (typeof lastEntry?.uuid === 'string')
+                            parentUuid = lastEntry.uuid;
                     }
-                    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,
-                        };
+                    if (entries.length === 0) {
+                        pendingRecoveryHookOutcomes.length = 0;
+                        return;
                     }
-                    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 }
-                                : {}),
+                    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.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);
+                        ...(this.options.eventSink
+                            ? { eventSink: this.options.eventSink }
+                            : {}),
+                        ...(taskTools
+                            ? {
+                                backgroundTaskNotifications: (waitForRunning) => taskTools.notifications(waitForRunning),
                             }
-                            else if (call.name === 'Write' || call.name === 'Edit') {
-                                projectMemoryMaintained = true;
+                            : {}),
+                        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);
+                }
+                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 === '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 === 'Write' || call.name === 'Edit') &&
+                                (await this.options.interactiveTools?.isPlanFile(sessionId, path))) {
+                                return interactiveMessageTools.execute(call, context);
                             }
-                        }
-                    }
-                    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');
-                        }
+                            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;
+                        },
                     }
-                },
-                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');
+                    : 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)),
                         }
-                        const followUpTail = await this.append(lease, snapshot.tail, followUpEntry);
-                        snapshot = {
-                            entries: [...snapshot.entries, followUpEntry],
-                            tail: followUpTail,
-                        };
-                        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);
-                }
-                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
+                        : {}),
+                    ...(this.options.pricing
                         ? {
-                            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;
+                            costUsd: (usage) => {
+                                const pricing = this.options.pricing?.resolve(provider.model ?? 'praxis/provider');
+                                return pricing ? usageCostUsd(usage, pricing) : undefined;
                             },
-                            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,
-                    };
-                }
-                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,
-                    });
-                    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] }
+                    ...(this.options.maxBudgetUsd === undefined
+                        ? {}
+                        : { maxBudgetUsd: this.options.maxBudgetUsd }),
+                    ...(hookTools
+                        ? { tools: hookTools, permissions: hookTools }
                         : {
-                            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',
+                            ...(structuredTools ? { tools: structuredTools } : {}),
+                            ...(turnPermissions ? { permissions: turnPermissions } : {}),
+                        }),
                 });
-                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 ?? []),
-                            ],
+                let currentTurnUserMessages = null;
+                let currentTurnToolCalls = 0;
+                let projectMemoryMaintained = false;
+                let projectMemoryRecallMessages = [];
+                let observeModelRequestUsage = () => undefined;
+                const observer = {
+                    modelRequestCompleted: async (input) => {
+                        observeModelRequestUsage(input);
+                    },
+                    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,
+                            };
                         }
-                        : {}),
-                    ...(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;
+                        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,
+                            };
                         }
-                    }
-                    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) => ({
-                                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,
-                        {
-                            role: 'user',
-                            content: formatClaudeCompactSummary(''),
-                        },
-                    ], definitions);
-                    let targetTokens = Math.min(8192, compactEnvelope.availableTokens - compactEnvelope.estimatedTokens);
-                    if (targetTokens < 1) {
-                        budget.assertFits(budget.evaluate([
-                            ...irreducibleMessages,
+                        const [entry] = translateProviderEvents([
                             {
-                                role: 'user',
-                                content: formatClaudeCompactSummary('a'),
+                                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 }
+                                    : {}),
                             },
-                        ], 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] : []),
+                        ], 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') {
+                                    turnMemory.recordRead(path);
                                 }
-                                : {}),
-                            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,
-                        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,
-                            ...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);
+                                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)) {
+                                        turnMemory.recordRead(resolvedAccessedPath);
+                                    }
+                                }
+                            }
                         }
-                        if (meteringDurationsInput !== undefined) {
-                            preflight.recordDurations(meteringDurationsInput);
+                        if (toolResult.isError ||
+                            call.name !== 'Read' ||
+                            !this.options.conditionalRuleResolver ||
+                            !toolResult.accessedPaths) {
+                            return;
                         }
-                    }
-                    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}`);
+                        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');
+                            }
                         }
-                        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 }
-                                : {}),
+                    },
+                    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, followUpEntry],
+                                tail: followUpTail,
+                            };
+                            currentTurnUserMessages?.push(content);
+                            await Promise.all(this.sessionSubagentExecutors(sessionId, true).map((executor) => executor.acknowledgeNotifications([content])));
                         }
-                        : 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;
+                    },
+                };
+                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 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,
+                    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,
+                            }
+                            : {}),
                     };
-                }
-                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 unresolvedToolCall = unresolvedToolCalls[0];
+                    if (unresolvedToolCall && !approveRecovery) {
+                        throw new Error(`Claude session tool call ${unresolvedToolCall.id} requires explicit recovery approval`);
                     }
-                }
-                let shellUsage = { inputTokens: 0, outputTokens: 0 };
-                let shellModelUsage;
-                if (shellCommand !== undefined) {
-                    const call = {
-                        id: `shell_${randomUUID().replaceAll('-', '')}`,
-                        name: 'Bash',
-                        input: { command: shellCommand },
+                    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,
+                        };
+                    }
+                    let agentSystem = null;
+                    let planModeMessage;
+                    let sessionMemoryMessage = null;
+                    let contextMessages = [];
+                    let contextProjection = {
+                        systemMessages: [],
+                        stableSystemSectionCount: 0,
                     };
-                    this.options.eventSink?.({
-                        type: 'shell-command',
-                        callId: call.id,
-                        command: shellCommand,
-                    });
-                    let shellResult;
-                    try {
-                        shellResult = await runtime.executeDirectToolCall(call, {
+                    let stableSystemMessageCount = 0;
+                    const refreshRuntimeContext = async () => {
+                        agentSystem = await this.mainAgentSystemPrompt(agent);
+                        planModeMessage =
+                            this.options.interactiveTools?.contextMessage(sessionId);
+                        sessionMemoryMessage = this.sessionMemoryMessage(await turnMemory.sessionSummary());
+                        const assembledContext = await assembleContextSnapshot(this.options.contextAssembler, {
                             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 }
+                            lifecycleId: sessionId,
+                            ...(agentSystem
+                                ? { mode: 'agent', baseSystemPrompt: agentSystem }
                                 : {}),
-                            permissionUpdates: this.sessionPermissionUpdates.get(sessionId) ?? [],
-                            onPermissionUpdates: (updates) => this.applyPermissionUpdates(sessionId, updates),
-                            ...(signal ? { signal } : {}),
-                        });
-                    }
-                    catch (error) {
-                        this.options.eventSink?.({
-                            type: 'shell-cancelled',
-                            callId: call.id,
+                            turn: {
+                                ...(planModeMessage ? { planMode: planModeMessage } : {}),
+                                ...(sessionMemoryMessage
+                                    ? { sessionMemory: sessionMemoryMessage }
+                                    : {}),
+                                ...(this.options.brief ? { briefOutput: true } : {}),
+                                ...(this.options.structuredOutputSchema
+                                    ? { structuredOutput: true }
+                                    : {}),
+                            },
                         });
-                        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,
+                        contextProjection = projectContextSnapshot(assembledContext);
+                        stableSystemMessageCount =
+                            contextProjection.stableSystemSectionCount;
+                        contextMessages = [...contextProjection.systemMessages];
                     };
-                    currentTurnUserMessages.push(`<bash-stdout>${stdout}</bash-stdout><bash-stderr>${stderr}</bash-stderr>`);
+                    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: 'shell-result',
-                        callId: call.id,
-                        stdout,
-                        stderr,
-                        isError: shellResult.isError,
+                        type: 'state',
+                        state: 'assembling-context',
                     });
-                }
-                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 },
-                            ];
-                        }
-                        await compactIfNeeded([], currentTurnUserMessages ?? []);
-                        if (stableSystemMessageCount === undefined) {
-                            delete runtimeRequest.stableSystemMessageCount;
-                        }
-                        else {
-                            runtimeRequest.stableSystemMessageCount = stableSystemMessageCount;
+                    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 contextEngine = new ContextEngine({
+                        ...(budget ? { budget } : {}),
+                        autoCompact: this.options.autoCompact !== false,
+                        memory: {
+                            beforeCompact: () => turnMemory.beforeCompact(),
+                            afterCompact: () => turnMemory.afterCompact(),
+                        },
+                    });
+                    observeModelRequestUsage = ({ usage, messages, tools }) => {
+                        contextEngine.observeUsage(usage, messages, tools);
+                    };
+                    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 [
-                            ...contextMessages,
-                            ...injectTurnContext([
+                            ...messages.slice(0, insertionIndex),
+                            ...agentMentionMessages.map((content) => ({
+                                role: 'user',
+                                content,
+                            })),
+                            ...messages.slice(insertionIndex),
+                        ];
+                    };
+                    const injectDynamicContext = (messages) => injectFirstUserMessageContext(messages, contextProjection.firstUserMessageContext);
+                    const injectTurnContext = (messages) => injectAgentMentionContext(injectDynamicContext(messages));
+                    let compactionAnchorUuid = this.lastMessageUuid(snapshot.entries);
+                    const contextTransitionPort = (pendingMessages = [], preservedUserMessages = []) => ({
+                        current: () => {
+                            const historyMessages = [
                                 ...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
+                            ];
+                            return {
+                                messages: [
+                                    ...contextMessages,
+                                    ...injectTurnContext([
+                                        ...historyMessages,
+                                        ...pendingMessages,
+                                    ]),
+                                ],
+                                tools: definitions,
+                            };
+                        },
+                        irreducible: () => ({
+                            messages: [
+                                ...contextMessages,
+                                ...injectTurnContext([
+                                    ...pendingMessages,
+                                    ...preservedUserMessages.map((content) => ({
+                                        role: 'user',
+                                        content,
+                                    })),
+                                ]),
+                            ],
+                            tools: definitions,
+                        }),
+                        propose: async () => {
+                            if (!budget) {
+                                throw new Error('Context budget is unavailable');
+                            }
+                            const historyMessages = [
+                                ...projectClaudeModelMessages(snapshot.entries),
+                                ...projectMemoryRecallMessages,
+                            ];
+                            const irreducibleMessages = [
+                                ...contextMessages,
+                                ...injectTurnContext([
+                                    ...pendingMessages,
+                                    ...preservedUserMessages.map((content) => ({
+                                        role: 'user',
+                                        content,
+                                    })),
+                                ]),
+                            ];
+                            let logicalParentUuid = compactionAnchorUuid;
+                            if (!logicalParentUuid || historyMessages.length === 0) {
+                                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), { sessionMemoryReady: true })
+                                : 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,
+                                {
+                                    role: 'user',
+                                    content: formatClaudeCompactSummary(''),
+                                },
+                            ], 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
                                         ? {
-                                            durationApiMs: batchDurationApiMs,
-                                            durationApiWithoutRetriesMs: batchDurationApiWithoutRetriesMs,
+                                            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,
+                                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,
+                                    ...replayEntries,
+                                ]),
+                                ...projectMemoryRecallMessages,
+                            ];
+                            const afterHistory = budget.evaluate([...contextMessages, ...injectTurnContext(compactedHistory)], definitions);
+                            const proposedMessages = [
+                                ...contextMessages,
+                                ...injectTurnContext([...compactedHistory, ...pendingMessages]),
+                            ];
+                            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 }),
                                 };
-                            },
-                        }
-                        : {}),
-                    ...(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 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);
+                                }
+                            }
+                            return {
+                                envelope: {
+                                    messages: proposedMessages,
+                                    tools: definitions,
+                                },
+                                commit: async () => {
+                                    if (signal?.aborted)
+                                        throw new AgentRunCancelledError();
+                                    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}`);
+                                        }
+                                        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',
+                                    });
+                                    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);
+                                    }
+                                },
+                            };
+                        },
                     });
-                };
-                let result;
-                try {
-                    try {
-                        result = await attemptMainTurn();
+                    await contextEngine.prepare(contextTransitionPort(pendingUserMessages), signal);
+                    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 }
+                                    : {}),
+                            }
+                            : 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,
+                        };
                     }
-                    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 contextEngine.prepare(contextTransitionPort([], currentTurnUserMessages ?? []), signal);
+                        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 = turnMemory.consumeRecall();
+                            if (recalled) {
+                                projectMemoryRecallMessages = [
+                                    { role: 'user', content: recalled.content },
+                                ];
+                            }
+                            await contextEngine.prepare(contextTransitionPort([], currentTurnUserMessages ?? []), signal);
+                            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;
+                            const recovery = await contextEngine.recover(error, contextTransitionPort([], currentTurnUserMessages ?? []), signal);
+                            if (recovery.kind !== 'retry') {
+                                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;
+                            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.
+                                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;
+                    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) {
+                    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 }),
+                        });
+                    }
                     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)}`,
-                        });
-                    }
+                    const currentContextTokens = contextEngine.report({
+                        messages: providerVisibleMessages,
+                        tools: definitions,
+                    })?.occupancyTokens ??
+                        estimateModelRequestTokens(providerVisibleMessages, definitions);
+                    await turnMemory.observeSuccess({
+                        ...(finalLeafUuid ? { messageId: finalLeafUuid } : {}),
+                        occupancyTokens: currentContextTokens,
+                        toolCalls: currentTurnToolCalls,
+                        messages: memorySnapshot,
+                        projectMessages: projectMemoryMessages(snapshot.entries),
+                        directMaintenance: projectMemoryMaintained,
+                    });
+                    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 ?? [];
@@ -4416,11 +4493,12 @@ export class ClaudeSessionService {
      *  recent suffix. Returns null to fall back to the existing full-compaction
      *  behavior (missing/invalid watermark, empty projection, or oversized
      *  projection). */
-    async selectMemoryPreservedCompact(sessionId, activeEntries) {
+    async selectMemoryPreservedCompact(sessionId, activeEntries, options = {}) {
         const controller = this.sessionMemoryController(sessionId);
         if (controller === null)
             return null;
-        await controller.waitForCompact();
+        if (options.sessionMemoryReady !== true)
+            await controller.waitForCompact();
         let watermark = null;
         let memorySummary = '';
         try {
@@ -5052,12 +5130,37 @@ export class ClaudeSessionService {
             return 'corrupt';
         return this.schema.writeMode === 'read-write' ? 'ready' : 'read-only';
     }
+    nativeSessionStatus(issue, entryCount) {
+        if (issue?.kind === 'unsupported-version')
+            return 'read-only';
+        if (entryCount === 0 || issue)
+            return 'corrupt';
+        return 'read-only';
+    }
+    claudeSessionSummary(sessionId, index) {
+        const metadata = reduceClaudeSessionMetadata(index.entries, sessionId);
+        return {
+            sessionId,
+            ...sessionMetadataFields(metadata, { agentNameFallback: true }),
+            lastPrompt: metadata.lastPrompt ?? null,
+            updatedAt: index.updatedAt,
+            status: this.sessionStatus(index.issue, index.entries.length),
+            issue: index.issue,
+        };
+    }
     provider() {
         if (!this.options.provider) {
             throw new Error('A model provider is required for run and resume');
         }
         return this.options.provider;
     }
+    async assertNativeWriteTargetIsLegacy(sessionId) {
+        if (this.options.dataPlane !== 'native')
+            return;
+        const existing = await readNativeTranscript(this.paths(sessionId).sessionFile);
+        if (existing.format === 'native')
+            throw new Error('native transcript is read-only until native writes are enabled');
+    }
     model() {
         return this.activeProvider?.model ?? this.options.provider?.model;
     }
@@ -5087,13 +5190,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;
@@ -5122,7 +5218,7 @@ export class ClaudeSessionService {
         return this.sessionMemoryProviderFactory() !== null;
     }
     sessionMemoryController(sessionId) {
-        if (!this.sessionMemoryEnabled() || !isClaudeSessionId(sessionId)) {
+        if (!this.sessionMemoryEnabled() || !isSessionId(sessionId)) {
             return null;
         }
         let controller = this.sessionMemoryControllers.get(sessionId);