@effect-uai/elevenlabs 0.5.2 → 0.6.0

package/dist/ElevenLabsSynthesizer.d.mts

@@ -1,5 +1,6 @@
 import { VoiceSettings } from "./codec.mjs";
 import { ElevenLabsTtsModel, ElevenLabsVoiceId } from "./models.mjs";
+import { ElevenLabsRegion } from "./region.mjs";
 import { Context, Effect, Layer, Redacted, Stream } from "effect";
 import { HttpClient } from "effect/unstable/http";
 import * as Socket from "effect/unstable/socket/Socket";
@@ -29,27 +30,31 @@ type ElevenLabsSynthesizerService = {
   readonly synthesize: (r: ElevenLabsSynthesizeRequest) => Effect.Effect<AudioBlob, AiError.AiError>;
   readonly streamSynthesis: (r: ElevenLabsSynthesizeRequest) => Stream.Stream<AudioChunk, AiError.AiError>;
   readonly streamSynthesisFrom: SpeechSynthesizerService["streamSynthesisFrom"];
+  readonly synthesizeDialogue: SpeechSynthesizerService["synthesizeDialogue"];
+  readonly streamSynthesizeDialogue: SpeechSynthesizerService["streamSynthesizeDialogue"];
 };
 declare const ElevenLabsSynthesizer_base: Context.ServiceClass<ElevenLabsSynthesizer, "@betalyra/effect-uai/providers/elevenlabs/ElevenLabsSynthesizer", ElevenLabsSynthesizerService>;
 declare class ElevenLabsSynthesizer extends ElevenLabsSynthesizer_base {}
 type Config = {
   readonly apiKey: Redacted.Redacted;
   readonly baseUrl?: string;
+  readonly region?: ElevenLabsRegion;
 };
 declare const make: (cfg: Config) => Effect.Effect<{
-  synthesize: (r: ElevenLabsSynthesizeRequest) => Effect.Effect<{
-    format: any;
-    bytes: Uint8Array<ArrayBuffer>;
-  }, AiError.AiError, never>;
-  streamSynthesis: (r: ElevenLabsSynthesizeRequest) => Stream.Stream<AudioChunk, AiError.AiError, never>;
-  streamSynthesisFrom: (textIn: any, request: any) => Stream.Stream<AudioChunk, unknown, unknown>;
+  synthesize: (r: ElevenLabsSynthesizeRequest) => Effect.Effect<any, any, never>;
+  streamSynthesis: (r: ElevenLabsSynthesizeRequest) => Stream.Stream<AudioChunk, any, never>;
+  streamSynthesisFrom: (textIn: any, request: any) => Stream.Stream<AudioChunk, any, unknown>;
+  synthesizeDialogue: (request: any) => Effect.Effect<any, any, never>;
+  streamSynthesizeDialogue: (request: any) => Stream.Stream<AudioChunk, any, never>;
 }, never, Socket.WebSocketConstructor | HttpClient.HttpClient>;
 /**
  * Layer registers `ElevenLabsSynthesizer`, the generic
- * `SpeechSynthesizer`, **and `TtsIncrementalText`** — incremental
- * text-in is wired to the realtime `/stream-input` WebSocket. Provide
- * `Socket.layerWebSocketConstructorGlobal` and an `HttpClient` Layer at
- * the call site.
+ * `SpeechSynthesizer`, the `TtsIncrementalText` marker (incremental
+ * text-in via `/stream-input` WebSocket), **and `MultiSpeakerTts`** —
+ * multi-speaker dialogue is wired to `POST /v1/text-to-dialogue`
+ * (sync) and `/v1/text-to-dialogue/stream` (chunked). Provide
+ * `Socket.layerWebSocketConstructorGlobal` and an `HttpClient` Layer
+ * at the call site.
  */
 declare const layer: (cfg: Config) => Layer.Layer<unknown, never, Socket.WebSocketConstructor | HttpClient.HttpClient>;
 //#endregion

package/dist/ElevenLabsSynthesizer.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"ElevenLabsSynthesizer.d.mts","names":[],"sources":["../src/ElevenLabsSynthesizer.ts"],"mappings":";;;;;;;;;;;;;;;;;;;KAiCY,2BAAA,GAA8B,IAAA,CAAK,uBAAA;EAAA,SACpC,KAAA,EAAO,kBAAA;EAAA,SACP,OAAA,EAAS,iBAAA;EAAA,SACT,aAAA,GAAgB,aAAA;EAAA,SAChB,IAAA;EAAA,SACA,YAAA;EAAA,SACA,QAAA;AAAA;AAAA,KAGC,4BAAA;EAAA,SACD,UAAA,GAAa,CAAA,EAAG,2BAAA,KAAgC,MAAA,CAAO,MAAA,CAAO,SAAA,EAAW,OAAA,CAAQ,OAAA;EAAA,SACjF,eAAA,GACP,CAAA,EAAG,2BAAA,KACA,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA,CAAQ,OAAA;EAAA,SAC9B,mBAAA,EAAqB,wBAAA;AAAA;AAAA,cAC/B,0BAAA;cAEY,qBAAA,SAA8B,0BAAA;AAAA,KAK/B,MAAA;EAAA,SAAoB,MAAA,EAAQ,QAAA,CAAS,QAAA;EAAA,SAAmB,OAAA;AAAA;AAAA,cAoEvD,IAAA,GAAQ,GAAA,EAAK,MAAA,KAAM,MAAA,CAAA,MAAA;;;;;;;;AAjFhC;;;;;;;AAAA,cAwGa,KAAA,GAAS,GAAA,EAAK,MAAA,KAAM,KAAA,CAAA,KAAA,iBAAA,MAAA,CAAA,oBAAA,GAAA,UAAA,CAAA,UAAA"}
+{"version":3,"file":"ElevenLabsSynthesizer.d.mts","names":[],"sources":["../src/ElevenLabsSynthesizer.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;KAqCY,2BAAA,GAA8B,IAAA,CAAK,uBAAA;EAAA,SACpC,KAAA,EAAO,kBAAA;EAAA,SACP,OAAA,EAAS,iBAAA;EAAA,SACT,aAAA,GAAgB,aAAA;EAAA,SAChB,IAAA;EAAA,SACA,YAAA;EAAA,SACA,QAAA;AAAA;AAAA,KAGC,4BAAA;EAAA,SACD,UAAA,GAAa,CAAA,EAAG,2BAAA,KAAgC,MAAA,CAAO,MAAA,CAAO,SAAA,EAAW,OAAA,CAAQ,OAAA;EAAA,SACjF,eAAA,GACP,CAAA,EAAG,2BAAA,KACA,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA,CAAQ,OAAA;EAAA,SAC9B,mBAAA,EAAqB,wBAAA;EAAA,SACrB,kBAAA,EAAoB,wBAAA;EAAA,SACpB,wBAAA,EAA0B,wBAAA;AAAA;AAAA,cACpC,0BAAA;cAEY,qBAAA,SAA8B,0BAAA;AAAA,KAK/B,MAAA;EAAA,SACD,MAAA,EAAQ,QAAA,CAAS,QAAA;EAAA,SACjB,OAAA;EAAA,SACA,MAAA,GAAS,gBAAA;AAAA;AAAA,cA+KP,IAAA,GAAQ,GAAA,EAAK,MAAA,KAAM,MAAA,CAAA,MAAA;;;;;;;;;;;;;;;;cAiCnB,KAAA,GAAS,GAAA,EAAK,MAAA,KAAM,KAAA,CAAA,KAAA,iBAAA,MAAA,CAAA,oBAAA,GAAA,UAAA,CAAA,UAAA"}

package/dist/ElevenLabsSynthesizer.mjs

@@ -1,10 +1,11 @@
 import { n as __exportAll } from "./chunk-uyGKjUfl.mjs";
 import { defaultFormat, formatToOutputSlug, httpStatusError, transportFailure, wireVoiceSettings } from "./codec.mjs";
+import { resolveHost } from "./region.mjs";
 import { streamSynthesis } from "./realtimeTts.mjs";
-import { Context, Effect, Layer, Redacted, Stream } from "effect";
+import { Array, Context, Effect, Layer, Redacted, Stream } from "effect";
 import { HttpClient, HttpClientRequest } from "effect/unstable/http";
 import * as Socket from "effect/unstable/socket/Socket";
-import { SpeechSynthesizer, TtsIncrementalText } from "@effect-uai/core/SpeechSynthesizer";
+import { MultiSpeakerTts, SpeechSynthesizer, TtsIncrementalText } from "@effect-uai/core/SpeechSynthesizer";
 //#region src/ElevenLabsSynthesizer.ts
 var ElevenLabsSynthesizer_exports = /* @__PURE__ */ __exportAll({
 	ElevenLabsSynthesizer: () => ElevenLabsSynthesizer,
@@ -12,8 +13,37 @@ var ElevenLabsSynthesizer_exports = /* @__PURE__ */ __exportAll({
 	make: () => make
 });
 var ElevenLabsSynthesizer = class extends Context.Service()("@betalyra/effect-uai/providers/elevenlabs/ElevenLabsSynthesizer") {};
+/**
+* Models that honor inline `<phoneme>` SSML tags. Other models silently
+* drop the tags server-side, so we don't bother rewriting the text for
+* them — the pronunciation overrides are silently ignored.
+*
+* Reference: https://elevenlabs.io/docs/best-practices/prompting/controls
+*/
+const PHONEME_SUPPORTED_MODELS = new Set([
+	"eleven_flash_v2",
+	"eleven_english_v1",
+	"eleven_monolingual_v1"
+]);
+const wireAlphabet = (encoding) => encoding === "ipa" ? "ipa" : encoding === "cmu-arpabet" ? "cmu-arpabet" : void 0;
+const phonemeTag = (phrase, pronunciation, alphabet) => `<phoneme alphabet="${alphabet}" ph="${pronunciation}">${phrase}</phoneme>`;
+const escapeForRegex = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+/**
+* Apply pronunciation overrides to a text string. Only applies for
+* phoneme-supported models; only IPA and CMU Arpabet are honored
+* (x-sampa is silently dropped). Whole-word, case-insensitive
+* replacement.
+*/
+const applyPronunciations = (text, model, pronunciations) => {
+	if (pronunciations === void 0 || !PHONEME_SUPPORTED_MODELS.has(model)) return text;
+	return Array.reduce(pronunciations, text, (acc, p) => {
+		const alphabet = wireAlphabet(p.encoding);
+		if (alphabet === void 0) return acc;
+		return acc.replace(new RegExp(`\\b${escapeForRegex(p.phrase)}\\b`, "i"), phonemeTag(p.phrase, p.pronunciation, alphabet));
+	});
+};
 const buildBody = (r) => ({
-	text: r.text,
+	text: applyPronunciations(r.text, r.model, r.pronunciations),
 	model_id: r.model,
 	...r.languageCode !== void 0 && { language_code: r.languageCode },
 	...r.seed !== void 0 && { seed: r.seed },
@@ -21,11 +51,52 @@ const buildBody = (r) => ({
 	...r.nextText !== void 0 && { next_text: r.nextText },
 	...r.voiceSettings !== void 0 && { voice_settings: wireVoiceSettings(r.voiceSettings) }
 });
-const baseUrl = (cfg) => cfg.baseUrl ?? "https://api.elevenlabs.io/v1";
+const DEFAULT_DIALOGUE_MODEL = "eleven_v3";
+const buildDialogueBody = (r) => ({
+	inputs: r.turns.map((t) => ({
+		voice_id: t.voiceId,
+		text: applyPronunciations(t.text, r.model, r.pronunciations)
+	})),
+	model_id: r.model ?? DEFAULT_DIALOGUE_MODEL,
+	...r.languageCode !== void 0 && { language_code: r.languageCode }
+});
+const buildDialogueHttpRequest = (cfg, r, path) => Effect.gen(function* () {
+	const format = r.outputFormat ?? defaultFormat;
+	const slug = yield* formatToOutputSlug(format);
+	const url = `${resolveHost(cfg)}/text-to-dialogue${path}?output_format=${slug}`;
+	return {
+		httpRequest: HttpClientRequest.post(url).pipe(HttpClientRequest.setHeader("xi-api-key", Redacted.value(cfg.apiKey)), HttpClientRequest.bodyJsonUnsafe(buildDialogueBody(r))),
+		format
+	};
+});
+const synthesizeDialogueImpl = (cfg) => (request) => Effect.gen(function* () {
+	const client = yield* HttpClient.HttpClient;
+	const { httpRequest, format } = yield* buildDialogueHttpRequest(cfg, request, "");
+	const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure));
+	if (response.status >= 400) {
+		const text = yield* response.text.pipe(Effect.orElseSucceed(() => ""));
+		return yield* Effect.fail(httpStatusError(response.status, text));
+	}
+	const bytes = yield* response.arrayBuffer.pipe(Effect.mapError(transportFailure));
+	return {
+		format,
+		bytes: new Uint8Array(bytes)
+	};
+});
+const streamSynthesizeDialogueImpl = (cfg) => (request) => Stream.unwrap(Effect.gen(function* () {
+	const client = yield* HttpClient.HttpClient;
+	const { httpRequest } = yield* buildDialogueHttpRequest(cfg, request, "/stream");
+	const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure));
+	if (response.status >= 400) {
+		const text = yield* response.text.pipe(Effect.orElseSucceed(() => ""));
+		return Stream.fail(httpStatusError(response.status, text));
+	}
+	return response.stream.pipe(Stream.mapError(transportFailure), Stream.map((bytes) => ({ bytes })));
+}));
 const buildHttpRequest = (cfg, r, path) => Effect.gen(function* () {
 	const format = r.outputFormat ?? defaultFormat;
 	const slug = yield* formatToOutputSlug(format);
-	const url = `${baseUrl(cfg)}/text-to-speech/${r.voiceId}${path}?output_format=${slug}`;
+	const url = `${resolveHost(cfg)}/text-to-speech/${r.voiceId}${path}?output_format=${slug}`;
 	return {
 		httpRequest: HttpClientRequest.post(url).pipe(HttpClientRequest.setHeader("xi-api-key", Redacted.value(cfg.apiKey)), HttpClientRequest.bodyJsonUnsafe(buildBody(r))),
 		format
@@ -61,21 +132,27 @@ const make = (cfg) => Effect.gen(function* () {
 	return {
 		synthesize: (r) => synthesizeImpl(cfg)(r).pipe(Effect.provideService(HttpClient.HttpClient, client)),
 		streamSynthesis: (r) => streamSynthesisImpl(cfg)(r).pipe(Stream.provideService(HttpClient.HttpClient, client)),
-		streamSynthesisFrom: (textIn, request) => streamSynthesis(cfg)(textIn, request).pipe(Stream.provideService(Socket.WebSocketConstructor, ctor))
+		streamSynthesisFrom: (textIn, request) => streamSynthesis(cfg)(textIn, request).pipe(Stream.provideService(Socket.WebSocketConstructor, ctor)),
+		synthesizeDialogue: (request) => synthesizeDialogueImpl(cfg)(request).pipe(Effect.provideService(HttpClient.HttpClient, client)),
+		streamSynthesizeDialogue: (request) => streamSynthesizeDialogueImpl(cfg)(request).pipe(Stream.provideService(HttpClient.HttpClient, client))
 	};
 });
 /**
 * Layer registers `ElevenLabsSynthesizer`, the generic
-* `SpeechSynthesizer`, **and `TtsIncrementalText`** — incremental
-* text-in is wired to the realtime `/stream-input` WebSocket. Provide
-* `Socket.layerWebSocketConstructorGlobal` and an `HttpClient` Layer at
-* the call site.
+* `SpeechSynthesizer`, the `TtsIncrementalText` marker (incremental
+* text-in via `/stream-input` WebSocket), **and `MultiSpeakerTts`** —
+* multi-speaker dialogue is wired to `POST /v1/text-to-dialogue`
+* (sync) and `/v1/text-to-dialogue/stream` (chunked). Provide
+* `Socket.layerWebSocketConstructorGlobal` and an `HttpClient` Layer
+* at the call site.
 */
 const layer = (cfg) => Layer.mergeAll(Layer.effect(ElevenLabsSynthesizer, make(cfg)), Layer.effect(SpeechSynthesizer, Effect.map(make(cfg), (s) => ({
 	synthesize: (req) => s.synthesize(req),
 	streamSynthesis: (req) => s.streamSynthesis(req),
-	streamSynthesisFrom: (textIn, req) => s.streamSynthesisFrom(textIn, req)
-}))), Layer.succeed(TtsIncrementalText, void 0));
+	streamSynthesisFrom: (textIn, req) => s.streamSynthesisFrom(textIn, req),
+	synthesizeDialogue: s.synthesizeDialogue,
+	streamSynthesizeDialogue: s.streamSynthesizeDialogue
+}))), Layer.succeed(TtsIncrementalText, void 0), Layer.succeed(MultiSpeakerTts, void 0));
 //#endregion
 export { ElevenLabsSynthesizer, layer, make, ElevenLabsSynthesizer_exports as t };
 

