@contractspec/example.voice-providers 1.57.0 → 1.58.0

package/.turbo/turbo-build.log

@@ -1,47 +1,44 @@
-$ bun build:types && bun build:bundle
-$ tsc --noEmit
-$ tsdown
-ℹ tsdown v0.20.3 powered by rolldown v1.0.0-rc.3
-ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/voice-providers/tsdown.config.js 
-ℹ entry: src/connection.sample.ts, src/example.ts, src/index.ts, src/run.ts, src/handlers/create-provider.ts, src/handlers/list-voices.ts, src/handlers/synthesize.ts, src/docs/index.ts, src/docs/voice-providers.docblock.ts
-ℹ target: esnext
-ℹ tsconfig: tsconfig.json
-ℹ Build start
-ℹ dist/run.js                                3.90 kB │ gzip: 1.33 kB
-ℹ dist/docs/voice-providers.docblock.js      1.85 kB │ gzip: 0.87 kB
-ℹ dist/connection.sample.js                  1.48 kB │ gzip: 0.58 kB
-ℹ dist/handlers/create-provider.js           1.21 kB │ gzip: 0.49 kB
-ℹ dist/example.js                            0.99 kB │ gzip: 0.51 kB
-ℹ dist/index.js                              0.49 kB │ gzip: 0.20 kB
-ℹ dist/handlers/synthesize.js                0.28 kB │ gzip: 0.19 kB
-ℹ dist/handlers/list-voices.js               0.26 kB │ gzip: 0.18 kB
-ℹ dist/docs/index.js                         0.04 kB │ gzip: 0.06 kB
-ℹ dist/run.js.map                            7.18 kB │ gzip: 2.33 kB
-ℹ dist/handlers/create-provider.js.map       2.73 kB │ gzip: 0.96 kB
-ℹ dist/docs/voice-providers.docblock.js.map  2.57 kB │ gzip: 1.08 kB
-ℹ dist/connection.sample.js.map              2.28 kB │ gzip: 0.83 kB
-ℹ dist/example.js.map                        1.46 kB │ gzip: 0.70 kB
-ℹ dist/handlers/synthesize.js.map            0.76 kB │ gzip: 0.40 kB
-ℹ dist/handlers/list-voices.js.map           0.56 kB │ gzip: 0.34 kB
-ℹ dist/handlers/create-provider.d.ts.map     0.43 kB │ gzip: 0.24 kB
-ℹ dist/handlers/synthesize.d.ts.map          0.22 kB │ gzip: 0.18 kB
-ℹ dist/connection.sample.d.ts.map            0.20 kB │ gzip: 0.14 kB
-ℹ dist/handlers/list-voices.d.ts.map         0.17 kB │ gzip: 0.15 kB
-ℹ dist/example.d.ts.map                      0.13 kB │ gzip: 0.13 kB
-ℹ dist/run.d.ts.map                          0.12 kB │ gzip: 0.13 kB
-ℹ dist/handlers/create-provider.d.ts         1.05 kB │ gzip: 0.45 kB
-ℹ dist/index.d.ts                            0.69 kB │ gzip: 0.24 kB
-ℹ dist/handlers/synthesize.d.ts              0.52 kB │ gzip: 0.27 kB
-ℹ dist/connection.sample.d.ts                0.45 kB │ gzip: 0.21 kB
-ℹ dist/handlers/list-voices.d.ts             0.35 kB │ gzip: 0.23 kB
-ℹ dist/example.d.ts                          0.25 kB │ gzip: 0.17 kB
-ℹ dist/run.d.ts                              0.20 kB │ gzip: 0.16 kB
-ℹ dist/docs/index.d.ts                       0.01 kB │ gzip: 0.03 kB
-ℹ dist/docs/voice-providers.docblock.d.ts    0.01 kB │ gzip: 0.03 kB
-ℹ 31 files, total: 32.86 kB
-[PLUGIN_TIMINGS] Warning: Your build spent significant time in plugins. Here is a breakdown:
-  - tsdown:external (56%)
-  - rolldown-plugin-dts:generate (42%)
-See https://rolldown.rs/options/checks#plugintimings for more details.
+$ contractspec-bun-build prebuild
+$ bun run prebuild && bun run build:bundle && bun run build:types
+$ contractspec-bun-build prebuild
+$ contractspec-bun-build transpile
+[contractspec-bun-build] transpile target=bun root=src entries=9
+Bundled 9 modules in 40ms
 
