@mercuryo-ai/agentbrowse 0.2.50 → 0.2.52

package/dist/commands/observe.js

@@ -1,50 +1,50 @@
 /**
  * browse observe ["<instruction>"] — Discover available actions on the page.
  */
-import { canUseAgentbrowseAssistiveLlmClient } from "../assistive-runtime.js";
-import { saveSession } from "../session.js";
-import { ensureRuntimeState, replaceTargetsForPage } from "../runtime-state.js";
-import { incrementMetric } from "../runtime-metrics.js";
-import { bumpPageScopeEpoch, setCurrentPage } from "../runtime-page-state.js";
-import { getProtectedExposure } from "../runtime-protected-state.js";
-import { connectPlaywright, disconnectPlaywright, resolveCurrentPageContext, syncSessionPage, } from "../playwright-runtime.js";
-import { tracedStepOperation, withApiTraceContext, } from "../command-api-tracing.js";
-import { captureDiagnosticSnapshotBestEffort, finishDiagnosticStepBestEffort, recordCommandLifecycleEventBestEffort, startDiagnosticStep, } from "../diagnostics.js";
-import { outputContractFailure, outputJSON, } from "../output.js";
-import { domRuntimeResolution, stagehandRuntimeResolution, } from "../runtime-resolution.js";
-import { withStagehand } from "../stagehand-runtime.js";
-import { buildProtectedObserveBlockedResult } from "../secrets/protected-artifact-guard.js";
-import { scrubProtectedExactValues } from "../secrets/protected-exact-value-redaction.js";
-import { normalizePageSignature } from "./descriptor-validation.js";
-import { collectDomTargets, __testDomTargetCollection as inventoryDomTargetCollection, __testStagehandDescriptor as inventoryStagehandDescriptor, } from "./observe-inventory.js";
-import { enrichDomTargetsWithAccessibility } from "./observe-accessibility.js";
-import { collectPageSignals } from "./observe-signals.js";
-import { attachObservedTargetOwners, linkObservedSurfaceGraph, reconcileObservedTargetsForPage, persistObservedSurfacesForPage, toDomDescriptor, } from "./observe-persistence.js";
-import { clearProtectedFillableFormsForPage, markProtectedFillableFormsUnknownForPage, persistProtectedFillableFormsForPage, } from "./observe-protected.js";
-import { classifyObservePageState, shouldSuppressFillableFormsForObserve, } from "./observe-page-state.js";
-import { annotateDomTargets, compressSemanticallyDuplicateTargets, orderBySurfaceCompetition, prioritizeGoalActionTargets, } from "./observe-semantics.js";
-import { buildGroupedObserveScopes, buildGoalProjectionScopeRefs, buildGoalObserveInventoryCandidates, compactFillableForms, compactSignals, expandWorkflowGraphTargets, projectPersistedTargetsForGoal, selectTargetsForGoalMatches, } from "./observe-projection.js";
-import { collectSurfaceDescriptors, selectScopesForOutput, } from "./observe-surfaces.js";
-import { toStagehandDescriptor } from "./observe-stagehand.js";
-import { rerankDomTargetsForGoal } from "./semantic-observe.js";
+import { canUseAgentbrowseAssistiveLlmClient } from '../assistive-runtime.js';
+import { saveSession } from '../session.js';
+import { ensureRuntimeState, replaceTargetsForPage } from '../runtime-state.js';
+import { incrementMetric } from '../runtime-metrics.js';
+import { bumpPageScopeEpoch, setCurrentPage } from '../runtime-page-state.js';
+import { getProtectedExposure } from '../runtime-protected-state.js';
+import { connectPlaywright, disconnectPlaywright, resolveCurrentPageContext, syncSessionPage, } from '../playwright-runtime.js';
+import { tracedStepOperation, withApiTraceContext } from '../command-api-tracing.js';
+import { captureDiagnosticSnapshotBestEffort, finishDiagnosticStepBestEffort, recordCommandLifecycleEventBestEffort, startDiagnosticStep, } from '../diagnostics.js';
+import { outputContractFailure, outputJSON, } from '../output.js';
+import { domRuntimeResolution, stagehandRuntimeResolution } from '../runtime-resolution.js';
+import { withStagehand } from '../stagehand-runtime.js';
+import { buildProtectedObserveBlockedResult } from '../secrets/protected-artifact-guard.js';
+import { scrubProtectedExactValues } from '../secrets/protected-exact-value-redaction.js';
+import { normalizePageSignature } from './descriptor-validation.js';
+import { collectDomTargets, __testDomTargetCollection as inventoryDomTargetCollection, __testStagehandDescriptor as inventoryStagehandDescriptor, } from './observe-inventory.js';
+import { enrichDomTargetsWithAccessibility } from './observe-accessibility.js';
+import { collectPageSignals } from './observe-signals.js';
+import { attachObservedTargetOwners, linkObservedSurfaceGraph, reconcileObservedTargetsForPage, persistObservedSurfacesForPage, toDomDescriptor, } from './observe-persistence.js';
+import { clearProtectedFillableFormsForPage, markProtectedFillableFormsUnknownForPage, persistProtectedFillableFormsForPage, } from './observe-protected.js';
+import { classifyObservePageState, shouldSuppressFillableFormsForObserve, } from './observe-page-state.js';
+import { annotateDomTargets, compressSemanticallyDuplicateTargets, orderBySurfaceCompetition, prioritizeGoalActionTargets, } from './observe-semantics.js';
+import { buildGroupedObserveScopes, buildGoalProjectionScopeRefs, buildGoalObserveInventoryCandidates, compactFillableForms, compactSignals, expandWorkflowGraphTargets, projectPersistedTargetsForGoal, selectTargetsForGoalMatches, } from './observe-projection.js';
+import { collectSurfaceDescriptors, selectScopesForOutput } from './observe-surfaces.js';
+import { toStagehandDescriptor } from './observe-stagehand.js';
+import { rerankDomTargetsForGoal } from './semantic-observe.js';
 /** Stable top-level error codes returned by `observe(...)`. */
 export const OBSERVE_ERROR_CODES = [
-    "browser_connection_failed",
-    "observe_failed",
-    "protected_observe_blocked",
+    'browser_connection_failed',
+    'observe_failed',
+    'protected_observe_blocked',
 ];
 /** Stable outcome categories emitted by `observe(...)`. */
 export const OBSERVE_OUTCOME_TYPES = [
-    "blocked",
-    "observation_completed",
-    "protected_exposure_active",
+    'blocked',
+    'observation_completed',
+    'protected_exposure_active',
 ];
 function flattenObserveTargets(scopes) {
     if (!Array.isArray(scopes)) {
         return [];
     }
     return scopes.flatMap((scope) => {
-        if (!scope || typeof scope !== "object" || Array.isArray(scope)) {
+        if (!scope || typeof scope !== 'object' || Array.isArray(scope)) {
             return [];
         }
         const typedScope = scope;
@@ -62,9 +62,7 @@ function normalizeObserveSuccessPayload(payload) {
         scopes,
         targets,
         signals: Array.isArray(payload.signals) ? payload.signals : [],
-        fillableForms: Array.isArray(payload.fillableForms)
-            ? payload.fillableForms
-            : [],
+        fillableForms: Array.isArray(payload.fillableForms) ? payload.fillableForms : [],
         targetCount: targets.length,
         scopeCount: scopes.length,
         projectedTargetCount: targets.length,
@@ -98,36 +96,32 @@ async function buildObserveSuccessResult(session, step, payload) {
     captureDiagnosticSnapshotBestEffort({
         session,
         step,
-        phase: "after",
-        pageRef: typeof normalizedPayload.pageRef === "string"
+        phase: 'after',
+        pageRef: typeof normalizedPayload.pageRef === 'string'
             ? normalizedPayload.pageRef
             : session.runtime?.currentPageRef,
-        url: typeof normalizedPayload.url === "string"
-            ? normalizedPayload.url
-            : undefined,
-        title: typeof normalizedPayload.title === "string"
-            ? normalizedPayload.title
-            : undefined,
+        url: typeof normalizedPayload.url === 'string' ? normalizedPayload.url : undefined,
+        title: typeof normalizedPayload.title === 'string' ? normalizedPayload.title : undefined,
     });
     recordCommandLifecycleEventBestEffort({
         step,
-        phase: "completed",
+        phase: 'completed',
         attributes: {
-            outcomeType: "observation_completed",
-            ...(typeof normalizedPayload.pageRef === "string"
+            outcomeType: 'observation_completed',
+            ...(typeof normalizedPayload.pageRef === 'string'
                 ? { pageRef: normalizedPayload.pageRef }
                 : {}),
-            ...(typeof normalizedPayload.resolvedBy === "string"
+            ...(typeof normalizedPayload.resolvedBy === 'string'
                 ? { resolvedBy: normalizedPayload.resolvedBy }
                 : {}),
         },
     });
     await finalizeObserveStepBestEffort(step, {
         success: true,
-        outcomeType: "observation_completed",
-        message: typeof normalizedPayload.message === "string"
+        outcomeType: 'observation_completed',
+        message: typeof normalizedPayload.message === 'string'
             ? normalizedPayload.message
-            : "Observe completed.",
+            : 'Observe completed.',
     });
     return normalizedPayload;
 }
@@ -136,17 +130,15 @@ async function buildObserveContractFailureResult(session, params) {
     captureDiagnosticSnapshotBestEffort({
         session,
         step,
-        phase: "point-in-time",
-        pageRef: typeof params.pageRef === "string" ? params.pageRef : undefined,
+        phase: 'point-in-time',
+        pageRef: typeof params.pageRef === 'string' ? params.pageRef : undefined,
     });
     recordCommandLifecycleEventBestEffort({
         step,
-        phase: "failed",
+        phase: 'failed',
         attributes: {
             ...(params.outcomeType ? { outcomeType: params.outcomeType } : {}),
-            ...(typeof params.pageRef === "string"
-                ? { pageRef: params.pageRef }
-                : {}),
+            ...(typeof params.pageRef === 'string' ? { pageRef: params.pageRef } : {}),
             ...(params.reason ? { reason: params.reason } : {}),
         },
     });
@@ -186,7 +178,7 @@ export async function observeBrowser(session, instruction) {
     let observedScopes = [];
     const observeStep = startDiagnosticStep({
         runId: session.activeRunId,
-        command: "observe",
+        command: 'observe',
         input: {
             ...(instruction ? { instruction } : {}),
         },
@@ -198,12 +190,12 @@ export async function observeBrowser(session, instruction) {
     captureDiagnosticSnapshotBestEffort({
         session,
         step: observeStep,
-        phase: "before",
+        phase: 'before',
         pageRef,
     });
     recordCommandLifecycleEventBestEffort({
         step: observeStep,
-        phase: "started",
+        phase: 'started',
         attributes: {
             ...(instruction ? { instruction } : {}),
             pageRef,
@@ -212,18 +204,16 @@ export async function observeBrowser(session, instruction) {
     return withApiTraceContext({
         runId: session.activeRunId,
         stepId: observeStep?.stepId,
-        command: "observe",
+        command: 'observe',
     }, async () => {
         const observePhaseAttributes = {
-            "agentbrowse.observe.goal_based": Boolean(instruction),
+            'agentbrowse.observe.goal_based': Boolean(instruction),
         };
-        const initialProtectedExposure = instruction
-            ? getProtectedExposure(session, pageRef)
-            : null;
+        const initialProtectedExposure = instruction ? getProtectedExposure(session, pageRef) : null;
         if (instruction && initialProtectedExposure) {
             return buildObserveContractFailureResult(session, {
                 step: observeStep,
-                ...buildProtectedObserveBlockedResult(initialProtectedExposure, "goal-rerank"),
+                ...buildProtectedObserveBlockedResult(initialProtectedExposure, 'goal-rerank'),
                 pageRef,
                 runId: session.activeRunId,
                 stepId: observeStep?.stepId,
@@ -247,9 +237,9 @@ export async function observeBrowser(session, instruction) {
                     },
                 }))));
                 if (observeAccessibilityStats) {
-                    incrementMetric(session, "observeAxAttempts", observeAccessibilityStats.axAttempts);
-                    incrementMetric(session, "observeAxHits", observeAccessibilityStats.axHits);
-                    incrementMetric(session, "observeFallbackUses", observeAccessibilityStats.fallbackUses);
+                    incrementMetric(session, 'observeAxAttempts', observeAccessibilityStats.axAttempts);
+                    incrementMetric(session, 'observeAxHits', observeAccessibilityStats.axHits);
+                    incrementMetric(session, 'observeFallbackUses', observeAccessibilityStats.fallbackUses);
                 }
                 const pageSignals = await collectPageSignals(page).catch(() => []);
                 const pageState = classifyObservePageState(pageSignals);
@@ -268,9 +258,9 @@ export async function observeBrowser(session, instruction) {
                     browser = null;
                     return buildObserveSuccessResult(session, observeStep, {
                         success: true,
-                        observationMode: "deterministic_dom",
+                        observationMode: 'deterministic_dom',
                         pageRef,
-                        resolvedBy: "dom",
+                        resolvedBy: 'dom',
                         ...domRuntimeResolution(),
                         scopes: buildGroupedObserveScopes({
                             pageRef,
@@ -281,9 +271,7 @@ export async function observeBrowser(session, instruction) {
                         signals: compactSignals(pageSignals),
                         fillableForms: compactFillableForms(fillableForms),
                         metrics: session.runtime?.metrics,
-                        message: targets.length === 0
-                            ? "This observe pass returned zero targets."
-                            : undefined,
+                        message: targets.length === 0 ? 'This observe pass returned zero targets.' : undefined,
                         ...buildObservePageMetadata({
                             url,
                             title,
@@ -296,15 +284,15 @@ export async function observeBrowser(session, instruction) {
                     browser = null;
                     return buildObserveSuccessResult(session, observeStep, {
                         success: true,
-                        observationMode: "deterministic_dom",
+                        observationMode: 'deterministic_dom',
                         pageRef,
-                        resolvedBy: "dom",
+                        resolvedBy: 'dom',
                         ...domRuntimeResolution(),
                         scopes: [],
                         signals: compactSignals(pageSignals),
                         fillableForms: [],
                         metrics: session.runtime?.metrics,
-                        message: "This observe pass returned zero targets.",
+                        message: 'This observe pass returned zero targets.',
                         ...buildObservePageMetadata({
                             url,
                             title,
@@ -312,23 +300,23 @@ export async function observeBrowser(session, instruction) {
                         }),
                     });
                 }
-                stagehandFallbackReason = "deterministic-observe-empty";
+                stagehandFallbackReason = 'deterministic-observe-empty';
             }
             catch (err) {
                 domPassError = err instanceof Error ? err.message : String(err);
                 if (!allowAssistive) {
                     return buildObserveContractFailureResult(session, {
                         step: observeStep,
-                        error: "observe_failed",
-                        outcomeType: "blocked",
-                        message: "Observe failed.",
+                        error: 'observe_failed',
+                        outcomeType: 'blocked',
+                        message: 'Observe failed.',
                         reason: domPassError,
                         pageRef,
                         runId: session.activeRunId,
                         stepId: observeStep?.stepId,
                     });
                 }
-                stagehandFallbackReason = "deterministic-observe-failed";
+                stagehandFallbackReason = 'deterministic-observe-failed';
             }
         }
         if (instruction) {
@@ -344,7 +332,7 @@ export async function observeBrowser(session, instruction) {
                 if (protectedExposure) {
                     return buildObserveContractFailureResult(session, {
                         step: observeStep,
-                        ...buildProtectedObserveBlockedResult(protectedExposure, "goal-rerank"),
+                        ...buildProtectedObserveBlockedResult(protectedExposure, 'goal-rerank'),
                         pageRef,
                         runId: session.activeRunId,
                         stepId: observeStep?.stepId,
@@ -362,19 +350,19 @@ export async function observeBrowser(session, instruction) {
                     },
                 }))));
                 if (observeAccessibilityStats) {
-                    incrementMetric(session, "observeAxAttempts", observeAccessibilityStats.axAttempts);
-                    incrementMetric(session, "observeAxHits", observeAccessibilityStats.axHits);
-                    incrementMetric(session, "observeFallbackUses", observeAccessibilityStats.fallbackUses);
+                    incrementMetric(session, 'observeAxAttempts', observeAccessibilityStats.axAttempts);
+                    incrementMetric(session, 'observeAxHits', observeAccessibilityStats.axHits);
+                    incrementMetric(session, 'observeFallbackUses', observeAccessibilityStats.fallbackUses);
                 }
                 const pageSignals = await collectPageSignals(page).catch(() => []);
                 const pageState = classifyObservePageState(pageSignals);
                 const surfaceInputs = collectSurfaceDescriptors(pageRef, domTargets);
                 if (domTargets.length > 0) {
                     const rerankedCandidates = await tracedStepOperation(() => rerankDomTargetsForGoal(instruction, buildGoalObserveInventoryCandidates(domTargets, surfaceInputs), { session }), {
-                        spanName: "agentbrowse.observe.rerank_goal_candidates",
+                        spanName: 'agentbrowse.observe.rerank_goal_candidates',
                         attributes: {
                             ...observePhaseAttributes,
-                            "agentbrowse.observe.target_count": domTargets.length,
+                            'agentbrowse.observe.target_count': domTargets.length,
                         },
                     });
                     const { targets: goalMatchedTargets, selectedSurfaceIds } = selectTargetsForGoalMatches(domTargets, rerankedCandidates);
@@ -402,10 +390,10 @@ export async function observeBrowser(session, instruction) {
                         return buildObserveSuccessResult(session, observeStep, {
                             success: true,
                             observationMode: canUseAssistiveLlm
-                                ? "goal_assistive_rerank"
-                                : "goal_heuristic_shortlist",
+                                ? 'goal_assistive_rerank'
+                                : 'goal_heuristic_shortlist',
                             pageRef,
-                            resolvedBy: "dom-rerank",
+                            resolvedBy: 'dom-rerank',
                             ...domRuntimeResolution(),
                             scopes: buildGroupedObserveScopes({
                                 pageRef,
@@ -425,25 +413,25 @@ export async function observeBrowser(session, instruction) {
                     return buildObserveSuccessResult(session, observeStep, {
                         success: true,
                         observationMode: canUseAssistiveLlm
-                            ? "goal_assistive_rerank"
-                            : "goal_heuristic_shortlist",
+                            ? 'goal_assistive_rerank'
+                            : 'goal_heuristic_shortlist',
                         pageRef,
-                        resolvedBy: "dom-rerank",
+                        resolvedBy: 'dom-rerank',
                         ...domRuntimeResolution(),
                         scopes: [],
                         signals: compactSignals(pageSignals),
                         fillableForms: compactFillableForms(fillableForms),
                         metrics: session.runtime?.metrics,
-                        message: "This goal-based observe pass returned zero matching targets.",
+                        message: 'This goal-based observe pass returned zero matching targets.',
                         url,
                         title,
                     });
                 }
-                stagehandFallbackReason = "deterministic-observe-empty";
+                stagehandFallbackReason = 'deterministic-observe-empty';
             }
             catch (err) {
                 domPassError = err instanceof Error ? err.message : String(err);
-                stagehandFallbackReason = "deterministic-observe-failed";
+                stagehandFallbackReason = 'deterministic-observe-failed';
             }
         }
         try {
@@ -452,14 +440,12 @@ export async function observeBrowser(session, instruction) {
             }
         }
         catch (err) {
-            const domFailure = domPassError && domPassError.length > 0
-                ? `; dom observe failed: ${domPassError}`
-                : "";
+            const domFailure = domPassError && domPassError.length > 0 ? `; dom observe failed: ${domPassError}` : '';
             return buildObserveContractFailureResult(session, {
                 step: observeStep,
-                error: "browser_connection_failed",
-                outcomeType: "blocked",
-                message: "Observe could not start because AgentBrowse failed to connect to the browser.",
+                error: 'browser_connection_failed',
+                outcomeType: 'blocked',
+                message: 'Observe could not start because AgentBrowse failed to connect to the browser.',
                 reason: `${err instanceof Error ? err.message : String(err)}${domFailure}`,
                 pageRef,
                 runId: session.activeRunId,
@@ -475,7 +461,7 @@ export async function observeBrowser(session, instruction) {
             if (protectedExposure) {
                 return buildObserveContractFailureResult(session, {
                     step: observeStep,
-                    ...buildProtectedObserveBlockedResult(protectedExposure, "stagehand-fallback"),
+                    ...buildProtectedObserveBlockedResult(protectedExposure, 'stagehand-fallback'),
                     fallbackReason: stagehandFallbackReason ?? undefined,
                     deterministicObserveError: domPassError ?? undefined,
                     pageRef,
@@ -487,7 +473,7 @@ export async function observeBrowser(session, instruction) {
             setCurrentPage(session, pageRef);
             const pageSignals = await collectPageSignals(page).catch(() => []);
             const actions = await withStagehand(session, async (stagehand) => {
-                incrementMetric(session, "stagehandCalls");
+                incrementMetric(session, 'stagehandCalls');
                 return instruction
                     ? (await stagehand.observe(instruction, {
                         page,
@@ -498,10 +484,10 @@ export async function observeBrowser(session, instruction) {
             const fillableForms = markProtectedFillableFormsUnknownForPage(session, pageRef);
             return buildObserveSuccessResult(session, observeStep, {
                 success: true,
-                observationMode: "goal_assistive_stagehand",
+                observationMode: 'goal_assistive_stagehand',
                 pageRef,
-                resolvedBy: "stagehand-observe",
-                ...stagehandRuntimeResolution(stagehandFallbackReason ?? "deterministic-observe-failed"),
+                resolvedBy: 'stagehand-observe',
+                ...stagehandRuntimeResolution(stagehandFallbackReason ?? 'deterministic-observe-failed'),
                 deterministicObserveError: domPassError ?? undefined,
                 scopes: buildGroupedObserveScopes({
                     pageRef,
@@ -512,9 +498,7 @@ export async function observeBrowser(session, instruction) {
                 signals: compactSignals(pageSignals),
                 fillableForms: compactFillableForms(fillableForms),
                 metrics: session.runtime?.metrics,
-                message: targets.length === 0
-                    ? "This observe pass returned zero targets."
-                    : undefined,
+                message: targets.length === 0 ? 'This observe pass returned zero targets.' : undefined,
                 url,
                 title,
             });
@@ -526,9 +510,9 @@ export async function observeBrowser(session, instruction) {
                 : stagehandError;
             return buildObserveContractFailureResult(session, {
                 step: observeStep,
-                error: "observe_failed",
-                outcomeType: "blocked",
-                message: "Observe failed.",
+                error: 'observe_failed',
+                outcomeType: 'blocked',
+                message: 'Observe failed.',
                 reason: details,
                 pageRef,
                 runId: session.activeRunId,

package/dist/commands/user-actionable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user-actionable.d.ts","sourceRoot":"","sources":["../../src/commands/user-actionable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,eAAO,MAAM,4CAA4C,QAoHxD,CAAC;AAEF,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAmIhF"}
+{"version":3,"file":"user-actionable.d.ts","sourceRoot":"","sources":["../../src/commands/user-actionable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,eAAO,MAAM,4CAA4C,QAoHxD,CAAC;AAEF,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAoIhF"}

package/dist/protected-fill.d.ts

@@ -1,13 +1,13 @@
-import type { BrowserSessionState } from "./browser-session-state.js";
-import type { FillableFormFieldBinding, FillableFormPresence, ProtectedBindingValueHint, ProtectedFieldPolicy, StoredSecretFieldKey, StoredSecretFieldPolicies } from "./secrets/types.js";
-import type { ProtectedExactValueProfile } from "./runtime-state.js";
+import type { BrowserSessionState } from './browser-session-state.js';
+import type { FillableFormFieldBinding, FillableFormPresence, 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;
 export type ProtectedFieldPolicyMode = ProtectedFieldPolicy;
 export type ProtectedFieldPolicies = StoredSecretFieldPolicies;
 export type ProtectedFieldValueHint = ProtectedBindingValueHint;
 export type ProtectedFillPresence = FillableFormPresence;
-export type { ProtectedExactValueProfile } from "./runtime-state.js";
+export type { ProtectedExactValueProfile } from './runtime-state.js';
 /** Single field binding inside a protected fill form. */
 export interface ProtectedFillFieldBinding extends FillableFormFieldBinding {
 }
@@ -29,25 +29,25 @@ export interface ProtectedFilledField {
 }
 /** Field-level validation or application failure for protected fill. */
 export interface ProtectedFieldError extends ProtectedFilledField {
-    reason: "client_validation_rejected" | "value_not_applied";
+    reason: 'client_validation_rejected' | 'value_not_applied';
     validationTextRedacted?: true;
 }
 export type ProtectedFillExecution = {
-    kind: "success";
+    kind: 'success';
     filledFields: ProtectedFilledField[];
 } | {
-    kind: "binding_stale";
+    kind: 'binding_stale';
     targetRef: string;
     fieldKeys: ProtectedFieldKey[];
-    reason: "target_missing" | "target_not_live" | "page_signature_mismatch" | "dom_signature_mismatch" | "locator_resolution_failed" | "target_blocked";
+    reason: 'target_missing' | 'target_not_live' | 'page_signature_mismatch' | 'dom_signature_mismatch' | 'locator_resolution_failed' | 'target_blocked';
     attempts: string[];
 } | {
-    kind: "validation_failed";
+    kind: 'validation_failed';
     filledFields: ProtectedFilledField[];
     fieldErrors: ProtectedFieldError[];
 } | {
-    kind: "unexpected_error";
-    reason: "missing_protected_value" | "unsupported_protected_field_group" | "deterministic_only_resolution_failed" | "assisted_value_resolution_failed" | "action_failed";
+    kind: 'unexpected_error';
+    reason: 'missing_protected_value' | 'unsupported_protected_field_group' | 'deterministic_only_resolution_failed' | 'assisted_value_resolution_failed' | 'action_failed';
 };
 export type FillProtectedFormResult = {
     success: true;
@@ -57,7 +57,7 @@ export type FillProtectedFormResult = {
     execution: ProtectedFillExecution;
 } | {
     success: false;
-    error: "browser_connection_failed" | "page_resolution_failed";
+    error: 'browser_connection_failed' | 'page_resolution_failed';
     message: string;
     reason: string;
 };

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,5 +1,5 @@
-import { fillProtectedFormBrowser, } from "./protected-fill-browser.js";
-import { buildProtectedExactValueProfile as buildProtectedExactValueProfileInternal } from "./secrets/protected-exact-value-redaction.js";
+import { fillProtectedFormBrowser, } from './protected-fill-browser.js';
+import { buildProtectedExactValueProfile as buildProtectedExactValueProfileInternal } from './secrets/protected-exact-value-redaction.js';
 /** Fills a previously observed protected form with caller-provided protected values. */
 export async function fillProtectedForm(params) {
     return (await fillProtectedFormBrowser({
@@ -12,7 +12,7 @@ export async function fillProtectedForm(params) {
 export function buildProtectedExposureArtifacts(params) {
     const filteredProtectedValues = Object.fromEntries(Object.entries(params.protectedValues).filter((entry) => {
         const value = entry[1];
-        return typeof value === "string" && value.length > 0;
+        return typeof value === 'string' && value.length > 0;
     }));
     return {
         exactValueProfile: buildProtectedExactValueProfileInternal(filteredProtectedValues),