@mercuryo-ai/agentbrowse 0.2.57 → 0.2.61

package/dist/commands/screenshot.js

@@ -6,8 +6,10 @@ import { getProtectedExposure } from '../runtime-protected-state.js';
 import { saveSession } from '../session.js';
 import { outputFailure, outputJSON, outputContractFailure, info } from '../output.js';
 import { captureDiagnosticSnapshotBestEffort, finishDiagnosticStepBestEffort, recordCommandLifecycleEventBestEffort, startDiagnosticStep, } from '../diagnostics.js';
-import { connectPlaywright, disconnectPlaywright, resolveCurrentPageContext, syncSessionPage, } from '../playwright-runtime.js';
+import { resolveCurrentPageContext, syncSessionPage } from '../playwright-runtime.js';
 import { buildProtectedScreenshotBlockedResult, } from '../secrets/protected-artifact-guard.js';
+import { describeBrowserConnectionFailure } from './browser-connection-failure.js';
+import { withStickyOwnerBrowser } from '../sticky-owner.js';
 /** Stable top-level error codes returned by `screenshot(...)`. */
 export const SCREENSHOT_ERROR_CODES = [
     'browser_connection_failed',
@@ -172,81 +174,65 @@ export async function screenshotBrowser(session, filePath) {
             protectedStep: Boolean(initialProtectedExposure),
         },
     });
