pi-agent-browser-native 0.2.77 → 0.5.0

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

@@ -1,21 +1,31 @@
-/**
- * Purpose: Format scalar extraction results, navigation summaries, and page-change summaries.
- * Responsibilities: Keep navigation/extraction presentation separate from core tool result orchestration.
- * Scope: Navigation and get/eval extraction formatting only.
- */
 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) {
@@ -37,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;
     }
@@ -55,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;
     }
@@ -137,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,23 +1,9 @@
-/**
- * Purpose: Map successful semanticAction results to the same presentation signals as direct ref commands.
- * Responsibilities: Resolve presentation command names, compact action prose, and navigation-summary probe gates.
- * Scope: semanticAction success presentation only.
- */
 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/skills.js

@@ -1,8 +1,3 @@
-/**
- * Purpose: Render upstream agent-browser skills output as native pi tool guidance.
- * Responsibilities: Format skills list/path/get results and translate agent-browser shell snippets to agent_browser tool calls.
- * Scope: Skills command presentation only.
- */
 import { isRecord } from "../../parsing.js";
 import { getStringField, redactModelFacingText, stringifyModelFacing } from "./common.js";
 function formatSkillsListText(skills) {

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

@@ -1,10 +1,5 @@
-/*
- * Purpose: Render parsed agent-browser results into concise pi-facing summaries, text content, and optional inline image attachments.
- * Responsibilities: Orchestrate specialized presentation modules, attach inline images within size limits, and keep generic record formatting distinct from envelope parsing.
- * Scope: Presentation shaping only; upstream stdout parsing and snapshot compaction internals live in separate modules.
- */
 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";
@@ -38,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);
@@ -54,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,
@@ -161,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

@@ -1,10 +1,3 @@
-/**
- * Purpose: Centralize recovery-oriented nextAction ids and action construction.
- * Responsibilities: Build tab/about:blank/no-active-page/connected-session follow-ups and rich-input recovery ids.
- * Scope: Recovery action contracts only; result category classification and artifact follow-ups live elsewhere.
- * Usage: Imported by shared result action builders and the extension entrypoint.
- * Invariants/Assumptions: Ids are public machine-readable contracts mirrored by docs and tests.
- */
 import { buildNextToolAction, withOptionalSessionArgs } from "./next-actions.js";
 export const AGENT_BROWSER_RECOVERY_NEXT_ACTION_IDS = {
     aboutBlankListTabs: "list-tabs-for-about-blank-recovery",
@@ -15,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/recovery-next-actions.js

@@ -1,10 +1,3 @@
-/**
- * Purpose: Build session-aware recovery nextActions that combine result category policy with known session/tab context.
- * Responsibilities: Prefix recovery argv with the active session and adapt tab/about:blank/no-active/stale-ref contexts into stable nextAction lists.
- * Scope: Recovery nextAction assembly only; diagnostic detection and action-list merge ordering stay in the extension entrypoint.
- * Usage: Imported by the extension entrypoint when adding recovery nextActions to tool details.
- * Invariants/Assumptions: Action ids and argv ordering are public contracts; session prefixing must not double-prefix explicit --session args.
- */
 import { buildAgentBrowserNextActions } from "./action-recommendations.js";
 import { withOptionalSessionArgs } from "./next-actions.js";
 export function buildConnectedSessionNextActions(sessionName) {

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

@@ -1,10 +1,3 @@
-/**
- * Purpose: Own pure selector-miss recovery diagnostics for visible refs and rich editable inputs.
- * Responsibilities: Parse find/semantic action targets, match current snapshot refs, build public diagnostics, text, and safe nextActions.
- * Scope: Selector recovery policy only; subprocess snapshot probing and result orchestration stay in the extension entrypoint.
- * Usage: The extension entrypoint supplies command tokens plus snapshot data after a selector-not-found failure.
- * Invariants/Assumptions: Public fill recovery must never echo or auto-submit the user-provided fill text; guarded semanticAction fill pre-resolution may execute only one exact current editable ref.
- */
 import { isRecord } from "../parsing.js";
 import { extractRefSnapshotFromData } from "../session-page-state.js";
 import { getEditableRefEvidence } from "./editable-ref-evidence.js";
@@ -23,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;
@@ -32,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;
@@ -76,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 } : {}),
@@ -108,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

@@ -1,14 +1,9 @@
-/**
- * Purpose: Select the omitted snapshot refs most likely to be actionable controls.
- * Responsibilities: Classify editable, surface, primary-action, and role-based control refs with deterministic diversity and top-up rules.
- * Scope: High-value control ranking only; snapshot parsing, noise filtering, and presentation text live in neighboring modules.
- * Usage: Snapshot presentation passes already-visible, non-noise omitted refs and receives the bounded high-value subset to surface.
- * Invariants/Assumptions: Ranking must preserve scarce control categories before filling dominant buckets so dense desktop hosts stay navigable.
- */
 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",
