@ai-sdk/deepgram 3.0.0-beta.3 → 3.0.0-beta.31

package/CHANGELOG.md

@@ -1,5 +1,243 @@
 # @ai-sdk/deepgram
 
+## 3.0.0-beta.31
+
+### Major Changes
+
+- 04e9009: chore: make provider implementations code patterns more consistent, including renaming certain exported symbols
+
+  For all externally exported symbols that were renamed, the old names continue to work via deprecated aliases.
+
+### Patch Changes
+
+- Updated dependencies [08d2129]
+  - @ai-sdk/provider-utils@5.0.0-beta.30
+
+## 3.0.0-beta.30
+
+### Patch Changes
+
+- 258c093: chore: ensure consistent import handling and avoid import duplicates or cycles
+- Updated dependencies [9bd6512]
+- Updated dependencies [258c093]
+- Updated dependencies [b6783da]
+  - @ai-sdk/provider-utils@5.0.0-beta.29
+  - @ai-sdk/provider@4.0.0-beta.14
+
+## 3.0.0-beta.29
+
+### Patch Changes
+
+- 9f0e36c: trigger release for all packages after provenance setup
+- Updated dependencies [9f0e36c]
+  - @ai-sdk/provider@4.0.0-beta.13
+  - @ai-sdk/provider-utils@5.0.0-beta.28
+
+## 3.0.0-beta.28
+
+### Patch Changes
+
+- Updated dependencies [785fe16]
+- Updated dependencies [67df0a0]
+- Updated dependencies [befb78c]
+- Updated dependencies [0458559]
+- Updated dependencies [5852c0a]
+- Updated dependencies [fc92055]
+  - @ai-sdk/provider-utils@5.0.0-beta.27
+
+## 3.0.0-beta.27
+
+### Patch Changes
+
+- Updated dependencies [2e98477]
+  - @ai-sdk/provider-utils@5.0.0-beta.26
+
+## 3.0.0-beta.26
+
+### Patch Changes
+
+- Updated dependencies [eea8d98]
+  - @ai-sdk/provider-utils@5.0.0-beta.25
+
+## 3.0.0-beta.25
+
+### Patch Changes
+
+- Updated dependencies [f807e45]
+  - @ai-sdk/provider-utils@5.0.0-beta.24
+
+## 3.0.0-beta.24
+
+### Patch Changes
+
+- Updated dependencies [350ea38]
+  - @ai-sdk/provider-utils@5.0.0-beta.23
+
+## 3.0.0-beta.23
+
+### Patch Changes
+
+- Updated dependencies [083947b]
+  - @ai-sdk/provider-utils@5.0.0-beta.22
+
+## 3.0.0-beta.22
+
+### Patch Changes
+
+- Updated dependencies [add1126]
+  - @ai-sdk/provider-utils@5.0.0-beta.21
+
+## 3.0.0-beta.21
+
+### Patch Changes
+
+- b3976a2: Add workflow serialization support to all provider models.
+
+  **`@ai-sdk/provider-utils`:** New `serializeModel()` helper that extracts only serializable properties from a model instance, filtering out functions and objects containing functions. Third-party provider authors can use this to add workflow support to their own models.
+
+  **All providers:** `headers` is now optional in provider config types. This is non-breaking — existing code that passes `headers` continues to work. Custom provider implementations that construct model configs manually can now omit `headers`, which is useful when models are deserialized from a workflow step boundary where auth is provided separately.
+
+  All provider model classes now include `WORKFLOW_SERIALIZE` and `WORKFLOW_DESERIALIZE` static methods, enabling them to cross workflow step boundaries without serialization errors.
+
+- Updated dependencies [b3976a2]
+- Updated dependencies [ff5eba1]
+  - @ai-sdk/provider-utils@5.0.0-beta.20
+  - @ai-sdk/provider@4.0.0-beta.12
+
+## 3.0.0-beta.20
+
+### Major Changes
+
+- ef992f8: Remove CommonJS exports from all packages. All packages are now ESM-only (`"type": "module"`). Consumers using `require()` must switch to ESM `import` syntax.
+
+### Patch Changes
+
+- Updated dependencies [ef992f8]
+  - @ai-sdk/provider@4.0.0-beta.11
+  - @ai-sdk/provider-utils@5.0.0-beta.19
+
+## 3.0.0-beta.19
+
+### Patch Changes
+
+- Updated dependencies [90e2d8a]
+  - @ai-sdk/provider-utils@5.0.0-beta.18
+
+## 3.0.0-beta.18
+
+### Patch Changes
+
+- Updated dependencies [3ae1786]
+  - @ai-sdk/provider-utils@5.0.0-beta.17
+
+## 3.0.0-beta.17
+
+### Patch Changes
+
+- Updated dependencies [176466a]
+  - @ai-sdk/provider@4.0.0-beta.10
+  - @ai-sdk/provider-utils@5.0.0-beta.16
+
+## 3.0.0-beta.16
+
+### Patch Changes
+
+- Updated dependencies [e311194]
+  - @ai-sdk/provider@4.0.0-beta.9
+  - @ai-sdk/provider-utils@5.0.0-beta.15
+
+## 3.0.0-beta.15
+
+### Patch Changes
+
+- Updated dependencies [34bd95d]
+- Updated dependencies [008271d]
+  - @ai-sdk/provider@4.0.0-beta.8
+  - @ai-sdk/provider-utils@5.0.0-beta.14
+
+## 3.0.0-beta.14
+
+### Patch Changes
+
+- Updated dependencies [b0c2869]
+- Updated dependencies [7e26e81]
+  - @ai-sdk/provider-utils@5.0.0-beta.13
+
+## 3.0.0-beta.13
+
+### Patch Changes
+
+- Updated dependencies [46d1149]
+  - @ai-sdk/provider-utils@5.0.0-beta.12
+
+## 3.0.0-beta.12
+
+### Patch Changes
+
+- Updated dependencies [6fd51c0]
+  - @ai-sdk/provider-utils@5.0.0-beta.11
+  - @ai-sdk/provider@4.0.0-beta.7
+
+## 3.0.0-beta.11
+
+### Patch Changes
+
+- Updated dependencies [c29a26f]
+  - @ai-sdk/provider-utils@5.0.0-beta.10
+  - @ai-sdk/provider@4.0.0-beta.6
+
+## 3.0.0-beta.10
+
+### Patch Changes
+
+- 38fc777: Add AI Gateway hint to provider READMEs
+
+## 3.0.0-beta.9
+
+### Patch Changes
+
+- Updated dependencies [2e17091]
+  - @ai-sdk/provider-utils@5.0.0-beta.9
+
+## 3.0.0-beta.8
+
+### Patch Changes
+
+- Updated dependencies [986c6fd]
+- Updated dependencies [493295c]
+  - @ai-sdk/provider-utils@5.0.0-beta.8
+
+## 3.0.0-beta.7
+
+### Patch Changes
+
+- Updated dependencies [1f509d4]
+  - @ai-sdk/provider-utils@5.0.0-beta.7
+  - @ai-sdk/provider@4.0.0-beta.5
+
+## 3.0.0-beta.6
+
+### Patch Changes
+
+- Updated dependencies [3887c70]
+  - @ai-sdk/provider-utils@5.0.0-beta.6
+  - @ai-sdk/provider@4.0.0-beta.4
+
+## 3.0.0-beta.5
+
+### Patch Changes
+
+- Updated dependencies [776b617]
+  - @ai-sdk/provider-utils@5.0.0-beta.5
+  - @ai-sdk/provider@4.0.0-beta.3
+
+## 3.0.0-beta.4
+
+### Patch Changes
+
+- Updated dependencies [61753c3]
+  - @ai-sdk/provider-utils@5.0.0-beta.4
+
 ## 3.0.0-beta.3
 
 ### Patch Changes
