@nuanu-ai/agentbrowse 0.2.24 → 0.2.26

package/dist/commands/action-result-resolution.d.ts

@@ -1,5 +1,5 @@
 import { type AcceptanceProbe, type PageObservation } from './action-acceptance.js';
-export type SubmitResultClaimKind = 'hard_result' | 'hard_blocker' | 'soft_result_candidate' | 'noisy_change';
+export type SubmitResultClaimKind = 'hard_result' | 'hard_blocker' | 'intermediate_progress' | 'soft_result_candidate' | 'noisy_change';
 export type SubmitResultClaim = {
     kind: SubmitResultClaimKind;
     source: string;
@@ -7,7 +7,7 @@ export type SubmitResultClaim = {
     ownerScopeRef?: string;
 };
 export type SubmitResultResolution = {
-    finalVerdict: 'outcome' | 'blocked' | 'none';
+    finalVerdict: 'outcome' | 'blocked' | 'progress' | 'none';
     claims: SubmitResultClaim[];
     decisiveClaims: SubmitResultClaim[];
     acceptAsProgress: boolean;

package/dist/commands/action-result-resolution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action-result-resolution.d.ts","sourceRoot":"","sources":["../../src/commands/action-result-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAC;AAGhC,MAAM,MAAM,qBAAqB,GAC7B,aAAa,GACb,cAAc,GACd,uBAAuB,GACvB,cAAc,CAAC;AAEnB,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,qBAAqB,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,YAAY,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IAC7C,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,cAAc,EAAE,iBAAiB,EAAE,CAAC;IACpC,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,aAAa,CAAC,iBAAiB,CAAC,GACvC,IAAI,CAAC,sBAAsB,EAAE,QAAQ,GAAG,kBAAkB,CAAC,CAqB7D;AAmBD,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,eAAe,EACtB,oBAAoB,EAAE,eAAe,GAAG,IAAI,GAC3C,OAAO,CAAC,sBAAsB,CAAC,CAsEjC"}
+{"version":3,"file":"action-result-resolution.d.ts","sourceRoot":"","sources":["../../src/commands/action-result-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAC;AAGhC,MAAM,MAAM,qBAAqB,GAC7B,aAAa,GACb,cAAc,GACd,uBAAuB,GACvB,uBAAuB,GACvB,cAAc,CAAC;AAEnB,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,qBAAqB,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,YAAY,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IAC1D,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,cAAc,EAAE,iBAAiB,EAAE,CAAC;IACpC,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,aAAa,CAAC,iBAAiB,CAAC,GACvC,IAAI,CAAC,sBAAsB,EAAE,QAAQ,GAAG,kBAAkB,CAAC,CA+B7D;AAmBD,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,eAAe,EACtB,oBAAoB,EAAE,eAAe,GAAG,IAAI,GAC3C,OAAO,CAAC,sBAAsB,CAAC,CAoFjC"}

package/dist/commands/action-result-resolution.js

@@ -15,6 +15,13 @@ export function reduceSubmitResultClaims(claims) {
             decisiveClaims: hardResults,
         };
     }
+    const intermediateProgressClaims = claims.filter((claim) => claim.kind === 'intermediate_progress');
+    if (intermediateProgressClaims.length > 0) {
+        return {
+            finalVerdict: 'progress',
+            decisiveClaims: intermediateProgressClaims,
+        };
+    }
     return {
         finalVerdict: 'none',
         decisiveClaims: [],
@@ -62,6 +69,8 @@ export async function resolveSubmitResult(probe, afterPageObservation) {
     }
     const resultSignalChanged = beforePageObservation.resultSignalHash !== afterPageObservation.resultSignalHash &&
         afterPageObservation.resultSignalHash !== null;
+    const submitSignalChanged = beforePageObservation.submitSignalHash !== afterPageObservation.submitSignalHash &&
+        afterPageObservation.submitSignalHash !== null;
     const afterSurfaceContextHash = await captureAfterSurfaceContextHash(probe);
     const ownerScopeChanged = probe.beforeSurfaceContextHash !== null &&
         afterSurfaceContextHash !== null &&
@@ -77,18 +86,29 @@ export async function resolveSubmitResult(probe, afterPageObservation) {
         });
     }
     else if (ownerScopeChanged) {
-        claims.push({
-            kind: 'noisy_change',
-            source: 'owner-scope',
-            reason: 'Owner scope changed after submit without a result-bearing signal.',
-            ownerScopeRef: probe.surface?.ref,
-        });
+        if (submitSignalChanged) {
+            claims.push({
+                kind: 'intermediate_progress',
+                source: 'owner-scope',
+                reason: 'Owner scope changed after submit with a submit-relevant follow-up state change.',
+                ownerScopeRef: probe.surface?.ref,
+            });
+        }
+        else {
+            claims.push({
+                kind: 'noisy_change',
+                source: 'owner-scope',
+                reason: 'Owner scope changed after submit without a result-bearing signal.',
+                ownerScopeRef: probe.surface?.ref,
+            });
+        }
     }
     const reduced = reduceSubmitResultClaims(claims);
     return {
         ...reduced,
         claims,
         acceptAsProgress: reduced.finalVerdict === 'outcome' ||
+            reduced.finalVerdict === 'progress' ||
             (reduced.finalVerdict === 'none' &&
                 claims.some((claim) => claim.kind === 'soft_result_candidate')),
     };

package/dist/commands/extract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/commands/extract.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAmMnD,wBAAsB,OAAO,CAC3B,OAAO,EAAE,aAAa,EACtB,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAkMf"}
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/commands/extract.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAoMnD,wBAAsB,OAAO,CAC3B,OAAO,EAAE,aAAa,EACtB,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAyMf"}

package/dist/commands/extract.js

@@ -6,7 +6,7 @@ import { AgentpayStructuredOutputTruncatedError } from '../agentpay-stagehand-ll
 import { saveSession } from '../session.js';
 import { getSurface, getTarget, markSurfaceLifecycle, markTargetLifecycle, setCurrentPage, } from '../runtime-state.js';
 import { outputContractFailure, outputJSON } from '../output.js';
-import { connectPlaywright, disconnectPlaywright, resolvePageByRef as resolvePlaywrightPageByRef, syncSessionPage, } from '../playwright-runtime.js';
+import { connectPlaywright, disconnectPlaywright, resolveCurrentPageContext, resolvePageByRef as resolvePlaywrightPageByRef, syncSessionPage, } from '../playwright-runtime.js';
 import { normalizePageSignature } from './descriptor-validation.js';
 import { readScopedDialogText } from './extract-scoped-dialog-text.js';
 import { resolveScopedExtractContext } from './extract-scope-resolution.js';
@@ -174,7 +174,7 @@ export async function extract(session, schemaJson, scopeRef) {
     const targetScope = scopeRef ? getTarget(session, scopeRef) : null;
     const surfaceScope = !targetScope && scopeRef ? getSurface(session, scopeRef) : null;
     const scopeTarget = targetScope ?? surfaceScope;
-    const pageRef = scopeTarget?.pageRef ?? session.runtime?.currentPageRef ?? 'p0';
+    let pageRef = scopeTarget?.pageRef ?? session.runtime?.currentPageRef ?? 'p0';
     if (scopeRef && !scopeTarget) {
         return outputContractFailure({
             error: 'unknown_scope_ref',
@@ -221,7 +221,15 @@ export async function extract(session, schemaJson, scopeRef) {
         });
     }
     try {
-        const sourcePage = await resolvePlaywrightPageByRef(browser, session, pageRef);
+        let sourcePage;
+        if (scopeTarget) {
+            sourcePage = await resolvePlaywrightPageByRef(browser, session, pageRef);
+        }
+        else {
+            const resolvedPage = await resolveCurrentPageContext(browser, session);
+            pageRef = resolvedPage.pageRef;
+            sourcePage = resolvedPage.page;
+        }
         let page = sourcePage;
         let scopedResolution = null;
         const { url, title } = await syncSessionPage(session, pageRef, sourcePage);

package/dist/commands/navigate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"navigate.d.ts","sourceRoot":"","sources":["../../src/commands/navigate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAiBnD,wBAAsB,QAAQ,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyDvF"}
+{"version":3,"file":"navigate.d.ts","sourceRoot":"","sources":["../../src/commands/navigate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAgBnD,wBAAsB,QAAQ,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwDvF"}

package/dist/commands/navigate.js

@@ -1,11 +1,11 @@
 /**
  * browse navigate <url> — Navigate the current tab to a URL.
  */
-import { clearProtectedExposure } from '../runtime-state.js';
+import { clearProtectedExposure, setCurrentPage } from '../runtime-state.js';
 import { saveSession } from '../session.js';
 import { outputContractFailure, outputJSON, info } from '../output.js';
 import { summarizeSecretCatalog, syncSecretCatalogForUrl, tryResolveCatalogHost, } from '../secrets/catalog-sync.js';
-import { connectPlaywright, disconnectPlaywright, listPages, resolvePageByRef, syncSessionPage, } from '../playwright-runtime.js';
+import { connectPlaywright, disconnectPlaywright, resolveCurrentPageContext, syncSessionPage, } from '../playwright-runtime.js';
 export async function navigate(session, targetUrl) {
     let browser = null;
     let failureMessage = null;
@@ -22,18 +22,18 @@ export async function navigate(session, targetUrl) {
         });
     }
     try {
-        const pageRef = session.runtime?.currentPageRef ?? 'p0';
+        let pageRef = session.runtime?.currentPageRef ?? 'p0';
+        const resolvedPage = await resolveCurrentPageContext(browser, session);
+        pageRef = resolvedPage.pageRef;
+        const page = resolvedPage.page;
         const previousUrl = session.runtime?.pages?.[pageRef]?.url;
         const previousHost = tryResolveCatalogHost(previousUrl);
-        const pages = listPages(browser);
-        const page = session.runtime?.pages[pageRef] || pages.length > 1
-            ? await resolvePageByRef(browser, session, pageRef)
-            : pages[0];
         if (!page) {
             throw new Error('no_open_pages');
         }
         await page.goto(targetUrl, { waitUntil: 'domcontentloaded' });
         const { url, title } = await syncSessionPage(session, pageRef, page);
+        setCurrentPage(session, pageRef);
         clearProtectedExposure(session, pageRef);
         const nextHost = tryResolveCatalogHost(url);
         if (nextHost && nextHost !== previousHost) {

package/dist/commands/observe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../../src/commands/observe.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAqDnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAU/D,eAAO,MAAM,yBAAyB;;;;iBA4TwQ,CAAC;gBAAwB,CAAC;;;;CA5TnQ,CAAC;AACtE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGrC,CAAC;AAEF,wBAAsB,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqTzF"}
+{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../../src/commands/observe.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AA0DnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAU/D,eAAO,MAAM,yBAAyB;;;;iBA6T7B,CAAC;gBAEE,CAAA;;;;CA/TyD,CAAC;AACtE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGrC,CAAC;AAEF,wBAAsB,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA8TzF"}

package/dist/commands/observe.js

@@ -2,8 +2,8 @@
  * browse observe ["<instruction>"] — Discover available actions on the page.
  */
 import { saveSession } from '../session.js';
-import { ensureRuntimeState, incrementMetric, replaceTargetsForPage } from '../runtime-state.js';
-import { connectPlaywright, disconnectPlaywright, resolvePageByRef, syncSessionPage, } from '../playwright-runtime.js';
+import { ensureRuntimeState, incrementMetric, replaceTargetsForPage, setCurrentPage, } from '../runtime-state.js';
+import { connectPlaywright, disconnectPlaywright, resolveCurrentPageContext, syncSessionPage, } from '../playwright-runtime.js';
 import { outputContractFailure, outputJSON } from '../output.js';
 import { domRuntimeResolution, stagehandRuntimeResolution } from '../runtime-resolution.js';
 import { withStagehand } from '../stagehand-runtime.js';
@@ -26,7 +26,7 @@ export const __testStagehandDescriptor = {
 };
 export async function observe(session, instruction) {
     const runtime = ensureRuntimeState(session);
-    const pageRef = runtime.currentPageRef;
+    let pageRef = runtime.currentPageRef;
     let domPassError = null;
     let stagehandFallbackReason = null;
     let browser = null;
@@ -34,8 +34,11 @@ export async function observe(session, instruction) {
     if (!instruction) {
         try {
             browser = await connectPlaywright(session.cdpUrl);
-            const page = await resolvePageByRef(browser, session, pageRef);
+            const resolvedPage = await resolveCurrentPageContext(browser, session);
+            pageRef = resolvedPage.pageRef;
+            const page = resolvedPage.page;
             const { url, title } = await syncSessionPage(session, pageRef, page);
+            setCurrentPage(session, pageRef);
             const collectedTargets = await collectDomTargets(page);
             let observeAccessibilityStats;
             const domTargets = compressSemanticallyDuplicateTargets(orderBySurfaceCompetition(annotateDomTargets(await enrichDomTargetsWithAccessibility(page, collectedTargets, {
@@ -96,8 +99,11 @@ export async function observe(session, instruction) {
             if (!browser) {
                 browser = await connectPlaywright(session.cdpUrl);
             }
-            const page = await resolvePageByRef(browser, session, pageRef);
+            const resolvedPage = await resolveCurrentPageContext(browser, session);
+            pageRef = resolvedPage.pageRef;
+            const page = resolvedPage.page;
             const { url, title } = await syncSessionPage(session, pageRef, page);
+            setCurrentPage(session, pageRef);
             const collectedTargets = await collectDomTargets(page, {
                 includeActivationAffordances: true,
             });
@@ -198,8 +204,11 @@ export async function observe(session, instruction) {
         });
     }
     try {
-        const page = await resolvePageByRef(browser, session, pageRef);
+        const resolvedPage = await resolveCurrentPageContext(browser, session);
+        pageRef = resolvedPage.pageRef;
+        const page = resolvedPage.page;
         const { url, title } = await syncSessionPage(session, pageRef, page);
+        setCurrentPage(session, pageRef);
         const signals = compactSignals(await collectPageSignals(page).catch(() => []));
         const actions = await withStagehand(session, async (stagehand) => {
             incrementMetric(session, 'stagehandCalls');

package/dist/commands/screenshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../../src/commands/screenshot.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAYnD,wBAAsB,UAAU,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsDzF"}
+{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../../src/commands/screenshot.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAWnD,wBAAsB,UAAU,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsEzF"}

package/dist/commands/screenshot.js

@@ -1,20 +1,19 @@
 /**
  * browse screenshot [--path <file>] — Capture a screenshot of the current page.
  */
-import { getProtectedExposure } from '../runtime-state.js';
+import { getProtectedExposure, setCurrentPage } from '../runtime-state.js';
 import { saveSession } from '../session.js';
 import { outputFailure, outputJSON, outputContractFailure, info } from '../output.js';
-import { connectPlaywright, disconnectPlaywright, listPages, resolvePageByRef, syncSessionPage, } from '../playwright-runtime.js';
+import { connectPlaywright, disconnectPlaywright, resolveCurrentPageContext, syncSessionPage, } from '../playwright-runtime.js';
 import { buildProtectedScreenshotBlockedResult } from '../secrets/protected-artifact-guard.js';
 export async function screenshot(session, filePath) {
     const outputPath = filePath ?? `/tmp/browse-screenshot-${Date.now()}.png`;
-    const pageRef = session.runtime?.currentPageRef ?? 'p0';
-    const protectedExposure = getProtectedExposure(session, pageRef);
-    if (protectedExposure) {
-        return outputFailure(buildProtectedScreenshotBlockedResult(protectedExposure));
-    }
+    const initialPageRef = session.runtime?.currentPageRef ?? 'p0';
+    let pageRef = initialPageRef;
+    const initialProtectedExposure = getProtectedExposure(session, initialPageRef);
     let browser = null;
     let failureMessage = null;
+    let page = null;
     try {
         browser = await connectPlaywright(session.cdpUrl);
     }
@@ -27,16 +26,33 @@ export async function screenshot(session, filePath) {
         });
     }
     try {
-        const pages = listPages(browser);
-        const page = session.runtime?.pages[pageRef] || pages.length > 1
-            ? await resolvePageByRef(browser, session, pageRef)
-            : pages[0];
+        const resolvedPage = await resolveCurrentPageContext(browser, session);
+        pageRef = resolvedPage.pageRef;
+        page = resolvedPage.page;
+    }
+    catch (err) {
+        failureMessage = `Screenshot failed: ${err instanceof Error ? err.message : String(err)}`;
+    }
+    const recoveredProtectedExposure = getProtectedExposure(session, pageRef) ?? (!page ? initialProtectedExposure : null);
+    if (recoveredProtectedExposure) {
+        if (page && pageRef !== initialPageRef) {
+            setCurrentPage(session, pageRef);
+            saveSession(session);
+        }
+        if (browser) {
+            disconnectPlaywright(browser);
+            browser = null;
+        }
+        return outputFailure(buildProtectedScreenshotBlockedResult(recoveredProtectedExposure));
+    }
+    try {
         if (!page) {
-            throw new Error('no_open_pages');
+            throw new Error(failureMessage?.replace(/^Screenshot failed:\s*/, '') ?? 'no_open_pages');
         }
         await page.screenshot({ path: outputPath });
         info(`Screenshot saved: ${outputPath}`);
         const { url, title } = await syncSessionPage(session, pageRef, page);
+        setCurrentPage(session, pageRef);
         saveSession(session);
         outputJSON({ success: true, pageRef, path: outputPath, url, title });
     }

package/dist/commands/status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA;;GAEG;AAoDH,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CA8F5C"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmKH,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAgG5C"}

package/dist/commands/status.js

@@ -3,6 +3,21 @@
  */
 import { loadSession, isSessionAlive, getSessionPort, supportsCaptchaSolve } from '../session.js';
 import { outputJSON } from '../output.js';
+function normalizeComparableUrl(url) {
+    const raw = url?.trim();
+    if (!raw) {
+        return null;
+    }
+    try {
+        const parsed = new URL(raw);
+        parsed.hash = '';
+        parsed.search = '';
+        return `${parsed.origin}${parsed.pathname}`;
+    }
+    catch {
+        return raw;
+    }
+}
 function tryResolveHost(url) {
     if (!url) {
         return undefined;
@@ -23,6 +38,7 @@ function buildProtectedStatusPayload(params) {
             ? { captchaSolveCapable: params.captchaSolveCapable }
             : {}),
         runtime: params.runtimeSummary,
+        ...(params.currentPageMismatch ? { currentPageMismatch: params.currentPageMismatch } : {}),
         protectedExposureActive: true,
         pageRef: params.protectedExposure.pageRef,
         url: params.pageUrl ?? 'unknown',
@@ -36,6 +52,70 @@ function buildProtectedStatusPayload(params) {
         reason: 'AgentBrowse is treating the current page as sensitive because a protected fill was executed and values may still be visible.',
     };
 }
+function matchesStoredPage(page, livePage) {
+    const storedUrl = normalizeComparableUrl(page?.url);
+    const currentUrl = normalizeComparableUrl(livePage.url);
+    if (!storedUrl || !currentUrl || storedUrl !== currentUrl) {
+        return null;
+    }
+    if (page?.title && livePage.title && page.title === livePage.title) {
+        return 'url-title-match';
+    }
+    return 'url-match';
+}
+function resolveCurrentPageMismatch(session, livePage) {
+    const runtime = session?.runtime;
+    if (!runtime || !livePage) {
+        return undefined;
+    }
+    const persistedPageRef = runtime.currentPageRef;
+    const currentPage = runtime.pages[persistedPageRef];
+    if (!currentPage) {
+        return {
+            persistedPageRef,
+        };
+    }
+    if (matchesStoredPage(currentPage, livePage)) {
+        return undefined;
+    }
+    const openerPageRef = currentPage.openerPageRef;
+    if (openerPageRef && matchesStoredPage(runtime.pages[openerPageRef], livePage)) {
+        return {
+            persistedPageRef,
+            livePageRef: openerPageRef,
+            recoveredVia: 'opener',
+        };
+    }
+    const exactMatches = Object.values(runtime.pages).filter((page) => {
+        if (page.pageRef === persistedPageRef || page.pageRef === openerPageRef) {
+            return false;
+        }
+        return matchesStoredPage(page, livePage) === 'url-title-match';
+    });
+    if (exactMatches.length === 1) {
+        return {
+            persistedPageRef,
+            livePageRef: exactMatches[0].pageRef,
+            recoveredVia: 'url-title-match',
+        };
+    }
+    const urlOnlyMatches = Object.values(runtime.pages).filter((page) => {
+        if (page.pageRef === persistedPageRef || page.pageRef === openerPageRef) {
+            return false;
+        }
+        return matchesStoredPage(page, livePage) === 'url-match';
+    });
+    if (urlOnlyMatches.length === 1) {
+        return {
+            persistedPageRef,
+            livePageRef: urlOnlyMatches[0].pageRef,
+            recoveredVia: 'url-match',
+        };
+    }
+    return {
+        persistedPageRef,
+    };
+}
 export async function status() {
     const session = loadSession();
     const port = getSessionPort(session);
@@ -57,15 +137,17 @@ export async function status() {
                 const listRes = await fetch(`http://localhost:${port}/json/list`);
                 const targets = (await listRes.json());
                 const page = targets.find((t) => t.type === 'page' && !t.url.startsWith('devtools://'));
-                const currentPageRef = session?.runtime?.currentPageRef;
-                const protectedExposure = currentPageRef
-                    ? session?.runtime?.protectedExposureByPage?.[currentPageRef]
+                const currentPageMismatch = resolveCurrentPageMismatch(session, page);
+                const effectivePageRef = currentPageMismatch?.livePageRef ?? session?.runtime?.currentPageRef;
+                const protectedExposure = effectivePageRef
+                    ? session?.runtime?.protectedExposureByPage?.[effectivePageRef]
                     : undefined;
                 if (protectedExposure) {
                     outputJSON(buildProtectedStatusPayload({
                         runtimeSummary,
                         pageUrl: page?.url,
                         pageTitle: page?.title,
+                        currentPageMismatch,
                         protectedExposure,
                     }));
                     return;
@@ -76,6 +158,7 @@ export async function status() {
                     url: page?.url ?? 'unknown',
                     title: page?.title ?? 'unknown',
                     runtime: runtimeSummary,
+                    ...(currentPageMismatch ? { currentPageMismatch } : {}),
                 });
                 return;
             }
@@ -90,9 +173,10 @@ export async function status() {
         const listRes = await fetch(`http://localhost:${port}/json/list`);
         const targets = (await listRes.json());
         const page = targets.find((t) => t.type === 'page' && !t.url.startsWith('devtools://'));
-        const currentPageRef = session.runtime?.currentPageRef;
-        const protectedExposure = currentPageRef
-            ? session.runtime?.protectedExposureByPage?.[currentPageRef]
+        const currentPageMismatch = resolveCurrentPageMismatch(session, page);
+        const effectivePageRef = currentPageMismatch?.livePageRef ?? session.runtime?.currentPageRef;
+        const protectedExposure = effectivePageRef
+            ? session.runtime?.protectedExposureByPage?.[effectivePageRef]
             : undefined;
         if (protectedExposure) {
             outputJSON(buildProtectedStatusPayload({
@@ -100,6 +184,7 @@ export async function status() {
                 pageUrl: page?.url,
                 pageTitle: page?.title,
                 captchaSolveCapable: supportsCaptchaSolve(session),
+                currentPageMismatch,
                 protectedExposure,
             }));
             return;
@@ -111,6 +196,7 @@ export async function status() {
             url: page?.url ?? 'unknown',
             title: page?.title ?? 'unknown',
             runtime: runtimeSummary,
+            ...(currentPageMismatch ? { currentPageMismatch } : {}),
         });
         return;
     }

package/dist/playwright-runtime.d.ts

@@ -9,6 +9,11 @@ type LaunchPageMetadata = {
     title: string;
     targetId?: string;
 };
+export type ResolvedCurrentPageContext = {
+    pageRef: string;
+    page: Page;
+    recoveredVia?: 'opener' | 'sole-live-page';
+};
 export declare function readLaunchPageMetadata(browser: Browser, options?: {
     requestedUrl?: string;
     fallbackUrl?: string;
@@ -26,6 +31,7 @@ export declare function syncLaunchPage(session: BrowseSession, browser: Browser,
     targetId?: string;
 }>;
 export declare function resolvePageByRef(browser: Browser, session: BrowseSession, pageRef: string): Promise<Page>;
+export declare function resolveCurrentPageContext(browser: Browser, session: BrowseSession): Promise<ResolvedCurrentPageContext>;
 export declare function syncSessionPage(session: BrowseSession, pageRef: string, page: Page, options?: {
     settleTimeoutMs?: number;
 }): Promise<{

package/dist/playwright-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playwright-runtime.d.ts","sourceRoot":"","sources":["../src/playwright-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAExE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAO3D;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,EAAE,CAElD;AAmCD,KAAK,kBAAkB,GAAG;IACxB,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAkJF,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE;IACP,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,OAAO,CAAC,kBAAkB,CAAC,CA+C7B;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE;IACP,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgC5D;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CA8Cf;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,IAAI,EACV,OAAO,GAAE;IACP,eAAe,CAAC,EAAE,MAAM,CAAC;CACrB,GACL,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgB5D"}
+{"version":3,"file":"playwright-runtime.d.ts","sourceRoot":"","sources":["../src/playwright-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAExE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAO3D;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,EAAE,CAElD;AA8CD,KAAK,kBAAkB,GAAG;IACxB,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAQF,MAAM,MAAM,0BAA0B,GAAG;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,IAAI,CAAC;IACX,YAAY,CAAC,EAAE,QAAQ,GAAG,gBAAgB,CAAC;CAC5C,CAAC;AA4IF,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE;IACP,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,OAAO,CAAC,kBAAkB,CAAC,CA+C7B;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE;IACP,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgC5D;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CA8Cf;AA+CD,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,0BAA0B,CAAC,CAqCrC;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,IAAI,EACV,OAAO,GAAE;IACP,eAAe,CAAC,EAAE,MAAM,CAAC;CACrB,GACL,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgB5D"}

package/dist/playwright-runtime.js

@@ -17,6 +17,10 @@ export function listPages(browser) {
 function buildPageResolutionError(kind, pageRef) {
     return new Error(`${kind === 'unknown' ? 'unknown_page_ref' : 'stale_page_ref'}:${pageRef}`);
 }
+function isPageResolutionError(error, kind, pageRef) {
+    return (error instanceof Error &&
+        error.message === `${kind === 'unknown' ? 'unknown_page_ref' : 'stale_page_ref'}:${pageRef}`);
+}
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -250,6 +254,78 @@ export async function resolvePageByRef(browser, session, pageRef) {
     }
     throw buildPageResolutionError('stale', pageRef);
 }
+async function findRecoverableCurrentPageRef(browser, session, stalePageRef) {
+    const runtimePages = session.runtime?.pages ?? {};
+    const stalePageState = runtimePages[stalePageRef];
+    const openerPageRef = stalePageState?.openerPageRef;
+    if (openerPageRef && openerPageRef !== stalePageRef) {
+        try {
+            await resolvePageByRef(browser, session, openerPageRef);
+            return {
+                pageRef: openerPageRef,
+                recoveredVia: 'opener',
+            };
+        }
+        catch {
+            // Keep recovery fail-closed unless opener or a single live alternative is provably valid.
+        }
+    }
+    const liveCandidateRefs = [];
+    for (const candidatePageRef of Object.keys(runtimePages)) {
+        if (candidatePageRef === stalePageRef || candidatePageRef === openerPageRef) {
+            continue;
+        }
+        try {
+            await resolvePageByRef(browser, session, candidatePageRef);
+            liveCandidateRefs.push(candidatePageRef);
+        }
+        catch {
+            // Ignore stale or unknown candidates while looking for a single surviving live page.
+        }
+    }
+    if (liveCandidateRefs.length === 1) {
+        return {
+            pageRef: liveCandidateRefs[0],
+            recoveredVia: 'sole-live-page',
+        };
+    }
+    return null;
+}
+export async function resolveCurrentPageContext(browser, session) {
+    const currentPageRef = session.runtime?.currentPageRef ?? 'p0';
+    try {
+        const page = await resolvePageByRef(browser, session, currentPageRef);
+        return {
+            pageRef: currentPageRef,
+            page,
+        };
+    }
+    catch (error) {
+        if (isPageResolutionError(error, 'unknown', currentPageRef)) {
+            const pages = listPages(browser);
+            if (pages.length === 1) {
+                return {
+                    pageRef: currentPageRef,
+                    page: pages[0],
+                    recoveredVia: 'sole-live-page',
+                };
+            }
+            throw error;
+        }
+        if (!isPageResolutionError(error, 'stale', currentPageRef)) {
+            throw error;
+        }
+        const recovered = await findRecoverableCurrentPageRef(browser, session, currentPageRef);
+        if (!recovered) {
+            throw error;
+        }
+        return {
+            pageRef: recovered.pageRef,
+            page: await resolvePageByRef(browser, session, recovered.pageRef),
+            recoveredVia: recovered.recoveredVia,
+        };
+    }
+}
 export async function syncSessionPage(session, pageRef, page, options = {}) {
     ensureRuntimeState(session);
     const { url, title, targetId } = await readSettledSessionPageMetadata(session, pageRef, page, options);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuanu-ai/agentbrowse",
-  "version": "0.2.24",
+  "version": "0.2.26",
   "type": "module",
   "description": "Browser automation CLI for AI agents: control a CDP browser, observe UI surfaces, act on refs, extract data, capture screenshots, complete protected fills, and solve captchas",
   "keywords": [