dominus-sdk-nodejs-dev 1.2.18 → 1.2.44

package/dist/namespaces/files.d.ts

@@ -31,6 +31,81 @@ export interface FileInfo {
     path?: string;
     actor?: string;
 }
+export interface BrowseResult {
+    path: string;
+    folders: FolderInfo[];
+    files: BrowseFileInfo[];
+    cursor?: string;
+}
+export interface FolderInfo {
+    name: string;
+    path: string;
+}
+export interface BrowseFileInfo {
+    id: string;
+    name: string;
+    path: string;
+    size_bytes: number;
+    content_type: string;
+    created_at: string;
+}
+export interface StorageStats {
+    total_objects: number;
+    total_size_bytes: number;
+    by_category: Record<string, CategoryStats>;
+}
+export interface CategoryStats {
+    count: number;
+    size: number;
+}
+export interface CategoriesResponse {
+    categories: CategoryInfo[];
+}
+export interface CategoryInfo {
+    name: string;
+    object_count: number;
+    total_size_bytes: number;
+}
+export interface CreateFolderResult {
+    created: boolean;
+    exists?: boolean;
+    path: string;
+    placeholder_id?: string;
+    message?: string;
+}
+export interface DeleteFolderResult {
+    deleted: boolean;
+    path: string;
+    deleted_count?: number;
+    retained_count?: number;
+    has_compliance?: boolean;
+    compliance_count?: number;
+    message?: string;
+    errors?: string[];
+}
+export interface FactoryResetResult {
+    reset: boolean;
+    deleted_count: number;
+    retained_count: number;
+    by_category: Record<string, {
+        deleted: number;
+        retained: number;
+    }>;
+    initialized_folders?: string[];
+    message?: string;
+    errors?: string[];
+}
+export interface ViewInfo {
+    name: string;
+    object_count: number;
+    total_size_bytes: number;
+    is_reserved: boolean;
+}
+export interface ViewsResult {
+    views: ViewInfo[];
+    total_views: number;
+    is_admin: boolean;
+}
 export declare class FilesNamespace {
     private client;
     constructor(client: DominusClient);
@@ -103,5 +178,83 @@ export declare class FilesNamespace {
         tags?: Record<string, string>;
         description?: string;
     }): Promise<Record<string, unknown>>;
+    /**
+     * Browse storage with hierarchical navigation.
+     *
+     * @param options - Browse options
+     */
+    browse(options: {
+        category: string;
+        path?: string;
+        includeSubfolders?: boolean;
+        limit?: number;
+        cursor?: string;
+    }): Promise<BrowseResult>;
+    /**
+     * Get storage statistics.
+     */
+    getStorageStats(): Promise<StorageStats>;
+    /**
+     * List all categories (root folders) in storage.
+     */
+    listCategories(): Promise<CategoriesResponse>;
+    /**
+     * List storage views filtered by user access.
+     *
+     * Views are the root-level scopes in the path structure:
+     * - 'admin' - System/admin files (admin-only)
+     * - 'shared' - Non-tenant-specific files (all users)
+     * - '{tenant_slug}' - Tenant-specific files (user must have access)
+     *
+     * Admin users (with 'admin' or 'admin-view' scope) see ALL views.
+     * Regular users see 'shared' + their active_tenant view.
+     *
+     * @param options - Optional user context for filtering
+     * @param options.userScopes - User's scopes (e.g., ['admin', 'admin-view'])
+     * @param options.activeTenant - User's active tenant slug
+     */
+    listViews(options?: {
+        userScopes?: string[];
+        activeTenant?: string;
+    }): Promise<ViewsResult>;
+    /**
+     * List categories within a specific view (scope).
+     *
+     * @param view - View/scope name (admin, shared, or tenant slug)
+     */
+    listCategoriesInView(view: string): Promise<CategoriesResponse>;
+    /**
+     * Create a virtual folder.
+     *
+     * @param options - Folder creation options
+     */
+    createFolder(options: {
+        category: string;
+        path: string;
+    }): Promise<CreateFolderResult>;
+    /**
+     * Delete a virtual folder and all its contents.
+     *
+     * @param options - Folder deletion options
+     */
+    deleteFolder(options: {
+        category: string;
+        path: string;
+        force?: boolean;
+    }): Promise<DeleteFolderResult>;
+    /**
+     * Factory reset - delete ALL objects in the project/environment.
+     *
+     * WARNING: This will permanently delete all files in storage.
+     * Compliance objects will be moved to retention unless force=true.
+     *
+     * @param options - Reset options
+     * @param options.force - If true, hard delete even compliance objects
+     * @param options.reinitializeStructure - If true (default), recreate default folder structure after reset
+     */
+    factoryReset(options?: {
+        force?: boolean;
+        reinitializeStructure?: boolean;
+    }): Promise<FactoryResetResult>;
 }
 //# sourceMappingURL=files.d.ts.map

