@oxvo/ai-live-assist 7.3.0 → 7.4.15

package/cjs/AiLiveAssist.d.ts

@@ -1,96 +1,586 @@
-import type { App } from '@oxvo/browser';
-import type { PluginOptions } from './types.js';
-export type ConfirmationReplyIntent = 'approve' | 'decline' | null;
+import type { App } from "@oxvo/browser";
+import { type ReplayLaunchContext } from "./client.js";
+import type { AiGuideControllerState, AiGuideOpenInput, BootstrapConfig, PluginOptions } from "./types.js";
+export declare const REPLAY_SESSION_READY_TIMEOUT_MS = 15000;
+type ReplayAwareApp = App & {
+    getAssistSessionGrant?: () => {
+        sessionId?: unknown;
+        token?: unknown;
+    } | null;
+};
+export declare class ReplaySessionReadiness {
+    private readonly app;
+    private readonly tabId;
+    private lineage;
+    private waiter;
+    private startInFlight;
+    private stopHandler;
+    private destroyed;
+    private recordingDisabled;
+    constructor(app: ReplayAwareApp, tabId: string);
+    wait(): Promise<ReplayLaunchContext>;
+    assertCurrent(lineage: ReplayLaunchContext): void;
+    setStopHandler(handler: () => void): void;
+    startFreshSessionIfInactive(): void;
+    disableRecording(): void;
+    destroy(): void;
+    private readCurrentLineage;
+    private onStart;
+    private onStop;
+    private rejectWaiter;
+    private recordingRequiredError;
+    private notReadyError;
+}
+export type ConfirmationReplyIntent = "approve" | "decline" | null;
 export declare const confirmationReplyIntent: (value: string) => ConfirmationReplyIntent;