package/dist/ElevenLabsSynthesizer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ElevenLabsSynthesizer.mjs","names":["realtimeStream"],"sources":["../src/ElevenLabsSynthesizer.ts"],"sourcesContent":["import { Context, Effect, Layer, Redacted, Stream } from \"effect\"\nimport { HttpClient, HttpClientRequest } from \"effect/unstable/http\"\nimport * as Socket from \"effect/unstable/socket/Socket\"\nimport type * as AiError from \"@effect-uai/core/AiError\"\nimport type { AudioBlob, AudioChunk } from \"@effect-uai/core/Audio\"\nimport {\n  type CommonStreamSynthesizeRequest,\n  type CommonSynthesizeRequest,\n  SpeechSynthesizer,\n  type SpeechSynthesizerService,\n  TtsIncrementalText,\n} from \"@effect-uai/core/SpeechSynthesizer\"\nimport {\n  defaultFormat,\n  formatToOutputSlug,\n  httpStatusError,\n  transportFailure,\n  type VoiceSettings,\n  wireVoiceSettings,\n} from \"./codec.js\"\nimport type { ElevenLabsTtsModel, ElevenLabsVoiceId } from \"./models.js\"\nimport { streamSynthesis as realtimeStream } from \"./realtimeTts.js\"\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\n/**\n * ElevenLabs-typed synthesize request. `voiceSettings` exposes the\n * provider's prosody/timbre controls; `seed` makes generation\n * deterministic; `previousText` / `nextText` thread context across\n * sequential calls for natural prosody.\n */\nexport type ElevenLabsSynthesizeRequest = Omit<CommonSynthesizeRequest, \"model\" | \"voiceId\"> & {\n  readonly model: ElevenLabsTtsModel\n  readonly voiceId: ElevenLabsVoiceId\n  readonly voiceSettings?: VoiceSettings\n  readonly seed?: number\n  readonly previousText?: string\n  readonly nextText?: string\n}\n\nexport type ElevenLabsSynthesizerService = {\n  readonly synthesize: (r: ElevenLabsSynthesizeRequest) => Effect.Effect<AudioBlob, AiError.AiError>\n  readonly streamSynthesis: (\n    r: ElevenLabsSynthesizeRequest,\n  ) => Stream.Stream<AudioChunk, AiError.AiError>\n  readonly streamSynthesisFrom: SpeechSynthesizerService[\"streamSynthesisFrom\"]\n}\n\nexport class ElevenLabsSynthesizer extends Context.Service<\n  ElevenLabsSynthesizer,\n  ElevenLabsSynthesizerService\n>()(\"@betalyra/effect-uai/providers/elevenlabs/ElevenLabsSynthesizer\") {}\n\nexport type Config = { readonly apiKey: Redacted.Redacted; readonly baseUrl?: string }\n\n// ---------------------------------------------------------------------------\n// Codec — request → JSON body\n// ---------------------------------------------------------------------------\n\nconst buildBody = (r: ElevenLabsSynthesizeRequest) => ({\n  text: r.text,\n  model_id: r.model,\n  ...(r.languageCode !== undefined && { language_code: r.languageCode }),\n  ...(r.seed !== undefined && { seed: r.seed }),\n  ...(r.previousText !== undefined && { previous_text: r.previousText }),\n  ...(r.nextText !== undefined && { next_text: r.nextText }),\n  ...(r.voiceSettings !== undefined && { voice_settings: wireVoiceSettings(r.voiceSettings) }),\n})\n\n// ---------------------------------------------------------------------------\n// HTTP plumbing (sync + chunked-HTTP streaming)\n// ---------------------------------------------------------------------------\n\nconst baseUrl = (cfg: Config) => cfg.baseUrl ?? \"https://api.elevenlabs.io/v1\"\n\nconst buildHttpRequest = (cfg: Config, r: ElevenLabsSynthesizeRequest, path: \"\" | \"/stream\") =>\n  Effect.gen(function* () {\n    const format = r.outputFormat ?? defaultFormat\n    const slug = yield* formatToOutputSlug(format)\n    const url = `${baseUrl(cfg)}/text-to-speech/${r.voiceId}${path}?output_format=${slug}`\n    const httpRequest = HttpClientRequest.post(url).pipe(\n      HttpClientRequest.setHeader(\"xi-api-key\", Redacted.value(cfg.apiKey)),\n      HttpClientRequest.bodyJsonUnsafe(buildBody(r)),\n    )\n    return { httpRequest, format }\n  })\n\nconst synthesizeImpl = (cfg: Config) => (request: ElevenLabsSynthesizeRequest) =>\n  Effect.gen(function* () {\n    const client = yield* HttpClient.HttpClient\n    const { httpRequest, format } = yield* buildHttpRequest(cfg, request, \"\")\n    const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure))\n    if (response.status >= 400) {\n      const text = yield* response.text.pipe(Effect.orElseSucceed(() => \"\"))\n      return yield* Effect.fail(httpStatusError(response.status, text))\n    }\n    const bytes = yield* response.arrayBuffer.pipe(Effect.mapError(transportFailure))\n    return { format, bytes: new Uint8Array(bytes) } satisfies AudioBlob\n  })\n\nconst streamSynthesisImpl = (cfg: Config) => (request: ElevenLabsSynthesizeRequest) =>\n  Stream.unwrap(\n    Effect.gen(function* () {\n      const client = yield* HttpClient.HttpClient\n      const { httpRequest } = yield* buildHttpRequest(cfg, request, \"/stream\")\n      const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure))\n      if (response.status >= 400) {\n        const text = yield* response.text.pipe(Effect.orElseSucceed(() => \"\"))\n        return Stream.fail(httpStatusError(response.status, text))\n      }\n      return response.stream.pipe(\n        Stream.mapError(transportFailure),\n        Stream.map((bytes): AudioChunk => ({ bytes })),\n      )\n    }),\n  )\n\n// ---------------------------------------------------------------------------\n// Constructors\n// ---------------------------------------------------------------------------\n\nexport const make = (cfg: Config) =>\n  Effect.gen(function* () {\n    const client = yield* HttpClient.HttpClient\n    const ctor = yield* Socket.WebSocketConstructor\n    return {\n      synthesize: (r) =>\n        synthesizeImpl(cfg)(r).pipe(Effect.provideService(HttpClient.HttpClient, client)),\n      streamSynthesis: (r) =>\n        streamSynthesisImpl(cfg)(r).pipe(Stream.provideService(HttpClient.HttpClient, client)),\n      streamSynthesisFrom: (textIn, request) =>\n        realtimeStream(cfg)(textIn, request as ElevenLabsSynthesizeRequest).pipe(\n          Stream.provideService(Socket.WebSocketConstructor, ctor),\n        ),\n    } satisfies ElevenLabsSynthesizerService\n  })\n\n/**\n * Layer registers `ElevenLabsSynthesizer`, the generic\n * `SpeechSynthesizer`, **and `TtsIncrementalText`** — incremental\n * text-in is wired to the realtime `/stream-input` WebSocket. Provide\n * `Socket.layerWebSocketConstructorGlobal` and an `HttpClient` Layer at\n * the call site.\n */\nexport const layer = (cfg: Config) =>\n  Layer.mergeAll(\n    Layer.effect(ElevenLabsSynthesizer, make(cfg)),\n    Layer.effect(\n      SpeechSynthesizer,\n      Effect.map(\n        make(cfg),\n        (s): SpeechSynthesizerService => ({\n          synthesize: (req: CommonSynthesizeRequest) =>\n            s.synthesize(req as ElevenLabsSynthesizeRequest),\n          streamSynthesis: (req: CommonSynthesizeRequest) =>\n            s.streamSynthesis(req as ElevenLabsSynthesizeRequest),\n          streamSynthesisFrom: (textIn, req: CommonStreamSynthesizeRequest) =>\n            s.streamSynthesisFrom(textIn, req),\n        }),\n      ),\n    ),\n    Layer.succeed(TtsIncrementalText, undefined),\n  )\n"],"mappings":"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"}
+{"version":3,"file":"ElevenLabsSynthesizer.mjs","names":["Arr","realtimeStream"],"sources":["../src/ElevenLabsSynthesizer.ts"],"sourcesContent":["import { Array as Arr, Context, Effect, Layer, Redacted, Stream } from \"effect\"\nimport { HttpClient, HttpClientRequest } from \"effect/unstable/http\"\nimport * as Socket from \"effect/unstable/socket/Socket\"\nimport type * as AiError from \"@effect-uai/core/AiError\"\nimport type { AudioBlob, AudioChunk } from \"@effect-uai/core/Audio\"\nimport {\n  type CommonStreamSynthesizeRequest,\n  type CommonSynthesizeDialogueRequest,\n  type CommonSynthesizeRequest,\n  type CustomPronunciation,\n  MultiSpeakerTts,\n  SpeechSynthesizer,\n  type SpeechSynthesizerService,\n  TtsIncrementalText,\n} from \"@effect-uai/core/SpeechSynthesizer\"\nimport {\n  defaultFormat,\n  formatToOutputSlug,\n  httpStatusError,\n  transportFailure,\n  type VoiceSettings,\n  wireVoiceSettings,\n} from \"./codec.js\"\nimport type { ElevenLabsTtsModel, ElevenLabsVoiceId } from \"./models.js\"\nimport { streamSynthesis as realtimeStream } from \"./realtimeTts.js\"\nimport { type ElevenLabsRegion, resolveHost } from \"./region.js\"\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\n/**\n * ElevenLabs-typed synthesize request. `voiceSettings` exposes the\n * provider's prosody/timbre controls; `seed` makes generation\n * deterministic; `previousText` / `nextText` thread context across\n * sequential calls for natural prosody.\n */\nexport type ElevenLabsSynthesizeRequest = Omit<CommonSynthesizeRequest, \"model\" | \"voiceId\"> & {\n  readonly model: ElevenLabsTtsModel\n  readonly voiceId: ElevenLabsVoiceId\n  readonly voiceSettings?: VoiceSettings\n  readonly seed?: number\n  readonly previousText?: string\n  readonly nextText?: string\n}\n\nexport type ElevenLabsSynthesizerService = {\n  readonly synthesize: (r: ElevenLabsSynthesizeRequest) => Effect.Effect<AudioBlob, AiError.AiError>\n  readonly streamSynthesis: (\n    r: ElevenLabsSynthesizeRequest,\n  ) => Stream.Stream<AudioChunk, AiError.AiError>\n  readonly streamSynthesisFrom: SpeechSynthesizerService[\"streamSynthesisFrom\"]\n  readonly synthesizeDialogue: SpeechSynthesizerService[\"synthesizeDialogue\"]\n  readonly streamSynthesizeDialogue: SpeechSynthesizerService[\"streamSynthesizeDialogue\"]\n}\n\nexport class ElevenLabsSynthesizer extends Context.Service<\n  ElevenLabsSynthesizer,\n  ElevenLabsSynthesizerService\n>()(\"@betalyra/effect-uai/providers/elevenlabs/ElevenLabsSynthesizer\") {}\n\nexport type Config = {\n  readonly apiKey: Redacted.Redacted\n  readonly baseUrl?: string\n  readonly region?: ElevenLabsRegion\n}\n\n// ---------------------------------------------------------------------------\n// Pronunciations — SSML <phoneme> rewrite (gated to legacy models)\n// ---------------------------------------------------------------------------\n\n/**\n * Models that honor inline `<phoneme>` SSML tags. Other models silently\n * drop the tags server-side, so we don't bother rewriting the text for\n * them — the pronunciation overrides are silently ignored.\n *\n * Reference: https://elevenlabs.io/docs/best-practices/prompting/controls\n */\nconst PHONEME_SUPPORTED_MODELS: ReadonlySet<string> = new Set([\n  \"eleven_flash_v2\",\n  \"eleven_english_v1\",\n  \"eleven_monolingual_v1\",\n])\n\nconst wireAlphabet = (encoding: CustomPronunciation[\"encoding\"]): string | undefined =>\n  encoding === \"ipa\" ? \"ipa\" : encoding === \"cmu-arpabet\" ? \"cmu-arpabet\" : undefined\n\nconst phonemeTag = (phrase: string, pronunciation: string, alphabet: string): string =>\n  `<phoneme alphabet=\"${alphabet}\" ph=\"${pronunciation}\">${phrase}</phoneme>`\n\nconst escapeForRegex = (s: string): string => s.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\")\n\n/**\n * Apply pronunciation overrides to a text string. Only applies for\n * phoneme-supported models; only IPA and CMU Arpabet are honored\n * (x-sampa is silently dropped). Whole-word, case-insensitive\n * replacement.\n */\nconst applyPronunciations = (\n  text: string,\n  model: string,\n  pronunciations: ReadonlyArray<CustomPronunciation> | undefined,\n): string => {\n  if (pronunciations === undefined || !PHONEME_SUPPORTED_MODELS.has(model)) return text\n  return Arr.reduce(pronunciations, text, (acc, p) => {\n    const alphabet = wireAlphabet(p.encoding)\n    if (alphabet === undefined) return acc\n    return acc.replace(\n      new RegExp(`\\\\b${escapeForRegex(p.phrase)}\\\\b`, \"i\"),\n      phonemeTag(p.phrase, p.pronunciation, alphabet),\n    )\n  })\n}\n\n// ---------------------------------------------------------------------------\n// Codec — request → JSON body\n// ---------------------------------------------------------------------------\n\nconst buildBody = (r: ElevenLabsSynthesizeRequest) => ({\n  text: applyPronunciations(r.text, r.model, r.pronunciations),\n  model_id: r.model,\n  ...(r.languageCode !== undefined && { language_code: r.languageCode }),\n  ...(r.seed !== undefined && { seed: r.seed }),\n  ...(r.previousText !== undefined && { previous_text: r.previousText }),\n  ...(r.nextText !== undefined && { next_text: r.nextText }),\n  ...(r.voiceSettings !== undefined && { voice_settings: wireVoiceSettings(r.voiceSettings) }),\n})\n\n// ---------------------------------------------------------------------------\n// Dialogue — POST /v1/text-to-dialogue (+ /stream variant)\n// ---------------------------------------------------------------------------\n\nconst DEFAULT_DIALOGUE_MODEL = \"eleven_v3\"\n\nconst buildDialogueBody = (r: CommonSynthesizeDialogueRequest) => ({\n  inputs: r.turns.map((t) => ({\n    voice_id: t.voiceId,\n    text: applyPronunciations(t.text, r.model, r.pronunciations),\n  })),\n  model_id: r.model ?? DEFAULT_DIALOGUE_MODEL,\n  ...(r.languageCode !== undefined && { language_code: r.languageCode }),\n})\n\nconst buildDialogueHttpRequest = (\n  cfg: Config,\n  r: CommonSynthesizeDialogueRequest,\n  path: \"\" | \"/stream\",\n) =>\n  Effect.gen(function* () {\n    const format = r.outputFormat ?? defaultFormat\n    const slug = yield* formatToOutputSlug(format)\n    const url = `${resolveHost(cfg)}/text-to-dialogue${path}?output_format=${slug}`\n    const httpRequest = HttpClientRequest.post(url).pipe(\n      HttpClientRequest.setHeader(\"xi-api-key\", Redacted.value(cfg.apiKey)),\n      HttpClientRequest.bodyJsonUnsafe(buildDialogueBody(r)),\n    )\n    return { httpRequest, format }\n  })\n\nconst synthesizeDialogueImpl = (cfg: Config) => (request: CommonSynthesizeDialogueRequest) =>\n  Effect.gen(function* () {\n    const client = yield* HttpClient.HttpClient\n    const { httpRequest, format } = yield* buildDialogueHttpRequest(cfg, request, \"\")\n    const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure))\n    if (response.status >= 400) {\n      const text = yield* response.text.pipe(Effect.orElseSucceed(() => \"\"))\n      return yield* Effect.fail(httpStatusError(response.status, text))\n    }\n    const bytes = yield* response.arrayBuffer.pipe(Effect.mapError(transportFailure))\n    return { format, bytes: new Uint8Array(bytes) } satisfies AudioBlob\n  })\n\nconst streamSynthesizeDialogueImpl = (cfg: Config) => (request: CommonSynthesizeDialogueRequest) =>\n  Stream.unwrap(\n    Effect.gen(function* () {\n      const client = yield* HttpClient.HttpClient\n      const { httpRequest } = yield* buildDialogueHttpRequest(cfg, request, \"/stream\")\n      const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure))\n      if (response.status >= 400) {\n        const text = yield* response.text.pipe(Effect.orElseSucceed(() => \"\"))\n        return Stream.fail(httpStatusError(response.status, text))\n      }\n      return response.stream.pipe(\n        Stream.mapError(transportFailure),\n        Stream.map((bytes): AudioChunk => ({ bytes })),\n      )\n    }),\n  )\n\n// ---------------------------------------------------------------------------\n// HTTP plumbing (sync + chunked-HTTP streaming)\n// ---------------------------------------------------------------------------\n\nconst buildHttpRequest = (cfg: Config, r: ElevenLabsSynthesizeRequest, path: \"\" | \"/stream\") =>\n  Effect.gen(function* () {\n    const format = r.outputFormat ?? defaultFormat\n    const slug = yield* formatToOutputSlug(format)\n    const url = `${resolveHost(cfg)}/text-to-speech/${r.voiceId}${path}?output_format=${slug}`\n    const httpRequest = HttpClientRequest.post(url).pipe(\n      HttpClientRequest.setHeader(\"xi-api-key\", Redacted.value(cfg.apiKey)),\n      HttpClientRequest.bodyJsonUnsafe(buildBody(r)),\n    )\n    return { httpRequest, format }\n  })\n\nconst synthesizeImpl = (cfg: Config) => (request: ElevenLabsSynthesizeRequest) =>\n  Effect.gen(function* () {\n    const client = yield* HttpClient.HttpClient\n    const { httpRequest, format } = yield* buildHttpRequest(cfg, request, \"\")\n    const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure))\n    if (response.status >= 400) {\n      const text = yield* response.text.pipe(Effect.orElseSucceed(() => \"\"))\n      return yield* Effect.fail(httpStatusError(response.status, text))\n    }\n    const bytes = yield* response.arrayBuffer.pipe(Effect.mapError(transportFailure))\n    return { format, bytes: new Uint8Array(bytes) } satisfies AudioBlob\n  })\n\nconst streamSynthesisImpl = (cfg: Config) => (request: ElevenLabsSynthesizeRequest) =>\n  Stream.unwrap(\n    Effect.gen(function* () {\n      const client = yield* HttpClient.HttpClient\n      const { httpRequest } = yield* buildHttpRequest(cfg, request, \"/stream\")\n      const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure))\n      if (response.status >= 400) {\n        const text = yield* response.text.pipe(Effect.orElseSucceed(() => \"\"))\n        return Stream.fail(httpStatusError(response.status, text))\n      }\n      return response.stream.pipe(\n        Stream.mapError(transportFailure),\n        Stream.map((bytes): AudioChunk => ({ bytes })),\n      )\n    }),\n  )\n\n// ---------------------------------------------------------------------------\n// Constructors\n// ---------------------------------------------------------------------------\n\nexport const make = (cfg: Config) =>\n  Effect.gen(function* () {\n    const client = yield* HttpClient.HttpClient\n    const ctor = yield* Socket.WebSocketConstructor\n    return {\n      synthesize: (r) =>\n        synthesizeImpl(cfg)(r).pipe(Effect.provideService(HttpClient.HttpClient, client)),\n      streamSynthesis: (r) =>\n        streamSynthesisImpl(cfg)(r).pipe(Stream.provideService(HttpClient.HttpClient, client)),\n      streamSynthesisFrom: (textIn, request) =>\n        realtimeStream(cfg)(textIn, request as ElevenLabsSynthesizeRequest).pipe(\n          Stream.provideService(Socket.WebSocketConstructor, ctor),\n        ),\n      synthesizeDialogue: (request) =>\n        synthesizeDialogueImpl(cfg)(request).pipe(\n          Effect.provideService(HttpClient.HttpClient, client),\n        ),\n      streamSynthesizeDialogue: (request) =>\n        streamSynthesizeDialogueImpl(cfg)(request).pipe(\n          Stream.provideService(HttpClient.HttpClient, client),\n        ),\n    } satisfies ElevenLabsSynthesizerService\n  })\n\n/**\n * Layer registers `ElevenLabsSynthesizer`, the generic\n * `SpeechSynthesizer`, the `TtsIncrementalText` marker (incremental\n * text-in via `/stream-input` WebSocket), **and `MultiSpeakerTts`** —\n * multi-speaker dialogue is wired to `POST /v1/text-to-dialogue`\n * (sync) and `/v1/text-to-dialogue/stream` (chunked). Provide\n * `Socket.layerWebSocketConstructorGlobal` and an `HttpClient` Layer\n * at the call site.\n */\nexport const layer = (cfg: Config) =>\n  Layer.mergeAll(\n    Layer.effect(ElevenLabsSynthesizer, make(cfg)),\n    Layer.effect(\n      SpeechSynthesizer,\n      Effect.map(\n        make(cfg),\n        (s): SpeechSynthesizerService => ({\n          synthesize: (req: CommonSynthesizeRequest) =>\n            s.synthesize(req as ElevenLabsSynthesizeRequest),\n          streamSynthesis: (req: CommonSynthesizeRequest) =>\n            s.streamSynthesis(req as ElevenLabsSynthesizeRequest),\n          streamSynthesisFrom: (textIn, req: CommonStreamSynthesizeRequest) =>\n            s.streamSynthesisFrom(textIn, req),\n          synthesizeDialogue: s.synthesizeDialogue,\n          streamSynthesizeDialogue: s.streamSynthesizeDialogue,\n        }),\n      ),\n    ),\n    Layer.succeed(TtsIncrementalText, undefined),\n    Layer.succeed(MultiSpeakerTts, undefined),\n  )\n"],"mappings":"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"}