package/dist/namespaces/files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/namespaces/files.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAEzC;;;;;;OAMG;IACG,MAAM,CACV,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;QACP,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;KACnB,GACL,OAAO,CAAC,YAAY,CAAC;IAmCxB;;;;OAIG;IACG,QAAQ,CACZ,OAAO,EAAE,QAAQ,GAAG;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9C,OAAO,CAAC,cAAc,CAAC;IAgB1B;;;;OAIG;IACG,KAAK,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC;IAgBpD;;;;OAIG;IACG,IAAI,CACR,OAAO,GAAE;QACP,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACZ,GACL,OAAO,CAAC,UAAU,CAAC;IAetB;;;;OAIG;IACG,MAAM,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAgB9D;;;;;OAKG;IACG,IAAI,CACR,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAClD,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAcnC;;;;;OAKG;IACG,UAAU,CACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/D,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAapC"}
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/namespaces/files.ts"],"names":[],"mappings":"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"}

package/dist/namespaces/files.js

@@ -157,5 +157,130 @@ export class FilesNamespace {
             body,
         });
     }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Storage Browser Methods
+    // ─────────────────────────────────────────────────────────────────────────────
+    /**
+     * Browse storage with hierarchical navigation.
+     *
+     * @param options - Browse options
+     */
+    async browse(options) {
+        return this.client.request({
+            endpoint: '/api/archivist/browse',
+            body: {
+                category: options.category,
+                path: options.path,
+                include_subfolders: options.includeSubfolders ?? true,
+                limit: options.limit ?? 100,
+                cursor: options.cursor,
+            },
+        });
+    }
+    /**
+     * Get storage statistics.
+     */
+    async getStorageStats() {
+        return this.client.request({
+            endpoint: '/api/archivist/stats',
+            method: 'GET',
+        });
+    }
+    /**
+     * List all categories (root folders) in storage.
+     */
+    async listCategories() {
+        return this.client.request({
+            endpoint: '/api/archivist/categories',
+            method: 'GET',
+        });
+    }
+    /**
+     * List storage views filtered by user access.
+     *
+     * Views are the root-level scopes in the path structure:
+     * - 'admin' - System/admin files (admin-only)
+     * - 'shared' - Non-tenant-specific files (all users)
+     * - '{tenant_slug}' - Tenant-specific files (user must have access)
+     *
+     * Admin users (with 'admin' or 'admin-view' scope) see ALL views.
+     * Regular users see 'shared' + their active_tenant view.
+     *
+     * @param options - Optional user context for filtering
+     * @param options.userScopes - User's scopes (e.g., ['admin', 'admin-view'])
+     * @param options.activeTenant - User's active tenant slug
+     */
+    async listViews(options) {
+        // Use POST with base64-encoded body (consistent with all other orchestrator endpoints)
+        return this.client.request({
+            endpoint: '/api/archivist/views',
+            method: 'POST',
+            body: {
+                user_scopes: options?.userScopes || [],
+                active_tenant: options?.activeTenant || null,
+            },
+        });
+    }
+    /**
+     * List categories within a specific view (scope).
+     *
+     * @param view - View/scope name (admin, shared, or tenant slug)
+     */
+    async listCategoriesInView(view) {
+        return this.client.request({
+            endpoint: `/api/archivist/views/${encodeURIComponent(view)}/categories`,
+            method: 'GET',
+        });
+    }
+    /**
+     * Create a virtual folder.
+     *
+     * @param options - Folder creation options
+     */
+    async createFolder(options) {
+        return this.client.request({
+            endpoint: '/api/archivist/folder',
+            body: {
+                category: options.category,
+                path: options.path,
+            },
+        });
+    }
+    /**
+     * Delete a virtual folder and all its contents.
+     *
+     * @param options - Folder deletion options
+     */
+    async deleteFolder(options) {
+        return this.client.request({
+            endpoint: '/api/archivist/folder',
+            method: 'DELETE',
+            body: {
+                category: options.category,
+                path: options.path,
+                force: options.force ?? false,
+            },
+        });
+    }
+    /**
+     * Factory reset - delete ALL objects in the project/environment.
+     *
+     * WARNING: This will permanently delete all files in storage.
+     * Compliance objects will be moved to retention unless force=true.
+     *
+     * @param options - Reset options
+     * @param options.force - If true, hard delete even compliance objects
+     * @param options.reinitializeStructure - If true (default), recreate default folder structure after reset
+     */
+    async factoryReset(options) {
+        return this.client.request({
+            endpoint: '/api/archivist/factory-reset',
+            body: {
+                confirm: 'FACTORY_RESET',
+                force: options?.force ?? false,
+                reinitialize_structure: options?.reinitializeStructure ?? true,
+            },
+        });
+    }
 }
 //# sourceMappingURL=files.js.map

package/dist/namespaces/files.js.map

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

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

@@ -0,0 +1,92 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,219 @@
+/**
+ * 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

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