@alien-lobster-buffet/tts-conductor-fal 0.2.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cole Reed
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,106 @@
+# @alien-lobster-buffet/tts-conductor-fal
+
+[fal.ai](https://fal.ai) provider bindings for the
+[TTS Conductor](https://github.com/ichabodcole/tts-conductor) ecosystem.
+
+fal.ai is a **gateway fronting many TTS engines**, each with its own input and
+voice schema. This package models that as a single `fal` provider id that you
+parameterize with a `model` at construction — so the marketplace lives at
+construction time while each provider _instance_ is still one engine, fully
+honoring the conductor's `TtsProvider` contract (one `caps`, one `generate`, one
+optional `voiceCatalog`).
+
+## Install
+
+```sh
+npm install @alien-lobster-buffet/tts-conductor-core @alien-lobster-buffet/tts-conductor-fal
+```
+
+Requires a fal API key (`FAL_KEY`).
+
+## Quickstart
+
+```ts
+import { createTtsConductor } from "@alien-lobster-buffet/tts-conductor-core";
+import { falProviderFactory } from "@alien-lobster-buffet/tts-conductor-fal";
+
+const conductor = createTtsConductor({ pauseTable: {}, maxPauseSeconds: 30 });
+conductor.registerProvider(falProviderFactory);
+
+const provider = conductor.createProvider("fal", {
+  apiKey: process.env.FAL_KEY!,
+  model: "fal-ai/minimax/speech-02-hd",
+  voice: { kind: "preset", id: "Wise_Woman" },
+});
+
+const { audio, duration, providerMeta } = await conductor.generateFull(
+  "Hello there. [PAUSE:2s] Welcome.",
+  provider,
+);
+```
+
+## Starter models
+
+| `model`                            | text key | voice mechanism                                                                  | duration               |
+| ---------------------------------- | -------- | -------------------------------------------------------------------------------- | ---------------------- |
+| `fal-ai/minimax/speech-02-hd`      | `text`   | `{ kind: 'preset', id }` → `voice_setting` object                                | native (`duration_ms`) |
+| `fal-ai/gemini-3.1-flash-tts`      | `prompt` | `{ kind: 'preset', id }` (30-voice enum) or `{ kind: 'multiSpeaker', speakers }` | ffprobe                |
+| `fal-ai/chatterbox/text-to-speech` | `text`   | `{ kind: 'clone', audioUrl }` (no preset voices)                                 | ffprobe                |
+| `fal-ai/elevenlabs/tts/turbo-v2.5` | `text`   | `{ kind: 'preset', id }`                                                         | ffprobe                |
+
+Switch model and voice at construction, or vary them per call:
+
+```ts
+await provider.generate(chunk, {
+  overrides: {
+    voice: { kind: "preset", id: "Aria" },
+    params: { stability: 0.3 },
+  },
+});
+```
+
+`params` carries the model's scalar knobs (e.g. minimax `voiceSetting`, gemini
+`styleInstructions` / `temperature`, chatterbox `exaggeration` / `cfg`, 11labs
+`stability` / `similarity_boost` / `speed`). Each descriptor forwards only the
+keys it recognizes.
+
+## Voice discovery
+
+Only `fal-ai/gemini-3.1-flash-tts` exposes a `voiceCatalog` — its 30 preset
+voices are the one schema-enumerable set. minimax and elevenlabs-on-fal take a
+voice id as a free string (pass a known id), and chatterbox clones from
+`audio_url`; all three leave `voiceCatalog` undefined.
+
+```ts
+if (provider.voiceCatalog) {
+  const voices = await provider.voiceCatalog.listVoices({ search: "kore" });
+}
+```
+
+> Gemini voices carry no per-voice language metadata (the model is multilingual
+> via the `languageCode` param), so `listVoices({ language })` filters them all
+> out. Filter by `search` instead.
+
+## Cost reconciliation
+
+fal bills asynchronously. Each chunk's fal `request_id` is surfaced on the
+generation result via core's generic `providerMeta` channel — collect them from
+the final result and reconcile against fal's billing-events API:
+
+```ts
+const result = await conductor.generateFull(text, provider);
+const requestIds =
+  result.providerMeta?.map((m) => m?.request_id).filter(Boolean) ?? [];
+```
+
+## Notes
+
+- **Multi-speaker (gemini) is single-chunk / short-form for now.** fal needs the
+  full `speakers[]` on every request and the prompt's `Alias:` line-prefixes to
+  survive chunking; long multi-speaker scripts aren't supported yet.
+- fal engines don't render SSML breaks — inter-chunk pauses become stitched
+  silence segments via the core orchestrator.
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,188 @@
+import { ProviderCapabilities, TtsProviderFactory, VoiceCatalog, VoiceCatalogEntry } from "@alien-lobster-buffet/tts-conductor-core";
+
+//#region src/types.d.ts
+/**
+ * fal endpoint ids supported by this provider. Extended as models are added;
+ * each id must have a matching entry in the descriptor registry.
+ */
+type FalModelId = 'fal-ai/minimax/speech-02-hd' | 'fal-ai/gemini-3.1-flash-tts' | 'fal-ai/chatterbox/text-to-speech' | 'fal-ai/elevenlabs/tts/turbo-v2.5';
+/** One speaker in a multi-speaker request (gemini `speakers[]`). */
+interface FalSpeaker {
+  /** Alias used as a line prefix in the prompt (e.g. "Host:"). → SpeakerConfig.speaker_id */
+  speakerId: string;
+  /** A preset voice name. → SpeakerConfig.voice */
+  voiceId: string;
+}
+/**
+ * Polymorphic voice selection spanning fal's mechanisms. Object-voice (minimax
+ * `voice_setting`) is not a separate kind — it's a `preset` id that the
+ * descriptor nests into an object alongside its scalar params.
+ */
+type FalVoiceSelection = {
+  kind: 'preset';
+  id: string;
+} | {
+  kind: 'multiSpeaker';
+  speakers: FalSpeaker[];
+} | {
+  kind: 'clone';
+  audioUrl: string;
+};
+/**
+ * Normalized, model-agnostic input the provider assembles per call before a
+ * descriptor maps it onto a specific model's wire schema.
+ */
+interface CanonicalTtsInput {
+  /** Plain text for this chunk — already stripped of core's `<speak>` wrapper. */
+  text: string;
+  /** Resolved voice selection (per-call override ?? construction default). */
+  voice?: FalVoiceSelection;
+  /**
+   * Resolved model-specific scalar knobs (speed, temperature, stability, …).
+   * Opaque at this layer; each descriptor whitelists the keys it forwards, so a
+   * typo'd param is a silent no-op rather than a crash.
+   */
+  params?: Record<string, unknown>;
+}
+/**
+ * Where a model's audio lives in its fal response: a URL to fetch plus an
+ * optional mime type. All four starter models return `audio` as a fal `File`
+ * (`{ url, content_type? }`), so the provider's shared, abort-aware fetch turns
+ * this into bytes — descriptors only need to *locate* it.
+ */
+interface FalAudioLocation {
+  url: string;
+  mimeType?: string;
+}
+/**
+ * Per-model adapter. The marketplace nature of fal is localized here: one
+ * descriptor per `endpointId`, all sharing the provider's `fal.subscribe` /
+ * fetch / abort plumbing.
+ */
+interface FalModelDescriptor {
+  endpointId: FalModelId;
+  /**
+   * Per-model capabilities (incl. `maxCharsPerRequest`). fal engines don't
+   * render SSML breaks, so `maxInlineBreakSeconds` is always `null` — long
+   * pauses become stitched silence segments via the core orchestrator.
+   */
+  caps: ProviderCapabilities;
+  /** Map canonical input → this model's fal wire input (text key, voice encoding, defaults). */
+  buildInput(input: CanonicalTtsInput): Record<string, unknown>;
+  /** Locate the audio URL (+ mime) in this model's fal response. */
+  extractAudio(data: unknown): FalAudioLocation;
+  /**
+   * Pull duration (seconds) from the response when the model returns it. Only
+   * minimax does (`duration_ms`); the others omit this and let core's ffprobe
+   * derive duration.
+   */
+  extractDuration?(data: unknown): number | undefined;
+  /** Enumerable speaker list, for models that expose one. */
+  voiceCatalog?: VoiceCatalog;
+}
+//#endregion
+//#region src/descriptors/chatterbox.d.ts
+declare const chatterboxTextToSpeech: FalModelDescriptor;
+//#endregion
+//#region src/descriptors/elevenlabs.d.ts
+/**
+ * `fal-ai/elevenlabs/tts/turbo-v2.5` — the flat model: `text` key, `voice` id
+ * (default Rachel), and 11labs scalar knobs (`stability` / `similarity_boost` /
+ * `style` / `speed` / `previous_text` / `next_text` / `language_code` /
+ * `apply_text_normalization`) forwarded via `params`. `voice` is a free string
+ * with documented examples, not a schema enum, so no `voiceCatalog`. Returns
+ * `.mp3`; no duration field → core ffprobe fallback.
+ */
+declare const elevenlabsTurboV25: FalModelDescriptor;
+//#endregion
+//#region src/descriptors/flatBuildInput.d.ts
+interface FlatBuildInputOptions {
+  /** Wire key the chunk text maps to (`text` for most, `prompt` for gemini). */
+  textKey: 'text' | 'prompt';
+  /** Wire key a `preset` voice id maps to. */
+  voiceKey: string;
+  /** Static input merged in first (e.g. an output_format or default voice). */
+  defaults?: Record<string, unknown>;
+}
+/**
+ * Produces a `buildInput` for flat models — text at `textKey`, a `preset` voice
+ * id at `voiceKey`, scalar `params` merged on top. Keeps one-line ergonomics for
+ * structurally-simple models without a separate declarative code path; models
+ * with object/multi-speaker/clone voice encoding hand-write `buildInput` instead.
+ */
+declare function flatBuildInput(opts: FlatBuildInputOptions): (input: CanonicalTtsInput) => Record<string, unknown>;
+//#endregion
+//#region src/descriptors/gemini.d.ts
+/**
+ * `fal-ai/gemini-3.1-flash-tts` — uses the `prompt` key (not `text`).
+ * Single-speaker uses the `voice` enum (default Kore); multi-speaker maps the
+ * canonical `speakers` to fal `SpeakerConfig[]` (`{ speaker_id, voice }`) and
+ * omits `voice`. `style_instructions` / `language_code` / `temperature` ride
+ * `params`. No duration field → core ffprobe fallback.
+ *
+ * **Multi-speaker + chunking caveat:** fal expects every request to carry the
+ * full `speakers[]` AND the prompt to keep its `Alias:` line-prefixes. A naive
+ * length-chunker can split mid-turn, so long multi-speaker scripts are not yet
+ * supported — treat multi-speaker as single-chunk / short-form for now.
+ */
+declare const gemini31FlashTts: FalModelDescriptor;
+//#endregion
+//#region src/descriptors/minimax.d.ts
+/**
+ * `fal-ai/minimax/speech-02-hd` — object-voice. The preset voice id nests into a
+ * `voice_setting` object alongside scalar knobs (vol/speed/pitch/emotion via
+ * `params.voiceSetting`). `output_format` is forced to `url` so the response is
+ * the schema-confirmed `audio.url` fetch shape shared by all four models (hex
+ * inline bytes are a possible later optimization). minimax is the only starter
+ * model that returns a duration (`duration_ms`).
+ */
+declare const minimaxSpeech02Hd: FalModelDescriptor;
+//#endregion
+//#region src/descriptors/index.d.ts
+/** Registry of every supported fal model, keyed by its `endpointId`. */
+declare const FAL_DESCRIPTORS: Record<FalModelId, FalModelDescriptor>;
+//#endregion
+//#region src/falProvider.d.ts
+/**
+ * Construction options for the single `fal` provider id. `model` selects the
+ * engine (the marketplace lives here, at construction); the returned provider
+ * instance is bound to that one model. `voice` / `params` are per-instance
+ * defaults that per-call overrides can replace.
+ */
+interface FalProviderOptions {
+  apiKey: string;
+  model: FalModelId;
+  voice?: FalVoiceSelection;
+  params?: Record<string, unknown>;
+}
+/** Per-call overrides — vary the voice or scalar params for a single `generate`. */
+interface FalCallOverrides {
+  voice?: FalVoiceSelection;
+  params?: Record<string, unknown>;
+}
+declare module '@alien-lobster-buffet/tts-conductor-core' {
+  interface TtsProviderRegistry {
+    fal: FalProviderOptions;
+  }
+  interface TtsProviderCallOverridesRegistry {
+    fal: FalCallOverrides;
+  }
+}
+declare const falProviderFactory: TtsProviderFactory<'fal', FalCallOverrides>;
+//#endregion
+//#region src/voiceCatalog.d.ts
+/**
+ * Build a `VoiceCatalog` from a fixed list of entries, applying the
+ * cross-provider client-side filter baseline (case-insensitive substring search;
+ * language prefix-match; gender equality; custom-only). Used for fal models
+ * whose voices are a schema-enumerable set.
+ */
+declare function staticVoiceCatalog<TRaw = unknown>(entries: ReadonlyArray<VoiceCatalogEntry<TRaw>>): VoiceCatalog<TRaw>;
+/** Raw shape for a gemini voice entry — just the preset name. */
+interface GeminiRawVoice {
+  name: string;
+}
+declare const geminiVoiceCatalog: VoiceCatalog<GeminiRawVoice>;
+//#endregion
+export { type CanonicalTtsInput, FAL_DESCRIPTORS, type FalAudioLocation, type FalCallOverrides, type FalModelDescriptor, type FalModelId, type FalProviderOptions, type FalSpeaker, type FalVoiceSelection, type FlatBuildInputOptions, type GeminiRawVoice, chatterboxTextToSpeech, elevenlabsTurboV25, falProviderFactory, flatBuildInput, gemini31FlashTts, geminiVoiceCatalog, minimaxSpeech02Hd, staticVoiceCatalog };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,329 @@
+import { TtsError } from "@alien-lobster-buffet/tts-conductor-core";
+import { createFalClient } from "@fal-ai/client";
+//#region src/descriptors/shared.ts
+/**
+* Locate the audio URL (+ mime) in a fal TTS response. All four starter models
+* return `audio` as a fal `File` (`{ url, content_type? }`) when
+* `output_format` is url-based — the provider's shared fetch turns the URL into
+* bytes. Throws a {@link TtsError} if the response carries no usable `audio.url`
+* (already-classified, so the provider passes it through without re-wrapping).
+*/
+function locateAudio(data, defaultMime) {
+	const audio = data?.audio;
+	const url = typeof audio?.url === "string" ? audio.url : void 0;
+	if (!url) throw new TtsError("[fal] response did not contain an audio.url");
+	return {
+		url,
+		mimeType: typeof audio?.content_type === "string" ? audio.content_type : defaultMime
+	};
+}
+//#endregion
+//#region src/descriptors/chatterbox.ts
+/**
+* `fal-ai/chatterbox/text-to-speech` — voice cloning, no voice id. A `clone`
+* selection supplies `audio_url` (a plain URL string); omitting it lets fal use
+* its demo voice. Generation knobs (`exaggeration` / `cfg` / `temperature` /
+* `seed`) ride `params`. Returns `.wav`; no duration field → core ffprobe
+* fallback. No `voiceCatalog` — there are no enumerable speakers.
+*/
+const CHATTERBOX_PARAM_KEYS = [
+	"exaggeration",
+	"cfg",
+	"temperature",
+	"seed"
+];
+const chatterboxTextToSpeech = {
+	endpointId: "fal-ai/chatterbox/text-to-speech",
+	caps: {
+		maxInlineBreakSeconds: null,
+		maxCharsPerRequest: 5e3
+	},
+	buildInput(input) {
+		const params = input.params ?? {};
+		const wire = { text: input.text };
+		if (input.voice?.kind === "clone") wire.audio_url = input.voice.audioUrl;
+		for (const key of CHATTERBOX_PARAM_KEYS) if (params[key] !== void 0) wire[key] = params[key];
+		return wire;
+	},
+	extractAudio: (data) => locateAudio(data, "audio/wav")
+};
+//#endregion
+//#region src/descriptors/flatBuildInput.ts
+/**
+* Produces a `buildInput` for flat models — text at `textKey`, a `preset` voice
+* id at `voiceKey`, scalar `params` merged on top. Keeps one-line ergonomics for
+* structurally-simple models without a separate declarative code path; models
+* with object/multi-speaker/clone voice encoding hand-write `buildInput` instead.
+*/
+function flatBuildInput(opts) {
+	return (input) => ({
+		...opts.defaults,
+		[opts.textKey]: input.text,
+		...input.voice?.kind === "preset" ? { [opts.voiceKey]: input.voice.id } : {},
+		...input.params ?? {}
+	});
+}
+//#endregion
+//#region src/descriptors/elevenlabs.ts
+/**
+* `fal-ai/elevenlabs/tts/turbo-v2.5` — the flat model: `text` key, `voice` id
+* (default Rachel), and 11labs scalar knobs (`stability` / `similarity_boost` /
+* `style` / `speed` / `previous_text` / `next_text` / `language_code` /
+* `apply_text_normalization`) forwarded via `params`. `voice` is a free string
+* with documented examples, not a schema enum, so no `voiceCatalog`. Returns
+* `.mp3`; no duration field → core ffprobe fallback.
+*/
+const elevenlabsTurboV25 = {
+	endpointId: "fal-ai/elevenlabs/tts/turbo-v2.5",
+	caps: {
+		maxInlineBreakSeconds: null,
+		maxCharsPerRequest: 2e3
+	},
+	buildInput: flatBuildInput({
+		textKey: "text",
+		voiceKey: "voice",
+		defaults: { voice: "Rachel" }
+	}),
+	extractAudio: (data) => locateAudio(data, "audio/mpeg")
+};
+//#endregion
+//#region src/voiceCatalog.ts
+/**
+* Build a `VoiceCatalog` from a fixed list of entries, applying the
+* cross-provider client-side filter baseline (case-insensitive substring search;
+* language prefix-match; gender equality; custom-only). Used for fal models
+* whose voices are a schema-enumerable set.
+*/
+function staticVoiceCatalog(entries) {
+	return { async listVoices(query) {
+		let result = [...entries];
+		if (query?.search) {
+			const q = query.search.toLowerCase();
+			result = result.filter((v) => [
+				v.name,
+				v.description,
+				...Object.values(v.labels ?? {})
+			].filter((s) => typeof s === "string").some((s) => s.toLowerCase().includes(q)));
+		}
+		if (query?.language) {
+			const lang = query.language.toLowerCase();
+			result = result.filter((v) => v.languages.some((l) => l.toLowerCase().startsWith(lang)));
+		}
+		if (query?.gender) {
+			const g = query.gender.toLowerCase();
+			result = result.filter((v) => v.gender?.toLowerCase() === g);
+		}
+		if (query?.customOnly) result = result.filter((v) => v.custom === true);
+		return result;
+	} };
+}
+const geminiVoiceCatalog = staticVoiceCatalog([
+	"Achernar",
+	"Achird",
+	"Algenib",
+	"Algieba",
+	"Alnilam",
+	"Aoede",
+	"Autonoe",
+	"Callirrhoe",
+	"Charon",
+	"Despina",
+	"Enceladus",
+	"Erinome",
+	"Fenrir",
+	"Gacrux",
+	"Iapetus",
+	"Kore",
+	"Laomedeia",
+	"Leda",
+	"Orus",
+	"Pulcherrima",
+	"Puck",
+	"Rasalgethi",
+	"Sadachbia",
+	"Sadaltager",
+	"Schedar",
+	"Sulafat",
+	"Umbriel",
+	"Vindemiatrix",
+	"Zephyr",
+	"Zubenelgenubi"
+].map((name) => ({
+	id: name,
+	name,
+	languages: [],
+	raw: { name }
+})));
+//#endregion
+//#region src/descriptors/gemini.ts
+/**
+* `fal-ai/gemini-3.1-flash-tts` — uses the `prompt` key (not `text`).
+* Single-speaker uses the `voice` enum (default Kore); multi-speaker maps the
+* canonical `speakers` to fal `SpeakerConfig[]` (`{ speaker_id, voice }`) and
+* omits `voice`. `style_instructions` / `language_code` / `temperature` ride
+* `params`. No duration field → core ffprobe fallback.
+*
+* **Multi-speaker + chunking caveat:** fal expects every request to carry the
+* full `speakers[]` AND the prompt to keep its `Alias:` line-prefixes. A naive
+* length-chunker can split mid-turn, so long multi-speaker scripts are not yet
+* supported — treat multi-speaker as single-chunk / short-form for now.
+*/
+const gemini31FlashTts = {
+	endpointId: "fal-ai/gemini-3.1-flash-tts",
+	caps: {
+		maxInlineBreakSeconds: null,
+		maxCharsPerRequest: 5e3
+	},
+	buildInput(input) {
+		const params = input.params ?? {};
+		const wire = {
+			prompt: input.text,
+			output_format: "mp3"
+		};
+		if (params.styleInstructions !== void 0) wire.style_instructions = params.styleInstructions;
+		if (params.languageCode !== void 0) wire.language_code = params.languageCode;
+		if (params.temperature !== void 0) wire.temperature = params.temperature;
+		if (input.voice?.kind === "multiSpeaker") wire.speakers = input.voice.speakers.map((s) => ({
+			speaker_id: s.speakerId,
+			voice: s.voiceId
+		}));
+		else wire.voice = input.voice?.kind === "preset" ? input.voice.id : "Kore";
+		return wire;
+	},
+	extractAudio: (data) => locateAudio(data, "audio/mpeg"),
+	voiceCatalog: geminiVoiceCatalog
+};
+//#endregion
+//#region src/descriptors/minimax.ts
+/**
+* `fal-ai/minimax/speech-02-hd` — object-voice. The preset voice id nests into a
+* `voice_setting` object alongside scalar knobs (vol/speed/pitch/emotion via
+* `params.voiceSetting`). `output_format` is forced to `url` so the response is
+* the schema-confirmed `audio.url` fetch shape shared by all four models (hex
+* inline bytes are a possible later optimization). minimax is the only starter
+* model that returns a duration (`duration_ms`).
+*/
+const minimaxSpeech02Hd = {
+	endpointId: "fal-ai/minimax/speech-02-hd",
+	caps: {
+		maxInlineBreakSeconds: null,
+		maxCharsPerRequest: 5e3
+	},
+	buildInput(input) {
+		const params = input.params ?? {};
+		const voiceSetting = params.voiceSetting ?? {};
+		const presetId = input.voice?.kind === "preset" ? input.voice.id : void 0;
+		const wire = {
+			text: input.text,
+			voice_setting: {
+				...voiceSetting,
+				voice_id: presetId ?? voiceSetting.voice_id ?? "Wise_Woman"
+			},
+			output_format: "url"
+		};
+		if (params.audioSetting !== void 0) wire.audio_setting = params.audioSetting;
+		if (params.languageBoost !== void 0) wire.language_boost = params.languageBoost;
+		return wire;
+	},
+	extractAudio: (data) => locateAudio(data, "audio/mpeg"),
+	extractDuration(data) {
+		const ms = data.duration_ms;
+		return typeof ms === "number" ? ms / 1e3 : void 0;
+	}
+};
+//#endregion
+//#region src/descriptors/index.ts
+/** Registry of every supported fal model, keyed by its `endpointId`. */
+const FAL_DESCRIPTORS = {
+	"fal-ai/minimax/speech-02-hd": minimaxSpeech02Hd,
+	"fal-ai/gemini-3.1-flash-tts": gemini31FlashTts,
+	"fal-ai/chatterbox/text-to-speech": chatterboxTextToSpeech,
+	"fal-ai/elevenlabs/tts/turbo-v2.5": elevenlabsTurboV25
+};
+//#endregion
+//#region src/falProvider.ts
+/**
+* Remove core's `<speak>…</speak>` wrapper, which the orchestrator adds to every
+* chunk. fal engines take plain text/prompt, not SSML (and the descriptors
+* declare `maxInlineBreakSeconds: null`, so the chunker emits no `<break>` tags).
+*/
+function stripSpeak(input) {
+	return input.replace(/^\s*<speak[^>]*>/i, "").replace(/<\/speak>\s*$/i, "").trim();
+}
+function isAbortError(error) {
+	return error instanceof Error && error.name === "AbortError";
+}
+var FalProvider = class {
+	constructor(ctx, options, client) {
+		this.ctx = ctx;
+		this.options = options;
+		this.client = client;
+		this.id = ctx.id;
+		this.descriptor = FAL_DESCRIPTORS[options.model];
+		this.caps = this.descriptor.caps;
+		this.voiceCatalog = this.descriptor.voiceCatalog;
+	}
+	async generate(chunk, options) {
+		const signal = options?.signal;
+		signal?.throwIfAborted();
+		const overrides = options?.overrides;
+		const mergedParams = this.options.params || overrides?.params ? {
+			...this.options.params,
+			...overrides?.params
+		} : void 0;
+		const canonical = {
+			text: stripSpeak(chunk),
+			voice: overrides?.voice ?? this.options.voice,
+			params: mergedParams
+		};
+		const input = this.descriptor.buildInput(canonical);
+		const logger = this.ctx.config.logger;
+		logger?.info?.("[fal] subscribe start", { model: this.options.model });
+		try {
+			const result = await this.client.subscribe(this.descriptor.endpointId, {
+				input,
+				...signal ? { abortSignal: signal } : {}
+			});
+			const { url, mimeType } = this.descriptor.extractAudio(result.data);
+			const audio = await this.fetchAudio(url, signal);
+			const duration = this.descriptor.extractDuration?.(result.data);
+			logger?.info?.("[fal] generation done", {
+				model: this.options.model,
+				bytes: audio.length,
+				requestId: result.requestId
+			});
+			return {
+				audio,
+				mimeType,
+				...duration !== void 0 ? { duration } : {},
+				size: audio.length,
+				providerMeta: { request_id: result.requestId }
+			};
+		} catch (error) {
+			if (isAbortError(error)) throw error;
+			if (signal?.aborted) throw new DOMException("Aborted", "AbortError");
+			if (error instanceof TtsError) throw error;
+			const mapped = new TtsError(`fal generation failed: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+			logger?.error?.("[fal] generation error", { message: mapped.message });
+			throw mapped;
+		}
+	}
+	/** Shared, abort-aware fetch turning a model's `audio.url` into bytes. */
+	async fetchAudio(url, signal) {
+		const res = await fetch(url, signal ? { signal } : {});
+		if (!res.ok) throw new TtsError(`fal audio fetch failed (${res.status}): ${url}`, { statusCode: res.status });
+		return Buffer.from(await res.arrayBuffer());
+	}
+};
+const falProviderFactory = {
+	id: "fal",
+	create(ctx, options) {
+		if (!options.apiKey) throw new Error("fal provider requires an apiKey");
+		if (!options.model || !FAL_DESCRIPTORS[options.model]) throw new Error(`fal provider: unknown model "${options.model}"`);
+		return new FalProvider(ctx, options, createFalClient({ credentials: options.apiKey }));
+	}
+};
+//#endregion
+export { FAL_DESCRIPTORS, chatterboxTextToSpeech, elevenlabsTurboV25, falProviderFactory, flatBuildInput, gemini31FlashTts, geminiVoiceCatalog, minimaxSpeech02Hd, staticVoiceCatalog };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/descriptors/shared.ts","../src/descriptors/chatterbox.ts","../src/descriptors/flatBuildInput.ts","../src/descriptors/elevenlabs.ts","../src/voiceCatalog.ts","../src/descriptors/gemini.ts","../src/descriptors/minimax.ts","../src/descriptors/index.ts","../src/falProvider.ts"],"sourcesContent":["import { TtsError } from '@alien-lobster-buffet/tts-conductor-core';\nimport type { FalAudioLocation } from '../types';\n\n/**\n * Locate the audio URL (+ mime) in a fal TTS response. All four starter models\n * return `audio` as a fal `File` (`{ url, content_type? }`) when\n * `output_format` is url-based — the provider's shared fetch turns the URL into\n * bytes. Throws a {@link TtsError} if the response carries no usable `audio.url`\n * (already-classified, so the provider passes it through without re-wrapping).\n */\nexport function locateAudio(data: unknown, defaultMime: string): FalAudioLocation {\n  const audio = (data as { audio?: { url?: unknown; content_type?: unknown } } | null | undefined)\n    ?.audio;\n  const url = typeof audio?.url === 'string' ? audio.url : undefined;\n  if (!url) {\n    throw new TtsError('[fal] response did not contain an audio.url');\n  }\n  const mimeType = typeof audio?.content_type === 'string' ? audio.content_type : defaultMime;\n  return { url, mimeType };\n}\n","import type { FalModelDescriptor } from '../types';\nimport { locateAudio } from './shared';\n\n/**\n * `fal-ai/chatterbox/text-to-speech` — voice cloning, no voice id. A `clone`\n * selection supplies `audio_url` (a plain URL string); omitting it lets fal use\n * its demo voice. Generation knobs (`exaggeration` / `cfg` / `temperature` /\n * `seed`) ride `params`. Returns `.wav`; no duration field → core ffprobe\n * fallback. No `voiceCatalog` — there are no enumerable speakers.\n */\nconst CHATTERBOX_PARAM_KEYS = ['exaggeration', 'cfg', 'temperature', 'seed'] as const;\n\nexport const chatterboxTextToSpeech: FalModelDescriptor = {\n  endpointId: 'fal-ai/chatterbox/text-to-speech',\n  caps: { maxInlineBreakSeconds: null, maxCharsPerRequest: 5000 },\n  buildInput(input) {\n    const params = input.params ?? {};\n    const wire: Record<string, unknown> = { text: input.text };\n    if (input.voice?.kind === 'clone') wire.audio_url = input.voice.audioUrl;\n    for (const key of CHATTERBOX_PARAM_KEYS) {\n      if (params[key] !== undefined) wire[key] = params[key];\n    }\n    return wire;\n  },\n  extractAudio: (data) => locateAudio(data, 'audio/wav'),\n};\n","import type { CanonicalTtsInput } from '../types';\n\nexport interface FlatBuildInputOptions {\n  /** Wire key the chunk text maps to (`text` for most, `prompt` for gemini). */\n  textKey: 'text' | 'prompt';\n  /** Wire key a `preset` voice id maps to. */\n  voiceKey: string;\n  /** Static input merged in first (e.g. an output_format or default voice). */\n  defaults?: Record<string, unknown>;\n}\n\n/**\n * Produces a `buildInput` for flat models — text at `textKey`, a `preset` voice\n * id at `voiceKey`, scalar `params` merged on top. Keeps one-line ergonomics for\n * structurally-simple models without a separate declarative code path; models\n * with object/multi-speaker/clone voice encoding hand-write `buildInput` instead.\n */\nexport function flatBuildInput(opts: FlatBuildInputOptions) {\n  return (input: CanonicalTtsInput): Record<string, unknown> => ({\n    ...opts.defaults,\n    [opts.textKey]: input.text,\n    ...(input.voice?.kind === 'preset' ? { [opts.voiceKey]: input.voice.id } : {}),\n    ...(input.params ?? {}),\n  });\n}\n","import type { FalModelDescriptor } from '../types';\nimport { flatBuildInput } from './flatBuildInput';\nimport { locateAudio } from './shared';\n\n/**\n * `fal-ai/elevenlabs/tts/turbo-v2.5` — the flat model: `text` key, `voice` id\n * (default Rachel), and 11labs scalar knobs (`stability` / `similarity_boost` /\n * `style` / `speed` / `previous_text` / `next_text` / `language_code` /\n * `apply_text_normalization`) forwarded via `params`. `voice` is a free string\n * with documented examples, not a schema enum, so no `voiceCatalog`. Returns\n * `.mp3`; no duration field → core ffprobe fallback.\n */\nexport const elevenlabsTurboV25: FalModelDescriptor = {\n  endpointId: 'fal-ai/elevenlabs/tts/turbo-v2.5',\n  // No schema char limit; 2000 is a deliberate narration default (a bit above\n  // the direct 11labs adapter's 1200) balancing progress granularity against\n  // request count. Soft — raise per job via BuildAudioOptions.maxCharsPerRequest.\n  caps: { maxInlineBreakSeconds: null, maxCharsPerRequest: 2000 },\n  buildInput: flatBuildInput({ textKey: 'text', voiceKey: 'voice', defaults: { voice: 'Rachel' } }),\n  extractAudio: (data) => locateAudio(data, 'audio/mpeg'),\n};\n","import type {\n  VoiceCatalog,\n  VoiceCatalogEntry,\n  VoiceCatalogQuery,\n} from '@alien-lobster-buffet/tts-conductor-core';\n\n/**\n * Build a `VoiceCatalog` from a fixed list of entries, applying the\n * cross-provider client-side filter baseline (case-insensitive substring search;\n * language prefix-match; gender equality; custom-only). Used for fal models\n * whose voices are a schema-enumerable set.\n */\nexport function staticVoiceCatalog<TRaw = unknown>(\n  entries: ReadonlyArray<VoiceCatalogEntry<TRaw>>,\n): VoiceCatalog<TRaw> {\n  return {\n    async listVoices(query?: VoiceCatalogQuery): Promise<VoiceCatalogEntry<TRaw>[]> {\n      let result = [...entries];\n      if (query?.search) {\n        const q = query.search.toLowerCase();\n        result = result.filter((v) =>\n          [v.name, v.description, ...Object.values(v.labels ?? {})]\n            .filter((s): s is string => typeof s === 'string')\n            .some((s) => s.toLowerCase().includes(q)),\n        );\n      }\n      if (query?.language) {\n        const lang = query.language.toLowerCase();\n        result = result.filter((v) => v.languages.some((l) => l.toLowerCase().startsWith(lang)));\n      }\n      if (query?.gender) {\n        const g = query.gender.toLowerCase();\n        result = result.filter((v) => v.gender?.toLowerCase() === g);\n      }\n      if (query?.customOnly) {\n        result = result.filter((v) => v.custom === true);\n      }\n      return result;\n    },\n  };\n}\n\n/** Raw shape for a gemini voice entry — just the preset name. */\nexport interface GeminiRawVoice {\n  name: string;\n}\n\n/**\n * The 30 gemini-3.1-flash-tts preset voices, straight from the model's OpenAPI\n * `voice` enum (authoritative). gemini is multilingual via `language_code`\n * rather than per-voice, so `languages` is left empty.\n */\nconst GEMINI_VOICE_NAMES = [\n  'Achernar',\n  'Achird',\n  'Algenib',\n  'Algieba',\n  'Alnilam',\n  'Aoede',\n  'Autonoe',\n  'Callirrhoe',\n  'Charon',\n  'Despina',\n  'Enceladus',\n  'Erinome',\n  'Fenrir',\n  'Gacrux',\n  'Iapetus',\n  'Kore',\n  'Laomedeia',\n  'Leda',\n  'Orus',\n  'Pulcherrima',\n  'Puck',\n  'Rasalgethi',\n  'Sadachbia',\n  'Sadaltager',\n  'Schedar',\n  'Sulafat',\n  'Umbriel',\n  'Vindemiatrix',\n  'Zephyr',\n  'Zubenelgenubi',\n] as const;\n\nexport const geminiVoiceCatalog: VoiceCatalog<GeminiRawVoice> = staticVoiceCatalog(\n  GEMINI_VOICE_NAMES.map((name) => ({ id: name, name, languages: [], raw: { name } })),\n);\n","import type { FalModelDescriptor } from '../types';\nimport { geminiVoiceCatalog } from '../voiceCatalog';\nimport { locateAudio } from './shared';\n\n/**\n * `fal-ai/gemini-3.1-flash-tts` — uses the `prompt` key (not `text`).\n * Single-speaker uses the `voice` enum (default Kore); multi-speaker maps the\n * canonical `speakers` to fal `SpeakerConfig[]` (`{ speaker_id, voice }`) and\n * omits `voice`. `style_instructions` / `language_code` / `temperature` ride\n * `params`. No duration field → core ffprobe fallback.\n *\n * **Multi-speaker + chunking caveat:** fal expects every request to carry the\n * full `speakers[]` AND the prompt to keep its `Alias:` line-prefixes. A naive\n * length-chunker can split mid-turn, so long multi-speaker scripts are not yet\n * supported — treat multi-speaker as single-chunk / short-form for now.\n */\nexport const gemini31FlashTts: FalModelDescriptor = {\n  endpointId: 'fal-ai/gemini-3.1-flash-tts',\n  // Schema allows up to 50000. Default 5000 favors progress granularity and a\n  // small per-failure blast radius for narration. NB: smaller chunks mean more\n  // fal.subscribe calls → more request_ids to reconcile + more stitch seams\n  // (fal cost is ~per-request, not per-char), so long-form consumers should\n  // raise this per job via BuildAudioOptions.maxCharsPerRequest (it's a soft\n  // default, not a ceiling).\n  caps: { maxInlineBreakSeconds: null, maxCharsPerRequest: 5000 },\n  buildInput(input) {\n    const params = input.params ?? {};\n    const wire: Record<string, unknown> = {\n      prompt: input.text,\n      output_format: 'mp3',\n    };\n    if (params.styleInstructions !== undefined) wire.style_instructions = params.styleInstructions;\n    if (params.languageCode !== undefined) wire.language_code = params.languageCode;\n    if (params.temperature !== undefined) wire.temperature = params.temperature;\n\n    if (input.voice?.kind === 'multiSpeaker') {\n      wire.speakers = input.voice.speakers.map((s) => ({\n        speaker_id: s.speakerId,\n        voice: s.voiceId,\n      }));\n    } else {\n      wire.voice = input.voice?.kind === 'preset' ? input.voice.id : 'Kore';\n    }\n    return wire;\n  },\n  extractAudio: (data) => locateAudio(data, 'audio/mpeg'),\n  voiceCatalog: geminiVoiceCatalog,\n};\n","import type { FalModelDescriptor } from '../types';\nimport { locateAudio } from './shared';\n\n/**\n * `fal-ai/minimax/speech-02-hd` — object-voice. The preset voice id nests into a\n * `voice_setting` object alongside scalar knobs (vol/speed/pitch/emotion via\n * `params.voiceSetting`). `output_format` is forced to `url` so the response is\n * the schema-confirmed `audio.url` fetch shape shared by all four models (hex\n * inline bytes are a possible later optimization). minimax is the only starter\n * model that returns a duration (`duration_ms`).\n */\nexport const minimaxSpeech02Hd: FalModelDescriptor = {\n  endpointId: 'fal-ai/minimax/speech-02-hd',\n  // Schema hard limit is 5000 chars; used directly as the chunk budget.\n  caps: { maxInlineBreakSeconds: null, maxCharsPerRequest: 5000 },\n  buildInput(input) {\n    const params = input.params ?? {};\n    const voiceSetting = (params.voiceSetting as Record<string, unknown> | undefined) ?? {};\n    const presetId = input.voice?.kind === 'preset' ? input.voice.id : undefined;\n    const wire: Record<string, unknown> = {\n      text: input.text,\n      voice_setting: {\n        ...voiceSetting,\n        // The explicit canonical voice wins over a voice_id smuggled into\n        // params.voiceSetting; fall back to that, then the model default.\n        voice_id: presetId ?? voiceSetting.voice_id ?? 'Wise_Woman',\n      },\n      output_format: 'url',\n    };\n    if (params.audioSetting !== undefined) wire.audio_setting = params.audioSetting;\n    if (params.languageBoost !== undefined) wire.language_boost = params.languageBoost;\n    return wire;\n  },\n  extractAudio: (data) => locateAudio(data, 'audio/mpeg'),\n  extractDuration(data) {\n    const ms = (data as { duration_ms?: unknown }).duration_ms;\n    return typeof ms === 'number' ? ms / 1000 : undefined;\n  },\n  // minimax voice_id is a free string with documented examples (not a schema\n  // enum), so there's no authoritative list to enumerate — voiceCatalog omitted.\n};\n","import type { FalModelDescriptor, FalModelId } from '../types';\nimport { chatterboxTextToSpeech } from './chatterbox';\nimport { elevenlabsTurboV25 } from './elevenlabs';\nimport { gemini31FlashTts } from './gemini';\nimport { minimaxSpeech02Hd } from './minimax';\n\nexport { chatterboxTextToSpeech } from './chatterbox';\nexport { elevenlabsTurboV25 } from './elevenlabs';\nexport { type FlatBuildInputOptions, flatBuildInput } from './flatBuildInput';\nexport { gemini31FlashTts } from './gemini';\nexport { minimaxSpeech02Hd } from './minimax';\n\n/** Registry of every supported fal model, keyed by its `endpointId`. */\nexport const FAL_DESCRIPTORS: Record<FalModelId, FalModelDescriptor> = {\n  'fal-ai/minimax/speech-02-hd': minimaxSpeech02Hd,\n  'fal-ai/gemini-3.1-flash-tts': gemini31FlashTts,\n  'fal-ai/chatterbox/text-to-speech': chatterboxTextToSpeech,\n  'fal-ai/elevenlabs/tts/turbo-v2.5': elevenlabsTurboV25,\n};\n","import type {\n  GenerateCallOptions,\n  GenerationResult,\n  ProviderCapabilities,\n  TtsProvider,\n  TtsProviderContext,\n  TtsProviderFactory,\n  VoiceCatalog,\n} from '@alien-lobster-buffet/tts-conductor-core';\nimport { TtsError } from '@alien-lobster-buffet/tts-conductor-core';\nimport { createFalClient, type FalClient } from '@fal-ai/client';\nimport { FAL_DESCRIPTORS } from './descriptors';\nimport type { CanonicalTtsInput, FalModelDescriptor, FalModelId, FalVoiceSelection } from './types';\n\n/**\n * Construction options for the single `fal` provider id. `model` selects the\n * engine (the marketplace lives here, at construction); the returned provider\n * instance is bound to that one model. `voice` / `params` are per-instance\n * defaults that per-call overrides can replace.\n */\nexport interface FalProviderOptions {\n  apiKey: string;\n  model: FalModelId;\n  voice?: FalVoiceSelection;\n  params?: Record<string, unknown>;\n}\n\n/** Per-call overrides — vary the voice or scalar params for a single `generate`. */\nexport interface FalCallOverrides {\n  voice?: FalVoiceSelection;\n  params?: Record<string, unknown>;\n}\n\ndeclare module '@alien-lobster-buffet/tts-conductor-core' {\n  interface TtsProviderRegistry {\n    fal: FalProviderOptions;\n  }\n  interface TtsProviderCallOverridesRegistry {\n    fal: FalCallOverrides;\n  }\n}\n\n/**\n * Remove core's `<speak>…</speak>` wrapper, which the orchestrator adds to every\n * chunk. fal engines take plain text/prompt, not SSML (and the descriptors\n * declare `maxInlineBreakSeconds: null`, so the chunker emits no `<break>` tags).\n */\nfunction stripSpeak(input: string): string {\n  return input\n    .replace(/^\\s*<speak[^>]*>/i, '')\n    .replace(/<\\/speak>\\s*$/i, '')\n    .trim();\n}\n\nfunction isAbortError(error: unknown): boolean {\n  return error instanceof Error && error.name === 'AbortError';\n}\n\nclass FalProvider implements TtsProvider<FalCallOverrides> {\n  readonly id: string;\n  readonly caps: ProviderCapabilities;\n  readonly voiceCatalog?: VoiceCatalog;\n  private readonly descriptor: FalModelDescriptor;\n\n  constructor(\n    private readonly ctx: TtsProviderContext,\n    private readonly options: FalProviderOptions,\n    // Instance-local fal client — credentials are scoped to this provider, not\n    // a global singleton, so multiple providers with different keys don't race.\n    private readonly client: FalClient,\n  ) {\n    this.id = ctx.id;\n    this.descriptor = FAL_DESCRIPTORS[options.model];\n    this.caps = this.descriptor.caps;\n    this.voiceCatalog = this.descriptor.voiceCatalog;\n  }\n\n  async generate(\n    chunk: string,\n    options?: GenerateCallOptions<FalCallOverrides>,\n  ): Promise<GenerationResult> {\n    const signal = options?.signal;\n    signal?.throwIfAborted();\n\n    const overrides = options?.overrides;\n    const mergedParams =\n      this.options.params || overrides?.params\n        ? { ...this.options.params, ...overrides?.params }\n        : undefined;\n    const canonical: CanonicalTtsInput = {\n      text: stripSpeak(chunk),\n      voice: overrides?.voice ?? this.options.voice,\n      params: mergedParams,\n    };\n\n    const input = this.descriptor.buildInput(canonical);\n    const logger = this.ctx.config.logger;\n    logger?.info?.('[fal] subscribe start', { model: this.options.model });\n\n    try {\n      const result = await this.client.subscribe(this.descriptor.endpointId, {\n        input,\n        ...(signal ? { abortSignal: signal } : {}),\n      });\n\n      const { url, mimeType } = this.descriptor.extractAudio(result.data);\n      const audio = await this.fetchAudio(url, signal);\n      const duration = this.descriptor.extractDuration?.(result.data);\n\n      logger?.info?.('[fal] generation done', {\n        model: this.options.model,\n        bytes: audio.length,\n        requestId: result.requestId,\n      });\n\n      return {\n        audio,\n        mimeType,\n        ...(duration !== undefined ? { duration } : {}),\n        size: audio.length,\n        // Opaque per-chunk metadata for core; consumers reconcile fal cost from\n        // the aggregated request_ids on the final result.\n        providerMeta: { request_id: result.requestId },\n      };\n    } catch (error) {\n      // Aborts are not failures — propagate so consumers can distinguish\n      // cancellation from a real error (BullMQ workers, retry logic, etc.).\n      if (isAbortError(error)) throw error;\n      // If the call was cancelled, surface a clean AbortError rather than\n      // re-throwing whatever the SDK happened to raise after the abort — that\n      // would otherwise mislabel a real API error as a cancellation.\n      if (signal?.aborted) throw new DOMException('Aborted', 'AbortError');\n      // A TtsError raised below (e.g. a failed fetch) is already classified.\n      if (error instanceof TtsError) throw error;\n      const message = error instanceof Error ? error.message : String(error);\n      const mapped = new TtsError(`fal generation failed: ${message}`, { cause: error });\n      logger?.error?.('[fal] generation error', { message: mapped.message });\n      throw mapped;\n    }\n  }\n\n  /** Shared, abort-aware fetch turning a model's `audio.url` into bytes. */\n  private async fetchAudio(url: string, signal?: AbortSignal): Promise<Buffer> {\n    const res = await fetch(url, signal ? { signal } : {});\n    if (!res.ok) {\n      throw new TtsError(`fal audio fetch failed (${res.status}): ${url}`, {\n        statusCode: res.status,\n      });\n    }\n    return Buffer.from(await res.arrayBuffer());\n  }\n}\n\nexport const falProviderFactory: TtsProviderFactory<'fal', FalCallOverrides> = {\n  id: 'fal',\n  create(ctx: TtsProviderContext, options: FalProviderOptions) {\n    if (!options.apiKey) {\n      throw new Error('fal provider requires an apiKey');\n    }\n    if (!options.model || !FAL_DESCRIPTORS[options.model]) {\n      throw new Error(`fal provider: unknown model \"${options.model}\"`);\n    }\n    // Instance-local client — credentials scoped here, no global mutation.\n    const client = createFalClient({ credentials: options.apiKey });\n    return new FalProvider(ctx, options, client);\n  },\n};\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@alien-lobster-buffet/tts-conductor-fal",
+  "version": "0.2.0-alpha.0",
+  "description": "fal.ai provider bindings for the TTS Conductor ecosystem",
+  "keywords": [
+    "tts",
+    "fal",
+    "fal-ai",
+    "provider"
+  ],
+  "license": "MIT",
+  "author": "Cole Reed <alienlobsterbuffet.dev@gmail.com>",
+  "homepage": "https://github.com/ichabodcole/tts-conductor#readme",
+  "bugs": {
+    "url": "https://github.com/ichabodcole/tts-conductor/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ichabodcole/tts-conductor.git",
+    "directory": "packages/tts-provider-fal"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.mts"
+    }
+  },
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "clean": "tsdown --clean",
+    "dev": "tsdown --watch",
+    "prepublishOnly": "tsdown",
+    "test": "vitest --run --config ../../vitest.config.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@alien-lobster-buffet/tts-conductor-core": "^0.2.0-alpha.1"
+  },
+  "dependencies": {
+    "@fal-ai/client": "^1.10.1"
+  },
+  "devDependencies": {
+    "@alien-lobster-buffet/tts-conductor-core": "^0.2.0-alpha.1"
+  }
+}