-✔ Build complete in 21592ms
+  ./connection.sample.js             1.50 KB  (entry point)
+  ./run.js                           5.59 KB  (entry point)
+  ./index.js                         5.98 KB  (entry point)
+  docs/index.js                      1.92 KB  (entry point)
+  docs/voice-providers.docblock.js   1.92 KB  (entry point)
+  ./example.js                       0.99 KB  (entry point)
+  handlers/list-voices.js            1.40 KB  (entry point)
+  handlers/synthesize.js             1.43 KB  (entry point)
+  handlers/create-provider.js        1.27 KB  (entry point)
+
+[contractspec-bun-build] transpile target=node root=src entries=9
+Bundled 9 modules in 31ms
+
+  ./connection.sample.js             1.49 KB  (entry point)
+  ./run.js                           5.58 KB  (entry point)
+  ./index.js                         5.97 KB  (entry point)
+  docs/index.js                      1.91 KB  (entry point)
+  docs/voice-providers.docblock.js   1.91 KB  (entry point)
+  ./example.js                       0.98 KB  (entry point)
+  handlers/list-voices.js            1.40 KB  (entry point)
+  handlers/synthesize.js             1.42 KB  (entry point)
+  handlers/create-provider.js        1.26 KB  (entry point)
+
+[contractspec-bun-build] transpile target=browser root=src entries=9
+Bundled 9 modules in 26ms
+
+  ./connection.sample.js             1.49 KB  (entry point)
+  ./run.js                           5.58 KB  (entry point)
+  ./index.js                         5.97 KB  (entry point)
+  docs/index.js                      1.91 KB  (entry point)
+  docs/voice-providers.docblock.js   1.91 KB  (entry point)
+  ./example.js                       0.98 KB  (entry point)
+  handlers/list-voices.js            1.40 KB  (entry point)
+  handlers/synthesize.js             1.42 KB  (entry point)
+  handlers/create-provider.js        1.26 KB  (entry point)
+
+$ contractspec-bun-build types

package/.turbo/turbo-prebuild.log

@@ -0,0 +1 @@
+$ contractspec-bun-build prebuild

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @contractspec/example.voice-providers
 
+## 1.58.0
+
+### Minor Changes
+
+- d1f0fd0: chore: Migrate non-app package builds from tsdown to shared Bun tooling, add `@contractspec/tool.bun`, and standardize `prebuild`/`build`/`typecheck` with platform-aware exports and `tsc` declaration emission into `dist`.
+
+### Patch Changes
+
+- Updated dependencies [d1f0fd0]
+- Updated dependencies [4355a9e]
+  - @contractspec/integration.providers-impls@1.58.0
+  - @contractspec/lib.contracts@1.58.0
+
 ## 1.57.0
 
 ### Minor Changes

package/dist/browser/connection.sample.js

@@ -0,0 +1,55 @@
+// src/connection.sample.ts
+var gradiumVoiceConnection = {
+  meta: {
+    id: "conn-gradium-voice-demo",
+    tenantId: "acme-inc",
+    integrationKey: "ai-voice.gradium",
+    integrationVersion: "1.0.0",
+    label: "Gradium Voice",
+    environment: "production",
+    createdAt: "2026-01-01T00:00:00.000Z",
+    updatedAt: "2026-01-01T00:00:00.000Z"
+  },
+  ownershipMode: "byok",
+  config: {
+    defaultVoiceId: "YTpq7expH9539ERJ",
+    region: "eu",
+    outputFormat: "wav"
+  },
+  secretProvider: "vault",
+  secretRef: "vault://integrations/acme-inc/conn-gradium-voice-demo",
+  status: "connected"
+};
+var falVoiceConnection = {
+  meta: {
+    id: "conn-fal-voice-demo",
+    tenantId: "acme-inc",
+    integrationKey: "ai-voice.fal",
+    integrationVersion: "1.0.0",
+    label: "Fal Voice",
+    environment: "production",
+    createdAt: "2026-01-01T00:00:00.000Z",
+    updatedAt: "2026-01-01T00:00:00.000Z"
+  },
+  ownershipMode: "byok",
+  config: {
+    modelId: "fal-ai/chatterbox/text-to-speech",
+    defaultVoiceUrl: "https://storage.googleapis.com/chatterbox-demo-samples/prompts/male_rickmorty.mp3",
+    defaultExaggeration: 0.25,
+    defaultTemperature: 0.7,
+    defaultCfg: 0.5,
+    pollIntervalMs: 1000
+  },
+  secretProvider: "vault",
+  secretRef: "vault://integrations/acme-inc/conn-fal-voice-demo",
+  status: "connected"
+};
+var voiceSampleConnections = [
+  gradiumVoiceConnection,
+  falVoiceConnection
+];
+export {
+  voiceSampleConnections,
+  gradiumVoiceConnection,
+  falVoiceConnection
+};

