pi-agent-browser-native 0.3.0 → 0.5.0

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

@@ -1,11 +1,13 @@
+import { isCloseCommand } from "../../command-taxonomy.js";
 import { isRecord } from "../../parsing.js";
-import { extractCommandTokens, parseCommandInfo, redactInvocationArgs, redactSensitiveText, redactSensitiveValue } from "../../runtime.js";
+import { getAgentBrowserSessionIdentityKey } from "../../argv-grammar.js";
+import { extractUpstreamCommandTokens, parseCommandInfo, redactInvocationArgs, redactSensitiveText, redactSensitiveValue } from "../../runtime.js";
 import { buildAgentBrowserNextActions } from "../action-recommendations.js";
-import { formatSessionArtifactRetentionSummary } from "../artifact-manifest.js";
+import { formatSessionArtifactRetentionSummary, isPendingRecordingArtifact } from "../artifact-manifest.js";
 import { classifyAgentBrowserFailureCategory } from "../categories.js";
 import { detectConfirmationRequired } from "../confirmation.js";
 import { applyNetworkRouteRecords, buildNetworkRouteDiagnostics } from "../network-routes.js";
-import { applyNamespaceToNextActions, withOptionalSessionArgs } from "../next-actions.js";
+import { appendUniqueAgentBrowserNextActions, applyNamespaceToNextActions, withOptionalSessionArgs } from "../next-actions.js";
 import { stringifyModelFacing } from "./common.js";
 import { buildArtifactVerificationSummary, classifyPresentationSuccessCategory, manifestHasNewNoticeWorthyEntries } from "./artifacts.js";
 import { formatBatchStepCommand, getPresentationImages, getPresentationPaths, getPresentationText, isStringArray } from "./content.js";
