@ai-sdk/deepgram 3.0.0-beta.5 → 3.0.0-beta.51

package/CHANGELOG.md

@@ -1,5 +1,383 @@
 # @ai-sdk/deepgram
 
+## 3.0.0-beta.51
+
+### Patch Changes
+
+- Updated dependencies [0416e3e]
+  - @ai-sdk/provider@4.0.0-beta.20
+  - @ai-sdk/provider-utils@5.0.0-beta.50
+
+## 3.0.0-beta.50
+
+### Patch Changes
+
+- b8396f0: trigger initial beta release
+- Updated dependencies [b8396f0]
+  - @ai-sdk/provider-utils@5.0.0-beta.49
+  - @ai-sdk/provider@4.0.0-beta.19
+
+## 3.0.0-canary.49
+
+### Patch Changes
+
+- Updated dependencies [aeda373]
+- Updated dependencies [375fdd7]
+- Updated dependencies [b4507d5]
+  - @ai-sdk/provider-utils@5.0.0-canary.48
+
+## 3.0.0-canary.48
+
+### Patch Changes
+
+- Updated dependencies [bae5e2b]
+  - @ai-sdk/provider-utils@5.0.0-canary.47
+
+## 3.0.0-canary.47
+
+### Patch Changes
+
+- Updated dependencies [ce769dd]
+  - @ai-sdk/provider@4.0.0-canary.18
+  - @ai-sdk/provider-utils@5.0.0-canary.46
+
+## 3.0.0-canary.46
+
+### Patch Changes
+
+- Updated dependencies [ee798eb]
+- Updated dependencies [daf6637]
+  - @ai-sdk/provider-utils@5.0.0-canary.45
+
+## 3.0.0-canary.45
+
+### Patch Changes
+
+- Updated dependencies [6c93e36]
+- Updated dependencies [f617ac2]
+  - @ai-sdk/provider-utils@5.0.0-canary.44
+
+## 3.0.0-canary.44
+
+### Patch Changes
+
+- 7fc6bd6: Raise minimum supported Node.js version to 22. Supported versions: 22, 24, and 26.
+- Updated dependencies [7fc6bd6]
+  - @ai-sdk/provider-utils@5.0.0-canary.43
+  - @ai-sdk/provider@4.0.0-canary.17
+
+## 3.0.0-canary.43
+
+### Patch Changes
+
+- Updated dependencies [a6617c5]
+  - @ai-sdk/provider-utils@5.0.0-canary.42
+
+## 3.0.0-canary.42
+
+### Patch Changes
+
+- Updated dependencies [28dfa06]
+- Updated dependencies [e93fa91]
+  - @ai-sdk/provider-utils@5.0.0-canary.41
+
+## 3.0.0-canary.41
+
+### Patch Changes
+
+- Updated dependencies [a7de9c9]
+  - @ai-sdk/provider-utils@5.0.0-canary.40
+
+## 3.0.0-canary.40
+
+### Patch Changes
+
+- Updated dependencies [105f95b]
+  - @ai-sdk/provider-utils@5.0.0-canary.39
+
+## 3.0.0-canary.39
+
+### Patch Changes
+
+- Updated dependencies [ca446f8]
+  - @ai-sdk/provider-utils@5.0.0-canary.38
+
+## 3.0.0-canary.38
+
+### Patch Changes
+
+- Updated dependencies [d848405]
+  - @ai-sdk/provider-utils@5.0.0-canary.37
+
+## 3.0.0-canary.37
+
+### Patch Changes
+
+- Updated dependencies [ca39020]
+  - @ai-sdk/provider-utils@5.0.0-canary.36
+
+## 3.0.0-canary.36
+
+### Patch Changes
+
+- Updated dependencies [f634bac]
+  - @ai-sdk/provider-utils@5.0.0-canary.35
+
+## 3.0.0-canary.35
+
+### Patch Changes
+
+- Updated dependencies [69254e0]
+- Updated dependencies [3015fc3]
+  - @ai-sdk/provider-utils@5.0.0-canary.34
+
+## 3.0.0-canary.34
+
+### Patch Changes
+
+- Updated dependencies [2427d88]
+  - @ai-sdk/provider-utils@5.0.0-canary.33
+
+## 3.0.0-canary.33
+
+### Patch Changes
+
+- Updated dependencies [5463d0d]
+  - @ai-sdk/provider-utils@5.0.0-canary.32
+  - @ai-sdk/provider@4.0.0-canary.16
+
+## 3.0.0-canary.32
+
+### Patch Changes
+
+- 0c4c275: trigger initial canary release
+- Updated dependencies [0c4c275]
+  - @ai-sdk/provider-utils@5.0.0-canary.31
+  - @ai-sdk/provider@4.0.0-canary.15
+
+## 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
@@ -241,13 +619,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
@@ -463,13 +841,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
@@ -33,7 +35,7 @@ import { deepgram } from '@ai-sdk/deepgram';
 
 ```ts
 import { deepgram } from '@ai-sdk/deepgram';
-import { experimental_transcribe as transcribe } from 'ai';
+import { transcribe } from 'ai';
 
 const { text } = await transcribe({
   model: deepgram.transcription('nova-3'),
@@ -47,7 +49,7 @@ const { text } = await transcribe({
 
 ```ts
 import { deepgram } from '@ai-sdk/deepgram';
