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

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/hume-provider.ts","../src/hume-speech-model.ts","../src/hume-error.ts","../src/version.ts"],"sourcesContent":["export { createHume, hume } from './hume-provider';\nexport type { HumeProvider, HumeProviderSettings } from './hume-provider';\nexport type { HumeSpeechModelOptions } from './hume-speech-model';\nexport { VERSION } from './version';\n","import { SpeechModelV3, ProviderV3 } from '@ai-sdk/provider';\nimport {\n  FetchFunction,\n  loadApiKey,\n  withUserAgentSuffix,\n} from '@ai-sdk/provider-utils';\nimport { HumeSpeechModel } from './hume-speech-model';\nimport { VERSION } from './version';\n\nexport interface HumeProvider extends Pick<ProviderV3, 'speechModel'> {\n  (settings?: {}): {\n    speech: HumeSpeechModel;\n  };\n\n  /**\n   * Creates a model for speech synthesis.\n   */\n  speech(): SpeechModelV3;\n}\n\nexport interface HumeProviderSettings {\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 Hume provider instance.\n */\nexport function createHume(options: HumeProviderSettings = {}): HumeProvider {\n  const getHeaders = () =>\n    withUserAgentSuffix(\n      {\n        'X-Hume-Api-Key': loadApiKey({\n          apiKey: options.apiKey,\n          environmentVariableName: 'HUME_API_KEY',\n          description: 'Hume',\n        }),\n        ...options.headers,\n      },\n      `ai-sdk/hume/${VERSION}`,\n    );\n\n  const createSpeechModel = () =>\n    new HumeSpeechModel('', {\n      provider: `hume.speech`,\n      url: ({ path }) => `https://api.hume.ai${path}`,\n      headers: getHeaders,\n      fetch: options.fetch,\n    });\n\n  const provider = function () {\n    return {\n      speech: createSpeechModel(),\n    };\n  };\n\n  provider.speech = createSpeechModel;\n  provider.speechModel = createSpeechModel;\n\n  return provider satisfies HumeProvider;\n}\n\n/**\n * Default Hume provider instance.\n */\nexport const hume = createHume();\n","import { SpeechModelV3, SharedV3Warning } 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 { HumeConfig } from './hume-config';\nimport { humeFailedResponseHandler } from './hume-error';\nimport { HumeSpeechAPITypes } from './hume-api-types';\n\n// https://dev.hume.ai/reference/text-to-speech-tts/synthesize-file\nconst humeSpeechModelOptionsSchema = z.object({\n  /**\n   * Context for the speech synthesis request.\n   * Can be either a generationId for retrieving a previous generation,\n   * or a list of utterances to synthesize.\n   */\n  context: z\n    .object({\n      /**\n       * ID of a previously generated speech synthesis to retrieve.\n       */\n      generationId: z.string(),\n    })\n    .or(\n      z.object({\n        /**\n         * List of utterances to synthesize into speech.\n         */\n        utterances: z.array(\n          z.object({\n            /**\n             * The text content to convert to speech.\n             */\n            text: z.string(),\n            /**\n             * Optional description or instructions for how the text should be spoken.\n             */\n            description: z.string().optional(),\n            /**\n             * Optional speech rate multiplier.\n             */\n            speed: z.number().optional(),\n            /**\n             * Optional duration of silence to add after the utterance in seconds.\n             */\n            trailingSilence: z.number().optional(),\n            /**\n             * Voice configuration for the utterance.\n             * Can be specified by ID or name.\n             */\n            voice: z\n              .object({\n                /**\n                 * ID of the voice to use.\n                 */\n                id: z.string(),\n                /**\n                 * Provider of the voice, either Hume's built-in voices or a custom voice.\n                 */\n                provider: z.enum(['HUME_AI', 'CUSTOM_VOICE']).optional(),\n              })\n              .or(\n                z.object({\n                  /**\n                   * Name of the voice to use.\n                   */\n                  name: z.string(),\n                  /**\n                   * Provider of the voice, either Hume's built-in voices or a custom voice.\n                   */\n                  provider: z.enum(['HUME_AI', 'CUSTOM_VOICE']).optional(),\n                }),\n              )\n              .optional(),\n          }),\n        ),\n      }),\n    )\n    .nullish(),\n});\n\nexport type HumeSpeechModelOptions = z.infer<\n  typeof humeSpeechModelOptionsSchema\n>;\n\ninterface HumeSpeechModelConfig extends HumeConfig {\n  _internal?: {\n    currentDate?: () => Date;\n  };\n}\n\nexport class HumeSpeechModel implements SpeechModelV3 {\n  readonly specificationVersion = 'v3';\n\n  get provider(): string {\n    return this.config.provider;\n  }\n\n  constructor(\n    readonly modelId: '',\n    private readonly config: HumeSpeechModelConfig,\n  ) {}\n\n  private async getArgs({\n    text,\n    voice = 'd8ab67c6-953d-4bd8-9370-8fa53a0f1453',\n    outputFormat = 'mp3',\n    speed,\n    instructions,\n    language,\n    providerOptions,\n  }: Parameters<SpeechModelV3['doGenerate']>[0]) {\n    const warnings: SharedV3Warning[] = [];\n\n    // Parse provider options\n    const humeOptions = await parseProviderOptions({\n      provider: 'hume',\n      providerOptions,\n      schema: humeSpeechModelOptionsSchema,\n    });\n\n    // Create request body\n    const requestBody: HumeSpeechAPITypes = {\n      utterances: [\n        {\n          text,\n          speed,\n          description: instructions,\n          voice: {\n            id: voice,\n            provider: 'HUME_AI',\n          },\n        },\n      ],\n      format: { type: 'mp3' },\n    };\n\n    if (outputFormat) {\n      if (['mp3', 'pcm', 'wav'].includes(outputFormat)) {\n        requestBody.format = { type: outputFormat as 'mp3' | 'pcm' | 'wav' };\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 (humeOptions) {\n      const speechModelOptions: Omit<\n        HumeSpeechAPITypes,\n        'utterances' | 'format'\n      > = {};\n\n      if (humeOptions.context) {\n        if ('generationId' in humeOptions.context) {\n          speechModelOptions.context = {\n            generation_id: humeOptions.context.generationId,\n          };\n        } else {\n          speechModelOptions.context = {\n            utterances: humeOptions.context.utterances.map(utterance => ({\n              text: utterance.text,\n              description: utterance.description,\n              speed: utterance.speed,\n              trailing_silence: utterance.trailingSilence,\n              voice: utterance.voice,\n            })),\n          };\n        }\n      }\n\n      for (const key in speechModelOptions) {\n        const value =\n          speechModelOptions[\n            key as keyof Omit<HumeSpeechAPITypes, 'utterances' | 'format'>\n          ];\n        if (value !== undefined) {\n          (requestBody as Record<string, unknown>)[key] = value;\n        }\n      }\n    }\n\n    if (language) {\n      warnings.push({\n        type: 'unsupported',\n        feature: 'language',\n        details: `Hume speech models do not support language selection. Language parameter \"${language}\" was ignored.`,\n      });\n    }\n\n    return {\n      requestBody,\n      warnings,\n    };\n  }\n\n  async doGenerate(\n    options: Parameters<SpeechModelV3['doGenerate']>[0],\n  ): Promise<Awaited<ReturnType<SpeechModelV3['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: '/v0/tts/file',\n        modelId: this.modelId,\n      }),\n      headers: combineHeaders(this.config.headers(), options.headers),\n      body: requestBody,\n      failedResponseHandler: humeFailedResponseHandler,\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 humeErrorDataSchema = z.object({\n  error: z.object({\n    message: z.string(),\n    code: z.number(),\n  }),\n});\n\nexport type HumeErrorData = z.infer<typeof humeErrorDataSchema>;\n\nexport const humeFailedResponseHandler = createJsonErrorResponseHandler({\n  errorSchema: humeErrorDataSchema,\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":["import_provider_utils","import_provider_utils","import_v4"]}
+{"version":3,"sources":["../src/hume-provider.ts","../src/hume-speech-model.ts","../src/hume-error.ts","../src/hume-speech-model-options.ts","../src/version.ts"],"sourcesContent":["import {\n  NoSuchModelError,\n  type SpeechModelV4,\n  type ProviderV4,\n} from '@ai-sdk/provider';\nimport {\n  loadApiKey,\n  withUserAgentSuffix,\n  type FetchFunction,\n} from '@ai-sdk/provider-utils';\nimport { HumeSpeechModel } from './hume-speech-model';\nimport { VERSION } from './version';\n\nexport interface HumeProvider extends ProviderV4 {\n  (settings?: {}): {\n    speech: HumeSpeechModel;\n  };\n\n  /**\n   * Creates a model for speech synthesis.\n   */\n  speech(): SpeechModelV4;\n}\n\nexport interface HumeProviderSettings {\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 Hume provider instance.\n */\nexport function createHume(options: HumeProviderSettings = {}): HumeProvider {\n  const getHeaders = () =>\n    withUserAgentSuffix(\n      {\n        'X-Hume-Api-Key': loadApiKey({\n          apiKey: options.apiKey,\n          environmentVariableName: 'HUME_API_KEY',\n          description: 'Hume',\n        }),\n        ...options.headers,\n      },\n      `ai-sdk/hume/${VERSION}`,\n    );\n\n  const createSpeechModel = () =>\n    new HumeSpeechModel('', {\n      provider: `hume.speech`,\n      url: ({ path }) => `https://api.hume.ai${path}`,\n      headers: getHeaders,\n      fetch: options.fetch,\n    });\n\n  const provider = function () {\n    return {\n      speech: createSpeechModel(),\n    };\n  };\n\n  provider.specificationVersion = 'v4' as const;\n  provider.speech = createSpeechModel;\n  provider.speechModel = createSpeechModel;\n\n  provider.languageModel = (modelId: string) => {\n    throw new NoSuchModelError({\n      modelId,\n      modelType: 'languageModel',\n      message: 'Hume does not provide language models',\n    });\n  };\n\n  provider.embeddingModel = (modelId: string) => {\n    throw new NoSuchModelError({\n      modelId,\n      modelType: 'embeddingModel',\n      message: 'Hume does not provide embedding models',\n    });\n  };\n\n  provider.imageModel = (modelId: string) => {\n    throw new NoSuchModelError({\n      modelId,\n      modelType: 'imageModel',\n      message: 'Hume does not provide image models',\n    });\n  };\n\n  return provider as HumeProvider;\n}\n\n/**\n * Default Hume provider instance.\n */\nexport const hume = createHume();\n","import type { 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 type { HumeConfig } from './hume-config';\nimport { humeFailedResponseHandler } from './hume-error';\nimport { humeSpeechModelOptionsSchema } from './hume-speech-model-options';\nimport type { HumeSpeechAPITypes } from './hume-api-types';\n\ninterface HumeSpeechModelConfig extends HumeConfig {\n  _internal?: {\n    currentDate?: () => Date;\n  };\n}\n\nexport class HumeSpeechModel implements SpeechModelV4 {\n  readonly specificationVersion = 'v4';\n\n  get provider(): string {\n    return this.config.provider;\n  }\n\n  static [WORKFLOW_SERIALIZE](model: HumeSpeechModel) {\n    return serializeModelOptions({\n      modelId: model.modelId,\n      config: model.config,\n    });\n  }\n\n  static [WORKFLOW_DESERIALIZE](options: {\n    modelId: '';\n    config: HumeSpeechModelConfig;\n  }) {\n    return new HumeSpeechModel(options.modelId as '', options.config);\n  }\n\n  constructor(\n    readonly modelId: '',\n    private readonly config: HumeSpeechModelConfig,\n  ) {}\n\n  private async getArgs({\n    text,\n    voice = 'd8ab67c6-953d-4bd8-9370-8fa53a0f1453',\n    outputFormat = 'mp3',\n    speed,\n    instructions,\n    language,\n    providerOptions,\n  }: Parameters<SpeechModelV4['doGenerate']>[0]) {\n    const warnings: SharedV4Warning[] = [];\n\n    // Parse provider options\n    const humeOptions = await parseProviderOptions({\n      provider: 'hume',\n      providerOptions,\n      schema: humeSpeechModelOptionsSchema,\n    });\n\n    // Create request body\n    const requestBody: HumeSpeechAPITypes = {\n      utterances: [\n        {\n          text,\n          speed,\n          description: instructions,\n          voice: {\n            id: voice,\n            provider: 'HUME_AI',\n          },\n        },\n      ],\n      format: { type: 'mp3' },\n    };\n\n    if (outputFormat) {\n      if (['mp3', 'pcm', 'wav'].includes(outputFormat)) {\n        requestBody.format = { type: outputFormat as 'mp3' | 'pcm' | 'wav' };\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 (humeOptions) {\n      const speechModelOptions: Omit<\n        HumeSpeechAPITypes,\n        'utterances' | 'format'\n      > = {};\n\n      if (humeOptions.context) {\n        if ('generationId' in humeOptions.context) {\n          speechModelOptions.context = {\n            generation_id: humeOptions.context.generationId,\n          };\n        } else {\n          speechModelOptions.context = {\n            utterances: humeOptions.context.utterances.map(utterance => ({\n              text: utterance.text,\n              description: utterance.description,\n              speed: utterance.speed,\n              trailing_silence: utterance.trailingSilence,\n              voice: utterance.voice,\n            })),\n          };\n        }\n      }\n\n      for (const key in speechModelOptions) {\n        const value =\n          speechModelOptions[\n            key as keyof Omit<HumeSpeechAPITypes, 'utterances' | 'format'>\n          ];\n        if (value !== undefined) {\n          (requestBody as Record<string, unknown>)[key] = value;\n        }\n      }\n    }\n\n    if (language) {\n      warnings.push({\n        type: 'unsupported',\n        feature: 'language',\n        details: `Hume speech models do not support language selection. Language parameter \"${language}\" was ignored.`,\n      });\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: '/v0/tts/file',\n        modelId: this.modelId,\n      }),\n      headers: combineHeaders(this.config.headers?.(), options.headers),\n      body: requestBody,\n      failedResponseHandler: humeFailedResponseHandler,\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 humeErrorDataSchema = z.object({\n  error: z.object({\n    message: z.string(),\n    code: z.number(),\n  }),\n});\n\nexport type HumeErrorData = z.infer<typeof humeErrorDataSchema>;\n\nexport const humeFailedResponseHandler = createJsonErrorResponseHandler({\n  errorSchema: humeErrorDataSchema,\n  errorToMessage: data => data.error.message,\n});\n","import { z } from 'zod/v4';\n\n// https://dev.hume.ai/reference/text-to-speech-tts/synthesize-file\nexport const humeSpeechModelOptionsSchema = z.object({\n  /**\n   * Context for the speech synthesis request.\n   * Can be either a generationId for retrieving a previous generation,\n   * or a list of utterances to synthesize.\n   */\n  context: z\n    .object({\n      /**\n       * ID of a previously generated speech synthesis to retrieve.\n       */\n      generationId: z.string(),\n    })\n    .or(\n      z.object({\n        /**\n         * List of utterances to synthesize into speech.\n         */\n        utterances: z.array(\n          z.object({\n            /**\n             * The text content to convert to speech.\n             */\n            text: z.string(),\n            /**\n             * Optional description or instructions for how the text should be spoken.\n             */\n            description: z.string().optional(),\n            /**\n             * Optional speech rate multiplier.\n             */\n            speed: z.number().optional(),\n            /**\n             * Optional duration of silence to add after the utterance in seconds.\n             */\n            trailingSilence: z.number().optional(),\n            /**\n             * Voice configuration for the utterance.\n             * Can be specified by ID or name.\n             */\n            voice: z\n              .object({\n                /**\n                 * ID of the voice to use.\n                 */\n                id: z.string(),\n                /**\n                 * Provider of the voice, either Hume's built-in voices or a custom voice.\n                 */\n                provider: z.enum(['HUME_AI', 'CUSTOM_VOICE']).optional(),\n              })\n              .or(\n                z.object({\n                  /**\n                   * Name of the voice to use.\n                   */\n                  name: z.string(),\n                  /**\n                   * Provider of the voice, either Hume's built-in voices or a custom voice.\n                   */\n                  provider: z.enum(['HUME_AI', 'CUSTOM_VOICE']).optional(),\n                }),\n              )\n              .optional(),\n          }),\n        ),\n      }),\n    )\n    .nullish(),\n});\n\nexport type HumeSpeechModelOptions = z.infer<\n  typeof humeSpeechModelOptionsSchema\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"]}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@ai-sdk/hume",
-  "version": "3.0.0-beta.3",
+  "version": "3.0.0-beta.31",
+  "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
   "main": "./dist/index.js",
-  "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
   "files": [
     "dist/**/*",
@@ -24,20 +24,20 @@
     "./package.json": "./package.json",
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js"
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
     }
   },
   "dependencies": {
-    "@ai-sdk/provider": "4.0.0-beta.2",
-    "@ai-sdk/provider-utils": "5.0.0-beta.3"
+    "@ai-sdk/provider": "4.0.0-beta.14",
+    "@ai-sdk/provider-utils": "5.0.0-beta.30"
   },
   "devDependencies": {
     "@types/node": "20.17.24",
     "tsup": "^8",
     "typescript": "5.6.3",
     "zod": "3.25.76",
-    "@ai-sdk/test-server": "2.0.0-beta.0",
+    "@ai-sdk/test-server": "2.0.0-beta.3",
     "@vercel/ai-tsconfig": "0.0.0"
   },
   "peerDependencies": {
@@ -47,12 +47,14 @@
     "node": ">=18"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "provenance": true
   },
   "homepage": "https://ai-sdk.dev/docs",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/vercel/ai.git"
