dominus-sdk-nodejs 3.0.1 → 3.0.3

package/dist/namespaces/oracle/OracleSession.d.ts

@@ -1,92 +0,0 @@
-/**
- * OracleSession - Main session class for streaming transcription.
- *
- * Provides the public API for Oracle streaming:
- * - start() / stop() lifecycle
- * - Event callbacks for transcripts, VAD state, errors
- * - NO sendAudio() exposed - VAD gates all audio automatically
- *
- * The session handles everything internally:
- * - Microphone access and audio capture
- * - Resampling to 16kHz mono PCM
- * - VAD gating (only sends speech, not silence)
- * - WebSocket connection to Oracle
- * - Ping/pong keepalive during IDLE
- */
-import type { VADState, ResolvedOracleSessionOptions } from './types.js';
-/**
- * OracleSession - Real-time speech-to-text with VAD gating.
- *
- * Usage:
- * ```typescript
- * const session = dominus.oracle.createSession(userJwt);
- *
- * session.onReady = () => console.log('Ready');
- * session.onInterim = (text) => setLiveText(text);
- * session.onUtterance = (text) => sendToCurator(text);
- * session.onVADStateChange = (state) => updateMicIcon(state);
- *
- * await session.start();
- * // ... user speaks ...
- * await session.stop();
- * ```
- */
-export declare class OracleSession {
-    private userToken;
-    private ws;
-    private vad;
-    private audio;
-    private _isActive;
-    private _vadState;
-    private pendingUtterance;
-    /** Called when session is ready to receive speech */
-    onReady: (() => void) | null;
-    /** Called with interim transcripts (may change) */
-    onInterim: ((text: string) => void) | null;
-    /** Called when a transcript segment is finalized */
-    onFinal: ((text: string) => void) | null;
-    /** Called when user finishes an utterance (trigger for Curator) */
-    onUtterance: ((text: string) => void) | null;
-    /** Called on any error */
-    onError: ((error: Error) => void) | null;
-    /** Called when session closes */
-    onClose: (() => void) | null;
-    /** Called when VAD state changes (for UI indicators) */
-    onVADStateChange: ((state: VADState) => void) | null;
-    constructor(baseUrl: string, userToken: string, options: ResolvedOracleSessionOptions);
-    /**
-     * Check if session is currently active.
-     */
-    get isActive(): boolean;
-    /**
-     * Get current VAD state.
-     */
-    get vadState(): VADState;
-    /**
-     * Start the transcription session.
-     *
-     * - Requests microphone permission
-     * - Connects WebSocket to Oracle
-     * - Begins VAD-gated audio streaming
-     *
-     * @throws Error if mic permission denied or connection fails
-     */
-    start(): Promise<void>;
-    /**
-     * Stop the transcription session.
-     *
-     * - Stops microphone capture
-     * - Closes WebSocket connection
-     * - Cleans up resources
-     */
-    stop(): Promise<void>;
-    /**
-     * Clean up all resources.
-     */
-    private cleanup;
-    /**
-     * Dispose of all resources (for cleanup on unmount).
-     */
-    dispose(): void;
-}
-//# sourceMappingURL=OracleSession.d.ts.map

package/dist/namespaces/oracle/OracleSession.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"OracleSession.d.ts","sourceRoot":"","sources":["../../../src/namespaces/oracle/OracleSession.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EACV,QAAQ,EACR,4BAA4B,EAC7B,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,aAAa;IAqCtB,OAAO,CAAC,SAAS;IApCnB,OAAO,CAAC,EAAE,CAAkB;IAC5B,OAAO,CAAC,GAAG,CAAU;IACrB,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAoB;IAKrC,OAAO,CAAC,gBAAgB,CAAM;IAI9B,qDAAqD;IAC9C,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAQ;IAE3C,mDAAmD;IAC5C,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAEzD,oDAAoD;IAC7C,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAEvD,mEAAmE;IAC5D,WAAW,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAE3D,0BAA0B;IACnB,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAEvD,iCAAiC;IAC1B,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAQ;IAE3C,wDAAwD;IACjD,gBAAgB,EAAE,CAAC,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;gBAGjE,OAAO,EAAE,MAAM,EACP,SAAS,EAAE,MAAM,EACzB,OAAO,EAAE,4BAA4B;IAcvC;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAID;;;;;;;;OAQG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsF5B;;;;;;OAMG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B;;OAEG;YACW,OAAO;IAerB;;OAEG;IACH,OAAO,IAAI,IAAI;CAgBhB"}

