pi-agent-browser-native 0.9.3 → 0.9.5

package/dist/extensions/agent-browser/lib/results/presentation/navigation.js

@@ -1,7 +1,7 @@
-import { isNavigationObservableCommandName, isOpenNavigationCommand, isPageChangeSummaryCommand } from "../../command-taxonomy.js";
+import { isNavigationObservableCommandName, isOpenNavigationCommand, isPageChangeSummaryCommand, } from "../../command-taxonomy.js";
 import { isRecord } from "../../parsing.js";
 import { detectConfirmationRequired } from "../confirmation.js";
-import { firstLine, omitUpstreamLifecycle, redactModelFacingText, stringifyModelFacing } from "./common.js";
+import { firstLine, omitUpstreamLifecycle, redactModelFacingText, stringifyModelFacing, } from "./common.js";
 const NAVIGATION_SUMMARY_FIELD = "navigationSummary";
 const GET_RESULT_FIELDS = {
     attr: "value",
@@ -12,77 +12,87 @@ const GET_RESULT_FIELDS = {
     url: "url",
     value: "value",
 };
-function getScalarExtractionResult(commandInfo, data) {
-    const fallbackField = commandInfo.command === "get" && commandInfo.subcommand ? GET_RESULT_FIELDS[commandInfo.subcommand] ?? "" : "";
-    const resultField = Object.hasOwn(data, "result") ? "result" : fallbackField.length > 0 && Object.hasOwn(data, fallbackField) ? fallbackField : undefined;
-    if (resultField === undefined)
+function getExtractionResultField(command, data) {
+    if (Object.hasOwn(data, "result")) {
+        return "result";
+    }
+    const field = command.command === "get" && command.subcommand !== undefined
+        ? GET_RESULT_FIELDS[command.subcommand]
+        : undefined;
+    return field !== undefined && field.length > 0 && Object.hasOwn(data, field) ? field : undefined;
+}
+function getScalarExtractionResult(command, data) {
+    const field = getExtractionResultField(command, data);
+    if (field === undefined) {
         return undefined;
-    const result = data[resultField];
-    if (typeof result === "string")
+    }
+    const result = data[field];
+    if (typeof result === "string") {
         return result.trim().length > 0 ? result : "(empty string)";
-    if (typeof result === "number" || typeof result === "boolean")
+    }
+    if (typeof result === "number" || typeof result === "boolean") {
         return String(result);
-    if (result === null || result === undefined)
+    }
+    if (result === null || result === undefined) {
         return "null";
-    if (typeof result === "object")
-        return JSON.stringify(result, null, 2);
-    return undefined;
+    }
+    return typeof result === "object" ? JSON.stringify(result, null, 2) : undefined;
 }
 function getExtractionOrigin(data) {
     if (typeof data.origin === "string" && data.origin.trim().length > 0) {
         return data.origin.trim();
     }
-    if (typeof data.url === "string" && data.url.trim().length > 0) {
-        return data.url.trim();
-    }
-    return undefined;
+    return typeof data.url === "string" && data.url.trim().length > 0 ? data.url.trim() : undefined;
 }
 function formatGetSummaryLabel(subcommand) {
-    if (!subcommand) {
+    if (subcommand === undefined || subcommand.length === 0) {
         return "Get result";
     }
-    if (subcommand.toLowerCase() === "url") {
-        return "URL";
-    }
-    return `${subcommand.slice(0, 1).toUpperCase()}${subcommand.slice(1)}`;
+    return subcommand.toLowerCase() === "url"
+        ? "URL"
+        : `${subcommand.slice(0, 1).toUpperCase()}${subcommand.slice(1)}`;
 }
-export function formatExtractionSummary(commandInfo, data) {
-    const scalarResult = getScalarExtractionResult(commandInfo, data);
-    if (!scalarResult) {
+export function formatExtractionSummary(command, data) {
+    const result = getScalarExtractionResult(command, data);
+    if (result === undefined || result.length === 0) {
         return undefined;
     }
-    const safeScalarResult = redactModelFacingText(scalarResult);
-    const firstResultLine = firstLine(safeScalarResult);
-    if (commandInfo.command === "get") {
-        return `${formatGetSummaryLabel(commandInfo.subcommand)}: ${firstResultLine}`;
+    const line = firstLine(redactModelFacingText(result));
+    if (command.command === "get") {
+        return `${formatGetSummaryLabel(command.subcommand)}: ${line}`;
     }
-    if (commandInfo.command === "eval") {
-        return `Eval result: ${firstResultLine}`;
-    }
-    return undefined;
+    return command.command === "eval" ? `Eval result: ${line}` : undefined;
 }
-export function formatExtractionText(commandInfo, data) {
-    if (commandInfo.command !== "get" && commandInfo.command !== "eval") {
+export function formatExtractionText(command, data) {
+    if (command.command !== "get" && command.command !== "eval") {
         return undefined;
     }
-    const scalarResult = getScalarExtractionResult(commandInfo, data);
-    if (!scalarResult) {
+    const result = getScalarExtractionResult(command, data);
+    if (result === undefined || result.length === 0) {
         return undefined;
     }
     const origin = getExtractionOrigin(data);
-    const safeScalarResult = redactModelFacingText(scalarResult);
-    const safeOrigin = origin ? redactModelFacingText(origin) : undefined;
-    return safeOrigin && safeOrigin !== safeScalarResult ? `${safeScalarResult}\n\nOrigin: ${safeOrigin}` : safeScalarResult;
+    const safeResult = redactModelFacingText(result);
+    const safeOrigin = origin !== undefined ? redactModelFacingText(origin) : undefined;
+    return safeOrigin !== undefined && safeOrigin.length > 0 && safeOrigin !== safeResult
+        ? `${safeResult}\n\nOrigin: ${safeOrigin}`
+        : safeResult;
 }
 export function isNavigationObservableCommand(command, subcommand) {
     return isNavigationObservableCommandName(command, subcommand);
 }
 function isNavigationSummary(value) {
-    return isRecord(value) && (typeof value.title === "string" || typeof value.url === "string");
+    if (!isRecord(value)) {
+        return false;
+    }
+    return ((typeof value.title === "string" || typeof value.url === "string") &&
+        (value.title === undefined || typeof value.title === "string") &&
+        (value.url === undefined || typeof value.url === "string") &&
+        (value.urlChanged === undefined || typeof value.urlChanged === "boolean"));
 }
 export function getNavigationSummary(data) {
-    const candidate = data[NAVIGATION_SUMMARY_FIELD];
-    return isNavigationSummary(candidate) ? candidate : undefined;
+    const value = data[NAVIGATION_SUMMARY_FIELD];
+    return isNavigationSummary(value) ? value : undefined;
 }
 function getTopLevelNavigationSummary(data) {
     return isNavigationSummary(data)
@@ -92,57 +102,109 @@ function getTopLevelNavigationSummary(data) {
         }
         : undefined;
 }
+function getNavigationText(value) {
+    return typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
+}
 function getNormalizedNavigationSummary(summary) {
-    const title = typeof summary?.title === "string" && summary.title.trim().length > 0 ? summary.title.trim() : undefined;
-    const url = typeof summary?.url === "string" && summary.url.trim().length > 0 ? summary.url.trim() : undefined;
-    return title || url ? { title, url, ...(typeof summary?.urlChanged === "boolean" ? { urlChanged: summary.urlChanged } : {}) } : undefined;
+    const title = getNavigationText(summary?.title);
+    const url = getNavigationText(summary?.url);
+    return title !== undefined || url !== undefined
+        ? {
+            title,
+            url,
+            ...(typeof summary?.urlChanged === "boolean" ? { urlChanged: summary.urlChanged } : {}),
+        }
+        : undefined;
 }
 export function formatNavigationSummary(summary) {
     const normalized = getNormalizedNavigationSummary(summary);
-    if (!normalized)
+    if (!normalized) {
         return undefined;
-    if (normalized.title && normalized.url)
-        return `${normalized.title}\n${normalized.url}`;
-    return normalized.title ?? normalized.url;
+    }
+    return normalized.title !== undefined && normalized.url !== undefined
+        ? `${normalized.title}\n${normalized.url}`
+        : (normalized.title ?? normalized.url);
 }
-export function buildPageChangeSummary(options) {
-    const { artifacts, commandInfo, data, nextActions, savedFilePath } = options;
-    const artifactCount = artifacts?.length ?? 0;
-    const navigation = isRecord(data)
-        ? getNormalizedNavigationSummary(getNavigationSummary(data) ?? (isPageChangeSummaryCommand(commandInfo.command, commandInfo.subcommand) ? getTopLevelNavigationSummary(data) : undefined))
+function getPageNavigation(command, data) {
+    if (!isRecord(data)) {
+        return undefined;
+    }
+    const summary = getNavigationSummary(data) ??
+        (isPageChangeSummaryCommand(command.command, command.subcommand)
+            ? getTopLevelNavigationSummary(data)
+            : undefined);
+    return getNormalizedNavigationSummary(summary);
+}
+function isNavigationObserved(command, navigation) {
+    return (navigation !== undefined &&
+        (navigation.urlChanged === true ||
+            isOpenNavigationCommand(command.command) ||
+            ["back", "forward", "pushstate", "reload"].includes(command.command ?? "")));
+}
+function getPageChangeKind(options, evidence) {
+    if (evidence.savedFilePath !== undefined || evidence.artifactCount > 0) {
+        return "artifact";
+    }
+    const navigation = evidence.navigation;
+    if (isNavigationObserved(options.commandInfo, navigation)) {
+        return "navigation";
+    }
+    if (detectConfirmationRequired(options.data) !== undefined) {
+        return "confirmation";
+    }
+    return navigation ||
+        isPageChangeSummaryCommand(options.commandInfo.command, options.commandInfo.subcommand)
+        ? "mutation"
         : undefined;
-    const confirmationRequired = detectConfirmationRequired(data) !== undefined;
-    if (!navigation && !confirmationRequired && artifactCount === 0 && !savedFilePath && !isPageChangeSummaryCommand(commandInfo.command, commandInfo.subcommand)) {
+}
+function getPageChangeTargetParts(evidence) {
+    const parts = [evidence.navigation?.title, evidence.navigation?.url].filter((value) => value !== undefined);
+    if (evidence.savedFilePath !== undefined) {
+        parts.push(evidence.savedFilePath);
+    }
+    else if (evidence.artifactCount > 0) {
+        parts.push(`${evidence.artifactCount} artifact${evidence.artifactCount === 1 ? "" : "s"}`);
+    }
+    return parts;
+}
+function formatPageChangeText(command, evidence, kind) {
+    const observed = kind !== "mutation";
+    const parts = [
+        command.command ?? "agent-browser",
+        observed ? kind : "action dispatched",
+        ...getPageChangeTargetParts(evidence),
+    ];
+    return `${parts.join(" → ")}${observed ? "" : " → application change unverified"}`;
+}
+function getPageChangeIdentityFields(options, evidence) {
+    return {
+        ...(options.commandInfo.command !== undefined && options.commandInfo.command.length > 0
+            ? { command: options.commandInfo.command }
+            : {}),
+        ...(options.nextActions
+            ? { nextActionIds: options.nextActions.map((action) => action.id) }
+            : {}),
+        ...(evidence.savedFilePath !== undefined ? { savedFilePath: evidence.savedFilePath } : {}),
+        ...(evidence.navigation?.title !== undefined ? { title: evidence.navigation.title } : {}),
+        ...(evidence.navigation?.url !== undefined ? { url: evidence.navigation.url } : {}),
+    };
+}
+export function buildPageChangeSummary(options) {
+    const evidence = {
+        artifactCount: options.artifacts?.length ?? 0,
+        navigation: getPageNavigation(options.commandInfo, options.data),
+        savedFilePath: options.savedFilePath === "" ? undefined : options.savedFilePath,
+    };
+    const changeType = getPageChangeKind(options, evidence);
+    if (changeType === undefined) {
         return undefined;
     }
-    const navigationObserved = navigation && (navigation.urlChanged === true || isOpenNavigationCommand(commandInfo.command) || ["back", "forward", "pushstate", "reload"].includes(commandInfo.command ?? ""));
-    const changeType = savedFilePath || artifactCount > 0
-        ? "artifact"
-        : navigationObserved
-            ? "navigation"
-            : confirmationRequired
-                ? "confirmation"
-                : "mutation";
-    const observed = changeType !== "mutation";
-    const parts = [commandInfo.command ?? "agent-browser", observed ? changeType : "action dispatched"];
-    if (navigation?.title)
-        parts.push(navigation.title);
-    if (navigation?.url)
-        parts.push(navigation.url);
-    if (savedFilePath)
-        parts.push(savedFilePath);
-    else if (artifactCount > 0)
-        parts.push(`${artifactCount} artifact${artifactCount === 1 ? "" : "s"}`);
     return {
-        ...(artifactCount > 0 ? { artifactCount } : {}),
+        ...getPageChangeIdentityFields(options, evidence),
+        ...(evidence.artifactCount > 0 ? { artifactCount: evidence.artifactCount } : {}),
         changeType,
-        ...(commandInfo.command ? { command: commandInfo.command } : {}),
-        ...(nextActions ? { nextActionIds: nextActions.map((action) => action.id) } : {}),
-        observed,
-        ...(savedFilePath ? { savedFilePath } : {}),
-        summary: `${parts.join(" → ")}${observed ? "" : " → application change unverified"}`,
-        ...(navigation?.title ? { title: navigation.title } : {}),
-        ...(navigation?.url ? { url: navigation.url } : {}),
+        observed: changeType !== "mutation",
+        summary: formatPageChangeText(options.commandInfo, evidence, changeType),
     };
 }
 function stripNavigationSummary(data) {
@@ -164,9 +226,6 @@ export function formatNavigationActionResult(data) {
     if (lines.length > 0) {
         return lines.join("\n");
     }
-    const actionText = stringifyModelFacing(actionData).trim();
-    if (actionText.length === 0 || actionText === "{}") {
-        return undefined;
-    }
-    return actionText;
+    const text = stringifyModelFacing(actionData).trim();
+    return text.length === 0 || text === "{}" ? undefined : text;
 }

package/dist/extensions/agent-browser/lib/results/presentation/notices.js

@@ -0,0 +1,75 @@
+import { isRecord } from "../../parsing.js";
+import { getSavedFileDetails } from "./artifacts.js";
+import { formatWebMcpCatalogUpdate } from "./common.js";
+import { formatNetworkRouteDiagnosticsText } from "./diagnostics.js";
+import { buildErrorPresentation } from "./errors.js";
+function appendNotice(draft, text) {
+    if (text !== undefined && text.length > 0 && draft.content[0]?.type === "text") {
+        draft.content[0] = { ...draft.content[0], text: `${draft.content[0].text}\n\n${text}` };
+    }
+}
+function getKeyboardInsertTextWarning(commandInfo) {
+    if (commandInfo.command !== "keyboard" || commandInfo.subcommand !== "inserttext") {
+        return undefined;
+    }
+    return "Input dispatch warning: keyboard inserttext skips key events. A DOM value change does not prove a framework-controlled editor accepted it; verify application state before saving, or use keyboard type when real key events are required.";
+}
+function applyRecordingError(draft, options, source) {
+    if (options.errorText === undefined ||
+        options.errorText.length === 0 ||
+        (!source.recordingCommand && !source.recordingBatch)) {
+        return;
+    }
+    const failure = buildErrorPresentation({
+        args: options.args,
+        commandInfo: options.commandInfo,
+        errorText: options.errorText,
+        presentationCommand: source.presentationCommandInfo.command,
+        sessionName: options.sessionName,
+    });
+    draft.resultCategory = "failure";
+    draft.failureCategory = failure.failureCategory;
+    draft.summary = failure.summary;
+    draft.content = [
+        {
+            type: "text",
+            text: `${failure.content[0]?.type === "text" ? failure.content[0].text : options.errorText}\n\n${draft.content[0]?.type === "text" ? draft.content[0].text : ""}`,
+        },
+    ];
+}
+function applyNetworkNotices(draft, options) {
+    const diagnostics = options.networkRouteDiagnostics;
+    if (diagnostics && diagnostics.length > 0 && draft.content[0]?.type === "text") {
+        const text = formatNetworkRouteDiagnosticsText(diagnostics);
+        if (text !== undefined && text.length > 0) {
+            draft.content[0] = { ...draft.content[0], text: `${text}\n\n${draft.content[0].text}` };
+        }
+        draft.networkRouteDiagnostics = diagnostics;
+    }
+}
+function applySavedFile(draft, source, commandInfo) {
+    if (!isRecord(source.data)) {
+        return;
+    }
+    const savedFile = getSavedFileDetails(commandInfo, source.data);
+    if (savedFile) {
+        draft.savedFile = savedFile;
+        draft.savedFilePath = savedFile.path;
+    }
+}
+export function applyPresentationNotices(draft, options, source) {
+    applyRecordingError(draft, options, source);
+    applyNetworkNotices(draft, options);
+    applySavedFile(draft, source, options.commandInfo);
+    const data = source.presentationData;
+    if (isRecord(data) &&
+        isRecord(data.webmcp) &&
+        (Array.isArray(data.webmcp.tools) || data.webmcp.status === "unavailable")) {
+        appendNotice(draft, formatWebMcpCatalogUpdate(data.webmcp));
+    }
+    if (options.commandInfo.command === "screenshot" &&
+        (options.args?.includes("--annotate") ?? false)) {
+        appendNotice(draft, "Annotated screenshot note: dense pages can produce overlapping labels. If the labels are noisy, capture a scoped element screenshot, take a non-annotated screenshot, or use snapshot -i high-value refs as the machine-readable map.");
+    }
+    appendNotice(draft, getKeyboardInsertTextWarning(source.commandInfo));
+}

package/dist/extensions/agent-browser/lib/results/presentation/observation-contracts.js

@@ -0,0 +1 @@
+export {};

package/dist/extensions/agent-browser/lib/results/presentation/observation-rendering.js

@@ -0,0 +1,127 @@
+import { isRecord } from "../../parsing.js";
+import { isSessionArtifactManifest } from "../artifact-manifest-validation.js";
+import { stringifyUnknown, truncateText } from "../text.js";
+import { applyArtifactManifest } from "./artifacts.js";
+import { redactModelFacingText } from "./common.js";
+import { OBSERVATION_INLINE_MAX_CHARS, projectAgentBrowserObservation } from "./content.js";
+import { buildSpillArtifactEntries, writeLargeOutputSpillFile, } from "./output-spill.js";
+function isJsonValue(value) {
+    if (value === null ||
+        typeof value === "string" ||
+        typeof value === "number" ||
+        typeof value === "boolean") {
+        return true;
+    }
+    if (Array.isArray(value)) {
+        return value.every(isJsonValue);
+    }
+    return isRecord(value) && Object.values(value).every(isJsonValue);
+}
+function toJsonValue(value) {
+    const parsed = JSON.parse(JSON.stringify(value));
+    if (!isJsonValue(parsed)) {
+        throw new Error("Serialized browser observation must be JSON.");
+    }
+    return parsed;
+}
+function getCompactSummary(observation) {
+    if (typeof observation.summary === "string") {
+        return truncateText(observation.summary, 700);
+    }
+    return typeof observation.error === "string" ? truncateText(observation.error, 700) : undefined;
+}
+function buildCompactObservation(observation, persisted) {
+    const compact = {
+        success: observation.success,
+        resultCategory: observation.resultCategory,
+        failureCategory: observation.failureCategory,
+        successCategory: observation.successCategory,
+        summary: getCompactSummary(observation),
+        compacted: true,
+        ...(persisted.spill
+            ? {
+                observationPath: persisted.spill.path,
+                retrieve: "Read observationPath for the complete redacted observation, including exact recovery actions and requested data.",
+            }
+            : {
+                observationUnavailable: truncateText(redactModelFacingText(persisted.error ?? "Spill could not be written; request a smaller result."), 1_000),
+            }),
+    };
+    for (const key of [
+        "sessionName",
+        "namespace",
+        "codeRun",
+        "error",
+        "failures",
+        "nextActions",
+        "artifactVerification",
+        "imageObservations",
+        "data",
+        "fullOutputPath",
+        "fullOutputPaths",
+    ]) {
+        if (observation[key] !== undefined &&
+            JSON.stringify({ ...compact, [key]: observation[key] }, null, 2).length <=
+                OBSERVATION_INLINE_MAX_CHARS - 500) {
+            compact[key] = observation[key];
+        }
+    }
+    return compact;
+}
+async function persistObservation(options, observation, prose, text) {
+    const manifest = isSessionArtifactManifest(options.details.artifactManifest)
+        ? options.details.artifactManifest
+        : undefined;
+    try {
+        const write = () => writeLargeOutputSpillFile({
+            data: { ...observation, ...(!options.json ? { text: prose } : {}) },
+            persistentArtifactStore: options.persistentArtifactStore,
+            text,
+        });
+        const spill = await (options.withArtifactWrite ? options.withArtifactWrite(write) : write());
+        return {
+            spill,
+            manifest: applyArtifactManifest({ content: [], summary: "" }, manifest, buildSpillArtifactEntries({
+                ...spill,
+                commandInfo: {
+                    command: typeof options.details.command === "string" ? options.details.command : undefined,
+                },
+            })).artifactManifest,
+        };
+    }
+    catch (error) {
+        return { manifest, error: error instanceof Error ? error.message : stringifyUnknown(error) };
+    }
+}
+/** Bound final model-visible output after recovery assembly; never truncate executable actions. */
+export async function renderAgentBrowserObservation(options) {
+    const observation = projectAgentBrowserObservation(options.details, options.succeeded);
+    let structuredContent = observation;
+    const images = options.content.filter((part) => part.type === "image");
+    const prose = options.content
+        .filter((part) => part.type === "text")
+        .map((part) => part.text)
+        .join("\n\n");
+    const { data: _data, error: _error, summary: _summary, ...metadata } = observation;
+    let text = options.json
+        ? JSON.stringify(observation, null, 2)
+        : `${prose}\n\nObservation: ${JSON.stringify(metadata)}`;
+    let manifest = isSessionArtifactManifest(options.details.artifactManifest)
+        ? options.details.artifactManifest
+        : undefined;
+    if (text.length > OBSERVATION_INLINE_MAX_CHARS ||
+        JSON.stringify(observation).length > OBSERVATION_INLINE_MAX_CHARS) {
+        const persisted = await persistObservation(options, observation, prose, text);
+        manifest = persisted.manifest;
+        structuredContent = buildCompactObservation(observation, persisted);
+        text = options.preserveContent === true ? prose : JSON.stringify(structuredContent, null, 2);
+        if (options.preserveContent !== true && !options.json) {
+            text = `Browser observation compacted.\n${text}`;
+        }
+    }
+    return {
+        content: [{ type: "text", text }, ...images],
+        artifactManifest: manifest,
+        structuredContent: toJsonValue(structuredContent),
+    };
+}

package/dist/extensions/agent-browser/lib/results/presentation/outcomes.js

@@ -0,0 +1,120 @@
+import { buildReadConfirmationNextActions } from "../../read-confirmation.js";
+import { buildAgentBrowserNextActions } from "../action-recommendations.js";
+import { buildAgentBrowserResultCategoryDetails } from "../categories.js";
+import { classifyPresentationSuccessCategory, formatMissingArtifactFailureText, hasMissingFileArtifact, } from "./artifacts.js";
+import { buildNetworkRequestsNextActions, buildStreamNextActions } from "./diagnostics.js";
+import { isOverlayBlockedClickError } from "./errors.js";
+import { buildPageChangeSummary } from "./navigation.js";
+function markFailure(draft, category, text, prepend) {
+    draft.resultCategory = "failure";
+    draft.failureCategory = category;
+    draft.successCategory = undefined;
+    draft.summary = text;
+    if (!prepend && draft.content[0]?.type === "text") {
+        draft.content[0] = { ...draft.content[0], text: `${text}\n\n${draft.content[0].text}` };
+    }
+    else {
+        draft.content.unshift({ type: "text", text });
+    }
+}
+function applyArtifactFailures(draft, options) {
+    const missing = formatMissingArtifactFailureText(draft.artifacts);
+    const hasError = options.errorText !== undefined && options.errorText.length > 0;
+    if (hasError) {
+        return;
+    }
+    if (missing !== undefined && missing.length > 0 && hasMissingFileArtifact(draft.artifacts)) {
+        markFailure(draft, "artifact-missing", missing, false);
+    }
+    const recording = draft.artifacts?.find((artifact) => artifact.recording?.success === false ||
+        artifact.recording?.output.encoderSucceeded === false);
+    if (recording) {
+        markFailure(draft, "upstream-error", `Recording failed: ${recording.recording?.error ?? "native capture/encoder failure"}`, true);
+    }
+}
+function classifyOutcome(draft, options, source) {
+    if (source.readConfirmation?.state === "pending") {
+        draft.readConfirmation = source.readConfirmation;
+        draft.resultCategory = "failure";
+        draft.failureCategory = "confirmation-required";
+        draft.successCategory = undefined;
+    }
+    if (draft.resultCategory === undefined) {
+        const categories = buildAgentBrowserResultCategoryDetails({
+            artifacts: draft.artifacts,
+            command: source.presentationCommandInfo.command,
+            confirmationRequired: source.confirmationRequired !== undefined,
+            errorText: options.envelope?.success === false ? draft.summary : undefined,
+            savedFile: draft.savedFile,
+            succeeded: options.envelope?.success !== false && source.confirmationRequired === undefined,
+        });
+        draft.resultCategory = categories.resultCategory;
+        draft.successCategory = categories.successCategory;
+        draft.failureCategory = categories.failureCategory;
+    }
+    if (draft.resultCategory === "success") {
+        draft.successCategory = classifyPresentationSuccessCategory({
+            artifactVerification: draft.artifactVerification,
+            artifacts: draft.artifacts,
+            savedFile: draft.savedFile,
+        });
+    }
+}
+function getGenericNextActions(draft, options, source) {
+    if (draft.nextActions) {
+        return undefined;
+    }
+    return buildAgentBrowserNextActions({
+        artifacts: draft.artifacts,
+        args: options.args,
+        command: source.presentationCommandInfo.command,
+        confirmationId: source.confirmationRequired?.id,
+        failureCategory: draft.failureCategory,
+        overlayBlockedClick: isOverlayBlockedClickError(source.presentationCommandInfo.command, options.envelope?.success === false ? draft.summary : undefined, options.args ?? source.presentationCommandInfo.commandTokens),
+        resultCategory: draft.resultCategory ?? "success",
+        savedFilePath: draft.savedFilePath,
+        sessionName: options.sessionName,
+        subcommand: source.presentationCommandInfo.subcommand,
+        successCategory: draft.successCategory,
+    });
+}
+function applyNextActions(draft, options, source) {
+    const generic = getGenericNextActions(draft, options, source);
+    const network = source.commandInfo.command === "network" &&
+        source.commandInfo.subcommand === "requests" &&
+        draft.resultCategory === "success"
+        ? buildNetworkRequestsNextActions(source.data, options.sessionName, draft.networkRouteDiagnostics)
+        : undefined;
+    const stream = draft.resultCategory === "success"
+        ? buildStreamNextActions(source.commandInfo, source.data, options.sessionName)
+        : undefined;
+    const merged = [draft.nextActions, generic, network, stream].flatMap((group) => group ?? []);
+    const fallback = merged.length > 0 ? merged : undefined;
+    draft.nextActions = source.readConfirmation
+        ? buildReadConfirmationNextActions(source.readConfirmation, true)
+        : fallback;
+}
+export function applyPresentationOutcome(draft, options, source) {
+    applyArtifactFailures(draft, options);
+    classifyOutcome(draft, options, source);
+    applyNextActions(draft, options, source);
+    draft.pageChangeSummary ??= buildPageChangeSummary({
+        artifacts: draft.artifacts,
+        commandInfo: source.presentationCommandInfo,
+        data: source.data,
+        nextActions: draft.nextActions,
+        savedFilePath: draft.savedFilePath,
+        summary: draft.summary,
+    });
+    if (draft.pageChangeSummary?.observed === false &&
+        source.presentationCommandInfo.command !== "batch" &&
+        draft.content[0]?.type === "text") {
+        draft.content[0] = {
+            ...draft.content[0],
+            text: `${draft.content[0].text}\n\nAction dispatched; application change unverified. Verify the expected URL, text, state, or external receipt before relying on it.`,
+        };
+    }
+    if (options.modelVisible === false) {
+        draft.content = [];
+    }
+}