package/dist/browser/docs/index.js

@@ -0,0 +1,36 @@
+// src/docs/voice-providers.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    id: "docs.examples.voice-providers",
+    title: "Voice Providers (example)",
+    summary: "Multi-provider voice integration example covering Gradium and Fal text-to-speech flows.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/examples/voice-providers",
+    tags: ["voice", "tts", "gradium", "fal", "example"],
+    body: `## What this example shows
+` + "- Provider selection for `ai-voice.gradium` and `ai-voice.fal`.\n" + `- Listing voice catalogs and synthesizing text into audio bytes.
+` + `- Connection metadata patterns for BYOK secret references.
+
+` + `## Secrets and config
+` + "- `apiKey` for each provider.\n" + "- Gradium config: `defaultVoiceId`, `region`, `outputFormat`.\n" + "- Fal config: `modelId`, `defaultVoiceUrl`, synthesis tuning fields.\n\n" + `## Guardrails
+` + `- Keep API keys in secret providers only.
+` + `- Prefer declarative provider config over hardcoded runtime options.
+` + "- Keep synthesis side effects explicit for deterministic workflows."
+  },
+  {
+    id: "docs.examples.voice-providers.usage",
+    title: "Voice Providers - Usage",
+    summary: "How to wire provider factory and synthesis helpers in runtime code.",
+    kind: "usage",
+    visibility: "public",
+    route: "/docs/examples/voice-providers/usage",
+    tags: ["voice", "usage"],
+    body: `## Usage
+` + "- Call `createVoiceProvider` with integration key, secrets, and config.\n" + "- Use `listVoices` to expose voice choices in admin/config screens.\n" + "- Use `synthesizeVoice` for message generation or workflow steps.\n\n" + `## Notes
+` + `- Fal uses an audio URL output; this example downloads bytes for a canonical result shape.
+` + "- Gradium maps provider output formats into ContractSpec voice result conventions."
+  }
+];
+registerDocBlocks(blocks);

package/dist/browser/docs/voice-providers.docblock.js

@@ -0,0 +1,36 @@
+// src/docs/voice-providers.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    id: "docs.examples.voice-providers",
+    title: "Voice Providers (example)",
+    summary: "Multi-provider voice integration example covering Gradium and Fal text-to-speech flows.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/examples/voice-providers",
+    tags: ["voice", "tts", "gradium", "fal", "example"],
+    body: `## What this example shows
+` + "- Provider selection for `ai-voice.gradium` and `ai-voice.fal`.\n" + `- Listing voice catalogs and synthesizing text into audio bytes.
+` + `- Connection metadata patterns for BYOK secret references.
+
+` + `## Secrets and config
+` + "- `apiKey` for each provider.\n" + "- Gradium config: `defaultVoiceId`, `region`, `outputFormat`.\n" + "- Fal config: `modelId`, `defaultVoiceUrl`, synthesis tuning fields.\n\n" + `## Guardrails
+` + `- Keep API keys in secret providers only.
+` + `- Prefer declarative provider config over hardcoded runtime options.
+` + "- Keep synthesis side effects explicit for deterministic workflows."
+  },
+  {
+    id: "docs.examples.voice-providers.usage",
+    title: "Voice Providers - Usage",
+    summary: "How to wire provider factory and synthesis helpers in runtime code.",
+    kind: "usage",
+    visibility: "public",
+    route: "/docs/examples/voice-providers/usage",
+    tags: ["voice", "usage"],
+    body: `## Usage
+` + "- Call `createVoiceProvider` with integration key, secrets, and config.\n" + "- Use `listVoices` to expose voice choices in admin/config screens.\n" + "- Use `synthesizeVoice` for message generation or workflow steps.\n\n" + `## Notes
+` + `- Fal uses an audio URL output; this example downloads bytes for a canonical result shape.
+` + "- Gradium maps provider output formats into ContractSpec voice result conventions."
+  }
+];
+registerDocBlocks(blocks);