package/dist/ElevenLabsTranscriber.d.mts

@@ -1,4 +1,5 @@
 import { ElevenLabsSttModel } from "./models.mjs";
+import { ElevenLabsRegion } from "./region.mjs";
 import { Context, Effect, Layer, Redacted, Stream } from "effect";
 import { HttpClient } from "effect/unstable/http";
 import * as Socket from "effect/unstable/socket/Socket";
@@ -32,10 +33,11 @@ declare class ElevenLabsTranscriber extends ElevenLabsTranscriber_base {}
 type Config = {
   readonly apiKey: Redacted.Redacted;
   readonly baseUrl?: string;
+  readonly region?: ElevenLabsRegion;
 };
 declare const make: (cfg: Config) => Effect.Effect<{
-  transcribe: (r: ElevenLabsTranscribeRequest) => Effect.Effect<any, AiError.AiError, never>;
-  streamTranscriptionFrom: (audioIn: any, request: any) => Stream.Stream<TranscriptEvent, unknown, unknown>;
+  transcribe: (r: ElevenLabsTranscribeRequest) => Effect.Effect<any, any, never>;
+  streamTranscriptionFrom: (audioIn: any, request: any) => Stream.Stream<TranscriptEvent, any, unknown>;
 }, never, Socket.WebSocketConstructor | HttpClient.HttpClient>;
 /**
  * Layer registers `ElevenLabsTranscriber`, the generic `Transcriber`,

package/dist/ElevenLabsTranscriber.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"ElevenLabsTranscriber.d.mts","names":[],"sources":["../src/ElevenLabsTranscriber.ts"],"mappings":";;;;;;;;;;;;;;;;;;;KA0BY,2BAAA,GAA8B,IAAA,CAAK,uBAAA;EAAA,SACpC,KAAA,EAAO,kBAAA;EAAA,SACP,WAAA;EAAA,SACA,WAAA;EAAA,SACA,QAAA;AAAA;AAAA,KAGC,4BAAA;EAAA,SACD,UAAA,GACP,CAAA,EAAG,2BAAA,KACA,MAAA,CAAO,MAAA,CAAO,gBAAA,EAAkB,OAAA,CAAQ,OAAA;EAAA,SACpC,uBAAA,EAAyB,kBAAA;AAAA;AAAA,cACnC,0BAAA;cAEY,qBAAA,SAA8B,0BAAA;AAAA,KAK/B,MAAA;EAAA,SAAoB,MAAA,EAAQ,QAAA,CAAS,QAAA;EAAA,SAAmB,OAAA;AAAA;AAAA,cAgGvD,IAAA,GAAQ,GAAA,EAAK,MAAA,KAAM,MAAA,CAAA,MAAA;;;;AA5GhC;;;;;;;AAAA,cAkIa,KAAA,GAAS,GAAA,EAAK,MAAA,KAAM,KAAA,CAAA,KAAA,iBAAA,MAAA,CAAA,oBAAA,GAAA,UAAA,CAAA,UAAA"}
+{"version":3,"file":"ElevenLabsTranscriber.d.mts","names":[],"sources":["../src/ElevenLabsTranscriber.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;KA2BY,2BAAA,GAA8B,IAAA,CAAK,uBAAA;EAAA,SACpC,KAAA,EAAO,kBAAA;EAAA,SACP,WAAA;EAAA,SACA,WAAA;EAAA,SACA,QAAA;AAAA;AAAA,KAGC,4BAAA;EAAA,SACD,UAAA,GACP,CAAA,EAAG,2BAAA,KACA,MAAA,CAAO,MAAA,CAAO,gBAAA,EAAkB,OAAA,CAAQ,OAAA;EAAA,SACpC,uBAAA,EAAyB,kBAAA;AAAA;AAAA,cACnC,0BAAA;cAEY,qBAAA,SAA8B,0BAAA;AAAA,KAK/B,MAAA;EAAA,SACD,MAAA,EAAQ,QAAA,CAAS,QAAA;EAAA,SACjB,OAAA;EAAA,SACA,MAAA,GAAS,gBAAA;AAAA;AAAA,cA+FP,IAAA,GAAQ,GAAA,EAAK,MAAA,KAAM,MAAA,CAAA,MAAA;;;;;;;;;;;cAsBnB,KAAA,GAAS,GAAA,EAAK,MAAA,KAAM,KAAA,CAAA,KAAA,iBAAA,MAAA,CAAA,oBAAA,GAAA,UAAA,CAAA,UAAA"}

package/dist/ElevenLabsTranscriber.mjs

@@ -1,5 +1,6 @@
 import { n as __exportAll } from "./chunk-uyGKjUfl.mjs";
 import { audioToBlob, defaultFileName, httpStatusError, transportFailure } from "./codec.mjs";
+import { resolveHost } from "./region.mjs";
 import { streamTranscription } from "./realtimeStt.mjs";
 import { Context, Effect, Layer, Redacted, Schema, Stream } from "effect";
 import { HttpClient, HttpClientRequest } from "effect/unstable/http";
@@ -49,11 +50,10 @@ const buildForm = (request) => Effect.gen(function* () {
 	if (request.audioEvents !== void 0) form.set("tag_audio_events", request.audioEvents ? "true" : "false");
 	return form;
 });
-const baseUrl = (cfg) => cfg.baseUrl ?? "https://api.elevenlabs.io/v1";
 const transcribeImpl = (cfg) => (request) => Effect.gen(function* () {
 	const client = yield* HttpClient.HttpClient;
 	const form = yield* buildForm(request);
-	const httpRequest = HttpClientRequest.post(`${baseUrl(cfg)}/speech-to-text`).pipe(HttpClientRequest.setHeader("xi-api-key", Redacted.value(cfg.apiKey)), HttpClientRequest.bodyFormData(form));
+	const httpRequest = HttpClientRequest.post(`${resolveHost(cfg)}/speech-to-text`).pipe(HttpClientRequest.setHeader("xi-api-key", Redacted.value(cfg.apiKey)), HttpClientRequest.bodyFormData(form));
 	const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure));
 	if (response.status >= 400) {
 		const text = yield* response.text.pipe(Effect.orElseSucceed(() => ""));

package/dist/ElevenLabsTranscriber.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ElevenLabsTranscriber.mjs","names":[],"sources":["../src/ElevenLabsTranscriber.ts"],"sourcesContent":["import { Context, Effect, Layer, Redacted, Schema, Stream } from \"effect\"\nimport { HttpClient, HttpClientRequest } from \"effect/unstable/http\"\nimport * as Socket from \"effect/unstable/socket/Socket\"\nimport * as AiError from \"@effect-uai/core/AiError\"\nimport type { TranscriptResult, WordTimestamp } from \"@effect-uai/core/Transcript\"\nimport {\n  type CommonTranscribeRequest,\n  SttStreaming,\n  Transcriber,\n  type TranscriberService,\n} from \"@effect-uai/core/Transcriber\"\nimport { audioToBlob, defaultFileName, httpStatusError, transportFailure } from \"./codec.js\"\nimport type { ElevenLabsSttModel } from \"./models.js\"\nimport { streamTranscription } from \"./realtimeStt.js\"\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\n/**\n * ElevenLabs-typed transcribe request. `model` narrows to\n * `ElevenLabsSttModel`. `numSpeakers` hints diarization. `audioEvents`\n * surfaces `(laughter)` / `(music)` tags inline in `text` (provider\n * default: true). `fileName` overrides the multipart upload's\n * `filename`; ElevenLabs uses the extension to detect format.\n */\nexport type ElevenLabsTranscribeRequest = Omit<CommonTranscribeRequest, \"model\"> & {\n  readonly model: ElevenLabsSttModel\n  readonly numSpeakers?: number\n  readonly audioEvents?: boolean\n  readonly fileName?: string\n}\n\nexport type ElevenLabsTranscriberService = {\n  readonly transcribe: (\n    r: ElevenLabsTranscribeRequest,\n  ) => Effect.Effect<TranscriptResult, AiError.AiError>\n  readonly streamTranscriptionFrom: TranscriberService[\"streamTranscriptionFrom\"]\n}\n\nexport class ElevenLabsTranscriber extends Context.Service<\n  ElevenLabsTranscriber,\n  ElevenLabsTranscriberService\n>()(\"@betalyra/effect-uai/providers/elevenlabs/ElevenLabsTranscriber\") {}\n\nexport type Config = { readonly apiKey: Redacted.Redacted; readonly baseUrl?: string }\n\n// ---------------------------------------------------------------------------\n// Response schema\n// ---------------------------------------------------------------------------\n\nconst Word = Schema.Struct({\n  text: Schema.String,\n  start: Schema.optional(Schema.Number),\n  end: Schema.optional(Schema.Number),\n  type: Schema.optional(Schema.String),\n  speaker_id: Schema.optional(Schema.String),\n  logprob: Schema.optional(Schema.Number),\n})\n\nconst Wire = Schema.Struct({\n  text: Schema.String,\n  language_code: Schema.optional(Schema.String),\n  language_probability: Schema.optional(Schema.Number),\n  words: Schema.optional(Schema.Array(Word)),\n  transcription_id: Schema.optional(Schema.String),\n})\nconst decodeWire = Schema.decodeUnknownEffect(Wire)\n\nconst toWordTimestamp = (w: typeof Word.Type): WordTimestamp | undefined =>\n  w.start === undefined || w.end === undefined\n    ? undefined\n    : {\n        text: w.text,\n        startSeconds: w.start,\n        endSeconds: w.end,\n        ...(w.logprob !== undefined && { confidence: Math.exp(w.logprob) }),\n        ...(w.speaker_id !== undefined && { speakerId: w.speaker_id }),\n      }\n\n// ---------------------------------------------------------------------------\n// Multipart body\n// ---------------------------------------------------------------------------\n\nconst buildForm = (request: ElevenLabsTranscribeRequest) =>\n  Effect.gen(function* () {\n    const blob = yield* audioToBlob(request.audio)\n    const fileName = request.fileName ?? defaultFileName(request.audio.mimeType ?? \"\")\n    const form = new FormData()\n    form.set(\"model_id\", request.model)\n    form.set(\"file\", blob, fileName)\n    if (request.language !== undefined) form.set(\"language_code\", request.language)\n    if (request.diarization !== undefined)\n      form.set(\"diarize\", request.diarization ? \"true\" : \"false\")\n    if (request.wordTimestamps === true) form.set(\"timestamps_granularity\", \"word\")\n    if (request.numSpeakers !== undefined) form.set(\"num_speakers\", String(request.numSpeakers))\n    if (request.audioEvents !== undefined)\n      form.set(\"tag_audio_events\", request.audioEvents ? \"true\" : \"false\")\n    return form\n  })\n\n// ---------------------------------------------------------------------------\n// HTTP plumbing\n// ---------------------------------------------------------------------------\n\nconst baseUrl = (cfg: Config) => cfg.baseUrl ?? \"https://api.elevenlabs.io/v1\"\n\nconst transcribeImpl = (cfg: Config) => (request: ElevenLabsTranscribeRequest) =>\n  Effect.gen(function* () {\n    const client = yield* HttpClient.HttpClient\n    const form = yield* buildForm(request)\n    const httpRequest = HttpClientRequest.post(`${baseUrl(cfg)}/speech-to-text`).pipe(\n      HttpClientRequest.setHeader(\"xi-api-key\", Redacted.value(cfg.apiKey)),\n      HttpClientRequest.bodyFormData(form),\n    )\n    const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure))\n    if (response.status >= 400) {\n      const text = yield* response.text.pipe(Effect.orElseSucceed(() => \"\"))\n      return yield* Effect.fail(httpStatusError(response.status, text))\n    }\n    const json = yield* response.json.pipe(Effect.mapError(transportFailure))\n    const wire = yield* decodeWire(json).pipe(\n      Effect.mapError(\n        (cause) => new AiError.GenerationFailed({ provider: \"elevenlabs\", raw: cause }),\n      ),\n    )\n    const words = wire.words\n      ?.map(toWordTimestamp)\n      .filter((w): w is WordTimestamp => w !== undefined)\n    return {\n      text: wire.text,\n      ...(wire.language_code !== undefined && { languageCode: wire.language_code }),\n      ...(words !== undefined && words.length > 0 && { words }),\n      raw: json,\n    } satisfies TranscriptResult\n  })\n\n// ---------------------------------------------------------------------------\n// Constructors\n// ---------------------------------------------------------------------------\n\nexport const make = (cfg: Config) =>\n  Effect.gen(function* () {\n    const client = yield* HttpClient.HttpClient\n    const ctor = yield* Socket.WebSocketConstructor\n    return {\n      transcribe: (r) =>\n        transcribeImpl(cfg)(r).pipe(Effect.provideService(HttpClient.HttpClient, client)),\n      streamTranscriptionFrom: (audioIn, request) =>\n        streamTranscription(cfg)(audioIn, request).pipe(\n          Stream.provideService(HttpClient.HttpClient, client),\n          Stream.provideService(Socket.WebSocketConstructor, ctor),\n        ),\n    } satisfies ElevenLabsTranscriberService\n  })\n\n/**\n * Layer registers `ElevenLabsTranscriber`, the generic `Transcriber`,\n * **and the `SttStreaming` capability marker** — `streamTranscriptionFrom`\n * is wired to the realtime WebSocket. Provide\n * `Socket.layerWebSocketConstructorGlobal` (or a custom constructor) +\n * an `HttpClient` Layer at the call site.\n */\nexport const layer = (cfg: Config) =>\n  Layer.mergeAll(\n    Layer.effect(ElevenLabsTranscriber, make(cfg)),\n    Layer.effect(\n      Transcriber,\n      Effect.map(\n        make(cfg),\n        (s): TranscriberService => ({\n          transcribe: (req: CommonTranscribeRequest) =>\n            s.transcribe(req as ElevenLabsTranscribeRequest),\n          streamTranscriptionFrom: s.streamTranscriptionFrom,\n        }),\n      ),\n    ),\n    Layer.succeed(SttStreaming, undefined),\n  )\n"],"mappings":"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"}
+{"version":3,"file":"ElevenLabsTranscriber.mjs","names":[],"sources":["../src/ElevenLabsTranscriber.ts"],"sourcesContent":["import { Context, Effect, Layer, Redacted, Schema, Stream } from \"effect\"\nimport { HttpClient, HttpClientRequest } from \"effect/unstable/http\"\nimport * as Socket from \"effect/unstable/socket/Socket\"\nimport * as AiError from \"@effect-uai/core/AiError\"\nimport type { TranscriptResult, WordTimestamp } from \"@effect-uai/core/Transcript\"\nimport {\n  type CommonTranscribeRequest,\n  SttStreaming,\n  Transcriber,\n  type TranscriberService,\n} from \"@effect-uai/core/Transcriber\"\nimport { audioToBlob, defaultFileName, httpStatusError, transportFailure } from \"./codec.js\"\nimport type { ElevenLabsSttModel } from \"./models.js\"\nimport { streamTranscription } from \"./realtimeStt.js\"\nimport { type ElevenLabsRegion, resolveHost } from \"./region.js\"\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\n/**\n * ElevenLabs-typed transcribe request. `model` narrows to\n * `ElevenLabsSttModel`. `numSpeakers` hints diarization. `audioEvents`\n * surfaces `(laughter)` / `(music)` tags inline in `text` (provider\n * default: true). `fileName` overrides the multipart upload's\n * `filename`; ElevenLabs uses the extension to detect format.\n */\nexport type ElevenLabsTranscribeRequest = Omit<CommonTranscribeRequest, \"model\"> & {\n  readonly model: ElevenLabsSttModel\n  readonly numSpeakers?: number\n  readonly audioEvents?: boolean\n  readonly fileName?: string\n}\n\nexport type ElevenLabsTranscriberService = {\n  readonly transcribe: (\n    r: ElevenLabsTranscribeRequest,\n  ) => Effect.Effect<TranscriptResult, AiError.AiError>\n  readonly streamTranscriptionFrom: TranscriberService[\"streamTranscriptionFrom\"]\n}\n\nexport class ElevenLabsTranscriber extends Context.Service<\n  ElevenLabsTranscriber,\n  ElevenLabsTranscriberService\n>()(\"@betalyra/effect-uai/providers/elevenlabs/ElevenLabsTranscriber\") {}\n\nexport type Config = {\n  readonly apiKey: Redacted.Redacted\n  readonly baseUrl?: string\n  readonly region?: ElevenLabsRegion\n}\n\n// ---------------------------------------------------------------------------\n// Response schema\n// ---------------------------------------------------------------------------\n\nconst Word = Schema.Struct({\n  text: Schema.String,\n  start: Schema.optional(Schema.Number),\n  end: Schema.optional(Schema.Number),\n  type: Schema.optional(Schema.String),\n  speaker_id: Schema.optional(Schema.String),\n  logprob: Schema.optional(Schema.Number),\n})\n\nconst Wire = Schema.Struct({\n  text: Schema.String,\n  language_code: Schema.optional(Schema.String),\n  language_probability: Schema.optional(Schema.Number),\n  words: Schema.optional(Schema.Array(Word)),\n  transcription_id: Schema.optional(Schema.String),\n})\nconst decodeWire = Schema.decodeUnknownEffect(Wire)\n\nconst toWordTimestamp = (w: typeof Word.Type): WordTimestamp | undefined =>\n  w.start === undefined || w.end === undefined\n    ? undefined\n    : {\n        text: w.text,\n        startSeconds: w.start,\n        endSeconds: w.end,\n        ...(w.logprob !== undefined && { confidence: Math.exp(w.logprob) }),\n        ...(w.speaker_id !== undefined && { speakerId: w.speaker_id }),\n      }\n\n// ---------------------------------------------------------------------------\n// Multipart body\n// ---------------------------------------------------------------------------\n\nconst buildForm = (request: ElevenLabsTranscribeRequest) =>\n  Effect.gen(function* () {\n    const blob = yield* audioToBlob(request.audio)\n    const fileName = request.fileName ?? defaultFileName(request.audio.mimeType ?? \"\")\n    const form = new FormData()\n    form.set(\"model_id\", request.model)\n    form.set(\"file\", blob, fileName)\n    if (request.language !== undefined) form.set(\"language_code\", request.language)\n    if (request.diarization !== undefined)\n      form.set(\"diarize\", request.diarization ? \"true\" : \"false\")\n    if (request.wordTimestamps === true) form.set(\"timestamps_granularity\", \"word\")\n    if (request.numSpeakers !== undefined) form.set(\"num_speakers\", String(request.numSpeakers))\n    if (request.audioEvents !== undefined)\n      form.set(\"tag_audio_events\", request.audioEvents ? \"true\" : \"false\")\n    return form\n  })\n\n// ---------------------------------------------------------------------------\n// HTTP plumbing\n// ---------------------------------------------------------------------------\n\nconst transcribeImpl = (cfg: Config) => (request: ElevenLabsTranscribeRequest) =>\n  Effect.gen(function* () {\n    const client = yield* HttpClient.HttpClient\n    const form = yield* buildForm(request)\n    const httpRequest = HttpClientRequest.post(`${resolveHost(cfg)}/speech-to-text`).pipe(\n      HttpClientRequest.setHeader(\"xi-api-key\", Redacted.value(cfg.apiKey)),\n      HttpClientRequest.bodyFormData(form),\n    )\n    const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure))\n    if (response.status >= 400) {\n      const text = yield* response.text.pipe(Effect.orElseSucceed(() => \"\"))\n      return yield* Effect.fail(httpStatusError(response.status, text))\n    }\n    const json = yield* response.json.pipe(Effect.mapError(transportFailure))\n    const wire = yield* decodeWire(json).pipe(\n      Effect.mapError(\n        (cause) => new AiError.GenerationFailed({ provider: \"elevenlabs\", raw: cause }),\n      ),\n    )\n    const words = wire.words\n      ?.map(toWordTimestamp)\n      .filter((w): w is WordTimestamp => w !== undefined)\n    return {\n      text: wire.text,\n      ...(wire.language_code !== undefined && { languageCode: wire.language_code }),\n      ...(words !== undefined && words.length > 0 && { words }),\n      raw: json,\n    } satisfies TranscriptResult\n  })\n\n// ---------------------------------------------------------------------------\n// Constructors\n// ---------------------------------------------------------------------------\n\nexport const make = (cfg: Config) =>\n  Effect.gen(function* () {\n    const client = yield* HttpClient.HttpClient\n    const ctor = yield* Socket.WebSocketConstructor\n    return {\n      transcribe: (r) =>\n        transcribeImpl(cfg)(r).pipe(Effect.provideService(HttpClient.HttpClient, client)),\n      streamTranscriptionFrom: (audioIn, request) =>\n        streamTranscription(cfg)(audioIn, request).pipe(\n          Stream.provideService(HttpClient.HttpClient, client),\n          Stream.provideService(Socket.WebSocketConstructor, ctor),\n        ),\n    } satisfies ElevenLabsTranscriberService\n  })\n\n/**\n * Layer registers `ElevenLabsTranscriber`, the generic `Transcriber`,\n * **and the `SttStreaming` capability marker** — `streamTranscriptionFrom`\n * is wired to the realtime WebSocket. Provide\n * `Socket.layerWebSocketConstructorGlobal` (or a custom constructor) +\n * an `HttpClient` Layer at the call site.\n */\nexport const layer = (cfg: Config) =>\n  Layer.mergeAll(\n    Layer.effect(ElevenLabsTranscriber, make(cfg)),\n    Layer.effect(\n      Transcriber,\n      Effect.map(\n        make(cfg),\n        (s): TranscriberService => ({\n          transcribe: (req: CommonTranscribeRequest) =>\n            s.transcribe(req as ElevenLabsTranscribeRequest),\n          streamTranscriptionFrom: s.streamTranscriptionFrom,\n        }),\n      ),\n    ),\n    Layer.succeed(SttStreaming, undefined),\n  )\n"],"mappings":"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"}

