@ai-sdk/lmnt 3.0.0-beta.20 → 3.0.0-beta.21

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @ai-sdk/lmnt
 
+## 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

package/dist/index.d.ts

@@ -1,5 +1,6 @@
+import * as _ai_sdk_provider from '@ai-sdk/provider';
 import { SpeechModelV4, ProviderV4 } 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 LMNTConfig = {
@@ -8,7 +9,7 @@ type LMNTConfig = {
         modelId: string;
         path: string;
     }) => string;
-    headers: () => Record<string, string | undefined>;
+    headers?: () => Record<string, string | undefined>;
     fetch?: FetchFunction;
     generateId?: () => string;
 };
@@ -46,6 +47,14 @@ declare class LMNTSpeechModel implements SpeechModelV4 {
     private readonly config;
     readonly specificationVersion = "v4";
     get provider(): string;
+    static [WORKFLOW_SERIALIZE](model: LMNTSpeechModel): {
+        modelId: string;
+        config: _ai_sdk_provider.JSONObject;
+    };
+    static [WORKFLOW_DESERIALIZE](options: {
+        modelId: LMNTSpeechModelId;
+        config: LMNTSpeechModelConfig;
+    }): LMNTSpeechModel;
     constructor(modelId: LMNTSpeechModelId, config: LMNTSpeechModelConfig);
     private getArgs;
     doGenerate(options: Parameters<SpeechModelV4['doGenerate']>[0]): Promise<Awaited<ReturnType<SpeechModelV4['doGenerate']>>>;

package/dist/index.js

@@ -9,7 +9,10 @@ import {
   combineHeaders,
   createBinaryResponseHandler,
   parseProviderOptions,
-  postJsonToApi
+  postJsonToApi,
+  serializeModelOptions,
+  WORKFLOW_SERIALIZE,
+  WORKFLOW_DESERIALIZE
 } from "@ai-sdk/provider-utils";
 import { z as z2 } from "zod/v4";
 
@@ -73,7 +76,7 @@ var lmntSpeechModelOptionsSchema = z2.object({
    */
   temperature: z2.number().min(0).nullish().default(1)
 });
-var LMNTSpeechModel = class {
+var LMNTSpeechModel = class _LMNTSpeechModel {
   constructor(modelId, config) {
     this.modelId = modelId;
     this.config = config;
@@ -82,6 +85,15 @@ var LMNTSpeechModel = class {
   get provider() {
     return this.config.provider;
   }
+  static [WORKFLOW_SERIALIZE](model) {
+    return serializeModelOptions({
+      modelId: model.modelId,
+      config: model.config
+    });
+  }
+  static [WORKFLOW_DESERIALIZE](options) {
+    return new _LMNTSpeechModel(options.modelId, options.config);
+  }
   async getArgs({
     text,
     voice = "ava",
@@ -141,7 +153,7 @@ var LMNTSpeechModel = class {
     };
   }
   async doGenerate(options) {
-    var _a, _b, _c;
+    var _a, _b, _c, _d, _e;
     const currentDate = (_c = (_b = (_a = this.config._internal) == null ? void 0 : _a.currentDate) == null ? void 0 : _b.call(_a)) != null ? _c : /* @__PURE__ */ new Date();
     const { requestBody, warnings } = await this.getArgs(options);
     const {
@@ -153,7 +165,7 @@ var LMNTSpeechModel = class {
         path: "/v1/ai/speech/bytes",
         modelId: this.modelId
       }),
-      headers: combineHeaders(this.config.headers(), options.headers),
+      headers: combineHeaders((_e = (_d = this.config).headers) == null ? void 0 : _e.call(_d), options.headers),
       body: requestBody,
       failedResponseHandler: lmntFailedResponseHandler,
       successfulResponseHandler: createBinaryResponseHandler(),
@@ -177,7 +189,7 @@ var LMNTSpeechModel = class {
 };
 
 // src/version.ts
-var VERSION = true ? "3.0.0-beta.20" : "0.0.0-test";
+var VERSION = true ? "3.0.0-beta.21" : "0.0.0-test";
 
 // src/lmnt-provider.ts
 function createLMNT(options = {}) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/lmnt-provider.ts","../src/lmnt-speech-model.ts","../src/lmnt-error.ts","../src/version.ts"],"sourcesContent":["import { SpeechModelV4, ProviderV4 } from '@ai-sdk/provider';\nimport {\n  FetchFunction,\n  loadApiKey,\n  withUserAgentSuffix,\n} from '@ai-sdk/provider-utils';\nimport { LMNTSpeechModel } from './lmnt-speech-model';\nimport { LMNTSpeechModelId } from './lmnt-speech-options';\nimport { VERSION } from './version';\n\nexport interface LMNTProvider extends Pick<ProviderV4, 'speechModel'> {\n  (\n    modelId: 'aurora',\n    settings?: {},\n  ): {\n    speech: LMNTSpeechModel;\n  };\n\n  /**\n   * Creates a model for speech synthesis.\n   */\n  speech(modelId: LMNTSpeechModelId): SpeechModelV4;\n}\n\nexport interface LMNTProviderSettings {\n  /**\n   * API key for authenticating requests.\n   */\n  apiKey?: string;\n\n  /**\n   * Custom headers to include in the requests.\n   */\n  headers?: Record<string, string>;\n\n  /**\n   * Custom fetch implementation. You can use it as a middleware to intercept requests,\n   * or to provide a custom fetch implementation for e.g. testing.\n   */\n  fetch?: FetchFunction;\n}\n\n/**\n * Create an LMNT provider instance.\n */\nexport function createLMNT(options: LMNTProviderSettings = {}): LMNTProvider {\n  const getHeaders = () =>\n    withUserAgentSuffix(\n      {\n        'x-api-key': loadApiKey({\n          apiKey: options.apiKey,\n          environmentVariableName: 'LMNT_API_KEY',\n          description: 'LMNT',\n        }),\n        ...options.headers,\n      },\n      `ai-sdk/lmnt/${VERSION}`,\n    );\n\n  const createSpeechModel = (modelId: LMNTSpeechModelId) =>\n    new LMNTSpeechModel(modelId, {\n      provider: `lmnt.speech`,\n      url: ({ path }) => `https://api.lmnt.com${path}`,\n      headers: getHeaders,\n      fetch: options.fetch,\n    });\n\n  const provider = function (modelId: LMNTSpeechModelId) {\n    return {\n      speech: createSpeechModel(modelId),\n    };\n  };\n\n  provider.speech = createSpeechModel;\n  provider.speechModel = createSpeechModel;\n\n  return provider as LMNTProvider;\n}\n\n/**\n * Default LMNT provider instance.\n */\nexport const lmnt = createLMNT();\n","import { SpeechModelV4, SharedV4Warning } from '@ai-sdk/provider';\nimport {\n  combineHeaders,\n  createBinaryResponseHandler,\n  parseProviderOptions,\n  postJsonToApi,\n} from '@ai-sdk/provider-utils';\nimport { z } from 'zod/v4';\nimport { LMNTConfig } from './lmnt-config';\nimport { lmntFailedResponseHandler } from './lmnt-error';\nimport { LMNTSpeechModelId } from './lmnt-speech-options';\nimport { LMNTSpeechAPITypes } from './lmnt-api-types';\n\n// https://docs.lmnt.com/api-reference/speech/synthesize-speech-bytes\nconst lmntSpeechModelOptionsSchema = z.object({\n  /**\n   * The model to use for speech synthesis e.g. 'aurora' or 'blizzard'.\n   * @default 'aurora'\n   */\n  model: z\n    .union([z.enum(['aurora', 'blizzard']), z.string()])\n    .nullish()\n    .default('aurora'),\n\n  /**\n   * The audio format of the output.\n   * @default 'mp3'\n   */\n  format: z\n    .enum(['aac', 'mp3', 'mulaw', 'raw', 'wav'])\n    .nullish()\n    .default('mp3'),\n\n  /**\n   * The sample rate of the output audio in Hz.\n   * @default 24000\n   */\n  sampleRate: z\n    .union([z.literal(8000), z.literal(16000), z.literal(24000)])\n    .nullish()\n    .default(24000),\n\n  /**\n   * The speed of the speech. Range: 0.25 to 2.\n   * @default 1\n   */\n  speed: z.number().min(0.25).max(2).nullish().default(1),\n\n  /**\n   * A seed value for deterministic generation.\n   */\n  seed: z.number().int().nullish(),\n\n  /**\n   * Whether to use a conversational style.\n   * @default false\n   */\n  conversational: z.boolean().nullish().default(false),\n\n  /**\n   * Maximum length of the output in seconds (up to 300).\n   */\n  length: z.number().max(300).nullish(),\n\n  /**\n   * Top-p sampling parameter. Range: 0 to 1.\n   * @default 1\n   */\n  topP: z.number().min(0).max(1).nullish().default(1),\n\n  /**\n   * Temperature for sampling. Higher values increase randomness.\n   * @default 1\n   */\n  temperature: z.number().min(0).nullish().default(1),\n});\n\nexport type LMNTSpeechModelOptions = z.infer<\n  typeof lmntSpeechModelOptionsSchema\n>;\n\ninterface LMNTSpeechModelConfig extends LMNTConfig {\n  _internal?: {\n    currentDate?: () => Date;\n  };\n}\n\nexport class LMNTSpeechModel implements SpeechModelV4 {\n  readonly specificationVersion = 'v4';\n\n  get provider(): string {\n    return this.config.provider;\n  }\n\n  constructor(\n    readonly modelId: LMNTSpeechModelId,\n    private readonly config: LMNTSpeechModelConfig,\n  ) {}\n\n  private async getArgs({\n    text,\n    voice = 'ava',\n    outputFormat = 'mp3',\n    speed,\n    language,\n    providerOptions,\n  }: Parameters<SpeechModelV4['doGenerate']>[0]) {\n    const warnings: SharedV4Warning[] = [];\n\n    // Parse provider options\n    const lmntOptions = await parseProviderOptions({\n      provider: 'lmnt',\n      providerOptions,\n      schema: lmntSpeechModelOptionsSchema,\n    });\n\n    // Create request body\n    const requestBody: Record<string, unknown> = {\n      model: this.modelId,\n      text,\n      voice,\n      response_format: 'mp3',\n      speed,\n    };\n\n    if (outputFormat) {\n      if (['mp3', 'aac', 'mulaw', 'raw', 'wav'].includes(outputFormat)) {\n        requestBody.response_format = outputFormat;\n      } else {\n        warnings.push({\n          type: 'unsupported',\n          feature: 'outputFormat',\n          details: `Unsupported output format: ${outputFormat}. Using mp3 instead.`,\n        });\n      }\n    }\n\n    // Add provider-specific options\n    if (lmntOptions) {\n      const speechModelOptions: Omit<LMNTSpeechAPITypes, 'voice' | 'text'> = {\n        conversational: lmntOptions.conversational ?? undefined,\n        length: lmntOptions.length ?? undefined,\n        seed: lmntOptions.seed ?? undefined,\n        speed: lmntOptions.speed ?? undefined,\n        temperature: lmntOptions.temperature ?? undefined,\n        top_p: lmntOptions.topP ?? undefined,\n        sample_rate: lmntOptions.sampleRate ?? undefined,\n      };\n\n      for (const key in speechModelOptions) {\n        const value =\n          speechModelOptions[\n            key as keyof Omit<LMNTSpeechAPITypes, 'voice' | 'text'>\n          ];\n        if (value !== undefined) {\n          requestBody[key] = value;\n        }\n      }\n    }\n\n    if (language) {\n      requestBody.language = language;\n    }\n\n    return {\n      requestBody,\n      warnings,\n    };\n  }\n\n  async doGenerate(\n    options: Parameters<SpeechModelV4['doGenerate']>[0],\n  ): Promise<Awaited<ReturnType<SpeechModelV4['doGenerate']>>> {\n    const currentDate = this.config._internal?.currentDate?.() ?? new Date();\n    const { requestBody, warnings } = await this.getArgs(options);\n\n    const {\n      value: audio,\n      responseHeaders,\n      rawValue: rawResponse,\n    } = await postJsonToApi({\n      url: this.config.url({\n        path: '/v1/ai/speech/bytes',\n        modelId: this.modelId,\n      }),\n      headers: combineHeaders(this.config.headers(), options.headers),\n      body: requestBody,\n      failedResponseHandler: lmntFailedResponseHandler,\n      successfulResponseHandler: createBinaryResponseHandler(),\n      abortSignal: options.abortSignal,\n      fetch: this.config.fetch,\n    });\n\n    return {\n      audio,\n      warnings,\n      request: {\n        body: JSON.stringify(requestBody),\n      },\n      response: {\n        timestamp: currentDate,\n        modelId: this.modelId,\n        headers: responseHeaders,\n        body: rawResponse,\n      },\n    };\n  }\n}\n","import { z } from 'zod/v4';\nimport { createJsonErrorResponseHandler } from '@ai-sdk/provider-utils';\n\nexport const lmntErrorDataSchema = z.object({\n  error: z.object({\n    message: z.string(),\n    code: z.number(),\n  }),\n});\n\nexport type LMNTErrorData = z.infer<typeof lmntErrorDataSchema>;\n\nexport const lmntFailedResponseHandler = createJsonErrorResponseHandler({\n  errorSchema: lmntErrorDataSchema,\n  errorToMessage: data => data.error.message,\n});\n","// Version string of this package injected at build time.\ndeclare const __PACKAGE_VERSION__: string | undefined;\nexport const VERSION: string =\n  typeof __PACKAGE_VERSION__ !== 'undefined'\n    ? __PACKAGE_VERSION__\n    : '0.0.0-test';\n"],"mappings":"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","names":["z","z"]}
+{"version":3,"sources":["../src/lmnt-provider.ts","../src/lmnt-speech-model.ts","../src/lmnt-error.ts","../src/version.ts"],"sourcesContent":["import { SpeechModelV4, ProviderV4 } from '@ai-sdk/provider';\nimport {\n  FetchFunction,\n  loadApiKey,\n  withUserAgentSuffix,\n} from '@ai-sdk/provider-utils';\nimport { LMNTSpeechModel } from './lmnt-speech-model';\nimport { LMNTSpeechModelId } from './lmnt-speech-options';\nimport { VERSION } from './version';\n\nexport interface LMNTProvider extends Pick<ProviderV4, 'speechModel'> {\n  (\n    modelId: 'aurora',\n    settings?: {},\n  ): {\n    speech: LMNTSpeechModel;\n  };\n\n  /**\n   * Creates a model for speech synthesis.\n   */\n  speech(modelId: LMNTSpeechModelId): SpeechModelV4;\n}\n\nexport interface LMNTProviderSettings {\n  /**\n   * API key for authenticating requests.\n   */\n  apiKey?: string;\n\n  /**\n   * Custom headers to include in the requests.\n   */\n  headers?: Record<string, string>;\n\n  /**\n   * Custom fetch implementation. You can use it as a middleware to intercept requests,\n   * or to provide a custom fetch implementation for e.g. testing.\n   */\n  fetch?: FetchFunction;\n}\n\n/**\n * Create an LMNT provider instance.\n */\nexport function createLMNT(options: LMNTProviderSettings = {}): LMNTProvider {\n  const getHeaders = () =>\n    withUserAgentSuffix(\n      {\n        'x-api-key': loadApiKey({\n          apiKey: options.apiKey,\n          environmentVariableName: 'LMNT_API_KEY',\n          description: 'LMNT',\n        }),\n        ...options.headers,\n      },\n      `ai-sdk/lmnt/${VERSION}`,\n    );\n\n  const createSpeechModel = (modelId: LMNTSpeechModelId) =>\n    new LMNTSpeechModel(modelId, {\n      provider: `lmnt.speech`,\n      url: ({ path }) => `https://api.lmnt.com${path}`,\n      headers: getHeaders,\n      fetch: options.fetch,\n    });\n\n  const provider = function (modelId: LMNTSpeechModelId) {\n    return {\n      speech: createSpeechModel(modelId),\n    };\n  };\n\n  provider.speech = createSpeechModel;\n  provider.speechModel = createSpeechModel;\n\n  return provider as LMNTProvider;\n}\n\n/**\n * Default LMNT provider instance.\n */\nexport const lmnt = createLMNT();\n","import { SpeechModelV4, SharedV4Warning } from '@ai-sdk/provider';\nimport {\n  combineHeaders,\n  createBinaryResponseHandler,\n  parseProviderOptions,\n  postJsonToApi,\n  serializeModelOptions,\n  WORKFLOW_SERIALIZE,\n  WORKFLOW_DESERIALIZE,\n} from '@ai-sdk/provider-utils';\nimport { z } from 'zod/v4';\nimport { LMNTConfig } from './lmnt-config';\nimport { lmntFailedResponseHandler } from './lmnt-error';\nimport { LMNTSpeechModelId } from './lmnt-speech-options';\nimport { LMNTSpeechAPITypes } from './lmnt-api-types';\n\n// https://docs.lmnt.com/api-reference/speech/synthesize-speech-bytes\nconst lmntSpeechModelOptionsSchema = z.object({\n  /**\n   * The model to use for speech synthesis e.g. 'aurora' or 'blizzard'.\n   * @default 'aurora'\n   */\n  model: z\n    .union([z.enum(['aurora', 'blizzard']), z.string()])\n    .nullish()\n    .default('aurora'),\n\n  /**\n   * The audio format of the output.\n   * @default 'mp3'\n   */\n  format: z\n    .enum(['aac', 'mp3', 'mulaw', 'raw', 'wav'])\n    .nullish()\n    .default('mp3'),\n\n  /**\n   * The sample rate of the output audio in Hz.\n   * @default 24000\n   */\n  sampleRate: z\n    .union([z.literal(8000), z.literal(16000), z.literal(24000)])\n    .nullish()\n    .default(24000),\n\n  /**\n   * The speed of the speech. Range: 0.25 to 2.\n   * @default 1\n   */\n  speed: z.number().min(0.25).max(2).nullish().default(1),\n\n  /**\n   * A seed value for deterministic generation.\n   */\n  seed: z.number().int().nullish(),\n\n  /**\n   * Whether to use a conversational style.\n   * @default false\n   */\n  conversational: z.boolean().nullish().default(false),\n\n  /**\n   * Maximum length of the output in seconds (up to 300).\n   */\n  length: z.number().max(300).nullish(),\n\n  /**\n   * Top-p sampling parameter. Range: 0 to 1.\n   * @default 1\n   */\n  topP: z.number().min(0).max(1).nullish().default(1),\n\n  /**\n   * Temperature for sampling. Higher values increase randomness.\n   * @default 1\n   */\n  temperature: z.number().min(0).nullish().default(1),\n});\n\nexport type LMNTSpeechModelOptions = z.infer<\n  typeof lmntSpeechModelOptionsSchema\n>;\n\ninterface LMNTSpeechModelConfig extends LMNTConfig {\n  _internal?: {\n    currentDate?: () => Date;\n  };\n}\n\nexport class LMNTSpeechModel implements SpeechModelV4 {\n  readonly specificationVersion = 'v4';\n\n  get provider(): string {\n    return this.config.provider;\n  }\n\n  static [WORKFLOW_SERIALIZE](model: LMNTSpeechModel) {\n    return serializeModelOptions({\n      modelId: model.modelId,\n      config: model.config,\n    });\n  }\n\n  static [WORKFLOW_DESERIALIZE](options: {\n    modelId: LMNTSpeechModelId;\n    config: LMNTSpeechModelConfig;\n  }) {\n    return new LMNTSpeechModel(options.modelId, options.config);\n  }\n\n  constructor(\n    readonly modelId: LMNTSpeechModelId,\n    private readonly config: LMNTSpeechModelConfig,\n  ) {}\n\n  private async getArgs({\n    text,\n    voice = 'ava',\n    outputFormat = 'mp3',\n    speed,\n    language,\n    providerOptions,\n  }: Parameters<SpeechModelV4['doGenerate']>[0]) {\n    const warnings: SharedV4Warning[] = [];\n\n    // Parse provider options\n    const lmntOptions = await parseProviderOptions({\n      provider: 'lmnt',\n      providerOptions,\n      schema: lmntSpeechModelOptionsSchema,\n    });\n\n    // Create request body\n    const requestBody: Record<string, unknown> = {\n      model: this.modelId,\n      text,\n      voice,\n      response_format: 'mp3',\n      speed,\n    };\n\n    if (outputFormat) {\n      if (['mp3', 'aac', 'mulaw', 'raw', 'wav'].includes(outputFormat)) {\n        requestBody.response_format = outputFormat;\n      } else {\n        warnings.push({\n          type: 'unsupported',\n          feature: 'outputFormat',\n          details: `Unsupported output format: ${outputFormat}. Using mp3 instead.`,\n        });\n      }\n    }\n\n    // Add provider-specific options\n    if (lmntOptions) {\n      const speechModelOptions: Omit<LMNTSpeechAPITypes, 'voice' | 'text'> = {\n        conversational: lmntOptions.conversational ?? undefined,\n        length: lmntOptions.length ?? undefined,\n        seed: lmntOptions.seed ?? undefined,\n        speed: lmntOptions.speed ?? undefined,\n        temperature: lmntOptions.temperature ?? undefined,\n        top_p: lmntOptions.topP ?? undefined,\n        sample_rate: lmntOptions.sampleRate ?? undefined,\n      };\n\n      for (const key in speechModelOptions) {\n        const value =\n          speechModelOptions[\n            key as keyof Omit<LMNTSpeechAPITypes, 'voice' | 'text'>\n          ];\n        if (value !== undefined) {\n          requestBody[key] = value;\n        }\n      }\n    }\n\n    if (language) {\n      requestBody.language = language;\n    }\n\n    return {\n      requestBody,\n      warnings,\n    };\n  }\n\n  async doGenerate(\n    options: Parameters<SpeechModelV4['doGenerate']>[0],\n  ): Promise<Awaited<ReturnType<SpeechModelV4['doGenerate']>>> {\n    const currentDate = this.config._internal?.currentDate?.() ?? new Date();\n    const { requestBody, warnings } = await this.getArgs(options);\n\n    const {\n      value: audio,\n      responseHeaders,\n      rawValue: rawResponse,\n    } = await postJsonToApi({\n      url: this.config.url({\n        path: '/v1/ai/speech/bytes',\n        modelId: this.modelId,\n      }),\n      headers: combineHeaders(this.config.headers?.(), options.headers),\n      body: requestBody,\n      failedResponseHandler: lmntFailedResponseHandler,\n      successfulResponseHandler: createBinaryResponseHandler(),\n      abortSignal: options.abortSignal,\n      fetch: this.config.fetch,\n    });\n\n    return {\n      audio,\n      warnings,\n      request: {\n        body: JSON.stringify(requestBody),\n      },\n      response: {\n        timestamp: currentDate,\n        modelId: this.modelId,\n        headers: responseHeaders,\n        body: rawResponse,\n      },\n    };\n  }\n}\n","import { z } from 'zod/v4';\nimport { createJsonErrorResponseHandler } from '@ai-sdk/provider-utils';\n\nexport const lmntErrorDataSchema = z.object({\n  error: z.object({\n    message: z.string(),\n    code: z.number(),\n  }),\n});\n\nexport type LMNTErrorData = z.infer<typeof lmntErrorDataSchema>;\n\nexport const lmntFailedResponseHandler = createJsonErrorResponseHandler({\n  errorSchema: lmntErrorDataSchema,\n  errorToMessage: data => data.error.message,\n});\n","// Version string of this package injected at build time.\ndeclare const __PACKAGE_VERSION__: string | undefined;\nexport const VERSION: string =\n  typeof __PACKAGE_VERSION__ !== 'undefined'\n    ? __PACKAGE_VERSION__\n    : '0.0.0-test';\n"],"mappings":"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","names":["z","z"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/lmnt",
-  "version": "3.0.0-beta.20",
+  "version": "3.0.0-beta.21",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -29,8 +29,8 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/provider": "4.0.0-beta.11",
-    "@ai-sdk/provider-utils": "5.0.0-beta.19"
+    "@ai-sdk/provider": "4.0.0-beta.12",
+    "@ai-sdk/provider-utils": "5.0.0-beta.20"
   },
   "devDependencies": {
     "@types/node": "20.17.24",

package/src/lmnt-config.ts

@@ -3,7 +3,7 @@ import { FetchFunction } from '@ai-sdk/provider-utils';
 export type LMNTConfig = {
   provider: string;
   url: (options: { modelId: string; path: string }) => string;
-  headers: () => Record<string, string | undefined>;
+  headers?: () => Record<string, string | undefined>;
   fetch?: FetchFunction;
   generateId?: () => string;
 };

package/src/lmnt-speech-model.ts

@@ -4,6 +4,9 @@ import {
   createBinaryResponseHandler,
   parseProviderOptions,
   postJsonToApi,
+  serializeModelOptions,
+  WORKFLOW_SERIALIZE,
+  WORKFLOW_DESERIALIZE,
 } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
 import { LMNTConfig } from './lmnt-config';
@@ -92,6 +95,20 @@ export class LMNTSpeechModel implements SpeechModelV4 {
     return this.config.provider;
   }
 
+  static [WORKFLOW_SERIALIZE](model: LMNTSpeechModel) {
+    return serializeModelOptions({
+      modelId: model.modelId,
+      config: model.config,
+    });
+  }
+
+  static [WORKFLOW_DESERIALIZE](options: {
+    modelId: LMNTSpeechModelId;
+    config: LMNTSpeechModelConfig;
+  }) {
+    return new LMNTSpeechModel(options.modelId, options.config);
+  }
+
   constructor(
     readonly modelId: LMNTSpeechModelId,
     private readonly config: LMNTSpeechModelConfig,
@@ -183,7 +200,7 @@ export class LMNTSpeechModel implements SpeechModelV4 {
         path: '/v1/ai/speech/bytes',
         modelId: this.modelId,
       }),
-      headers: combineHeaders(this.config.headers(), options.headers),
+      headers: combineHeaders(this.config.headers?.(), options.headers),
       body: requestBody,
       failedResponseHandler: lmntFailedResponseHandler,
       successfulResponseHandler: createBinaryResponseHandler(),