@nuanu-ai/agentbrowse 0.2.48 → 0.2.50

package/README.md

@@ -53,6 +53,12 @@ agentbrowse init ap_...
 agentbrowse init ap_... --api-url https://your-project.supabase.co/functions/v1/api
 ```
 
+Check AgentPay setup health and the authenticated agent profile:
+
+```bash
+agentbrowse status
+```
+
 Launch browser and optionally navigate:
 
 ```bash
@@ -65,6 +71,18 @@ that page. Avoid `launch` on a blank tab followed immediately by
 `start-session` and `navigate`, because the first workflow session and timeline
 will otherwise begin on the current page state, often `about:blank`.
 
+`launch` is direct/proxyless by default. Add `--proxy` only when you want to
+use a proxy for the current run:
+
+```bash
+agentbrowse launch https://example.com --proxy
+agentbrowse launch https://example.com --proxy http://proxy.example:8080
+agentbrowse launch https://example.com --proxy=http://proxy.example:8080
+```
+
+Bare `--proxy` uses `defaults.proxy` from the config. Passing a URL after
+`--proxy` (or via `--proxy=...`) is a one-off override and does not persist it.
+
 If an older workflow session is still open in the persisted browser context,
 `launch` cancels that session first before replacing the browser record.
 
@@ -139,10 +157,10 @@ agentbrowse screenshot
 agentbrowse screenshot --path ./checkout.png
 ```
 
-Inspect or close the current session:
+Inspect the launched browser or close the current workflow/browser session:
 
 ```bash