package/dist/namespaces/oracle/OracleSession.js

@@ -1,219 +0,0 @@
-/**
- * OracleSession - Main session class for streaming transcription.
- *
- * Provides the public API for Oracle streaming:
- * - start() / stop() lifecycle
- * - Event callbacks for transcripts, VAD state, errors
- * - NO sendAudio() exposed - VAD gates all audio automatically
- *
- * The session handles everything internally:
- * - Microphone access and audio capture
- * - Resampling to 16kHz mono PCM
- * - VAD gating (only sends speech, not silence)
- * - WebSocket connection to Oracle
- * - Ping/pong keepalive during IDLE
- */
-import { OracleWebSocket } from './internal/OracleWebSocket.js';
-import { VADGate } from './internal/VADGate.js';
-import { AudioCapture } from './internal/AudioCapture.js';
-/**
- * OracleSession - Real-time speech-to-text with VAD gating.
- *
- * Usage:
- * ```typescript
- * const session = dominus.oracle.createSession(userJwt);
- *
- * session.onReady = () => console.log('Ready');
- * session.onInterim = (text) => setLiveText(text);
- * session.onUtterance = (text) => sendToCurator(text);
- * session.onVADStateChange = (state) => updateMicIcon(state);
- *
- * await session.start();
- * // ... user speaks ...
- * await session.stop();
- * ```
- */
-export class OracleSession {
-    userToken;
-    ws;
-    vad;
-    audio;
-    _isActive = false;
-    _vadState = 'idle';
-    // Track accumulated transcript for utterance detection
-    // Since VAD stops sending audio before Deepgram's utterance_end_ms,
-    // we use VAD TRAILING→IDLE transition as utterance boundary
-    pendingUtterance = '';
-    // ========== EVENT CALLBACKS ==========
-    /** Called when session is ready to receive speech */
-    onReady = null;
-    /** Called with interim transcripts (may change) */
-    onInterim = null;
-    /** Called when a transcript segment is finalized */
-    onFinal = null;
-    /** Called when user finishes an utterance (trigger for Curator) */
-    onUtterance = null;
-    /** Called on any error */
-    onError = null;
-    /** Called when session closes */
-    onClose = null;
-    /** Called when VAD state changes (for UI indicators) */
-    onVADStateChange = null;
-    constructor(baseUrl, userToken, options) {
-        this.userToken = userToken;
-        // Initialize internal components
-        this.ws = new OracleWebSocket(baseUrl, {
-            pingIntervalMs: options.pingIntervalMs,
-        });
-        this.vad = new VADGate(options);
-        this.audio = new AudioCapture();
-    }
-    // ========== PUBLIC GETTERS ==========
-    /**
-     * Check if session is currently active.
-     */
-    get isActive() {
-        return this._isActive;
-    }
-    /**
-     * Get current VAD state.
-     */
-    get vadState() {
-        return this._vadState;
-    }
-    // ========== LIFECYCLE METHODS ==========
-    /**
-     * Start the transcription session.
-     *
-     * - Requests microphone permission
-     * - Connects WebSocket to Oracle
-     * - Begins VAD-gated audio streaming
-     *
-     * @throws Error if mic permission denied or connection fails
-     */
-    async start() {
-        if (this._isActive) {
-            return;
-        }
-        try {
-            // 1. Initialize VAD
-            await this.vad.initialize();
-            // 2. Connect WebSocket with first-message auth
-            await this.ws.connect(this.userToken);
-            // 3. Wire up transcript events
-            // Note: Deepgram's speech_final requires 2s silence, but VAD only sends 400ms trailing.
-            // So we accumulate is_final text and emit on VAD TRAILING→IDLE transition.
-            this.ws.onTranscript = (text, isFinal, speechFinal) => {
-                if (!isFinal) {
-                    // Interim: show in live view (may change)
-                    this.onInterim?.(text);
-                }
-                else {
-                    // Final: accumulate for utterance
-                    this.onFinal?.(text);
-                    // Accumulate finals - space-separated
-                    if (this.pendingUtterance) {
-                        this.pendingUtterance += ' ' + text;
-                    }
-                    else {
-                        this.pendingUtterance = text;
-                    }
-                }
-                // If Deepgram does send speech_final, honor it
-                if (speechFinal && text) {
-                    this.pendingUtterance = ''; // Clear since we're emitting
-                    this.onUtterance?.(text);
-                }
-            };
-            this.ws.onError = (error) => {
-                this.onError?.(error);
-            };
-            this.ws.onClose = () => {
-                this._isActive = false;
-                this.onClose?.();
-            };
-            // 4. Start audio capture
-            await this.audio.start();
-            // 5. Wire audio through VAD gate
-            this.audio.onFrame = (pcmFrame) => {
-                this.vad.processFrame(pcmFrame);
-            };
-            // 6. VAD gate controls what gets sent
-            this.vad.onSendAudio = (frames) => {
-                frames.forEach((frame) => this.ws.sendBinary(frame));
-            };
-            this.vad.onStateChange = (state) => {
-                const prevState = this._vadState;
-                this._vadState = state;
-                this.onVADStateChange?.(state);
-                // When VAD transitions to IDLE from TRAILING, emit accumulated utterance
-                // This is our primary utterance boundary since Deepgram's speech_final
-                // requires 2s silence but VAD only sends 400ms trailing
-                if (state === 'idle' && (prevState === 'trailing' || prevState === 'speaking')) {
-                    if (this.pendingUtterance.trim()) {
-                        console.log('[OracleSDK] VAD→IDLE: emitting utterance', {
-                            text: this.pendingUtterance.substring(0, 50),
-                        });
-                        this.onUtterance?.(this.pendingUtterance.trim());
-                        this.pendingUtterance = '';
-                    }
-                }
-            };
-            this._isActive = true;
-            this.onReady?.();
-        }
-        catch (error) {
-            // Clean up on failure
-            await this.cleanup();
-            throw error;
-        }
-    }
-    /**
-     * Stop the transcription session.
-     *
-     * - Stops microphone capture
-     * - Closes WebSocket connection
-     * - Cleans up resources
-     */
-    async stop() {
-        if (!this._isActive) {
-            return;
-        }
-        this._isActive = false;
-        await this.cleanup();
-        this.onClose?.();
-    }
-    // ========== PRIVATE METHODS ==========
-    /**
-     * Clean up all resources.
-     */
-    async cleanup() {
-        // Stop audio capture
-        await this.audio.stop();
-        // Close WebSocket
-        await this.ws.close();
-        // Reset VAD state
-        this.vad.reset();
-        this._vadState = 'idle';
-        // Clear pending utterance
-        this.pendingUtterance = '';
-    }
-    /**
-     * Dispose of all resources (for cleanup on unmount).
-     */
-    dispose() {
-        this.stop().catch(() => { });
-        // Clear all callbacks
-        this.onReady = null;
-        this.onInterim = null;
-        this.onFinal = null;
-        this.onUtterance = null;
-        this.onError = null;
-        this.onClose = null;
-        this.onVADStateChange = null;
-        // Dispose internal components
-        this.audio.dispose();
-        this.vad.dispose();
-    }
-}
-//# sourceMappingURL=OracleSession.js.map

