pi-agent-browser-native 0.9.3 → 0.9.5

package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output.js

@@ -1,975 +1,25 @@
 import { rm } from "node:fs/promises";
-import { observeNativeWebMcp } from "../../webmcp-observation.js";
-import { parseArgvDescriptor } from "../../argv-descriptor.js";
-import { isBrowserIndependentRead, needsManagedSession } from "../../command-policy.js";
-import { deleteIdentityKeysInNamespace, getAgentBrowserSessionIdentityKey, getBooleanFlagValue, isAgentBrowserSessionIdentityKeyInNamespace } from "../../argv-grammar.js";
-import { batchHasSuccessfulCloseAll, getSuccessfulBatchCloseLifecycle } from "../../batch-lifecycle.js";
-import { isCloseAllCommand, isCloseCommand, isNavigationObservableCommandName, isOpenNavigationCommand, isPageMutationCommand, isRecordPageTransitionCommand, isUnverifiedPageTransitionCommand, isWindowOrDiffPageTransitionCommand } from "../../command-taxonomy.js";
-import { OPEN_RESULT_TAB_CORRECTION_FLAGS } from "../../launch-scoped-flags.js";
-import { cleanupElectronLaunchResources, inspectElectronLaunchStatus } from "../../electron/cleanup.js";
-import { getResultingPageTargetState, commandRequiresLivePageVerification } from "../../page-target-validation.js";
-import { analyzeNetworkSourceLookupResults, analyzeSourceLookupResults, redactNetworkSourceLookupAnalysis } from "../../input-modes/lookups.js";
-import { analyzeQaPresetResults, analyzeQaPresetTimeout, buildQaCompactFailureText, buildQaCompactPassText, extractQaPageContext } from "../../input-modes/job.js";
-import { applyNetworkRouteRecords, buildNetworkRouteDiagnostics } from "../../results/network-routes.js";
-import { buildToolPresentation } from "../../results/presentation.js";
-import { compactLargePresentationOutput } from "../../results/presentation/large-output.js";
-import { extractEnvelopeErrorText, getAgentBrowserErrorText, parseAgentBrowserEnvelope } from "../../results/envelope.js";
-import { detectConfirmationRequired } from "../../results/confirmation.js";
-import { extractAgentBrowserLifecycle, omitUpstreamLifecycle } from "../../results/presentation/common.js";
-import { getClipboardWritePayloadCandidates, redactClipboardPermissionEcho, redactClipboardPermissionErrorValue } from "../../results/presentation/errors.js";
-import { shouldCaptureSemanticActionNavigationSummary } from "../../results/presentation/semantic-action.js";
-import { buildPageTransitionRefSnapshotInvalidation, commandExplicitlyTargetsAboutBlank, getCommandRefSnapshotInvalidation, deriveSessionTabTarget, extractLatestRefSnapshotStateFromBatchResults, extractRefSnapshotFromData, extractSessionTabTargetFromBatchResults, extractSessionTabTargetFromCommandData, isAboutBlankSessionTabTarget, normalizeSessionTabTarget, } from "../../session-page-state.js";
-import { isRecord } from "../../parsing.js";
-import { getAgentBrowserProcessEnvironment } from "../../process-environment.js";
-import { buildReadConfirmationNextActions, isBrowserIndependentConfirmation, isSuccessfulNativeConfirmedClose, nextReadConfirmation, parseReadConfirmation } from "../../read-confirmation.js";
-import { pruneOwnedManagedSessionRestoreSnapshots } from "../../managed-session-restore.js";
-import { isManagedSessionRestoreKey } from "../../managed-session-storage.js";
-import { createFreshSessionName, extractUpstreamCommandTokens, redactInvocationArgs, resolveManagedSessionState } from "../../runtime.js";
-import { getUpstreamEffectiveBatchSteps } from "../batch-stdin.js";
-import { closeManagedSession, inspectManagedSessionDaemon } from "./managed-session-daemon-policy.js";
-import { applyOpenResultTabCorrection, applyBrowserRunStatePatch, buildAboutBlankRecoveryHint, buildAboutBlankWarning, buildElectronPostCommandHealthDiagnostic, buildElectronRefFreshnessDiagnostic, buildElectronSessionMismatch, buildManagedSessionOutcome, collectOpenResultTabCorrection, collectSessionTabSelection, collectSessionTabTarget, commandChoosesSessionTabTarget, extractNavigationSummaryFromData, extractStringResultField, findElectronLaunchRecordForSession, formatElectronPostCommandHealthText, formatElectronSessionMismatchText, getSessionContextKey, getStaleRefArgs, mergeNavigationSummaryIntoData, runSessionCommandData, shouldCaptureNavigationSummary, shouldCorrectSessionTabAfterCommand, shouldInspectElectronPostCommandHealth, updateTraceOwnerState, } from "./session-state.js";
-import { collectClickDispatchDiagnostic } from "./click-dispatch.js";
-import { buildScrollNoopDiagnostic, collectComboboxFocusDiagnostic, collectElectronBroadGetTextScopeDiagnostics, collectElectronHandoff, collectFillVerificationDiagnostic, collectNavigationSummary, collectOverlayBlockerDiagnostic, collectQaAttachedTarget, collectSnapshotOverlayBlockerDiagnostic, collectRecordingDependencyWarning, collectScrollPositionSnapshot, collectSelectorTextVisibilityDiagnostics, collectTimeoutPartialProgress, sleepMs, formatQaAttachedTargetText, getArtifactCleanupGuidance, getEvalResultWarning, getEvalStdinHint, getSourceLookupElectronContext, } from "./diagnostics.js";
-import { repairScreenshotData } from "./prepare.js";
-import { mergeRecordingRecoveryPresentation, recoverRecordingStop } from "./recording-recovery.js";
-import { getPersistentSessionArtifactStore } from "./session-state.js";
-import { nativePolicyDefinitelyUnestablished } from "./session-state.js";
-import { buildFinalAgentBrowserToolResult, buildRedactedPresentationContent, buildWrapperRecoveryHint, prepareFinalResultRecoveryState, redactExactSensitiveValue, } from "./final-result.js";
-async function repairScreenshotArtifact(options) {
-    const { cwd, envelope, request } = options;
-    if (!request || !envelope || !isRecord(envelope.data))
-        return { envelope, request };
-    const repaired = await repairScreenshotData({ cwd, data: envelope.data, request });
-    return { envelope: { ...envelope, data: repaired.data }, request: repaired.request };
-}
-async function repairBatchScreenshotArtifacts(options) {
-    const { cwd, envelope, requests } = options;
-    if (!envelope || !Array.isArray(envelope.data) || !requests?.some((request) => request !== undefined))
-        return { envelope, requests };
-    const repairedRequests = [];
-    const repairedData = await Promise.all(envelope.data.map(async (item, index) => {
-        const request = requests[index];
-        if (!request || !isRecord(item) || !isRecord(item.result))
-            return item;
-        const repaired = await repairScreenshotData({ cwd, data: item.result, request });
-        repairedRequests[index] = repaired.request;
-        return { ...item, result: repaired.data };
-    }));
-    return { envelope: { ...envelope, data: repairedData }, requests: repairedRequests };
-}
-function getEnvelopeErrorString(envelope) {
-    if (!envelope?.error)
-        return undefined;
-    if (typeof envelope.error === "string")
-        return envelope.error;
-    if (isRecord(envelope.error) && typeof envelope.error.message === "string")
-        return envelope.error.message;
-    return String(envelope.error);
-}
-function isStreamEnableAlreadyEnabledNoop(options) {
-    if (!options.processSucceeded || options.command !== "stream" || options.subcommand !== "enable" || options.envelope?.success !== false)
-        return false;
-    const message = (getEnvelopeErrorString(options.envelope) ?? "").trim().replace(/[.!]+$/, "").toLowerCase();
-    return message === "streaming is already enabled for this session" || message === "streaming is already enabled" || message === "stream already enabled";
-}
-function isPendingWebMcpMutation(command, subcommand, data) {
-    return command === "webmcp"
-        && ["invoke", "result"].includes(subcommand ?? "")
-        && isRecord(data)
-        && data.status === "pending";
-}
-function isWebMcpSettlementCommand(command, subcommand) {
-    return command === "webmcp" && ["result", "cancel"].includes(subcommand ?? "");
-}
-function batchHasPendingWebMcpMutation(data) {
-    if (!Array.isArray(data))
-        return false;
-    return data.some((row) => {
-        if (!isRecord(row) || row.success === false || !Array.isArray(row.command) || !row.command.every((token) => typeof token === "string"))
-            return false;
-        const [command, subcommand] = extractUpstreamCommandTokens(row.command);
-        return isPendingWebMcpMutation(command, subcommand, row.result);
-    });
-}
-function batchHasFailedWebMcpSettlement(data) {
-    if (!Array.isArray(data))
-        return false;
-    return data.some((row) => {
-        if (!isRecord(row) || row.success !== false || !Array.isArray(row.command) || !row.command.every((token) => typeof token === "string"))
-            return false;
-        const [command, subcommand] = extractUpstreamCommandTokens(row.command);
-        return isWebMcpSettlementCommand(command, subcommand);
-    });
-}
-function batchStartedManagedBrowser(data) {
-    if (!Array.isArray(data))
-        return false;
-    return data.some((entry) => {
-        if (!isRecord(entry) || entry.success !== true || !Array.isArray(entry.command))
-            return false;
-        const command = typeof entry.command[0] === "string" ? entry.command[0] : undefined;
-        return command === "connect" || command === "goto" || command === "navigate" || isOpenNavigationCommand(command);
-    });
-}
-function withoutNamespaceEntries(entries, namespace) {
-    return new Map([...entries].filter(([key]) => !isAgentBrowserSessionIdentityKeyInNamespace(key, namespace)));
-}
-function setNetworkRouteState(options) {
-    if (!options.sessionName)
-        return options.routesBySession;
-    const previousRoutes = options.routesBySession.get(options.sessionName);
-    if (options.routes === previousRoutes)
-        return options.routesBySession;
-    const next = new Map(options.routesBySession);
-    if (options.routes && options.routes.length > 0)
-        next.set(options.sessionName, options.routes);
-    else
-        next.delete(options.sessionName);
-    return next;
-}
-function applyNetworkRouteState(options) {
-    const routes = options.sessionName ? applyNetworkRouteRecords(options.routesBySession.get(options.sessionName), options.commandTokens, options.succeeded) : undefined;
-    return setNetworkRouteState({ routes, routesBySession: options.routesBySession, sessionName: options.sessionName });
-}
-function applyBatchNetworkRouteState(options) {
-    if (!options.succeeded || !options.sessionName || !Array.isArray(options.data))
-        return options.routesBySession;
-    let routes = options.routesBySession.get(options.sessionName);
-    for (const item of options.data) {
-        if (!isRecord(item) || !Array.isArray(item.command) || !item.command.every((token) => typeof token === "string"))
-            continue;
-        const commandTokens = extractUpstreamCommandTokens(item.command);
-        const stepSucceeded = item.success !== false && !detectConfirmationRequired(item.result);
-        if (stepSucceeded && isCloseCommand(commandTokens[0]))
-            routes = undefined;
-        else
-            routes = applyNetworkRouteRecords(routes, commandTokens, stepSucceeded);
-    }
-    return setNetworkRouteState({ routes, routesBySession: options.routesBySession, sessionName: options.sessionName });
-}
+import { captureBrowserOutputOwnership } from "./process-output-ownership.js";
+import { observeNativeEffects } from "./process-output-native-phase.js";
+import { observePageEffects } from "./process-output-page-phase.js";
+import { commitLifecycleEffects } from "./process-output-lifecycle-phase.js";
+import { publishOutputEffects } from "./process-output-publication-phase.js";
+import { buildOutputResult } from "./process-output-publication.js";
 export async function processBrowserOutput(input) {
-    const { ctx, cwd, electronPostCommandStatusSettleMs, implicitSessionCloseTimeoutMs, sessionPageStateUpdate, signal, state } = input;
-    const operationCwd = input.operationCwd ?? cwd;
-    const { prepared, processResult } = input;
-    const { electronChildProcesses, electronLaunchRecords, sessionPageState, traceOwners } = state;
-    let artifactManifest = state.artifactManifest;
-    let freshSessionOrdinal = state.freshSessionOrdinal;
-    let managedSessionActive = state.managedSessionActive;
-    let managedSessionCompatibilityWorkaround = state.managedSessionCompatibilityWorkaround;
-    let managedSessionHeadedAutosaveDisabled = state.managedSessionHeadedAutosaveDisabled === true;
-    let managedSessionHeadedAutosaveInterval = state.managedSessionHeadedAutosaveInterval;
-    let managedSessionCwd = state.managedSessionCwd;
-    let managedSessionName = state.managedSessionName;
-    let managedSessionNamespace = state.managedSessionNamespace;
-    let networkRoutesBySession = state.networkRoutesBySession;
+    const ownership = captureBrowserOutputOwnership(input);
     try {
-        const persistentArtifactStore = getPersistentSessionArtifactStore(ctx);
-        // Native upgrade prints text even with --json; explicit false selects opaque native text.
-        const plainTextUpgrade = !prepared.executionPlan.plainTextInspection && prepared.executionPlan.commandInfo.command === "upgrade" && !needsManagedSession(parseArgvDescriptor(prepared.runtimeToolArgs));
-        const textOutput = getBooleanFlagValue(prepared.processArgs, "--json") === false;
-        const parsed = await parseAgentBrowserEnvelope({ stdout: processResult.stdout, stdoutPath: processResult.stdoutSpillPath, plainText: plainTextUpgrade, textOutput });
-        observeNativeWebMcp(parsed.envelope?.data);
-        let parseError = parsed.parseError;
-        const recordingStopRecovery = await recoverRecordingStop({
-            modelVisible: input.modelVisible,
-            artifactManifest, artifactRunStartedAtMs: input.artifactRunStartedAtMs, commandTokens: prepared.commandTokens, cwd,
-            envelope: parsed.envelope, namespace: prepared.executionPlan.namespace, parseError, processResult,
-            reservation: prepared.executionPlan.sessionName ? state.activeRecordingReservations?.get(getAgentBrowserSessionIdentityKey(prepared.executionPlan.sessionName, prepared.executionPlan.namespace)) : undefined,
-            sessionName: prepared.executionPlan.sessionName, signal, stdin: prepared.runtimeToolStdin,
-        });
-        let presentationEnvelope = recordingStopRecovery?.envelope ?? parsed.envelope;
-        let navigationSummary = undefined;
-        let failedTransitionReverification = false;
-        const repairedScreenshot = await repairScreenshotArtifact({ cwd, envelope: presentationEnvelope, request: prepared.preparedArgs.screenshotPathRequest });
-        presentationEnvelope = repairedScreenshot.envelope;
-        const repairedBatchScreenshots = await repairBatchScreenshotArtifacts({ cwd, envelope: presentationEnvelope, requests: prepared.preparedArgs.batchScreenshotPathRequests });
-        presentationEnvelope = repairedBatchScreenshots.envelope;
-        const screenshotArtifactRequest = repairedScreenshot.request;
-        const batchScreenshotArtifactRequests = repairedBatchScreenshots.requests;
-        const batchCommandSteps = prepared.executionPlan.commandInfo.command === "batch"
-            ? getUpstreamEffectiveBatchSteps(prepared.commandTokens, prepared.runtimeToolStdin)
-            : [];
-        const dispatchedCommands = prepared.executionPlan.commandInfo.command !== "batch"
-            ? [prepared.commandTokens]
-            : Array.isArray(presentationEnvelope?.data)
-                ? presentationEnvelope.data.flatMap((row, index) => isRecord(row) ? [Array.isArray(row.command) && row.command.every((token) => typeof token === "string") ? row.command : batchCommandSteps[index] ?? []] : [])
-                : batchCommandSteps;
-        const confirmationSessionName = prepared.executionPlan.sessionName ?? "default";
-        let readConfirmation = state.sessionPageState.getReadConfirmation(getAgentBrowserSessionIdentityKey(confirmationSessionName, prepared.executionPlan.namespace));
-        let readConfirmationEvent;
-        const confirmedEffects = [];
-        const confirmationRows = prepared.executionPlan.commandInfo.command === "batch" && Array.isArray(presentationEnvelope?.data)
-            ? presentationEnvelope.data.flatMap((row, index) => isRecord(row) ? [{ tokens: Array.isArray(row.command) && row.command.every(token => typeof token === "string") ? row.command : batchCommandSteps[index] ?? [], data: row.result, index, response: row, succeeded: row.success === true }] : [])
-            : [{ tokens: prepared.commandTokens, data: presentationEnvelope?.data, index: 0, response: presentationEnvelope, succeeded: presentationEnvelope?.success === true }];
-        for (const row of confirmationRows) {
-            if (readConfirmation?.state === "pending" && readConfirmation.source === "native-guarded-action" && typeof readConfirmation.command === "string"
-                && row.tokens.length === 2 && row.tokens[0] === "confirm" && row.tokens[1] === readConfirmation.id
-                && isRecord(row.data) && row.data.confirmed === true && row.data.action === readConfirmation.action
-                && isRecord(row.data.result) && !detectConfirmationRequired(row.data)) {
-                confirmedEffects.push({ command: readConfirmation.command, data: row.data.result.data, index: row.index, succeeded: row.succeeded && row.data.result.success === true });
-            }
-            const transition = nextReadConfirmation({ commandTokens: row.tokens, current: readConfirmation, data: row.data, namespace: prepared.executionPlan.namespace, sessionName: confirmationSessionName, succeeded: row.succeeded });
-            if (transition) {
-                readConfirmationEvent = transition;
-                readConfirmation = transition;
-            }
-            if (row.tokens.length === 2 && row.tokens[0] === "confirm" && isRecord(row.data) && row.data.confirmed === true && isRecord(row.data.result) && row.data.result.success === false && row.response) {
-                row.response.success = false;
-                row.response.error = row.data.result.error;
-                if (presentationEnvelope)
-                    presentationEnvelope.success = false;
-            }
-        }
-        const confirmedData = prepared.commandTokens[0] === "confirm" ? confirmedEffects[0]?.data : undefined;
-        const confirmedCommand = prepared.commandTokens[0] === "confirm" ? confirmedEffects[0]?.command : undefined;
-        const directClose = isCloseCommand(prepared.executionPlan.commandInfo.command)
-            || isSuccessfulNativeConfirmedClose(prepared.commandTokens, presentationEnvelope?.data);
-        if (readConfirmationEvent?.state === "pending")
-            state.observedBrowserEffects = { ...state.observedBrowserEffects, readConfirmation: readConfirmationEvent };
-        const destinationTransition = dispatchedCommands.some((step) => {
-            const [command, subcommand] = extractUpstreamCommandTokens(step);
-            return isWindowOrDiffPageTransitionCommand(command, subcommand);
-        });
-        const nestedBatchClose = prepared.executionPlan.commandInfo.command === "batch"
-            ? getSuccessfulBatchCloseLifecycle(presentationEnvelope?.data, batchCommandSteps)
-            : undefined;
-        const nestedBatchClosed = nestedBatchClose?.endsClosed === true;
-        const nestedBatchRemainsActive = nestedBatchClose?.endsClosed === false;
-        const nestedBatchClosesAll = prepared.executionPlan.commandInfo.command === "batch"
-            && batchHasSuccessfulCloseAll(presentationEnvelope?.data, batchCommandSteps);
-        const directCloseAllRequested = isCloseAllCommand(extractUpstreamCommandTokens(prepared.commandTokens));
-        const directCloseData = confirmedData ?? presentationEnvelope?.data;
-        const rawCloseStatePath = directClose && isRecord(directCloseData) && typeof directCloseData.statePath === "string"
-            ? directCloseData.statePath
-            : nestedBatchClose?.statePath;
-        if (presentationEnvelope && prepared.exactSensitiveValues.length > 0)
-            presentationEnvelope = redactExactSensitiveValue(presentationEnvelope, prepared.exactSensitiveValues);
-        const parseFailureOutput = parseError && processResult.stdoutSpillPath
-            ? { fullOutputUnavailable: "Malformed upstream output was discarded because it may contain sensitive browser data." }
-            : {};
-        const browserIndependentRead = isBrowserIndependentConfirmation(prepared.readConfirmation) || isBrowserIndependentRead(prepared.commandTokens, prepared.runtimeToolStdin);
-        const nativeCommandMayHaveExecuted = !nativePolicyDefinitelyUnestablished(processResult, parsed.envelope, prepared.commandTokens);
-        if (state.confirmationPolicyMayBeEstablished !== true)
-            state.confirmationPolicyMayBeEstablished = nativeCommandMayHaveExecuted;
-        const processSucceeded = !processResult.timedOut && !processResult.aborted && !processResult.spawnError && processResult.exitCode === 0;
-        const plainTextInspection = prepared.executionPlan.plainTextInspection && processSucceeded;
-        const parseSucceeded = plainTextInspection || parseError === undefined;
-        if (isStreamEnableAlreadyEnabledNoop({ command: prepared.executionPlan.commandInfo.command, envelope: presentationEnvelope, processSucceeded, subcommand: prepared.executionPlan.commandInfo.subcommand })) {
-            presentationEnvelope = { success: true, data: { alreadyEnabled: true, enabled: true, message: getEnvelopeErrorString(presentationEnvelope) ?? "Stream already enabled" } };
-        }
-        const envelopeSuccess = plainTextInspection ? true : presentationEnvelope?.success !== false && !detectConfirmationRequired(presentationEnvelope?.data);
-        let succeeded = (processSucceeded && parseSucceeded && envelopeSuccess) || recordingStopRecovery?.recovery.healed === true;
-        const inspectionText = plainTextInspection ? processResult.stdout.trim() : undefined;
-        const unobservedMutation = processResult.agentBrowserStarted && !plainTextInspection
-            && (processResult.aborted || processResult.timedOut || !parseSucceeded || presentationEnvelope === undefined)
-            && (prepared.executionPlan.commandInfo.command === "batch" ? batchCommandSteps : [prepared.commandTokens]).some(step => {
-                const action = step[0] === "find" ? step[step[1] === "nth" ? 4 : 3] ?? "click" : step[0];
-                return isPageMutationCommand(action, step[1]);
-            });
-        const sessionStateKey = getSessionContextKey(prepared.executionPlan.sessionName, prepared.executionPlan.namespace);
-        const closeAllApplied = nestedBatchClosesAll || (directCloseAllRequested && succeeded);
-        if (sessionStateKey && processResult.agentBrowserStarted && sessionPageState.get(sessionStateKey).tabReopenPending === true) {
-            if (dispatchedCommands.some(commandChoosesSessionTabTarget))
-                sessionPageState.setTabReopenPending({ pending: false, sessionName: sessionStateKey, update: sessionPageStateUpdate });
-        }
-        if (closeAllApplied) {
-            networkRoutesBySession = withoutNamespaceEntries(networkRoutesBySession, prepared.executionPlan.namespace);
-            deleteIdentityKeysInNamespace(state.attachedSessionKeys, prepared.executionPlan.namespace);
-            deleteIdentityKeysInNamespace(traceOwners, prepared.executionPlan.namespace);
-            sessionPageState.clearNamespace(prepared.executionPlan.namespace);
-            const retainedSessionKey = nestedBatchRemainsActive ? sessionStateKey : undefined;
-            for (const [key, owner] of state.ownedManagedSessions) {
-                if (!isAgentBrowserSessionIdentityKeyInNamespace(key, prepared.executionPlan.namespace) || key === retainedSessionKey)
-                    continue;
-                state.closedManagedSessionNames.add(key);
-                state.managedSessionRestoreState.clear(owner.sessionName, owner.namespace);
-            }
-        }
-        else if (nestedBatchClose && sessionStateKey) {
-            networkRoutesBySession = new Map(networkRoutesBySession);
-            networkRoutesBySession.delete(sessionStateKey);
-            sessionPageState.clearSession(sessionStateKey);
-        }
-        if (sessionStateKey && nestedBatchRemainsActive) {
-            const confirmActions = getAgentBrowserProcessEnvironment().AGENT_BROWSER_CONFIRM_ACTIONS;
-            if (confirmActions !== undefined)
-                sessionPageState.setConfirmActions(sessionStateKey, confirmActions);
-        }
-        if (prepared.executionPlan.commandInfo.command === "batch" && Array.isArray(presentationEnvelope?.data)) {
-            for (const [index, row] of presentationEnvelope.data.entries()) {
-                if (!isRecord(row))
-                    continue;
-                const rowCommand = Array.isArray(row.command) && row.command.every((token) => typeof token === "string")
-                    ? row.command
-                    : batchCommandSteps[index];
-                if (!rowCommand)
-                    continue;
-                const [command, subcommand] = extractUpstreamCommandTokens(rowCommand);
-                updateTraceOwnerState({ command, sessionName: sessionStateKey, subcommand, succeeded: row.success === true && !detectConfirmationRequired(row.result), traceOwners });
-            }
-        }
-        else {
-            updateTraceOwnerState({ command: directClose ? "close" : prepared.executionPlan.commandInfo.command, sessionName: sessionStateKey, subcommand: prepared.executionPlan.commandInfo.subcommand, succeeded, traceOwners });
-        }
-        let clickDispatchDiagnostic;
-        if (succeeded && prepared.clickDispatchProbe) {
-            clickDispatchDiagnostic = await collectClickDispatchDiagnostic({ cwd, namespace: prepared.executionPlan.namespace, probe: prepared.clickDispatchProbe, sessionName: prepared.executionPlan.sessionName, signal });
-            if (clickDispatchDiagnostic) {
-                succeeded = false;
-                presentationEnvelope = { ...(presentationEnvelope ?? {}), error: clickDispatchDiagnostic.summary, success: false };
-            }
-        }
-        const tabTransition = confirmedEffects.some(effect => effect.command === "tab") || dispatchedCommands.some((step) => {
-            const [command, subcommand] = extractUpstreamCommandTokens(step);
-            return command === "tab" && subcommand !== undefined && subcommand !== "list";
-        });
-        // Non-page rows (including a failed prefix) cannot retire a cold target for a navigation that never ran.
-        const resultingPageState = !nativeCommandMayHaveExecuted || detectConfirmationRequired(presentationEnvelope?.data) || sessionPageState.get(sessionStateKey).tabReopenPending === true
-            ? { currentPageUrl: prepared.priorSessionTabTarget?.url, pageTargetMayHaveChanged: false, pageUrlUnknown: prepared.priorSessionTabTargetUnknown === true }
-            : getResultingPageTargetState({
-                args: prepared.executionPlan.effectiveArgs,
-                executedBatchSteps: dispatchedCommands,
-                batchResults: presentationEnvelope?.data,
-                currentPageUrl: prepared.priorSessionTabTarget?.url,
-                pageUrlUnknown: prepared.priorSessionTabTargetUnknown === true,
-            });
-        if ((succeeded || processSucceeded && confirmedEffects.some(effect => effect.succeeded)) && readConfirmation?.state !== "pending" && !nestedBatchClosed && !directClose &&
-            (confirmedEffects.some(effect => shouldCaptureNavigationSummary(effect.command, effect.data)) || shouldCaptureNavigationSummary(prepared.executionPlan.commandInfo.command, presentationEnvelope?.data, prepared.executionPlan.commandInfo.subcommand) ||
-                (prepared.executionPlan.commandInfo.command === "batch" && dispatchedCommands.some(([command, subcommand]) => isNavigationObservableCommandName(command, subcommand))) ||
-                shouldCaptureSemanticActionNavigationSummary(prepared.compiledSemanticAction, presentationEnvelope?.data) ||
-                commandRequiresLivePageVerification(prepared.executionPlan.effectiveArgs, prepared.runtimeToolStdin) ||
-                destinationTransition || tabTransition)) {
-            navigationSummary = await collectNavigationSummary({ cwd, namespace: prepared.executionPlan.namespace, priorTarget: prepared.priorSessionTabTarget, reusePriorTitle: !tabTransition, sessionName: prepared.executionPlan.sessionName, signal });
-        }
-        // Failed transitions may already have changed the page; keep only a live observed URL.
-        if (succeeded === false && navigationSummary === undefined && readConfirmation?.state !== "pending" &&
-            processResult.agentBrowserStarted && nativeCommandMayHaveExecuted &&
-            !processResult.aborted &&
-            !processResult.timedOut &&
-            !nestedBatchClosed && !directClose &&
-            (confirmedEffects.some(effect => isUnverifiedPageTransitionCommand(effect.command)) || dispatchedCommands.some((step) => {
-                const [command, subcommand] = extractUpstreamCommandTokens(step);
-                return (prepared.executionPlan.commandInfo.command === "batch" && isOpenNavigationCommand(command))
-                    || isUnverifiedPageTransitionCommand(command, subcommand);
-            }))) {
-            navigationSummary = await collectNavigationSummary({ cwd, namespace: prepared.executionPlan.namespace, priorTarget: prepared.priorSessionTabTarget, sessionName: prepared.executionPlan.sessionName, signal });
-            // Re-verifying a failed transition's URL does not make its prior refs valid.
-            failedTransitionReverification = navigationSummary !== undefined;
-        }
-        if (!textOutput && navigationSummary && presentationEnvelope && prepared.executionPlan.commandInfo.command !== "eval" && !Array.isArray(presentationEnvelope.data))
-            presentationEnvelope = { ...presentationEnvelope, data: mergeNavigationSummaryIntoData(presentationEnvelope.data, navigationSummary) };
-        let overlayBlockerDiagnostic;
-        let openResultTabCorrection;
-        if (succeeded && prepared.executionPlan.sessionName && prepared.executionPlan.startupScopedFlags.some((flag) => OPEN_RESULT_TAB_CORRECTION_FLAGS.has(flag)) && isOpenNavigationCommand(prepared.executionPlan.commandInfo.command) && !commandExplicitlyTargetsAboutBlank(prepared.commandTokens)) {
-            const targetTitle = extractStringResultField(presentationEnvelope?.data, "title");
-            const targetUrl = extractStringResultField(presentationEnvelope?.data, "url");
-            const plannedTabCorrection = await collectOpenResultTabCorrection({ cwd, namespace: prepared.executionPlan.namespace, sessionName: prepared.executionPlan.sessionName, signal, targetTitle, targetUrl });
-            if (plannedTabCorrection)
-                openResultTabCorrection = await applyOpenResultTabCorrection({ correction: plannedTabCorrection, cwd, namespace: prepared.executionPlan.namespace, sessionName: prepared.executionPlan.sessionName, signal });
-        }
-        const verifiesCurrentUrl = prepared.executionPlan.commandInfo.command === "get" && prepared.executionPlan.commandInfo.subcommand === "url"
-            || readConfirmationEvent?.state === "cleared" && prepared.readConfirmation?.source === "native-guarded-action" && extractSessionTabTargetFromCommandData(prepared.commandTokens, presentationEnvelope?.data) !== undefined;
-        const trustsReportedPageTarget = !resultingPageState.pageUrlUnknown || verifiesCurrentUrl;
-        const pendingWebMcpMutation = isPendingWebMcpMutation(prepared.executionPlan.commandInfo.command, prepared.executionPlan.commandInfo.subcommand, presentationEnvelope?.data) || (prepared.executionPlan.commandInfo.command === "batch" && batchHasPendingWebMcpMutation(presentationEnvelope?.data));
-        const failedWebMcpSettlement = prepared.priorSessionTabTargetUnknown === true && ((!succeeded && isWebMcpSettlementCommand(prepared.executionPlan.commandInfo.command, prepared.executionPlan.commandInfo.subcommand))
-            || (prepared.executionPlan.commandInfo.command === "batch" && batchHasFailedWebMcpSettlement(presentationEnvelope?.data)));
-        const unsettledWebMcpMutation = pendingWebMcpMutation || failedWebMcpSettlement;
-        const helperConfirmation = parseReadConfirmation(state.observedBrowserEffects?.readConfirmation);
-        // Main pending installs this object above; only a helper can replace it during post-processing.
-        let confirmationFromHelper = state.observedBrowserEffects?.readConfirmation !== readConfirmationEvent;
-        if (confirmationFromHelper && helperConfirmation?.state === "pending") {
-            readConfirmationEvent = helperConfirmation;
-            readConfirmation = helperConfirmation;
-            succeeded = false;
-        }
-        const pageTargetData = textOutput ? undefined : presentationEnvelope?.data;
-        let observedSessionTabTarget = unsettledWebMcpMutation || (unobservedMutation && !failedTransitionReverification)
-            ? undefined
-            : normalizeSessionTabTarget(navigationSummary)
-                ?? (trustsReportedPageTarget ? extractSessionTabTargetFromBatchResults(pageTargetData) : undefined)
-                ?? (succeeded && trustsReportedPageTarget ? extractSessionTabTargetFromCommandData(prepared.commandTokens, pageTargetData) : undefined);
-        if (observedSessionTabTarget && readConfirmation?.state !== "pending" && !browserIndependentRead && !nestedBatchClosed && !directClose) {
-            const reportedTarget = prepared.executionPlan.commandInfo.command === "batch"
-                ? extractSessionTabTargetFromBatchResults(pageTargetData)
-                : prepared.commandTokens[0] === "tab" && prepared.commandTokens[1] === "close" ? undefined
-                    : extractSessionTabTargetFromCommandData(prepared.commandTokens, pageTargetData);
-            if (reportedTarget?.targetId)
-                observedSessionTabTarget.targetId = reportedTarget.targetId;
-            else
-                observedSessionTabTarget = await collectSessionTabTarget({ cwd, namespace: prepared.executionPlan.namespace, sessionName: prepared.executionPlan.sessionName, signal, target: observedSessionTabTarget });
-        }
-        const safeObservedSessionTabTarget = observedSessionTabTarget;
-        let currentSessionTabTarget = safeObservedSessionTabTarget;
-        if (!currentSessionTabTarget && nestedBatchClose === undefined && !unobservedMutation) {
-            // Window/diff responses do not report the final URL; URL2 is intent, not redirect evidence.
-            currentSessionTabTarget = resultingPageState.pageTargetMayHaveChanged
-                ? succeeded && !destinationTransition ? normalizeSessionTabTarget({ url: resultingPageState.currentPageUrl }) : undefined
-                : deriveSessionTabTarget({ command: directClose ? "close" : prepared.executionPlan.commandInfo.command, data: pageTargetData, navigationSummary, previousTarget: prepared.priorSessionTabTarget, subcommand: prepared.executionPlan.commandInfo.subcommand });
-        }
-        let aboutBlankSessionMismatch;
-        let electronPostCommandHealth;
-        let electronRefFreshnessDiagnostic;
-        let electronSessionMismatch;
-        let electronStatusAfterCommand;
-        const explicitlyTargetsAboutBlank = dispatchedCommands.some((step) => commandExplicitlyTargetsAboutBlank(extractUpstreamCommandTokens(step)));
-        const shouldTreatAboutBlankAsMismatch = succeeded && !tabTransition && !destinationTransition && !explicitlyTargetsAboutBlank && nestedBatchClose === undefined && prepared.priorSessionTabTarget !== undefined && !isAboutBlankSessionTabTarget(prepared.priorSessionTabTarget) && isAboutBlankSessionTabTarget(observedSessionTabTarget ?? currentSessionTabTarget);
-        let sessionTabCorrection = prepared.sessionTabCorrection;
-        if (shouldTreatAboutBlankAsMismatch && prepared.priorSessionTabTarget) {
-            const aboutBlankObservedTarget = observedSessionTabTarget ?? currentSessionTabTarget;
-            const aboutBlankRecovery = await collectSessionTabSelection({ cwd, namespace: prepared.executionPlan.namespace, sessionName: prepared.executionPlan.sessionName, signal, target: prepared.priorSessionTabTarget });
-            const appliedAboutBlankRecovery = aboutBlankRecovery ? await applyOpenResultTabCorrection({ correction: aboutBlankRecovery, cwd, namespace: prepared.executionPlan.namespace, sessionName: prepared.executionPlan.sessionName, signal }) : undefined;
-            if (appliedAboutBlankRecovery) {
-                sessionTabCorrection = appliedAboutBlankRecovery;
-                currentSessionTabTarget = prepared.priorSessionTabTarget;
-            }
-            else
-                currentSessionTabTarget = aboutBlankObservedTarget ?? normalizeSessionTabTarget({ url: "about:blank" });
-            aboutBlankSessionMismatch = { activeUrl: "about:blank", recoveryApplied: appliedAboutBlankRecovery !== undefined, recoveryHint: buildAboutBlankRecoveryHint(), targetTitle: prepared.priorSessionTabTarget.title, targetUrl: prepared.priorSessionTabTarget.url };
-            const electronRecord = findElectronLaunchRecordForSession(prepared.executionPlan.sessionName, electronLaunchRecords, prepared.executionPlan.namespace);
-            if (electronRecord && prepared.executionPlan.sessionName) {
-                electronStatusAfterCommand = await inspectElectronLaunchStatus(electronRecord);
-                electronSessionMismatch = buildElectronSessionMismatch({ managedSession: { sessionName: prepared.executionPlan.sessionName, title: aboutBlankObservedTarget?.title, url: aboutBlankObservedTarget?.url ?? "about:blank" }, record: electronRecord, statusTargets: electronStatusAfterCommand.targets });
-            }
-        }
-        if (succeeded && prepared.priorSessionTabTarget && !sessionTabCorrection && !aboutBlankSessionMismatch && !commandExplicitlyTargetsAboutBlank(prepared.commandTokens) && observedSessionTabTarget && shouldCorrectSessionTabAfterCommand({ command: prepared.executionPlan.commandInfo.command, pinningRequired: prepared.sessionTabPinningReason !== undefined, sessionName: prepared.executionPlan.sessionName })) {
-            const postCommandTabCorrection = await collectSessionTabSelection({ cwd, namespace: prepared.executionPlan.namespace, sessionName: prepared.executionPlan.sessionName, signal, target: observedSessionTabTarget });
-            if (postCommandTabCorrection) {
-                const appliedPostCommandCorrection = await applyOpenResultTabCorrection({ correction: postCommandTabCorrection, cwd, namespace: prepared.executionPlan.namespace, sessionName: prepared.executionPlan.sessionName, signal });
-                if (appliedPostCommandCorrection && !sessionTabCorrection)
-                    sessionTabCorrection = appliedPostCommandCorrection;
-            }
-        }
-        const electronRecordForCommand = findElectronLaunchRecordForSession(prepared.executionPlan.sessionName, electronLaunchRecords, prepared.executionPlan.namespace);
-        if (succeeded && electronRecordForCommand && shouldInspectElectronPostCommandHealth(prepared.executionPlan.commandInfo.command)) {
-            electronStatusAfterCommand ??= await inspectElectronLaunchStatus(electronRecordForCommand);
-            electronPostCommandHealth = buildElectronPostCommandHealthDiagnostic({ command: prepared.executionPlan.commandInfo.command, record: electronRecordForCommand, status: electronStatusAfterCommand, target: observedSessionTabTarget ?? currentSessionTabTarget });
-            if (electronPostCommandHealth && electronPostCommandHealth.reason !== "process-dead") {
-                await sleepMs(electronPostCommandStatusSettleMs);
-                electronStatusAfterCommand = await inspectElectronLaunchStatus(electronRecordForCommand);
-                electronPostCommandHealth = buildElectronPostCommandHealthDiagnostic({ command: prepared.executionPlan.commandInfo.command, record: electronRecordForCommand, status: electronStatusAfterCommand, target: observedSessionTabTarget ?? currentSessionTabTarget });
-            }
-            if (electronPostCommandHealth)
-                succeeded = false;
-        }
-        let fillVerificationDiagnostic;
-        let selectorTextVisibilityDiagnostics = [];
-        let electronBroadGetTextScopeDiagnostics = [];
-        const timeoutPartialProgress = processResult.timedOut && !recordingStopRecovery && !prepared.readConfirmation ? await collectTimeoutPartialProgress({ commandTokens: prepared.commandTokens, compiledJob: prepared.compiledJob, cwd, operationCwd: input.operationCwd, namespace: prepared.executionPlan.namespace, sessionName: prepared.executionPlan.sessionName, stdin: prepared.runtimeToolStdin }) : undefined;
-        if (!currentSessionTabTarget && timeoutPartialProgress?.liveUrlRecovered === true) {
-            currentSessionTabTarget = normalizeSessionTabTarget(timeoutPartialProgress.currentPage);
-        }
-        if (succeeded) {
-            const fillRefSnapshot = prepared.resolvedSemanticActionRefSnapshot ?? prepared.priorRefSnapshotState;
-            fillVerificationDiagnostic = await collectFillVerificationDiagnostic({ commandTokens: prepared.commandTokens, cwd, forceValueVerification: electronRecordForCommand !== undefined, namespace: prepared.executionPlan.namespace, refSnapshot: fillRefSnapshot, sessionName: prepared.executionPlan.sessionName, signal });
-        }
-        if (succeeded && electronRecordForCommand) {
-            electronRefFreshnessDiagnostic = buildElectronRefFreshnessDiagnostic({ command: prepared.executionPlan.commandInfo.command, commandTokens: prepared.commandTokens, record: electronRecordForCommand, sessionName: prepared.executionPlan.sessionName, stdin: prepared.runtimeToolStdin });
-        }
-        if (succeeded && prepared.executionPlan.commandInfo.command === "snapshot") {
-            overlayBlockerDiagnostic = collectSnapshotOverlayBlockerDiagnostic(presentationEnvelope?.data);
-        }
-        if (succeeded && !overlayBlockerDiagnostic && !sessionTabCorrection && !aboutBlankSessionMismatch && !electronRecordForCommand && !clickDispatchDiagnostic)
-            overlayBlockerDiagnostic = await collectOverlayBlockerDiagnostic({ command: prepared.executionPlan.commandInfo.command, cwd, data: presentationEnvelope?.data, namespace: prepared.executionPlan.namespace, navigationSummary, priorTarget: prepared.priorSessionTabTarget, sessionName: prepared.executionPlan.sessionName, signal });
-        if (succeeded) {
-            selectorTextVisibilityDiagnostics = await collectSelectorTextVisibilityDiagnostics({ commandInfo: prepared.executionPlan.commandInfo, commandTokens: prepared.commandTokens, cwd, data: presentationEnvelope?.data, namespace: prepared.executionPlan.namespace, sessionName: prepared.executionPlan.sessionName, signal });
-            if (electronRecordForCommand)
-                electronBroadGetTextScopeDiagnostics = collectElectronBroadGetTextScopeDiagnostics({ commandInfo: prepared.executionPlan.commandInfo, commandTokens: prepared.commandTokens, currentTarget: currentSessionTabTarget, data: presentationEnvelope?.data, electronLaunchRecords, namespace: prepared.executionPlan.namespace, priorTarget: prepared.priorSessionTabTarget, sessionName: prepared.executionPlan.sessionName });
-        }
-        const activeNetworkRoutes = sessionStateKey ? networkRoutesBySession.get(sessionStateKey) : undefined;
-        const networkRouteDiagnostics = succeeded && prepared.executionPlan.commandInfo.command === "network" && prepared.executionPlan.commandInfo.subcommand === "requests" && prepared.executionPlan.sessionName
-            ? buildNetworkRouteDiagnostics(presentationEnvelope?.data, activeNetworkRoutes)
-            : undefined;
-        networkRoutesBySession = applyNetworkRouteState({ commandTokens: prepared.commandTokens, routesBySession: networkRoutesBySession, sessionName: sessionStateKey, succeeded });
-        const comboboxFocusDiagnostic = succeeded ? await collectComboboxFocusDiagnostic({ command: prepared.executionPlan.commandInfo.command, commandTokens: prepared.commandTokens, cwd, namespace: prepared.executionPlan.namespace, semanticAction: prepared.compiledSemanticAction, sessionName: prepared.executionPlan.sessionName, signal }) : undefined;
-        const recordingDependencyWarning = await collectRecordingDependencyWarning({ command: prepared.executionPlan.commandInfo.command, commandTokens: prepared.commandTokens, succeeded });
-        const scrollNoopDiagnostic = succeeded && prepared.shouldProbeScrollNoop ? buildScrollNoopDiagnostic(prepared.scrollPositionBefore, await collectScrollPositionSnapshot({ cwd, namespace: prepared.executionPlan.namespace, sessionName: prepared.executionPlan.sessionName, signal })) : undefined;
-        const batchRefSnapshotState = prepared.executionPlan.commandInfo.command === "batch" ? extractLatestRefSnapshotStateFromBatchResults(Array.isArray(presentationEnvelope?.data) ? presentationEnvelope.data.map((row, index) => {
-            const snapshot = confirmedEffects.find(effect => effect.index === index && effect.command === "snapshot");
-            return snapshot && isRecord(row) ? { ...row, command: ["snapshot"], result: snapshot.data, success: snapshot.succeeded } : row;
-        }) : presentationEnvelope?.data) : undefined;
-        let currentRefSnapshot;
-        let currentRefSnapshotInvalidation;
-        if (sessionStateKey && !browserIndependentRead) {
-            const sessionClosed = (directClose && succeeded) || nestedBatchClosed;
-            if (sessionClosed) {
-                state.attachedSessionKeys.delete(sessionStateKey);
-                networkRoutesBySession = new Map(networkRoutesBySession);
-                networkRoutesBySession.delete(sessionStateKey);
-                sessionPageState.clearSession(sessionStateKey);
-                state.closedManagedSessionNames.add(sessionStateKey);
-            }
-            else {
-                // A batch that times out or returns unparseable output yields no result rows, but the daemon
-                // may already have executed a recording swap or page-provided WebMCP tool; fall back to the
-                // planned steps then. This can over-invalidate by one snapshot, but never under-invalidates.
-                const directTransitionInvalidation = getCommandRefSnapshotInvalidation(prepared.commandTokens);
-                const plannedBatchTransitionInvalidation = !Array.isArray(presentationEnvelope?.data)
-                    ? batchCommandSteps.map(getCommandRefSnapshotInvalidation).find((invalidation) => invalidation !== undefined)
-                    : undefined;
-                const pageTransitionInvalidation = unobservedMutation && !failedTransitionReverification
-                    ? buildPageTransitionRefSnapshotInvalidation("A dispatched mutation was interrupted without a final outcome. Verify the current URL and take a fresh snapshot before deciding whether to retry.")
-                    : unsettledWebMcpMutation
-                        ? buildPageTransitionRefSnapshotInvalidation("A detached WebMCP invocation is still pending or failed to settle and can mutate, rerender, or navigate the page, so prior snapshot refs remain invalid after URL verification. Run webmcp result or cancel, then take a fresh snapshot before using page-scoped refs.")
-                        : processResult.agentBrowserStarted && nativeCommandMayHaveExecuted && (directTransitionInvalidation || plannedBatchTransitionInvalidation)
-                            ? directTransitionInvalidation ?? plannedBatchTransitionInvalidation
-                            : failedTransitionReverification
-                                ? buildPageTransitionRefSnapshotInvalidation("A failed page transition may still have changed the page, so the prior snapshot refs were invalidated. Run snapshot -i before using page-scoped refs.")
-                                : batchRefSnapshotState?.invalidation?.reason === "page-transition"
-                                    ? batchRefSnapshotState.invalidation
-                                    : undefined;
-                if (currentSessionTabTarget) {
-                    const tabUpdate = sessionPageState.applyTabTarget({ sessionName: sessionStateKey, target: currentSessionTabTarget, update: sessionPageStateUpdate });
-                    if (!tabUpdate.applied && succeeded)
-                        sessionPageState.markPinning(sessionStateKey, "drift");
-                }
-                else if (processResult.agentBrowserStarted && (unobservedMutation || resultingPageState.pageUrlUnknown || resultingPageState.pageTargetMayHaveChanged) && !(prepared.commandTokens[0] === "session" && prepared.commandTokens[1] === "info")) {
-                    sessionPageState.markTabTargetUnknown({ sessionName: sessionStateKey, update: sessionPageStateUpdate });
-                }
-                let refSnapshot = unsettledWebMcpMutation || unobservedMutation
-                    ? undefined
-                    : prepared.executionPlan.commandInfo.command === "batch"
-                        ? batchRefSnapshotState?.snapshot
-                        : succeeded
-                            ? prepared.executionPlan.commandInfo.command === "snapshot" || confirmedCommand === "snapshot" ? extractRefSnapshotFromData(confirmedData ?? presentationEnvelope?.data) : prepared.resolvedSemanticActionRefSnapshot ?? overlayBlockerDiagnostic?.snapshot
-                            : undefined;
-                const refreshArgs = batchRefSnapshotState?.refreshArgs ?? (succeeded && prepared.commandTokens[0] === "snapshot" && isRecord(presentationEnvelope?.data) && isRecord(presentationEnvelope.data.snapshot) && !refSnapshot
-                    ? prepared.commandTokens.filter((token) => token !== "--delta" && token !== "--full") : undefined);
-                // Native owns delta baselines. Read complete refs without advancing that baseline
-                // rather than maintaining a second revision/tree cache in the wrapper.
-                if (refreshArgs && readConfirmation?.state !== "pending" && !unsettledWebMcpMutation && !unobservedMutation) {
-                    refSnapshot = extractRefSnapshotFromData(await runSessionCommandData({ args: refreshArgs, cwd, namespace: prepared.executionPlan.namespace, sessionName: prepared.executionPlan.sessionName, signal }));
-                    if (!refSnapshot)
-                        sessionPageState.applyRefSnapshotInvalidation({ invalidation: buildPageTransitionRefSnapshotInvalidation("The native snapshot delta did not include complete refs and the full ref read failed. Run snapshot -i before using refs."), sessionName: sessionStateKey, update: sessionPageStateUpdate });
-                }
-                if (refSnapshot) {
-                    const refUpdate = sessionPageState.applyRefSnapshot({ fallbackTarget: currentSessionTabTarget, sessionName: sessionStateKey, snapshot: refSnapshot, update: sessionPageStateUpdate });
-                    currentRefSnapshot = refUpdate.refSnapshot;
-                    currentRefSnapshotInvalidation = refUpdate.refSnapshotInvalidation;
-                }
-                else if (pageTransitionInvalidation) {
-                    const refUpdate = sessionPageState.applyRefSnapshotInvalidation({ invalidation: pageTransitionInvalidation, sessionName: sessionStateKey, update: sessionPageStateUpdate });
-                    currentRefSnapshot = refUpdate.refSnapshot;
-                    currentRefSnapshotInvalidation = refUpdate.refSnapshotInvalidation;
-                }
-                else {
-                    const stateView = sessionPageState.get(sessionStateKey);
-                    currentRefSnapshot = stateView.refSnapshot;
-                    currentRefSnapshotInvalidation = stateView.refSnapshotInvalidation;
-                }
-            }
-        }
-        const priorManagedSessionActive = managedSessionActive;
-        const priorManagedSessionCwd = managedSessionCwd;
-        const priorManagedSessionHeadedAutosaveInterval = managedSessionHeadedAutosaveInterval;
-        const priorManagedSessionName = managedSessionName;
-        const priorManagedSessionNamespace = managedSessionNamespace;
-        const priorManagedSessionKey = getSessionContextKey(priorManagedSessionName, priorManagedSessionNamespace) ?? priorManagedSessionName;
-        const closeAllTargetsPriorManagedSession = closeAllApplied
-            && priorManagedSessionActive
-            && isAgentBrowserSessionIdentityKeyInNamespace(priorManagedSessionKey, prepared.executionPlan.namespace);
-        const closeAllRetainsPriorManagedSession = closeAllTargetsPriorManagedSession
-            && nestedBatchRemainsActive
-            && sessionStateKey === priorManagedSessionKey;
-        const closeAllClosesPriorManagedSession = closeAllTargetsPriorManagedSession && !closeAllRetainsPriorManagedSession;
-        const commandClosesSession = directClose || nestedBatchClosed || closeAllClosesPriorManagedSession;
-        const closeCommandSucceeded = (directClose && succeeded) || nestedBatchClosed || closeAllClosesPriorManagedSession;
-        const closeTargetsPriorManagedNamespace = prepared.executionPlan.namespace === priorManagedSessionNamespace;
-        const managedCloseSessionName = closeAllClosesPriorManagedSession
-            ? priorManagedSessionName
-            : closeCommandSucceeded && prepared.executionPlan.sessionName === priorManagedSessionName && closeTargetsPriorManagedNamespace
-                ? prepared.executionPlan.sessionName
-                : prepared.executionPlan.managedSessionName;
-        const postLaunchBatchFailure = !succeeded && processSucceeded && parseSucceeded && prepared.sessionMode === "fresh" && prepared.executionPlan.commandInfo.command === "batch" && batchStartedManagedBrowser(presentationEnvelope?.data);
-        const postLaunchTimeoutWithPage = !succeeded && processResult.timedOut && prepared.sessionMode === "fresh" && prepared.executionPlan.commandInfo.command === "batch" && timeoutPartialProgress?.liveUrlRecovered === true;
-        const failedFreshSessionMayHaveStarted = !succeeded
-            && (processResult.agentBrowserStarted || (!processResult.aborted && processResult.spawnError === undefined))
-            && prepared.sessionMode === "fresh"
-            && prepared.executionPlan.managedSessionName === prepared.executionPlan.sessionName;
-        const failedFreshDaemon = failedFreshSessionMayHaveStarted && prepared.executionPlan.sessionName
-            ? await inspectManagedSessionDaemon({
-                cwd,
-                headedManagedAutosaveInterval: prepared.ownedManagedSessionContext?.headedManagedAutosaveInterval,
-                namespace: prepared.executionPlan.namespace,
-                sessionName: prepared.executionPlan.sessionName,
-                timeoutMs: Math.min(implicitSessionCloseTimeoutMs, 2_000),
-            })
-            : undefined;
-        if (failedFreshDaemon?.status === "active") {
-            state.managedSessionRestoreState.recordDaemonRestoreKey(prepared.executionPlan.sessionName, prepared.executionPlan.namespace, failedFreshDaemon.restoreKey);
-        }
-        // Only a confirmed inactive daemon proves that a started fresh command did not establish browser ownership.
-        const postLaunchFreshFailure = failedFreshDaemon !== undefined && failedFreshDaemon.status !== "inactive";
-        const managedTransitionSucceeded = succeeded || nestedBatchClosed || nestedBatchRemainsActive || postLaunchBatchFailure || postLaunchTimeoutWithPage || postLaunchFreshFailure;
-        const managedSessionState = resolveManagedSessionState({ command: commandClosesSession ? "close" : prepared.executionPlan.commandInfo.command, managedSessionName: managedCloseSessionName, managedSessionNamespace: prepared.executionPlan.namespace, priorActive: priorManagedSessionActive, priorNamespace: priorManagedSessionNamespace, priorSessionName: priorManagedSessionName, succeeded: managedTransitionSucceeded });
-        if (!managedTransitionSucceeded && prepared.sessionMode === "fresh" && prepared.executionPlan.managedSessionName) {
-            state.managedSessionRestoreState.clear(prepared.executionPlan.managedSessionName, prepared.executionPlan.namespace);
-        }
-        const replacedManagedSessionName = managedSessionState.replacedSessionName;
-        managedSessionActive = managedSessionState.active;
-        managedSessionName = managedSessionState.sessionName;
-        managedSessionNamespace = managedSessionState.namespace;
-        const executionTargetsManagedSession = prepared.executionPlan.sessionName
-            && getAgentBrowserSessionIdentityKey(prepared.executionPlan.sessionName, prepared.executionPlan.namespace)
-                === getAgentBrowserSessionIdentityKey(managedSessionName, managedSessionNamespace);
-        if (!managedSessionActive) {
-            managedSessionCompatibilityWorkaround = undefined;
-            managedSessionHeadedAutosaveDisabled = false;
-            managedSessionHeadedAutosaveInterval = undefined;
-        }
-        else if (managedTransitionSucceeded && executionTargetsManagedSession && prepared.ownedManagedSessionContext && !prepared.ownedManagedSessionContext.reuseOnly) {
-            managedSessionCompatibilityWorkaround = prepared.compatibilityWorkaround;
-            managedSessionHeadedAutosaveDisabled = prepared.ownedManagedSessionContext?.headedManagedAutosaveDisabled === true;
-            managedSessionHeadedAutosaveInterval = prepared.ownedManagedSessionContext?.headedManagedAutosaveInterval;
-        }
-        if (closeCommandSucceeded && managedCloseSessionName === priorManagedSessionName && !managedSessionActive) {
-            const daemonRestoreKey = state.managedSessionRestoreState.getDaemonRestoreKey(managedCloseSessionName, priorManagedSessionNamespace);
-            const ownedRestoreKey = !state.managedSessionRestoreState.isDisabled(managedCloseSessionName, priorManagedSessionNamespace)
-                && isManagedSessionRestoreKey(daemonRestoreKey) ? daemonRestoreKey : null;
-            state.managedSessionRestoreState.clear(managedCloseSessionName, priorManagedSessionNamespace);
-            pruneOwnedManagedSessionRestoreSnapshots({
-                cwd,
-                namespace: priorManagedSessionNamespace,
-                restoreKey: ownedRestoreKey,
-                statePath: rawCloseStatePath,
-            });
-            freshSessionOrdinal += 1;
-            managedSessionName = createFreshSessionName(state.managedSessionBaseName, state.ephemeralSessionSeed, freshSessionOrdinal);
-            managedSessionNamespace = undefined;
-        }
-        let managedSessionOutcome = buildManagedSessionOutcome({ activeAfter: managedSessionActive, activeBefore: priorManagedSessionActive, attemptedSessionName: managedCloseSessionName, command: commandClosesSession ? "close" : prepared.executionPlan.commandInfo.command, currentSessionName: managedSessionName, currentSessionNamespace: managedSessionNamespace, previousSessionName: priorManagedSessionName, replacedSessionName: replacedManagedSessionName, replacedSessionNamespace: priorManagedSessionNamespace, sessionMode: prepared.sessionMode, succeeded: managedTransitionSucceeded });
-        if (prepared.executionPlan.managedSessionName && managedTransitionSucceeded && managedSessionActive) {
-            if (!priorManagedSessionActive || replacedManagedSessionName)
-                managedSessionCwd = cwd;
-            managedSessionNamespace = prepared.executionPlan.namespace;
-        }
-        if (sessionStateKey && succeeded) {
-            if (openResultTabCorrection || sessionTabCorrection || aboutBlankSessionMismatch?.recoveryApplied)
-                sessionPageState.markPinning(sessionStateKey, "drift");
-            else if (prepared.sessionTabPinningReason === "restore" && observedSessionTabTarget)
-                sessionPageState.clearRestorePinning(sessionStateKey);
-        }
-        if (replacedManagedSessionName) {
-            const replacedSessionStateKey = getSessionContextKey(replacedManagedSessionName, priorManagedSessionNamespace);
-            const replacedSessionKey = replacedSessionStateKey ?? replacedManagedSessionName;
-            const replacedCloseError = await closeManagedSession({ confirmActions: sessionPageState.get(replacedSessionKey).confirmActions ?? process.env.AGENT_BROWSER_CONFIRM_ACTIONS, cwd: priorManagedSessionCwd, headedManagedAutosaveInterval: priorManagedSessionHeadedAutosaveInterval, namespace: priorManagedSessionNamespace, preserveAttachedBrowserSession: state.attachedSessionKeys.has(replacedSessionKey), restoreState: state.managedSessionRestoreState, sessionName: replacedManagedSessionName, socketDir: state.ownedManagedSessions.get(replacedSessionKey)?.socketDir, timeoutMs: implicitSessionCloseTimeoutMs });
-            if (managedSessionOutcome) {
-                managedSessionOutcome = {
-                    ...managedSessionOutcome,
-                    replacedSessionClosed: !replacedCloseError,
-                    summary: replacedCloseError
-                        ? `${managedSessionOutcome.summary} Previous session ${replacedManagedSessionName} remains wrapper-owned because automatic close failed; retry an explicit close.`
-                        : managedSessionOutcome.summary,
-                };
-            }
-            if (!replacedCloseError) {
-                networkRoutesBySession = new Map(networkRoutesBySession);
-                networkRoutesBySession.delete(replacedSessionKey);
-                sessionPageState.clearSession(replacedSessionKey);
-                state.attachedSessionKeys.delete(replacedSessionKey);
-                state.closedManagedSessionNames.add(replacedSessionKey);
-            }
-        }
-        let electronLaunchRecord;
-        let electronFailedConnectCleanup = prepared.electronFailedConnectCleanup;
-        let electronHandoff = prepared.electronHandoff;
-        if (prepared.electronLaunch) {
-            if (succeeded && prepared.executionPlan.sessionName) {
-                const electronSessionName = prepared.executionPlan.sessionName;
-                const electronSessionStateKey = sessionStateKey ?? electronSessionName;
-                electronLaunchRecord = { ...prepared.electronLaunch.record, namespace: prepared.executionPlan.namespace, sessionName: electronSessionName };
-                const electronHandoffMode = prepared.compiledElectron?.action === "launch" ? prepared.compiledElectron.handoff : "connect";
-                try {
-                    electronHandoff = await collectElectronHandoff({ cwd, handoff: electronHandoffMode, namespace: prepared.executionPlan.namespace, sessionName: electronSessionName, signal });
-                }
-                catch (error) {
-                    electronHandoff = {
-                        error: error instanceof Error ? error.message : String(error),
-                        failureCategory: signal?.aborted ? "aborted" : "upstream-error",
-                        handoff: electronHandoffMode,
-                    };
-                }
-                if (electronHandoff.error) {
-                    succeeded = false;
-                    presentationEnvelope = { error: electronHandoff.error, success: false };
-                    const closeError = await closeManagedSession({ confirmActions: sessionPageState.get(electronSessionStateKey).confirmActions ?? process.env.AGENT_BROWSER_CONFIRM_ACTIONS, cwd, headedManagedAutosaveInterval: prepared.ownedManagedSessionContext?.headedManagedAutosaveInterval, namespace: prepared.executionPlan.namespace, policyLock: prepared.managedSessionPolicyLock, preserveAttachedBrowserSession: input.preserveAttachedBrowserSession, restoreState: state.managedSessionRestoreState, sessionName: electronSessionName, timeoutMs: implicitSessionCloseTimeoutMs });
-                    electronFailedConnectCleanup = await cleanupElectronLaunchResources({ child: prepared.electronLaunch.child, record: electronLaunchRecord, timeoutMs: implicitSessionCloseTimeoutMs });
-                    electronLaunchRecord = electronFailedConnectCleanup.record;
-                    if (electronFailedConnectCleanup.partial) {
-                        electronLaunchRecords.set(electronLaunchRecord.launchId, electronLaunchRecord);
-                        electronChildProcesses.set(electronLaunchRecord.launchId, prepared.electronLaunch.child);
-                    }
-                    else {
-                        electronLaunchRecords.delete(electronLaunchRecord.launchId);
-                        electronChildProcesses.delete(electronLaunchRecord.launchId);
-                    }
-                    if (!closeError) {
-                        state.closedManagedSessionNames.add(electronSessionStateKey);
-                        networkRoutesBySession = new Map(networkRoutesBySession);
-                        networkRoutesBySession.delete(electronSessionStateKey);
-                        sessionPageState.clearSession(electronSessionStateKey);
-                        if (managedSessionName === electronSessionName && managedSessionNamespace === prepared.executionPlan.namespace) {
-                            managedSessionActive = false;
-                            freshSessionOrdinal += 1;
-                            managedSessionName = createFreshSessionName(state.managedSessionBaseName, state.ephemeralSessionSeed, freshSessionOrdinal);
-                            managedSessionNamespace = undefined;
-                        }
-                    }
-                    managedSessionOutcome = buildManagedSessionOutcome({ activeAfter: managedSessionActive, activeBefore: priorManagedSessionActive, attemptedSessionName: electronSessionName, command: prepared.executionPlan.commandInfo.command, currentSessionName: managedSessionName, currentSessionNamespace: managedSessionNamespace, previousSessionName: priorManagedSessionName, replacedSessionName: replacedManagedSessionName, replacedSessionNamespace: priorManagedSessionNamespace, sessionMode: prepared.sessionMode, succeeded: false });
-                }
-                else {
-                    electronLaunchRecords.set(electronLaunchRecord.launchId, electronLaunchRecord);
-                    electronChildProcesses.set(electronLaunchRecord.launchId, prepared.electronLaunch.child);
-                    if (electronHandoff.refSnapshot) {
-                        const refUpdate = sessionPageState.applyRefSnapshot({ sessionName: electronSessionStateKey, snapshot: electronHandoff.refSnapshot, update: sessionPageStateUpdate });
-                        currentRefSnapshot = refUpdate.refSnapshot;
-                        currentRefSnapshotInvalidation = refUpdate.refSnapshotInvalidation;
-                        if (electronHandoff.refSnapshot.target) {
-                            const targetUpdate = sessionPageState.applyTabTarget({ sessionName: electronSessionStateKey, target: electronHandoff.refSnapshot.target, update: sessionPageStateUpdate });
-                            currentSessionTabTarget = targetUpdate.tabTarget;
-                        }
-                    }
-                }
-            }
-            else {
-                electronFailedConnectCleanup = await cleanupElectronLaunchResources({ child: prepared.electronLaunch.child, record: prepared.electronLaunch.record, timeoutMs: implicitSessionCloseTimeoutMs });
-                electronLaunchRecord = electronFailedConnectCleanup.record;
-            }
-        }
-        let errorText = recordingStopRecovery?.recovery.healed ? undefined : getAgentBrowserErrorText({ aborted: processResult.aborted, command: prepared.executionPlan.commandInfo.command, effectiveArgs: prepared.redactedProcessArgs, envelope: presentationEnvelope, exitCode: processResult.exitCode, parseError, plainTextInspection, staleRefArgs: getStaleRefArgs(prepared.commandTokens, prepared.runtimeToolStdin), spawnError: processResult.spawnError, stderr: processResult.stderr, timedOut: processResult.timedOut, timeoutMs: processResult.timeoutMs, wrapperRecoveryHint: buildWrapperRecoveryHint({ sessionTabCorrection }) });
-        if (errorText && presentationEnvelope?.success === false && extractEnvelopeErrorText(presentationEnvelope.error) === undefined)
-            presentationEnvelope = { ...presentationEnvelope, error: errorText };
-        if (errorText) {
-            const clipboardWritePayloadCandidates = getClipboardWritePayloadCandidates(prepared.commandTokens);
-            errorText = redactClipboardPermissionEcho(prepared.executionPlan.commandInfo, errorText);
-            if (presentationEnvelope?.error !== undefined)
-                presentationEnvelope = { ...presentationEnvelope, error: redactClipboardPermissionErrorValue(prepared.executionPlan.commandInfo, presentationEnvelope.error, clipboardWritePayloadCandidates) };
-        }
-        if ((plainTextUpgrade || textOutput) && errorText)
-            presentationEnvelope = { ...presentationEnvelope, success: false, error: errorText };
-        const resultRetainsPreparedManagedSession = !managedSessionOutcome || (managedSessionOutcome.activeAfter
-            && managedSessionOutcome.attemptedSessionName === managedSessionOutcome.currentSessionName);
-        const resultHeadedManagedAutosaveDisabled = prepared.ownedManagedSessionContext?.headedManagedAutosaveDisabled === true
-            && resultRetainsPreparedManagedSession
-            && !(commandClosesSession && succeeded);
-        const resultHeadedManagedAutosaveInterval = resultRetainsPreparedManagedSession && !(commandClosesSession && succeeded)
-            ? prepared.ownedManagedSessionContext?.headedManagedAutosaveInterval
-            : undefined;
-        // Commit native lifecycle facts to the execution state before rendering/export can fail.
-        const finalHelperConfirmation = parseReadConfirmation(state.observedBrowserEffects?.readConfirmation);
-        if (finalHelperConfirmation?.state === "pending") {
-            confirmationFromHelper ||= state.observedBrowserEffects?.readConfirmation !== readConfirmationEvent;
-            readConfirmationEvent = finalHelperConfirmation;
-            succeeded = false;
-        }
-        applyBrowserRunStatePatch(state, { artifactManifest, freshSessionOrdinal, managedSessionActive, managedSessionCompatibilityWorkaround, managedSessionHeadedAutosaveDisabled, managedSessionHeadedAutosaveInterval, managedSessionCwd, managedSessionName, managedSessionNamespace, networkRoutesBySession });
-        state.observedBrowserEffects = {
-            args: prepared.redactedArgs, command: directClose ? "close" : prepared.executionPlan.commandInfo.command, subcommand: directClose ? undefined : prepared.executionPlan.commandInfo.subcommand,
-            sessionName: prepared.executionPlan.sessionName, namespace: prepared.executionPlan.namespace, sessionMode: prepared.sessionMode,
-            usedImplicitSession: prepared.executionPlan.usedImplicitSession, agentBrowserStarted: processResult.agentBrowserStarted,
-            nativeSucceeded: succeeded, managedSessionOutcome, managedSessionCwd: prepared.ownedManagedSessionContext?.cwd ?? managedSessionCwd, compatibilityWorkaround: prepared.compatibilityWorkaround,
-            managedSessionHeadedAutosaveDisabled: resultHeadedManagedAutosaveDisabled, managedSessionHeadedAutosaveInterval: resultHeadedManagedAutosaveInterval,
-            managedSessionRestoreDisabled: state.managedSessionRestoreState.isDisabled(prepared.executionPlan.sessionName, prepared.executionPlan.namespace),
-            closeAllApplied, readConfirmation: readConfirmationEvent ?? prepared.readConfirmation ?? state.observedBrowserEffects?.readConfirmation,
-            electron: electronLaunchRecord ? { launch: electronLaunchRecord, cleanup: electronFailedConnectCleanup } : undefined,
-            batchSteps: Array.isArray(presentationEnvelope?.data) ? presentationEnvelope.data.filter(isRecord).map(row => ({
-                command: Array.isArray(row.command) && row.command.every(token => typeof token === "string") ? isSuccessfulNativeConfirmedClose(row.command, row.result) ? ["close"] : redactInvocationArgs(row.command) : undefined,
-                success: row.success === true && !detectConfirmationRequired(row.result), lifecycle: extractAgentBrowserLifecycle(row.result),
-            })) : undefined,
-        };
-        let presentation = plainTextInspection ? { artifacts: undefined, batchFailure: undefined, batchSteps: undefined, content: [{ type: "text", text: inspectionText ?? "" }], data: undefined, fullOutputPath: undefined, fullOutputPaths: undefined, imagePath: undefined, imagePaths: undefined, savedFile: undefined, savedFilePath: undefined, summary: `${prepared.redactedArgs.join(" ")} completed` } : recordingStopRecovery && !recordingStopRecovery.batch ? recordingStopRecovery.presentation : await buildToolPresentation({ textOutput, stdin: prepared.processStdin, modelVisible: input.modelVisible, args: prepared.redactedProcessArgs, artifactManifest, artifactMaxUpdatedAtMs: Date.now(), artifactMinUpdatedAtMs: input.artifactRunStartedAtMs, artifactRequest: screenshotArtifactRequest, batchArtifactRequests: batchScreenshotArtifactRequests, commandInfo: { ...prepared.executionPlan.commandInfo, commandTokens: prepared.commandTokens }, compiledSemanticAction: prepared.compiledSemanticAction, cwd: operationCwd, envelope: presentationEnvelope, errorText, namespace: prepared.executionPlan.namespace, networkRouteDiagnostics, networkRoutes: activeNetworkRoutes, persistentArtifactStore, previousRecordingContactSheetPath: sessionStateKey ? state.activeRecordingReservations?.get(sessionStateKey)?.contactSheetPath : undefined, piCleanupOwnership: sessionStateKey && (state.ownedManagedSessions.has(sessionStateKey) || prepared.executionPlan.managedSessionName !== undefined) ? "wrapper-managed" : "caller-owned", sessionName: prepared.executionPlan.sessionName });
-        if (recordingStopRecovery)
-            presentation = mergeRecordingRecoveryPresentation(presentation, recordingStopRecovery);
-        if (parseError && processResult.exitCode !== 0 && processResult.stderr.trim() && !processResult.timedOut && !processResult.aborted && !processResult.spawnError) {
-            presentation.failureCategory = "upstream-error";
-        }
-        const confirmation = readConfirmationEvent ?? prepared.readConfirmation;
-        if (confirmation) {
-            presentation.readConfirmation = confirmation;
-            if (confirmation.state !== "cleared" || !detectConfirmationRequired(presentationEnvelope?.data)) {
-                presentation.nextActions = buildReadConfirmationNextActions(confirmation, readConfirmationEvent?.state === "pending");
-            }
-            if (readConfirmationEvent?.state === "pending") {
-                presentation.resultCategory = "failure";
-                presentation.failureCategory = "confirmation-required";
-                presentation.successCategory = undefined;
-                if (confirmationFromHelper)
-                    presentation.content.unshift({ type: "text", text: `Native helper ${confirmation.command ?? "read"} requires confirmation (${confirmation.action ?? "read"}, ${confirmation.id}). The requested command's result, if dispatched, is preserved below.` });
-            }
-        }
-        if (plainTextUpgrade && !textOutput && !succeeded && typeof presentationEnvelope?.data === "string") {
-            presentation.data = presentationEnvelope.data;
-            const errorContent = presentation.content[0];
-            if (errorContent?.type === "text" && presentationEnvelope.data)
-                errorContent.text += `\n\n${presentationEnvelope.data}`;
-            if (input.modelVisible !== false)
-                presentation = await compactLargePresentationOutput({ artifactManifest, commandInfo: prepared.executionPlan.commandInfo, data: presentation.data, persistentArtifactStore, presentation });
-        }
-        if (electronHandoff?.error && electronHandoff.failureCategory)
-            presentation.failureCategory = electronHandoff.failureCategory;
-        networkRoutesBySession = applyBatchNetworkRouteState({ data: presentationEnvelope?.data, routesBySession: networkRoutesBySession, sessionName: sessionStateKey, succeeded });
-        if (presentation.resultCategory === "failure" && succeeded) {
-            succeeded = false;
-            presentationEnvelope = { ...(presentationEnvelope ?? {}), error: presentation.summary, success: false };
-        }
-        if (scrollNoopDiagnostic) {
-            succeeded = false;
-            presentation.resultCategory = "failure";
-            presentation.failureCategory = "upstream-error";
-            presentationEnvelope = { ...(presentationEnvelope ?? {}), error: "Scroll completed with no observed movement.", success: false };
-            presentation.summary = "Scroll completed with no observed movement.";
-            if (isRecord(presentation.data))
-                presentation.data = { ...presentation.data, noMovement: true, scrolled: false };
-            if (presentation.content[0]?.type === "text") {
-                const details = isRecord(presentation.data) ? JSON.stringify(omitUpstreamLifecycle(presentation.data), null, 2) : presentation.content[0].text;
-                presentation.content[0] = { ...presentation.content[0], text: `Scroll completed with no observed movement.\n\n${details}` };
-            }
-            else {
-                presentation.content.unshift({ type: "text", text: "Scroll completed with no observed movement." });
-            }
-        }
-        if (parseFailureOutput.artifactManifest) {
-            presentation.artifactManifest = parseFailureOutput.artifactManifest;
-            presentation.artifactRetentionSummary = parseFailureOutput.artifactRetentionSummary;
-        }
-        if (parseFailureOutput.fullOutputPath || parseFailureOutput.fullOutputUnavailable) {
-            const existingText = presentation.content[0]?.type === "text" ? presentation.content[0].text : "";
-            const noticeLines = [parseFailureOutput.fullOutputPath ? `Full output path: ${parseFailureOutput.fullOutputPath}` : `Full raw output unavailable: ${parseFailureOutput.fullOutputUnavailable}`, parseFailureOutput.artifactRetentionSummary].filter((item) => item !== undefined);
-            const notice = noticeLines.join("\n");
-            presentation.content[0] = { type: "text", text: existingText.length > 0 ? `${existingText}\n\n${notice}` : notice };
-        }
-        if (presentation.artifactManifest)
-            artifactManifest = presentation.artifactManifest;
-        const qaPreset = prepared.compiledQaPreset
-            ? (processResult.timedOut ? analyzeQaPresetTimeout(prepared.compiledQaPreset) ?? analyzeQaPresetResults(presentationEnvelope?.data, prepared.compiledQaPreset) : analyzeQaPresetResults(presentationEnvelope?.data, prepared.compiledQaPreset))
-            : undefined;
-        if (qaPreset?.passed && presentation.resultCategory === "failure") {
-            qaPreset.passed = false;
-            qaPreset.summary = presentation.summary;
-            qaPreset.failedChecks.push(presentation.summary);
-        }
-        let qaAttachedTarget = prepared.compiledQaPreset?.checks.attached
-            ? await collectQaAttachedTarget({ currentTarget: currentSessionTabTarget ?? prepared.priorSessionTabTarget, cwd, namespace: prepared.executionPlan.namespace, sessionName: prepared.executionPlan.sessionName, signal })
-            : undefined;
-        const sourceLookupElectronContext = prepared.compiledSourceLookup ? getSourceLookupElectronContext({ currentTarget: currentSessionTabTarget, electronLaunchRecords, namespace: prepared.executionPlan.namespace, priorTarget: prepared.priorSessionTabTarget, sessionName: prepared.executionPlan.sessionName }) : undefined;
-        const sourceLookup = prepared.compiledSourceLookup ? await analyzeSourceLookupResults(presentationEnvelope?.data, prepared.compiledSourceLookup, operationCwd, { electronContext: sourceLookupElectronContext, workspaceRoot: operationCwd }) : undefined;
-        const networkSourceLookup = prepared.compiledNetworkSourceLookup ? redactNetworkSourceLookupAnalysis(await analyzeNetworkSourceLookupResults(presentationEnvelope?.data, prepared.compiledNetworkSourceLookup, operationCwd)) : undefined;
-        if (networkSourceLookup && presentation.content[0]?.type === "text")
-            presentation.content[0] = { ...presentation.content[0], text: `${networkSourceLookup.summary}\n\n${presentation.content[0].text}` };
-        else if (networkSourceLookup)
-            presentation.content.unshift({ type: "text", text: networkSourceLookup.summary });
-        if (sourceLookup && presentation.content[0]?.type === "text")
-            presentation.content[0] = { ...presentation.content[0], text: `${sourceLookup.summary}\n\n${presentation.content[0].text}` };
-        else if (sourceLookup)
-            presentation.content.unshift({ type: "text", text: sourceLookup.summary });
-        if (qaPreset && !qaPreset.passed && prepared.compiledQaPreset && presentation.failureCategory !== "artifact-missing") {
-            succeeded = false;
-            presentation.failureCategory = "qa-failure";
-            presentation.summary = qaPreset.summary;
-            const compactText = buildQaCompactFailureText({
-                causalError: presentation.batchFailure?.failedStep.text,
-                executedStepCount: presentation.batchSteps?.length,
-                page: extractQaPageContext({
-                    attachedTarget: qaAttachedTarget,
-                    batchData: presentationEnvelope?.data,
-                    compiled: prepared.compiledQaPreset,
-                }),
-                plannedStepCount: prepared.compiledQaPreset.steps.length,
-                qaPreset,
-            });
-            const nonTextContent = presentation.content.filter((item) => item.type !== "text");
-            presentation.content = [{ type: "text", text: compactText }, ...nonTextContent];
-        }
-        else if (qaPreset?.passed && prepared.compiledQaPreset && succeeded) {
-            const compactText = buildQaCompactPassText({
-                artifactVerification: presentation.artifactVerification,
-                batchStepCount: presentation.batchSteps?.length ?? prepared.compiledQaPreset.steps.length,
-                checks: prepared.compiledQaPreset.checks,
-                page: extractQaPageContext({
-                    attachedTarget: qaAttachedTarget,
-                    batchData: presentationEnvelope?.data,
-                    compiled: prepared.compiledQaPreset,
-                }),
-                qaPreset,
-            });
-            presentation.summary = qaPreset.summary;
-            const nonTextContent = presentation.content.filter((item) => item.type !== "text");
-            presentation.content = [{ type: "text", text: compactText }, ...nonTextContent];
-        }
-        const qaAttachedTargetText = formatQaAttachedTargetText(qaAttachedTarget);
-        const qaAttachedDiagnosticsText = prepared.compiledQaPreset?.checks.attached && prepared.compiledQaPreset.checks.diagnosticsResetAtStart === false && (prepared.compiledQaPreset.checks.checkNetwork || prepared.compiledQaPreset.checks.checkConsole || prepared.compiledQaPreset.checks.checkErrors)
-            ? "Attached diagnostics: existing upstream session console/network/error buffers were preserved; rows may include events from before qa.attached started."
-            : undefined;
-        const qaAttachedBannerText = [qaAttachedTargetText, qaAttachedDiagnosticsText].filter((part) => typeof part === "string" && part.length > 0).join("\n");
-        const skipAttachedTargetBanner = qaPreset?.passed && prepared.compiledQaPreset?.checks.attached;
-        if (!skipAttachedTargetBanner && qaAttachedBannerText && presentation.content[0]?.type === "text")
-            presentation.content[0] = {
-                ...presentation.content[0],
-                text: qaPreset?.passed === false
-                    ? `${presentation.content[0].text}\n\n${qaAttachedBannerText}`
-                    : `${qaAttachedBannerText}\n\n${presentation.content[0].text}`,
-            };
-        else if (!skipAttachedTargetBanner && qaAttachedBannerText)
-            presentation.content.unshift({ type: "text", text: qaAttachedBannerText });
-        if (managedSessionOutcome && managedSessionOutcome.succeeded !== succeeded)
-            managedSessionOutcome = { ...managedSessionOutcome, succeeded };
-        const evalNavigationSummary = navigationSummary ?? extractNavigationSummaryFromData(presentationEnvelope?.data);
-        const evalSessionTabUrl = sessionStateKey ? sessionPageState.get(sessionStateKey).tabTarget?.url : undefined;
-        const evalPageUrl = evalNavigationSummary?.url ?? currentSessionTabTarget?.url ?? prepared.priorSessionTabTarget?.url ?? evalSessionTabUrl;
-        const evalStdinHint = getEvalStdinHint({ command: prepared.executionPlan.commandInfo.command, data: presentationEnvelope?.data, stdin: prepared.runtimeToolStdin });
-        const evalResultWarning = getEvalResultWarning({ command: prepared.executionPlan.commandInfo.command, data: presentationEnvelope?.data, navigationSummary: evalNavigationSummary, pageUrl: evalPageUrl, stdin: prepared.runtimeToolStdin });
-        if (readConfirmationEvent)
-            state.sessionPageState.applyReadConfirmation(readConfirmationEvent, sessionPageStateUpdate);
-        const resultArtifactManifest = presentation.artifactManifest ?? artifactManifest;
-        const artifactCleanup = await getArtifactCleanupGuidance({ command: prepared.executionPlan.commandInfo.command, cwd, manifest: resultArtifactManifest, succeeded });
-        const recordingTransitionReached = prepared.executionPlan.commandInfo.command === "batch"
-            ? presentation.batchSteps?.some((step) => isRecordPageTransitionCommand(extractUpstreamCommandTokens(step.command ?? [])))
-            : isRecordPageTransitionCommand(prepared.commandTokens);
-        const recordingPageWarning = processResult.agentBrowserStarted && !prepared.executionPlan.plainTextInspection && recordingTransitionReached
-            ? "Page state: this wrapper conservatively invalidates earlier refs after recording starts and URL-bearing restarts. Take a fresh snapshot before continuing; this does not prove the page changed."
-            : undefined;
-        const sessionWarning = electronPostCommandHealth ? formatElectronPostCommandHealthText(electronPostCommandHealth) : electronSessionMismatch ? formatElectronSessionMismatchText(electronSessionMismatch) : aboutBlankSessionMismatch ? buildAboutBlankWarning(aboutBlankSessionMismatch) : undefined;
-        const warningText = [sessionWarning, recordingPageWarning].filter(Boolean).join("\n\n") || undefined;
-        const redactedContent = input.modelVisible === false ? [] : buildRedactedPresentationContent({ exactSensitiveValues: prepared.exactSensitiveValues, plainTextInspection, presentation, presentationEnvelope, succeeded, userRequestedJson: prepared.userRequestedJson, warningText });
-        const finalRecoveryState = await prepareFinalResultRecoveryState({ aboutBlankSessionMismatch, batchRefSnapshotState, commandTokens: prepared.commandTokens, compiledSemanticAction: prepared.compiledSemanticAction, currentRefSnapshot, currentRefSnapshotInvalidation, currentSessionTabTarget, cwd, electronPostCommandHealth, errorText, executionPlan: prepared.executionPlan, parseError, plainTextInspection, presentation, processResult, redactedProcessArgs: prepared.redactedProcessArgs, runtimeToolArgs: prepared.runtimeToolArgs, sessionPageState, sessionPageStateUpdate, sessionTabCorrection, signal, succeeded });
-        currentRefSnapshot = finalRecoveryState.currentRefSnapshot;
-        currentRefSnapshotInvalidation = finalRecoveryState.currentRefSnapshotInvalidation;
-        const authoritativePageState = sessionStateKey ? sessionPageState.get(sessionStateKey) : undefined;
-        const newSnapshot = authoritativePageState?.refSnapshot && authoritativePageState.refSnapshot.snapshotId !== prepared.priorRefSnapshotState?.snapshotId;
-        const needsDaemonReceipt = prepared.ownedManagedSessionContext && !prepared.ownedManagedSessionContext.reuseOnly && !commandClosesSession && processResult.agentBrowserStarted
-            && (succeeded || managedSessionOutcome?.activeAfter === true && managedSessionOutcome.currentSessionName === prepared.executionPlan.sessionName)
-            && !state.managedSessionRestoreState.getDaemonReceipt(prepared.executionPlan.sessionName, prepared.executionPlan.namespace);
-        if (sessionStateKey && prepared.executionPlan.sessionName && (newSnapshot || needsDaemonReceipt)) {
-            const daemon = await inspectManagedSessionDaemon({ cwd, namespace: prepared.executionPlan.namespace, sessionName: prepared.executionPlan.sessionName, signal, includeGeneration: true, headedManagedAutosaveInterval: prepared.ownedManagedSessionContext?.headedManagedAutosaveInterval ?? (prepared.ownedManagedSessionContext?.headedManagedAutosaveDisabled ? "0" : undefined), timeoutMs: prepared.processTimeoutMs });
-            if (newSnapshot) {
-                sessionPageState.bindSnapshotGeneration(sessionStateKey, daemon.status === "active" ? daemon.generation : undefined);
-                currentRefSnapshot = sessionPageState.get(sessionStateKey).refSnapshot;
-            }
-            if (prepared.ownedManagedSessionContext && daemon.status === "active" && daemon.generation) {
-                state.managedSessionRestoreState.recordDaemonRestoreKey(prepared.executionPlan.sessionName, prepared.executionPlan.namespace, daemon.restoreKey, daemon.generation);
-            }
-        }
-        if (sessionStateKey && currentRefSnapshot && processSucceeded && parseSucceeded && !unobservedMutation && readConfirmationEvent?.state === "cleared"
-            && readConfirmationEvent.command === "snapshot" && readConfirmationEvent.action === "snapshot"
-            && confirmedEffects.some(effect => effect.command === "snapshot" && effect.succeeded
-                && effect.index === (Array.isArray(presentationEnvelope?.data) ? presentationEnvelope.data.length - 1 : 0) && extractRefSnapshotFromData(effect.data))) {
-            readConfirmationEvent = { ...readConfirmationEvent, refSnapshotFresh: true };
-            presentation.readConfirmation = readConfirmationEvent;
-            sessionPageState.applyReadConfirmation(readConfirmationEvent, sessionPageStateUpdate);
-            state.observedBrowserEffects = { ...state.observedBrowserEffects, readConfirmation: readConfirmationEvent };
-        }
-        if (sessionStateKey)
-            currentSessionTabTarget = authoritativePageState?.tabTarget;
-        const currentSessionTabTargetUnknown = authoritativePageState?.tabTargetUnknown === true ? true : undefined;
-        // ponytail: skip silent ref copies; direct failure receipts need their existing fields until final publication owns those paths.
-        const result = buildFinalAgentBrowserToolResult({ modelVisible: input.modelVisible, aboutBlankSessionMismatch, artifactCleanup, categoryDetails: finalRecoveryState.categoryDetails, clickDispatchDiagnostic, commandTokens: prepared.commandTokens, comboboxFocusDiagnostic, compiledNetworkSourceLookup: prepared.compiledNetworkSourceLookup, compiledSemanticAction: prepared.compiledSemanticAction, compatibilityWorkaround: prepared.compatibilityWorkaround, currentRefSnapshot: input.modelVisible === false ? undefined : currentRefSnapshot, currentRefSnapshotInvalidation, currentSessionTabTarget, currentSessionTabTargetUnknown, electronBroadGetTextScopeDiagnostics, electronFailedConnectCleanup, electronHandoff, electronLaunch: prepared.electronLaunch, electronLaunchRecord, electronLaunchRecords, electronPostCommandHealth, electronProfileIsolationDetails: input.electronProfileIsolationDetails, electronRefFreshnessDiagnostic, electronSessionMismatch, errorText, evalResultWarning, evalStdinHint, exactSensitiveValues: prepared.exactSensitiveValues, executionPlan: prepared.executionPlan, fillVerificationDiagnostic, headedLaunch: prepared.headedLaunch, inspectionText, preserveAttachedBrowserSession: input.preserveAttachedBrowserSession === true, providerLaunch: prepared.providerLaunch, managedSessionHeadedAutosaveDisabled: !prepared.ownedManagedSessionContext?.reuseOnly && resultHeadedManagedAutosaveDisabled || undefined, managedSessionHeadedAutosaveInterval: prepared.ownedManagedSessionContext?.reuseOnly ? undefined : resultHeadedManagedAutosaveInterval, managedSessionOutcome, managedSessionRestoreDisabled: state.managedSessionRestoreState.isDisabled(prepared.executionPlan.sessionName, prepared.executionPlan.namespace), navigationSummary, networkSourceLookup, noActivePageSnapshotFailure: finalRecoveryState.noActivePageSnapshotFailure, openResultTabCorrection, overlayBlockerDiagnostic, parseError, parseFailureOutput, parseSucceeded, plainTextInspection, presentation, presentationEnvelope, priorSessionTabTarget: prepared.priorSessionTabTarget, processResult, qaAttachedTarget, qaPreset, recordingDependencyWarning, redactedArgs: prepared.redactedArgs, redactedCompiledElectron: prepared.redactedCompiledElectron, redactedCompiledJob: prepared.redactedCompiledJob, redactedCompiledNetworkSourceLookup: prepared.redactedCompiledNetworkSourceLookup, redactedCompiledQaPreset: prepared.redactedCompiledQaPreset, redactedCompiledSemanticAction: prepared.redactedCompiledSemanticAction, redactedCompiledSourceLookup: prepared.redactedCompiledSourceLookup, redactedContent, redactedProcessArgs: prepared.redactedProcessArgs, redactedRecoveryHint: prepared.redactedRecoveryHint, resultArtifactManifest, richInputRecoveryDiagnostic: finalRecoveryState.richInputRecoveryDiagnostic, scrollNoopDiagnostic, selectorTextVisibilityDiagnostics, sessionMode: prepared.sessionMode, sessionTabCorrection, sourceLookup, succeeded, timeoutPartialProgress, unsettledWebMcpMutation, userRequestedJson: prepared.userRequestedJson, visibleRefFallbackDiagnostic: finalRecoveryState.visibleRefFallbackDiagnostic, visibleRefFallbackSessionName: finalRecoveryState.visibleRefFallbackSessionName });
-        const resultWithCloseAll = closeAllApplied
-            ? { ...result, details: { ...(isRecord(result.details) ? result.details : {}), closeAllApplied: true } }
-            : result;
-        const statePatch = { artifactManifest, freshSessionOrdinal, managedSessionActive, managedSessionCompatibilityWorkaround, managedSessionHeadedAutosaveDisabled, managedSessionHeadedAutosaveInterval, managedSessionCwd, managedSessionName, managedSessionNamespace, networkRoutesBySession };
-        return { result: resultWithCloseAll, statePatch };
+        const native = await observeNativeEffects(input, ownership);
+        const page = await observePageEffects(input, native);
+        const lifecycle = await commitLifecycleEffects(input, native, page, ownership);
+        const { publication, recovery } = await publishOutputEffects(input, native, page, lifecycle);
+        return buildOutputResult({ input, native, page, lifecycle, publication }, recovery);
     }
     finally {
-        if (processResult.stdoutSpillPath)
-            await rm(processResult.stdoutSpillPath, { force: true }).catch(() => undefined);
+        const path = input.processResult.stdoutSpillPath;
+        if (path !== undefined && path.length > 0) {
+            await rm(path, { force: true }).catch(() => {
+                // This raw spool is disposable and may already be removed; cleanup must not replace the native outcome or a publication failure.
+            });
+        }
     }
 }