-    let browser = null;
-    let failureMessage = null;
-    let page = null;
     try {
-        browser = await connectPlaywright(session.cdpUrl);
-    }
-    catch (err) {
-        return buildScreenshotContractFailureResult(session, {
-            step: screenshotStepHandle,
-            error: 'browser_connection_failed',
-            outcomeType: 'blocked',
-            message: 'Screenshot capture could not start because AgentBrowse failed to connect to the browser.',
-            reason: err instanceof Error ? err.message : String(err),
-            runId: session.activeRunId,
-            stepId: screenshotStep?.stepId,
+        return await withStickyOwnerBrowser(session, async (browser) => {
+            try {
+                const resolvedPage = await resolveCurrentPageContext(browser, session);
+                pageRef = resolvedPage.pageRef;
+                const page = resolvedPage.page;
+                const recoveredProtectedExposure = getProtectedExposure(session, pageRef) ?? (!page ? initialProtectedExposure : null);
+                if (recoveredProtectedExposure) {
+                    if (page && pageRef !== initialPageRef) {
+                        setCurrentPage(session, pageRef);
+                    }
+                    return buildScreenshotFailureResult(session, {
+                        step: screenshotStepHandle,
+                        ...buildProtectedScreenshotBlockedResult(recoveredProtectedExposure),
+                        runId: session.activeRunId,
+                        stepId: screenshotStep?.stepId,
+                    });
+                }
+                if (!page) {
+                    throw new Error('no_open_pages');
+                }
+                await page.screenshot({ path: outputPath });
+                const { url, title } = await syncSessionPage(session, pageRef, page);
+                setCurrentPage(session, pageRef);
+                return buildScreenshotSuccessResult({
+                    session,
+                    step: screenshotStepHandle,
+                    runId: session.activeRunId,
+                    stepId: screenshotStep?.stepId,
+                    pageRef,
+                    path: outputPath,
+                    url,
+                    title,
+                });
+            }
+            catch (error) {
+                throw new Error(`screenshot_failed:${error instanceof Error ? error.message : String(error)}`);
+            }
         });
     }
-    try {
-        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);
-        }
-        if (browser) {
-            await disconnectPlaywright(browser);
-            browser = null;
-        }
-        return buildScreenshotFailureResult(session, {
-            step: screenshotStepHandle,
-            ...buildProtectedScreenshotBlockedResult(recoveredProtectedExposure),
-            runId: session.activeRunId,
-            stepId: screenshotStep?.stepId,
+        const reason = err instanceof Error ? err.message : String(err);
+        const isCommandFailure = reason.startsWith('screenshot_failed:');
+        const browserConnectionFailure = describeBrowserConnectionFailure(err, {
+            defaultMessage: 'Screenshot capture could not start because AgentBrowse failed to connect to the browser.',
+            unrecoverableSessionMessage: 'Screenshot capture could not start because the previous browser session is no longer reachable.',
         });
-    }
-    try {
-        if (!page) {
-            throw new Error(failureMessage?.replace(/^Screenshot failed:\s*/, '') ?? 'no_open_pages');
-        }
-        await page.screenshot({ path: outputPath });
-        const { url, title } = await syncSessionPage(session, pageRef, page);
-        setCurrentPage(session, pageRef);
-        return buildScreenshotSuccessResult({
-            session,
-            step: screenshotStepHandle,
-            runId: session.activeRunId,
-            stepId: screenshotStep?.stepId,
-            pageRef,
-            path: outputPath,
-            url,
-            title,
-        });
-    }
-    catch (err) {
         return buildScreenshotContractFailureResult(session, {
             step: screenshotStepHandle,
-            error: 'screenshot_failed',
+            error: isCommandFailure ? 'screenshot_failed' : 'browser_connection_failed',
             outcomeType: 'blocked',
-            message: 'Screenshot capture failed.',
-            reason: err instanceof Error ? err.message : String(err),
+            message: isCommandFailure ? 'Screenshot capture failed.' : browserConnectionFailure.message,
+            reason: isCommandFailure
+                ? reason.replace(/^screenshot_failed:/, '')
+                : browserConnectionFailure.reason,
             runId: session.activeRunId,
             stepId: screenshotStep?.stepId,
         });
     }
-    finally {
-        if (browser) {
-            await disconnectPlaywright(browser);
-        }
-    }
 }
 /** CLI wrapper for `screenshotBrowser(...)` that persists session changes and writes JSON output. */
 export async function screenshot(session, filePath) {

package/dist/control-semantics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"control-semantics.d.ts","sourceRoot":"","sources":["../src/control-semantics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC;AAEzE,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,aAAa,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;AAwCtF,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,oBAAoB,GAC1B,mBAAmB,GAAG,SAAS,CAuCjC;AA6LD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAYxE;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,oBAAoB,GAAG,mBAAmB,EAAE,CA4G/F;AAED,wBAAgB,0BAA0B,CACxC,MAAM,CAAC,EAAE,gBAAgB,EACzB,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE;IACP,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC1B,GACL,uBAAuB,CAyBzB;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,oBAAoB,EAC3B,cAAc,EAAE,aAAa,CAAC,mBAAmB,CAAC,GACjD,mBAAmB,GAAG,SAAS,CA0EjC;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,oBAAoB,EAC3B,cAAc,EAAE,aAAa,CAAC,mBAAmB,CAAC,GACjD,sBAAsB,GAAG,SAAS,CA6CpC"}
+{"version":3,"file":"control-semantics.d.ts","sourceRoot":"","sources":["../src/control-semantics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC;AAEzE,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,aAAa,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;AAwCtF,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,oBAAoB,GAC1B,mBAAmB,GAAG,SAAS,CAuCjC;AA6LD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAYxE;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,oBAAoB,GAAG,mBAAmB,EAAE,CA4G/F;AAED,wBAAgB,0BAA0B,CACxC,MAAM,CAAC,EAAE,gBAAgB,EACzB,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE;IACP,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC1B,GACL,uBAAuB,CAyBzB;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,oBAAoB,EAC3B,cAAc,EAAE,aAAa,CAAC,mBAAmB,CAAC,GACjD,mBAAmB,GAAG,SAAS,CA0EjC;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,oBAAoB,EAC3B,cAAc,EAAE,aAAa,CAAC,mBAAmB,CAAC,GACjD,sBAAsB,GAAG,SAAS,CAqDpC"}

package/dist/control-semantics.js

@@ -387,6 +387,7 @@ export function inferAcceptancePolicyFromFacts(facts, allowedActions) {
     const states = facts.states;
     const kind = normalizeText(facts.kind);
     const role = normalizeText(facts.role);
+    const inputType = normalizeText(facts.inputType);
     const controlFamily = inferControlFamilyFromFacts(facts, allowedActions);
     if (facts.structure?.family === 'structured-grid') {
         return facts.structure.variant === 'date-cell' ? 'date-selection' : 'selection';
@@ -409,6 +410,10 @@ export function inferAcceptancePolicyFromFacts(facts, allowedActions) {
     if (role === 'link' || kind === 'link') {
         return 'navigation';
     }
+    if (inputType === 'submit' &&
+        (kind === 'button' || role === 'button' || isButtonLikeInputFacts(facts))) {
+        return 'submit';
+    }
     if (!legacyMethod && SUBMIT_LABEL_RE.test(label)) {
         return 'submit';
     }

package/dist/date-value-normalization.d.ts

@@ -0,0 +1,16 @@
+export type DateValueNormalizationErrorReason = 'ambiguous_date_value' | 'incomplete_date_value' | 'invalid_date_value';
+export type NormalizedDateValueResult = {
+    kind: 'normalized';
+    iso: string;
+    year: string;
+    month: string;
+    day: string;
+} | {
+    kind: 'error';
+    reason: DateValueNormalizationErrorReason;
+} | {
+    kind: 'not_date_like';
+};
+export declare function isDateValueNormalizationErrorReason(value: string): value is DateValueNormalizationErrorReason;
+export declare function normalizeStructuredDateValue(value: string): NormalizedDateValueResult;
+//# sourceMappingURL=date-value-normalization.d.ts.map

package/dist/date-value-normalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-value-normalization.d.ts","sourceRoot":"","sources":["../src/date-value-normalization.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iCAAiC,GACzC,sBAAsB,GACtB,uBAAuB,GACvB,oBAAoB,CAAC;AAEzB,MAAM,MAAM,yBAAyB,GACjC;IACE,IAAI,EAAE,YAAY,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,iCAAiC,CAAC;CAC3C,GACD;IACE,IAAI,EAAE,eAAe,CAAC;CACvB,CAAC;AAsDN,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,MAAM,GACZ,KAAK,IAAI,iCAAiC,CAM5C;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,yBAAyB,CAuFrF"}

package/dist/date-value-normalization.js

@@ -0,0 +1,117 @@
+const ISO_DATE_RE = /^(\d{4})-(\d{2})-(\d{2})$/;
+const YEAR_FIRST_DATE_RE = /^(\d{4})[./-](\d{1,2})[./-](\d{1,2})$/;
+const DAY_OR_MONTH_FIRST_DATE_RE = /^(\d{1,2})[./-](\d{1,2})[./-](\d{4})$/;
+const PARTIAL_DATE_RE = /^(?:\d{4}[./-]\d{1,2}|\d{1,2}[./-](?:\d{2}|\d{4}))$/;
+function padDatePart(value) {
+    return String(value).padStart(2, '0');
+}
+function buildNormalizedDateValue(year, month, day) {
+    if (!Number.isInteger(year) ||
+        !Number.isInteger(month) ||
+        !Number.isInteger(day) ||
+        month < 1 ||
+        month > 12 ||
+        day < 1 ||
+        day > 31) {
+        return {
+            kind: 'error',
+            reason: 'invalid_date_value',
+        };
+    }
+    const date = new Date(Date.UTC(year, month - 1, day));
+    if (date.getUTCFullYear() !== year ||
+        date.getUTCMonth() !== month - 1 ||
+        date.getUTCDate() !== day) {
+        return {
+            kind: 'error',
+            reason: 'invalid_date_value',
+        };
+    }
+    const paddedMonth = padDatePart(month);
+    const paddedDay = padDatePart(day);
+    return {
+        kind: 'normalized',
+        iso: `${String(year)}-${paddedMonth}-${paddedDay}`,
+        year: String(year),
+        month: paddedMonth,
+        day: paddedDay,
+    };
+}
+export function isDateValueNormalizationErrorReason(value) {
+    return (value === 'ambiguous_date_value' ||
+        value === 'incomplete_date_value' ||
+        value === 'invalid_date_value');
+}
+export function normalizeStructuredDateValue(value) {
+    const trimmed = value.trim();
+    if (trimmed.length === 0) {
+        return {
+            kind: 'not_date_like',
+        };
+    }
+    const isoMatch = trimmed.match(ISO_DATE_RE);
+    if (isoMatch) {
+        return buildNormalizedDateValue(Number(isoMatch[1]), Number(isoMatch[2]), Number(isoMatch[3]));
+    }
+    const yearFirstMatch = trimmed.match(YEAR_FIRST_DATE_RE);
+    if (yearFirstMatch) {
+        return buildNormalizedDateValue(Number(yearFirstMatch[1]), Number(yearFirstMatch[2]), Number(yearFirstMatch[3]));
+    }
+    const dayOrMonthFirstMatch = trimmed.match(DAY_OR_MONTH_FIRST_DATE_RE);
+    if (dayOrMonthFirstMatch) {
+        const first = Number(dayOrMonthFirstMatch[1]);
+        const second = Number(dayOrMonthFirstMatch[2]);
+        const year = Number(dayOrMonthFirstMatch[3]);
+        const dayFirstCandidate = first >= 1 && first <= 31 && second >= 1 && second <= 12;
+        const monthFirstCandidate = first >= 1 && first <= 12 && second >= 1 && second <= 31;
+        if (dayFirstCandidate && monthFirstCandidate) {
+            const dayFirst = buildNormalizedDateValue(year, second, first);
+            const monthFirst = buildNormalizedDateValue(year, first, second);
+            if (dayFirst.kind === 'normalized' && monthFirst.kind === 'normalized') {
+                if (dayFirst.iso === monthFirst.iso) {
+                    return dayFirst;
+                }
+                return {
+                    kind: 'error',
+                    reason: 'ambiguous_date_value',
+                };
+            }
+            if (dayFirst.kind === 'normalized') {
+                return dayFirst;
+            }
+            if (monthFirst.kind === 'normalized') {
+                return monthFirst;
+            }
+            return {
+                kind: 'error',
+                reason: 'invalid_date_value',
+            };
+        }
+        if (dayFirstCandidate) {
+            return buildNormalizedDateValue(year, second, first);
+        }
+        if (monthFirstCandidate) {
+            return buildNormalizedDateValue(year, first, second);
+        }
+        return {
+            kind: 'error',
+            reason: 'invalid_date_value',
+        };
+    }
+    if (PARTIAL_DATE_RE.test(trimmed)) {
+        return {
+            kind: 'error',
+            reason: 'incomplete_date_value',
+        };
+    }
+    const separatorCount = trimmed.split(/[./-]/).length - 1;
+    if (separatorCount >= 2 && /\d/.test(trimmed)) {
+        return {
+            kind: 'error',
+            reason: 'invalid_date_value',
+        };
+    }
+    return {
+        kind: 'not_date_like',
+    };
+}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAmQA,iBAAe,IAAI,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqJhE;AAED,OAAO,EAAE,IAAI,EAAE,CAAC;AAEhB,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAWzF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAuOA,iBAAe,IAAI,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoJhE;AAED,OAAO,EAAE,IAAI,EAAE,CAAC;AAEhB,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAWzF"}

package/dist/index.js

@@ -22,14 +22,9 @@ Commands:
   close                           Close browser and clean up
 
 Options:
-  --compact                       Launch browser in compact window size (1280x900, default)
-  --full                          Launch browser in full-size window
-  --profile <name>                Solver profile name for launch (default: "default")
   --proxy [url]                   Launch through configured proxy, or use one-off override URL
   --provider <name>               Optional provider label for attach (for example "browserbase")
-  --headful                       Explicit alias for visible browser mode
-  --headless                      Explicit alias for headless browser mode (default)
-  --path <file>                   Output path for screenshot
+  --headful                       Launch a visible browser window
   --help                          Show this help message`;
 }
 const KNOWN_COMMANDS = new Set([
@@ -95,33 +90,20 @@ function getPositionals(args, valueFlags = []) {
 }
 function parseLaunchArgs(args) {
     let url;
-    let compact = true;
     let profile;
     let headless;
     let useProxy = false;
     let proxy;
     for (let i = 0; i < args.length; i++) {
         const arg = args[i];
-        if (arg === '--headless') {
-            headless = true;
-            continue;
-        }
         if (arg === '--headful') {
             headless = false;
             continue;
         }
-        if (arg === '--compact') {
-            compact = true;
-            continue;
-        }
-        if (arg === '--full') {
-            compact = false;
-            continue;
-        }
         if (arg === '--profile') {
             const value = args[i + 1];
             if (!value || value.startsWith('--')) {
-                outputError(`Usage: ${browseCommand('launch', '[url]', '[--profile <name>]', '[--proxy [url]]', '[--headful|--headless]')}`);
+                outputError(`Usage: ${browseCommand('launch', '[url]', '[--proxy [url]]', '[--headful]')}`);
             }
             profile = value;
             i += 1;
@@ -130,7 +112,7 @@ function parseLaunchArgs(args) {
         if (arg.startsWith('--proxy=')) {
             const value = arg.slice('--proxy='.length).trim();
             if (!value) {
-                outputError(`Usage: ${browseCommand('launch', '[url]', '[--profile <name>]', '[--proxy [url]]', '[--headful|--headless]')}`);
+                outputError(`Usage: ${browseCommand('launch', '[url]', '[--proxy [url]]', '[--headful]')}`);
             }
             useProxy = true;
             proxy = value;
@@ -150,11 +132,11 @@ function parseLaunchArgs(args) {
             outputError(`Unknown launch option: ${arg}`);
         }
         if (url) {
-            outputError(`Usage: ${browseCommand('launch', '[url]', '[--profile <name>]', '[--proxy [url]]', '[--headful|--headless]')}`);
+            outputError(`Usage: ${browseCommand('launch', '[url]', '[--proxy [url]]', '[--headful]')}`);
         }
         url = arg;
     }
-    return { url, compact, profile, headless, useProxy, proxy };
+    return { url, profile, headless, useProxy, proxy };
 }
 function parseAttachArgs(args) {
     let cdpUrl;
@@ -226,7 +208,6 @@ async function main(argv = process.argv) {
             await Promise.resolve(close(existingSession)).catch(() => undefined);
             deleteWorkflowContext();
             const launchResult = await launch(launchArgs.url, {
-                compact: launchArgs.compact,
                 ...(launchArgs.profile ? { profile: launchArgs.profile } : {}),
                 ...(typeof launchArgs.headless === 'boolean' ? { headless: launchArgs.headless } : {}),
                 useProxy: launchArgs.useProxy,

package/dist/library.d.ts

@@ -1,15 +1,19 @@
-export { createBrowserSessionStore, deleteBrowserSession, getSessionPort, isAttachedSession, isOwnedSession, isSessionAlive, loadBrowserSession, resolveBrowserSessionId, saveBrowserSession, serializeBrowserSession, supportsCaptchaSolve, buildAttachedSession, buildOwnedSession, type BrowserSessionCapabilities, type BrowserSessionStore, type BrowserSessionState, type BrowseSessionIdentity, type BrowseSessionTransport, } from './browser-session-state.js';
+export { createBrowserSessionStore, deleteBrowserSession, getSessionPort, isAttachedSession, isOwnedSession, isSessionAlive, loadBrowserSession, resolveBrowserSessionId, saveBrowserSession, serializeBrowserSession, supportsCaptchaSolve, buildAttachedSession, buildOwnedSession, buildStickyOwnerMetadata, canPersistStickyOwnerMetadata, type BrowserSessionCapabilities, type BrowserSessionStore, type BrowserSessionState, type BrowseSessionIdentity, type BrowseSessionTransport, type StickyOwnerInProcessTransport, type StickyOwnerMetadata, type StickyOwnerPlaywrightBindTransport, type StickyOwnerState, type StickyOwnerTransport, STICKY_OWNER_SCHEMA_VERSION, } from './browser-session-state.js';
 export { attach, ATTACH_ERROR_CODES, ATTACH_OUTCOME_TYPES, type AttachErrorCode, type AttachFailureResult, type AttachOutcomeType, type AttachOptions, type AttachResult, type AttachSuccessResult, } from './commands/attach.js';
 export { AgentbrowseAssistiveRuntimeMissingError, AssistiveStructuredOutputTruncatedError, configureAgentbrowseAssistiveRuntime, resetAgentbrowseAssistiveRuntime, type AgentbrowseAssistiveChatCompletionOptions, type AgentbrowseAssistiveChatCompletionRequest, type AgentbrowseAssistiveChatCompletionResult, type AgentbrowseAssistiveChatMessage, type AgentbrowseAssistiveImageInput, type AgentbrowseAssistiveLlmClient, type AgentbrowseAssistiveLlmUsage, type AgentbrowseAssistiveMessageContentPart, type AgentbrowseAssistiveResponseModel, type AgentbrowseAssistiveRuntime, } from './assistive-runtime.js';
 export { createAgentbrowseClient, type AgentbrowseClient, type AgentbrowseClientOptions, } from './client.js';
 export { configureAgentbrowseDiagnostics, resetAgentbrowseDiagnostics, type DiagnosticArtifactManifest, type DiagnosticArtifactManifestInput, type AgentbrowseDiagnosticsHooks, type DiagnosticChildSpanInput, type DiagnosticLifecycleEventInput, type DiagnosticSnapshotInput, type DiagnosticStepFinishInput, type DiagnosticStepHandle, type DiagnosticStepStartInput, } from './diagnostics.js';
 export { setSolverConfigStoreOverride, type SolverConfigStoreOverride, } from './solver/config.js';
 export type { BrowserCommandSession } from './browser-session-state.js';
+export type { TargetDescriptor } from './runtime-state.js';
 export { browserStatus as status, BROWSER_STATUS_OUTCOME_TYPES, type BrowserStatusAliveResult, type BrowserStatusCurrentPageMismatch, type BrowserStatusNotRunningResult, type BrowserStatusOutcomeType, type BrowserStatusProtectedExposureResult, type BrowserStatusResult, type BrowserStatusRuntimeSummary, } from './commands/browser-status.js';
 export { actBrowser as act, ACT_ERROR_CODES, ACT_OUTCOME_TYPES, isBrowseAction, BROWSE_ACTIONS, type ActErrorCode, type ActExecutionFailureResult, type ActFailureResult, type ActOutcomeType, type ActPreflightFailureResult, type ActResult, type ActSuccessResult, type BrowseAction, } from './commands/act.js';
 export { extractBrowser as extract, EXTRACT_ERROR_CODES, EXTRACT_OUTCOME_TYPES, type ExtractErrorCode, type ExtractFailureResult, type ExtractOutcomeType, type ExtractResult, type ExtractSchemaDescriptor, type ExtractSchemaInput, type ExtractSchemaValue, type ExtractSuccessResult, } from './commands/extract.js';
 export { observeBrowser as observe, OBSERVE_ERROR_CODES, OBSERVE_OUTCOME_TYPES, type ObserveErrorCode, type ObserveExecutionMode, type ObserveFailureResult, type ObserveFillableForm, type ObserveOutcomeType, type ObserveResult, type ObserveScope, type ObserveSuccessResult, type ObserveSignal, type ObserveTarget, } from './commands/observe.js';
+export { classifyObservePageState, shouldSuppressFillableFormsForObserve, type ObservePageState, } from './commands/observe-page-state.js';
+export { resolveObservedField, type ObservedFieldCandidate, type ObservedFieldValueSource, type ObservedFieldValueType, type ResolveObservedFieldOptions, type ResolveObservedFieldResult, } from './secrets/observed-field-resolution.js';
 export { close, CLOSE_ERROR_CODES, CLOSE_OUTCOME_TYPES, type CloseErrorCode, type CloseFailureResult, type CloseOutcomeType, type CloseResult, type CloseSuccessResult, } from './commands/close.js';
+export { restoreBrowserSessionOwner, type RestoreBrowserSessionOwnerResult, } from './sticky-owner.js';
 export { launch, LAUNCH_ERROR_CODES, LAUNCH_OUTCOME_TYPES, type LaunchErrorCode, type LaunchOptions, type LaunchFailureResult, type LaunchOutcomeType, type LaunchResult, type LaunchSuccessResult, } from './commands/launch.js';
 export { navigateBrowser as navigate, NAVIGATE_ERROR_CODES, NAVIGATE_OUTCOME_TYPES, type NavigateErrorCode, type NavigateFailureResult, type NavigateOutcomeType, type NavigateResult, type NavigateSuccessResult, } from './commands/navigate.js';
 export { screenshotBrowser as screenshot, SCREENSHOT_ERROR_CODES, SCREENSHOT_OUTCOME_TYPES, type ScreenshotErrorCode, type ScreenshotFailureResult, type ScreenshotOutcomeType, type ScreenshotResult, type ScreenshotSuccessResult, } from './commands/screenshot.js';

package/dist/library.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../src/library.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../src/library.ts"],"names":[],"mappings":"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"}

package/dist/library.js

@@ -1,4 +1,4 @@
-export { createBrowserSessionStore, deleteBrowserSession, getSessionPort, isAttachedSession, isOwnedSession, isSessionAlive, loadBrowserSession, resolveBrowserSessionId, saveBrowserSession, serializeBrowserSession, supportsCaptchaSolve, buildAttachedSession, buildOwnedSession, } from './browser-session-state.js';
+export { createBrowserSessionStore, deleteBrowserSession, getSessionPort, isAttachedSession, isOwnedSession, isSessionAlive, loadBrowserSession, resolveBrowserSessionId, saveBrowserSession, serializeBrowserSession, supportsCaptchaSolve, buildAttachedSession, buildOwnedSession, buildStickyOwnerMetadata, canPersistStickyOwnerMetadata, STICKY_OWNER_SCHEMA_VERSION, } from './browser-session-state.js';
 export { attach, ATTACH_ERROR_CODES, ATTACH_OUTCOME_TYPES, } from './commands/attach.js';
 export { AgentbrowseAssistiveRuntimeMissingError, AssistiveStructuredOutputTruncatedError, configureAgentbrowseAssistiveRuntime, resetAgentbrowseAssistiveRuntime, } from './assistive-runtime.js';
 export { createAgentbrowseClient, } from './client.js';
@@ -8,7 +8,10 @@ export { browserStatus as status, BROWSER_STATUS_OUTCOME_TYPES, } from './comman
 export { actBrowser as act, ACT_ERROR_CODES, ACT_OUTCOME_TYPES, isBrowseAction, BROWSE_ACTIONS, } from './commands/act.js';
 export { extractBrowser as extract, EXTRACT_ERROR_CODES, EXTRACT_OUTCOME_TYPES, } from './commands/extract.js';
 export { observeBrowser as observe, OBSERVE_ERROR_CODES, OBSERVE_OUTCOME_TYPES, } from './commands/observe.js';
+export { classifyObservePageState, shouldSuppressFillableFormsForObserve, } from './commands/observe-page-state.js';
+export { resolveObservedField, } from './secrets/observed-field-resolution.js';
 export { close, CLOSE_ERROR_CODES, CLOSE_OUTCOME_TYPES, } from './commands/close.js';
+export { restoreBrowserSessionOwner, } from './sticky-owner.js';
 export { launch, LAUNCH_ERROR_CODES, LAUNCH_OUTCOME_TYPES, } from './commands/launch.js';
 export { navigateBrowser as navigate, NAVIGATE_ERROR_CODES, NAVIGATE_OUTCOME_TYPES, } from './commands/navigate.js';
 export { screenshotBrowser as screenshot, SCREENSHOT_ERROR_CODES, SCREENSHOT_OUTCOME_TYPES, } from './commands/screenshot.js';

package/dist/protected-fill.d.ts

@@ -1,5 +1,5 @@
 import type { BrowserSessionState } from './browser-session-state.js';
-import type { FillableFormFieldBinding, FillableFormPresence, ProtectedBindingValueHint, ProtectedFieldPolicy, StoredSecretFieldKey, StoredSecretFieldPolicies } from './secrets/types.js';
+import type { FillableFormFieldBinding, FillableFormPresence, LoginStepKind, ProtectedBindingValueHint, ProtectedFieldPolicy, StoredSecretFieldKey, StoredSecretFieldPolicies } from './secrets/types.js';
 import type { ProtectedExactValueProfile } from './runtime-state.js';
 /** Canonical stored protected field keys supported by AgentBrowse protected fill. */
 export type ProtectedFieldKey = StoredSecretFieldKey;
@@ -17,6 +17,7 @@ export interface ProtectedFillForm {
     pageRef: string;
     scopeRef?: string;
     purpose: string;
+    loginStep?: LoginStepKind;
     presence?: ProtectedFillPresence;
     scopeEpoch?: number;
     fields: ProtectedFillFieldBinding[];
@@ -47,7 +48,7 @@ export type ProtectedFillExecution = {
     fieldErrors: ProtectedFieldError[];
 } | {
     kind: 'unexpected_error';
-    reason: 'missing_protected_value' | 'unsupported_protected_field_group' | 'deterministic_only_resolution_failed' | 'assisted_value_resolution_failed' | 'action_failed';
+    reason: 'missing_protected_value' | 'unsupported_protected_field_group' | 'deterministic_only_resolution_failed' | 'assisted_value_resolution_failed' | 'action_failed' | 'ambiguous_date_value' | 'incomplete_date_value' | 'invalid_date_value';
 };
 export type FillProtectedFormResult = {
     success: true;

package/dist/protected-fill.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protected-fill.d.ts","sourceRoot":"","sources":["../src/protected-fill.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"protected-fill.d.ts","sourceRoot":"","sources":["../src/protected-fill.ts"],"names":[],"mappings":"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"}

package/dist/protected-fill.js

@@ -1,13 +1,52 @@
-import { fillProtectedFormBrowser, } from './protected-fill-browser.js';
 import { buildProtectedExactValueProfile as buildProtectedExactValueProfileInternal } from './secrets/protected-exact-value-redaction.js';
+import { executeProtectedFill } from './secrets/protected-fill.js';
+import { resolvePageByRef, syncSessionPage } from './playwright-runtime.js';
+import { withStickyOwnerBrowser } from './sticky-owner.js';
 /** Fills a previously observed protected form with caller-provided protected values. */
 export async function fillProtectedForm(params) {
-    return (await fillProtectedFormBrowser({
-        session: params.session,
-        fillableForm: params.fillableForm,
-        protectedValues: params.protectedValues,
-        fieldPolicies: params.fieldPolicies,
-    }));
+    try {
+        return await withStickyOwnerBrowser(params.session, async (browser) => {
+            try {
+                const page = await resolvePageByRef(browser, params.session, params.fillableForm.pageRef).catch((error) => {
+                    throw new Error(error instanceof Error ? error.message : String(error));
+                });
+                const { url, title } = await syncSessionPage(params.session, params.fillableForm.pageRef, page);
+                const execution = await executeProtectedFill({
+                    session: params.session,
+                    page,
+                    fillableForm: params.fillableForm,
+                    protectedValues: Object.fromEntries(Object.entries(params.protectedValues).filter((entry) => {
+                        const value = entry[1];
+                        return typeof value === 'string' && value.length > 0;
+                    })),
+                    fieldPolicies: params.fieldPolicies,
+                });
+                return {
+                    success: true,
+                    pageRef: params.fillableForm.pageRef,
+                    url,
+                    title,
+                    execution,
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: 'page_resolution_failed',
+                    message: 'Protected fill could not resolve the target page in the browser.',
+                    reason: error instanceof Error ? error.message : String(error),
+                };
+            }
+        });
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: 'browser_connection_failed',
+            message: 'Protected fill could not reach the browser session.',
+            reason: error instanceof Error ? error.message : String(error),
+        };
+    }
 }
 export function buildProtectedExposureArtifacts(params) {
     const filteredProtectedValues = Object.fromEntries(Object.entries(params.protectedValues).filter((entry) => {

package/dist/runtime-protected-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-protected-state.d.ts","sourceRoot":"","sources":["../src/runtime-protected-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAwB,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEtF,OAAO,EAIL,KAAK,sBAAsB,EAC5B,MAAM,oBAAoB,CAAC;AAyC5B,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,aAAa,CAAC,qBAAqB,CAAC,GAC1C,qBAAqB,EAAE,CAYzB;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,qBAAqB,EAAE,SAAS,CAAC,CAAC,EAC5D,OAAO,GAAE;IACP,uBAAuB,CAAC,EAAE,OAAO,CAAC;CAC9B,GACL,qBAAqB,EAAE,CAgDzB;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,MAAM,GACd,qBAAqB,EAAE,CAuBzB;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,MAAM,GACd,qBAAqB,EAAE,CAmBzB;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,MAAM,GACd,qBAAqB,GAAG,IAAI,CAI9B;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,EAAE,sBAAsB,GAC/B,sBAAsB,CAKxB;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,MAAM,GACd,sBAAsB,GAAG,IAAI,CAG/B;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAS3F"}
+{"version":3,"file":"runtime-protected-state.d.ts","sourceRoot":"","sources":["../src/runtime-protected-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAwB,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEtF,OAAO,EAIL,KAAK,sBAAsB,EAC5B,MAAM,oBAAoB,CAAC;AAmD5B,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,aAAa,CAAC,qBAAqB,CAAC,GAC1C,qBAAqB,EAAE,CAYzB;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,qBAAqB,EAAE,SAAS,CAAC,CAAC,EAC5D,OAAO,GAAE;IACP,uBAAuB,CAAC,EAAE,OAAO,CAAC;CAC9B,GACL,qBAAqB,EAAE,CAgDzB;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,MAAM,GACd,qBAAqB,EAAE,CAuBzB;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,MAAM,GACd,qBAAqB,EAAE,CAmBzB;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,MAAM,GACd,qBAAqB,GAAG,IAAI,CAI9B;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,EAAE,sBAAsB,GAC/B,sBAAsB,CAKxB;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,MAAM,GACd,sBAAsB,GAAG,IAAI,CAG/B;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAS3F"}

package/dist/runtime-protected-state.js

@@ -14,7 +14,14 @@ function fillableFormIdentity(form) {
         .map((field) => logicalProtectedBindingKey(field))
         .sort()
         .join('|');
-    return [form.pageRef, form.scopeRef ?? '', form.purpose, fieldsKey].join('||');
+    return [
+        form.pageRef,
+        form.scopeRef ?? '',
+        form.pageFormSelector ?? '',
+        form.purpose,
+        form.loginStep ?? '',
+        fieldsKey,
+    ].join('||');
 }
 function normalizeFillableForm(runtime, form) {
     const pageScopeEpoch = runtime.pages[form.pageRef]?.scopeEpoch ?? 0;

package/dist/runtime-state.d.ts

@@ -62,11 +62,21 @@ export interface TargetValidationEvidence {
     message?: string;
     errorStyling?: boolean;
 }
+export interface TargetSelectionItem {
+    label: string;
+    selected?: true;
+    removable?: boolean;
+}
+export interface TargetSelectionState {
+    mode: 'single' | 'multiple';
+    items: TargetSelectionItem[];
+}
 export interface TargetDescriptor {
     ref: string;
     pageRef: string;
     framePath?: string[];
     frameUrl?: string;
+    pageFormSelector?: string;
     kind?: string;
     label?: string;
     displayLabel?: string;
@@ -78,6 +88,7 @@ export interface TargetDescriptor {
     surfaceKind?: string;
     controlsSurfaceSelector?: string;
     validation?: TargetValidationEvidence;
+    selection?: TargetSelectionState;
     capability: TargetCapability;
     lifecycle: TargetLifecycle;
     availability: TargetAvailabilityState;