package/dist/browser/example.js

@@ -0,0 +1,33 @@
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var example = defineExample({
+  meta: {
+    key: "voice-providers",
+    version: "1.0.0",
+    title: "Voice Providers (Gradium and Fal)",
+    description: "Multi-provider voice integration example for Gradium and Fal text-to-speech adapters.",
+    kind: "integration",
+    visibility: "public",
+    stability: "experimental",
+    owners: ["@platform.integrations"],
+    tags: ["voice", "tts", "gradium", "fal", "integrations"]
+  },
+  docs: {
+    rootDocId: "docs.examples.voice-providers",
+    usageDocId: "docs.examples.voice-providers.usage"
+  },
+  entrypoints: {
+    packageName: "@contractspec/example.voice-providers",
+    docs: "./docs"
+  },
+  surfaces: {
+    templates: true,
+    sandbox: { enabled: true, modes: ["markdown", "specs"] },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true }
+  }
+});
+var example_default = example;
+export {
+  example_default as default
+};

package/dist/browser/handlers/create-provider.js

@@ -0,0 +1,35 @@
+// src/handlers/create-provider.ts
+import { FalVoiceProvider } from "@contractspec/integration.providers-impls/impls/fal-voice";
+import { GradiumVoiceProvider } from "@contractspec/integration.providers-impls/impls/gradium-voice";
+function createVoiceProvider(input) {
+  const { integrationKey, secrets, config } = input;
+  if (!secrets.apiKey) {
+    throw new Error("Voice provider apiKey is required.");
+  }
+  switch (integrationKey) {
+    case "ai-voice.gradium":
+      return new GradiumVoiceProvider({
+        apiKey: secrets.apiKey,
+        defaultVoiceId: config?.defaultVoiceId,
+        region: config?.region,
+        baseUrl: config?.baseUrl,
+        timeoutMs: config?.timeoutMs,
+        outputFormat: config?.outputFormat
+      });
+    case "ai-voice.fal":
+      return new FalVoiceProvider({
+        apiKey: secrets.apiKey,
+        modelId: config?.modelId,
+        defaultVoiceUrl: config?.defaultVoiceUrl,
+        defaultExaggeration: config?.defaultExaggeration,
+        defaultTemperature: config?.defaultTemperature,
+        defaultCfg: config?.defaultCfg,
+        pollIntervalMs: config?.pollIntervalMs
+      });
+    default:
+      throw new Error(`Unsupported voice provider: ${integrationKey}`);
+  }
+}
+export {
+  createVoiceProvider
+};

package/dist/browser/handlers/list-voices.js

@@ -0,0 +1,41 @@
+// src/handlers/create-provider.ts
+import { FalVoiceProvider } from "@contractspec/integration.providers-impls/impls/fal-voice";
+import { GradiumVoiceProvider } from "@contractspec/integration.providers-impls/impls/gradium-voice";
+function createVoiceProvider(input) {
+  const { integrationKey, secrets, config } = input;
+  if (!secrets.apiKey) {
+    throw new Error("Voice provider apiKey is required.");
+  }
+  switch (integrationKey) {
+    case "ai-voice.gradium":
+      return new GradiumVoiceProvider({
+        apiKey: secrets.apiKey,
+        defaultVoiceId: config?.defaultVoiceId,
+        region: config?.region,
+        baseUrl: config?.baseUrl,
+        timeoutMs: config?.timeoutMs,
+        outputFormat: config?.outputFormat
+      });
+    case "ai-voice.fal":
+      return new FalVoiceProvider({
+        apiKey: secrets.apiKey,
+        modelId: config?.modelId,
+        defaultVoiceUrl: config?.defaultVoiceUrl,
+        defaultExaggeration: config?.defaultExaggeration,
+        defaultTemperature: config?.defaultTemperature,
+        defaultCfg: config?.defaultCfg,
+        pollIntervalMs: config?.pollIntervalMs
+      });
+    default:
+      throw new Error(`Unsupported voice provider: ${integrationKey}`);
+  }
+}
+
+// src/handlers/list-voices.ts
+async function listVoices(input) {
+  const provider = createVoiceProvider(input);
+  return provider.listVoices();
+}
+export {
+  listVoices
+};