+export declare const normalizeAiGuideOpenInput: (input?: AiGuideOpenInput) => Required<Pick<AiGuideOpenInput, "mode">> & Pick<AiGuideOpenInput, "question" | "requestId">;
+export declare const resolveAiGuideProtocolVersion: (bootstrap: Pick<BootstrapConfig, "experienceMode" | "minimumProtocolVersion" | "protocol">) => 1 | 2;
 export default class AiLiveAssist {
     private readonly app;
     private readonly options;
-    readonly version = "7.3.0";
+    readonly version = "7.4.15";
     private readonly siteKey;
     private tabId;
     private readonly windowId;
     private readonly locale;
     private readonly storageKey;
+    private readonly transcriptStorageKey;
+    private readonly transferAuthorityStorageKey;
+    private readonly stagedPendingLaunchStorageKey;
+    private readonly terminalEndStorageKey;
+    private readonly visitorIdentity;
     private readonly runtime;
     private readonly lock;
+    private readonly replayReadiness;
     private bootstrap;
     private view;
+    private messenger;
+    private messengerListenersBound;
+    private messengerReturnListenerBound;
+    private messengerIntegrationEnabled;
+    private messengerInitialLauncherVisible;
+    private messengerPreparing;
+    private messengerPreparationPromise;
+    private messengerLoadPromise;
+    private messengerHandoffRequestInFlight;
+    private handoffRequestLifecycleOwner;
+    private handoffRequestProgressTimer;
+    private messengerBindingChallengesInFlight;
+    private messengerBindingChallengesDelivered;
+    private messengerBindingChallengeAwaitingTerminal;
+    private messengerBindingTerminalDelivery;
+    private messengerBindingResume;
+    private messengerBindingTerminalAckInFlight;
+    private messengerTransferred;
+    private messengerTransferredConversationId;
+    private messengerTransferredSurface;
+    private messengerTransferEndPromise;
+    private messengerReturnActivationPromise;
+    private messengerReturnInFlight;
+    private messengerReturnRetryRemaining;
+    private messengerSuspendedAiSurface;
+    private messengerTransferPending;
+    private messengerTransferConversationId;
+    private messengerTransferAttemptId;
+    private messengerTransferDeadline;
+    private messengerTransferOpened;
+    private messengerTransferPreparationGeneration;
+    private messengerTransferHadFocus;
+    private messengerOpenAckInFlight;
+    private messengerTerminalDeliveryObserved;
+    private messengerTerminalDeliveryId;
+    private messengerTerminalSequence;
+    private messengerTerminalFencingToken;
+    private messengerTerminalClientSequence;
+    private messengerTerminalAckInFlight;
+    private messengerOpenTimer;
+    private messengerClosePrepared;
     private result;
+    private modeUpgradeTerminalResult;
     private channel;
     private media;
     private context;
     private presentation;
     private connectionAbort;
+    private connectionGeneration;
+    private sessionEffectGeneration;
+    private bootstrapAbort;
     private scopes;
     private mode;
     private ended;
     private reconnecting;
+    private resumeAttemptOwner;
+    private reconnectTimer;
+    private reconnectGeneration;
     private pendingSessionAuthorization;
+    private pendingSessionAuthorizationController;
     private terminalRequestPending;
+    private terminalRequestInFlight;
+    private terminalResumeRecord;
+    private terminalSessionAuthorization;
+    private terminalSessionAuthorizationController;
+    private terminalSessionAuthorizationFailure;
+    private terminalEndIntent;
+    private terminalPendingLaunch;
+    private terminalRetryTimer;
+    private terminalRetryWake;
+    private terminalOffline;
+    private terminalDeliveryRelinquished;
+    private terminalRecoveryOnly;
+    private terminalRetryAttempts;
+    private terminalInitializationDeferred;
     private reconnectAttempts;
+    private pauseCommandGeneration;
+    private pauseCommandAcked;
+    private pauseCommandStateObserved;
+    private pauseHelloStateSignals;
+    private authoritativePauseStateByChannel;
+    private conservativePreFencePresenceByChannel;
+    private preFenceAuthorityEnvelopesByChannel;
+    private preFenceAuthorityEnvelopes;
     private heartbeatSeconds;
+    private handoffContextPromptReceiptChannel;
     private pendingAction;
+    private actionGrantInFlight;
+    private completedActionGrants;
+    private pendingNavigationActionResult;
+    private pendingContextNavigationAcknowledgements;
+    private authoritativeSessionPath;
+    private authoritativeSessionPathClientSequence;
+    private voiceUpgradeIntentGeneration;
+    private queuedVoiceUpgradeIntentGeneration;
+    private legacyActionExecution;
+    private actionExecutionTail;
+    private actionExecutionGeneration;
+    private actionAuthorityGeneration;
+    private actionIngressRevocationGeneration;
+    private actionIngressRevocationGenerationByEnvelope;
+    private fencedAuthorityAtIngressByEnvelope;
+    private messengerPreparationReceivedAtByEnvelope;
+    private pageAssistanceRequestReceivedAtByEnvelope;
+    private correlatedConfirmationErrorsSettledAtIngress;
+    private contextResyncAuthorityRevokedAtIngress;
+    private correlatedTextErrorsSettledAtIngress;
+    private activeActionAuthorityEpoch;
+    private pendingPageAssistance;
+    private pageAssistanceExpiryTimer;
+    private pageAssistanceRecoveryExpiryTimer;
+    private pendingHandoffContext;
+    private handoffContextExpiryTimer;
+    private pageAssistancePreferenceStore;
+    private pageAssistancePreferenceReady;
+    private pageAssistanceRecoveryStore;
+    private pendingPageAssistanceRevocation;
+    private pageAssistanceRecoverySubmissionDigest;
+    private pageAssistanceRecoveryEffectTail;
+    private unsubscribePageAssistancePreference;
+    private pageAssistanceAuthorityGeneration;
+    private pageAssistanceBindingGeneration;
+    private minimumPageAssistanceAuthorityEpoch;
+    private activePageAssistanceAuthorityEpoch;
+    private navigationConsentResetCandidate;
+    private navigationConsentReset;
+    private navigationConsentResetReady;
+    private awaitingNavigationConsentReset;
+    private deferredPageAssistanceConsent;
+    private suppressPageAssistancePreferenceChange;
     private pendingConfirmation;
+    private pendingConfirmationDecisions;
+    private confirmationDecisionSending;
     private destroyed;
+    private initialized;
+    private readyDispatched;
+    private lifecyclePhase;
+    private unavailableReason;
+    private launchInFlight;
+    private visitorActiveTakeoverOnly;
+    private visitorActiveEligibilityRecheck;
+    private visitorActiveEligibilityRecheckController;
+    private visitorActiveEligibilityRecheckKey;
+    private launchGeneration;
+    private queuedLaunchToken;
+    private visitorLimitAbort;
     private lastLaunch;
+    private pendingOpenIntent;
+    private pendingQuestion;
+    private queuedQuestions;
+    private pendingQuestionSending;
+    private acceptedRequestIds;
+    private acknowledgedQuestionIds;
+    private failedQuestionIds;
     private visualConsentGranted;
     private manualTurn;
     private pushActive;
+    private pendingModeUpgrade;
+    private pendingModeUpgradeConsentCompensation;
+    private modeUpgradeReturnToTextEntry;
+    private pendingTextModeTransition;
     private activeFallback;
+    private activeFallbackTransitionToken;
     private pendingHumanFallback;
     private pendingFocusedHandoff;
+    private focusedHandoffInFlight;
+    private preparedFocusedHandoff;
+    private transcript;
+    private renderedTranscriptIds;
+    private transcriptRestoredFromCache;
     private agentDiscoveryLink;
     constructor(app: App, options: PluginOptions);
+    open(input?: AiGuideOpenInput): AiGuideControllerState;
+    close(): void;
+    getState(): AiGuideControllerState;
     end(): Promise<void>;
+    private endInBackground;
+    private endFailedModeUpgradeInBackground;
+    private endFailedModeUpgrade;
+    private requestEnd;
     destroy(): void;
     private initialize;
+    private rememberRequestId;
+    private rememberAcknowledgedQuestion;
+    private isLocallyRenderedQuestionEcho;
+    private clearPendingIntentBeforeAuthorization;
+    private clearPendingIntent;
+    private pendingQuestionCount;
+    private queueQuestion;
+    private removePendingQuestion;
+    private bindQuestionToSupersededConfirmation;
+    private performPendingOpen;
+    private handleViewOpenChange;
+    private publicModeUnavailable;
+    private startMessengerIntegration;
+    private prepareMessengerIntegration;
+    private performMessengerPreparation;
+    private resolveMessenger;
+    private currentMessengerDescriptor;
+    private messengerMatchesDescriptor;
+    private withMessengerTimeout;
+    private ensureMessengerAvailable;
+    private ensureMessengerBindingReceipt;
+    private currentMessengerBindingReceipt;
+    private clearHandoffRequestProgressTimer;
+    private beginHandoffRequestLifecycle;
+    private handoffRequestLifecycleIsCurrent;
+    private finishHandoffRequestLifecycle;
+    private armHandoffRequestProgressTimer;
+    private requestHumanHandoff;
+    private showRecoverableHandoffFailure;
+    private closeMessengerBeforeOpen;
+    private suspendAiSurfaceForMessenger;
+    private restoreAiSurfaceAfterMessengerFailure;
+    private clearSuspendedAiSurface;
+    private clearMessengerOpenTimer;
+    private clearMessengerTerminalDelivery;
+    private restoreMessengerBindingResume;
+    private persistMessengerBindingResume;
+    private rememberMessengerBindingChallenge;
+    private rememberMessengerBindingTerminal;
+    private clearMessengerBindingChallenge;
+    private stopMessengerIntegration;
+    private onMessengerReady;
+    private onMessengerOpened;
+    private handleMessengerOpened;
+    private onMessengerClosed;
+    private onMessengerReturnRequested;
+    private handleMessengerReturnRequested;
+    private startMessengerReturn;
+    private freshMessengerReturnScopes;
+    private createMessengerReturnView;
+    private returnToAiGuide;
+    private beginMessengerTransfer;
+    private messengerDisplayId;
+    private failMessengerTransfer;
+    private cancelMessengerTransferForTerminalPresentation;
+    private acknowledgeMessengerOpen;
+    private acknowledgeMessengerTerminal;
+    private messengerBindingTerminalFrom;
+    private retryMessengerBindingTerminalAck;
+    private acknowledgeMessengerBindingTerminal;
+    private completeMessengerTransfer;
+    private retireAiAfterMessengerTransfer;
+    private focusMessengerSurface;
     private syncAgentDiscovery;
     private widgetCallbacks;
+    private prepareForNextSession;
+    private clearFreshSessionAuthority;
+    private captureSessionEffectGuard;
     private fallbackAllowed;
     private standardFallbackBootstrap;
+    private effectivePageAssistanceBootstrap;
     private activateFallback;
     private launch;
     private applyVisitorLimitFailure;
+    private beginVisitorActiveEligibilityRecheck;
+    private finishVisitorActiveEligibilityRecheck;
+    private cancelVisitorActiveEligibilityRecheck;
     private resume;
     private connectTransport;
+    private requireControlReadiness;
+    private contextNavigationPath;
+    private trackContextNavigationAcknowledgement;
+    private deliverContextNavigation;
+    private commitAuthorizedRuntimePath;
+    private waitForPendingContextNavigationAcknowledgements;
     private startContext;
     private startPresentation;
     private sendText;
+    private flushPendingQuestion;
     private resolvePendingConfirmationReply;
     private cancelConfirmationForNewRequest;
+    private submitConfirmationDecision;
+    private flushPendingConfirmationDecision;
+    private discardPendingConfirmationDecisions;
+    private settleCorrelatedConfirmationError;
+    private settleCorrelatedTextError;
+    private parsePageAssistanceRequest;
+    private pageAssistanceActionMatchesCategory;
+    private pageAssistancePendingIdentity;
+    private samePageAssistanceIdentity;
+    private pageAssistanceDecisionWindowOpen;
+    private settlePageAssistanceDecisionCutoff;
+    private handlePageAssistanceRequest;
+    private resolvePageAssistanceRequest;
+    private submitPageAssistanceDecision;
+    private pageAssistanceResultMessageId;
+    private sendPageAssistanceResult;
+    private pageAssistanceRecoveries;
+    private clearPageAssistanceRecovery;
+    private queuePageAssistanceRecoveryEffect;
+    private schedulePageAssistanceRecoveryExpiry;
+    private validatePageAssistanceRecoveryEffect;
+    private consumePageAssistanceRecoveryEffect;
+    private currentPageAssistanceRecoveryBinding;
+    private rememberPageAssistanceRecovery;
+    private restorePageAssistanceRecovery;
+    private handlePageAssistanceUpdated;
+    private handlePageAssistanceAccessGranted;
+    private handleConsentUpdated;
+    private authoritativeConsentScopes;
+    private sameNavigationConsentResetIdentity;
+    private applyNavigationResumeConsent;
+    private waitForNavigationConsentReset;
+    private acknowledgeNavigationConsentReset;
+    private applyAuthoritativeConsent;
+    private commitAuthoritativeConsent;
+    private clearPendingPageAssistance;
+    private parseHandoffContextRequest;
+    private handleHandoffContextRequest;
+    private reconcilePendingHandoffContext;
+    private resolveHandoffContextRequest;
+    private sendHandoffContextResult;
+    private handleHandoffContextUpdated;
+    private clearPendingHandoffContext;
+    private strictSafeText;
+    private strictReceipt;
+    private shouldQuarantinePreFenceAuthority;
+    private handleControlIngress;
+    private revokeActiveActionAtIngress;
+    private correlatedControlOperation;
+    private controlOutcomeNeedsRetry;
+    private controlErrorPayload;
+    private revokeActiveAction;
+    private contextResyncAuthorityEpoch;
+    private revokeContextResyncActionAuthority;
+    private handleContextResyncRequired;
+    private applyPresenceState;
+    private reapplyConservativePreFencePresence;
+    private replayPreFenceAuthorityEnvelopes;
+    private preparePreFenceActionExecutionReadiness;
     private handleServerMessage;
+    private handleTrackedQuestionFailure;
+    private rememberFailedQuestion;
+    private actionRequiresExecutionTransition;
+    private pendingActionExecutionRecord;
+    private persistPendingActionExecution;
+    private restorePendingActionExecution;
+    private clearPendingActionExecution;
+    private unconfirmedActionExecutionResult;
+    private executionResultWithoutGrant;
+    private markPendingActionMutationApplied;
+    private handleActionExecutionReady;
+    private waitForActionExecutionReady;
+    private admitActionExecution;
     private executeGrant;
+    private terminalizeRejectedGrant;
+    private performActionGrant;
+    private failLegacyActionExecution;
+    private prepareNavigationActionPayload;
+    private deliverLegacyCausalNavigation;
+    private abandonLegacyCausalDelivery;
+    private sendPendingNavigationMessage;
+    private observePendingNavigationAck;
+    private pendingNavigationPayloadMatchesGrant;
+    private flushPendingNavigationActionResult;
+    private blockedActionResult;
+    private navigateTo;
+    private pruneCompletedActionGrants;
+    private rememberCompletedActionGrant;
     private confirmSafetySurface;
     private resolveVisualContext;
+    private deliverVisualContextResult;
     private parseGrant;
     private updateMute;
     private interrupt;
     private updateVoiceTurnMode;
     private updatePushToTalk;
+    private pauseCommandKey;
+    private samePauseCommand;
+    private stagePendingPauseCommand;
+    private clearPendingPauseCommand;
+    private parseRuntimeSessionState;
+    private parsePauseCommandStateObservation;
+    private observePauseCommandStateAtIngress;
+    private hadFencedAuthorityAtIngress;
+    private markPauseCommandAcknowledged;
+    private pauseStateMatchesAction;
+    private applyAuthoritativePauseState;
+    private waitForPauseHelloState;
+    private reconcilePendingPauseCommandAfterHello;
     private updatePause;
+    private performPauseCommand;
+    private revokePageAssistancePreference;
+    private handleControlSequenceGap;
+    private performPageAssistanceRevocation;
+    private pageAssistanceRevocationStorageKey;
+    private rememberPendingPageAssistanceRevocation;
+    private restorePendingPageAssistanceRevocation;
+    private clearPendingPageAssistanceRevocation;
+    private finalizePageAssistanceRevocation;
+    private flushPendingPageAssistanceRevocation;
+    private invalidatePageAssistanceAuthority;
+    private rotatePageAssistanceBindingGeneration;
+    private removeActiveBrowserControl;
     private updateCaptions;
     private updateVisualPause;
+    private setModeTransitionPending;
+    private resumeDisplayMode;
+    private currentDisplayMode;
+    private persistModeUpgradeResumeIntent;
+    private clearUnsentModeUpgradeResumeIntent;
+    private validModeUpgradeRecovery;
+    private validModeUpgradeResumeResult;
+    private reconcileModeUpgrade;
+    private resumeOrReconcileModeUpgrade;
+    private recoverStoredModeUpgrade;
+    private ensurePendingModeUpgrade;
+    private upgradeToVoice;
+    private updateModeUpgradeConsent;
+    private waitForModeUpgradeConsentApplied;
+    private beginModeUpgradeConsentCompensation;
+    private rebaseModeUpgradeConsentCompensation;
+    private flushModeUpgradeConsentCompensation;
+    private waitForModeUpgradeReady;
+    private waitForModeUpgradeTick;
+    private assertModeUpgradeCurrent;
+    private handleModeUpgradeReady;
+    private handleModeUpgradeCancelled;
+    private commitModeUpgradeActivation;
+    private clearModeUpgradeAttempt;
+    private relinquishModeUpgradeForRecovery;
+    private resetActionGrantAuthority;
+    private cancelQueuedVoiceUpgrade;
     private switchToText;
+    private commitTextModeActivation;
     private submitFeedback;
     private retry;
     private scheduleReconnect;
+    private reconnectMessengerTerminalControl;
+    private clearReconnectTimer;
+    private sameResumeIdentity;
+    private sameModeUpgradeIntent;
+    private retryableResumeFailure;
+    private unrecoverableResumeFailure;
+    private retryableModeUpgradeFailure;
+    private beginConnectionAttempt;
+    private assertConnectionCurrent;
+    private modeUpgradePathIsCurrent;
+    private assertModeUpgradePathCurrent;
+    private startModeUpgradeLifecycleGuard;
+    private waitForModeUpgradeLifecycle;
+    private waitForModeUpgradeConnectionDeadline;
+    private invalidateConnectionAttempt;
     private createMedia;
+    private releaseMedia;
+    private onReplayRecordingStopped;
+    private ownsTerminalDelivery;
+    private restoreTerminalEnd;
+    private startTerminalEndDelivery;
+    private wakeTerminalRetry;
+    private parkTerminalRetry;
+    private clearTerminalRetry;
     private finishFromServer;
+    private captureTerminalAuthorizedResult;
+    private completeRuntimeEnd;
+    private finishRuntimeEndAttempt;
+    private settleRuntimeEndRequest;
+    private settleAuthoritativeTerminalFailure;
+    private finishConfirmedRuntimeEnd;
+    private retryTerminalEnd;
+    private requestTerminalPendingLaunch;
+    private terminalPendingLaunchBootstrap;
+    private requestTerminalModeUpgradeReconciliation;
+    private waitForTerminalRequestDeadline;
+    private resumeInitializationAfterExpiredTerminalEnd;
+    private waitForTerminalRetry;
+    private quiesceLocalEffectsForTerminalRequest;
     private cleanupTransport;
     private requestRuntimeEnd;
+    private requestRecoveryRuntimeEnd;
     private send;
-    private replayContext;
+    private sendControlOutcome;
+    private initializePageAssistancePreference;
+    private pageAssistancePreferences;
+    private disposePageAssistancePreference;
+    private handlePageAssistancePreferenceChange;
     private visitorId;
+    private resolveVisitorId;
+    private readTranscript;
+    private persistTranscript;
+    private clearTranscriptCache;
+    private rememberTranscript;
+    private restoreTranscriptToView;
+    private focusedHandoffPayload;
+    private readTransferAuthority;
+    private readStagedPendingLaunch;
+    private persistStagedPendingLaunch;
+    private pendingLaunchMatches;
+    private stagePendingLaunch;
+    private clearStagedPendingLaunch;
+    private clearOwnedStagedPendingLaunch;
+    private clearTerminalPendingLaunchStage;
+    private commitStagedPendingLaunch;
+    private claimStagedPendingLaunch;
+    private markStagedPendingLaunchInFlight;
+    private acceptStagedPendingLaunch;
+    private hasStagedPendingLaunch;
+    private storeTransferAuthority;
+    private storeFocusedHandoffPayload;
+    private acceptStandbyPayload;
+    private publishCurrentStandby;
+    private readTerminalEndIntent;
+    private persistTerminalEndIntent;
+    private clearTerminalEndIntent;
+    private clearExpiredTerminalRecoveryStorage;
+    private createTerminalEndIntent;
+    private terminalIntentMatchesAuthority;
+    private storeTerminalResume;
+    private refreshTerminalResumeRecord;
     private readResume;
     private writeResume;
     private updateResumeManualTurn;
     private updateResumeSequence;
     private storeResume;
+    private clearResumeIfCurrent;
+    private clearResumeForTerminalSession;
+    private clearTerminalRequestIdentity;
     private clearResume;
     private publicError;
     private retryable;
     private string;
     private state;
+    private emitReadyEvent;
+    private emitStateEvent;
+    private dispatchPublicEvent;
     private sendPresentationResult;
     private isVoicePresence;
     private lowPowerMode;
@@ -101,8 +591,18 @@ export default class AiLiveAssist {
     private onVisibilityChange;
     private onOffline;
     private onOnline;
+    private onTerminalStorage;
+    private restoreTerminalFromStorage;
+    private handleTabActivityChange;
+    private relinquishForNewerFocus;
+    private drainPendingFocusedHandoff;
     private requestFocusedHandoff;
     private handoffToFocusedTab;
-    private acceptFocusedTabHandoff;
+    private prepareFocusedTabHandoff;
+    private commitFocusedTabHandoff;
+    private completeFocusedTabRelinquish;
+    private recoverFailedFocusedTabHandoff;
+    private recoverStandbySession;
     private onVisitorControl;
 }
+export {};