@contractspec/example.voice-providers 1.57.0 → 1.59.0

package/dist/node/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/node/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
+};

package/dist/node/run.js

@@ -0,0 +1,179 @@
+// 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);
+}
+
+// src/run.ts
+async function runVoiceProvidersExampleFromEnv() {
+  const integrationKey = resolveIntegrationKey();
+  const mode = resolveMode();
+  const dryRun = process.env.CONTRACTSPEC_VOICE_DRY_RUN === "true";
+  const config = resolveConfig(integrationKey);
+  const text = process.env.CONTRACTSPEC_VOICE_TEXT ?? "Hello from ContractSpec voice providers example.";
+  const voiceId = process.env.CONTRACTSPEC_VOICE_ID;
+  if (dryRun) {
+    return {
+      integrationKey,
+      mode,
+      dryRun,
+      text,
+      voiceId,
+      config
+    };
+  }
+  const input = {
+    integrationKey,
+    secrets: {
+      apiKey: resolveApiKey(integrationKey)
+    },
+    config
+  };
+  const output = {
+    integrationKey,
+    mode,
+    dryRun
+  };
+  if (mode === "list" || mode === "both") {
+    const voices = await listVoices(input);
+    output.voices = voices;
+  }
+  if (mode === "synthesize" || mode === "both") {
+    const result = await synthesizeVoice({
+      ...input,
+      synthesis: {
+        text,
+        voiceId
+      }
+    });
+    output.synthesis = {
+      format: result.format,
+      sampleRateHz: result.sampleRateHz,
+      bytes: result.audio.length,
+      url: result.url
+    };
+  }
+  return output;
+}
+function resolveMode() {
+  const raw = (process.env.CONTRACTSPEC_VOICE_MODE ?? "both").toLowerCase();
+  if (raw === "list" || raw === "synthesize" || raw === "both") {
+    return raw;
+  }
+  throw new Error(`Unsupported CONTRACTSPEC_VOICE_MODE: ${raw}. Use list, synthesize, or both.`);
+}
+function resolveIntegrationKey() {
+  const raw = (process.env.CONTRACTSPEC_VOICE_PROVIDER ?? "gradium").toLowerCase();
+  if (raw === "gradium")
+    return "ai-voice.gradium";
+  if (raw === "fal")
+    return "ai-voice.fal";
+  throw new Error(`Unsupported CONTRACTSPEC_VOICE_PROVIDER: ${raw}. Use gradium or fal.`);
+}
+function resolveApiKey(integrationKey) {
+  const shared = process.env.CONTRACTSPEC_VOICE_API_KEY;
+  if (shared)
+    return shared;
+  const specific = integrationKey === "ai-voice.gradium" ? process.env.GRADIUM_API_KEY : process.env.FAL_KEY;
+  if (!specific) {
+    const envName = integrationKey === "ai-voice.gradium" ? "GRADIUM_API_KEY" : "FAL_KEY";
+    throw new Error(`Missing API key. Set CONTRACTSPEC_VOICE_API_KEY or ${envName}.`);
+  }
+  return specific;
+}
+function resolveConfig(integrationKey) {
+  if (integrationKey === "ai-voice.gradium") {
+    const config = {
+      defaultVoiceId: process.env.GRADIUM_DEFAULT_VOICE_ID,
+      region: process.env.GRADIUM_REGION === "eu" || process.env.GRADIUM_REGION === "us" ? process.env.GRADIUM_REGION : undefined,
+      baseUrl: process.env.GRADIUM_BASE_URL,
+      timeoutMs: parseOptionalInt(process.env.GRADIUM_TIMEOUT_MS),
+      outputFormat: parseGradiumOutputFormat(process.env.GRADIUM_OUTPUT_FORMAT)
+    };
+    return config;
+  }
+  return {
+    modelId: process.env.FAL_MODEL_ID,
+    defaultVoiceUrl: process.env.FAL_DEFAULT_VOICE_URL,
+    defaultExaggeration: parseOptionalNumber(process.env.FAL_DEFAULT_EXAGGERATION),
+    defaultTemperature: parseOptionalNumber(process.env.FAL_DEFAULT_TEMPERATURE),
+    defaultCfg: parseOptionalNumber(process.env.FAL_DEFAULT_CFG),
+    pollIntervalMs: parseOptionalInt(process.env.FAL_POLL_INTERVAL_MS)
+  };
+}
+function parseOptionalInt(value) {
+  if (!value)
+    return;
+  const parsed = Number.parseInt(value, 10);
+  return Number.isFinite(parsed) ? parsed : undefined;
+}
+function parseOptionalNumber(value) {
+  if (!value)
+    return;
+  const parsed = Number.parseFloat(value);
+  return Number.isFinite(parsed) ? parsed : undefined;
+}
+function parseGradiumOutputFormat(value) {
+  if (!value)
+    return;
+  switch (value) {
+    case "wav":
+    case "pcm":
+    case "opus":
+    case "ulaw_8000":
+    case "alaw_8000":
+    case "pcm_16000":
+    case "pcm_24000":
+      return value;
+    default:
+      return;
+  }
+}
+runVoiceProvidersExampleFromEnv().then((result) => {
+  console.log(JSON.stringify(result, null, 2));
+}).catch((error) => {
+  console.error(error);
+  process.exitCode = 1;
+});
+export {
+  runVoiceProvidersExampleFromEnv
+};

