@shogo-ai/voice 1.4.1 → 1.9.0

package/dist/{chunk-ZGYHDC5G.js → chunk-B4JC3DK2.js}

@@ -44,6 +44,7 @@ function resolveConvaiTtsModel(requested) {
   if (requested && CONVAI_SUPPORTED_TTS_MODELS.has(requested)) return requested;
   return CONVAI_TTS_MODEL_FALLBACK;
 }
+var DEFAULT_MUSIC_MODEL = "music_v1";
 var ElevenLabsApiError = class extends Error {
   constructor(message, status, body) {
     super(message);
@@ -244,6 +245,110 @@ var ElevenLabsClient = class {
     const contentType = res.headers.get("content-type") ?? accept;
     return { audio, modelId: used, contentType };
   }
+  /**
+   * Low-level escape hatch for any ElevenLabs endpoint not covered by a
+   * dedicated method (music, sound-generation, speech-to-text, dubbing,
+   * voice-design, …). Handles auth, query encoding, JSON body encoding,
+   * and JSON-vs-binary response parsing; non-2xx responses throw
+   * {@link ElevenLabsApiError} like the typed methods do.
+   *
+   * @example
+   * ```ts
+   * const { json } = await el.request({ method: 'GET', path: '/v1/models' })
+   * const { audio } = await el.request({
+   *   method: 'POST',
+   *   path: '/v1/sound-generation',
+   *   body: { text: 'door creak' },
+   *   accept: 'audio/mpeg',
+   * })
+   * ```
+   */
+  async request(opts) {
+    const accept = opts.accept ?? "application/json";
+    let url = `${this.baseUrl}${opts.path.startsWith("/") ? "" : "/"}${opts.path}`;
+    if (opts.query) {
+      const params = new URLSearchParams();
+      for (const [k, v] of Object.entries(opts.query)) {
+        if (v !== null && v !== void 0) params.set(k, String(v));
+      }
+      const qs = params.toString();
+      if (qs) url += `${url.includes("?") ? "&" : "?"}${qs}`;
+    }
+    const headers = this.headers({ accept, ...opts.headers ?? {} });
+    const init = { method: opts.method, headers };
+    if (opts.body !== void 0 && opts.body !== null) {
+      const isPlainPayload = typeof opts.body === "object" && !(opts.body instanceof ArrayBuffer) && !(opts.body instanceof Uint8Array) && !(typeof Blob !== "undefined" && opts.body instanceof Blob) && !(typeof FormData !== "undefined" && opts.body instanceof FormData);
+      if (isPlainPayload) {
+        headers["content-type"] = "application/json";
+        init.body = JSON.stringify(opts.body);
+      } else {
+        init.body = opts.body;
+      }
+    }
+    const res = await this.fetchImpl(url, init);
+    if (!res.ok) {
+      const text = await res.text();
+      throw new ElevenLabsApiError(
+        `request ${opts.method} ${opts.path} failed: ${res.status}`,
+        res.status,
+        text
+      );
+    }
+    const contentType = res.headers.get("content-type") ?? accept;
+    if (contentType.includes("application/json")) {
+      return { status: res.status, contentType, json: await res.json() };
+    }
+    return { status: res.status, contentType, audio: await res.arrayBuffer() };
+  }
+  /**
+   * Generate music via `POST /v1/music`. Provide exactly one of `prompt`
+   * or `compositionPlan` (ElevenLabs returns 422 otherwise). Returns the
+   * raw audio bytes plus the response content type.
+   *
+   * @example
+   * ```ts
+   * const { audio } = await el.composeMusic({
+   *   prompt: 'Upbeat synthwave with driving bass',
+   *   musicLengthMs: 30_000,
+   * })
+   * ```
+   */
+  async composeMusic(params) {
+    const hasPrompt = typeof params.prompt === "string" && params.prompt.length > 0;
+    const hasPlan = params.compositionPlan != null;
+    if (hasPrompt === hasPlan) {
+      throw new Error(
+        "composeMusic: provide exactly one of `prompt` or `compositionPlan`"
+      );
+    }
+    const body = {
+      model_id: params.modelId ?? DEFAULT_MUSIC_MODEL
+    };
+    if (hasPrompt) {
+      body.prompt = params.prompt;
+      if (params.musicLengthMs !== void 0) body.music_length_ms = params.musicLengthMs;
+      if (params.forceInstrumental !== void 0) {
+        body.force_instrumental = params.forceInstrumental;
+      }
+    } else {
+      body.composition_plan = params.compositionPlan;
+    }
+    const { audio, contentType } = await this.request({
+      method: "POST",
+      path: "/v1/music",
+      body,
+      accept: "audio/mpeg",
+      ...params.outputFormat ? { query: { output_format: params.outputFormat } } : {}
+    });
+    if (!audio) {
+      throw new ElevenLabsApiError(
+        "composeMusic: expected audio bytes but got a JSON response",
+        500,
+        ""
+      );
+    }
+    return { audio, contentType };
+  }
   /** Probe whether a given voice id still exists on the caller's account. */
   async voiceExists(voiceId) {
     const res = await this.fetchImpl(
@@ -416,8 +521,9 @@ export {
   CONVAI_SUPPORTED_TTS_MODELS,
   CONVAI_TTS_MODEL_FALLBACK,
   resolveConvaiTtsModel,
+  DEFAULT_MUSIC_MODEL,
   ElevenLabsApiError,
   ElevenLabsClient,
   MEMORY_CLIENT_TOOLS
 };
-//# sourceMappingURL=chunk-ZGYHDC5G.js.map
+//# sourceMappingURL=chunk-B4JC3DK2.js.map

package/dist/{chunk-QHDIEE7O.js → chunk-O362EJQR.js}

@@ -5,7 +5,7 @@ import {
   MEMORY_CLIENT_TOOLS,
   extractBasePrompt,
   resolveConvaiTtsModel
-} from "./chunk-ZGYHDC5G.js";
+} from "./chunk-B4JC3DK2.js";
 import {
   AUDIO_TAGS,
   AUDIO_TAG_GROUPS,
@@ -39,6 +39,28 @@ async function readJson(req) {
 }
 var NOOP_LOGGER = () => {
 };
+function parseMusicBody(raw) {
+  if (raw === null || typeof raw !== "object") return { error: "Invalid JSON body" };
+  const b = raw;
+  const hasPrompt = typeof b.prompt === "string" && b.prompt.trim().length > 0;
+  const hasPlan = b.compositionPlan != null && typeof b.compositionPlan === "object";
+  if (hasPrompt === hasPlan) {
+    return { error: "Provide exactly one of `prompt` or `compositionPlan`" };
+  }
+  const params = {};
+  if (hasPrompt) {
+    params.prompt = b.prompt.trim();
+    if (typeof b.musicLengthMs === "number") params.musicLengthMs = b.musicLengthMs;
+    if (typeof b.forceInstrumental === "boolean") params.forceInstrumental = b.forceInstrumental;
+  } else {
+    params.compositionPlan = b.compositionPlan;
+  }
+  if (typeof b.modelId === "string" && b.modelId.length > 0) params.modelId = b.modelId;
+  if (typeof b.outputFormat === "string" && b.outputFormat.length > 0) {
+    params.outputFormat = b.outputFormat;
+  }
+  return { params };
+}
 function resolveProxyOptions(config) {
   if (config.proxy) {
     if (!config.proxy.runtimeToken || !config.proxy.projectId || !config.proxy.apiUrl) {
@@ -124,6 +146,34 @@ function createProxyHandlers(proxy, log) {
       }
     });
   }
+  async function doMusic(req) {
+    if (req.method !== "POST") return json({ error: "Method Not Allowed" }, 405);
+    const raw = await readJson(req);
+    const parsed = parseMusicBody(raw);
+    if ("error" in parsed) return json({ error: parsed.error }, 400);
+    try {
+      const upstream = await fetchImpl(proxyUrl("/api/voice/music", {}), {
+        method: "POST",
+        headers: {
+          "x-runtime-token": proxy.runtimeToken,
+          "content-type": "application/json",
+          accept: "audio/mpeg"
+        },
+        body: JSON.stringify(parsed.params),
+        credentials: "omit"
+      });
+      const buf = await upstream.arrayBuffer();
+      const headers = {};
+      const ct = upstream.headers.get("content-type");
+      if (ct) headers["content-type"] = ct;
+      return new Response(buf, { status: upstream.status, headers });
+    } catch (err) {
+      log("error", "proxy music failed", {
+        error: err instanceof Error ? err.message : String(err)
+      });
+      return json({ error: "music proxy failed" }, 502);
+    }
+  }
   function notImplemented(label) {
     return async () => json(
       {
@@ -136,6 +186,7 @@ function createProxyHandlers(proxy, log) {
   return {
     signedUrl: doSignedUrl,
     tts: notImplemented("tts"),
+    music: doMusic,
     agent: {
       create: notImplemented("agent.create"),
       patch: notImplemented("agent.patch"),
@@ -276,6 +327,25 @@ function createVoiceHandlers(config) {
       return handleElError(e, "TTS failed");
     }
   }
+  async function doMusic(req) {
+    if (req.method !== "POST") return json({ error: "Method Not Allowed" }, 405);
+    const u = await resolveUser(req);
+    if (u instanceof Response) return u;
+    const raw = await readJson(req);
+    const parsed = parseMusicBody(raw);
+    if ("error" in parsed) return json({ error: parsed.error }, 400);
+    try {
+      const { audio, contentType } = await el.composeMusic(parsed.params);
+      return new Response(audio, {
+        headers: {
+          "content-type": contentType,
+          "cache-control": "private, max-age=3600"
+        }
+      });
+    } catch (e) {
+      return handleElError(e, "Music generation failed");
+    }
+  }
   async function doAgentCreate(req) {
     if (req.method !== "POST") return json({ error: "Method Not Allowed" }, 405);
     const u = await resolveUser(req);
@@ -406,6 +476,7 @@ function createVoiceHandlers(config) {
   return {
     signedUrl: doSignedUrl,
     tts: doTts,
+    music: doMusic,
     agent: {
       create: doAgentCreate,
       patch: doAgentPatch,
@@ -450,4 +521,4 @@ export {
   createVoiceHandlers,
   toNodeListener
 };
-//# sourceMappingURL=chunk-QHDIEE7O.js.map
+//# sourceMappingURL=chunk-O362EJQR.js.map

package/dist/{chunk-D2EVSUZX.js → chunk-T3T4EBWY.js}

@@ -1,6 +1,6 @@
 import {
   createVoiceHandlers
-} from "./chunk-QHDIEE7O.js";
+} from "./chunk-O362EJQR.js";
 
 // src/route/index.ts
 function defaultHandlers() {
@@ -11,6 +11,7 @@ function createVoiceRoute(config) {
   return {
     signedUrl: { GET: (req) => v.signedUrl(req) },
     ttsPreview: { POST: (req) => v.tts(req) },
+    music: { POST: (req) => v.music(req) },
     agent: {
       POST: (req) => v.agent.create(req),
       PATCH: (req) => v.agent.patch(req),
@@ -24,4 +25,4 @@ export {
   defaultHandlers,
   createVoiceRoute
 };
-//# sourceMappingURL=chunk-D2EVSUZX.js.map
+//# sourceMappingURL=chunk-T3T4EBWY.js.map

package/dist/index.cjs

@@ -27,6 +27,7 @@ __export(index_exports, {
   DEFAULT_ALLOWED_TAGS: () => DEFAULT_ALLOWED_TAGS,
   DEFAULT_ELEVENLABS_BASE_URL: () => DEFAULT_ELEVENLABS_BASE_URL,
   DEFAULT_MEMORY_BLOCK: () => DEFAULT_MEMORY_BLOCK,
+  DEFAULT_MUSIC_MODEL: () => DEFAULT_MUSIC_MODEL,
   DEFAULT_TWILIO_BASE_URL: () => DEFAULT_TWILIO_BASE_URL,
   DEFAULT_VOICE_SETTINGS: () => DEFAULT_VOICE_SETTINGS,
   DirectTelephonyClient: () => DirectTelephonyClient,
@@ -248,6 +249,7 @@ function resolveConvaiTtsModel(requested) {
   if (requested && CONVAI_SUPPORTED_TTS_MODELS.has(requested)) return requested;
   return CONVAI_TTS_MODEL_FALLBACK;
 }
+var DEFAULT_MUSIC_MODEL = "music_v1";
 var ElevenLabsApiError = class extends Error {
   constructor(message, status, body) {
     super(message);
@@ -448,6 +450,110 @@ var ElevenLabsClient = class {
     const contentType = res.headers.get("content-type") ?? accept;
     return { audio, modelId: used, contentType };
   }
+  /**
+   * Low-level escape hatch for any ElevenLabs endpoint not covered by a
+   * dedicated method (music, sound-generation, speech-to-text, dubbing,
+   * voice-design, …). Handles auth, query encoding, JSON body encoding,
+   * and JSON-vs-binary response parsing; non-2xx responses throw
+   * {@link ElevenLabsApiError} like the typed methods do.
+   *
+   * @example
+   * ```ts
+   * const { json } = await el.request({ method: 'GET', path: '/v1/models' })
+   * const { audio } = await el.request({
+   *   method: 'POST',
+   *   path: '/v1/sound-generation',
+   *   body: { text: 'door creak' },
+   *   accept: 'audio/mpeg',
+   * })
+   * ```
+   */
+  async request(opts) {
+    const accept = opts.accept ?? "application/json";
+    let url = `${this.baseUrl}${opts.path.startsWith("/") ? "" : "/"}${opts.path}`;
+    if (opts.query) {
+      const params = new URLSearchParams();
+      for (const [k, v] of Object.entries(opts.query)) {
+        if (v !== null && v !== void 0) params.set(k, String(v));
+      }
+      const qs = params.toString();
+      if (qs) url += `${url.includes("?") ? "&" : "?"}${qs}`;
+    }
+    const headers = this.headers({ accept, ...opts.headers ?? {} });
+    const init = { method: opts.method, headers };
+    if (opts.body !== void 0 && opts.body !== null) {
+      const isPlainPayload = typeof opts.body === "object" && !(opts.body instanceof ArrayBuffer) && !(opts.body instanceof Uint8Array) && !(typeof Blob !== "undefined" && opts.body instanceof Blob) && !(typeof FormData !== "undefined" && opts.body instanceof FormData);
+      if (isPlainPayload) {
+        headers["content-type"] = "application/json";
+        init.body = JSON.stringify(opts.body);
+      } else {
+        init.body = opts.body;
+      }
+    }
+    const res = await this.fetchImpl(url, init);
+    if (!res.ok) {
+      const text = await res.text();
+      throw new ElevenLabsApiError(
+        `request ${opts.method} ${opts.path} failed: ${res.status}`,
+        res.status,
+        text
+      );
+    }
+    const contentType = res.headers.get("content-type") ?? accept;
+    if (contentType.includes("application/json")) {
+      return { status: res.status, contentType, json: await res.json() };
+    }
+    return { status: res.status, contentType, audio: await res.arrayBuffer() };
+  }
+  /**
+   * Generate music via `POST /v1/music`. Provide exactly one of `prompt`
+   * or `compositionPlan` (ElevenLabs returns 422 otherwise). Returns the
+   * raw audio bytes plus the response content type.
+   *
+   * @example
+   * ```ts
+   * const { audio } = await el.composeMusic({
+   *   prompt: 'Upbeat synthwave with driving bass',
+   *   musicLengthMs: 30_000,
+   * })
+   * ```
+   */
+  async composeMusic(params) {
+    const hasPrompt = typeof params.prompt === "string" && params.prompt.length > 0;
+    const hasPlan = params.compositionPlan != null;
+    if (hasPrompt === hasPlan) {
+      throw new Error(
+        "composeMusic: provide exactly one of `prompt` or `compositionPlan`"
+      );
+    }
+    const body = {
+      model_id: params.modelId ?? DEFAULT_MUSIC_MODEL
+    };
+    if (hasPrompt) {
+      body.prompt = params.prompt;
+      if (params.musicLengthMs !== void 0) body.music_length_ms = params.musicLengthMs;
+      if (params.forceInstrumental !== void 0) {
+        body.force_instrumental = params.forceInstrumental;
+      }
+    } else {
+      body.composition_plan = params.compositionPlan;
+    }
+    const { audio, contentType } = await this.request({
+      method: "POST",
+      path: "/v1/music",
+      body,
+      accept: "audio/mpeg",
+      ...params.outputFormat ? { query: { output_format: params.outputFormat } } : {}
+    });
+    if (!audio) {
+      throw new ElevenLabsApiError(
+        "composeMusic: expected audio bytes but got a JSON response",
+        500,
+        ""
+      );
+    }
+    return { audio, contentType };
+  }
   /** Probe whether a given voice id still exists on the caller's account. */
   async voiceExists(voiceId) {
     const res = await this.fetchImpl(
@@ -1280,6 +1386,7 @@ function isVoiceMockEnv() {
   DEFAULT_ALLOWED_TAGS,
   DEFAULT_ELEVENLABS_BASE_URL,
   DEFAULT_MEMORY_BLOCK,
+  DEFAULT_MUSIC_MODEL,
   DEFAULT_TWILIO_BASE_URL,
   DEFAULT_VOICE_SETTINGS,
   DirectTelephonyClient,

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { E as Expressivity } from './types-BKJtOUbE.cjs';
-export { A as AUDIO_TAGS, a as AUDIO_TAG_GROUPS, b as AudioTag, c as AudioTagGroup, C as CONVAI_SUPPORTED_TTS_MODELS, d as CONVAI_TTS_MODEL_FALLBACK, e as Companion, f as CompanionStore, g as ConvaiClientTool, h as CreateAgentParams, i as CreateCompanionBody, D as DEFAULT_ALLOWED_TAGS, j as DEFAULT_ELEVENLABS_BASE_URL, k as DEFAULT_VOICE_SETTINGS, l as EXPRESSIVITY_BLOCK_CLOSE, m as EXPRESSIVITY_BLOCK_OPEN, n as EXPRESSIVITY_OPTIONS, o as ElevenLabsApiError, p as ElevenLabsClient, q as ElevenLabsClientConfig, M as MEMORY_CLIENT_TOOLS, P as PatchAgentParams, r as PatchCompanionBody, T as TextToSpeechParams, s as TtsPreviewBody, V as VoiceMemoryStore, t as VoiceSettings, u as VoiceUser, v as buildPreviewLine, w as composeExpressivityBlock, x as normalizeAudioTags, y as normalizeExpressivity, z as normalizeVoiceSettings, B as readAudioTags, F as readExpressivity, G as readVoiceSettings, H as resolveConvaiTtsModel, I as stripAudioTags, J as stripExpressivityBlock } from './types-BKJtOUbE.cjs';
+import { E as Expressivity } from './types-W9y6eMj3.cjs';
+export { A as AUDIO_TAGS, a as AUDIO_TAG_GROUPS, b as AudioTag, c as AudioTagGroup, C as CONVAI_SUPPORTED_TTS_MODELS, d as CONVAI_TTS_MODEL_FALLBACK, e as Companion, f as CompanionStore, g as ComposeMusicParams, h as ConvaiClientTool, i as CreateAgentParams, j as CreateCompanionBody, D as DEFAULT_ALLOWED_TAGS, k as DEFAULT_ELEVENLABS_BASE_URL, l as DEFAULT_MUSIC_MODEL, m as DEFAULT_VOICE_SETTINGS, n as EXPRESSIVITY_BLOCK_CLOSE, o as EXPRESSIVITY_BLOCK_OPEN, p as EXPRESSIVITY_OPTIONS, q as ElevenLabsApiError, r as ElevenLabsClient, s as ElevenLabsClientConfig, t as ElevenLabsRequestOptions, u as ElevenLabsResponse, M as MEMORY_CLIENT_TOOLS, P as PatchAgentParams, v as PatchCompanionBody, T as TextToSpeechParams, w as TtsPreviewBody, V as VoiceMemoryStore, x as VoiceSettings, y as VoiceUser, z as buildPreviewLine, B as composeExpressivityBlock, F as normalizeAudioTags, G as normalizeExpressivity, H as normalizeVoiceSettings, I as readAudioTags, J as readExpressivity, K as readVoiceSettings, L as resolveConvaiTtsModel, N as stripAudioTags, O as stripExpressivityBlock } from './types-W9y6eMj3.cjs';
 
 /**
  * System-prompt composer for the voice agent.

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { E as Expressivity } from './types-BKJtOUbE.js';
-export { A as AUDIO_TAGS, a as AUDIO_TAG_GROUPS, b as AudioTag, c as AudioTagGroup, C as CONVAI_SUPPORTED_TTS_MODELS, d as CONVAI_TTS_MODEL_FALLBACK, e as Companion, f as CompanionStore, g as ConvaiClientTool, h as CreateAgentParams, i as CreateCompanionBody, D as DEFAULT_ALLOWED_TAGS, j as DEFAULT_ELEVENLABS_BASE_URL, k as DEFAULT_VOICE_SETTINGS, l as EXPRESSIVITY_BLOCK_CLOSE, m as EXPRESSIVITY_BLOCK_OPEN, n as EXPRESSIVITY_OPTIONS, o as ElevenLabsApiError, p as ElevenLabsClient, q as ElevenLabsClientConfig, M as MEMORY_CLIENT_TOOLS, P as PatchAgentParams, r as PatchCompanionBody, T as TextToSpeechParams, s as TtsPreviewBody, V as VoiceMemoryStore, t as VoiceSettings, u as VoiceUser, v as buildPreviewLine, w as composeExpressivityBlock, x as normalizeAudioTags, y as normalizeExpressivity, z as normalizeVoiceSettings, B as readAudioTags, F as readExpressivity, G as readVoiceSettings, H as resolveConvaiTtsModel, I as stripAudioTags, J as stripExpressivityBlock } from './types-BKJtOUbE.js';
+import { E as Expressivity } from './types-W9y6eMj3.js';
+export { A as AUDIO_TAGS, a as AUDIO_TAG_GROUPS, b as AudioTag, c as AudioTagGroup, C as CONVAI_SUPPORTED_TTS_MODELS, d as CONVAI_TTS_MODEL_FALLBACK, e as Companion, f as CompanionStore, g as ComposeMusicParams, h as ConvaiClientTool, i as CreateAgentParams, j as CreateCompanionBody, D as DEFAULT_ALLOWED_TAGS, k as DEFAULT_ELEVENLABS_BASE_URL, l as DEFAULT_MUSIC_MODEL, m as DEFAULT_VOICE_SETTINGS, n as EXPRESSIVITY_BLOCK_CLOSE, o as EXPRESSIVITY_BLOCK_OPEN, p as EXPRESSIVITY_OPTIONS, q as ElevenLabsApiError, r as ElevenLabsClient, s as ElevenLabsClientConfig, t as ElevenLabsRequestOptions, u as ElevenLabsResponse, M as MEMORY_CLIENT_TOOLS, P as PatchAgentParams, v as PatchCompanionBody, T as TextToSpeechParams, w as TtsPreviewBody, V as VoiceMemoryStore, x as VoiceSettings, y as VoiceUser, z as buildPreviewLine, B as composeExpressivityBlock, F as normalizeAudioTags, G as normalizeExpressivity, H as normalizeVoiceSettings, I as readAudioTags, J as readExpressivity, K as readVoiceSettings, L as resolveConvaiTtsModel, N as stripAudioTags, O as stripExpressivityBlock } from './types-W9y6eMj3.js';
 
 /**
  * System-prompt composer for the voice agent.

package/dist/index.js

@@ -3,6 +3,7 @@ import {
   CONVAI_TTS_MODEL_FALLBACK,
   DEFAULT_ELEVENLABS_BASE_URL,
   DEFAULT_MEMORY_BLOCK,
+  DEFAULT_MUSIC_MODEL,
   ElevenLabsApiError,
   ElevenLabsClient,
   MEMORY_CLIENT_TOOLS,
@@ -10,7 +11,7 @@ import {
   extractBasePrompt,
   resolveConvaiTtsModel,
   stripMemoryBlock
-} from "./chunk-ZGYHDC5G.js";
+} from "./chunk-B4JC3DK2.js";
 import {
   AUDIO_TAGS,
   AUDIO_TAG_GROUPS,
@@ -699,6 +700,7 @@ export {
   DEFAULT_ALLOWED_TAGS,
   DEFAULT_ELEVENLABS_BASE_URL,
   DEFAULT_MEMORY_BLOCK,
+  DEFAULT_MUSIC_MODEL,
   DEFAULT_TWILIO_BASE_URL,
   DEFAULT_VOICE_SETTINGS,
   DirectTelephonyClient,

package/dist/route/agent.cjs

@@ -205,6 +205,7 @@ function resolveConvaiTtsModel(requested) {
   if (requested && CONVAI_SUPPORTED_TTS_MODELS.has(requested)) return requested;
   return CONVAI_TTS_MODEL_FALLBACK;
 }
+var DEFAULT_MUSIC_MODEL = "music_v1";
 var ElevenLabsApiError = class extends Error {
   constructor(message, status, body) {
     super(message);
@@ -405,6 +406,110 @@ var ElevenLabsClient = class {
     const contentType = res.headers.get("content-type") ?? accept;
     return { audio, modelId: used, contentType };
   }
+  /**
+   * Low-level escape hatch for any ElevenLabs endpoint not covered by a
+   * dedicated method (music, sound-generation, speech-to-text, dubbing,
+   * voice-design, …). Handles auth, query encoding, JSON body encoding,
+   * and JSON-vs-binary response parsing; non-2xx responses throw
+   * {@link ElevenLabsApiError} like the typed methods do.
+   *
+   * @example
+   * ```ts
+   * const { json } = await el.request({ method: 'GET', path: '/v1/models' })
+   * const { audio } = await el.request({
+   *   method: 'POST',
+   *   path: '/v1/sound-generation',
+   *   body: { text: 'door creak' },
+   *   accept: 'audio/mpeg',
+   * })
+   * ```
+   */
+  async request(opts) {
+    const accept = opts.accept ?? "application/json";
+    let url = `${this.baseUrl}${opts.path.startsWith("/") ? "" : "/"}${opts.path}`;
+    if (opts.query) {
+      const params = new URLSearchParams();
+      for (const [k, v] of Object.entries(opts.query)) {
+        if (v !== null && v !== void 0) params.set(k, String(v));
+      }
+      const qs = params.toString();
+      if (qs) url += `${url.includes("?") ? "&" : "?"}${qs}`;
+    }
+    const headers = this.headers({ accept, ...opts.headers ?? {} });
+    const init = { method: opts.method, headers };
+    if (opts.body !== void 0 && opts.body !== null) {
+      const isPlainPayload = typeof opts.body === "object" && !(opts.body instanceof ArrayBuffer) && !(opts.body instanceof Uint8Array) && !(typeof Blob !== "undefined" && opts.body instanceof Blob) && !(typeof FormData !== "undefined" && opts.body instanceof FormData);
+      if (isPlainPayload) {
+        headers["content-type"] = "application/json";
+        init.body = JSON.stringify(opts.body);
+      } else {
+        init.body = opts.body;
+      }
+    }
+    const res = await this.fetchImpl(url, init);
+    if (!res.ok) {
+      const text = await res.text();
+      throw new ElevenLabsApiError(
+        `request ${opts.method} ${opts.path} failed: ${res.status}`,
+        res.status,
+        text
+      );
+    }
+    const contentType = res.headers.get("content-type") ?? accept;
+    if (contentType.includes("application/json")) {
+      return { status: res.status, contentType, json: await res.json() };
+    }
+    return { status: res.status, contentType, audio: await res.arrayBuffer() };
+  }
+  /**
+   * Generate music via `POST /v1/music`. Provide exactly one of `prompt`
+   * or `compositionPlan` (ElevenLabs returns 422 otherwise). Returns the
+   * raw audio bytes plus the response content type.
+   *
+   * @example
+   * ```ts
+   * const { audio } = await el.composeMusic({
+   *   prompt: 'Upbeat synthwave with driving bass',
+   *   musicLengthMs: 30_000,
+   * })
+   * ```
+   */
+  async composeMusic(params) {
+    const hasPrompt = typeof params.prompt === "string" && params.prompt.length > 0;
+    const hasPlan = params.compositionPlan != null;
+    if (hasPrompt === hasPlan) {
+      throw new Error(
+        "composeMusic: provide exactly one of `prompt` or `compositionPlan`"
+      );
+    }
+    const body = {
+      model_id: params.modelId ?? DEFAULT_MUSIC_MODEL
+    };
+    if (hasPrompt) {
+      body.prompt = params.prompt;
+      if (params.musicLengthMs !== void 0) body.music_length_ms = params.musicLengthMs;
+      if (params.forceInstrumental !== void 0) {
+        body.force_instrumental = params.forceInstrumental;
+      }
+    } else {
+      body.composition_plan = params.compositionPlan;
+    }
+    const { audio, contentType } = await this.request({
+      method: "POST",
+      path: "/v1/music",
+      body,
+      accept: "audio/mpeg",
+      ...params.outputFormat ? { query: { output_format: params.outputFormat } } : {}
+    });
+    if (!audio) {
+      throw new ElevenLabsApiError(
+        "composeMusic: expected audio bytes but got a JSON response",
+        500,
+        ""
+      );
+    }
+    return { audio, contentType };
+  }
   /** Probe whether a given voice id still exists on the caller's account. */
   async voiceExists(voiceId) {
     const res = await this.fetchImpl(
@@ -586,6 +691,28 @@ async function readJson(req) {
 }
 var NOOP_LOGGER = () => {
 };
+function parseMusicBody(raw) {
+  if (raw === null || typeof raw !== "object") return { error: "Invalid JSON body" };
+  const b = raw;
+  const hasPrompt = typeof b.prompt === "string" && b.prompt.trim().length > 0;
+  const hasPlan = b.compositionPlan != null && typeof b.compositionPlan === "object";
+  if (hasPrompt === hasPlan) {
+    return { error: "Provide exactly one of `prompt` or `compositionPlan`" };
+  }
+  const params = {};
+  if (hasPrompt) {
+    params.prompt = b.prompt.trim();
+    if (typeof b.musicLengthMs === "number") params.musicLengthMs = b.musicLengthMs;
+    if (typeof b.forceInstrumental === "boolean") params.forceInstrumental = b.forceInstrumental;
+  } else {
+    params.compositionPlan = b.compositionPlan;
+  }
+  if (typeof b.modelId === "string" && b.modelId.length > 0) params.modelId = b.modelId;
+  if (typeof b.outputFormat === "string" && b.outputFormat.length > 0) {
+    params.outputFormat = b.outputFormat;
+  }
+  return { params };
+}
 function resolveProxyOptions(config) {
   if (config.proxy) {
     if (!config.proxy.runtimeToken || !config.proxy.projectId || !config.proxy.apiUrl) {
@@ -671,6 +798,34 @@ function createProxyHandlers(proxy, log) {
       }
     });
   }
+  async function doMusic(req) {
+    if (req.method !== "POST") return json({ error: "Method Not Allowed" }, 405);
+    const raw = await readJson(req);
+    const parsed = parseMusicBody(raw);
+    if ("error" in parsed) return json({ error: parsed.error }, 400);
+    try {
+      const upstream = await fetchImpl(proxyUrl("/api/voice/music", {}), {
+        method: "POST",
+        headers: {
+          "x-runtime-token": proxy.runtimeToken,
+          "content-type": "application/json",
+          accept: "audio/mpeg"
+        },
+        body: JSON.stringify(parsed.params),
+        credentials: "omit"
+      });
+      const buf = await upstream.arrayBuffer();
+      const headers = {};
+      const ct = upstream.headers.get("content-type");
+      if (ct) headers["content-type"] = ct;
+      return new Response(buf, { status: upstream.status, headers });
+    } catch (err) {
+      log("error", "proxy music failed", {
+        error: err instanceof Error ? err.message : String(err)
+      });
+      return json({ error: "music proxy failed" }, 502);
+    }
+  }
   function notImplemented(label) {
     return async () => json(
       {
@@ -683,6 +838,7 @@ function createProxyHandlers(proxy, log) {
   return {
     signedUrl: doSignedUrl,
     tts: notImplemented("tts"),
+    music: doMusic,
     agent: {
       create: notImplemented("agent.create"),
       patch: notImplemented("agent.patch"),
@@ -823,6 +979,25 @@ function createVoiceHandlers(config) {
       return handleElError(e, "TTS failed");
     }
   }
+  async function doMusic(req) {
+    if (req.method !== "POST") return json({ error: "Method Not Allowed" }, 405);
+    const u = await resolveUser(req);
+    if (u instanceof Response) return u;
+    const raw = await readJson(req);
+    const parsed = parseMusicBody(raw);
+    if ("error" in parsed) return json({ error: parsed.error }, 400);
+    try {
+      const { audio, contentType } = await el.composeMusic(parsed.params);
+      return new Response(audio, {
+        headers: {
+          "content-type": contentType,
+          "cache-control": "private, max-age=3600"
+        }
+      });
+    } catch (e) {
+      return handleElError(e, "Music generation failed");
+    }
+  }
   async function doAgentCreate(req) {
     if (req.method !== "POST") return json({ error: "Method Not Allowed" }, 405);
     const u = await resolveUser(req);
@@ -953,6 +1128,7 @@ function createVoiceHandlers(config) {
   return {
     signedUrl: doSignedUrl,
     tts: doTts,
+    music: doMusic,
     agent: {
       create: doAgentCreate,
       patch: doAgentPatch,