@nuanu-ai/agentbrowse 0.2.23 → 0.2.24

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

@@ -1 +1 @@
-{"version":3,"file":"act.d.ts","sourceRoot":"","sources":["../../src/commands/act.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAqCnD,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAyHxF,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC;AAC1C,YAAY,EAAE,YAAY,EAAE,CAAC;AA4V7B,wBAAsB,GAAG,CACvB,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EACpB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAmsBf"}
+{"version":3,"file":"act.d.ts","sourceRoot":"","sources":["../../src/commands/act.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAsCnD,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AA2HxF,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC;AAC1C,YAAY,EAAE,YAAY,EAAE,CAAC;AA4V7B,wBAAsB,GAAG,CACvB,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EACpB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAitBf"}

package/dist/commands/act.js

@@ -7,6 +7,7 @@ import { outputContractFailure, outputFailure, outputJSON } from '../output.js';
 import { capturePageObservation, captureLocatorContextHash, captureLocatorState, createAcceptanceProbe, diagnoseNoObservableProgress, genericClickObservationChanged, locatorStateChanged, pageObservationChanged, rankLocatorCandidates, shouldVerifyObservableProgress, waitForAcceptanceProbe, } from './action-acceptance.js';
 import { captureActionFailureArtifacts, startActionTrace } from './action-artifacts.js';
 import { buildLocator, resolveLocatorRoot } from './action-fallbacks.js';
+import { clickActivationStrategyForTarget } from './click-activation-policy.js';
 import { resolveSubmitResult } from './action-result-resolution.js';
 import { projectActionValue } from './action-value-projection.js';
 import { applyActionWithFallbacks } from './action-executor.js';
@@ -23,6 +24,7 @@ function ensureValue(action, value) {
         return value;
     throw new Error(`Act value is required for action: ${action}`);
 }
+const MUTABLE_FIELD_REBIND_RETRY_DELAYS_MS = [0, 25, 50];
 function emitActPreflightFailure(params) {
     return outputContractFailure({
         error: params.error,
@@ -465,30 +467,41 @@ export async function act(session, targetRef, action, value) {
             if (!liveTarget.domSignature) {
                 return false;
             }
-            const snapshot = await readLocatorBindingSnapshot(resolvedLocator).catch(() => null);
-            if (!snapshot?.domSignature || snapshot.domSignature === liveTarget.domSignature) {
-                return false;
-            }
-            if (!isCompatibleMutableFieldBinding(liveTarget, snapshot)) {
-                return false;
-            }
-            attempts.push(`domSignature.rebound:${strategy}`);
-            const updatedTarget = updateTarget(session, targetRef, {
-                domSignature: snapshot.domSignature,
-                label: snapshot.label ?? liveTarget.label,
-                lifecycle: 'live',
-                lifecycleReason: undefined,
-                availability: { state: 'available' },
-                semantics: {
-                    ...liveTarget.semantics,
-                    name: snapshot.label ?? liveTarget.semantics?.name,
-                    role: snapshot.role ?? liveTarget.semantics?.role,
-                },
-            });
-            if (updatedTarget) {
-                liveTarget = updatedTarget;
+            for (let attemptIndex = 0; attemptIndex < MUTABLE_FIELD_REBIND_RETRY_DELAYS_MS.length; attemptIndex += 1) {
+                const delayMs = MUTABLE_FIELD_REBIND_RETRY_DELAYS_MS[attemptIndex] ?? 0;
+                if (attemptIndex > 0) {
+                    attempts.push(`domSignature.rebind.retry:${strategy}:${attemptIndex + 1}`);
+                    await new Promise((resolve) => setTimeout(resolve, delayMs));
+                }
+                const snapshot = await readLocatorBindingSnapshot(resolvedLocator).catch(() => null);
+                if (!snapshot?.domSignature) {
+                    continue;
+                }
+                if (snapshot.domSignature === liveTarget.domSignature) {
+                    return false;
+                }
+                if (!isCompatibleMutableFieldBinding(liveTarget, snapshot)) {
+                    continue;
+                }
+                attempts.push(`domSignature.rebound:${strategy}`);
+                const updatedTarget = updateTarget(session, targetRef, {
+                    domSignature: snapshot.domSignature,
+                    label: snapshot.label ?? liveTarget.label,
+                    lifecycle: 'live',
+                    lifecycleReason: undefined,
+                    availability: { state: 'available' },
+                    semantics: {
+                        ...liveTarget.semantics,
+                        name: snapshot.label ?? liveTarget.semantics?.name,
+                        role: snapshot.role ?? liveTarget.semantics?.role,
+                    },
+                });
+                if (updatedTarget) {
+                    liveTarget = updatedTarget;
+                }
+                return true;
             }
-            return true;
+            return false;
         };
         const assertResolvedTargetStillValid = async (resolvedLocator, stage) => {
             if (liveTarget.pageSignature &&
@@ -596,6 +609,7 @@ export async function act(session, targetRef, action, value) {
                 });
                 attempts.push(`resolve:${strategy}`);
                 const usedFallback = await applyActionWithFallbacks(page, locatorRoot, resolvedLocator, action, executionValue, attempts, target.controlFamily, {
+                    clickActivationStrategy: clickActivationStrategyForTarget(target, action),
                     guards: {
                         assertStillValid: async (stage) => {
                             await assertResolvedTargetStillValid(resolvedLocator, stage);

package/dist/commands/action-executor.d.ts

@@ -3,9 +3,11 @@ import type { TargetControlFamily } from '../runtime-state.js';
 import type { BrowseAction } from './browse-actions.js';
 import type { LocatorRoot } from './action-fallbacks.js';
 import type { ActionExecutionGuards } from './action-execution-guards.js';
+import type { ClickActivationStrategy } from './click-activation-policy.js';
 type ActionExecutionOptions = {
     beforeClickRetry?: () => Promise<void>;
     guards?: ActionExecutionGuards;
+    clickActivationStrategy?: ClickActivationStrategy;
 };
 export declare function applyActionWithFallbacks(page: Page, root: LocatorRoot, locator: Locator, action: BrowseAction, value: string | undefined, attempts: string[], family?: TargetControlFamily, options?: ActionExecutionOptions): Promise<boolean>;
 export {};

package/dist/commands/action-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action-executor.d.ts","sourceRoot":"","sources":["../../src/commands/action-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAc1E,KAAK,sBAAsB,GAAG;IAC5B,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,CAAC,EAAE,qBAAqB,CAAC;CAChC,CAAC;AAEF,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,QAAQ,EAAE,MAAM,EAAE,EAClB,MAAM,CAAC,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,OAAO,CAAC,CAqDlB"}
+{"version":3,"file":"action-executor.d.ts","sourceRoot":"","sources":["../../src/commands/action-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAc5E,KAAK,sBAAsB,GAAG;IAC5B,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;CACnD,CAAC;AAEF,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,QAAQ,EAAE,MAAM,EAAE,EAClB,MAAM,CAAC,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,OAAO,CAAC,CAsDlB"}

package/dist/commands/action-executor.js

@@ -14,6 +14,7 @@ export async function applyActionWithFallbacks(page, root, locator, action, valu
                 return applyTriggerAction(page, locator, attempts, {
                     beforeRetry: options?.beforeClickRetry,
                     guards: options?.guards,
+                    clickActivationStrategy: options?.clickActivationStrategy,
                 });
             }
             return applyEditableClickAction(page, locator, attempts, {

package/dist/commands/click-action-executor.d.ts

@@ -1,8 +1,10 @@
 import type { Locator, Page } from 'playwright-core';
+import type { ClickActivationStrategy } from './click-activation-policy.js';
 import { type ActionExecutionGuards } from './action-execution-guards.js';
 type ClickRetryOptions = {
     beforeRetry?: () => Promise<void>;
     guards?: ActionExecutionGuards;
+    clickActivationStrategy?: ClickActivationStrategy;
 };
 export declare function applyEditableClickAction(page: Page, locator: Locator, attempts: string[], options?: ClickRetryOptions): Promise<boolean>;
 export declare function applyTriggerAction(page: Page, locator: Locator, attempts: string[], options?: ClickRetryOptions): Promise<boolean>;

package/dist/commands/click-action-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"click-action-executor.d.ts","sourceRoot":"","sources":["../../src/commands/click-action-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAMrD,OAAO,EAA2B,KAAK,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAEnG,KAAK,iBAAiB,GAAG;IACvB,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,qBAAqB,CAAC;CAChC,CAAC;AA+FF,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,OAAO,CAAC,CAElB;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,OAAO,CAAC,CAElB"}
+{"version":3,"file":"click-action-executor.d.ts","sourceRoot":"","sources":["../../src/commands/click-action-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAMrD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAA2B,KAAK,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAEnG,KAAK,iBAAiB,GAAG;IACvB,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;CACnD,CAAC;AA2GF,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,OAAO,CAAC,CAElB;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,OAAO,CAAC,CAElB"}

package/dist/commands/click-action-executor.js

@@ -28,6 +28,17 @@ async function ensureLocatorRetryReady(locator, error, options) {
 }
 async function applyClickSequence(page, locator, attempts, options) {
     await handoffFocusFromActiveIframe(locator, attempts);
+    if (options?.clickActivationStrategy === 'dom') {
+        await runActionExecutionGuard(options?.guards, 'click.evaluate.primary');
+        attempts.push('locator.evaluate.click.primary');
+        await locator.evaluate((element) => {
+            if (!(element instanceof HTMLElement)) {
+                throw new Error('unsupported_js_click_fallback');
+            }
+            element.click();
+        });
+        return false;
+    }
     attempts.push('locator.click');
     try {
         await locator.click({ timeout: LOCATOR_CLICK_TIMEOUT_MS });

package/dist/commands/click-activation-policy.d.ts

@@ -0,0 +1,5 @@
+import type { TargetDescriptor } from '../runtime-state.js';
+import type { BrowseAction } from './browse-actions.js';
+export type ClickActivationStrategy = 'pointer' | 'dom';
+export declare function clickActivationStrategyForTarget(target: Pick<TargetDescriptor, 'kind' | 'framePath' | 'semantics'>, action: BrowseAction): ClickActivationStrategy;
+//# sourceMappingURL=click-activation-policy.d.ts.map

package/dist/commands/click-activation-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"click-activation-policy.d.ts","sourceRoot":"","sources":["../../src/commands/click-activation-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,KAAK,CAAC;AAExD,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,WAAW,GAAG,WAAW,CAAC,EAClE,MAAM,EAAE,YAAY,GACnB,uBAAuB,CAezB"}

package/dist/commands/click-activation-policy.js

@@ -0,0 +1,13 @@
+export function clickActivationStrategyForTarget(target, action) {
+    if (action !== 'click') {
+        return 'pointer';
+    }
+    const withinIframe = Boolean(target.framePath?.length);
+    if (!withinIframe) {
+        return 'pointer';
+    }
+    const kind = target.kind?.trim().toLowerCase();
+    const role = target.semantics?.role?.trim().toLowerCase();
+    const isTab = kind === 'tab' || role === 'tab';
+    return isTab ? 'dom' : 'pointer';
+}

package/dist/commands/launch.js

@@ -9,7 +9,7 @@ import { findChromePid } from '../stagehand.js';
 import { applyAgentpayGatewayEnv, tryResolveAgentpayGatewayConfig } from '../agentpay-gateway.js';
 import { connectPlaywright, disconnectPlaywright, syncLaunchPage } from '../playwright-runtime.js';
 import { summarizeSecretCatalog, syncSecretCatalogForUrl } from '../secrets/catalog-sync.js';
-import { terminateOwnedPid } from '../owned-process.js';
+import { cleanupManagedBrowserPids, terminateOwnedPid } from '../owned-process.js';
 import { info } from '../output.js';
 const DEFAULT_PROFILE = 'default';
 const COMPACT_WINDOW = {
@@ -30,12 +30,22 @@ export async function launch(url, opts) {
 }
 async function cleanupOwnedSession() {
     const existingSession = loadSession();
-    if (!isOwnedSession(existingSession)) {
-        return null;
+    const excludePids = new Set();
+    if (isOwnedSession(existingSession)) {
+        excludePids.add(existingSession.pid);
+        const termination = await terminateOwnedPid(existingSession.pid);
+        if (termination === 'still_alive') {
+            return buildLaunchFailure(new Error(`Existing owned browser pid ${existingSession.pid} did not exit after SIGTERM/SIGKILL.`));
+        }
+    }
+    // Phase-1 ownership removed port-global prekill, so launch needs a second guardrail
+    // for crashes that happen before a session record is persisted or cleaned up.
+    const orphanCleanup = await cleanupManagedBrowserPids({ excludePids });
+    if (orphanCleanup.blocked.length > 0) {
+        return buildLaunchFailure(new Error(`Orphaned managed browser pid${orphanCleanup.blocked.length === 1 ? '' : 's'} ${orphanCleanup.blocked.join(', ')} did not exit after SIGTERM/SIGKILL.`));
     }
-    const termination = await terminateOwnedPid(existingSession.pid);
-    if (termination === 'still_alive') {
-        return buildLaunchFailure(new Error(`Existing owned browser pid ${existingSession.pid} did not exit after SIGTERM/SIGKILL.`));
+    if (orphanCleanup.terminated.length > 0) {
+        info(`[launch] cleaned up orphaned managed browser pid${orphanCleanup.terminated.length === 1 ? '' : 's'} ${orphanCleanup.terminated.join(', ')}`);
     }
     return null;
 }

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,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;AAyCtF,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,oBAAoB,GAC1B,mBAAmB,GAAG,SAAS,CAuCjC;AAsCD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAYxE;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,oBAAoB,GAAG,mBAAmB,EAAE,CA6F/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,CAiDpC"}
+{"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,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;AAyCtF,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,oBAAoB,GAC1B,mBAAmB,GAAG,SAAS,CAuCjC;AAsCD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAYxE;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,oBAAoB,GAAG,mBAAmB,EAAE,CAoG/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,CAiDpC"}

package/dist/control-semantics.js

@@ -148,7 +148,12 @@ export function inferAllowedActionsFromFacts(facts) {
         actions.add('click');
         actions.add('press');
     }
-    if (kind === 'button' || kind === 'link' || role === 'button' || role === 'link') {
+    if (kind === 'button' ||
+        kind === 'link' ||
+        kind === 'tab' ||
+        role === 'button' ||
+        role === 'link' ||
+        role === 'tab') {
         actions.add('click');
         actions.add('press');
     }

package/dist/owned-process.d.ts

@@ -1,4 +1,14 @@
 export type OwnedPidTerminationResult = 'not_found' | 'terminated' | 'sigkilled' | 'still_alive';
+export type ManagedBrowserCleanupResult = {
+    terminated: number[];
+    blocked: number[];
+};
 export declare function isPidAlive(pid: number): boolean;
 export declare function terminateOwnedPid(pid: number): Promise<OwnedPidTerminationResult>;
+export declare function cleanupManagedBrowserPids(options?: {
+    excludePids?: Iterable<number>;
+}): Promise<ManagedBrowserCleanupResult>;
+export declare function listManagedBrowserPids(options?: {
+    processTable?: string;
+}): number[];
 //# sourceMappingURL=owned-process.d.ts.map

package/dist/owned-process.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"owned-process.d.ts","sourceRoot":"","sources":["../src/owned-process.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,yBAAyB,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,aAAa,CAAC;AAEjG,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAW/C;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAsBvF"}
+{"version":3,"file":"owned-process.d.ts","sourceRoot":"","sources":["../src/owned-process.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,yBAAyB,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,aAAa,CAAC;AACjG,MAAM,MAAM,2BAA2B,GAAG;IACxC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAW/C;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAsBvF;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;CAAO,GAC/C,OAAO,CAAC,2BAA2B,CAAC,CAqBtC;AAED,wBAAgB,sBAAsB,CACpC,OAAO,GAAE;IACP,YAAY,CAAC,EAAE,MAAM,CAAC;CAClB,GACL,MAAM,EAAE,CAuBV"}

package/dist/owned-process.js

@@ -1,7 +1,14 @@
+import { execFileSync } from 'node:child_process';
+import { homedir } from 'node:os';
+import path from 'node:path';
 const TERM_WAIT_ATTEMPTS = 10;
 const TERM_WAIT_MS = 100;
 const KILL_WAIT_ATTEMPTS = 5;
 const KILL_WAIT_MS = 20;
+const MANAGED_PROFILE_ROOTS = [
+    path.join(homedir(), '.agentpay', 'agentbrowse', 'profiles'),
+    path.join(homedir(), '.agentpay', 'solver', 'profiles'),
+];
 export function isPidAlive(pid) {
     try {
         process.kill(pid, 0);
@@ -36,6 +43,45 @@ export async function terminateOwnedPid(pid) {
     }
     return 'still_alive';
 }
+export async function cleanupManagedBrowserPids(options = {}) {
+    const excludePids = new Set(options.excludePids ?? []);
+    const terminated = [];
+    const blocked = [];
+    for (const pid of listManagedBrowserPids()) {
+        if (excludePids.has(pid)) {
+            continue;
+        }
+        const result = await terminateOwnedPid(pid);
+        if (result === 'still_alive') {
+            blocked.push(pid);
+            continue;
+        }
+        if (result !== 'not_found') {
+            terminated.push(pid);
+        }
+    }
+    return { terminated, blocked };
+}
+export function listManagedBrowserPids(options = {}) {
+    const processTable = options.processTable ?? readProcessTable();
+    const pids = new Set();
+    for (const line of processTable.split(/\r?\n/)) {
+        const match = line.trimStart().match(/^(\d+)\s+(.*)$/);
+        if (!match) {
+            continue;
+        }
+        const pid = Number(match[1]);
+        const command = match[2] ?? '';
+        if (!Number.isFinite(pid) || pid <= 0 || pid === process.pid) {
+            continue;
+        }
+        if (!isManagedBrowserCommand(command)) {
+            continue;
+        }
+        pids.add(pid);
+    }
+    return Array.from(pids);
+}
 async function waitForPidExit(pid, attempts, intervalMs) {
     for (let attempt = 0; attempt < attempts; attempt++) {
         if (!isPidAlive(pid)) {
@@ -55,3 +101,31 @@ function getErrorCode(error) {
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
+function readProcessTable() {
+    try {
+        return execFileSync('ps', ['-Ao', 'pid=,command='], { encoding: 'utf-8' });
+    }
+    catch {
+        return '';
+    }
+}
+function isManagedBrowserCommand(command) {
+    if (!command.includes('--remote-debugging-address=127.0.0.1')) {
+        return false;
+    }
+    const userDataDir = readCommandFlag(command, '--user-data-dir');
+    if (!userDataDir) {
+        return false;
+    }
+    const normalizedUserDataDir = path.resolve(userDataDir);
+    return MANAGED_PROFILE_ROOTS.some((root) => isWithinRoot(normalizedUserDataDir, root));
+}
+function readCommandFlag(command, flag) {
+    const escapedFlag = flag.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const match = command.match(new RegExp(`${escapedFlag}=(?:"([^"]+)"|'([^']+)'|(\\S+))`));
+    return match?.[1] ?? match?.[2] ?? match?.[3] ?? null;
+}
+function isWithinRoot(candidatePath, rootPath) {
+    const relative = path.relative(rootPath, candidatePath);
+    return relative.length > 0 && !relative.startsWith(`..${path.sep}`) && relative !== '..';
+}

package/dist/solver/browser-launcher.js

@@ -90,14 +90,9 @@ async function discoverCdpUrl(options) {
         }
         else {
             const activePort = readDevToolsActivePort(activePortPath);
-            if (activePort?.browserWSEndpoint) {
-                return activePort.browserWSEndpoint;
-            }
-            if (activePort?.port) {
-                const cdpUrl = await discoverCdpUrlOnPort(activePort.port);
-                if (cdpUrl) {
-                    return cdpUrl;
-                }
+            const discoveredViaActivePort = await discoverCdpUrlFromActivePort(activePort);
+            if (discoveredViaActivePort) {
+                return discoveredViaActivePort;
             }
         }
         await sleep(CDP_DISCOVERY_INTERVAL_MS);
@@ -117,6 +112,38 @@ async function discoverCdpUrlOnPort(port) {
         return null;
     }
 }
+async function discoverCdpUrlFromActivePort(activePort) {
+    if (!activePort) {
+        return null;
+    }
+    const candidatePorts = new Set();
+    if (activePort.browserWSEndpoint) {
+        const wsPort = portFromBrowserWSEndpoint(activePort.browserWSEndpoint);
+        if (wsPort) {
+            candidatePorts.add(wsPort);
+        }
+    }
+    if (activePort.port > 0) {
+        candidatePorts.add(activePort.port);
+    }
+    for (const port of candidatePorts) {
+        const cdpUrl = await discoverCdpUrlOnPort(port);
+        if (cdpUrl) {
+            return cdpUrl;
+        }
+    }
+    return null;
+}
+function portFromBrowserWSEndpoint(browserWSEndpoint) {
+    try {
+        const url = new URL(browserWSEndpoint);
+        const port = Number(url.port);
+        return Number.isFinite(port) && port > 0 ? port : null;
+    }
+    catch {
+        return null;
+    }
+}
 function readDevToolsActivePort(activePortPath) {
     if (!existsSync(activePortPath)) {
         return null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuanu-ai/agentbrowse",
-  "version": "0.2.23",
+  "version": "0.2.24",
   "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": [