+    "url": "https://github.com/vercel/ai",
+    "directory": "packages/hume"
   },
   "bugs": {
     "url": "https://github.com/vercel/ai/issues"
@@ -64,9 +66,7 @@
     "build": "tsup --tsconfig tsconfig.build.json",
     "build:watch": "tsup --tsconfig tsconfig.build.json --watch",
     "clean": "del-cli dist docs",
-    "lint": "eslint \"./**/*.ts*\"",
     "type-check": "tsc --noEmit",
-    "prettier-check": "prettier --check \"./**/*.ts*\"",
     "test": "pnpm test:node && pnpm test:edge",
     "test:watch": "vitest --config vitest.node.config.js --watch",
     "test:edge": "vitest --config vitest.edge.config.js --run",

package/src/hume-config.ts

@@ -1,9 +1,9 @@
-import { FetchFunction } from '@ai-sdk/provider-utils';
+import type { FetchFunction } from '@ai-sdk/provider-utils';
 
 export type HumeConfig = {
   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/hume-provider.ts

@@ -1,13 +1,17 @@
-import { SpeechModelV3, ProviderV3 } from '@ai-sdk/provider';
 import {
-  FetchFunction,
+  NoSuchModelError,
+  type SpeechModelV4,
+  type ProviderV4,
+} from '@ai-sdk/provider';
+import {
   loadApiKey,
   withUserAgentSuffix,
+  type FetchFunction,
 } from '@ai-sdk/provider-utils';
 import { HumeSpeechModel } from './hume-speech-model';
 import { VERSION } from './version';
 
-export interface HumeProvider extends Pick<ProviderV3, 'speechModel'> {
+export interface HumeProvider extends ProviderV4 {
   (settings?: {}): {
     speech: HumeSpeechModel;
   };
@@ -15,7 +19,7 @@ export interface HumeProvider extends Pick<ProviderV3, 'speechModel'> {
   /**
    * Creates a model for speech synthesis.
    */
-  speech(): SpeechModelV3;
+  speech(): SpeechModelV4;
 }
 
 export interface HumeProviderSettings {
@@ -67,10 +71,35 @@ export function createHume(options: HumeProviderSettings = {}): HumeProvider {
     };
   };
 
+  provider.specificationVersion = 'v4' as const;
   provider.speech = createSpeechModel;
   provider.speechModel = createSpeechModel;
 
-  return provider satisfies HumeProvider;
+  provider.languageModel = (modelId: string) => {
+    throw new NoSuchModelError({
+      modelId,
+      modelType: 'languageModel',
+      message: 'Hume does not provide language models',
+    });
+  };
+
+  provider.embeddingModel = (modelId: string) => {
+    throw new NoSuchModelError({
+      modelId,
+      modelType: 'embeddingModel',
+      message: 'Hume does not provide embedding models',
+    });
+  };
+
+  provider.imageModel = (modelId: string) => {
+    throw new NoSuchModelError({
+      modelId,
+      modelType: 'imageModel',
+      message: 'Hume does not provide image models',
+    });
+  };
+
+  return provider as HumeProvider;
 }
 
 /**

package/src/hume-speech-model-options.ts

@@ -0,0 +1,77 @@
+import { z } from 'zod/v4';
+
+// https://dev.hume.ai/reference/text-to-speech-tts/synthesize-file
+export const humeSpeechModelOptionsSchema = z.object({
+  /**
+   * Context for the speech synthesis request.
+   * Can be either a generationId for retrieving a previous generation,
+   * or a list of utterances to synthesize.
+   */
+  context: z
+    .object({
+      /**
+       * ID of a previously generated speech synthesis to retrieve.
+       */
+      generationId: z.string(),
+    })
+    .or(
+      z.object({
+        /**
+         * List of utterances to synthesize into speech.
+         */
+        utterances: z.array(
+          z.object({
+            /**
+             * The text content to convert to speech.
+             */
+            text: z.string(),
+            /**
+             * Optional description or instructions for how the text should be spoken.
+             */
+            description: z.string().optional(),
+            /**
+             * Optional speech rate multiplier.
+             */
+            speed: z.number().optional(),
+            /**
+             * Optional duration of silence to add after the utterance in seconds.
+             */
+            trailingSilence: z.number().optional(),
+            /**
+             * Voice configuration for the utterance.
+             * Can be specified by ID or name.
+             */
+            voice: z
+              .object({
+                /**
+                 * ID of the voice to use.
+                 */
+                id: z.string(),
+                /**
+                 * Provider of the voice, either Hume's built-in voices or a custom voice.
+                 */
+                provider: z.enum(['HUME_AI', 'CUSTOM_VOICE']).optional(),
+              })
+              .or(
+                z.object({
+                  /**
+                   * Name of the voice to use.
+                   */
+                  name: z.string(),
+                  /**
+                   * Provider of the voice, either Hume's built-in voices or a custom voice.
+                   */
+                  provider: z.enum(['HUME_AI', 'CUSTOM_VOICE']).optional(),
+                }),
+              )
+              .optional(),
+          }),
+        ),
+      }),
+    )
+    .nullish(),
+});
+
+export type HumeSpeechModelOptions = z.infer<
+  typeof humeSpeechModelOptionsSchema
+>;

package/src/hume-speech-model.ts

@@ -1,90 +1,17 @@
-import { SpeechModelV3, SharedV3Warning } from '@ai-sdk/provider';
+import type { SpeechModelV4, SharedV4Warning } from '@ai-sdk/provider';
 import {
   combineHeaders,
   createBinaryResponseHandler,
   parseProviderOptions,
   postJsonToApi,
+  serializeModelOptions,
+  WORKFLOW_SERIALIZE,
+  WORKFLOW_DESERIALIZE,
 } from '@ai-sdk/provider-utils';
-import { z } from 'zod/v4';
-import { HumeConfig } from './hume-config';
+import type { HumeConfig } from './hume-config';
 import { humeFailedResponseHandler } from './hume-error';
-import { HumeSpeechAPITypes } from './hume-api-types';
-
-// https://dev.hume.ai/reference/text-to-speech-tts/synthesize-file
-const humeSpeechModelOptionsSchema = z.object({
-  /**
-   * Context for the speech synthesis request.
-   * Can be either a generationId for retrieving a previous generation,
-   * or a list of utterances to synthesize.
-   */
-  context: z
-    .object({
-      /**
-       * ID of a previously generated speech synthesis to retrieve.
-       */
-      generationId: z.string(),
-    })
-    .or(
-      z.object({
-        /**
-         * List of utterances to synthesize into speech.
-         */
-        utterances: z.array(
-          z.object({
-            /**
-             * The text content to convert to speech.
-             */
-            text: z.string(),
-            /**
-             * Optional description or instructions for how the text should be spoken.
-             */
-            description: z.string().optional(),
-            /**
-             * Optional speech rate multiplier.
-             */
-            speed: z.number().optional(),
-            /**
-             * Optional duration of silence to add after the utterance in seconds.
-             */
-            trailingSilence: z.number().optional(),
-            /**
-             * Voice configuration for the utterance.
-             * Can be specified by ID or name.
-             */
-            voice: z
-              .object({
-                /**
-                 * ID of the voice to use.
-                 */
-                id: z.string(),
-                /**
-                 * Provider of the voice, either Hume's built-in voices or a custom voice.
-                 */
-                provider: z.enum(['HUME_AI', 'CUSTOM_VOICE']).optional(),
-              })
-              .or(
-                z.object({
-                  /**
-                   * Name of the voice to use.
-                   */
-                  name: z.string(),
-                  /**
-                   * Provider of the voice, either Hume's built-in voices or a custom voice.
-                   */
-                  provider: z.enum(['HUME_AI', 'CUSTOM_VOICE']).optional(),
-                }),
-              )
-              .optional(),
-          }),
-        ),
-      }),
-    )
-    .nullish(),
-});
-
-export type HumeSpeechModelOptions = z.infer<
-  typeof humeSpeechModelOptionsSchema
->;
+import { humeSpeechModelOptionsSchema } from './hume-speech-model-options';
+import type { HumeSpeechAPITypes } from './hume-api-types';
 
 interface HumeSpeechModelConfig extends HumeConfig {
   _internal?: {
@@ -92,13 +19,27 @@ interface HumeSpeechModelConfig extends HumeConfig {
   };
 }
 
-export class HumeSpeechModel implements SpeechModelV3 {
-  readonly specificationVersion = 'v3';
+export class HumeSpeechModel implements SpeechModelV4 {
+  readonly specificationVersion = 'v4';
 
   get provider(): string {
     return this.config.provider;
   }
 
+  static [WORKFLOW_SERIALIZE](model: HumeSpeechModel) {
+    return serializeModelOptions({
+      modelId: model.modelId,
+      config: model.config,
+    });
+  }
+
+  static [WORKFLOW_DESERIALIZE](options: {
+    modelId: '';
+    config: HumeSpeechModelConfig;
+  }) {
+    return new HumeSpeechModel(options.modelId as '', options.config);
+  }
+
   constructor(
     readonly modelId: '',
     private readonly config: HumeSpeechModelConfig,
@@ -112,8 +53,8 @@ export class HumeSpeechModel implements SpeechModelV3 {
     instructions,
     language,
     providerOptions,
-  }: Parameters<SpeechModelV3['doGenerate']>[0]) {
-    const warnings: SharedV3Warning[] = [];
+  }: Parameters<SpeechModelV4['doGenerate']>[0]) {
+    const warnings: SharedV4Warning[] = [];
 
     // Parse provider options
     const humeOptions = await parseProviderOptions({
@@ -201,8 +142,8 @@ export class HumeSpeechModel implements SpeechModelV3 {
   }
 
   async doGenerate(
-    options: Parameters<SpeechModelV3['doGenerate']>[0],
-  ): Promise<Awaited<ReturnType<SpeechModelV3['doGenerate']>>> {
+    options: Parameters<SpeechModelV4['doGenerate']>[0],
+  ): Promise<Awaited<ReturnType<SpeechModelV4['doGenerate']>>> {
     const currentDate = this.config._internal?.currentDate?.() ?? new Date();
     const { requestBody, warnings } = await this.getArgs(options);
 
@@ -215,7 +156,7 @@ export class HumeSpeechModel implements SpeechModelV3 {
         path: '/v0/tts/file',
         modelId: this.modelId,
       }),
-      headers: combineHeaders(this.config.headers(), options.headers),
+      headers: combineHeaders(this.config.headers?.(), options.headers),
       body: requestBody,
       failedResponseHandler: humeFailedResponseHandler,
       successfulResponseHandler: createBinaryResponseHandler(),

package/src/index.ts

@@ -1,4 +1,4 @@
 export { createHume, hume } from './hume-provider';
 export type { HumeProvider, HumeProviderSettings } from './hume-provider';
-export type { HumeSpeechModelOptions } from './hume-speech-model';
+export type { HumeSpeechModelOptions } from './hume-speech-model-options';
 export { VERSION } from './version';

package/dist/index.d.mts

@@ -1,92 +0,0 @@
-import { SpeechModelV3, ProviderV3 } from '@ai-sdk/provider';
-import { FetchFunction } from '@ai-sdk/provider-utils';
-import { z } from 'zod/v4';
-
-type HumeConfig = {
-    provider: string;
-    url: (options: {
-        modelId: string;
-        path: string;
-    }) => string;
-    headers: () => Record<string, string | undefined>;
-    fetch?: FetchFunction;
-    generateId?: () => string;
-};
-
-declare const humeSpeechModelOptionsSchema: z.ZodObject<{
-    context: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodObject<{
-        generationId: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        utterances: z.ZodArray<z.ZodObject<{
-            text: z.ZodString;
-            description: z.ZodOptional<z.ZodString>;
-            speed: z.ZodOptional<z.ZodNumber>;
-            trailingSilence: z.ZodOptional<z.ZodNumber>;
-            voice: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
-                id: z.ZodString;
-                provider: z.ZodOptional<z.ZodEnum<{
-                    HUME_AI: "HUME_AI";
-                    CUSTOM_VOICE: "CUSTOM_VOICE";
-                }>>;
-            }, z.core.$strip>, z.ZodObject<{
-                name: z.ZodString;
-                provider: z.ZodOptional<z.ZodEnum<{
-                    HUME_AI: "HUME_AI";
-                    CUSTOM_VOICE: "CUSTOM_VOICE";
-                }>>;
-            }, z.core.$strip>]>>;
-        }, z.core.$strip>>;
-    }, z.core.$strip>]>>>;
-}, z.core.$strip>;
-type HumeSpeechModelOptions = z.infer<typeof humeSpeechModelOptionsSchema>;
-interface HumeSpeechModelConfig extends HumeConfig {
-    _internal?: {
-        currentDate?: () => Date;
-    };
-}
-declare class HumeSpeechModel implements SpeechModelV3 {
-    readonly modelId: '';
-    private readonly config;
-    readonly specificationVersion = "v3";
-    get provider(): string;
-    constructor(modelId: '', config: HumeSpeechModelConfig);
-    private getArgs;
-    doGenerate(options: Parameters<SpeechModelV3['doGenerate']>[0]): Promise<Awaited<ReturnType<SpeechModelV3['doGenerate']>>>;
-}
-
-interface HumeProvider extends Pick<ProviderV3, 'speechModel'> {
-    (settings?: {}): {
-        speech: HumeSpeechModel;
-    };
-    /**
-     * Creates a model for speech synthesis.
-     */
-    speech(): SpeechModelV3;
-}
-interface HumeProviderSettings {
-    /**
-     * API key for authenticating requests.
-     */
-    apiKey?: string;
-    /**
-     * Custom headers to include in the requests.
-     */
-    headers?: Record<string, string>;
-    /**
-     * Custom fetch implementation. You can use it as a middleware to intercept requests,
-     * or to provide a custom fetch implementation for e.g. testing.
-     */
-    fetch?: FetchFunction;
-}
-/**
- * Create an Hume provider instance.
- */
-declare function createHume(options?: HumeProviderSettings): HumeProvider;
-/**
- * Default Hume provider instance.
- */
-declare const hume: HumeProvider;
-
-declare const VERSION: string;
-
-export { type HumeProvider, type HumeProviderSettings, type HumeSpeechModelOptions, VERSION, createHume, hume };