@@ -226,13 +464,13 @@
   Before
 
   ```ts
-  model.textEmbeddingModel('my-model-id');
+  model.textEmbeddingModel("my-model-id");
   ```
 
   After
 
   ```ts
-  model.embeddingModel('my-model-id');
+  model.embeddingModel("my-model-id");
   ```
 
 - 7f91f36: feat(deepgram): add language detection support
@@ -448,13 +686,13 @@
   Before
 
   ```ts
-  model.textEmbeddingModel('my-model-id');
+  model.textEmbeddingModel("my-model-id");
   ```
 
   After
 
   ```ts
-  model.embeddingModel('my-model-id');
+  model.embeddingModel("my-model-id");
   ```
 
 - Updated dependencies [8d9e8ad]

package/README.md

@@ -3,6 +3,8 @@
 The **[Deepgram provider](https://ai-sdk.dev/providers/ai-sdk-providers/deepgram)** for the [AI SDK](https://ai-sdk.dev/docs)
 contains transcription model support for the Deepgram transcription API and speech model support for the Deepgram text-to-speech API.
 
+> **Deploying to Vercel?** With Vercel's AI Gateway you can access Deepgram (and hundreds of models from other providers) — no additional packages, API keys, or extra cost. [Get started with AI Gateway](https://vercel.com/ai-gateway).
+
 ## Setup
 
 The Deepgram provider is available in the `@ai-sdk/deepgram` module. You can install it with

package/dist/index.d.ts

@@ -1,5 +1,6 @@
-import { TranscriptionModelV3, ProviderV3, SpeechModelV3 } from '@ai-sdk/provider';
-import { FetchFunction } from '@ai-sdk/provider-utils';
+import * as _ai_sdk_provider from '@ai-sdk/provider';
+import { TranscriptionModelV4, ProviderV4, SpeechModelV4 } from '@ai-sdk/provider';
+import { FetchFunction, WORKFLOW_SERIALIZE, WORKFLOW_DESERIALIZE } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
 
 type DeepgramConfig = {
@@ -8,63 +9,50 @@ type DeepgramConfig = {
         modelId: string;
         path: string;
     }) => string;
-    headers: () => Record<string, string | undefined>;
+    headers?: () => Record<string, string | undefined>;
     fetch?: FetchFunction;
     generateId?: () => string;
 };
 
 type DeepgramTranscriptionModelId = 'base' | 'base-general' | 'base-meeting' | 'base-phonecall' | 'base-finance' | 'base-conversationalai' | 'base-voicemail' | 'base-video' | 'enhanced' | 'enhanced-general' | 'enhanced-meeting' | 'enhanced-phonecall' | 'enhanced-finance' | 'nova' | 'nova-general' | 'nova-phonecall' | 'nova-medical' | 'nova-2' | 'nova-2-general' | 'nova-2-meeting' | 'nova-2-phonecall' | 'nova-2-finance' | 'nova-2-conversationalai' | 'nova-2-voicemail' | 'nova-2-video' | 'nova-2-medical' | 'nova-2-drivethru' | 'nova-2-automotive' | 'nova-2-atc' | 'nova-3' | 'nova-3-general' | 'nova-3-medical' | (string & {});
 