-import { experimental_transcribe as transcribe } from 'ai';
+import { transcribe } from 'ai';
 
 const { text, language } = await transcribe({
   model: deepgram.transcription('nova-3'),
@@ -66,7 +68,7 @@ const { text, language } = await transcribe({
 
 ```ts
 import { deepgram } from '@ai-sdk/deepgram';
-import { experimental_generateSpeech as generateSpeech } from 'ai';
+import { generateSpeech } from 'ai';
 
 const { audio } = await generateSpeech({
   model: deepgram.speech('aura-2-helena-en'),

package/dist/index.d.ts

@@ -1,5 +1,6 @@
+import * as _ai_sdk_provider from '@ai-sdk/provider';
 import { TranscriptionModelV4, ProviderV4, SpeechModelV4 } from '@ai-sdk/provider';
-import { FetchFunction } from '@ai-sdk/provider-utils';
+import { FetchFunction, WORKFLOW_SERIALIZE, WORKFLOW_DESERIALIZE } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
 
 type DeepgramConfig = {
@@ -8,34 +9,13 @@ 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;
@@ -46,6 +26,14 @@ declare class DeepgramTranscriptionModel implements TranscriptionModelV4 {
     private readonly config;
     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<TranscriptionModelV4['doGenerate']>[0]): Promise<Awaited<ReturnType<TranscriptionModelV4['doGenerate']>>>;
@@ -94,20 +82,6 @@ declare function createDeepgram(options?: DeepgramProviderSettings): DeepgramPro
  */
 declare const deepgram: DeepgramProvider;
 
-declare const deepgramSpeechModelOptionsSchema: z.ZodObject<{
-    bitRate: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
-    container: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    encoding: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    sampleRate: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    callback: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    callbackMethod: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-        POST: "POST";
-        PUT: "PUT";
-    }>>>;
-    mipOptOut: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
-    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;
@@ -118,11 +92,56 @@ declare class DeepgramSpeechModel implements SpeechModelV4 {
     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>>;
+    encoding: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    sampleRate: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    callback: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    callbackMethod: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        POST: "POST";
+        PUT: "PUT";
+    }>>>;
+    mipOptOut: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    tag: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>;
+}, z.core.$strip>;
+type DeepgramSpeechModelOptions = z.infer<typeof deepgramSpeechModelOptionsSchema>;
+
+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;
 
 export { type DeepgramProvider, type DeepgramProviderSettings, type DeepgramSpeechModelOptions as DeepgramSpeechCallOptions, DeepgramSpeechModel, type DeepgramSpeechModelId, type DeepgramSpeechModelOptions, type DeepgramTranscriptionModelOptions, VERSION, createDeepgram, deepgram };