package/dist/index.d.mts

@@ -1,5 +1,6 @@
 import { t as codec_d_exports } from "./codec.mjs";
 import { ElevenLabsSttModel, ElevenLabsTtsModel, ElevenLabsVoiceId } from "./models.mjs";
+import { ElevenLabsRegion, resolveHost } from "./region.mjs";
 import { t as ElevenLabsSynthesizer_d_exports } from "./ElevenLabsSynthesizer.mjs";
 import { t as ElevenLabsTranscriber_d_exports } from "./ElevenLabsTranscriber.mjs";
-export { ElevenLabsSttModel, ElevenLabsSynthesizer_d_exports as ElevenLabsSynthesizer, ElevenLabsTranscriber_d_exports as ElevenLabsTranscriber, ElevenLabsTtsModel, ElevenLabsVoiceId, codec_d_exports as codec };
+export { ElevenLabsRegion, ElevenLabsSttModel, ElevenLabsSynthesizer_d_exports as ElevenLabsSynthesizer, ElevenLabsTranscriber_d_exports as ElevenLabsTranscriber, ElevenLabsTtsModel, ElevenLabsVoiceId, codec_d_exports as codec, resolveHost };

package/dist/index.mjs

@@ -1,5 +1,6 @@
 import { t as codec_exports } from "./codec.mjs";
+import { resolveHost } from "./region.mjs";
 import { t as ElevenLabsSynthesizer_exports } from "./ElevenLabsSynthesizer.mjs";
 import { t as ElevenLabsTranscriber_exports } from "./ElevenLabsTranscriber.mjs";
 import "./models.mjs";
-export { ElevenLabsSynthesizer_exports as ElevenLabsSynthesizer, ElevenLabsTranscriber_exports as ElevenLabsTranscriber, codec_exports as codec };
+export { ElevenLabsSynthesizer_exports as ElevenLabsSynthesizer, ElevenLabsTranscriber_exports as ElevenLabsTranscriber, codec_exports as codec, resolveHost };

package/dist/realtimeStt.d.mts

@@ -1,3 +1,4 @@
+import { ElevenLabsRegion } from "./region.mjs";
 import { Effect, Redacted, Schema, Stream } from "effect";
 import { HttpClient } from "effect/unstable/http";
 import * as Socket from "effect/unstable/socket/Socket";
@@ -10,9 +11,10 @@ import { TranscriptEvent } from "@effect-uai/core/Transcript";
 type Config = {
   readonly apiKey: Redacted.Redacted;
   readonly baseUrl?: string;
+  readonly region?: ElevenLabsRegion;
 };
 declare const inputFormatToSlug: (format: AudioFormat) => Effect.Effect<string, AiError.AiError>;