@@ -40,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;
 }
@@ -89,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);

package/dist/extensions/agent-browser/lib/results/snapshot-refs.js

@@ -1,10 +1,3 @@
-/**
- * Purpose: Own canonical parsing and enrichment of refs from agent-browser snapshot payloads.
- * Responsibilities: Read structured refs, correlate them with raw snapshot lines, and infer editable/ref role evidence once for consumers.
- * Scope: Snapshot ref metadata only; section preview, high-value ranking, and presentation assembly live in neighboring modules.
- * Usage: Imported by snapshot presentation and recovery diagnostics that need consistent ref/name/role/editable evidence.
- * Invariants/Assumptions: Snapshot text parsing is best-effort and must tolerate upstream formatting changes by preserving structured ref data when line parsing fails.
- */
 import { isRecord } from "../parsing.js";
 import { getEditableRefEvidence } from "./editable-ref-evidence.js";
 import { compareRefIds, normalizeWhitespace } from "./text.js";

package/dist/extensions/agent-browser/lib/results/snapshot-segments.js

@@ -1,10 +1,3 @@
-/**
- * Purpose: Parse raw agent-browser snapshot text into previewable sections.
- * Responsibilities: Identify signal lines, rank content segments, build structured previews, and provide raw-outline fallback previews.
- * Scope: Snapshot text/section planning only; ref enrichment, high-value control ranking, spill files, and final presentation live elsewhere.
- * Usage: Snapshot presentation uses this module before selecting displayed refs.
- * Invariants/Assumptions: Parsing is best-effort and must stay resilient to upstream snapshot text format changes.
- */
 import { normalizeWhitespace, truncateText } from "./text.js";
 const SNAPSHOT_MAX_ADDITIONAL_SECTIONS = 2;
 const SNAPSHOT_FALLBACK_PREVIEW_MAX_LINES = 12;

package/dist/extensions/agent-browser/lib/results/snapshot-spill.js

@@ -1,10 +1,3 @@
-/**
- * Purpose: Persist full compacted snapshot payloads when model-facing output is shortened.
- * Responsibilities: Write persistent or secure-temp snapshot spill files and merge spill retention metadata into the session artifact manifest.
- * Scope: Snapshot spill artifact lifecycle only; preview planning and presentation text live in snapshot.ts and sibling modules.
- * Usage: Snapshot presentation calls these helpers after deciding a snapshot is too large for inline output.
- * Invariants/Assumptions: Explicit full-output paths are reported but not deleted here; retention state mirrors the backing storage scope.
- */
 import { writePersistentSessionArtifactFile, writeSecureTempFile } from "../temp.js";
 import { buildEvictedSessionArtifactEntries, formatSessionArtifactRetentionSummary, mergeSessionArtifactManifest, } from "./artifact-manifest.js";
 const SNAPSHOT_SPILL_FILE_PREFIX = "pi-agent-browser-snapshot";

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

@@ -1,10 +1,3 @@
-/**
- * Purpose: Compact large agent-browser snapshots into actionable pi-facing previews while preserving access to the raw payload when budgets allow.
- * Responsibilities: Parse the current raw snapshot text format, detect when structured parsing is trustworthy, derive primary/additional content sections, rank high-value refs, and fall back to raw-outline previews when the upstream snapshot text format is unfamiliar.
- * Scope: Snapshot-specific rendering only; generic envelope parsing, non-snapshot summaries, and image attachment live in neighboring modules.
- * Usage: Imported by the focused presentation module for snapshot content and summary rendering.
- * Invariants/Assumptions: Snapshot compaction should stay helpful even if upstream snapshot text formatting shifts, so structured parsing is best-effort and always has a resilient raw-outline fallback.
- */
 import { isRecord } from "../parsing.js";
 import { isHighValueControlEntry, selectHighValueControlEntries } from "./snapshot-high-value-controls.js";
 import { buildFallbackSnapshotOutline, buildRefLineOrderMap, buildSegmentPreview, buildSnapshotSegments, canUseStructuredSnapshotPreview, chooseAdditionalSegments, choosePrimarySegment, getMeaningfulSegmentLines, getSnapshotRolePriority, isChromeSectionName, isNoiseName, parseSnapshotLines, } from "./snapshot-segments.js";

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

@@ -1,10 +1,3 @@
-/**
- * Purpose: Hold tiny text and ref-id helpers shared by result renderers.
- * Responsibilities: Convert unknown values to text, count lines, normalize whitespace, truncate labels, and sort ref ids naturally.
- * Scope: Generic pure utilities only; no agent-browser command policy belongs here.
- * Usage: Imported by envelope, presentation, snapshot, and diagnostic helpers.
- * Invariants/Assumptions: Helpers are deterministic and side-effect free.
- */
 export function stringifyUnknown(value) {
     if (typeof value === "string")
         return value;