@oxvo/ai-live-assist 7.3.4 → 7.4.23

package/cjs/control.d.ts

@@ -1,31 +1,96 @@
-import type { ControlServerEnvelope, LaunchResult } from './types.js';
-type Handler = (message: ControlServerEnvelope) => void | Promise<void>;
+import type { ControlServerEnvelope, RuntimeAuthorization } from "./types.js";
+type Handler = (message: ControlServerEnvelope, isCurrent: () => boolean) => void | Promise<void>;
+type IngressHandler = (message: ControlServerEnvelope, isCurrent: () => boolean) => void;
+export type ControlDeliveryOutcome = {
+    status: "ack";
+    messageId: string;
+    sequence: number;
+} | {
+    status: "explicit_error";
+    messageId: string;
+    sequence: number;
+    code: string;
+    message: string;
+    retryable: boolean;
+    retryAfterMs: number | null;
+} | {
+    status: "timeout" | "invalidated";
+    messageId: string;
+    sequence: number;
+};
+export type ControlOutboundOperation = {
+    messageId: string;
+    sequence: number;
+    type: string;
+};
+export type ReservedControlOperation = Readonly<ControlOutboundOperation>;
 export declare class ControlChannel {
     private readonly result;
     private readonly tabId;
     private readonly clientVersion;
     private readonly onDisconnect;
     private readonly onClientSequence;
+    private readonly onUnsafeDisconnect;
     private socket;
     private clientSequence;
     private serverSequence;
+    private serverBaselineEstablished;
+    private sequenceGapDetected;
+    private recoveryDisconnectNotified;
     private fencingToken;
     private heartbeat;
     private handlers;
+    private ingressHandlers;
     private intentionallyClosed;
-    private pendingAcks;
-    private recentAcks;
-    constructor(result: LaunchResult, tabId: string, clientVersion: string, onDisconnect: () => void, initialClientSequence?: number, onClientSequence?: (sequence: number) => void);
+    private pendingOutcomes;
+    private recentOutcomes;
+    private outboundOperations;
+    private latestOutboundSequence;
+    private unsettledStatefulOperations;
+    private socketGeneration;
+    private handlerTail;
+    private pendingHandlerMessages;
+    private pendingConnection;
+    private helloOperation;
+    private fencedAuthorityConfirmed;
+    constructor(result: RuntimeAuthorization, tabId: string, clientVersion: string, onDisconnect: () => void, initialClientSequence?: number, onClientSequence?: (sequence: number) => void, onUnsafeDisconnect?: () => void);
     get leaseToken(): number;
+    get lastClientSequence(): number;
     get isOpen(): boolean;
+    get connectionHelloOperation(): ReservedControlOperation | null;
+    get hasFencedAuthority(): boolean;
     setFencingToken(value: number): void;
     subscribe(handler: Handler): () => void;
+    subscribeIngress(handler: IngressHandler): () => void;
     connect(signal: AbortSignal, resume: boolean): Promise<void>;
-    send(type: string, payload: Record<string, unknown>): string;
+    send(type: string, payload: Record<string, unknown>, stableMessageId?: string): string;
+    reserveOperationIdentity(type: string, stableMessageId?: string): ReservedControlOperation;
+    sendReserved(operation: ReservedControlOperation, payload: Record<string, unknown>): string;
+    outboundOperation(messageId: string, sequence?: number): ControlOutboundOperation | null;
+    waitForOutcome(messageId: string, timeoutMs?: number, expectedSequence?: number): Promise<ControlDeliveryOutcome>;
     waitForAck(messageId: string, timeoutMs?: number): Promise<boolean>;
+    waitForHelloOutcome(timeoutMs?: number): Promise<ControlDeliveryOutcome>;
+    proveFencedAuthority(timeoutMs?: number): Promise<ControlDeliveryOutcome>;
     startHeartbeat(seconds: number): void;
     close(code?: number, reason?: string): void;
     private handleMessage;
-    private stopHeartbeat;
+    private recoverFromSequenceGap;
+    private notifyUnsafeDisconnect;
+    private enqueueHandlers;
+    private dispatchHandlers;
+    private handleHandlerFailure;
+    private dispatchIngressHandlers;
+    private failCurrentGeneration;
+    private isMessageSourceCurrent;
+    private isCurrentSocket;
+    private retireSocket;
+    private sendHeartbeat;
+    private withHandlerDeadline;
+    private clearPendingConnection;
+    private rejectPendingConnection;
+    private settleOutcome;
+    private invalidatePendingOutcomes;
+    private pruneSettledOperationHistory;
+    stopHeartbeat(): void;
 }
 export {};