package/dist/browser/handlers/synthesize.js

@@ -0,0 +1,41 @@
+// src/handlers/create-provider.ts
+import { FalVoiceProvider } from "@contractspec/integration.providers-impls/impls/fal-voice";
+import { GradiumVoiceProvider } from "@contractspec/integration.providers-impls/impls/gradium-voice";
+function createVoiceProvider(input) {
+  const { integrationKey, secrets, config } = input;
+  if (!secrets.apiKey) {
+    throw new Error("Voice provider apiKey is required.");
+  }
+  switch (integrationKey) {
+    case "ai-voice.gradium":
+      return new GradiumVoiceProvider({
+        apiKey: secrets.apiKey,
+        defaultVoiceId: config?.defaultVoiceId,
+        region: config?.region,
+        baseUrl: config?.baseUrl,
+        timeoutMs: config?.timeoutMs,
+        outputFormat: config?.outputFormat
+      });
+    case "ai-voice.fal":
+      return new FalVoiceProvider({
+        apiKey: secrets.apiKey,
+        modelId: config?.modelId,
+        defaultVoiceUrl: config?.defaultVoiceUrl,
+        defaultExaggeration: config?.defaultExaggeration,
+        defaultTemperature: config?.defaultTemperature,
+        defaultCfg: config?.defaultCfg,
+        pollIntervalMs: config?.pollIntervalMs
+      });
+    default:
+      throw new Error(`Unsupported voice provider: ${integrationKey}`);
+  }
+}
+
+// src/handlers/synthesize.ts
+async function synthesizeVoice(input) {
+  const provider = createVoiceProvider(input);
+  return provider.synthesize(input.synthesis);
+}
+export {
+  synthesizeVoice
+};

package/dist/browser/index.js

