voice-router-dev 0.3.3 → 0.3.4

package/dist/index.js

@@ -583,6 +583,12 @@ var Status = {
   Failed: "Failed"
 };
 
+// src/generated/deepgram/schema/manageV1FilterStatusParameter.ts
+var ManageV1FilterStatusParameter = {
+  succeeded: "succeeded",
+  failed: "failed"
+};
+
 // src/constants.ts
 var DeepgramEncoding = ListenV1EncodingParameter;
 var DeepgramRedact = ListenV1RedactParameterOneOfItem;
@@ -1880,6 +1886,12 @@ var preRecordedControllerGetPreRecordedJobV2 = (id, options) => {
 var preRecordedControllerDeletePreRecordedJobV2 = (id, options) => {
   return import_axios.default.delete(`/v2/pre-recorded/${id}`, options);
 };
+var preRecordedControllerGetAudioV2 = (id, options) => {
+  return import_axios.default.get(`/v2/pre-recorded/${id}/file`, {
+    responseType: "blob",
+    ...options
+  });
+};
 var transcriptionControllerListV2 = (params, options) => {
   return import_axios.default.get("/v2/transcription", {
     ...options,
@@ -1895,6 +1907,12 @@ var streamingControllerInitStreamingSessionV2 = (streamingRequest, params, optio
 var streamingControllerDeleteStreamingJobV2 = (id, options) => {
   return import_axios.default.delete(`/v2/live/${id}`, options);
 };
+var streamingControllerGetAudioV2 = (id, options) => {
+  return import_axios.default.get(`/v2/live/${id}/file`, {
+    responseType: "blob",
+    ...options
+  });
+};
 
 // src/adapters/gladia-adapter.ts
 var GladiaAdapter = class extends BaseAdapter {
@@ -1913,7 +1931,9 @@ var GladiaAdapter = class extends BaseAdapter {
       piiRedaction: false,
       // Gladia doesn't have PII redaction in their API
       listTranscripts: true,
-      deleteTranscript: true
+      deleteTranscript: true,
+      getAudioFile: true
+      // Gladia stores and allows downloading original audio files
     };
     this.baseUrl = "https://api.gladia.io";
   }
@@ -2128,6 +2148,10 @@ var GladiaAdapter = class extends BaseAdapter {
         utterances: this.extractUtterances(transcription),
         summary: result?.summarization?.results || void 0,
         metadata: {
+          sourceAudioUrl: response.file?.source ?? void 0,
+          audioFileAvailable: this.capabilities.getAudioFile ?? false,
+          filename: response.file?.filename ?? void 0,
+          audioDuration: response.file?.audio_duration ?? void 0,
           requestParams: response.request_params
         },
         createdAt: response.created_at,
@@ -2246,6 +2270,72 @@ var GladiaAdapter = class extends BaseAdapter {
       throw error;
     }
   }
+  /**
+   * Download the original audio file from a transcription
+   *
+   * Gladia stores the audio files used for transcription and allows downloading them.
+   * This works for both pre-recorded and streaming (live) transcriptions.
+   *
+   * @param transcriptId - The ID of the transcript/job
+   * @param jobType - Type of job: 'pre-recorded' or 'streaming' (defaults to 'pre-recorded')
+   * @returns Promise with the audio file as a Blob, or error
+   *
+   * @example Download audio from a pre-recorded transcription
+   * ```typescript
+   * const result = await adapter.getAudioFile('abc123');
+   * if (result.success && result.data) {
+   *   // Save to file (Node.js)
+   *   const buffer = Buffer.from(await result.data.arrayBuffer());
+   *   fs.writeFileSync('audio.mp3', buffer);
+   *
+   *   // Or create download URL (browser)
+   *   const url = URL.createObjectURL(result.data);
+   * }
+   * ```
+   *
+   * @example Download audio from a live/streaming session
+   * ```typescript
+   * const result = await adapter.getAudioFile('stream-456', 'streaming');
+   * if (result.success) {
+   *   console.log('Audio file size:', result.data?.size);
+   * }
+   * ```
+   *
+   * @see https://docs.gladia.io/
+   */
+  async getAudioFile(transcriptId, jobType = "pre-recorded") {
+    this.validateConfig();
+    try {
+      let response;
+      if (jobType === "streaming") {
+        response = await streamingControllerGetAudioV2(transcriptId, this.getAxiosConfig());
+      } else {
+        response = await preRecordedControllerGetAudioV2(transcriptId, this.getAxiosConfig());
+      }
+      return {
+        success: true,
+        data: response.data
+      };
+    } catch (error) {
+      const err = error;
+      if (err.response?.status === 404) {
+        return {
+          success: false,
+          error: {
+            code: "NOT_FOUND",
+            message: `Audio file not found for transcript ${transcriptId}`
+          }
+        };
+      }
+      return {
+        success: false,
+        error: {
+          code: "DOWNLOAD_ERROR",
+          message: err.message || "Failed to download audio file"
+        }
+      };
+    }
+  }
   /**
    * List recent transcriptions with filtering
    *
@@ -2350,6 +2440,7 @@ var GladiaAdapter = class extends BaseAdapter {
     const id = preRecorded.id || streaming.id;
     const status = normalizeStatus(preRecorded.status || streaming.status, "gladia");
     const text = preRecorded.result?.transcription?.full_transcript || "";
+    const file = preRecorded.file;
     return {
       success: status !== "error",
       provider: this.name,
@@ -2357,7 +2448,13 @@ var GladiaAdapter = class extends BaseAdapter {
         id,
         text,
         status,
+        duration: file?.audio_duration ?? void 0,
         metadata: {
+          sourceAudioUrl: file?.source ?? void 0,
+          audioFileAvailable: this.capabilities.getAudioFile ?? false,
+          filename: file?.filename ?? void 0,
+          audioDuration: file?.audio_duration ?? void 0,
+          numberOfChannels: file?.number_of_channels ?? void 0,
           createdAt: preRecorded.created_at || streaming.created_at,
           completedAt: preRecorded.completed_at || streaming.completed_at || void 0,
           kind: isLive ? "live" : "pre-recorded",
@@ -2367,7 +2464,8 @@ var GladiaAdapter = class extends BaseAdapter {
       error: preRecorded.error_code || streaming.error_code ? {
         code: (preRecorded.error_code || streaming.error_code)?.toString() || "ERROR",
         message: "Transcription failed"
-      } : void 0
+      } : void 0,
+      raw: item
     };
   }
   /**
@@ -3518,8 +3616,10 @@ var AssemblyAIAdapter = class extends BaseAdapter {
         text: "",
         // List items don't include full text
         status: item.status,
+        // Note: audio_duration is NOT available in TranscriptListItem (only in full Transcript)
         metadata: {
-          audioUrl: item.audio_url,
+          sourceAudioUrl: item.audio_url,
+          audioFileAvailable: this.capabilities.getAudioFile ?? false,
           createdAt: item.created,
           completedAt: item.completed || void 0,
           resourceUrl: item.resource_url
@@ -3528,7 +3628,8 @@ var AssemblyAIAdapter = class extends BaseAdapter {
       error: item.error ? {
         code: "TRANSCRIPTION_ERROR",
         message: item.error
-      } : void 0
+      } : void 0,
+      raw: item
     };
   }
   /**
@@ -3638,7 +3739,8 @@ var AssemblyAIAdapter = class extends BaseAdapter {
         utterances: this.extractUtterances(response),
         summary: response.summary || void 0,
         metadata: {
-          audioUrl: response.audio_url
+          sourceAudioUrl: response.audio_url,
+          audioFileAvailable: this.capabilities.getAudioFile ?? false
         }
       },
       // Extended data - fully typed from OpenAPI specs
@@ -4083,6 +4185,16 @@ function createAssemblyAIAdapter(config) {
 // src/adapters/deepgram-adapter.ts
 var import_axios3 = __toESM(require("axios"));
 var import_ws3 = __toESM(require("ws"));
+
+// src/generated/deepgram/schema/manageV1FilterEndpointParameter.ts
+var ManageV1FilterEndpointParameter = {
+  listen: "listen",
+  read: "read",
+  speak: "speak",
+  agent: "agent"
+};
+
+// src/adapters/deepgram-adapter.ts
 var DeepgramAdapter = class extends BaseAdapter {
   constructor() {
     super(...arguments);
@@ -4097,8 +4209,8 @@ var DeepgramAdapter = class extends BaseAdapter {
       sentimentAnalysis: true,
       entityDetection: true,
       piiRedaction: true,
-      listTranscripts: false,
-      // Deepgram doesn't store transcripts
+      listTranscripts: true,
+      // Via request history API (requires projectId)
       deleteTranscript: false
     };
     this.baseUrl = "https://api.deepgram.com/v1";
@@ -4106,6 +4218,7 @@ var DeepgramAdapter = class extends BaseAdapter {
   }
   initialize(config) {
     super.initialize(config);
+    this.projectId = config.projectId;
     this.client = import_axios3.default.create({
       baseURL: config.baseUrl || this.baseUrl,
       timeout: config.timeout || 6e4,
@@ -4190,23 +4303,66 @@ var DeepgramAdapter = class extends BaseAdapter {
   /**
    * Get transcription result by ID
    *
-   * Note: Deepgram processes synchronously, so this method is primarily
-   * for retrieving cached results if you've stored the request ID.
-   * The initial transcribe() call already returns complete results.
+   * Retrieves a previous transcription from Deepgram's request history.
    *
-   * @param transcriptId - Request ID from Deepgram
-   * @returns Normalized transcription response
+   * Unlike the list endpoint, getting a single request DOES include the full
+   * transcript response. Requires `projectId` to be set during initialization.
+   *
+   * @param transcriptId - Request ID from a previous transcription
+   * @returns Full transcript response including text, words, and metadata
+   *
+   * @example Get a transcript by request ID
+   * ```typescript
+   * const adapter = new DeepgramAdapter()
+   * adapter.initialize({
+   *   apiKey: process.env.DEEPGRAM_API_KEY,
+   *   projectId: process.env.DEEPGRAM_PROJECT_ID
+   * })
+   *
+   * const result = await adapter.getTranscript('abc123-request-id')
+   * if (result.success) {
+   *   console.log(result.data?.text)
+   *   console.log(result.data?.words)
+   * }
+   * ```
+   *
+   * @see https://developers.deepgram.com/reference/get-request
    */
   async getTranscript(transcriptId) {
     this.validateConfig();
-    return {
-      success: false,
-      provider: this.name,
-      error: {
-        code: "NOT_SUPPORTED",
-        message: "Deepgram returns transcription results immediately. Store the response from transcribe() instead of using getTranscript()."
+    if (!this.projectId) {
+      return {
+        success: false,
+        provider: this.name,
+        error: {
+          code: "MISSING_PROJECT_ID",
+          message: "Deepgram getTranscript requires projectId. Initialize with: { apiKey, projectId }"
+        }
+      };
+    }
+    try {
+      const response = await this.client.get(
+        `/projects/${this.projectId}/requests/${transcriptId}`
+      );
+      const request = response.data.request;
+      if (!request) {
+        return {
+          success: false,
+          provider: this.name,
+          error: {
+            code: "NOT_FOUND",
+            message: `Request ${transcriptId} not found`
+          }
+        };
       }
-    };
+      const transcriptResponse = request.response;
+      if (!transcriptResponse) {
+        return this.normalizeRequestItem(request);
+      }
+      return this.normalizeResponse(transcriptResponse);
+    } catch (error) {
+      return this.createErrorResponse(error);
+    }
   }
   /**
    * Build Deepgram transcription parameters from unified options
@@ -4776,6 +4932,133 @@ var DeepgramAdapter = class extends BaseAdapter {
       }
     }
   }
+  /**
+   * List recent transcription requests from Deepgram's request history
+   *
+   * **Important:** Deepgram processes synchronously and doesn't store transcript content.
+   * This method returns request metadata (IDs, timestamps, status) but NOT the actual
+   * transcript text. Use this for auditing, billing analysis, or request tracking.
+   *
+   * Requires `projectId` to be set during initialization.
+   *
+   * @param options - Filtering and pagination options
+   * @param options.limit - Maximum number of requests (default 10, max 1000)
+   * @param options.status - Filter by status: 'succeeded' or 'failed'
+   * @param options.afterDate - Start date (YYYY-MM-DD or ISO 8601)
+   * @param options.beforeDate - End date (YYYY-MM-DD or ISO 8601)
+   * @param options.deepgram - Provider-specific params (page, request_id, etc.)
+   * @returns List of transcription request metadata
+   *
+   * @example List recent transcription requests
+   * ```typescript
+   * const adapter = new DeepgramAdapter()
+   * adapter.initialize({
+   *   apiKey: process.env.DEEPGRAM_API_KEY,
+   *   projectId: process.env.DEEPGRAM_PROJECT_ID
+   * })
+   *
+   * const { transcripts, hasMore } = await adapter.listTranscripts({
+   *   limit: 50,
+   *   status: 'succeeded'
+   * })
+   *
+   * transcripts.forEach(t => {
+   *   console.log(t.data?.id, t.data?.metadata?.createdAt)
+   * })
+   * ```
+   *
+   * @see https://developers.deepgram.com/reference/get-all-requests
+   */
+  async listTranscripts(options) {
+    this.validateConfig();
+    if (!this.projectId) {
+      return {
+        transcripts: [
+          {
+            success: false,
+            provider: this.name,
+            error: {
+              code: "MISSING_PROJECT_ID",
+              message: "Deepgram listTranscripts requires projectId. Initialize with: { apiKey, projectId }"
+            }
+          }
+        ],
+        hasMore: false
+      };
+    }
+    try {
+      const params = {
+        // Filter to only transcription requests (listen endpoint)
+        endpoint: ManageV1FilterEndpointParameter.listen,
+        ...options?.deepgram
+      };
+      if (options?.limit) {
+        params.limit = options.limit;
+      }
+      if (options?.afterDate) {
+        params.start = options.afterDate;
+      }
+      if (options?.beforeDate) {
+        params.end = options.beforeDate;
+      }
+      if (options?.status) {
+        const statusMap = {
+          completed: ManageV1FilterStatusParameter.succeeded,
+          succeeded: ManageV1FilterStatusParameter.succeeded,
+          error: ManageV1FilterStatusParameter.failed,
+          failed: ManageV1FilterStatusParameter.failed
+        };
+        params.status = statusMap[options.status.toLowerCase()];
+      }
+      const response = await this.client.get(
+        `/projects/${this.projectId}/requests`,
+        { params }
+      );
+      const data = response.data;
+      const transcripts = (data.requests || []).map(
+        (item) => this.normalizeRequestItem(item)
+      );
+      return {
+        transcripts,
+        hasMore: (data.page || 1) * (data.limit || 10) < (data.requests?.length || 0)
+      };
+    } catch (error) {
+      return {
+        transcripts: [this.createErrorResponse(error)],
+        hasMore: false
+      };
+    }
+  }
+  /**
+   * Normalize a Deepgram request history item to unified format
+   */
+  normalizeRequestItem(item) {
+    const isSuccess = (item.code || 0) < 400;
+    return {
+      success: isSuccess,
+      provider: this.name,
+      data: {
+        id: item.request_id || "",
+        text: "",
+        // Deepgram doesn't store transcript content in request history
+        status: isSuccess ? "completed" : "error",
+        metadata: {
+          audioFileAvailable: this.capabilities.getAudioFile ?? false,
+          createdAt: item.created,
+          apiPath: item.path,
+          apiKeyId: item.api_key_id,
+          deployment: item.deployment,
+          callbackUrl: item.callback,
+          responseCode: item.code
+        }
+      },
+      error: !isSuccess ? {
+        code: "REQUEST_FAILED",
+        message: `Request failed with status code ${item.code}`
+      } : void 0,
+      raw: item
+    };
+  }
 };
 function createDeepgramAdapter(config) {
   const adapter = new DeepgramAdapter();
@@ -5080,8 +5363,12 @@ var AzureSTTAdapter = class extends BaseAdapter {
         // List items don't include full text
         status,
         language: item.locale,
+        // Note: contentUrls is write-only per Azure API docs (not returned in list response)
+        // Note: duration is not available in Transcription list item
         metadata: {
+          audioFileAvailable: this.capabilities.getAudioFile ?? false,
           displayName: item.displayName,
+          description: item.description || void 0,
           createdAt: item.createdDateTime,
           lastActionAt: item.lastActionDateTime,
           filesUrl: item.links?.files
@@ -5090,7 +5377,8 @@ var AzureSTTAdapter = class extends BaseAdapter {
       error: status === "error" ? {
         code: "TRANSCRIPTION_ERROR",
         message: item.properties?.error?.message || "Transcription failed"
-      } : void 0
+      } : void 0,
+      raw: item
     };
   }
   /**