package/dist/run.d.ts

@@ -1,5 +1,2 @@
-//#region src/run.d.ts
-declare function runVoiceProvidersExampleFromEnv(): Promise<Record<string, unknown>>;
-//#endregion
-export { runVoiceProvidersExampleFromEnv };
+export declare function runVoiceProvidersExampleFromEnv(): Promise<Record<string, unknown>>;
 //# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","names":[],"sources":["../src/run.ts"],"mappings":";iBAUsB,+BAAA,CAAA,GAA+B,OAAA,CAAA,MAAA"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAUA,wBAAsB,+BAA+B,qCAyDpD"}

package/dist/run.js

@@ -1,118 +1,180 @@
-import { listVoices } from "./handlers/list-voices.js";
-import { synthesizeVoice } from "./handlers/synthesize.js";
+// @bun
+// 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();
+}
 
-//#region src/run.ts
+// src/handlers/synthesize.ts
+async function synthesizeVoice(input) {
+  const provider = createVoiceProvider(input);
+  return provider.synthesize(input.synthesis);
+}
+
+// src/run.ts
 async function runVoiceProvidersExampleFromEnv() {
-	const integrationKey = resolveIntegrationKey();
-	const mode = resolveMode();
-	const dryRun = process.env.CONTRACTSPEC_VOICE_DRY_RUN === "true";
-	const config = resolveConfig(integrationKey);
-	const text = process.env.CONTRACTSPEC_VOICE_TEXT ?? "Hello from ContractSpec voice providers example.";
-	const voiceId = process.env.CONTRACTSPEC_VOICE_ID;
-	if (dryRun) return {
-		integrationKey,
-		mode,
-		dryRun,
-		text,
-		voiceId,
-		config
-	};
-	const input = {
-		integrationKey,
-		secrets: { apiKey: resolveApiKey(integrationKey) },
-		config
-	};
-	const output = {
-		integrationKey,
-		mode,
-		dryRun
-	};
-	if (mode === "list" || mode === "both") output.voices = await listVoices(input);
-	if (mode === "synthesize" || mode === "both") {
-		const result = await synthesizeVoice({
-			...input,
-			synthesis: {
-				text,
-				voiceId
-			}
-		});
-		output.synthesis = {
-			format: result.format,
-			sampleRateHz: result.sampleRateHz,
-			bytes: result.audio.length,
-			url: result.url
-		};
-	}
-	return output;
+  const integrationKey = resolveIntegrationKey();
+  const mode = resolveMode();
+  const dryRun = process.env.CONTRACTSPEC_VOICE_DRY_RUN === "true";
+  const config = resolveConfig(integrationKey);
+  const text = process.env.CONTRACTSPEC_VOICE_TEXT ?? "Hello from ContractSpec voice providers example.";
+  const voiceId = process.env.CONTRACTSPEC_VOICE_ID;
+  if (dryRun) {
+    return {
+      integrationKey,
+      mode,
+      dryRun,
+      text,
+      voiceId,
+      config
+    };
+  }
+  const input = {
+    integrationKey,
+    secrets: {
+      apiKey: resolveApiKey(integrationKey)
+    },
+    config
+  };
+  const output = {
+    integrationKey,
+    mode,
+    dryRun
+  };
+  if (mode === "list" || mode === "both") {
+    const voices = await listVoices(input);
+    output.voices = voices;
+  }
+  if (mode === "synthesize" || mode === "both") {
+    const result = await synthesizeVoice({
+      ...input,
+      synthesis: {
+        text,
+        voiceId
+      }
+    });
+    output.synthesis = {
+      format: result.format,
+      sampleRateHz: result.sampleRateHz,
+      bytes: result.audio.length,
+      url: result.url
+    };
+  }
+  return output;
 }
 function resolveMode() {
-	const raw = (process.env.CONTRACTSPEC_VOICE_MODE ?? "both").toLowerCase();
-	if (raw === "list" || raw === "synthesize" || raw === "both") return raw;
-	throw new Error(`Unsupported CONTRACTSPEC_VOICE_MODE: ${raw}. Use list, synthesize, or both.`);
+  const raw = (process.env.CONTRACTSPEC_VOICE_MODE ?? "both").toLowerCase();
+  if (raw === "list" || raw === "synthesize" || raw === "both") {
+    return raw;
+  }
+  throw new Error(`Unsupported CONTRACTSPEC_VOICE_MODE: ${raw}. Use list, synthesize, or both.`);
 }
 function resolveIntegrationKey() {
-	const raw = (process.env.CONTRACTSPEC_VOICE_PROVIDER ?? "gradium").toLowerCase();
-	if (raw === "gradium") return "ai-voice.gradium";
-	if (raw === "fal") return "ai-voice.fal";
-	throw new Error(`Unsupported CONTRACTSPEC_VOICE_PROVIDER: ${raw}. Use gradium or fal.`);
+  const raw = (process.env.CONTRACTSPEC_VOICE_PROVIDER ?? "gradium").toLowerCase();
+  if (raw === "gradium")
+    return "ai-voice.gradium";
+  if (raw === "fal")
+    return "ai-voice.fal";
+  throw new Error(`Unsupported CONTRACTSPEC_VOICE_PROVIDER: ${raw}. Use gradium or fal.`);
 }
 function resolveApiKey(integrationKey) {
-	const shared = process.env.CONTRACTSPEC_VOICE_API_KEY;
-	if (shared) return shared;
-	const specific = integrationKey === "ai-voice.gradium" ? process.env.GRADIUM_API_KEY : process.env.FAL_KEY;
-	if (!specific) {
-		const envName = integrationKey === "ai-voice.gradium" ? "GRADIUM_API_KEY" : "FAL_KEY";
-		throw new Error(`Missing API key. Set CONTRACTSPEC_VOICE_API_KEY or ${envName}.`);
-	}
-	return specific;
+  const shared = process.env.CONTRACTSPEC_VOICE_API_KEY;
+  if (shared)
+    return shared;
+  const specific = integrationKey === "ai-voice.gradium" ? process.env.GRADIUM_API_KEY : process.env.FAL_KEY;
+  if (!specific) {
+    const envName = integrationKey === "ai-voice.gradium" ? "GRADIUM_API_KEY" : "FAL_KEY";
+    throw new Error(`Missing API key. Set CONTRACTSPEC_VOICE_API_KEY or ${envName}.`);
+  }
+  return specific;
 }
 function resolveConfig(integrationKey) {
-	if (integrationKey === "ai-voice.gradium") return {
-		defaultVoiceId: process.env.GRADIUM_DEFAULT_VOICE_ID,
-		region: process.env.GRADIUM_REGION === "eu" || process.env.GRADIUM_REGION === "us" ? process.env.GRADIUM_REGION : void 0,
-		baseUrl: process.env.GRADIUM_BASE_URL,
-		timeoutMs: parseOptionalInt(process.env.GRADIUM_TIMEOUT_MS),
-		outputFormat: parseGradiumOutputFormat(process.env.GRADIUM_OUTPUT_FORMAT)
-	};
-	return {
-		modelId: process.env.FAL_MODEL_ID,
-		defaultVoiceUrl: process.env.FAL_DEFAULT_VOICE_URL,
-		defaultExaggeration: parseOptionalNumber(process.env.FAL_DEFAULT_EXAGGERATION),
-		defaultTemperature: parseOptionalNumber(process.env.FAL_DEFAULT_TEMPERATURE),
-		defaultCfg: parseOptionalNumber(process.env.FAL_DEFAULT_CFG),
-		pollIntervalMs: parseOptionalInt(process.env.FAL_POLL_INTERVAL_MS)
-	};
+  if (integrationKey === "ai-voice.gradium") {
+    const config = {
+      defaultVoiceId: process.env.GRADIUM_DEFAULT_VOICE_ID,
+      region: process.env.GRADIUM_REGION === "eu" || process.env.GRADIUM_REGION === "us" ? process.env.GRADIUM_REGION : undefined,
+      baseUrl: process.env.GRADIUM_BASE_URL,
+      timeoutMs: parseOptionalInt(process.env.GRADIUM_TIMEOUT_MS),
+      outputFormat: parseGradiumOutputFormat(process.env.GRADIUM_OUTPUT_FORMAT)
+    };
+    return config;
+  }
+  return {
+    modelId: process.env.FAL_MODEL_ID,
+    defaultVoiceUrl: process.env.FAL_DEFAULT_VOICE_URL,
+    defaultExaggeration: parseOptionalNumber(process.env.FAL_DEFAULT_EXAGGERATION),
+    defaultTemperature: parseOptionalNumber(process.env.FAL_DEFAULT_TEMPERATURE),
+    defaultCfg: parseOptionalNumber(process.env.FAL_DEFAULT_CFG),
+    pollIntervalMs: parseOptionalInt(process.env.FAL_POLL_INTERVAL_MS)
+  };
 }
 function parseOptionalInt(value) {
-	if (!value) return void 0;
-	const parsed = Number.parseInt(value, 10);
-	return Number.isFinite(parsed) ? parsed : void 0;
+  if (!value)
+    return;
+  const parsed = Number.parseInt(value, 10);
+  return Number.isFinite(parsed) ? parsed : undefined;
 }
 function parseOptionalNumber(value) {
-	if (!value) return void 0;
-	const parsed = Number.parseFloat(value);
-	return Number.isFinite(parsed) ? parsed : void 0;
+  if (!value)
+    return;
+  const parsed = Number.parseFloat(value);
+  return Number.isFinite(parsed) ? parsed : undefined;
 }
 function parseGradiumOutputFormat(value) {
-	if (!value) return void 0;
-	switch (value) {
-		case "wav":
-		case "pcm":
-		case "opus":
-		case "ulaw_8000":
-		case "alaw_8000":
-		case "pcm_16000":
-		case "pcm_24000": return value;
-		default: return;
-	}
+  if (!value)
+    return;
+  switch (value) {
+    case "wav":
+    case "pcm":
+    case "opus":
+    case "ulaw_8000":
+    case "alaw_8000":
+    case "pcm_16000":
+    case "pcm_24000":
+      return value;
+    default:
+      return;
+  }
 }
 runVoiceProvidersExampleFromEnv().then((result) => {
-	console.log(JSON.stringify(result, null, 2));
+  console.log(JSON.stringify(result, null, 2));
 }).catch((error) => {
-	console.error(error);
-	process.exitCode = 1;
+  console.error(error);
+  process.exitCode = 1;
 });
-
-//#endregion
-export { runVoiceProvidersExampleFromEnv };
-//# sourceMappingURL=run.js.map
+export {
+  runVoiceProvidersExampleFromEnv
+};