pi-agent-browser-native 0.2.60 → 0.2.62

package/dist/extensions/agent-browser/lib/input-modes/params.js

@@ -75,6 +75,7 @@ export function createAgentBrowserParamsSchema(Type = JsonSchema, StringEnum = l
         }, { additionalProperties: false, description: "EXPERIMENTAL: local UI-to-source candidates only (confidence/evidence, not guaranteed mappings). Compiles to batch; mutually exclusive with other input modes." })),
         networkSourceLookup: Type.Optional(Type.Object({
             filter: Type.Optional(Type.String({ description: "Optional upstream network requests filter pattern." })),
+            namespace: Type.Optional(Type.String({ description: "Optional upstream namespace; prepends --namespace <name> before the generated batch." })),
             requestId: Type.Optional(Type.String({ description: "Optional network request id to inspect with network request <id>." })),
             session: Type.Optional(Type.String({ description: "Optional upstream session name; prepends --session <name> before the generated batch." })),
             url: Type.Optional(Type.String({ description: "Optional failed request URL or URL fragment to correlate with local source." })),
@@ -135,7 +136,7 @@ export function createAgentBrowserParamsSchema(Type = JsonSchema, StringEnum = l
         outputPath: Type.Optional(Type.String({ description: "Optional workspace-relative or absolute file path that receives the model-facing command data/result after the browser command completes. Useful for eval/get/snapshot captures that should become durable local artifacts.", minLength: 1 })),
         timeoutMs: Type.Optional(Type.Integer({ description: "Optional per-call wrapper subprocess watchdog in milliseconds for browser CLI args/job/qa/source lookup calls. Use for long opens or large output captures; explicit long wait steps are forwarded, so set timeoutMs above the wait duration plus a small grace window when overriding the derived watchdog. Electron actions use electron.timeoutMs instead.", minimum: 1 })),
         sessionMode: Type.Optional(StringEnum(["auto", "fresh"], {
-            description: "Session handling mode. `auto` reuses the extension-managed pi-scoped session when possible. `fresh` switches that managed session to a fresh upstream launch so launch-scoped flags like --profile, --executable-path, --session-name, --cdp, --state, --auto-connect, --init-script, --enable, -p/--provider, or iOS --device apply and later auto calls follow the new browser.",
+            description: "Session handling mode. `auto` reuses the extension-managed pi-scoped session when possible. `fresh` switches that managed session to a fresh upstream launch so launch-scoped flags like --namespace, --restore, --restore-save, restore check flags, --profile, --executable-path, --session-name, --cdp, --state, --auto-connect, --init-script, --enable, -p/--provider, or iOS --device apply and later auto calls follow the new browser.",
             default: DEFAULT_SESSION_MODE,
         })),
     }, { additionalProperties: false });

package/dist/extensions/agent-browser/lib/launch-scoped-flags.js

@@ -8,6 +8,10 @@ export const LAUNCH_SCOPED_FLAG_DEFINITIONS = [
         flag: "--auto-connect",
         reason: "attaches to an already-running browser at launch time instead of reusing an existing named session",
     },
+    {
+        flag: "--namespace",
+        reason: "selects the upstream daemon/socket and restore-state namespace before session lookup",
+    },
     {
         flag: "--cdp",
         reason: "selects the browser/CDP endpoint used when an upstream session is launched",
@@ -44,6 +48,26 @@ export const LAUNCH_SCOPED_FLAG_DEFINITIONS = [
         flag: "--session-name",
         reason: "selects upstream saved auth/session state for the launch",
     },
+    {
+        flag: "--restore",
+        reason: "selects upstream saved auth/session restore state for the launch",
+    },
+    {
+        flag: "--restore-save",
+        reason: "configures upstream restore auto-save policy for the launched session",
+    },
+    {
+        flag: "--restore-check-url",
+        reason: "configures restore validation before the launched session can auto-save",
+    },
+    {
+        flag: "--restore-check-text",
+        reason: "configures restore validation before the launched session can auto-save",
+    },
+    {
+        flag: "--restore-check-fn",
+        reason: "configures restore validation before the launched session can auto-save",
+    },
     {
         flag: "--state",
         reason: "loads persisted upstream browser/auth state at launch time",
@@ -56,4 +80,4 @@ export const LAUNCH_SCOPED_FLAG_LABEL = LAUNCH_SCOPED_FLAGS.join(", ");
  * and are plausible wrong-active-tab sources after a fresh launch. These trigger post-open
  * tab-correction (the `tab list` + re-select cycle).
  */
-export const LAUNCH_SCOPED_TAB_CORRECTION_FLAGS = new Set(["--profile", "--session-name", "--state"]);
+export const LAUNCH_SCOPED_TAB_CORRECTION_FLAGS = new Set(["--profile", "--session-name", "--restore", "--state"]);

package/dist/extensions/agent-browser/lib/orchestration/browser-run/click-dispatch.js

@@ -43,7 +43,7 @@ function getClickDispatchProbeTarget(commandTokens, refSnapshot) {
     }
     if (selector.startsWith("xpath="))
         return { kind: "xpath", selector: selector.slice("xpath=".length) };
-    return { kind: "selector", selector };
+    return undefined;
 }
 function getEvalResultRecord(data) {
     return isRecord(data) && isRecord(data.result) ? data.result : undefined;
@@ -219,7 +219,7 @@ export async function prepareClickDispatchProbe(options) {
     if (!target)
         return undefined;
     const probe = { marker: `${CLICK_DISPATCH_MARKER_PREFIX}${Date.now().toString(36)}_${Math.random().toString(36).slice(2)}`, target };
-    const installData = await runSessionCommandData({ args: ["eval", "--stdin"], cwd: options.cwd, sessionName: options.sessionName, signal: options.signal, stdin: buildClickDispatchProbeInstallScript(probe) });
+    const installData = await runSessionCommandData({ args: ["eval", "--stdin"], cwd: options.cwd, namespace: options.namespace, sessionName: options.sessionName, signal: options.signal, stdin: buildClickDispatchProbeInstallScript(probe) });
     const installResult = getEvalResultRecord(installData);
     return installResult?.status === "installed" ? probe : undefined;
 }
@@ -241,7 +241,7 @@ function getClickDispatchScrollContainerDiagnostic(result) {
 export async function collectClickDispatchDiagnostic(options) {
     if (!options.probe || !options.sessionName)
         return undefined;
-    const data = await runSessionCommandData({ args: ["eval", "--stdin"], cwd: options.cwd, sessionName: options.sessionName, signal: options.signal, stdin: buildClickDispatchProbeCheckScript(options.probe) });
+    const data = await runSessionCommandData({ args: ["eval", "--stdin"], cwd: options.cwd, namespace: options.namespace, sessionName: options.sessionName, signal: options.signal, stdin: buildClickDispatchProbeCheckScript(options.probe) });
     const result = getEvalResultRecord(data);
     if (!result)
         return undefined;
@@ -269,6 +269,7 @@ export async function cleanupClickDispatchProbe(options) {
     await runSessionCommandData({
         args: ["eval", "--stdin"],
         cwd: options.cwd,
+        namespace: options.namespace,
         sessionName: options.sessionName,
         stdin: buildClickDispatchProbeCleanupScript(options.probe),
         timeoutMs: CLICK_DISPATCH_CLEANUP_TIMEOUT_MS,

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

@@ -18,9 +18,14 @@ export function sleepMs(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
 export async function collectNavigationSummary(options) {
+    const url = extractStringResultField(await runSessionCommandData({ args: ["get", "url"], cwd: options.cwd, namespace: options.namespace, sessionName: options.sessionName, signal: options.signal }), "url");
+    const title = extractStringResultField(await runSessionCommandData({ args: ["get", "title"], cwd: options.cwd, namespace: options.namespace, sessionName: options.sessionName, signal: options.signal }), "title");
+    if (url && /^[a-z][a-z0-9+.-]*:/i.test(url))
+        return { title, url };
     return extractNavigationSummaryFromData(await runSessionCommandData({
         args: ["eval", "--stdin"],
         cwd: options.cwd,
+        namespace: options.namespace,
         sessionName: options.sessionName,
         signal: options.signal,
         stdin: `({ title: document.title, url: location.href })`,
@@ -74,7 +79,7 @@ const SCROLL_POSITION_EVAL = `(() => {
   return { ...viewport, containerCount: containers.length, containers };
 })()`;
 export async function collectScrollPositionSnapshot(options) {
-    return extractScrollPositionSnapshot(await runSessionCommandData({ args: ["eval", "--stdin"], cwd: options.cwd, sessionName: options.sessionName, signal: options.signal, stdin: SCROLL_POSITION_EVAL }));
+    return extractScrollPositionSnapshot(await runSessionCommandData({ args: ["eval", "--stdin"], cwd: options.cwd, namespace: options.namespace, sessionName: options.sessionName, signal: options.signal, stdin: SCROLL_POSITION_EVAL }));
 }
 function sameScrollPositionSnapshot(left, right) {
     return left.scrollX === right.scrollX && left.scrollY === right.scrollY && left.scrollHeight === right.scrollHeight && left.scrollWidth === right.scrollWidth && left.containers.length === right.containers.length && left.containers.every((container, index) => {
@@ -173,7 +178,7 @@ function isComboboxFocusDiagnosticSemanticAction(compiled) {
 export async function collectComboboxFocusDiagnostic(options) {
     if (!isComboboxFocusDiagnosticCommand(options.command, options.commandTokens) && !isComboboxFocusDiagnosticSemanticAction(options.semanticAction))
         return undefined;
-    return extractComboboxFocusDiagnostic(await runSessionCommandData({ args: ["eval", "--stdin"], cwd: options.cwd, sessionName: options.sessionName, signal: options.signal, stdin: COMBOBOX_FOCUS_EVAL }));
+    return extractComboboxFocusDiagnostic(await runSessionCommandData({ args: ["eval", "--stdin"], cwd: options.cwd, namespace: options.namespace, sessionName: options.sessionName, signal: options.signal, stdin: COMBOBOX_FOCUS_EVAL }));
 }
 export function buildComboboxFocusNextActions(sessionName) {
     return [
@@ -257,11 +262,13 @@ export function collectSnapshotOverlayBlockerDiagnostic(data) {
 export async function collectOverlayBlockerDiagnostic(options) {
     if (options.command !== "click" || !isRecord(options.data) || typeof options.data.clicked !== "string")
         return undefined;
+    if (!options.data.clicked.startsWith("@") && !options.data.clicked.startsWith("ref="))
+        return undefined;
     const priorUrl = normalizeComparableUrl(options.priorTarget?.url);
     const currentUrl = normalizeComparableUrl(options.navigationSummary?.url);
-    if (!priorUrl || !currentUrl || priorUrl !== currentUrl)
+    if (!priorUrl || !currentUrl || currentUrl !== priorUrl)
         return undefined;
-    const snapshotData = await runSessionCommandData({ args: ["snapshot", "-i"], cwd: options.cwd, sessionName: options.sessionName, signal: options.signal });
+    const snapshotData = await runSessionCommandData({ args: ["snapshot", "-i"], cwd: options.cwd, namespace: options.namespace, sessionName: options.sessionName, signal: options.signal });
     const diagnostic = collectSnapshotOverlayBlockerDiagnostic(snapshotData);
     if (!diagnostic)
         return undefined;
@@ -314,9 +321,9 @@ function selectorMayExposeSensitiveLiteral(selector) {
 }
 async function collectSelectorTextVisibilityDiagnosticForSelector(options) {
     const { selector } = options;
-    if (!selector || /^@e\d+$/.test(selector) || selectorMayExposeSensitiveLiteral(selector))
+    if (!selector || /^@e\d+$/.test(selector) || /^#[A-Za-z_][\w-]*$/.test(selector) || selectorMayExposeSensitiveLiteral(selector))
         return undefined;
-    const probe = await runSessionCommandData({ args: ["eval", "--stdin"], cwd: options.cwd, sessionName: options.sessionName, signal: options.signal, stdin: buildVisibleTextProbeScript(selector) });
+    const probe = await runSessionCommandData({ args: ["eval", "--stdin"], cwd: options.cwd, namespace: options.namespace, sessionName: options.sessionName, signal: options.signal, stdin: buildVisibleTextProbeScript(selector) });
     const parsed = parseSelectorTextVisibilityProbe(probe, selector);
     if (!parsed || parsed.matchCount <= 1 && parsed.firstMatchVisible !== false)
         return undefined;
@@ -348,7 +355,7 @@ export async function collectSelectorTextVisibilityDiagnostics(options) {
     const selectors = getSuccessfulGetTextSelectors(options);
     const diagnostics = [];
     for (const selector of selectors) {
-        const diagnostic = await collectSelectorTextVisibilityDiagnosticForSelector({ cwd: options.cwd, selector, sessionName: options.sessionName, signal: options.signal });
+        const diagnostic = await collectSelectorTextVisibilityDiagnosticForSelector({ cwd: options.cwd, namespace: options.namespace, selector, sessionName: options.sessionName, signal: options.signal });
         if (diagnostic)
             diagnostics.push(diagnostic);
     }
@@ -510,6 +517,7 @@ async function collectElectronManagedSessionUrl(options) {
     const urlResult = await collectManagedSessionCommandData({
         args: ["get", "url"],
         cwd: options.cwd,
+        namespace: options.namespace,
         sessionName: options.sessionName,
         signal: options.signal,
         timeoutMs: options.timeoutMs,
@@ -521,8 +529,8 @@ export async function collectElectronManagedSessionTarget(options) {
     if (!options.sessionName)
         return undefined;
     const [titleResult, urlResult] = await Promise.all([
-        collectManagedSessionCommandData({ args: ["get", "title"], cwd: options.cwd, sessionName: options.sessionName, signal: options.signal, timeoutMs: options.timeoutMs }),
-        collectManagedSessionCommandData({ args: ["get", "url"], cwd: options.cwd, sessionName: options.sessionName, signal: options.signal, timeoutMs: options.timeoutMs }),
+        collectManagedSessionCommandData({ args: ["get", "title"], cwd: options.cwd, namespace: options.namespace, sessionName: options.sessionName, signal: options.signal, timeoutMs: options.timeoutMs }),
+        collectManagedSessionCommandData({ args: ["get", "url"], cwd: options.cwd, namespace: options.namespace, sessionName: options.sessionName, signal: options.signal, timeoutMs: options.timeoutMs }),
     ]);
     const title = boundElectronProbeString(extractStringResultField(titleResult.data, "result") ?? extractStringResultField(titleResult.data, "title"), 160);
     const url = boundElectronProbeString(extractStringResultField(urlResult.data, "result") ?? extractStringResultField(urlResult.data, "url"), 300);
@@ -534,7 +542,7 @@ export async function collectQaAttachedTarget(options) {
         return undefined;
     if (options.currentTarget?.title || options.currentTarget?.url)
         return { sessionName: options.sessionName, title: options.currentTarget.title, url: options.currentTarget.url };
-    return collectElectronManagedSessionTarget({ cwd: options.cwd, sessionName: options.sessionName, signal: options.signal });
+    return collectElectronManagedSessionTarget({ cwd: options.cwd, namespace: options.namespace, sessionName: options.sessionName, signal: options.signal });
 }
 export function formatQaAttachedTargetText(target) {
     if (!target)
@@ -565,7 +573,7 @@ export async function validateQaAttachedPrecondition(options) {
             nextActions: buildQaAttachedRecoveryNextActions(options.sessionName),
         };
     }
-    const urlProbe = await collectElectronManagedSessionUrl({ cwd: options.cwd, sessionName: options.sessionName, signal: options.signal });
+    const urlProbe = await collectElectronManagedSessionUrl({ cwd: options.cwd, namespace: options.namespace, sessionName: options.sessionName, signal: options.signal });
     if (urlProbe.error) {
         return {
             error: `qa.attached could not read the attached session URL: ${urlProbe.error}. Run tab list or snapshot -i before retrying qa.attached.`,
@@ -630,7 +638,7 @@ export async function collectFillVerificationDiagnostic(options) {
     const method = contenteditable ? "text" : "value";
     let valueData;
     try {
-        valueData = await runSessionCommandData({ args: ["get", method, fill.selector], cwd: options.cwd, sessionName: options.sessionName, signal: options.signal, timeoutMs: ELECTRON_FILL_VERIFICATION_TIMEOUT_MS });
+        valueData = await runSessionCommandData({ args: ["get", method, fill.selector], cwd: options.cwd, namespace: options.namespace, sessionName: options.sessionName, signal: options.signal, timeoutMs: ELECTRON_FILL_VERIFICATION_TIMEOUT_MS });
     }
     catch {
         return undefined;
@@ -659,22 +667,22 @@ export async function collectVisibleRefFallbackDiagnostic(options) {
     const target = getVisibleRefFallbackTarget({ commandTokens: options.commandTokens, compiledSemanticAction: options.compiledSemanticAction });
     if (!target)
         return undefined;
-    const snapshotData = await runSessionCommandData({ args: ["snapshot", "-i"], cwd: options.cwd, sessionName: options.sessionName, signal: options.signal });
+    const snapshotData = await runSessionCommandData({ args: ["snapshot", "-i"], cwd: options.cwd, namespace: options.namespace, sessionName: options.sessionName, signal: options.signal });
     return buildVisibleRefFallbackDiagnosticFromSnapshot({ snapshotData, target });
 }
 export async function collectElectronHandoff(options) {
     if (options.handoff === "connect")
         return { handoff: "connect" };
-    const tabs = await runSessionCommandData({ args: ["tab", "list"], cwd: options.cwd, sessionName: options.sessionName, signal: options.signal });
+    const tabs = await runSessionCommandData({ args: ["tab", "list"], cwd: options.cwd, namespace: options.namespace, sessionName: options.sessionName, signal: options.signal });
     if (options.handoff === "tabs")
         return { handoff: "tabs", tabs };
-    let snapshot = await runSessionCommandData({ args: ["snapshot", "-i"], cwd: options.cwd, sessionName: options.sessionName, signal: options.signal });
+    let snapshot = await runSessionCommandData({ args: ["snapshot", "-i"], cwd: options.cwd, namespace: options.namespace, sessionName: options.sessionName, signal: options.signal });
     let refSnapshot = extractRefSnapshotFromData(snapshot);
     let snapshotRetryCount = 0;
     while ((!refSnapshot || refSnapshot.refIds.length === 0) && snapshotRetryCount < 2) {
         snapshotRetryCount += 1;
         await sleepMs(250);
-        snapshot = await runSessionCommandData({ args: ["snapshot", "-i"], cwd: options.cwd, sessionName: options.sessionName, signal: options.signal });
+        snapshot = await runSessionCommandData({ args: ["snapshot", "-i"], cwd: options.cwd, namespace: options.namespace, sessionName: options.sessionName, signal: options.signal });
         refSnapshot = extractRefSnapshotFromData(snapshot);
     }
     return { handoff: "snapshot", refSnapshot, snapshot, ...(snapshotRetryCount > 0 ? { snapshotRetryCount } : {}), tabs };
@@ -849,7 +857,7 @@ function buildTimeoutProgressSteps(options) {
 export async function collectTimeoutPartialProgress(options) {
     const rawSteps = getTimeoutProgressSteps(options.compiledJob, options.command, options.stdin);
     const artifacts = await collectTimeoutArtifactEvidence(options.cwd, rawSteps);
-    const [urlData, titleData] = await Promise.all([runSessionCommandData({ args: ["get", "url"], cwd: options.cwd, sessionName: options.sessionName }), runSessionCommandData({ args: ["get", "title"], cwd: options.cwd, sessionName: options.sessionName })]);
+    const [urlData, titleData] = await Promise.all([runSessionCommandData({ args: ["get", "url"], cwd: options.cwd, namespace: options.namespace, sessionName: options.sessionName }), runSessionCommandData({ args: ["get", "title"], cwd: options.cwd, namespace: options.namespace, sessionName: options.sessionName })]);
     const recoveredUrl = extractStringResultField(urlData, "result") ?? extractStringResultField(urlData, "url");
     const title = extractStringResultField(titleData, "result") ?? extractStringResultField(titleData, "title");
     const plannedUrl = recoveredUrl ? undefined : getPlannedCurrentPageUrl(rawSteps);

package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result.js

@@ -2,7 +2,7 @@ import { cleanupElectronLaunchResources } from "../../electron/cleanup.js";
 import { getCompiledSemanticActionCommandIndex, getCompiledSemanticActionSessionPrefix, isCompiledSemanticActionFindCommand, redactNetworkSourceLookupSurface, } from "../../input-modes.js";
 import { buildAgentBrowserNextActions, buildAgentBrowserResultCategoryDetails, } from "../../results.js";
 import { formatSessionArtifactRetentionSummary } from "../../results/artifact-manifest.js";
-import { AgentBrowserNextActionCollector, alignPageChangeSummaryNextActionIds, isStandaloneSnapshotNextAction, withOptionalSessionArgs, } from "../../results/next-actions.js";
+import { AgentBrowserNextActionCollector, alignPageChangeSummaryNextActionIds, applyNamespaceToNextActions, isStandaloneSnapshotNextAction, withOptionalSessionArgs, } from "../../results/next-actions.js";
 import { buildConnectedSessionNextActions, buildNoActivePageNextActions, buildSessionAwareStaleRefNextActions, buildSessionTabRecoveryNextActions, } from "../../results/recovery-next-actions.js";
 import { buildRichInputRecoveryDiagnostic, buildRichInputRecoveryNextActions, buildVisibleRefFallbackNextActions, formatRichInputRecoveryText, formatVisibleRefFallbackText, sanitizeVisibleRefFallbackDiagnostic, } from "../../results/selector-recovery.js";
 import { buildNoActivePageRefSnapshotInvalidation, isNoActivePageSnapshotFailure, } from "../../session-page-state.js";
@@ -10,7 +10,7 @@ import { extractExplicitSessionName, redactInvocationArgs, redactSensitiveText,
 import { isRecord } from "../../parsing.js";
 import { buildClickDispatchNextActions, formatClickDispatchDiagnosticText } from "./click-dispatch.js";
 import { buildComboboxFocusNextActions, buildElectronBroadGetTextScopeNextActions, buildFillVerificationNextActions, buildOverlayBlockerNextActions, buildScrollNoopNextActions, buildSelectorTextVisibilityNextActions, buildSourceLookupElectronNextActions, collectVisibleRefFallbackDiagnostic, formatArtifactCleanupGuidanceText, formatComboboxFocusDiagnosticText, formatElectronBroadGetTextScopeText, formatEvalResultWarningText, formatEvalStdinHintText, formatFillVerificationText, formatOverlayBlockerText, formatRecordingDependencyWarningText, formatScrollNoopDiagnosticText, formatSelectorTextVisibilityText, formatTimeoutPartialProgressText, } from "./diagnostics.js";
-import { buildElectronIdentifiers, buildElectronLifecycleNextActions, buildElectronMismatchNextActions, buildElectronRefFreshnessNextActions, buildManagedSessionFreshFailureNextActions, buildManagedSessionOutcome, buildSessionDetailFields, formatElectronRefFreshnessText, formatManagedSessionOutcomeText, } from "./session-state.js";
+import { buildElectronIdentifiers, buildElectronLifecycleNextActions, buildElectronMismatchNextActions, buildElectronRefFreshnessNextActions, buildManagedSessionFreshFailureNextActions, buildManagedSessionOutcome, buildSessionDetailFields, getSessionContextKey, formatElectronRefFreshnessText, formatManagedSessionOutcomeText, } from "./session-state.js";
 export function buildMissingBinaryMessage() {
     return [
         "agent-browser is required but was not found on PATH.",
@@ -180,17 +180,19 @@ export async function prepareFinalResultRecoveryState(options) {
     const visibleRefFallbackSessionName = options.executionPlan.sessionName ?? extractExplicitSessionName(options.runtimeToolArgs);
     if (categoryDetails.failureCategory === "selector-not-found") {
         const selectorRecoveryCommandTokens = options.presentation.batchFailure?.failedStep.command ?? options.commandTokens;
-        visibleRefFallbackDiagnostic = await collectVisibleRefFallbackDiagnostic({ commandTokens: selectorRecoveryCommandTokens, compiledSemanticAction: options.compiledSemanticAction, cwd: options.cwd, sessionName: visibleRefFallbackSessionName, signal: options.signal });
-        if (visibleRefFallbackDiagnostic && visibleRefFallbackSessionName) {
-            const refUpdate = options.sessionPageState.applyRefSnapshot({ fallbackTarget: options.currentSessionTabTarget, sessionName: visibleRefFallbackSessionName, snapshot: visibleRefFallbackDiagnostic.snapshot, update: options.sessionPageStateUpdate });
+        visibleRefFallbackDiagnostic = await collectVisibleRefFallbackDiagnostic({ commandTokens: selectorRecoveryCommandTokens, compiledSemanticAction: options.compiledSemanticAction, cwd: options.cwd, namespace: options.executionPlan.namespace, sessionName: visibleRefFallbackSessionName, signal: options.signal });
+        const visibleRefFallbackSessionKey = getSessionContextKey(visibleRefFallbackSessionName, options.executionPlan.namespace);
+        if (visibleRefFallbackDiagnostic && visibleRefFallbackSessionKey) {
+            const refUpdate = options.sessionPageState.applyRefSnapshot({ fallbackTarget: options.currentSessionTabTarget, sessionName: visibleRefFallbackSessionKey, snapshot: visibleRefFallbackDiagnostic.snapshot, update: options.sessionPageStateUpdate });
             currentRefSnapshot = refUpdate.refSnapshot;
             currentRefSnapshotInvalidation = refUpdate.refSnapshotInvalidation;
         }
     }
     const richInputRecoveryDiagnostic = buildRichInputRecoveryDiagnostic(visibleRefFallbackDiagnostic);
     const noActivePageSnapshotFailure = categoryDetails.resultCategory === "failure" && (isNoActivePageSnapshotFailure(options.executionPlan.commandInfo.command, options.errorText ?? options.presentation.summary) || options.batchRefSnapshotState?.invalidation !== undefined);
-    if (noActivePageSnapshotFailure && options.executionPlan.sessionName) {
-        const refUpdate = options.sessionPageState.applyRefSnapshotInvalidation({ invalidation: buildNoActivePageRefSnapshotInvalidation(), sessionName: options.executionPlan.sessionName, update: options.sessionPageStateUpdate });
+    const executionSessionKey = getSessionContextKey(options.executionPlan.sessionName, options.executionPlan.namespace);
+    if (noActivePageSnapshotFailure && executionSessionKey) {
+        const refUpdate = options.sessionPageState.applyRefSnapshotInvalidation({ invalidation: buildNoActivePageRefSnapshotInvalidation(), sessionName: executionSessionKey, update: options.sessionPageStateUpdate });
         currentRefSnapshot = refUpdate.refSnapshot;
         currentRefSnapshotInvalidation = refUpdate.refSnapshotInvalidation;
     }
@@ -385,6 +387,7 @@ function buildAgentBrowserResultDetails(options, nextActions) {
         sessionTabTarget: options.currentSessionTabTarget,
         refSnapshot: options.currentRefSnapshot,
         refSnapshotInvalidation: options.currentRefSnapshotInvalidation,
+        namespace: options.executionPlan.namespace,
         ...buildSessionDetailFields(options.executionPlan.sessionName, options.executionPlan.usedImplicitSession),
         sessionRecoveryHint: options.redactedRecoveryHint,
         startupScopedFlags: options.executionPlan.startupScopedFlags,
@@ -396,7 +399,7 @@ function buildAgentBrowserResultDetails(options, nextActions) {
     };
 }
 export function buildFinalAgentBrowserToolResult(options) {
-    const nextActions = buildResultNextActions(options);
+    const nextActions = applyNamespaceToNextActions(buildResultNextActions(options), options.executionPlan.namespace);
     const details = buildAgentBrowserResultDetails(options, nextActions);
     const visibleRefFallbackText = formatVisibleRefFallbackText(options.visibleRefFallbackDiagnostic);
     const richInputRecoveryText = formatRichInputRecoveryText(options.richInputRecoveryDiagnostic);
@@ -429,9 +432,9 @@ export async function buildMissingBinaryFailureResult(options) {
     if (!options.processResult.spawnError?.message.includes("ENOENT"))
         return undefined;
     const errorText = buildMissingBinaryMessage();
-    const managedSessionOutcome = buildManagedSessionOutcome({ activeAfter: options.managedSessionActive, activeBefore: options.managedSessionActive, attemptedSessionName: options.executionPlan.managedSessionName, command: options.executionPlan.commandInfo.command, currentSessionName: options.managedSessionName, previousSessionName: options.managedSessionName, sessionMode: options.sessionMode, succeeded: false });
+    const managedSessionOutcome = buildManagedSessionOutcome({ activeAfter: options.managedSessionActive, activeBefore: options.managedSessionActive, attemptedSessionName: options.executionPlan.managedSessionName, command: options.executionPlan.commandInfo.command, currentSessionName: options.managedSessionName, currentSessionNamespace: options.managedSessionNamespace, previousSessionName: options.managedSessionName, sessionMode: options.sessionMode, succeeded: false });
     const managedSessionOutcomeText = formatManagedSessionOutcomeText(managedSessionOutcome);
-    const managedSessionRecoveryNextActions = buildManagedSessionFreshFailureNextActions(managedSessionOutcome);
+    const managedSessionRecoveryNextActions = applyNamespaceToNextActions(buildManagedSessionFreshFailureNextActions(managedSessionOutcome), options.executionPlan.namespace) ?? [];
     let missingBinaryElectronCleanup;
     let missingBinaryElectronRecord;
     if (options.electronLaunch) {
@@ -439,5 +442,5 @@ export async function buildMissingBinaryFailureResult(options) {
         missingBinaryElectronRecord = missingBinaryElectronCleanup.record;
     }
     const textParts = [errorText, managedSessionOutcomeText, missingBinaryElectronCleanup ? `Electron cleanup after failed attach: ${missingBinaryElectronCleanup.summary}` : undefined].filter((part) => part !== undefined && part.length > 0);
-    return { content: [{ type: "text", text: textParts.join("\n\n") }], details: { args: options.redactedArgs, compatibilityWorkaround: options.compatibilityWorkaround, effectiveArgs: options.redactedProcessArgs, electron: missingBinaryElectronRecord ? { action: "launch", cleanup: missingBinaryElectronCleanup, launch: missingBinaryElectronRecord, status: "failed", targets: options.electronLaunch?.targets, version: options.electronLaunch?.version } : undefined, managedSessionOutcome, nextActions: managedSessionRecoveryNextActions.length > 0 ? managedSessionRecoveryNextActions : undefined, sessionMode: options.sessionMode, sessionTabCorrection: options.sessionTabCorrection, ...buildAgentBrowserResultCategoryDetails({ args: options.redactedProcessArgs, command: options.executionPlan.commandInfo.command, errorText, failureCategory: "missing-binary", spawnError: options.processResult.spawnError.message, succeeded: false }), spawnError: options.processResult.spawnError.message }, isError: true };
+    return { content: [{ type: "text", text: textParts.join("\n\n") }], details: { args: options.redactedArgs, compatibilityWorkaround: options.compatibilityWorkaround, effectiveArgs: options.redactedProcessArgs, electron: missingBinaryElectronRecord ? { action: "launch", cleanup: missingBinaryElectronCleanup, launch: missingBinaryElectronRecord, status: "failed", targets: options.electronLaunch?.targets, version: options.electronLaunch?.version } : undefined, managedSessionOutcome, namespace: options.executionPlan.namespace, nextActions: managedSessionRecoveryNextActions.length > 0 ? managedSessionRecoveryNextActions : undefined, sessionMode: options.sessionMode, sessionTabCorrection: options.sessionTabCorrection, ...buildAgentBrowserResultCategoryDetails({ args: options.redactedProcessArgs, command: options.executionPlan.commandInfo.command, errorText, failureCategory: "missing-binary", spawnError: options.processResult.spawnError.message, succeeded: false }), spawnError: options.processResult.spawnError.message }, isError: true };
 }

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

@@ -4,7 +4,7 @@ import { applyBrowserRunStatePatch } from "./session-state.js";
 import { buildMissingBinaryFailureResult } from "./final-result.js";
 import { prepareBrowserRun } from "./prepare.js";
 import { processBrowserOutput } from "./process-output.js";
-export { closeManagedSession } from "./session-state.js";
+export { closeManagedSession, getSessionContextKey } from "./session-state.js";
 export async function runAgentBrowserTool(options) {
     const preparedResult = await prepareBrowserRun(options);
     applyBrowserRunStatePatch(options.state, preparedResult.kind === "ready" ? preparedResult.prepared.statePatch : preparedResult.statePatch);
@@ -28,6 +28,7 @@ export async function runAgentBrowserTool(options) {
             implicitSessionCloseTimeoutMs: options.implicitSessionCloseTimeoutMs,
             managedSessionActive: options.state.managedSessionActive,
             managedSessionName: options.state.managedSessionName,
+            managedSessionNamespace: options.state.managedSessionNamespace,
             processResult,
             redactedArgs: prepared.redactedArgs,
             redactedProcessArgs: prepared.redactedProcessArgs,
@@ -42,6 +43,6 @@ export async function runAgentBrowserTool(options) {
         return output.result;
     }
     finally {
-        await cleanupClickDispatchProbe({ cwd: options.cwd, probe: prepared.clickDispatchProbe, sessionName: prepared.executionPlan.sessionName });
+        await cleanupClickDispatchProbe({ cwd: options.cwd, namespace: prepared.executionPlan.namespace, probe: prepared.clickDispatchProbe, sessionName: prepared.executionPlan.sessionName });
     }
 }

package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/direct-anchor-download.js

@@ -29,6 +29,7 @@ export async function tryDirectAnchorDownload(options) {
         const probeData = await runSessionCommandData({
             args: ["eval", "--stdin"],
             cwd: options.cwd,
+            namespace: options.namespace,
             sessionName: options.sessionName,
             signal: options.signal,
             stdin: buildAnchorDownloadProbe(request.selector),
@@ -128,7 +129,7 @@ export async function tryDirectAnchorDownload(options) {
                     savedFilePath: absolutePath,
                     sessionMode: options.sessionMode,
                     ...buildAgentBrowserResultCategoryDetails({ artifacts: [artifact], args: options.effectiveArgs, command: "download", savedFile, succeeded: true }),
-                    ...buildSessionDetailFields(options.sessionName, options.usedImplicitSession),
+                    ...buildSessionDetailFields(options.sessionName, options.usedImplicitSession, options.namespace),
                     summary: `Download completed: ${absolutePath}`,
                 },
                 isError: false,

package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/network-page-filter.js

@@ -79,10 +79,10 @@ export async function tryNetworkRequestsPageFilter(options) {
     const request = parseNetworkRequestsPageFilterRequest(options.commandTokens);
     if (!request || !options.sessionName)
         return undefined;
-    const currentUrl = extractCurrentUrl(await runSessionCommandData({ args: ["get", "url"], cwd: options.cwd, sessionName: options.sessionName, signal: options.signal }));
+    const currentUrl = extractCurrentUrl(await runSessionCommandData({ args: ["get", "url"], cwd: options.cwd, namespace: options.namespace, sessionName: options.sessionName, signal: options.signal }));
     if (!currentUrl)
         return undefined;
-    const networkData = await runSessionCommandData({ args: request.cleanArgs, cwd: options.cwd, sessionName: options.sessionName, signal: options.signal });
+    const networkData = await runSessionCommandData({ args: request.cleanArgs, cwd: options.cwd, namespace: options.namespace, sessionName: options.sessionName, signal: options.signal });
     const filtered = filterNetworkRequestsData(networkData, currentUrl, request);
     if (!filtered)
         return undefined;
@@ -100,7 +100,7 @@ export async function tryNetworkRequestsPageFilter(options) {
             networkRequestsPageFilter: { cleanArgs: request.cleanArgs, currentUrl: redactSensitiveText(currentUrl), matchedRows: filtered.matchedRows, mode: request.mode, totalRows: filtered.totalRows },
             sessionMode: options.sessionMode,
             ...buildAgentBrowserResultCategoryDetails({ args: options.effectiveArgs, command: "network", succeeded: true }),
-            ...buildSessionDetailFields(options.sessionName, options.usedImplicitSession),
+            ...buildSessionDetailFields(options.sessionName, options.usedImplicitSession, options.namespace),
             summary,
         },
         isError: false,

package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/scroll-shims.js

@@ -1,5 +1,6 @@
 import { isRecord } from "../../../parsing.js";
 import { buildAgentBrowserResultCategoryDetails } from "../../../results.js";
+import { applyNamespaceToNextActions } from "../../../results/next-actions.js";
 import { buildScrollNoopNextActions } from "../diagnostics.js";
 import { buildSessionDetailFields, runSessionCommandData } from "../session-state.js";
 const SCROLL_CONTAINER_DIRECTIONS = new Set(["down", "left", "right", "up"]);
@@ -52,11 +53,11 @@ function buildScrollResult(options) {
             compatibilityWorkaround: options.compatibilityWorkaround,
             data: options.result,
             effectiveArgs: options.effectiveArgs,
-            nextActions: options.succeeded ? undefined : buildScrollNoopNextActions(options.sessionName),
+            nextActions: options.succeeded ? undefined : applyNamespaceToNextActions(buildScrollNoopNextActions(options.sessionName), options.namespace),
             [options.scrollField]: options.scrollValue,
             sessionMode: options.sessionMode,
             ...buildAgentBrowserResultCategoryDetails({ args: options.effectiveArgs, command: options.command, errorText: options.succeeded ? undefined : options.message, succeeded: options.succeeded, validationError: options.succeeded ? undefined : options.message }),
-            ...buildSessionDetailFields(options.sessionName, options.usedImplicitSession),
+            ...buildSessionDetailFields(options.sessionName, options.usedImplicitSession, options.namespace),
             summary: options.message,
             validationError: options.succeeded ? undefined : options.message,
         },
@@ -67,7 +68,7 @@ export async function tryContainerScroll(options) {
     const request = getContainerScrollRequest(options.commandTokens);
     if (!request || !options.sessionName)
         return undefined;
-    const data = await runSessionCommandData({ args: ["eval", "--stdin"], cwd: options.cwd, sessionName: options.sessionName, signal: options.signal, stdin: buildContainerScrollScript(request) });
+    const data = await runSessionCommandData({ args: ["eval", "--stdin"], cwd: options.cwd, namespace: options.namespace, sessionName: options.sessionName, signal: options.signal, stdin: buildContainerScrollScript(request) });
     const result = isRecord(data) && isRecord(data.result) ? data.result : data;
     if (!isRecord(result) || typeof result.status !== "string")
         return undefined;
@@ -102,7 +103,7 @@ export async function tryPageScrollTo(options) {
     const request = getPageScrollToRequest(options.commandTokens);
     if (!request || !options.sessionName)
         return undefined;
-    const data = await runSessionCommandData({ args: ["eval", "--stdin"], cwd: options.cwd, sessionName: options.sessionName, signal: options.signal, stdin: buildPageScrollToScript(request) });
+    const data = await runSessionCommandData({ args: ["eval", "--stdin"], cwd: options.cwd, namespace: options.namespace, sessionName: options.sessionName, signal: options.signal, stdin: buildPageScrollToScript(request) });
     const result = isRecord(data) && isRecord(data.result) ? data.result : data;
     if (!isRecord(result) || typeof result.status !== "string")
         return undefined;

package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/snapshot-filter.js

@@ -109,15 +109,15 @@ export async function trySnapshotFilter(options) {
     const request = parseSnapshotFilterRequest(options.commandTokens);
     if (!request || !options.sessionName)
         return undefined;
-    const snapshotData = await runSessionCommandData({ args: request.cleanArgs, cwd: options.cwd, sessionName: options.sessionName, signal: options.signal });
+    const snapshotData = await runSessionCommandData({ args: request.cleanArgs, cwd: options.cwd, namespace: options.namespace, sessionName: options.sessionName, signal: options.signal });
     const filtered = request.role || request.search ? filterSnapshotData(snapshotData, request) : isRecord(snapshotData) ? { data: snapshotData, matchedRefs: isRecord(snapshotData.refs) ? Object.keys(snapshotData.refs).length : 0, totalLines: typeof snapshotData.snapshot === "string" ? snapshotData.snapshot.split(/\r?\n/).filter((line) => line.length > 0).length : 0, totalRefs: isRecord(snapshotData.refs) ? Object.keys(snapshotData.refs).length : 0, visibleLines: typeof snapshotData.snapshot === "string" ? snapshotData.snapshot.split(/\r?\n/).filter((line) => line.length > 0).length : 0 } : undefined;
     if (!filtered)
         return undefined;
-    const viewport = request.viewport ? await collectScrollPositionSnapshot({ cwd: options.cwd, sessionName: options.sessionName, signal: options.signal }) : undefined;
+    const viewport = request.viewport ? await collectScrollPositionSnapshot({ cwd: options.cwd, namespace: options.namespace, sessionName: options.sessionName, signal: options.signal }) : undefined;
     const fullSnapshot = extractRefSnapshotFromData(snapshotData);
     const diff = request.diff ? buildSnapshotDiff(options.previousRefSnapshot, fullSnapshot) : undefined;
     if (fullSnapshot)
-        options.sessionPageState.applyRefSnapshot({ sessionName: options.sessionName, snapshot: fullSnapshot, update: options.sessionPageStateUpdate });
+        options.sessionPageState.applyRefSnapshot({ sessionName: options.sessionStateKey ?? options.sessionName, snapshot: fullSnapshot, update: options.sessionPageStateUpdate });
     const presentation = await buildSnapshotPresentation(filtered.data, options.persistentArtifactStore, options.artifactManifest);
     const summary = request.role || request.search
         ? `Snapshot filter: ${filtered.matchedRefs}/${filtered.totalRefs} direct refs matched${request.role ? ` role=${request.role}` : ""}${request.search ? ` search ${JSON.stringify(request.search)}` : ""}; ${filtered.visibleLines} surrounding snapshot line${filtered.visibleLines === 1 ? "" : "s"} shown.`
@@ -149,7 +149,7 @@ export async function trySnapshotFilter(options) {
                 snapshotFilter: request.role || request.search ? { cleanArgs: request.cleanArgs, matchedRefs: filtered.matchedRefs, role: request.role, search: request.search, totalLines: filtered.totalLines, totalRefs: filtered.totalRefs, visibleLines: filtered.visibleLines } : undefined,
                 snapshotViewport: viewport,
                 ...buildAgentBrowserResultCategoryDetails({ args: options.effectiveArgs, command: "snapshot", succeeded: true }),
-                ...buildSessionDetailFields(options.sessionName, options.usedImplicitSession),
+                ...buildSessionDetailFields(options.sessionName, options.usedImplicitSession, options.namespace),
                 summary,
             },
             isError: false,