-declare const deepgramTranscriptionModelOptionsSchema: z.ZodObject<{
-    language: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    detectLanguage: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
-    smartFormat: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
-    punctuate: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
-    paragraphs: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
-    summarize: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodLiteral<"v2">, z.ZodLiteral<false>]>>>;
-    topics: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
-    intents: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
-    sentiment: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
-    detectEntities: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
-    redact: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>;
-    replace: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    search: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    keyterm: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    diarize: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
-    utterances: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
-    uttSplit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    fillerWords: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
-}, z.core.$strip>;
-type DeepgramTranscriptionModelOptions = z.infer<typeof deepgramTranscriptionModelOptionsSchema>;
 interface DeepgramTranscriptionModelConfig extends DeepgramConfig {
     _internal?: {
         currentDate?: () => Date;
     };
 }
-declare class DeepgramTranscriptionModel implements TranscriptionModelV3 {
+declare class DeepgramTranscriptionModel implements TranscriptionModelV4 {
     readonly modelId: DeepgramTranscriptionModelId;
     private readonly config;
-    readonly specificationVersion = "v3";
+    readonly specificationVersion = "v4";
     get provider(): string;
+    static [WORKFLOW_SERIALIZE](model: DeepgramTranscriptionModel): {
+        modelId: string;
+        config: _ai_sdk_provider.JSONObject;
+    };
+    static [WORKFLOW_DESERIALIZE](options: {
+        modelId: DeepgramTranscriptionModelId;
+        config: DeepgramTranscriptionModelConfig;
+    }): DeepgramTranscriptionModel;
     constructor(modelId: DeepgramTranscriptionModelId, config: DeepgramTranscriptionModelConfig);
     private getArgs;
-    doGenerate(options: Parameters<TranscriptionModelV3['doGenerate']>[0]): Promise<Awaited<ReturnType<TranscriptionModelV3['doGenerate']>>>;
+    doGenerate(options: Parameters<TranscriptionModelV4['doGenerate']>[0]): Promise<Awaited<ReturnType<TranscriptionModelV4['doGenerate']>>>;
 }
 
 type DeepgramSpeechModelId = 'aura-asteria-en' | 'aura-2-asteria-en' | 'aura-2-thalia-en' | 'aura-2-helena-en' | 'aura-2-orpheus-en' | 'aura-2-zeus-en' | 'aura-luna-en' | 'aura-stella-en' | (string & {});
 
-interface DeepgramProvider extends ProviderV3 {
+interface DeepgramProvider extends ProviderV4 {
     (modelId: 'nova-3', settings?: {}): {
         transcription: DeepgramTranscriptionModel;
     };
     /**
      * Creates a model for transcription.
      */
-    transcription(modelId: DeepgramTranscriptionModelId): TranscriptionModelV3;
+    transcription(modelId: DeepgramTranscriptionModelId): TranscriptionModelV4;
     /**
      * Creates a model for speech generation.
      */
-    speech(modelId: DeepgramSpeechModelId): SpeechModelV3;
+    speech(modelId: DeepgramSpeechModelId): SpeechModelV4;
     /**
      * @deprecated Use `embeddingModel` instead.
      */
@@ -94,6 +82,29 @@ declare function createDeepgram(options?: DeepgramProviderSettings): DeepgramPro
  */
 declare const deepgram: DeepgramProvider;
 
+interface DeepgramSpeechModelConfig extends DeepgramConfig {
+    _internal?: {
+        currentDate?: () => Date;
+    };
+}
+declare class DeepgramSpeechModel implements SpeechModelV4 {
+    readonly modelId: DeepgramSpeechModelId;
+    private readonly config;
+    readonly specificationVersion = "v4";
+    get provider(): string;
+    static [WORKFLOW_SERIALIZE](model: DeepgramSpeechModel): {
+        modelId: string;
+        config: _ai_sdk_provider.JSONObject;
+    };
+    static [WORKFLOW_DESERIALIZE](options: {
+        modelId: DeepgramSpeechModelId;
+        config: DeepgramSpeechModelConfig;
+    }): DeepgramSpeechModel;
+    constructor(modelId: DeepgramSpeechModelId, config: DeepgramSpeechModelConfig);
+    private getArgs;
+    doGenerate(options: Parameters<SpeechModelV4['doGenerate']>[0]): Promise<Awaited<ReturnType<SpeechModelV4['doGenerate']>>>;
+}
+
 declare const deepgramSpeechModelOptionsSchema: z.ZodObject<{
     bitRate: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
     container: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -108,20 +119,28 @@ declare const deepgramSpeechModelOptionsSchema: z.ZodObject<{
     tag: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>;
 }, z.core.$strip>;
 type DeepgramSpeechModelOptions = z.infer<typeof deepgramSpeechModelOptionsSchema>;
-interface DeepgramSpeechModelConfig extends DeepgramConfig {
-    _internal?: {
-        currentDate?: () => Date;
-    };
-}
-declare class DeepgramSpeechModel implements SpeechModelV3 {
-    readonly modelId: DeepgramSpeechModelId;
-    private readonly config;
-    readonly specificationVersion = "v3";
-    get provider(): string;
-    constructor(modelId: DeepgramSpeechModelId, config: DeepgramSpeechModelConfig);
-    private getArgs;
-    doGenerate(options: Parameters<SpeechModelV3['doGenerate']>[0]): Promise<Awaited<ReturnType<SpeechModelV3['doGenerate']>>>;
-}
+
+declare const deepgramTranscriptionModelOptionsSchema: z.ZodObject<{
+    language: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    detectLanguage: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    smartFormat: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    punctuate: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    paragraphs: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    summarize: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodLiteral<"v2">, z.ZodLiteral<false>]>>>;
+    topics: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    intents: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    sentiment: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    detectEntities: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    redact: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>;
+    replace: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    search: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    keyterm: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    diarize: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    utterances: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    uttSplit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    fillerWords: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+}, z.core.$strip>;
+type DeepgramTranscriptionModelOptions = z.infer<typeof deepgramTranscriptionModelOptionsSchema>;
 
 declare const VERSION: string;