-declare const fetchSingleUseToken: (cfg: Config) => Effect.Effect<string, AiError.AiError, HttpClient.HttpClient>;
+declare const fetchSingleUseToken: (cfg: Config) => Effect.Effect<string, any, HttpClient.HttpClient>;
 declare const ServerMessage: Schema.Union<readonly [Schema.Struct<{
   readonly message_type: Schema.Literal<"session_started">;
   readonly session_id: Schema.optional<Schema.String>;

package/dist/realtimeStt.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"realtimeStt.d.mts","names":[],"sources":["../src/realtimeStt.ts"],"mappings":";;;;;;;;;KAUY,MAAA;EAAA,SAAoB,MAAA,EAAQ,QAAA,CAAS,QAAA;EAAA,SAAmB,OAAA;AAAA;AAAA,cAavD,iBAAA,GAAoB,MAAA,EAAQ,WAAA,KAAgB,MAAA,CAAO,MAAA,SAAe,OAAA,CAAQ,OAAA;AAAA,cAmB1E,mBAAA,GAAuB,GAAA,EAAK,MAAA,KAAM,MAAA,CAAA,MAAA,SAAA,OAAA,CAAA,OAAA,EAAA,UAAA,CAAA,UAAA;AAAA,cAsCzC,aAAA,EAAa,MAAA,CAAA,KAAA,WAAA,MAAA,CAAA,MAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAgDN,WAAA,GACV,iBAAA,eACA,GAAA,SAAY,aAAA,CAAc,IAAA,KAAO,eAAA;AAAA,KAqCxB,eAAA;EAAA,SACD,KAAA;EAAA,SACA,YAAA;EAAA,SACA,iBAAA;EAAA,SACA,cAAA;AAAA;AAAA,cAGE,UAAA,GACX,GAAA,EAAK,MAAA,EACL,KAAA,UACA,WAAA,UACA,IAAA,EAAM,eAAA;AAAA,cAcK,gBAAA,GAAoB,KAAA,EAAO,UAAA,EAAY,UAAA;AAAA,cAqCvC,mBAAA,GACV,GAAA,EAAK,MAAA,YAEJ,OAAA,EAAS,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,CAAA,EAAG,CAAA,GACtC,OAAA,EAAS,6BAAA,KACR,MAAA,CAAO,MAAA,CACR,eAAA,EACA,OAAA,CAAQ,OAAA,GAAU,CAAA,EAClB,CAAA,GAAI,UAAA,CAAW,UAAA,GAAa,MAAA,CAAO,oBAAA"}
+{"version":3,"file":"realtimeStt.d.mts","names":[],"sources":["../src/realtimeStt.ts"],"mappings":";;;;;;;;;;KAWY,MAAA;EAAA,SACD,MAAA,EAAQ,QAAA,CAAS,QAAA;EAAA,SACjB,OAAA;EAAA,SACA,MAAA,GAAS,gBAAA;AAAA;AAAA,cAcP,iBAAA,GAAoB,MAAA,EAAQ,WAAA,KAAgB,MAAA,CAAO,MAAA,SAAe,OAAA,CAAQ,OAAA;AAAA,cAmB1E,mBAAA,GAAuB,GAAA,EAAK,MAAA,KAAM,MAAA,CAAA,MAAA,cAAA,UAAA,CAAA,UAAA;AAAA,cAsCzC,aAAA,EAAa,MAAA,CAAA,KAAA,WAAA,MAAA,CAAA,MAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAgDN,WAAA,GACV,iBAAA,eACA,GAAA,SAAY,aAAA,CAAc,IAAA,KAAO,eAAA;AAAA,KAqCxB,eAAA;EAAA,SACD,KAAA;EAAA,SACA,YAAA;EAAA,SACA,iBAAA;EAAA,SACA,cAAA;AAAA;AAAA,cAGE,UAAA,GACX,GAAA,EAAK,MAAA,EACL,KAAA,UACA,WAAA,UACA,IAAA,EAAM,eAAA;AAAA,cAcK,gBAAA,GAAoB,KAAA,EAAO,UAAA,EAAY,UAAA;AAAA,cAqCvC,mBAAA,GACV,GAAA,EAAK,MAAA,YAEJ,OAAA,EAAS,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,CAAA,EAAG,CAAA,GACtC,OAAA,EAAS,6BAAA,KACR,MAAA,CAAO,MAAA,CACR,eAAA,EACA,OAAA,CAAQ,OAAA,GAAU,CAAA,EAClB,CAAA,GAAI,UAAA,CAAW,UAAA,GAAa,MAAA,CAAO,oBAAA"}

package/dist/realtimeStt.mjs

@@ -1,4 +1,5 @@
 import { httpStatusError, transportFailure } from "./codec.mjs";
+import { resolveHost } from "./region.mjs";
 import { Effect, Encoding, Match, Queue, Redacted, Schema, Stream } from "effect";
 import { HttpClient, HttpClientRequest } from "effect/unstable/http";
 import * as Socket from "effect/unstable/socket/Socket";
@@ -22,7 +23,7 @@ const TokenWire = Schema.Struct({ token: Schema.String });
 const decodeToken = Schema.decodeUnknownEffect(TokenWire);
 const fetchSingleUseToken = (cfg) => Effect.gen(function* () {
 	const client = yield* HttpClient.HttpClient;
-	const url = `${cfg.baseUrl ?? "https://api.elevenlabs.io/v1"}/single-use-token/realtime_scribe`;
+	const url = `${resolveHost(cfg)}/single-use-token/realtime_scribe`;
 	const httpRequest = HttpClientRequest.post(url).pipe(HttpClientRequest.setHeader("xi-api-key", Redacted.value(cfg.apiKey)));
 	const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure));
 	if (response.status >= 400) {
@@ -118,7 +119,7 @@ const wireToEvent = (includeTimestamps) => (msg) => Match.value(msg).pipe(Match.
 	message: typeof m.error === "string" ? m.error : JSON.stringify(m.error ?? `ElevenLabs ${m.message_type}`)
 })));
 const buildWsUrl = (cfg, token, audioFormat, opts) => {
-	return `${(cfg.baseUrl ?? "https://api.elevenlabs.io/v1").replace(/^http/, "ws")}/speech-to-text/realtime?${new URLSearchParams({
+	return `${resolveHost(cfg).replace(/^http/, "ws")}/speech-to-text/realtime?${new URLSearchParams({
 		token,
 		audio_format: audioFormat,
 		commit_strategy: opts.commitStrategy ?? "vad",

package/dist/realtimeStt.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"realtimeStt.mjs","names":[],"sources":["../src/realtimeStt.ts"],"sourcesContent":["import { Cause, Effect, Encoding, Match, Queue, Redacted, Schema, Stream } from \"effect\"\nimport { HttpClient, HttpClientRequest } from \"effect/unstable/http\"\nimport * as Socket from \"effect/unstable/socket/Socket\"\nimport * as AiError from \"@effect-uai/core/AiError\"\nimport type { AudioFormat } from \"@effect-uai/core/Audio\"\nimport * as JSONL from \"@effect-uai/core/JSONL\"\nimport type { TranscriptEvent, WordTimestamp } from \"@effect-uai/core/Transcript\"\nimport type { CommonStreamTranscribeRequest } from \"@effect-uai/core/Transcriber\"\nimport { httpStatusError, transportFailure } from \"./codec.js\"\n\nexport type Config = { readonly apiKey: Redacted.Redacted; readonly baseUrl?: string }\n\n// ---------------------------------------------------------------------------\n// AudioFormat → audio_format slug\n// ---------------------------------------------------------------------------\n\nconst unsupportedInputFormat = (format: AudioFormat) =>\n  new AiError.Unsupported({\n    provider: \"elevenlabs\",\n    capability: \"inputFormat\",\n    reason: `ElevenLabs realtime STT accepts pcm_<rate> or ulaw_8000 only. Got ${JSON.stringify(format)}.`,\n  })\n\nexport const inputFormatToSlug: (format: AudioFormat) => Effect.Effect<string, AiError.AiError> =\n  Match.type<AudioFormat>().pipe(\n    Match.when({ container: \"raw\", encoding: \"pcm_s16le\" }, (f) =>\n      Effect.succeed(`pcm_${f.sampleRate}`),\n    ),\n    Match.when({ container: \"raw\", encoding: \"pcm_mulaw\", sampleRate: 8000 }, () =>\n      Effect.succeed(\"ulaw_8000\"),\n    ),\n    Match.orElse((f) => Effect.fail(unsupportedInputFormat(f))),\n  )\n\n// ---------------------------------------------------------------------------\n// Single-use token — auth rides on a query param so any\n// `globalThis.WebSocket` works (browser, Node 22+, Bun, Deno).\n// ---------------------------------------------------------------------------\n\nconst TokenWire = Schema.Struct({ token: Schema.String })\nconst decodeToken = Schema.decodeUnknownEffect(TokenWire)\n\nexport const fetchSingleUseToken = (cfg: Config) =>\n  Effect.gen(function* () {\n    const client = yield* HttpClient.HttpClient\n    const url = `${cfg.baseUrl ?? \"https://api.elevenlabs.io/v1\"}/single-use-token/realtime_scribe`\n    const httpRequest = HttpClientRequest.post(url).pipe(\n      HttpClientRequest.setHeader(\"xi-api-key\", Redacted.value(cfg.apiKey)),\n    )\n    const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure))\n    if (response.status >= 400) {\n      const text = yield* response.text.pipe(Effect.orElseSucceed(() => \"\"))\n      return yield* Effect.fail(httpStatusError(response.status, text))\n    }\n    const json = yield* response.json.pipe(Effect.mapError(transportFailure))\n    const wire = yield* decodeToken(json).pipe(\n      Effect.mapError(\n        (cause) =>\n          new AiError.GenerationFailed({\n            provider: \"elevenlabs\",\n            raw: { message: \"single-use-token response missing `token` field\", cause, json },\n          }),\n      ),\n    )\n    return wire.token\n  })\n\n// ---------------------------------------------------------------------------\n// Wire schemas (server → client)\n// ---------------------------------------------------------------------------\n\nconst RealtimeWord = Schema.Struct({\n  text: Schema.String,\n  start: Schema.Number,\n  end: Schema.Number,\n  type: Schema.optional(Schema.String),\n  speaker_id: Schema.optional(Schema.NullOr(Schema.String)),\n  logprob: Schema.optional(Schema.Number),\n})\n\nconst ServerMessage = Schema.Union([\n  Schema.Struct({\n    message_type: Schema.Literal(\"session_started\"),\n    session_id: Schema.optional(Schema.String),\n  }),\n  Schema.Struct({\n    message_type: Schema.Literal(\"partial_transcript\"),\n    text: Schema.String,\n  }),\n  Schema.Struct({\n    message_type: Schema.Literal(\"committed_transcript\"),\n    text: Schema.String,\n  }),\n  Schema.Struct({\n    message_type: Schema.Literal(\"committed_transcript_with_timestamps\"),\n    text: Schema.String,\n    language_code: Schema.optional(Schema.NullOr(Schema.String)),\n    words: Schema.optional(Schema.NullOr(Schema.Array(RealtimeWord))),\n  }),\n  Schema.Struct({\n    message_type: Schema.Literals([\"error\", \"auth_error\", \"rate_limited\", \"quota_exceeded\"]),\n    error: Schema.optional(Schema.Unknown),\n  }),\n])\nconst decodeServerMessage = Schema.decodeUnknownEffect(ServerMessage)\n\nconst wireToWordTimestamp = (w: typeof RealtimeWord.Type): WordTimestamp => ({\n  text: w.text,\n  startSeconds: w.start,\n  endSeconds: w.end,\n  ...(w.speaker_id != null && { speakerId: w.speaker_id }),\n  ...(w.logprob !== undefined && { confidence: Math.exp(w.logprob) }),\n})\n\n/**\n * Map a server frame to a `TranscriptEvent`. The two `committed_*` variants\n * need disambiguation:\n *\n *   - When `include_timestamps=true` on the URL, the server emits BOTH\n *     `committed_transcript` and `committed_transcript_with_timestamps` for\n *     each segment — same text, the latter is a strict superset. The bare\n *     variant must be suppressed or callers see two finals per utterance.\n *   - When `include_timestamps=false`, the server emits ONLY\n *     `committed_transcript`. Suppressing it loses every final.\n *\n * So suppression must be conditional on `includeTimestamps`, which is what\n * `wordTimestamps` resolves to on the URL.\n */\nexport const wireToEvent =\n  (includeTimestamps: boolean) =>\n  (msg: typeof ServerMessage.Type): TranscriptEvent | undefined =>\n    Match.value(msg).pipe(\n      Match.when({ message_type: \"session_started\" }, () => undefined),\n      Match.when(\n        { message_type: \"partial_transcript\" },\n        (m): TranscriptEvent => ({ _tag: \"partial\", text: m.text }),\n      ),\n      Match.when({ message_type: \"committed_transcript\" }, (m): TranscriptEvent | undefined =>\n        includeTimestamps\n          ? undefined // superseded by the `_with_timestamps` variant\n          : { _tag: \"final\", text: m.text },\n      ),\n      Match.when({ message_type: \"committed_transcript_with_timestamps\" }, (m): TranscriptEvent => {\n        const words = m.words == null ? undefined : m.words.map(wireToWordTimestamp)\n        return {\n          _tag: \"final\",\n          text: m.text,\n          ...(m.language_code != null && { languageCode: m.language_code }),\n          ...(words !== undefined && words.length > 0 && { words }),\n        }\n      }),\n      Match.orElse(\n        (m): TranscriptEvent => ({\n          _tag: \"error\",\n          code: m.message_type,\n          message:\n            typeof m.error === \"string\"\n              ? m.error\n              : JSON.stringify(m.error ?? `ElevenLabs ${m.message_type}`),\n        }),\n      ),\n    )\n\n// ---------------------------------------------------------------------------\n// URL + frame builders\n// ---------------------------------------------------------------------------\n\nexport type RealtimeOptions = {\n  readonly model?: string\n  readonly languageCode?: string\n  readonly includeTimestamps?: boolean\n  readonly commitStrategy?: \"manual\" | \"vad\"\n}\n\nexport const buildWsUrl = (\n  cfg: Config,\n  token: string,\n  audioFormat: string,\n  opts: RealtimeOptions,\n) => {\n  const wsBase = (cfg.baseUrl ?? \"https://api.elevenlabs.io/v1\").replace(/^http/, \"ws\")\n  const params = new URLSearchParams({\n    token,\n    audio_format: audioFormat,\n    commit_strategy: opts.commitStrategy ?? \"vad\",\n    ...(opts.model !== undefined && { model_id: opts.model }),\n    ...(opts.languageCode !== undefined && { language_code: opts.languageCode }),\n    ...(opts.includeTimestamps === true && { include_timestamps: \"true\" }),\n  })\n  return `${wsBase}/speech-to-text/realtime?${params.toString()}`\n}\n\nexport const encodeAudioFrame = (bytes: Uint8Array, sampleRate: number) =>\n  JSON.stringify({\n    message_type: \"input_audio_chunk\",\n    audio_base_64: Encoding.encodeBase64(bytes),\n    sample_rate: sampleRate,\n  })\n\n// ---------------------------------------------------------------------------\n// Parse one server message and emit to the queue if it maps to a\n// TranscriptEvent. Invalid JSON / unknown shapes are silently dropped —\n// the connection stays open and we keep streaming subsequent messages.\n// ---------------------------------------------------------------------------\n\nconst handleServerMessage =\n  (\n    queue: Queue.Queue<TranscriptEvent, Cause.Done>,\n    mapEvent: (msg: typeof ServerMessage.Type) => TranscriptEvent | undefined,\n  ) =>\n  (raw: string) =>\n    Effect.gen(function* () {\n      const json = yield* JSONL.parseSafe(raw)\n      if (json === undefined) return\n      const decoded = yield* decodeServerMessage(json).pipe(Effect.option)\n      if (decoded._tag === \"None\") return\n      const event = mapEvent(decoded.value)\n      if (event !== undefined) yield* Queue.offer(queue, event)\n    })\n\n// ---------------------------------------------------------------------------\n// Stream<Uint8Array> → Stream<TranscriptEvent>\n//\n// Requires `HttpClient` (single-use token fetch) and\n// `Socket.WebSocketConstructor` (any `globalThis.WebSocket` works) in\n// context — `Socket.layerWebSocketConstructorGlobal` covers every\n// modern runtime.\n// ---------------------------------------------------------------------------\n\nexport const streamTranscription =\n  (cfg: Config) =>\n  <E, R>(\n    audioIn: Stream.Stream<Uint8Array, E, R>,\n    request: CommonStreamTranscribeRequest,\n  ): Stream.Stream<\n    TranscriptEvent,\n    AiError.AiError | E,\n    R | HttpClient.HttpClient | Socket.WebSocketConstructor\n  > =>\n    Stream.unwrap(\n      Effect.gen(function* () {\n        const slug = yield* inputFormatToSlug(request.inputFormat)\n        const token = yield* fetchSingleUseToken(cfg)\n        const includeTimestamps = request.wordTimestamps === true\n        const url = buildWsUrl(cfg, token, slug, {\n          ...(request.model !== undefined && { model: request.model }),\n          ...(request.language !== undefined && { languageCode: request.language }),\n          includeTimestamps,\n        })\n        const socket = yield* Socket.makeWebSocket(url, {\n          // Effect's Socket treats all close codes as errors by default — that\n          // surfaces a clean server-side close as a stream failure. Whitelist\n          // standard clean-close codes (1000 / 1001 / 1005).\n          closeCodeIsError: (code) => code !== 1000 && code !== 1001 && code !== 1005,\n        })\n        const queue = yield* Queue.bounded<TranscriptEvent, Cause.Done>(64)\n        const sampleRate = request.inputFormat.sampleRate\n\n        const write = yield* socket.writer\n        yield* Stream.runForEach(audioIn, (bytes) =>\n          write(encodeAudioFrame(bytes, sampleRate)),\n        ).pipe(Effect.ignore, Effect.forkScoped)\n\n        // `Queue.end` flushes pending events then fails the next take with\n        // `Done` — clean stream end. `Queue.shutdown` would CLEAR queued\n        // items and interrupt pending takes (wrong for graceful teardown).\n        yield* socket\n          .runString(handleServerMessage(queue, wireToEvent(includeTimestamps)))\n          .pipe(Effect.ensuring(Queue.end(queue)), Effect.forkScoped)\n\n        return Stream.fromQueue(queue)\n      }),\n    )\n"],"mappings":"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"}
+{"version":3,"file":"realtimeStt.mjs","names":[],"sources":["../src/realtimeStt.ts"],"sourcesContent":["import { Cause, Effect, Encoding, Match, Queue, Redacted, Schema, Stream } from \"effect\"\nimport { HttpClient, HttpClientRequest } from \"effect/unstable/http\"\nimport * as Socket from \"effect/unstable/socket/Socket\"\nimport * as AiError from \"@effect-uai/core/AiError\"\nimport type { AudioFormat } from \"@effect-uai/core/Audio\"\nimport * as JSONL from \"@effect-uai/core/JSONL\"\nimport type { TranscriptEvent, WordTimestamp } from \"@effect-uai/core/Transcript\"\nimport type { CommonStreamTranscribeRequest } from \"@effect-uai/core/Transcriber\"\nimport { httpStatusError, transportFailure } from \"./codec.js\"\nimport { type ElevenLabsRegion, resolveHost } from \"./region.js\"\n\nexport type Config = {\n  readonly apiKey: Redacted.Redacted\n  readonly baseUrl?: string\n  readonly region?: ElevenLabsRegion\n}\n\n// ---------------------------------------------------------------------------\n// AudioFormat → audio_format slug\n// ---------------------------------------------------------------------------\n\nconst unsupportedInputFormat = (format: AudioFormat) =>\n  new AiError.Unsupported({\n    provider: \"elevenlabs\",\n    capability: \"inputFormat\",\n    reason: `ElevenLabs realtime STT accepts pcm_<rate> or ulaw_8000 only. Got ${JSON.stringify(format)}.`,\n  })\n\nexport const inputFormatToSlug: (format: AudioFormat) => Effect.Effect<string, AiError.AiError> =\n  Match.type<AudioFormat>().pipe(\n    Match.when({ container: \"raw\", encoding: \"pcm_s16le\" }, (f) =>\n      Effect.succeed(`pcm_${f.sampleRate}`),\n    ),\n    Match.when({ container: \"raw\", encoding: \"pcm_mulaw\", sampleRate: 8000 }, () =>\n      Effect.succeed(\"ulaw_8000\"),\n    ),\n    Match.orElse((f) => Effect.fail(unsupportedInputFormat(f))),\n  )\n\n// ---------------------------------------------------------------------------\n// Single-use token — auth rides on a query param so any\n// `globalThis.WebSocket` works (browser, Node 22+, Bun, Deno).\n// ---------------------------------------------------------------------------\n\nconst TokenWire = Schema.Struct({ token: Schema.String })\nconst decodeToken = Schema.decodeUnknownEffect(TokenWire)\n\nexport const fetchSingleUseToken = (cfg: Config) =>\n  Effect.gen(function* () {\n    const client = yield* HttpClient.HttpClient\n    const url = `${resolveHost(cfg)}/single-use-token/realtime_scribe`\n    const httpRequest = HttpClientRequest.post(url).pipe(\n      HttpClientRequest.setHeader(\"xi-api-key\", Redacted.value(cfg.apiKey)),\n    )\n    const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure))\n    if (response.status >= 400) {\n      const text = yield* response.text.pipe(Effect.orElseSucceed(() => \"\"))\n      return yield* Effect.fail(httpStatusError(response.status, text))\n    }\n    const json = yield* response.json.pipe(Effect.mapError(transportFailure))\n    const wire = yield* decodeToken(json).pipe(\n      Effect.mapError(\n        (cause) =>\n          new AiError.GenerationFailed({\n            provider: \"elevenlabs\",\n            raw: { message: \"single-use-token response missing `token` field\", cause, json },\n          }),\n      ),\n    )\n    return wire.token\n  })\n\n// ---------------------------------------------------------------------------\n// Wire schemas (server → client)\n// ---------------------------------------------------------------------------\n\nconst RealtimeWord = Schema.Struct({\n  text: Schema.String,\n  start: Schema.Number,\n  end: Schema.Number,\n  type: Schema.optional(Schema.String),\n  speaker_id: Schema.optional(Schema.NullOr(Schema.String)),\n  logprob: Schema.optional(Schema.Number),\n})\n\nconst ServerMessage = Schema.Union([\n  Schema.Struct({\n    message_type: Schema.Literal(\"session_started\"),\n    session_id: Schema.optional(Schema.String),\n  }),\n  Schema.Struct({\n    message_type: Schema.Literal(\"partial_transcript\"),\n    text: Schema.String,\n  }),\n  Schema.Struct({\n    message_type: Schema.Literal(\"committed_transcript\"),\n    text: Schema.String,\n  }),\n  Schema.Struct({\n    message_type: Schema.Literal(\"committed_transcript_with_timestamps\"),\n    text: Schema.String,\n    language_code: Schema.optional(Schema.NullOr(Schema.String)),\n    words: Schema.optional(Schema.NullOr(Schema.Array(RealtimeWord))),\n  }),\n  Schema.Struct({\n    message_type: Schema.Literals([\"error\", \"auth_error\", \"rate_limited\", \"quota_exceeded\"]),\n    error: Schema.optional(Schema.Unknown),\n  }),\n])\nconst decodeServerMessage = Schema.decodeUnknownEffect(ServerMessage)\n\nconst wireToWordTimestamp = (w: typeof RealtimeWord.Type): WordTimestamp => ({\n  text: w.text,\n  startSeconds: w.start,\n  endSeconds: w.end,\n  ...(w.speaker_id != null && { speakerId: w.speaker_id }),\n  ...(w.logprob !== undefined && { confidence: Math.exp(w.logprob) }),\n})\n\n/**\n * Map a server frame to a `TranscriptEvent`. The two `committed_*` variants\n * need disambiguation:\n *\n *   - When `include_timestamps=true` on the URL, the server emits BOTH\n *     `committed_transcript` and `committed_transcript_with_timestamps` for\n *     each segment — same text, the latter is a strict superset. The bare\n *     variant must be suppressed or callers see two finals per utterance.\n *   - When `include_timestamps=false`, the server emits ONLY\n *     `committed_transcript`. Suppressing it loses every final.\n *\n * So suppression must be conditional on `includeTimestamps`, which is what\n * `wordTimestamps` resolves to on the URL.\n */\nexport const wireToEvent =\n  (includeTimestamps: boolean) =>\n  (msg: typeof ServerMessage.Type): TranscriptEvent | undefined =>\n    Match.value(msg).pipe(\n      Match.when({ message_type: \"session_started\" }, () => undefined),\n      Match.when(\n        { message_type: \"partial_transcript\" },\n        (m): TranscriptEvent => ({ _tag: \"partial\", text: m.text }),\n      ),\n      Match.when({ message_type: \"committed_transcript\" }, (m): TranscriptEvent | undefined =>\n        includeTimestamps\n          ? undefined // superseded by the `_with_timestamps` variant\n          : { _tag: \"final\", text: m.text },\n      ),\n      Match.when({ message_type: \"committed_transcript_with_timestamps\" }, (m): TranscriptEvent => {\n        const words = m.words == null ? undefined : m.words.map(wireToWordTimestamp)\n        return {\n          _tag: \"final\",\n          text: m.text,\n          ...(m.language_code != null && { languageCode: m.language_code }),\n          ...(words !== undefined && words.length > 0 && { words }),\n        }\n      }),\n      Match.orElse(\n        (m): TranscriptEvent => ({\n          _tag: \"error\",\n          code: m.message_type,\n          message:\n            typeof m.error === \"string\"\n              ? m.error\n              : JSON.stringify(m.error ?? `ElevenLabs ${m.message_type}`),\n        }),\n      ),\n    )\n\n// ---------------------------------------------------------------------------\n// URL + frame builders\n// ---------------------------------------------------------------------------\n\nexport type RealtimeOptions = {\n  readonly model?: string\n  readonly languageCode?: string\n  readonly includeTimestamps?: boolean\n  readonly commitStrategy?: \"manual\" | \"vad\"\n}\n\nexport const buildWsUrl = (\n  cfg: Config,\n  token: string,\n  audioFormat: string,\n  opts: RealtimeOptions,\n) => {\n  const wsBase = resolveHost(cfg).replace(/^http/, \"ws\")\n  const params = new URLSearchParams({\n    token,\n    audio_format: audioFormat,\n    commit_strategy: opts.commitStrategy ?? \"vad\",\n    ...(opts.model !== undefined && { model_id: opts.model }),\n    ...(opts.languageCode !== undefined && { language_code: opts.languageCode }),\n    ...(opts.includeTimestamps === true && { include_timestamps: \"true\" }),\n  })\n  return `${wsBase}/speech-to-text/realtime?${params.toString()}`\n}\n\nexport const encodeAudioFrame = (bytes: Uint8Array, sampleRate: number) =>\n  JSON.stringify({\n    message_type: \"input_audio_chunk\",\n    audio_base_64: Encoding.encodeBase64(bytes),\n    sample_rate: sampleRate,\n  })\n\n// ---------------------------------------------------------------------------\n// Parse one server message and emit to the queue if it maps to a\n// TranscriptEvent. Invalid JSON / unknown shapes are silently dropped —\n// the connection stays open and we keep streaming subsequent messages.\n// ---------------------------------------------------------------------------\n\nconst handleServerMessage =\n  (\n    queue: Queue.Queue<TranscriptEvent, Cause.Done>,\n    mapEvent: (msg: typeof ServerMessage.Type) => TranscriptEvent | undefined,\n  ) =>\n  (raw: string) =>\n    Effect.gen(function* () {\n      const json = yield* JSONL.parseSafe(raw)\n      if (json === undefined) return\n      const decoded = yield* decodeServerMessage(json).pipe(Effect.option)\n      if (decoded._tag === \"None\") return\n      const event = mapEvent(decoded.value)\n      if (event !== undefined) yield* Queue.offer(queue, event)\n    })\n\n// ---------------------------------------------------------------------------\n// Stream<Uint8Array> → Stream<TranscriptEvent>\n//\n// Requires `HttpClient` (single-use token fetch) and\n// `Socket.WebSocketConstructor` (any `globalThis.WebSocket` works) in\n// context — `Socket.layerWebSocketConstructorGlobal` covers every\n// modern runtime.\n// ---------------------------------------------------------------------------\n\nexport const streamTranscription =\n  (cfg: Config) =>\n  <E, R>(\n    audioIn: Stream.Stream<Uint8Array, E, R>,\n    request: CommonStreamTranscribeRequest,\n  ): Stream.Stream<\n    TranscriptEvent,\n    AiError.AiError | E,\n    R | HttpClient.HttpClient | Socket.WebSocketConstructor\n  > =>\n    Stream.unwrap(\n      Effect.gen(function* () {\n        const slug = yield* inputFormatToSlug(request.inputFormat)\n        const token = yield* fetchSingleUseToken(cfg)\n        const includeTimestamps = request.wordTimestamps === true\n        const url = buildWsUrl(cfg, token, slug, {\n          ...(request.model !== undefined && { model: request.model }),\n          ...(request.language !== undefined && { languageCode: request.language }),\n          includeTimestamps,\n        })\n        const socket = yield* Socket.makeWebSocket(url, {\n          // Effect's Socket treats all close codes as errors by default — that\n          // surfaces a clean server-side close as a stream failure. Whitelist\n          // standard clean-close codes (1000 / 1001 / 1005).\n          closeCodeIsError: (code) => code !== 1000 && code !== 1001 && code !== 1005,\n        })\n        const queue = yield* Queue.bounded<TranscriptEvent, Cause.Done>(64)\n        const sampleRate = request.inputFormat.sampleRate\n\n        const write = yield* socket.writer\n        yield* Stream.runForEach(audioIn, (bytes) =>\n          write(encodeAudioFrame(bytes, sampleRate)),\n        ).pipe(Effect.ignore, Effect.forkScoped)\n\n        // `Queue.end` flushes pending events then fails the next take with\n        // `Done` — clean stream end. `Queue.shutdown` would CLEAR queued\n        // items and interrupt pending takes (wrong for graceful teardown).\n        yield* socket\n          .runString(handleServerMessage(queue, wireToEvent(includeTimestamps)))\n          .pipe(Effect.ensuring(Queue.end(queue)), Effect.forkScoped)\n\n        return Stream.fromQueue(queue)\n      }),\n    )\n"],"mappings":"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"}

package/dist/realtimeTts.d.mts

@@ -1,5 +1,6 @@
 import { VoiceSettings } from "./codec.mjs";
 import { ElevenLabsTtsModel, ElevenLabsVoiceId } from "./models.mjs";
+import { ElevenLabsRegion } from "./region.mjs";
 import { Redacted, Stream } from "effect";
 import * as Socket from "effect/unstable/socket/Socket";
 import * as AiError from "@effect-uai/core/AiError";
@@ -9,6 +10,7 @@ import { AudioChunk, AudioFormat } from "@effect-uai/core/Audio";
 type Config = {
   readonly apiKey: Redacted.Redacted;
   readonly baseUrl?: string;
+  readonly region?: ElevenLabsRegion;
 };
 /**
  * Incremental-text-in request for `/stream-input`. `voiceSettings`

package/dist/realtimeTts.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"realtimeTts.d.mts","names":[],"sources":["../src/realtimeTts.ts"],"mappings":";;;;;;;;KAaY,MAAA;EAAA,SAAoB,MAAA,EAAQ,QAAA,CAAS,QAAA;EAAA,SAAmB,OAAA;AAAA;;;;;;;KAUxD,uBAAA;EAAA,SACD,KAAA,GAAQ,kBAAA;EAAA,SACR,OAAA,EAAS,iBAAA;EAAA,SACT,YAAA,GAAe,WAAA;EAAA,SACf,YAAA;EAAA,SACA,aAAA,GAAgB,aAAA;EAAA,SAChB,QAAA;AAAA;AAAA,cAOE,UAAA,GAAc,GAAA,EAAK,MAAA,EAAQ,OAAA,EAAS,uBAAA,EAAyB,YAAA;AAAA,cAsE7D,eAAA,GACV,GAAA,EAAK,MAAA,YAEJ,MAAA,EAAQ,MAAA,CAAO,MAAA,SAAe,CAAA,EAAG,CAAA,GACjC,OAAA,EAAS,uBAAA,KACR,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA,CAAQ,OAAA,GAAU,CAAA,EAAG,CAAA,GAAI,MAAA,CAAO,oBAAA"}
+{"version":3,"file":"realtimeTts.d.mts","names":[],"sources":["../src/realtimeTts.ts"],"mappings":";;;;;;;;;KAcY,MAAA;EAAA,SACD,MAAA,EAAQ,QAAA,CAAS,QAAA;EAAA,SACjB,OAAA;EAAA,SACA,MAAA,GAAS,gBAAA;AAAA;;;;;;;KAWR,uBAAA;EAAA,SACD,KAAA,GAAQ,kBAAA;EAAA,SACR,OAAA,EAAS,iBAAA;EAAA,SACT,YAAA,GAAe,WAAA;EAAA,SACf,YAAA;EAAA,SACA,aAAA,GAAgB,aAAA;EAAA,SAChB,QAAA;AAAA;AAAA,cAOE,UAAA,GAAc,GAAA,EAAK,MAAA,EAAQ,OAAA,EAAS,uBAAA,EAAyB,YAAA;AAAA,cAsE7D,eAAA,GACV,GAAA,EAAK,MAAA,YAEJ,MAAA,EAAQ,MAAA,CAAO,MAAA,SAAe,CAAA,EAAG,CAAA,GACjC,OAAA,EAAS,uBAAA,KACR,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA,CAAQ,OAAA,GAAU,CAAA,EAAG,CAAA,GAAI,MAAA,CAAO,oBAAA"}

package/dist/realtimeTts.mjs

@@ -1,11 +1,12 @@
 import { defaultFormat, formatToOutputSlug, wireVoiceSettings } from "./codec.mjs";
+import { resolveHost } from "./region.mjs";
 import { Effect, Encoding, Queue, Redacted, Result, Schema, Stream } from "effect";
 import * as Socket from "effect/unstable/socket/Socket";
 import * as AiError from "@effect-uai/core/AiError";
 import * as JSONL from "@effect-uai/core/JSONL";
 //#region src/realtimeTts.ts
 const buildWsUrl = (cfg, request, outputFormat) => {
-	const wsBase = (cfg.baseUrl ?? "https://api.elevenlabs.io/v1").replace(/^http/, "ws");
+	const wsBase = resolveHost(cfg).replace(/^http/, "ws");
 	const params = new URLSearchParams({
 		output_format: outputFormat,
 		auto_mode: String(request.autoMode ?? true),

package/dist/realtimeTts.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"realtimeTts.mjs","names":[],"sources":["../src/realtimeTts.ts"],"sourcesContent":["import { Cause, Effect, Encoding, Queue, Redacted, Result, Schema, Stream } from \"effect\"\nimport * as Socket from \"effect/unstable/socket/Socket\"\nimport * as AiError from \"@effect-uai/core/AiError\"\nimport type { AudioChunk, AudioFormat } from \"@effect-uai/core/Audio\"\nimport * as JSONL from \"@effect-uai/core/JSONL\"\nimport {\n  defaultFormat,\n  formatToOutputSlug,\n  type VoiceSettings,\n  wireVoiceSettings,\n} from \"./codec.js\"\nimport type { ElevenLabsTtsModel, ElevenLabsVoiceId } from \"./models.js\"\n\nexport type Config = { readonly apiKey: Redacted.Redacted; readonly baseUrl?: string }\n\nexport type { VoiceSettings } from \"./codec.js\"\n\n/**\n * Incremental-text-in request for `/stream-input`. `voiceSettings`\n * applies only on the BOS frame — mid-stream voice changes are\n * rejected. `autoMode: true` (default) lets the model pick flush\n * boundaries, which is what you want for LLM-token streams.\n */\nexport type StreamSynthesizeRequest = {\n  readonly model?: ElevenLabsTtsModel\n  readonly voiceId: ElevenLabsVoiceId\n  readonly outputFormat?: AudioFormat\n  readonly languageCode?: string\n  readonly voiceSettings?: VoiceSettings\n  readonly autoMode?: boolean\n}\n\n// ---------------------------------------------------------------------------\n// URL + frame builders\n// ---------------------------------------------------------------------------\n\nexport const buildWsUrl = (cfg: Config, request: StreamSynthesizeRequest, outputFormat: string) => {\n  const wsBase = (cfg.baseUrl ?? \"https://api.elevenlabs.io/v1\").replace(/^http/, \"ws\")\n  const params = new URLSearchParams({\n    output_format: outputFormat,\n    auto_mode: String(request.autoMode ?? true),\n    ...(request.model !== undefined && { model_id: request.model }),\n    ...(request.languageCode !== undefined && { language_code: request.languageCode }),\n  })\n  return `${wsBase}/text-to-speech/${request.voiceId}/stream-input?${params.toString()}`\n}\n\nconst bosFrame = (cfg: Config, request: StreamSynthesizeRequest) => {\n  const vs = wireVoiceSettings(request.voiceSettings)\n  return JSON.stringify({\n    text: \" \",\n    \"xi-api-key\": Redacted.value(cfg.apiKey),\n    ...(vs !== undefined && { voice_settings: vs }),\n  })\n}\n\nconst textFrame = (text: string) => JSON.stringify({ text: text.endsWith(\" \") ? text : `${text} ` })\nconst eosFrame = JSON.stringify({ text: \"\" })\n\n// ---------------------------------------------------------------------------\n// Wire schema (server → client) + helpers\n// ---------------------------------------------------------------------------\n\nconst ServerFrame = Schema.Struct({\n  audio: Schema.optional(Schema.NullOr(Schema.String)),\n  isFinal: Schema.optional(Schema.NullOr(Schema.Boolean)),\n  error: Schema.optional(Schema.Unknown),\n  message: Schema.optional(Schema.String),\n})\nconst decodeServerFrame = Schema.decodeUnknownEffect(ServerFrame)\n\nconst decodeAudio = (b64: string): Effect.Effect<Uint8Array, AiError.AiError> =>\n  Result.match(Encoding.decodeBase64(b64), {\n    onSuccess: Effect.succeed,\n    onFailure: (cause) =>\n      Effect.fail(\n        new AiError.GenerationFailed({\n          provider: \"elevenlabs\",\n          raw: { message: \"failed to decode audio frame\", cause },\n        }),\n      ),\n  })\n\nconst handleServerFrame = (queue: Queue.Queue<AudioChunk, Cause.Done>) => (raw: string) =>\n  Effect.gen(function* () {\n    const json = yield* JSONL.parseSafe(raw)\n    if (json === undefined) return\n    const decoded = yield* decodeServerFrame(json).pipe(Effect.option)\n    if (decoded._tag === \"None\") return\n    const frame = decoded.value\n    if (frame.error !== undefined) {\n      yield* Effect.logWarning(\"[elevenlabs-tts] server error frame\", {\n        error: frame.error,\n        message: frame.message,\n      })\n      return\n    }\n    if (frame.audio == null || frame.audio === \"\") return\n    const bytes = yield* decodeAudio(frame.audio).pipe(Effect.option)\n    if (bytes._tag === \"Some\") yield* Queue.offer(queue, { bytes: bytes.value })\n  })\n\n// ---------------------------------------------------------------------------\n// Stream<string> → Stream<AudioChunk>. Requires `Socket.WebSocketConstructor`.\n// ---------------------------------------------------------------------------\n\nexport const streamSynthesis =\n  (cfg: Config) =>\n  <E, R>(\n    textIn: Stream.Stream<string, E, R>,\n    request: StreamSynthesizeRequest,\n  ): Stream.Stream<AudioChunk, AiError.AiError | E, R | Socket.WebSocketConstructor> =>\n    Stream.unwrap(\n      Effect.gen(function* () {\n        const slug = yield* formatToOutputSlug(request.outputFormat ?? defaultFormat)\n        // ElevenLabs closes `/stream-input` with code 1000 after delivering the\n        // final audio chunk. Effect's default treats all close codes as errors,\n        // which would surface as a stream failure right after the last audio\n        // arrives. Whitelist standard clean-close codes.\n        const socket = yield* Socket.makeWebSocket(buildWsUrl(cfg, request, slug), {\n          closeCodeIsError: (code) => code !== 1000 && code !== 1001 && code !== 1005,\n        })\n        const queue = yield* Queue.bounded<AudioChunk, Cause.Done>(64)\n        const write = yield* socket.writer\n\n        // Writer fiber: BOS → drain text stream → EOS. Socket-side failures\n        // end this fiber; the reader still surfaces a clean stream end via\n        // `Queue.end` (in the ensuring below) when the upstream WS closes.\n        yield* Effect.gen(function* () {\n          yield* write(bosFrame(cfg, request))\n          yield* Stream.runForEach(textIn, (text) =>\n            text.length === 0 ? Effect.void : write(textFrame(text)),\n          )\n          yield* write(eosFrame)\n        }).pipe(Effect.ignore, Effect.forkScoped)\n\n        // Reader fiber. `ensuring(Queue.end)` flushes pending chunks then\n        // fails the next take with `Done`, which `Stream.fromQueue` treats\n        // as a clean end. (`Queue.shutdown` would CLEAR queued items and\n        // interrupt pending takes — wrong for graceful teardown.)\n        yield* socket\n          .runString(handleServerFrame(queue))\n          .pipe(Effect.ensuring(Queue.end(queue)), Effect.forkScoped)\n\n        return Stream.fromQueue(queue)\n      }),\n    )\n"],"mappings":"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"}
+{"version":3,"file":"realtimeTts.mjs","names":[],"sources":["../src/realtimeTts.ts"],"sourcesContent":["import { Cause, Effect, Encoding, Queue, Redacted, Result, Schema, Stream } from \"effect\"\nimport * as Socket from \"effect/unstable/socket/Socket\"\nimport * as AiError from \"@effect-uai/core/AiError\"\nimport type { AudioChunk, AudioFormat } from \"@effect-uai/core/Audio\"\nimport * as JSONL from \"@effect-uai/core/JSONL\"\nimport {\n  defaultFormat,\n  formatToOutputSlug,\n  type VoiceSettings,\n  wireVoiceSettings,\n} from \"./codec.js\"\nimport type { ElevenLabsTtsModel, ElevenLabsVoiceId } from \"./models.js\"\nimport { type ElevenLabsRegion, resolveHost } from \"./region.js\"\n\nexport type Config = {\n  readonly apiKey: Redacted.Redacted\n  readonly baseUrl?: string\n  readonly region?: ElevenLabsRegion\n}\n\nexport type { VoiceSettings } from \"./codec.js\"\n\n/**\n * Incremental-text-in request for `/stream-input`. `voiceSettings`\n * applies only on the BOS frame — mid-stream voice changes are\n * rejected. `autoMode: true` (default) lets the model pick flush\n * boundaries, which is what you want for LLM-token streams.\n */\nexport type StreamSynthesizeRequest = {\n  readonly model?: ElevenLabsTtsModel\n  readonly voiceId: ElevenLabsVoiceId\n  readonly outputFormat?: AudioFormat\n  readonly languageCode?: string\n  readonly voiceSettings?: VoiceSettings\n  readonly autoMode?: boolean\n}\n\n// ---------------------------------------------------------------------------\n// URL + frame builders\n// ---------------------------------------------------------------------------\n\nexport const buildWsUrl = (cfg: Config, request: StreamSynthesizeRequest, outputFormat: string) => {\n  const wsBase = resolveHost(cfg).replace(/^http/, \"ws\")\n  const params = new URLSearchParams({\n    output_format: outputFormat,\n    auto_mode: String(request.autoMode ?? true),\n    ...(request.model !== undefined && { model_id: request.model }),\n    ...(request.languageCode !== undefined && { language_code: request.languageCode }),\n  })\n  return `${wsBase}/text-to-speech/${request.voiceId}/stream-input?${params.toString()}`\n}\n\nconst bosFrame = (cfg: Config, request: StreamSynthesizeRequest) => {\n  const vs = wireVoiceSettings(request.voiceSettings)\n  return JSON.stringify({\n    text: \" \",\n    \"xi-api-key\": Redacted.value(cfg.apiKey),\n    ...(vs !== undefined && { voice_settings: vs }),\n  })\n}\n\nconst textFrame = (text: string) => JSON.stringify({ text: text.endsWith(\" \") ? text : `${text} ` })\nconst eosFrame = JSON.stringify({ text: \"\" })\n\n// ---------------------------------------------------------------------------\n// Wire schema (server → client) + helpers\n// ---------------------------------------------------------------------------\n\nconst ServerFrame = Schema.Struct({\n  audio: Schema.optional(Schema.NullOr(Schema.String)),\n  isFinal: Schema.optional(Schema.NullOr(Schema.Boolean)),\n  error: Schema.optional(Schema.Unknown),\n  message: Schema.optional(Schema.String),\n})\nconst decodeServerFrame = Schema.decodeUnknownEffect(ServerFrame)\n\nconst decodeAudio = (b64: string): Effect.Effect<Uint8Array, AiError.AiError> =>\n  Result.match(Encoding.decodeBase64(b64), {\n    onSuccess: Effect.succeed,\n    onFailure: (cause) =>\n      Effect.fail(\n        new AiError.GenerationFailed({\n          provider: \"elevenlabs\",\n          raw: { message: \"failed to decode audio frame\", cause },\n        }),\n      ),\n  })\n\nconst handleServerFrame = (queue: Queue.Queue<AudioChunk, Cause.Done>) => (raw: string) =>\n  Effect.gen(function* () {\n    const json = yield* JSONL.parseSafe(raw)\n    if (json === undefined) return\n    const decoded = yield* decodeServerFrame(json).pipe(Effect.option)\n    if (decoded._tag === \"None\") return\n    const frame = decoded.value\n    if (frame.error !== undefined) {\n      yield* Effect.logWarning(\"[elevenlabs-tts] server error frame\", {\n        error: frame.error,\n        message: frame.message,\n      })\n      return\n    }\n    if (frame.audio == null || frame.audio === \"\") return\n    const bytes = yield* decodeAudio(frame.audio).pipe(Effect.option)\n    if (bytes._tag === \"Some\") yield* Queue.offer(queue, { bytes: bytes.value })\n  })\n\n// ---------------------------------------------------------------------------\n// Stream<string> → Stream<AudioChunk>. Requires `Socket.WebSocketConstructor`.\n// ---------------------------------------------------------------------------\n\nexport const streamSynthesis =\n  (cfg: Config) =>\n  <E, R>(\n    textIn: Stream.Stream<string, E, R>,\n    request: StreamSynthesizeRequest,\n  ): Stream.Stream<AudioChunk, AiError.AiError | E, R | Socket.WebSocketConstructor> =>\n    Stream.unwrap(\n      Effect.gen(function* () {\n        const slug = yield* formatToOutputSlug(request.outputFormat ?? defaultFormat)\n        // ElevenLabs closes `/stream-input` with code 1000 after delivering the\n        // final audio chunk. Effect's default treats all close codes as errors,\n        // which would surface as a stream failure right after the last audio\n        // arrives. Whitelist standard clean-close codes.\n        const socket = yield* Socket.makeWebSocket(buildWsUrl(cfg, request, slug), {\n          closeCodeIsError: (code) => code !== 1000 && code !== 1001 && code !== 1005,\n        })\n        const queue = yield* Queue.bounded<AudioChunk, Cause.Done>(64)\n        const write = yield* socket.writer\n\n        // Writer fiber: BOS → drain text stream → EOS. Socket-side failures\n        // end this fiber; the reader still surfaces a clean stream end via\n        // `Queue.end` (in the ensuring below) when the upstream WS closes.\n        yield* Effect.gen(function* () {\n          yield* write(bosFrame(cfg, request))\n          yield* Stream.runForEach(textIn, (text) =>\n            text.length === 0 ? Effect.void : write(textFrame(text)),\n          )\n          yield* write(eosFrame)\n        }).pipe(Effect.ignore, Effect.forkScoped)\n\n        // Reader fiber. `ensuring(Queue.end)` flushes pending chunks then\n        // fails the next take with `Done`, which `Stream.fromQueue` treats\n        // as a clean end. (`Queue.shutdown` would CLEAR queued items and\n        // interrupt pending takes — wrong for graceful teardown.)\n        yield* socket\n          .runString(handleServerFrame(queue))\n          .pipe(Effect.ensuring(Queue.end(queue)), Effect.forkScoped)\n\n        return Stream.fromQueue(queue)\n      }),\n    )\n"],"mappings":"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"}

package/dist/region.d.mts

@@ -0,0 +1,29 @@
+//#region src/region.d.ts
+/**
+ * ElevenLabs regional residency endpoints. The default workspace runs
+ * against `api.elevenlabs.io`; EU- and IN-residency workspaces run
+ * against `api.{eu,in}.residency.elevenlabs.io` (REST + WSS).
+ *
+ * API keys are workspace-bound — a key minted in an EU workspace must
+ * be used against the EU host (and vice versa). Mixing key/host
+ * surfaces as `401 PERMISSION_DENIED`.
+ *
+ * Reference: https://elevenlabs.io/docs/overview/administration/data-residency
+ */
+type ElevenLabsRegion = "default" | "eu" | "in" | (string & {});
+/**
+ * Resolve the HTTP base URL from a Config. `baseUrl` wins when set;
+ * otherwise the host is computed from `region`. Unknown region strings
+ * pass through as `api.{region}.residency.elevenlabs.io/v1` for forward
+ * compat.
+ *
+ * WS code derives its `wss://` URL by substituting `http→ws` on the
+ * resolved host.
+ */
+declare const resolveHost: (cfg: {
+  readonly baseUrl?: string;
+  readonly region?: ElevenLabsRegion;
+}) => string;
+//#endregion
+export { ElevenLabsRegion, resolveHost };
+//# sourceMappingURL=region.d.mts.map

package/dist/region.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"region.d.mts","names":[],"sources":["../src/region.ts"],"mappings":";;AAaA;;;;;AAaA;;;;;KAbY,gBAAA;;;;;;;;;;cAaC,WAAA,GAAe,GAAA;EAAA,SACjB,OAAA;EAAA,SACA,MAAA,GAAS,gBAAA;AAAA"}

package/dist/region.mjs

@@ -0,0 +1,20 @@
+//#region src/region.ts
+const DEFAULT_HOST = "https://api.elevenlabs.io/v1";
+/**
+* Resolve the HTTP base URL from a Config. `baseUrl` wins when set;
+* otherwise the host is computed from `region`. Unknown region strings
+* pass through as `api.{region}.residency.elevenlabs.io/v1` for forward
+* compat.
+*
+* WS code derives its `wss://` URL by substituting `http→ws` on the
+* resolved host.
+*/
+const resolveHost = (cfg) => {
+	if (cfg.baseUrl !== void 0) return cfg.baseUrl;
+	if (cfg.region === void 0 || cfg.region === "default") return DEFAULT_HOST;
+	return `https://api.${cfg.region}.residency.elevenlabs.io/v1`;
+};
+//#endregion
+export { resolveHost };
+
+//# sourceMappingURL=region.mjs.map

package/dist/region.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"region.mjs","names":[],"sources":["../src/region.ts"],"sourcesContent":["/**\n * ElevenLabs regional residency endpoints. The default workspace runs\n * against `api.elevenlabs.io`; EU- and IN-residency workspaces run\n * against `api.{eu,in}.residency.elevenlabs.io` (REST + WSS).\n *\n * API keys are workspace-bound — a key minted in an EU workspace must\n * be used against the EU host (and vice versa). Mixing key/host\n * surfaces as `401 PERMISSION_DENIED`.\n *\n * Reference: https://elevenlabs.io/docs/overview/administration/data-residency\n */\n\n// eslint-disable-next-line @typescript-eslint/ban-types\nexport type ElevenLabsRegion = \"default\" | \"eu\" | \"in\" | (string & {})\n\nconst DEFAULT_HOST = \"https://api.elevenlabs.io/v1\"\n\n/**\n * Resolve the HTTP base URL from a Config. `baseUrl` wins when set;\n * otherwise the host is computed from `region`. Unknown region strings\n * pass through as `api.{region}.residency.elevenlabs.io/v1` for forward\n * compat.\n *\n * WS code derives its `wss://` URL by substituting `http→ws` on the\n * resolved host.\n */\nexport const resolveHost = (cfg: {\n  readonly baseUrl?: string\n  readonly region?: ElevenLabsRegion\n}): string => {\n  if (cfg.baseUrl !== undefined) return cfg.baseUrl\n  if (cfg.region === undefined || cfg.region === \"default\") return DEFAULT_HOST\n  return `https://api.${cfg.region}.residency.elevenlabs.io/v1`\n}\n"],"mappings":";AAeA,MAAM,eAAe;;;;;;;;;;AAWrB,MAAa,eAAe,QAGd;AACZ,KAAI,IAAI,YAAY,KAAA,EAAW,QAAO,IAAI;AAC1C,KAAI,IAAI,WAAW,KAAA,KAAa,IAAI,WAAW,UAAW,QAAO;AACjE,QAAO,eAAe,IAAI,OAAO"}

package/dist/region.test.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/region.test.mjs

@@ -0,0 +1,30 @@
+import { i as it, n as globalExpect, r as describe } from "./dist-DMsg8YLb.mjs";
+import { resolveHost } from "./region.mjs";
+//#region src/region.test.ts
+describe("elevenlabs/region.resolveHost", () => {
+	it("returns default host when no region or baseUrl", () => {
+		globalExpect(resolveHost({})).toBe("https://api.elevenlabs.io/v1");
+	});
+	it("returns default host for region 'default'", () => {
+		globalExpect(resolveHost({ region: "default" })).toBe("https://api.elevenlabs.io/v1");
+	});
+	it("computes EU residency host for region 'eu'", () => {
+		globalExpect(resolveHost({ region: "eu" })).toBe("https://api.eu.residency.elevenlabs.io/v1");
+	});
+	it("computes IN residency host for region 'in'", () => {
+		globalExpect(resolveHost({ region: "in" })).toBe("https://api.in.residency.elevenlabs.io/v1");
+	});
+	it("passes unknown region through as residency host", () => {
+		globalExpect(resolveHost({ region: "ap" })).toBe("https://api.ap.residency.elevenlabs.io/v1");
+	});
+	it("baseUrl wins over region", () => {
+		globalExpect(resolveHost({
+			baseUrl: "http://localhost:8080/v1",
+			region: "eu"
+		})).toBe("http://localhost:8080/v1");
+	});
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=region.test.mjs.map

package/dist/region.test.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"region.test.mjs","names":[],"sources":["../src/region.test.ts"],"sourcesContent":["import { describe, expect, it } from \"vitest\"\nimport { resolveHost } from \"./region.js\"\n\ndescribe(\"elevenlabs/region.resolveHost\", () => {\n  it(\"returns default host when no region or baseUrl\", () => {\n    expect(resolveHost({})).toBe(\"https://api.elevenlabs.io/v1\")\n  })\n\n  it(\"returns default host for region 'default'\", () => {\n    expect(resolveHost({ region: \"default\" })).toBe(\"https://api.elevenlabs.io/v1\")\n  })\n\n  it(\"computes EU residency host for region 'eu'\", () => {\n    expect(resolveHost({ region: \"eu\" })).toBe(\"https://api.eu.residency.elevenlabs.io/v1\")\n  })\n\n  it(\"computes IN residency host for region 'in'\", () => {\n    expect(resolveHost({ region: \"in\" })).toBe(\"https://api.in.residency.elevenlabs.io/v1\")\n  })\n\n  it(\"passes unknown region through as residency host\", () => {\n    expect(resolveHost({ region: \"ap\" })).toBe(\"https://api.ap.residency.elevenlabs.io/v1\")\n  })\n\n  it(\"baseUrl wins over region\", () => {\n    expect(resolveHost({ baseUrl: \"http://localhost:8080/v1\", region: \"eu\" })).toBe(\n      \"http://localhost:8080/v1\",\n    )\n  })\n})\n"],"mappings":";;;AAGA,SAAS,uCAAuC;AAC9C,IAAG,wDAAwD;AACzD,eAAO,YAAY,EAAE,CAAC,CAAC,CAAC,KAAK,+BAA+B;GAC5D;AAEF,IAAG,mDAAmD;AACpD,eAAO,YAAY,EAAE,QAAQ,WAAW,CAAC,CAAC,CAAC,KAAK,+BAA+B;GAC/E;AAEF,IAAG,oDAAoD;AACrD,eAAO,YAAY,EAAE,QAAQ,MAAM,CAAC,CAAC,CAAC,KAAK,4CAA4C;GACvF;AAEF,IAAG,oDAAoD;AACrD,eAAO,YAAY,EAAE,QAAQ,MAAM,CAAC,CAAC,CAAC,KAAK,4CAA4C;GACvF;AAEF,IAAG,yDAAyD;AAC1D,eAAO,YAAY,EAAE,QAAQ,MAAM,CAAC,CAAC,CAAC,KAAK,4CAA4C;GACvF;AAEF,IAAG,kCAAkC;AACnC,eAAO,YAAY;GAAE,SAAS;GAA4B,QAAQ;GAAM,CAAC,CAAC,CAAC,KACzE,2BACD;GACD;EACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@effect-uai/elevenlabs",
-  "version": "0.5.2",
+  "version": "0.6.0",
   "description": "ElevenLabs speech-to-text and text-to-speech provider for @effect-uai/core.",
   "keywords": [
     "ai",
@@ -51,7 +51,7 @@
   "devDependencies": {
     "effect": "4.0.0-beta.57",
     "typescript": "^6.0.3",
-    "@effect-uai/core": "0.5.2"
+    "@effect-uai/core": "0.6.0"
   },
   "peerDependencies": {
     "@effect-uai/core": ">=0.2.0 <1",

package/src/ElevenLabsSynthesizer.ts

@@ -1,11 +1,14 @@
-import { Context, Effect, Layer, Redacted, Stream } from "effect"
+import { Array as Arr, Context, Effect, Layer, Redacted, Stream } from "effect"
 import { HttpClient, HttpClientRequest } from "effect/unstable/http"
 import * as Socket from "effect/unstable/socket/Socket"
 import type * as AiError from "@effect-uai/core/AiError"
 import type { AudioBlob, AudioChunk } from "@effect-uai/core/Audio"
 import {
   type CommonStreamSynthesizeRequest,
+  type CommonSynthesizeDialogueRequest,
   type CommonSynthesizeRequest,
+  type CustomPronunciation,
+  MultiSpeakerTts,
   SpeechSynthesizer,
   type SpeechSynthesizerService,
   TtsIncrementalText,
@@ -20,6 +23,7 @@ import {
 } from "./codec.js"
 import type { ElevenLabsTtsModel, ElevenLabsVoiceId } from "./models.js"
 import { streamSynthesis as realtimeStream } from "./realtimeTts.js"
+import { type ElevenLabsRegion, resolveHost } from "./region.js"
 
 // ---------------------------------------------------------------------------
 // Public types
@@ -46,6 +50,8 @@ export type ElevenLabsSynthesizerService = {
     r: ElevenLabsSynthesizeRequest,
   ) => Stream.Stream<AudioChunk, AiError.AiError>
   readonly streamSynthesisFrom: SpeechSynthesizerService["streamSynthesisFrom"]
+  readonly synthesizeDialogue: SpeechSynthesizerService["synthesizeDialogue"]
+  readonly streamSynthesizeDialogue: SpeechSynthesizerService["streamSynthesizeDialogue"]
 }
 
 export class ElevenLabsSynthesizer extends Context.Service<
@@ -53,14 +59,65 @@ export class ElevenLabsSynthesizer extends Context.Service<
   ElevenLabsSynthesizerService
 >()("@betalyra/effect-uai/providers/elevenlabs/ElevenLabsSynthesizer") {}
 
-export type Config = { readonly apiKey: Redacted.Redacted; readonly baseUrl?: string }
+export type Config = {
+  readonly apiKey: Redacted.Redacted
+  readonly baseUrl?: string
+  readonly region?: ElevenLabsRegion
+}
+
+// ---------------------------------------------------------------------------
+// Pronunciations — SSML <phoneme> rewrite (gated to legacy models)
+// ---------------------------------------------------------------------------
+
+/**
+ * Models that honor inline `<phoneme>` SSML tags. Other models silently
+ * drop the tags server-side, so we don't bother rewriting the text for
+ * them — the pronunciation overrides are silently ignored.
+ *
+ * Reference: https://elevenlabs.io/docs/best-practices/prompting/controls
+ */
+const PHONEME_SUPPORTED_MODELS: ReadonlySet<string> = new Set([
+  "eleven_flash_v2",
+  "eleven_english_v1",
+  "eleven_monolingual_v1",
+])
+
+const wireAlphabet = (encoding: CustomPronunciation["encoding"]): string | undefined =>
+  encoding === "ipa" ? "ipa" : encoding === "cmu-arpabet" ? "cmu-arpabet" : undefined
+
+const phonemeTag = (phrase: string, pronunciation: string, alphabet: string): string =>
+  `<phoneme alphabet="${alphabet}" ph="${pronunciation}">${phrase}</phoneme>`
+
+const escapeForRegex = (s: string): string => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")
+
+/**
+ * Apply pronunciation overrides to a text string. Only applies for
+ * phoneme-supported models; only IPA and CMU Arpabet are honored
+ * (x-sampa is silently dropped). Whole-word, case-insensitive
+ * replacement.
+ */
+const applyPronunciations = (
+  text: string,
+  model: string,
+  pronunciations: ReadonlyArray<CustomPronunciation> | undefined,
+): string => {
+  if (pronunciations === undefined || !PHONEME_SUPPORTED_MODELS.has(model)) return text
+  return Arr.reduce(pronunciations, text, (acc, p) => {
+    const alphabet = wireAlphabet(p.encoding)
+    if (alphabet === undefined) return acc
+    return acc.replace(
+      new RegExp(`\\b${escapeForRegex(p.phrase)}\\b`, "i"),
+      phonemeTag(p.phrase, p.pronunciation, alphabet),
+    )
+  })
+}
 
 // ---------------------------------------------------------------------------
 // Codec — request → JSON body
 // ---------------------------------------------------------------------------
 
 const buildBody = (r: ElevenLabsSynthesizeRequest) => ({
-  text: r.text,
+  text: applyPronunciations(r.text, r.model, r.pronunciations),
   model_id: r.model,
   ...(r.languageCode !== undefined && { language_code: r.languageCode }),
   ...(r.seed !== undefined && { seed: r.seed }),
@@ -70,16 +127,75 @@ const buildBody = (r: ElevenLabsSynthesizeRequest) => ({
 })
 
 // ---------------------------------------------------------------------------
-// HTTP plumbing (sync + chunked-HTTP streaming)
+// Dialogue — POST /v1/text-to-dialogue (+ /stream variant)
 // ---------------------------------------------------------------------------
 
-const baseUrl = (cfg: Config) => cfg.baseUrl ?? "https://api.elevenlabs.io/v1"
+const DEFAULT_DIALOGUE_MODEL = "eleven_v3"
+
+const buildDialogueBody = (r: CommonSynthesizeDialogueRequest) => ({
+  inputs: r.turns.map((t) => ({
+    voice_id: t.voiceId,
+    text: applyPronunciations(t.text, r.model, r.pronunciations),
+  })),
+  model_id: r.model ?? DEFAULT_DIALOGUE_MODEL,
+  ...(r.languageCode !== undefined && { language_code: r.languageCode }),
+})
+
+const buildDialogueHttpRequest = (
+  cfg: Config,
+  r: CommonSynthesizeDialogueRequest,
+  path: "" | "/stream",
+) =>
+  Effect.gen(function* () {
+    const format = r.outputFormat ?? defaultFormat
+    const slug = yield* formatToOutputSlug(format)
+    const url = `${resolveHost(cfg)}/text-to-dialogue${path}?output_format=${slug}`
+    const httpRequest = HttpClientRequest.post(url).pipe(
+      HttpClientRequest.setHeader("xi-api-key", Redacted.value(cfg.apiKey)),
+      HttpClientRequest.bodyJsonUnsafe(buildDialogueBody(r)),
+    )
+    return { httpRequest, format }
+  })
+
+const synthesizeDialogueImpl = (cfg: Config) => (request: CommonSynthesizeDialogueRequest) =>
+  Effect.gen(function* () {
+    const client = yield* HttpClient.HttpClient
+    const { httpRequest, format } = yield* buildDialogueHttpRequest(cfg, request, "")
+    const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure))
+    if (response.status >= 400) {
+      const text = yield* response.text.pipe(Effect.orElseSucceed(() => ""))
+      return yield* Effect.fail(httpStatusError(response.status, text))
+    }
+    const bytes = yield* response.arrayBuffer.pipe(Effect.mapError(transportFailure))
+    return { format, bytes: new Uint8Array(bytes) } satisfies AudioBlob
+  })
+
+const streamSynthesizeDialogueImpl = (cfg: Config) => (request: CommonSynthesizeDialogueRequest) =>
+  Stream.unwrap(
+    Effect.gen(function* () {
+      const client = yield* HttpClient.HttpClient
+      const { httpRequest } = yield* buildDialogueHttpRequest(cfg, request, "/stream")
+      const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure))
+      if (response.status >= 400) {
+        const text = yield* response.text.pipe(Effect.orElseSucceed(() => ""))
+        return Stream.fail(httpStatusError(response.status, text))
+      }
+      return response.stream.pipe(
+        Stream.mapError(transportFailure),
+        Stream.map((bytes): AudioChunk => ({ bytes })),
+      )
+    }),
+  )
+
+// ---------------------------------------------------------------------------
+// HTTP plumbing (sync + chunked-HTTP streaming)
+// ---------------------------------------------------------------------------
 
 const buildHttpRequest = (cfg: Config, r: ElevenLabsSynthesizeRequest, path: "" | "/stream") =>
   Effect.gen(function* () {
     const format = r.outputFormat ?? defaultFormat
     const slug = yield* formatToOutputSlug(format)
-    const url = `${baseUrl(cfg)}/text-to-speech/${r.voiceId}${path}?output_format=${slug}`
+    const url = `${resolveHost(cfg)}/text-to-speech/${r.voiceId}${path}?output_format=${slug}`
     const httpRequest = HttpClientRequest.post(url).pipe(
       HttpClientRequest.setHeader("xi-api-key", Redacted.value(cfg.apiKey)),
       HttpClientRequest.bodyJsonUnsafe(buildBody(r)),
@@ -134,15 +250,25 @@ export const make = (cfg: Config) =>
         realtimeStream(cfg)(textIn, request as ElevenLabsSynthesizeRequest).pipe(
           Stream.provideService(Socket.WebSocketConstructor, ctor),
         ),
+      synthesizeDialogue: (request) =>
+        synthesizeDialogueImpl(cfg)(request).pipe(
+          Effect.provideService(HttpClient.HttpClient, client),
+        ),
+      streamSynthesizeDialogue: (request) =>
+        streamSynthesizeDialogueImpl(cfg)(request).pipe(
+          Stream.provideService(HttpClient.HttpClient, client),
+        ),
     } satisfies ElevenLabsSynthesizerService
   })
 
 /**
  * Layer registers `ElevenLabsSynthesizer`, the generic
- * `SpeechSynthesizer`, **and `TtsIncrementalText`** — incremental
- * text-in is wired to the realtime `/stream-input` WebSocket. Provide
- * `Socket.layerWebSocketConstructorGlobal` and an `HttpClient` Layer at
- * the call site.
+ * `SpeechSynthesizer`, the `TtsIncrementalText` marker (incremental
+ * text-in via `/stream-input` WebSocket), **and `MultiSpeakerTts`** —
+ * multi-speaker dialogue is wired to `POST /v1/text-to-dialogue`
+ * (sync) and `/v1/text-to-dialogue/stream` (chunked). Provide
+ * `Socket.layerWebSocketConstructorGlobal` and an `HttpClient` Layer
+ * at the call site.
  */
 export const layer = (cfg: Config) =>
   Layer.mergeAll(
@@ -158,8 +284,11 @@ export const layer = (cfg: Config) =>
             s.streamSynthesis(req as ElevenLabsSynthesizeRequest),
           streamSynthesisFrom: (textIn, req: CommonStreamSynthesizeRequest) =>
             s.streamSynthesisFrom(textIn, req),
+          synthesizeDialogue: s.synthesizeDialogue,
+          streamSynthesizeDialogue: s.streamSynthesizeDialogue,
         }),
       ),
     ),
     Layer.succeed(TtsIncrementalText, undefined),