@@ -62,7 +64,7 @@ function hasModelFacingArgRedaction(args) {
 function getStatefulCommandSensitiveValues(command) {
     if (!command)
         return [];
-    const tokens = extractCommandTokens(command);
+    const tokens = extractUpstreamCommandTokens(command);
     const values = [];
     if (tokens[0] === "cookies" && tokens[1] === "set" && tokens[3])
         values.push(tokens[3]);
@@ -181,10 +183,11 @@ function formatBatchStepsText(steps) {
     return lines.join("\n\n");
 }
 async function buildBatchStepPresentation(options) {
-    const { artifactManifest, artifactRequest, buildNestedToolPresentation, cwd, index, item, namespace, networkRoutes, persistentArtifactStore, sessionName } = options;
+    const { artifactManifest, artifactMaxUpdatedAtMs, artifactMinUpdatedAtMs, artifactRequest, buildNestedToolPresentation, cwd, index, item, namespace, networkRoutes, persistentArtifactStore, sessionName } = options;
     const command = isStringArray(item.command) ? item.command : undefined;
     const redactedCommand = command ? redactInvocationArgs(command) : undefined;
     const commandText = formatBatchStepCommand(hasModelFacingArgRedaction(redactedCommand) ? redactedCommand : command, index);
+    const lifecycle = extractBatchStepLifecycle(item.result);
     if (item.success === false) {
         const redactedErrorData = command?.[0] === "clipboard"
             ? redactSensitiveValue(redactClipboardPermissionErrorValue({ command: "clipboard", subcommand: command[1] }, item.error, getClipboardWritePayloadCandidates(command)))
@@ -196,13 +199,14 @@ async function buildBatchStepPresentation(options) {
             errorText,
         });
         const confirmationRequired = detectConfirmationRequired(item.error);
-        const nextActions = applyNamespaceToNextActions(mergePresentationNextActions(buildAgentBrowserNextActions({
+        const nextActions = applyNamespaceToNextActions(mergePresentationNextActions(isWaitTextAssertionCommand(command) ? [buildWaitTextAssertionFailureNextAction(sessionName)] : undefined, buildAgentBrowserNextActions({
             args: command,
             command: command?.[0],
             confirmationId: confirmationRequired?.id,
             failureCategory,
             resultCategory: "failure",
-        }), isWaitTextAssertionCommand(command) ? [buildWaitTextAssertionFailureNextAction(sessionName)] : undefined), namespace);
+            sessionName,
+        })), namespace);
         const presentation = {
             content: [{ type: "text", text: errorText }],
             failureCategory,
@@ -219,6 +223,7 @@ async function buildBatchStepPresentation(options) {
                 data: redactedErrorData,
                 failureCategory,
                 index,
+                lifecycle,
                 nextActions,
                 resultCategory: "failure",
                 success: false,
@@ -235,12 +240,15 @@ async function buildBatchStepPresentation(options) {
         : undefined;
     const presentation = await buildNestedToolPresentation({
         artifactManifest,
+        artifactMaxUpdatedAtMs,
+        artifactMinUpdatedAtMs,
         artifactRequest,
         commandInfo: commandInfoWithTokens,
         cwd,
         args: command,
         envelope: { data: item.result, success: true },
         networkRouteDiagnostics,
+        namespace,
         persistentArtifactStore,
         sessionName,
     });
@@ -261,6 +269,7 @@ async function buildBatchStepPresentation(options) {
         failureCategory: presentation.failureCategory,
         resultCategory: stepSucceeded ? "success" : "failure",
         savedFilePath: presentation.savedFilePath,
+        sessionName,
         successCategory: presentation.successCategory,
     }), namespace);
     const pageChangeSummary = buildPageChangeSummary({
@@ -284,6 +293,7 @@ async function buildBatchStepPresentation(options) {
             imagePath: imagePaths[0],
             imagePaths: imagePaths.length > 0 ? imagePaths : undefined,
             index,
+            lifecycle,
             networkRouteDiagnostics: presentation.networkRouteDiagnostics,
             nextActions,
             pageChangeSummary,
@@ -298,6 +308,48 @@ async function buildBatchStepPresentation(options) {
         presentation,
     };
 }
+function extractBatchStepLifecycle(result) {
+    if (!isRecord(result) || !isRecord(result.lifecycle) || !isRecord(result.lifecycle.effectiveLaunch))
+        return undefined;
+    const browserLaunched = result.lifecycle.effectiveLaunch.browserLaunched;
+    return typeof browserLaunched === "boolean" ? { effectiveLaunch: { browserLaunched } } : undefined;
+}
+function abandonedRecordingArtifact(artifact) {
+    const { recordingState: _recordingState, willExistOnStop: _willExistOnStop, ...terminal } = artifact;
+    return { ...terminal, exists: false, status: "missing", subcommand: "close-abandoned" };
+}
+function coalesceTerminalBatchRecordingArtifacts(steps, sessionName, namespace) {
+    const artifacts = [];
+    const pendingIndexesBySession = new Map();
+    const removedPendingIndexes = new Set();
+    for (const step of steps) {
+        for (const artifact of step.presentation.artifacts ?? []) {
+            const index = artifacts.push(artifact) - 1;
+            if (artifact.command !== "record" || artifact.kind !== "video")
+                continue;
+            const session = artifact.session ? getAgentBrowserSessionIdentityKey(artifact.session, artifact.namespace) : "";
+            if (isPendingRecordingArtifact(artifact)) {
+                const pendingIndexes = pendingIndexesBySession.get(session) ?? [];
+                pendingIndexes.push(index);
+                pendingIndexesBySession.set(session, pendingIndexes);
+                continue;
+            }
+            const pendingIndex = pendingIndexesBySession.get(session)?.pop();
+            if (pendingIndex !== undefined)
+                removedPendingIndexes.add(pendingIndex);
+        }
+        const command = step.details.command;
+        if (step.details.success !== true || !command || !isCloseCommand(extractUpstreamCommandTokens(command)[0]))
+            continue;
+        const session = sessionName ? getAgentBrowserSessionIdentityKey(sessionName, namespace) : "";
+        for (const pendingIndex of pendingIndexesBySession.get(session) ?? []) {
+            const pending = artifacts[pendingIndex];
+            if (pending && !removedPendingIndexes.has(pendingIndex))
+                artifacts[pendingIndex] = abandonedRecordingArtifact(pending);
+        }
+    }
+    return artifacts.filter((_, index) => !removedPendingIndexes.has(index));
+}
 export async function buildBatchPresentation(options) {
     const { artifactRequests, buildNestedToolPresentation, cwd, data, namespace, networkRoutes, persistentArtifactStore, sessionName, summary } = options;
     const steps = [];
@@ -307,6 +359,8 @@ export async function buildBatchPresentation(options) {
     for (const [index, item] of data.entries()) {
         const step = await buildBatchStepPresentation({
             artifactManifest: currentArtifactManifest,
+            artifactMaxUpdatedAtMs: options.artifactMaxUpdatedAtMs,
+            artifactMinUpdatedAtMs: options.artifactMinUpdatedAtMs,
             artifactRequest: artifactRequests?.[index],
             buildNestedToolPresentation,
             cwd,
@@ -319,7 +373,7 @@ export async function buildBatchPresentation(options) {
         });
         steps.push(step);
         currentArtifactManifest = step.presentation.artifactManifest ?? currentArtifactManifest;
-        currentNetworkRoutes = applyNetworkRouteRecords(currentNetworkRoutes, isStringArray(item.command) ? extractCommandTokens(item.command) : undefined, item.success !== false && step.details.success);
+        currentNetworkRoutes = applyNetworkRouteRecords(currentNetworkRoutes, isStringArray(item.command) ? extractUpstreamCommandTokens(item.command) : undefined, item.success !== false && step.details.success);
         protectedPersistentPaths.push(...getPresentationPaths({
             primaryPath: step.presentation.fullOutputPath,
             secondaryPaths: step.presentation.fullOutputPaths,
@@ -327,7 +381,7 @@ export async function buildBatchPresentation(options) {
     }
     const batchFailure = getBatchFailureDetails(steps);
     const images = steps.flatMap((step) => getPresentationImages(step.presentation));
-    const artifacts = steps.flatMap((step) => step.presentation.artifacts ?? []);
+    const artifacts = coalesceTerminalBatchRecordingArtifacts(steps, sessionName, namespace);
     const artifactVerification = buildArtifactVerificationSummary(artifacts);
     const fullOutputPaths = steps.flatMap((step) => getPresentationPaths({
         primaryPath: step.presentation.fullOutputPath,
@@ -356,9 +410,10 @@ export async function buildBatchPresentation(options) {
     const contentText = artifactRetentionSummary && manifestHasNewNoticeWorthyEntries(options.artifactManifest, currentArtifactManifest)
         ? `${text}\n\n${artifactRetentionSummary}`
         : text;
+    const artifactLifecycleActions = applyNamespaceToNextActions(buildAgentBrowserNextActions({ artifacts, command: "batch", resultCategory: batchFailure ? "failure" : "success", sessionName }), namespace);
     const nextActions = batchFailure
-        ? batchFailure.failedStep.nextActions
-        : buildAgentBrowserNextActions({ artifacts, command: "batch", resultCategory: "success" });
+        ? appendUniqueAgentBrowserNextActions([...(batchFailure.failedStep.nextActions ?? [])], artifactLifecycleActions)
+        : artifactLifecycleActions;
     const changedSteps = steps.map((step) => step.details).filter((details) => details.pageChangeSummary !== undefined);
     const pageChangeSummary = artifacts.length > 0
         ? buildPageChangeSummary({

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

@@ -1,6 +1,7 @@
 import { containsManagedSessionRestoreKey } from "../../managed-session-capabilities.js";
 import { redactSensitiveText, redactSensitiveValue } from "../../runtime.js";
 import { stringifyUnknown, truncateText } from "../text.js";
+const UNTITLED_PAGE_SUMMARY = "(untitled page)";
 export function stringifyModelFacing(value) {
     return stringifyUnknown(redactSensitiveValue(value));
 }
@@ -34,6 +35,23 @@ export function getStringField(data, key) {
     const value = data[key];
     return typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
 }
+// `lifecycle` is upstream launch/reuse bookkeeping, never page content, so it must not be the
+// answer an agent reads when a command has no dedicated presenter.
+export function omitUpstreamLifecycle(data) {
+    const { lifecycle: _lifecycle, ...rest } = data;
+    return rest;
+}
+export function getPageSummary(data) {
+    const title = typeof data.title === "string" ? data.title : undefined;
+    const url = typeof data.url === "string" ? data.url : undefined;
+    if (title === undefined && url === undefined)
+        return undefined;
+    if (title && url)
+        return `${title}\n${url}`;
+    if (url)
+        return url;
+    return title || UNTITLED_PAGE_SUMMARY;
+}
 export function formatCount(count, singular, plural = `${singular}s`) {
     return `${count} ${count === 1 ? singular : plural}`;
 }

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

@@ -61,7 +61,9 @@ export function getTabSummary(data) {
                     ? String(tab.index)
                     : String(index);
         const labelText = label && label !== tabSelector ? ` label=${redactModelFacingText(label)}` : "";
-        return `${marker} [${tabSelector}]${labelText} ${title} — ${url}`;
+        const targetId = typeof tab.targetId === "string" && tab.targetId.trim().length > 0 ? tab.targetId.trim() : undefined;
+        const targetText = targetId && targetId !== tabSelector ? ` target=${redactModelFacingText(targetId)}` : "";
+        return `${marker} [${tabSelector}]${labelText}${targetText} ${title} — ${url}`;
     });
     return lines.join("\n");
 }
@@ -348,6 +350,8 @@ function formatNetworkRequestLine(item, index) {
 }
 function formatNetworkRequestsText(data, commandInfo) {
     const requests = getArrayField(data, "requests");
+    if (isClearDiagnosticCommand(commandInfo) && data.cleared === true && !requests)
+        return "Network request buffer cleared.";
     if (!requests)
         return undefined;
     if (isClearDiagnosticCommand(commandInfo)) {
@@ -593,6 +597,8 @@ export function buildStreamNextActions(commandInfo, data, sessionName) {
 }
 function formatConsoleText(data, commandInfo) {
     const messages = getArrayField(data, "messages");
+    if (isClearDiagnosticCommand(commandInfo) && data.cleared === true && !messages)
+        return "Console buffer cleared.";
     if (!messages)
         return undefined;
     if (isClearDiagnosticCommand(commandInfo)) {

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

@@ -189,11 +189,12 @@ export function buildErrorPresentation(options) {
     const nextActions = [
         ...(buildUnknownCommandSuggestionActions(unknownCommandSuggestions, sessionName) ?? []),
         ...(browserProfileConfigRecovery?.actions ?? []),
-        ...(buildAgentBrowserNextActions({
+        ...(browserProfileConfigRecovery ? [] : buildAgentBrowserNextActions({
             args,
             command: commandInfo.command,
             failureCategory: categoryDetails.failureCategory,
             resultCategory: "failure",
+            sessionName,
         }) ?? []),
     ];
     return {

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

@@ -1,16 +1,31 @@
 import { isNavigationObservableCommandName, isPageChangeSummaryCommand } from "../../command-taxonomy.js";
 import { isRecord } from "../../parsing.js";
 import { detectConfirmationRequired } from "../confirmation.js";
-import { redactModelFacingText, stringifyModelFacing } from "./common.js";
+import { omitUpstreamLifecycle, redactModelFacingText, stringifyModelFacing } from "./common.js";
 const NAVIGATION_SUMMARY_FIELD = "navigationSummary";
-function getScalarExtractionResult(data) {
-    const { result } = data;
-    if (typeof result === "string") {
-        return result.trim().length > 0 ? result : undefined;
-    }
-    if (typeof result === "number" || typeof result === "boolean") {
+const GET_RESULT_FIELDS = {
+    attr: "value",
+    count: "count",
+    html: "html",
+    text: "text",
+    title: "title",
+    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)
+        return undefined;
+    const result = data[resultField];
+    if (typeof result === "string")
+        return result.trim().length > 0 ? result : "(empty string)";
+    if (typeof result === "number" || typeof result === "boolean")
         return String(result);
-    }
+    if (result === null || result === undefined)
+        return "null";
+    if (typeof result === "object")
+        return JSON.stringify(result);
     return undefined;
 }
 function getExtractionOrigin(data) {
@@ -32,7 +47,7 @@ function formatGetSummaryLabel(subcommand) {
     return `${subcommand.slice(0, 1).toUpperCase()}${subcommand.slice(1)}`;
 }
 export function formatExtractionSummary(commandInfo, data) {
-    const scalarResult = getScalarExtractionResult(data);
+    const scalarResult = getScalarExtractionResult(commandInfo, data);
     if (!scalarResult) {
         return undefined;
     }
@@ -50,7 +65,7 @@ export function formatExtractionText(commandInfo, data) {
     if (commandInfo.command !== "get" && commandInfo.command !== "eval") {
         return undefined;
     }
-    const scalarResult = getScalarExtractionResult(data);
+    const scalarResult = getScalarExtractionResult(commandInfo, data);
     if (!scalarResult) {
         return undefined;
     }
@@ -132,7 +147,7 @@ function stripNavigationSummary(data) {
     return rest;
 }
 export function formatNavigationActionResult(data) {
-    const actionData = stripNavigationSummary(data);
+    const actionData = omitUpstreamLifecycle(stripNavigationSummary(data));
     const lines = [];
     if (typeof actionData.clicked === "string" || typeof actionData.clicked === "boolean") {
         lines.push(`Clicked: ${String(actionData.clicked)}`);

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

@@ -1,24 +1,54 @@
 import { isRecord } from "../../parsing.js";
 import { detectConfirmationRequired } from "../confirmation.js";
 import { formatRawSnapshotText, formatSnapshotSummary } from "../snapshot.js";
-import { redactModelFacingText, stringifyModelFacing } from "./common.js";
+import { getPageSummary, omitUpstreamLifecycle, redactModelFacingText, stringifyModelFacing } from "./common.js";
 import { formatDiagnosticSummary, formatDiagnosticText, formatProfilesText, getStreamSummary, getTabSummary } from "./diagnostics.js";
 import { getScreenshotSummary } from "./artifacts.js";
 import { formatSkillsText } from "./skills.js";
 import { formatExtractionSummary, formatExtractionText, formatNavigationActionResult, formatNavigationSummary, getNavigationSummary, isNavigationObservableCommand, } from "./navigation.js";
 import { formatSemanticActionPresentationSummary, formatSemanticActionPresentationText, resolvePresentationCommandInfo, } from "./semantic-action.js";
-function getPageSummary(data) {
-    const title = typeof data.title === "string" ? data.title : undefined;
-    const url = typeof data.url === "string" ? data.url : undefined;
-    if (!title && !url)
-        return undefined;
-    if (title && url)
-        return `${title}\n${url}`;
-    return title ?? url;
-}
 function formatConfirmationRequiredSummary(confirmation) {
     return `Confirmation required: ${confirmation.id}`;
 }
+const SIMPLE_ACTION_RESULTS = {
+    check: { field: "checked", label: "Checked" },
+    click: { field: "clicked", label: "Clicked" },
+    fill: { field: "filled", label: "Filled" },
+    focus: { field: "focused", label: "Focused" },
+    hover: { field: "hovered", label: "Hovered" },
+    press: { field: "pressed", label: "Pressed" },
+    select: { field: "selected", label: "Selected" },
+    type: { field: "typed", label: "Typed" },
+    uncheck: { field: "unchecked", label: "Unchecked" },
+};
+function formatSimpleActionResult(command, data) {
+    if (!isRecord(data))
+        return undefined;
+    if (command === "click" && getNavigationSummary(data))
+        return undefined;
+    const definition = SIMPLE_ACTION_RESULTS[command];
+    if (!definition)
+        return undefined;
+    const value = data[definition.field];
+    if (typeof value !== "string" && typeof value !== "number" && typeof value !== "boolean")
+        return undefined;
+    return `${definition.label}: ${redactModelFacingText(String(value))}`;
+}
+function formatWaitResult(data) {
+    if (!isRecord(data))
+        return undefined;
+    if (data.waited === "timeout")
+        return "Fixed wait elapsed; no page condition was verified.";
+    for (const field of ["selector", "text", "url", "state", "waited"]) {
+        const value = data[field];
+        if (typeof value === "string" && value.length > 0)
+            return `Wait completed: ${redactModelFacingText(value)}`;
+    }
+    return undefined;
+}
+function formatCloseResult(data) {
+    return isRecord(data) && data.closed === true ? "Browser session closed." : undefined;
+}
 const VITALS_METRICS = ["lcp", "fcp", "ttfb", "inp", "cls"];
 function coerceVitalsMetricValue(value) {
     if (typeof value === "number" && Number.isFinite(value))
@@ -80,6 +110,14 @@ function formatConfirmationRequiredText(confirmation) {
     return lines.join("\n");
 }
 const COMMAND_PRESENTERS = {
+    ...Object.fromEntries(Object.keys(SIMPLE_ACTION_RESULTS).map((command) => [command, {
+            summary: (_commandInfo, data) => formatSimpleActionResult(command, data),
+            text: (_commandInfo, data) => formatSimpleActionResult(command, data),
+        }])),
+    close: { summary: (_commandInfo, data) => formatCloseResult(data), text: (_commandInfo, data) => formatCloseResult(data) },
+    exit: { summary: (_commandInfo, data) => formatCloseResult(data), text: (_commandInfo, data) => formatCloseResult(data) },
+    quit: { summary: (_commandInfo, data) => formatCloseResult(data), text: (_commandInfo, data) => formatCloseResult(data) },
+    wait: { summary: (_commandInfo, data) => formatWaitResult(data), text: (_commandInfo, data) => formatWaitResult(data) },
     profiles: {
         summary: (_commandInfo, data) => Array.isArray(data) ? `Chrome profiles: ${data.length}` : undefined,
         text: (_commandInfo, data) => Array.isArray(data) ? formatProfilesText(data, "Chrome profiles") : undefined,
@@ -118,8 +156,12 @@ const COMMAND_PRESENTERS = {
         text: (commandInfo, data) => isRecord(data) && commandInfo.subcommand === "status" ? getStreamSummary(data) : undefined,
     },
     tab: {
-        summary: (_commandInfo, data) => isRecord(data) && Array.isArray(data.tabs) ? `Tabs: ${data.tabs.length}` : undefined,
-        text: (_commandInfo, data) => isRecord(data) ? getTabSummary(data) : undefined,
+        summary: (_commandInfo, data) => isRecord(data) && Array.isArray(data.tabs)
+            ? `Tabs: ${data.tabs.length}`
+            : isRecord(data) && data.closed === true ? "Tab closed" : undefined,
+        text: (_commandInfo, data) => isRecord(data) && data.closed === true
+            ? `Tab closed${typeof data.tabId === "string" ? `: ${redactModelFacingText(data.tabId)}` : "."}`
+            : isRecord(data) ? getTabSummary(data) : undefined,
     },
     vitals: {
         summary: (_commandInfo, data) => isRecord(data) ? formatVitalsSummary(data) : undefined,
@@ -216,5 +258,8 @@ export function formatPresentationContentText(commandInfo, data, compiledSemanti
     const pageSummary = getPageSummary(data);
     if (pageSummary)
         return redactModelFacingText(pageSummary);
-    return stringifyModelFacing(data);
+    const { navigationSummary: _navigationSummary, ...pageData } = omitUpstreamLifecycle(data);
+    if (Object.keys(pageData).length > 0)
+        return stringifyModelFacing(pageData);
+    return `${presentationCommandInfo.command ?? commandInfo.command ?? "agent-browser"} completed`;
 }

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

@@ -1,18 +1,9 @@
 import { getCompiledSemanticActionCommandIndex, isCompiledSemanticActionFindCommand, } from "../../input-modes/semantic-action.js";
 import { isRecord } from "../../parsing.js";
 import { formatNavigationSummary, getNavigationSummary, isNavigationObservableCommand, } from "./navigation.js";
-import { redactModelFacingText } from "./common.js";
+import { getPageSummary, redactModelFacingText } from "./common.js";
 const SEMANTIC_NAVIGATION_PROBE_ACTIONS = new Set(["check", "click"]);
 const SEMANTIC_PRESENTATION_ACTIONS = new Set(["check", "click", "fill", "select"]);
-function getPageSummary(data) {
-    const title = typeof data.title === "string" ? data.title : undefined;
-    const url = typeof data.url === "string" ? data.url : undefined;
-    if (!title && !url)
-        return undefined;
-    if (title && url)
-        return `${title}\n${url}`;
-    return title ?? url;
-}
 function formatSemanticActionTarget(compiled) {
     if (compiled.action === "select") {
         const selector = compiled.selector ?? "selector";

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

@@ -1,5 +1,5 @@
 import { isRecord } from "../parsing.js";
-import { extractCommandTokens } from "../runtime.js";
+import { extractUpstreamCommandTokens } from "../runtime.js";
 import { buildAgentBrowserNextActions } from "./action-recommendations.js";
 import { buildAgentBrowserResultCategoryDetails } from "./categories.js";
 import { detectConfirmationRequired } from "./confirmation.js";
@@ -33,14 +33,14 @@ function shouldAddAnnotatedScreenshotGuidance(commandInfo, args) {
 }
 export async function buildToolPresentation(options) {
     const { args, artifactManifest, artifactRequest, commandInfo, compiledSemanticAction, cwd, envelope, errorText, namespace, networkRouteDiagnostics, networkRoutes, persistentArtifactStore, sessionName, } = options;
-    const commandInfoWithTokens = commandInfo.commandTokens || !args ? commandInfo : { ...commandInfo, commandTokens: extractCommandTokens(args) };
+    const commandInfoWithTokens = commandInfo.commandTokens || !args ? commandInfo : { ...commandInfo, commandTokens: extractUpstreamCommandTokens(args) };
     const presentationCommandInfo = resolvePresentationCommandInfo(commandInfoWithTokens, compiledSemanticAction);
     if (errorText) {
         return buildErrorPresentation({ args, commandInfo, errorText, sessionName });
     }
     const data = enrichStreamStatusData(commandInfoWithTokens, envelope?.data);
     const presentationData = redactPresentationData(commandInfoWithTokens, data);
-    const artifacts = await extractFileArtifacts({ artifactManifest, artifactRequest, commandInfo: presentationCommandInfo, cwd, data, sessionName });
+    const artifacts = await extractFileArtifacts({ artifactManifest, artifactMaxUpdatedAtMs: options.artifactMaxUpdatedAtMs, artifactMinUpdatedAtMs: options.artifactMinUpdatedAtMs, artifactRequest, commandInfo: presentationCommandInfo, cwd, data, namespace, sessionName });
     const artifactVerification = buildArtifactVerificationSummary(artifacts);
     const artifactSummary = formatArtifactSummary(artifacts);
     const summary = artifactSummary ?? formatPresentationSummary(commandInfoWithTokens, data, compiledSemanticAction);
@@ -49,6 +49,8 @@ export async function buildToolPresentation(options) {
     if (commandInfo.command === "batch" && isAgentBrowserBatchResultArray(data)) {
         presentation = await buildBatchPresentation({
             artifactManifest,
+            artifactMaxUpdatedAtMs: options.artifactMaxUpdatedAtMs,
+            artifactMinUpdatedAtMs: options.artifactMinUpdatedAtMs,
             artifactRequests: options.batchArtifactRequests,
             buildNestedToolPresentation: buildToolPresentation,
             cwd,
@@ -156,6 +158,7 @@ export async function buildToolPresentation(options) {
         failureCategory: presentationWithManifest.failureCategory,
         resultCategory: presentationWithManifest.resultCategory ?? "success",
         savedFilePath: presentationWithManifest.savedFilePath,
+        sessionName,
         successCategory: presentationWithManifest.successCategory,
     });
     const networkNextActions = commandInfoWithTokens.command === "network" && commandInfoWithTokens.subcommand === "requests" && presentationWithManifest.resultCategory === "success"

package/dist/extensions/agent-browser/lib/results/recovery-actions.js

@@ -8,6 +8,8 @@ export const AGENT_BROWSER_RECOVERY_NEXT_ACTION_IDS = {
     selectIntendedTabAfterDrift: "select-intended-tab-after-drift",
     snapshotAfterTabRecovery: "snapshot-after-tab-recovery",
     tabDriftListTabs: "list-tabs-for-tab-drift-recovery",
+    tabGoneListTabs: "list-tabs-after-tab-gone",
+    tabGoneNewTab: "open-tab-after-tab-gone",
 };
 export const AGENT_BROWSER_RICH_INPUT_RECOVERY_NEXT_ACTION_IDS = {
     click: "click-current-editable-ref",

package/dist/extensions/agent-browser/lib/results/selector-recovery.js

@@ -16,7 +16,17 @@ function isSelectorRecoveryActionName(action) {
 function getFindNameFlagValue(args, startIndex) {
     const nameFlagIndex = args.indexOf("--name", startIndex);
     const name = nameFlagIndex >= 0 ? args[nameFlagIndex + 1] : undefined;
-    return name && !name.startsWith("-") ? name : undefined;
+    return typeof name === "string" && name.length > 0 ? name : undefined;
+}
+function collectFindTrailingValues(args, startIndex) {
+    const values = [];
+    for (let index = startIndex; index < args.length; index += 1) {
+        const token = args[index];
+        if (!token || token.startsWith("-"))
+            break;
+        values.push(token);
+    }
+    return values;
 }
 function getFindVisibleRefFallbackTarget(args, options = {}) {
     const findIndex = args[0] === "--session" ? 2 : 0;
@@ -25,8 +35,21 @@ function getFindVisibleRefFallbackTarget(args, options = {}) {
     const locator = args[findIndex + 1];
     const value = args[findIndex + 2];
     const action = args[findIndex + 3];
-    if (!locator || !value || !isSelectorRecoveryActionName(action) || action === "select")
+    if (!locator || !value || !isSelectorRecoveryActionName(action))
         return undefined;
+    if (action === "select") {
+        const optionValues = collectFindTrailingValues(args, findIndex + 4);
+        if (locator === "role") {
+            if (!/^(?:combobox|listbox)$/i.test(value))
+                return undefined;
+            const targetName = getFindNameFlagValue(args, findIndex + 4);
+            return targetName ? { action, optionValues, roles: [value.toLowerCase()], targetName } : undefined;
+        }
+        if (locator === "label") {
+            return { action, optionValues, roles: ["combobox", "listbox"], targetName: value };
+        }
+        return undefined;
+    }
     const text = action === "fill" ? args[findIndex + 4] : undefined;
     if (action === "fill" && (!text || (!options.allowLeadingDashFillText && text.startsWith("-"))))
         return undefined;
@@ -69,7 +92,13 @@ function getVisibleRefFallbackCandidates(target, snapshotData) {
             return [];
         if (target.action === "fill" && editableEvidence === false && EDITABLE_CONTROL_ROLES.has(role.toLowerCase()))
             return [];
-        const directRefArgs = target.action === "fill" ? undefined : [target.action, `@${ref}`];
+        const directRefArgs = target.action === "fill"
+            ? undefined
+            : target.action === "select" && target.optionValues && target.optionValues.length > 0
+                ? ["select", `@${ref}`, ...target.optionValues]
+                : target.action === "select"
+                    ? undefined
+                    : [target.action, `@${ref}`];
         return [{
                 action: target.action,
                 ...(directRefArgs ? { args: directRefArgs } : {}),
@@ -101,19 +130,33 @@ export function buildVisibleRefFallbackDiagnosticFromSnapshot(options) {
 }
 export function resolveVisibleRefActionFromSnapshot(options) {
     const target = getFindVisibleRefFallbackTarget(options.compiledAction.args, { allowLeadingDashFillText: true });
-    if (!target || target.action === "select")
+    if (!target)
         return undefined;
     const snapshot = extractRefSnapshotFromData(options.snapshotData);
     if (!snapshot)
         return undefined;
-    const candidates = getVisibleRefFallbackCandidates(target, options.snapshotData);
-    if (target.action === "fill") {
-        if (!options.allowFill || candidates.length !== 1 || target.text === undefined)
+    const selectOptionValues = options.compiledAction.values && options.compiledAction.values.length > 0
+        ? options.compiledAction.values
+        : target.optionValues;
+    const effectiveTarget = target.action === "select" && selectOptionValues
+        ? { ...target, optionValues: selectOptionValues }
+        : target;
+    const candidates = getVisibleRefFallbackCandidates(effectiveTarget, options.snapshotData);
+    if (effectiveTarget.action === "fill") {
+        if (!options.allowFill || candidates.length !== 1 || effectiveTarget.text === undefined)
             return undefined;
         const [candidate] = candidates;
         if (!candidate || candidate.editableEvidence === false || !EDITABLE_CONTROL_ROLES.has(candidate.role.toLowerCase()))
             return undefined;
-        return { args: ["fill", candidate.ref, target.text], snapshot };
+        return { args: ["fill", candidate.ref, effectiveTarget.text], snapshot };
+    }
+    if (effectiveTarget.action === "select") {
+        if (candidates.length !== 1 || !selectOptionValues || selectOptionValues.length === 0)
+            return undefined;
+        const [candidate] = candidates;
+        if (!candidate)
+            return undefined;
+        return { args: ["select", candidate.ref, ...selectOptionValues], snapshot };
     }
     const candidate = candidates.find((item) => item.args !== undefined);
     if (!candidate?.args)

package/dist/extensions/agent-browser/lib/results/snapshot-high-value-controls.js

@@ -2,6 +2,8 @@ import { compareRefIds } from "./text.js";
 const SNAPSHOT_HIGH_VALUE_EDITABLE_REF_FILL_TARGET_LINES = 4;
 const SNAPSHOT_HIGH_VALUE_SURFACE_REF_FILL_TARGET_LINES = 3;
 const SNAPSHOT_HIGH_VALUE_PRIMARY_ACTION_REF_FILL_TARGET_LINES = 3;
+const SNAPSHOT_HIGH_VALUE_NAMED_LINK_REF_FILL_TARGET_LINES = 6;
+const SNAPSHOT_HIGH_VALUE_LINK_NAME_MAX_LENGTH = 80;
 const SNAPSHOT_HIGH_VALUE_CONTROL_ROLES = new Set([
     "button",
     "checkbox",
@@ -33,9 +35,6 @@ const SNAPSHOT_PRIMARY_ACTION_BUTTON_NAME_PATTERNS = [
     /^(?:add|apply|ask|attach|choose|confirm|connect|continue|create|deploy|done|download|go|insert|launch|log in|new|next|ok|open|publish|refresh|retry|run|save|search|select|send|sign in|sign up|start|submit|upload)$/i,
     /^(?:add|apply|ask|confirm|connect|continue|create|launch|new|open|refresh|retry|run|save|search|send|start|submit)\b/i,
 ];
-const SNAPSHOT_HIGH_VALUE_LINK_NAME_PATTERNS = [
-    /^[a-z0-9_.-]+\/[a-z0-9_.-]+$/i,
-];
 function getHighValueControlRole(entry) {
     return entry.isEditable === true && (entry.role === "unknown" || entry.role === "generic") ? "textbox" : entry.role;
 }
@@ -82,22 +81,29 @@ const SNAPSHOT_HIGH_VALUE_CONTROL_CATEGORY_RULES = [
         matches: (entry) => isPrimaryActionButtonRef(entry),
         priority: 2,
     },
+    {
+        bucketKey: () => "named-link",
+        fillTarget: SNAPSHOT_HIGH_VALUE_NAMED_LINK_REF_FILL_TARGET_LINES,
+        id: "named-link",
+        matches: (entry) => getHighValueControlRole(entry) === "link" && isNamedActionLinkRef(entry),
+        priority: 3,
+    },
     {
         bucketKey: (_entry, role) => role,
         id: "role",
         matches: () => true,
-        priority: 3,
+        priority: 4,
     },
 ];
-function isHighValueLinkRef(entry) {
-    return entry.name.length > 0 && SNAPSHOT_HIGH_VALUE_LINK_NAME_PATTERNS.some((pattern) => pattern.test(entry.name));
+function isNamedActionLinkRef(entry) {
+    return entry.name.length > 0 && entry.name.length <= SNAPSHOT_HIGH_VALUE_LINK_NAME_MAX_LENGTH;
 }
 export function isHighValueControlEntry(entry) {
     const role = getHighValueControlRole(entry);
     if (!SNAPSHOT_HIGH_VALUE_CONTROL_ROLES.has(role))
         return false;
     if (role === "link")
-        return isHighValueLinkRef(entry);
+        return isNamedActionLinkRef(entry);
     if (entry.isEditable === false && (role === "searchbox" || role === "textbox" || role === "combobox"))
         return false;
     return entry.name.length > 0 || isEditableControlRef(entry);