package/dist/namespaces/oracle/OracleSession.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"OracleSession.js","sourceRoot":"","sources":["../../../src/namespaces/oracle/OracleSession.ts"],"names":[],"mappings":"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"}

package/dist/namespaces/oracle/index.d.ts

@@ -1,78 +0,0 @@
-/**
- * STT Namespace - Real-time streaming speech-to-text.
- *
- * Provides WebSocket-based streaming transcription via Deepgram,
- * with built-in VAD (Voice Activity Detection) for cost optimization.
- *
- * Key features:
- * - Automatic microphone capture and 16kHz resampling
- * - VAD gating: only sends audio when speech is detected
- * - 4-state VAD machine: IDLE → ARMED → SPEAKING → TRAILING
- * - Pre-roll buffer captures word onsets
- * - Ping/pong keepalive during IDLE
- * - NO sendAudio() exposed - VAD handles everything
- *
- * Usage:
- * ```typescript
- * const session = dominus.stt.createSession(userJwt);
- *
- * session.onReady = () => setListening(true);
- * session.onInterim = (text) => setLiveTranscript(text);
- * session.onUtterance = (text) => sendToCurator(text);
- * session.onVADStateChange = (state) => setMicState(state);
- * session.onError = (error) => showError(error);
- *
- * await session.start();
- * // ... user speaks, transcripts flow back ...
- * await session.stop();
- * ```
- */
-import type { DominusClient } from '../../lib/client.js';
-import { OracleSession } from './OracleSession.js';
-import { type OracleSessionOptions } from './types.js';
-export type { OracleSessionOptions, VADState } from './types.js';
-export { OracleSession } from './OracleSession.js';
-/**
- * SttNamespace - Factory for creating streaming transcription sessions.
- *
- * The STT namespace provides a simple API for real-time speech-to-text:
- * - createSession() creates a new transcription session
- * - Sessions handle mic capture, VAD, WebSocket, and transcripts internally
- * - NO raw audio access - VAD is mandatory for cost control
- */
-export declare class OracleNamespace {
-    private baseUrl;
-    constructor(_client: DominusClient);
-    /**
-     * Create a streaming transcription session.
-     *
-     * The session handles everything internally:
-     * - Microphone access and audio capture
-     * - Resampling to 16kHz mono PCM
-     * - VAD gating (only sends speech, not silence)
-     * - WebSocket connection to Oracle
-     * - Reconnection on connection loss
-     *
-     * @param userToken - User JWT from portal.login()
-     * @param options - Optional configuration overrides
-     * @returns OracleSession ready to start()
-     *
-     * @example
-     * ```typescript
-     * const session = dominus.stt.createSession(userJwt, {
-     *   prerollMs: 320,      // Capture 320ms before speech
-     *   postrollMs: 400,     // Continue 400ms after speech
-     *   armedConfirmMs: 80,  // Require 80ms to confirm speech
-     * });
-     *
-     * session.onUtterance = (text) => {
-     *   // Called when user finishes speaking
-     *   await sendToCurator(text);
-     * };
-     *
-     * await session.start();
-     * ```
-     */
-    createSession(userToken: string, options?: OracleSessionOptions): OracleSession;
-}
-//# sourceMappingURL=index.d.ts.map