-agentbrowse status
+agentbrowse browser-status
 agentbrowse end-session
 agentbrowse close
 ```
@@ -195,21 +213,30 @@ overrides.
   not an additional runtime config source
 - all commands require AgentPay gateway configuration; prefer `agentbrowse init`
   and use env vars only as runtime overrides
-- `launch` is technical browser bootstrap only; it does not start workflow telemetry, but when the first working page is already known, prefer `launch <url>` so the workflow starts on the real page instead of `about:blank`
+- `status` checks AgentPay gateway health through `GET /api/agent/me` and
+  returns the authenticated agent profile on success
+- `launch` is technical browser bootstrap only; it does not start a workflow session or observability export, but when the first working page is already known, prefer `launch <url>` so the workflow starts on the real page instead of `about:blank`
 - `launch` fail-closes an older active workflow session before replacing the persisted browser context
 - `start-session` starts the active workflow/run context on top of the current browser session
 - `start-session` creates the backend product session through `POST /api/sessions`
+- `start-session` exports the run root trace separately through `POST /api/observability/telemetry/traces`
 - `start-session` may optionally attach `merchant_name` when the vendor is already known from the visible page or task context
 - re-running `start-session` fail-closes the older active workflow session through `POST /api/sessions/:id/complete` before creating a new one
-- page/runtime commands such as `navigate`, `observe`, `act`, `extract`, `screenshot`, `status`, `solve-captcha`, `request-secret`, `poll-secret`, and `fill-secret` require that active product session; `launch` alone is not enough
+- page/runtime workflow commands such as `navigate`, `observe`, `act`,
+  `extract`, `screenshot`, `solve-captcha`, `request-secret`, `poll-secret`,
+  and `fill-secret` require that active product session; `launch` alone is not
+  enough
+- `browser-status` is a browser/page/runtime diagnostic for a launched browser
+  session; it does not require an active workflow session
 - use `navigate` for explicit later URL transitions inside an active workflow session, not as a mandatory first step when the initial page is already known
 - `end-session` completes the active workflow session through `POST /api/sessions/:id/complete` and keeps the browser session alive
 - normal successful workflow close-out should use `end-session`; `close` is browser teardown and cancels any still-active workflow session instead of completing it successfully
 - `POST /api/sessions/:id/complete` is the only terminal session transition; ordinary `POST /api/sessions/:id/events` exports are non-terminal by contract
-- the same `start-session` request also carries the current telemetry envelope in the same OTLP structure that browse-cli already exports today
-- backend fan-out forwards that telemetry envelope through the existing telemetry ingest/index/forward path instead of inventing a new telemetry schema from product session fields
 - after `start-session`, ordinary workflow-relevant command step exports go through `POST /api/sessions/:id/events`
-- `status` stays local to the CLI as a diagnostic probe and does not emit workflow session events
+- ordinary workflow-relevant command step traces export separately through `POST /api/observability/telemetry/traces`
+- observability export is best-effort and must not rewrite the outcome of the product session mutation that ran before it
+- `browser-status` stays local to the CLI as a diagnostic probe and does not
+  emit workflow session events
 - `close` auto-cancels an active workflow session through `POST /api/sessions/:id/complete` before deleting the local browser session record
 - protected requests are session-bound:
   - `get-secrets-catalog(url?)` reads host-filtered catalog metadata through `GET /api/sessions/:id/secrets/catalog`

package/dist/agentpay-gateway.d.ts

@@ -6,6 +6,7 @@ export declare function tryResolveAgentpayGatewayConfig(): AgentpayGatewayConfig
 export declare function resolveAgentpayGatewayConfig(): AgentpayGatewayConfig;
 export declare function applyAgentpayGatewayEnv(gateway: AgentpayGatewayConfig): void;
 export declare function buildAgentpayTelemetryTracesUrl(apiUrl: string): string;
+export declare function buildAgentpayAgentMeUrl(apiUrl: string): string;
 export declare function buildAgentpaySessionsUrl(apiUrl: string): string;
 export declare function buildAgentpaySessionUrl(apiUrl: string, sessionId: string): string;
 export declare function buildAgentpaySessionSecretsCatalogUrl(apiUrl: string, sessionId: string): string;

package/dist/agentpay-gateway.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agentpay-gateway.d.ts","sourceRoot":"","sources":["../src/agentpay-gateway.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAgBD,wBAAgB,+BAA+B,IAAI,qBAAqB,GAAG,IAAI,CAgB9E;AAED,wBAAgB,4BAA4B,IAAI,qBAAqB,CAMpE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAG5E;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED,wBAAgB,qCAAqC,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE/F;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvF;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzF;AAED,wBAAgB,qCAAqC,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE/F;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,MAAM,CAER;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,MAAM,CAKR;AAED,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAI/E"}
+{"version":3,"file":"agentpay-gateway.d.ts","sourceRoot":"","sources":["../src/agentpay-gateway.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAgBD,wBAAgB,+BAA+B,IAAI,qBAAqB,GAAG,IAAI,CAgB9E;AAED,wBAAgB,4BAA4B,IAAI,qBAAqB,CAMpE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAG5E;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED,wBAAgB,qCAAqC,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE/F;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvF;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzF;AAED,wBAAgB,qCAAqC,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE/F;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,MAAM,CAER;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,MAAM,CAER;AAED,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAI/E"}

package/dist/agentpay-gateway.js

@@ -1,5 +1,5 @@
 import { readConfig } from './solver/config.js';
-const DEFAULT_AGENTPAY_API_URL = 'https://durcottggsiesxxqzvbb.supabase.co/functions/v1/api';
+import { DEFAULT_AGENTPAY_API_URL } from './generated/build-config.js';
 function trimOrUndefined(value) {
     if (!value)
         return undefined;
@@ -38,7 +38,10 @@ export function applyAgentpayGatewayEnv(gateway) {
     process.env.AGENTPAY_API_URL = gateway.apiUrl;
 }
 export function buildAgentpayTelemetryTracesUrl(apiUrl) {
-    return appendApiPath(apiUrl, '/telemetry/traces');
+    return appendApiPath(apiUrl, '/observability/telemetry/traces');
+}
+export function buildAgentpayAgentMeUrl(apiUrl) {
+    return appendApiPath(apiUrl, '/agent/me');
 }
 export function buildAgentpaySessionsUrl(apiUrl) {
     return appendApiPath(apiUrl, '/sessions');

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;AAiCnD,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAiNxF,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC;AAC1C,YAAY,EAAE,YAAY,EAAE,CAAC;AAkR7B,wBAAsB,GAAG,CACvB,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EACpB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CA01Bf"}
+{"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;AAiCnD,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AA8MxF,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC;AAC1C,YAAY,EAAE,YAAY,EAAE,CAAC;AA+R7B,wBAAsB,GAAG,CACvB,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EACpB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CA40Bf"}

package/dist/commands/act.js

@@ -32,7 +32,9 @@ function ensureValue(action, value) {
     throw new Error(`Act value is required for action: ${action}`);
 }
 const MUTABLE_FIELD_REBIND_RETRY_DELAYS_MS = [0, 25, 50, 100];
-const PARTIAL_SELECTION_PROGRESS_MESSAGE = 'Text entered. Selection is not complete. Choose one option from the visible list.';
+const PARTIAL_SELECTION_PROGRESS_MESSAGE = 'Text was entered and the related choice list remained open.';
+const NO_OBSERVABLE_PROGRESS_MESSAGE = 'The action ran, but no visible page change was detected.';
+const NO_OBSERVABLE_PROGRESS_REASON = 'No visible page or control state change was detected within the wait window.';
 async function readExpandedState(locator) {
     if (!locator) {
         return null;
@@ -100,41 +102,32 @@ async function emitActPreflightFailure(params) {
         action: params.action,
     });
 }
-function reasonForNoObservableProgressDiagnosis(diagnosis) {
-    switch (diagnosis.kind) {
-        case 'validation-blocked':
-            return 'The page stayed in place and surfaced validation blockers after the action.';
-        case 'target-blocked':
-            return 'The target stayed in place but remained blocked or unchanged after the action.';
-        case 'overlay-blocked':
-            return 'A blocking overlay prevented the action from producing observable progress.';
-        case 'site-noop':
-            return 'The page stayed in place and did not expose any observable progress after the action.';
-    }
-}
 function describeActFailure(params) {
     if (params.staleReason) {
         const reason = params.staleReason === 'page-signature-mismatch'
-            ? 'The page changed since this target was observed, so the saved page signature no longer matches.'
+            ? 'The page changed after the target was observed.'
             : params.staleReason === 'dom-signature-mismatch'
-                ? 'The target changed since it was observed, so the saved DOM signature no longer matches.'
-                : 'The saved locator no longer resolves to a live element on the page.';
+                ? 'The element changed after the target was observed.'
+                : 'The saved target no longer points to a live element on the page.';
         return {
+            error: 'stale_target',
             outcomeType: 'binding_stale',
-            message: 'The requested action cannot continue because the target is stale.',
+            message: 'The saved target is outdated.',
             reason,
         };
     }
-    if (params.diagnosis) {
+    if (params.failureMessage === 'Act failed: no_observable_progress') {
         return {
+            error: 'no_observable_progress',
             outcomeType: 'blocked',
-            message: 'The action did not produce observable progress.',
-            reason: reasonForNoObservableProgressDiagnosis(params.diagnosis),
+            message: NO_OBSERVABLE_PROGRESS_MESSAGE,
+            reason: NO_OBSERVABLE_PROGRESS_REASON,
         };
     }
     const rawReason = params.failureMessage.replace(/^Act failed:\s*/, '');
     if (rawReason === 'target_disabled') {
         return {
+            error: 'target_disabled',
             outcomeType: 'blocked',
             message: 'The requested action cannot continue because the target is disabled.',
             reason: 'The runtime resolved the target, but the browser marked it as disabled.',
@@ -142,6 +135,7 @@ function describeActFailure(params) {
     }
     if (rawReason === 'target_readonly') {
         return {
+            error: 'target_readonly',
             outcomeType: 'blocked',
             message: 'The requested action cannot continue because the target is read-only.',
             reason: 'The runtime resolved the target, but the browser marked it as read-only.',
@@ -149,42 +143,48 @@ function describeActFailure(params) {
     }
     if (rawReason === 'target_surface_inactive') {
         return {
+            error: 'target_surface_inactive',
             outcomeType: 'blocked',
             message: 'The requested action cannot continue because the target surface is inactive.',
             reason: 'The target belongs to a surface that is no longer active or available.',
         };
     }
     return {
+        error: params.failureMessage,
         outcomeType: 'blocked',
         message: 'The requested action could not be completed.',
         reason: rawReason,
     };
 }
 export { BROWSE_ACTIONS, isBrowseAction };
-function redactNoObservableProgressDiagnosis(diagnosis) {
+function hasMeaningfulNoObservableProgressObservations(observations) {
+    return Boolean(observations &&
+        (observations.visibleMessages.length > 0 ||
+            observations.invalidFields.length > 0 ||
+            observations.targetState));
+}
+function redactNoObservableProgressObservations(observations) {
     return {
-        kind: diagnosis.kind,
-        ...(diagnosis.targetState ? { targetState: diagnosis.targetState } : {}),
-        ...(diagnosis.messages.length > 0
+        ...(observations.targetState ? { targetState: observations.targetState } : {}),
+        ...(observations.visibleMessages.length > 0
             ? {
-                messagesRedacted: true,
-                messageCount: diagnosis.messages.length,
+                visibleMessagesRedacted: true,
+                visibleMessageCount: observations.visibleMessages.length,
             }
             : {}),
-        ...(diagnosis.invalidFields.length > 0
+        ...(observations.invalidFields.length > 0
             ? {
                 invalidFieldsRedacted: true,
-                invalidFieldCount: diagnosis.invalidFields.length,
-            }
-            : {}),
-        ...(diagnosis.blockingOverlays.length > 0
-            ? {
-                blockingOverlaysRedacted: true,
-                blockingOverlayCount: diagnosis.blockingOverlays.length,
+                invalidFieldCount: observations.invalidFields.length,
             }
             : {}),
     };
 }
+function sanitizePublicAttempts(attempts) {
+    return attempts.filter((attempt) => !attempt.startsWith('stale.') &&
+        !attempt.startsWith('no-progress.diagnosis:') &&
+        attempt !== 'outcome.partial-progress:selection-not-complete');
+}
 function buildActArtifactManifest(params) {
     if ('suppressed' in params.artifacts) {
         return {
@@ -505,7 +505,7 @@ export async function act(session, targetRef, action, value) {
         let recoveredProgressProbe = null;
         let staleReason = null;
         let progressProbe = null;
-        let noProgressDiagnosis = null;
+        let noProgressObservations = null;
         let partialProgressResult = null;
         let liveTarget = target;
         let trace = {
@@ -875,10 +875,7 @@ export async function act(session, targetRef, action, value) {
                             else {
                                 attempts.push(`acceptance.failed:${finalProgressProbe.policy}`);
                                 attempts.push('no-progress.detected');
-                                noProgressDiagnosis = await diagnoseNoObservableProgress(page, finalProgressProbe.locator);
-                                if (noProgressDiagnosis) {
-                                    attempts.push(`no-progress.diagnosis:${noProgressDiagnosis.kind}`);
-                                }
+                                noProgressObservations = await diagnoseNoObservableProgress(page, finalProgressProbe.locator);
                                 throw new Error('no_observable_progress');
                             }
                         }
@@ -898,10 +895,7 @@ export async function act(session, targetRef, action, value) {
                                 finalProgressProbe.beforeContextHash === afterContextHash &&
                                 !locatorStateChanged(finalProgressProbe.beforeLocator, afterLocatorObservation)) {
                                 attempts.push('no-progress.detected');
-                                noProgressDiagnosis = await diagnoseNoObservableProgress(page, finalProgressProbe.locator);
-                                if (noProgressDiagnosis) {
-                                    attempts.push(`no-progress.diagnosis:${noProgressDiagnosis.kind}`);
-                                }
+                                noProgressObservations = await diagnoseNoObservableProgress(page, finalProgressProbe.locator);
                                 throw new Error('no_observable_progress');
                             }
                         }
@@ -911,9 +905,6 @@ export async function act(session, targetRef, action, value) {
                             requestedAction,
                             probe: finalProgressProbe,
                         });
-                        if (partialProgressResult) {
-                            attempts.push('outcome.partial-progress:selection-not-complete');
-                        }
                     }
                 }
                 else if (recoveredProgressProbe) {
@@ -921,9 +912,6 @@ export async function act(session, targetRef, action, value) {
                         requestedAction,
                         probe: recoveredProgressProbe,
                     });
-                    if (partialProgressResult) {
-                        attempts.push('outcome.partial-progress:selection-not-complete');
-                    }
                 }
             }
             if (resolvedBy === 'playwright-locator') {
@@ -964,7 +952,7 @@ export async function act(session, targetRef, action, value) {
                 resolvedBy,
                 locatorStrategy,
                 pageRef: finalPageRef,
-                attempts,
+                attempts: sanitizePublicAttempts(attempts),
                 popup: Boolean(capturedPopup),
                 overlayHandled: attempts.includes('overlay.dismissed'),
                 iframe: Boolean(target.framePath?.length),
@@ -1023,18 +1011,16 @@ export async function act(session, targetRef, action, value) {
             }
         }
         if (failureMessage) {
-            if (failureMessage === 'Act failed: no_observable_progress' && noProgressDiagnosis) {
-                failureMessage = `Act failed: no_observable_progress (${noProgressDiagnosis.kind})`;
-            }
             const failureContract = describeActFailure({
                 failureMessage,
                 staleReason,
-                diagnosis: noProgressDiagnosis,
             });
             const protectedExposure = getProtectedExposure(session, currentPageRef);
-            const outputDiagnosis = protectedExposure && noProgressDiagnosis
-                ? redactNoObservableProgressDiagnosis(noProgressDiagnosis)
-                : noProgressDiagnosis;
+            const outputObservations = hasMeaningfulNoObservableProgressObservations(noProgressObservations)
+                ? protectedExposure
+                    ? redactNoObservableProgressObservations(noProgressObservations)
+                    : noProgressObservations
+                : undefined;
             const artifactManifestId = persistActArtifactManifestBestEffort(runId, actStep?.stepId, failureArtifacts ?? null);
             captureStepSnapshotBestEffort({
                 session,
@@ -1063,7 +1049,7 @@ export async function act(session, targetRef, action, value) {
             });
             await exportRunStepToOtlpHttpJsonBestEffort(runId, actStep?.stepId);
             outputFailure({
-                error: failureMessage,
+                error: failureContract.error,
                 outcomeType: failureContract.outcomeType,
                 message: failureContract.message,
                 reason: failureContract.reason,
@@ -1073,15 +1059,14 @@ export async function act(session, targetRef, action, value) {
                 value: actionValue,
                 pageRef: currentPageRef,
                 locatorStrategy,
-                attempts,
+                attempts: sanitizePublicAttempts(attempts),
                 popup: attempts.includes('popup-captured'),
                 overlayHandled: attempts.includes('overlay.dismissed'),
                 iframe: Boolean(target.framePath?.length),
                 jsFallback: attempts.some((attempt) => attempt.startsWith('locator.evaluate.')),
                 durationMs: Date.now() - startedAt,
                 staleTarget: Boolean(staleReason),
-                staleReason: staleReason ?? undefined,
-                diagnosis: outputDiagnosis ?? undefined,
+                observations: outputObservations,
                 artifacts: failureArtifacts,
                 metrics: session.runtime?.metrics,
             });

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

@@ -45,16 +45,12 @@ export type AcceptanceProbeResult = {
     afterPageObservation: PageObservation | null;
     polls: number;
 };
-export type NoObservableProgressDiagnosis = {
-    kind: 'validation-blocked' | 'overlay-blocked' | 'target-blocked' | 'site-noop';
-    messages: string[];
+export type NoObservableProgressObservations = {
+    visibleMessages: string[];
     invalidFields: string[];
-    blockingOverlays: string[];
     targetState?: {
         disabled?: boolean;
-        ariaDisabled?: boolean;
         readonly?: boolean;
-        centerHitSelf?: boolean;
     };
 };
 export declare function rankLocatorCandidates(candidates: ReadonlyArray<NonNullable<ReturnType<typeof getTarget>>['locatorCandidates'][number]>, action: BrowseAction): import("../runtime-state.js").LocatorCandidate[];
@@ -76,7 +72,7 @@ export declare function locatorStateChanged(before: LocatorStateObservation | nu
 export declare function pageObservationChanged(before: PageObservation | null, after: PageObservation | null): boolean;
 export declare function genericClickObservationChanged(before: PageObservation | null, after: PageObservation | null): boolean;
 export declare function submitObservationChanged(before: PageObservation | null, after: PageObservation | null): boolean;
-export declare function diagnoseNoObservableProgress(page: Page, locator: Locator): Promise<NoObservableProgressDiagnosis | null>;
+export declare function diagnoseNoObservableProgress(page: Page, locator: Locator): Promise<NoObservableProgressObservations | null>;
 export declare function createAcceptanceProbe(args: {
     session: BrowseSession;
     page: Page;

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

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

package/dist/commands/action-acceptance.js

@@ -1446,39 +1446,22 @@ export async function diagnoseNoObservableProgress(page, locator) {
     const invalidFields = Array.isArray(pageSignals.invalidFields)
         ? pageSignals.invalidFields.filter((value) => typeof value === 'string')
         : [];
-    const blockingOverlays = Array.isArray(pageSignals.blockingOverlays)
-        ? pageSignals.blockingOverlays.filter((value) => typeof value === 'string')
-        : [];
     const rawTargetState = targetState && typeof targetState === 'object' && !Array.isArray(targetState)
         ? targetState
         : undefined;
-    const normalizedTargetState = rawTargetState
+    const disabled = rawTargetState &&
+        (Boolean(rawTargetState.disabled) || Boolean(rawTargetState.ariaDisabled));
+    const readonly = rawTargetState ? Boolean(rawTargetState.readonly) : false;
+    const normalizedTargetState = disabled || readonly
         ? {
-            disabled: Boolean(rawTargetState.disabled),
-            ariaDisabled: Boolean(rawTargetState.ariaDisabled),
-            readonly: Boolean(rawTargetState.readonly),
-            centerHitSelf: Boolean(rawTargetState.centerHitSelf),
+            ...(disabled ? { disabled: true } : {}),
+            ...(readonly ? { readonly: true } : {}),
         }
         : undefined;
-    const effectiveBlockingOverlays = normalizedTargetState?.centerHitSelf ? [] : blockingOverlays;
-    let kind = 'site-noop';
-    if (invalidFields.length > 0) {
-        kind = 'validation-blocked';
-    }
-    else if (normalizedTargetState?.disabled ||
-        normalizedTargetState?.ariaDisabled ||
-        normalizedTargetState?.readonly) {
-        kind = 'target-blocked';
-    }
-    else if (effectiveBlockingOverlays.length > 0) {
-        kind = 'overlay-blocked';
-    }
     return {
-        kind,
-        messages,
+        visibleMessages: messages,
         invalidFields,
-        blockingOverlays: effectiveBlockingOverlays,
-        targetState: normalizedTargetState,
+        ...(normalizedTargetState ? { targetState: normalizedTargetState } : {}),
     };
 }
 async function resolveTargetLocatorForRead(page, target, surface, action = 'click') {

package/dist/commands/browser-status.d.ts

@@ -0,0 +1,6 @@
+/**
+ * browse browser-status — Check live browser/page/runtime state.
+ */
+import type { BrowseResult } from '../output.js';
+export declare function browserStatus(): Promise<BrowseResult>;
+//# sourceMappingURL=browser-status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser-status.d.ts","sourceRoot":"","sources":["../../src/commands/browser-status.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AA+LjD,wBAAsB,aAAa,IAAI,OAAO,CAAC,YAAY,CAAC,CAiH3D"}