@@ -0,0 +1,171 @@
+// src/connection.sample.ts
+var gradiumVoiceConnection = {
+  meta: {
+    id: "conn-gradium-voice-demo",
+    tenantId: "acme-inc",
+    integrationKey: "ai-voice.gradium",
+    integrationVersion: "1.0.0",
+    label: "Gradium Voice",
+    environment: "production",
+    createdAt: "2026-01-01T00:00:00.000Z",
+    updatedAt: "2026-01-01T00:00:00.000Z"
+  },
+  ownershipMode: "byok",
+  config: {
+    defaultVoiceId: "YTpq7expH9539ERJ",
+    region: "eu",
+    outputFormat: "wav"
+  },
+  secretProvider: "vault",
+  secretRef: "vault://integrations/acme-inc/conn-gradium-voice-demo",
+  status: "connected"
+};
+var falVoiceConnection = {
+  meta: {
+    id: "conn-fal-voice-demo",
+    tenantId: "acme-inc",
+    integrationKey: "ai-voice.fal",
+    integrationVersion: "1.0.0",
+    label: "Fal Voice",
+    environment: "production",
+    createdAt: "2026-01-01T00:00:00.000Z",
+    updatedAt: "2026-01-01T00:00:00.000Z"
+  },
+  ownershipMode: "byok",
+  config: {
+    modelId: "fal-ai/chatterbox/text-to-speech",
+    defaultVoiceUrl: "https://storage.googleapis.com/chatterbox-demo-samples/prompts/male_rickmorty.mp3",
+    defaultExaggeration: 0.25,
+    defaultTemperature: 0.7,
+    defaultCfg: 0.5,
+    pollIntervalMs: 1000
+  },
+  secretProvider: "vault",
+  secretRef: "vault://integrations/acme-inc/conn-fal-voice-demo",
+  status: "connected"
+};
+var voiceSampleConnections = [
+  gradiumVoiceConnection,
+  falVoiceConnection
+];
+
+// src/docs/voice-providers.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    id: "docs.examples.voice-providers",
+    title: "Voice Providers (example)",
+    summary: "Multi-provider voice integration example covering Gradium and Fal text-to-speech flows.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/examples/voice-providers",
+    tags: ["voice", "tts", "gradium", "fal", "example"],
+    body: `## What this example shows
+` + "- Provider selection for `ai-voice.gradium` and `ai-voice.fal`.\n" + `- Listing voice catalogs and synthesizing text into audio bytes.
+` + `- Connection metadata patterns for BYOK secret references.
+
+` + `## Secrets and config
+` + "- `apiKey` for each provider.\n" + "- Gradium config: `defaultVoiceId`, `region`, `outputFormat`.\n" + "- Fal config: `modelId`, `defaultVoiceUrl`, synthesis tuning fields.\n\n" + `## Guardrails
+` + `- Keep API keys in secret providers only.
+` + `- Prefer declarative provider config over hardcoded runtime options.
+` + "- Keep synthesis side effects explicit for deterministic workflows."
+  },
+  {
+    id: "docs.examples.voice-providers.usage",
+    title: "Voice Providers - Usage",
+    summary: "How to wire provider factory and synthesis helpers in runtime code.",
+    kind: "usage",
+    visibility: "public",
+    route: "/docs/examples/voice-providers/usage",
+    tags: ["voice", "usage"],
+    body: `## Usage
+` + "- Call `createVoiceProvider` with integration key, secrets, and config.\n" + "- Use `listVoices` to expose voice choices in admin/config screens.\n" + "- Use `synthesizeVoice` for message generation or workflow steps.\n\n" + `## Notes
+` + `- Fal uses an audio URL output; this example downloads bytes for a canonical result shape.
+` + "- Gradium maps provider output formats into ContractSpec voice result conventions."
+  }
+];
+registerDocBlocks(blocks);
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var example = defineExample({
+  meta: {
+    key: "voice-providers",
+    version: "1.0.0",
+    title: "Voice Providers (Gradium and Fal)",
+    description: "Multi-provider voice integration example for Gradium and Fal text-to-speech adapters.",
+    kind: "integration",
+    visibility: "public",
+    stability: "experimental",
+    owners: ["@platform.integrations"],
+    tags: ["voice", "tts", "gradium", "fal", "integrations"]
+  },
+  docs: {
+    rootDocId: "docs.examples.voice-providers",
+    usageDocId: "docs.examples.voice-providers.usage"
+  },
+  entrypoints: {
+    packageName: "@contractspec/example.voice-providers",
+    docs: "./docs"
+  },
+  surfaces: {
+    templates: true,
+    sandbox: { enabled: true, modes: ["markdown", "specs"] },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true }
+  }
+});
+var example_default = example;
+
+// src/handlers/create-provider.ts
+import { FalVoiceProvider } from "@contractspec/integration.providers-impls/impls/fal-voice";
+import { GradiumVoiceProvider } from "@contractspec/integration.providers-impls/impls/gradium-voice";
+function createVoiceProvider(input) {
+  const { integrationKey, secrets, config } = input;
+  if (!secrets.apiKey) {
+    throw new Error("Voice provider apiKey is required.");
+  }
+  switch (integrationKey) {
+    case "ai-voice.gradium":
+      return new GradiumVoiceProvider({
+        apiKey: secrets.apiKey,
+        defaultVoiceId: config?.defaultVoiceId,
+        region: config?.region,
+        baseUrl: config?.baseUrl,
+        timeoutMs: config?.timeoutMs,
+        outputFormat: config?.outputFormat
+      });
+    case "ai-voice.fal":
+      return new FalVoiceProvider({
+        apiKey: secrets.apiKey,
+        modelId: config?.modelId,
+        defaultVoiceUrl: config?.defaultVoiceUrl,
+        defaultExaggeration: config?.defaultExaggeration,
+        defaultTemperature: config?.defaultTemperature,
+        defaultCfg: config?.defaultCfg,
+        pollIntervalMs: config?.pollIntervalMs
+      });
+    default:
+      throw new Error(`Unsupported voice provider: ${integrationKey}`);
+  }
+}
+
+// src/handlers/list-voices.ts
+async function listVoices(input) {
+  const provider = createVoiceProvider(input);
+  return provider.listVoices();
+}
+
+// src/handlers/synthesize.ts
+async function synthesizeVoice(input) {
+  const provider = createVoiceProvider(input);
+  return provider.synthesize(input.synthesis);
+}
+export {
+  voiceSampleConnections,
+  synthesizeVoice,
+  listVoices,
+  gradiumVoiceConnection,
+  falVoiceConnection,
+  example_default as example,
+  createVoiceProvider
+};