package/dist/namespaces/oracle/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/namespaces/oracle/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAEL,KAAK,oBAAoB,EAE1B,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;GAOG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAS;gBAGZ,OAAO,EAAE,aAAa;IAIlC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,aAAa;CAShF"}

package/dist/namespaces/oracle/index.js

@@ -1,87 +0,0 @@
-/**
- * STT Namespace - Real-time streaming speech-to-text.
- *
- * Provides WebSocket-based streaming transcription via Deepgram,
- * with built-in VAD (Voice Activity Detection) for cost optimization.
- *
- * Key features:
- * - Automatic microphone capture and 16kHz resampling
- * - VAD gating: only sends audio when speech is detected
- * - 4-state VAD machine: IDLE → ARMED → SPEAKING → TRAILING
- * - Pre-roll buffer captures word onsets
- * - Ping/pong keepalive during IDLE
- * - NO sendAudio() exposed - VAD handles everything
- *
- * Usage:
- * ```typescript
- * const session = dominus.stt.createSession(userJwt);
- *
- * session.onReady = () => setListening(true);
- * session.onInterim = (text) => setLiveTranscript(text);
- * session.onUtterance = (text) => sendToCurator(text);
- * session.onVADStateChange = (state) => setMicState(state);
- * session.onError = (error) => showError(error);
- *
- * await session.start();
- * // ... user speaks, transcripts flow back ...
- * await session.stop();
- * ```
- */
-import { BASE_URL } from '../../lib/config.js';
-import { OracleSession } from './OracleSession.js';
-import { DEFAULT_OPTIONS, } from './types.js';
-export { OracleSession } from './OracleSession.js';
-/**
- * SttNamespace - Factory for creating streaming transcription sessions.
- *
- * The STT namespace provides a simple API for real-time speech-to-text:
- * - createSession() creates a new transcription session
- * - Sessions handle mic capture, VAD, WebSocket, and transcripts internally
- * - NO raw audio access - VAD is mandatory for cost control
- */
-export class OracleNamespace {
-    baseUrl;
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    constructor(_client) {
-        this.baseUrl = BASE_URL;
-    }
-    /**
-     * Create a streaming transcription session.
-     *
-     * The session handles everything internally:
-     * - Microphone access and audio capture
-     * - Resampling to 16kHz mono PCM
-     * - VAD gating (only sends speech, not silence)
-     * - WebSocket connection to Oracle
-     * - Reconnection on connection loss
-     *
-     * @param userToken - User JWT from portal.login()
-     * @param options - Optional configuration overrides
-     * @returns OracleSession ready to start()
-     *
-     * @example
-     * ```typescript
-     * const session = dominus.stt.createSession(userJwt, {
-     *   prerollMs: 320,      // Capture 320ms before speech
-     *   postrollMs: 400,     // Continue 400ms after speech
-     *   armedConfirmMs: 80,  // Require 80ms to confirm speech
-     * });
-     *
-     * session.onUtterance = (text) => {
-     *   // Called when user finishes speaking
-     *   await sendToCurator(text);
-     * };
-     *
-     * await session.start();
-     * ```
-     */
-    createSession(userToken, options) {
-        // Merge options with defaults
-        const resolvedOptions = {
-            ...DEFAULT_OPTIONS,
-            ...options,
-        };
-        return new OracleSession(this.baseUrl, userToken, resolvedOptions);
-    }
-}
-//# sourceMappingURL=index.js.map