+    Layer.succeed(MultiSpeakerTts, undefined),
   )

package/src/ElevenLabsTranscriber.ts

@@ -12,6 +12,7 @@ import {
 import { audioToBlob, defaultFileName, httpStatusError, transportFailure } from "./codec.js"
 import type { ElevenLabsSttModel } from "./models.js"
 import { streamTranscription } from "./realtimeStt.js"
+import { type ElevenLabsRegion, resolveHost } from "./region.js"
 
 // ---------------------------------------------------------------------------
 // Public types
@@ -43,7 +44,11 @@ export class ElevenLabsTranscriber extends Context.Service<
   ElevenLabsTranscriberService
 >()("@betalyra/effect-uai/providers/elevenlabs/ElevenLabsTranscriber") {}
 
-export type Config = { readonly apiKey: Redacted.Redacted; readonly baseUrl?: string }
+export type Config = {
+  readonly apiKey: Redacted.Redacted
+  readonly baseUrl?: string
+  readonly region?: ElevenLabsRegion
+}
 
 // ---------------------------------------------------------------------------
 // Response schema
@@ -103,13 +108,11 @@ const buildForm = (request: ElevenLabsTranscribeRequest) =>
 // HTTP plumbing
 // ---------------------------------------------------------------------------
 
-const baseUrl = (cfg: Config) => cfg.baseUrl ?? "https://api.elevenlabs.io/v1"
-
 const transcribeImpl = (cfg: Config) => (request: ElevenLabsTranscribeRequest) =>
   Effect.gen(function* () {
     const client = yield* HttpClient.HttpClient
     const form = yield* buildForm(request)
-    const httpRequest = HttpClientRequest.post(`${baseUrl(cfg)}/speech-to-text`).pipe(
+    const httpRequest = HttpClientRequest.post(`${resolveHost(cfg)}/speech-to-text`).pipe(
       HttpClientRequest.setHeader("xi-api-key", Redacted.value(cfg.apiKey)),
       HttpClientRequest.bodyFormData(form),
     )

package/src/index.ts

@@ -2,3 +2,4 @@ export * as ElevenLabsSynthesizer from "./ElevenLabsSynthesizer.js"
 export * as ElevenLabsTranscriber from "./ElevenLabsTranscriber.js"
 export * as codec from "./codec.js"
 export * from "./models.js"
+export * from "./region.js"

package/src/realtimeStt.ts

@@ -7,8 +7,13 @@ import * as JSONL from "@effect-uai/core/JSONL"
 import type { TranscriptEvent, WordTimestamp } from "@effect-uai/core/Transcript"
 import type { CommonStreamTranscribeRequest } from "@effect-uai/core/Transcriber"
 import { httpStatusError, transportFailure } from "./codec.js"
+import { type ElevenLabsRegion, resolveHost } from "./region.js"
 
-export type Config = { readonly apiKey: Redacted.Redacted; readonly baseUrl?: string }
+export type Config = {
+  readonly apiKey: Redacted.Redacted
+  readonly baseUrl?: string
+  readonly region?: ElevenLabsRegion
+}
 
 // ---------------------------------------------------------------------------
 // AudioFormat → audio_format slug
@@ -43,7 +48,7 @@ const decodeToken = Schema.decodeUnknownEffect(TokenWire)
 export const fetchSingleUseToken = (cfg: Config) =>
   Effect.gen(function* () {
     const client = yield* HttpClient.HttpClient
-    const url = `${cfg.baseUrl ?? "https://api.elevenlabs.io/v1"}/single-use-token/realtime_scribe`
+    const url = `${resolveHost(cfg)}/single-use-token/realtime_scribe`
     const httpRequest = HttpClientRequest.post(url).pipe(
       HttpClientRequest.setHeader("xi-api-key", Redacted.value(cfg.apiKey)),
     )
@@ -178,7 +183,7 @@ export const buildWsUrl = (
   audioFormat: string,
   opts: RealtimeOptions,
 ) => {
-  const wsBase = (cfg.baseUrl ?? "https://api.elevenlabs.io/v1").replace(/^http/, "ws")
+  const wsBase = resolveHost(cfg).replace(/^http/, "ws")
   const params = new URLSearchParams({
     token,
     audio_format: audioFormat,

package/src/realtimeTts.ts

@@ -10,8 +10,13 @@ import {
   wireVoiceSettings,
 } from "./codec.js"
 import type { ElevenLabsTtsModel, ElevenLabsVoiceId } from "./models.js"
+import { type ElevenLabsRegion, resolveHost } from "./region.js"
 
-export type Config = { readonly apiKey: Redacted.Redacted; readonly baseUrl?: string }
+export type Config = {
+  readonly apiKey: Redacted.Redacted
+  readonly baseUrl?: string
+  readonly region?: ElevenLabsRegion
+}
 
 export type { VoiceSettings } from "./codec.js"
 
@@ -35,7 +40,7 @@ export type StreamSynthesizeRequest = {
 // ---------------------------------------------------------------------------
 
 export const buildWsUrl = (cfg: Config, request: StreamSynthesizeRequest, outputFormat: string) => {
-  const wsBase = (cfg.baseUrl ?? "https://api.elevenlabs.io/v1").replace(/^http/, "ws")
+  const wsBase = resolveHost(cfg).replace(/^http/, "ws")
   const params = new URLSearchParams({
     output_format: outputFormat,
     auto_mode: String(request.autoMode ?? true),

package/src/region.test.ts

@@ -0,0 +1,30 @@
+import { describe, expect, it } from "vitest"
+import { resolveHost } from "./region.js"
+
+describe("elevenlabs/region.resolveHost", () => {
+  it("returns default host when no region or baseUrl", () => {
+    expect(resolveHost({})).toBe("https://api.elevenlabs.io/v1")
+  })
+
+  it("returns default host for region 'default'", () => {
+    expect(resolveHost({ region: "default" })).toBe("https://api.elevenlabs.io/v1")
+  })
+
+  it("computes EU residency host for region 'eu'", () => {
+    expect(resolveHost({ region: "eu" })).toBe("https://api.eu.residency.elevenlabs.io/v1")
+  })
+
+  it("computes IN residency host for region 'in'", () => {
+    expect(resolveHost({ region: "in" })).toBe("https://api.in.residency.elevenlabs.io/v1")
+  })
+
+  it("passes unknown region through as residency host", () => {
+    expect(resolveHost({ region: "ap" })).toBe("https://api.ap.residency.elevenlabs.io/v1")
+  })
+
+  it("baseUrl wins over region", () => {
+    expect(resolveHost({ baseUrl: "http://localhost:8080/v1", region: "eu" })).toBe(
+      "http://localhost:8080/v1",
+    )
+  })
+})

package/src/region.ts

@@ -0,0 +1,34 @@
+/**
+ * ElevenLabs regional residency endpoints. The default workspace runs
+ * against `api.elevenlabs.io`; EU- and IN-residency workspaces run
+ * against `api.{eu,in}.residency.elevenlabs.io` (REST + WSS).
+ *
+ * API keys are workspace-bound — a key minted in an EU workspace must
+ * be used against the EU host (and vice versa). Mixing key/host
+ * surfaces as `401 PERMISSION_DENIED`.
+ *
+ * Reference: https://elevenlabs.io/docs/overview/administration/data-residency
+ */
+
+// eslint-disable-next-line @typescript-eslint/ban-types
+export type ElevenLabsRegion = "default" | "eu" | "in" | (string & {})
+
+const DEFAULT_HOST = "https://api.elevenlabs.io/v1"
+
+/**
+ * Resolve the HTTP base URL from a Config. `baseUrl` wins when set;
+ * otherwise the host is computed from `region`. Unknown region strings
+ * pass through as `api.{region}.residency.elevenlabs.io/v1` for forward
+ * compat.
+ *
+ * WS code derives its `wss://` URL by substituting `http→ws` on the
+ * resolved host.
+ */
+export const resolveHost = (cfg: {
+  readonly baseUrl?: string
+  readonly region?: ElevenLabsRegion
+}): string => {
+  if (cfg.baseUrl !== undefined) return cfg.baseUrl
+  if (cfg.region === undefined || cfg.region === "default") return DEFAULT_HOST
+  return `https://api.${cfg.region}.residency.elevenlabs.io/v1`
+}