@oxvo/ai-live-assist 7.3.4 → 7.4.23

package/cjs/context.d.ts

@@ -1,17 +1,22 @@
-import type { ActionExecutionResult, ActionGrant, PageContextSnapshot, PresentationTarget, VisualContextCapture } from './types.js';
+import type { ActionExecutionResult, ActionGrant, PageContextSnapshot, SanitizedTarget, PresentationTarget, VisualContextCapture } from './types.js';
+export declare const actionTargetFingerprint: (target: SanitizedTarget, subtle?: Pick<SubtleCrypto, "digest"> | undefined) => Promise<string | null>;
 type SelectorRegionRule = {
     digest: string;
     selector: string;
 };
 type ContextCallbacks = {
     onSnapshot: (snapshot: PageContextSnapshot) => void | Promise<void>;
-    onNavigation: (pageId: string, revision: number, url: string) => void | Promise<void>;
+    onActionMutationApplied?: (actionId: string, revision: number, url: string) => void;
+    onCausalNavigationObserved?: (pageId: string, revision: number, url: string, causalActionId: string) => void;
+    onNavigation: (pageId: string, revision: number, url: string, causalActionId?: string) => boolean | void | Promise<boolean | void>;
     onHighlight: (element: Element | null, status: 'focus' | 'success' | 'failure') => void;
 };
 export declare class PageContextCollector {
     private readonly callbacks;
     private readonly selectorRegionRules;
     private readonly policyVersion;
+    private readonly trustedGuideRoot;
+    private readonly statefulButtonActionProof;
     private pageId;
     private revision;
     private running;
@@ -28,19 +33,21 @@ export declare class PageContextCollector {
     private pendingNavigation;
     private pendingCapture;
     private deferredNavigation;
+    private navigationSettlementGeneration;
+    private navigationSettlement;
     private recentSelection;
     private latestSemanticSignature;
-    constructor(callbacks: ContextCallbacks, selectorRegionRules?: SelectorRegionRule[], policyVersion?: number);
+    constructor(callbacks: ContextCallbacks, selectorRegionRules?: SelectorRegionRule[], policyVersion?: number, trustedGuideRoot?: Element | null, statefulButtonActionProof?: boolean);
     get currentRevision(): number;
     get currentPageId(): string;
     presentationTarget(targetId: string, revision: number): PresentationTarget | null;
     start(): void;
     stop(): void;
-    captureAndPublish(): Promise<PageContextSnapshot>;
+    captureAndPublish(): Promise<PageContextSnapshot | null>;
     capture(): PageContextSnapshot;
     private captureSnapshot;
     captureVisualContext(): VisualContextCapture | null;
-    execute(grant: ActionGrant): Promise<ActionExecutionResult>;
+    execute(grant: ActionGrant, authorityIsCurrent?: () => boolean): Promise<ActionExecutionResult>;
     completeActionExecution(actionId: string): Promise<string | null>;
     private click;
     private type;
@@ -59,6 +66,9 @@ export declare class PageContextCollector {
     private handleControlStateChange;
     private readSafeSelection;
     private handleNavigation;
+    private beginNavigationSettlement;
+    private observeCausalNavigationAfterMutation;
+    private reportCausalNavigationObservation;
     private installNavigationHooks;
     private restoreNavigationHooks;
     private reducedMotion;