package/dist/namespaces/oracle/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/namespaces/oracle/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,eAAe,GAGhB,MAAM,YAAY,CAAC;AAIpB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;GAOG;AACH,MAAM,OAAO,eAAe;IAClB,OAAO,CAAS;IAExB,6DAA6D;IAC7D,YAAY,OAAsB;QAChC,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC;IAC1B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,aAAa,CAAC,SAAiB,EAAE,OAA8B;QAC7D,8BAA8B;QAC9B,MAAM,eAAe,GAAiC;YACpD,GAAG,eAAe;YAClB,GAAG,OAAO;SACX,CAAC;QAEF,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;IACrE,CAAC;CACF"}

package/dist/namespaces/oracle/internal/AudioCapture.d.ts

@@ -1,42 +0,0 @@
-/**
- * AudioCapture - Microphone capture and resampling (INTERNAL)
- *
- * Handles:
- * - getUserMedia microphone access
- * - AudioWorklet for low-latency processing
- * - Resampling to 16kHz mono if needed
- * - Output 20ms frames (640 bytes PCM16)
- *
- * This module is INTERNAL and should NOT be exported publicly.
- */
-/**
- * AudioCapture - Main class for microphone capture.
- *
- * Automatically uses AudioWorklet if available, falls back to ScriptProcessor.
- * Outputs 20ms frames (640 bytes PCM16) at 16kHz mono.
- */
-export declare class AudioCapture {
-    private capture;
-    private _isCapturing;
-    /** Callback for each audio frame */
-    onFrame: ((pcmFrame: ArrayBuffer) => void) | null;
-    /**
-     * Check if currently capturing audio.
-     */
-    get isCapturing(): boolean;
-    /**
-     * Start audio capture from microphone.
-     *
-     * @throws Error if microphone permission denied or capture fails
-     */
-    start(): Promise<void>;
-    /**
-     * Stop audio capture.
-     */
-    stop(): Promise<void>;
-    /**
-     * Clean up resources.
-     */
-    dispose(): void;
-}
-//# sourceMappingURL=AudioCapture.d.ts.map

package/dist/namespaces/oracle/internal/AudioCapture.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AudioCapture.d.ts","sourceRoot":"","sources":["../../../../src/namespaces/oracle/internal/AudioCapture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAiRH;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAwD;IACvE,OAAO,CAAC,YAAY,CAAS;IAE7B,oCAAoC;IAC7B,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,WAAW,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAEhE;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqC5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAU3B;;OAEG;IACH,OAAO,IAAI,IAAI;CAIhB"}