@effect-uai/core 0.6.0 → 0.7.0

package/dist/music-generator/MusicGenerator.d.mts

@@ -1,77 +1,100 @@
 import { t as AiError } from "../AiError-CAX_48RU.mjs";
-import { n as AudioChunk } from "../Audio-BfCTGnH3.mjs";
-import { CommonGenerateMusicRequest, CommonStreamGenerateMusicRequest, MusicResult, MusicSessionInput, WeightedPrompt } from "../domain/Music.mjs";
+import { n as AudioChunk } from "../Audio-DPlTsNdz.mjs";
+import { CommonGenerateMusicRequest, CommonStreamGenerateMusicRequest, GenerateResult, MusicResult, MusicSection, MusicSessionControl, MusicSessionInput, MusicStreamEvent, Watermark, WeightedPrompt } from "../domain/Music.mjs";
 import { Context, Effect, Stream } from "effect";
 
 //#region src/music-generator/MusicGenerator.d.ts
 declare namespace MusicGenerator_d_exports {
-  export { CommonGenerateMusicRequest, CommonStreamGenerateMusicRequest, MusicGenerator, MusicGeneratorService, MusicInteractiveSession, MusicResult, MusicSessionInput, WeightedPrompt, generate, streamGeneration, streamGenerationFrom };
+  export { CommonGenerateMusicRequest, CommonStreamGenerateMusicRequest, GenerateResult, MusicGenerator, MusicGeneratorService, MusicInteractiveSession, MusicResult, MusicSection, MusicSessionControl, MusicSessionInput, MusicStreamEvent, Watermark, WeightedPrompt, generate, streamGeneration, streamGenerationFrom };
 }
 type MusicGeneratorService = {
   /**
    * One-shot. Prompt in, full audio bytes out. Universally supported.
    * Async/poll-based providers (Suno, Mureka) hide their poll loop
-   * inside the adapter — caller still sees a single `Effect`.
+   * inside the adapter, caller still sees a single `Effect`.
+   *
+   * Returns `GenerateResult` with `primary` plus a `variants` array.
+   * Suno and Mureka always return 2 tracks; every other provider
+   * returns 1 (and `primary === variants[0]`).
    */
-  readonly generate: (request: CommonGenerateMusicRequest) => Effect.Effect<MusicResult, AiError>;
+  readonly generate: (request: CommonGenerateMusicRequest) => Effect.Effect<GenerateResult, AiError>;
   /**
    * Prompt in, audio chunks streamed out. Providers without a native
    * chunked-output endpoint (Lyria 3 sync, Mureka, MiniMax, Stable
    * Audio) emulate this by calling `generate` and emitting a single
-   * `AudioChunk` — first-class, no `Unsupported`.
+   * `AudioChunk`, first-class, no `Unsupported`.
    */
   readonly streamGeneration: (request: CommonStreamGenerateMusicRequest) => Stream.Stream<AudioChunk, AiError>;
   /**
-   * Bidirectional session: a `Stream` of prompt-or-config updates flows
-   * in, a `Stream` of audio chunks flows out. The session WS / RPC is
-   * acquired on first pull and released when the output stream is
-   * finalized via `Stream.scoped`.
+   * Bidirectional session: a `Stream` of `MusicSessionInput` (prompts
+   * + playback control) flows in, a `Stream` of `MusicStreamEvent`
+   * flows out. The session WS / RPC is acquired on first pull and
+   * released when the output stream is finalized via `Stream.scoped`.
+   *
+   * Cross-provider callers send `prompts` (steer the active
+   * generation) and `control` (play / pause / stop / reset) — the two
+   * actions that converge across interactive-media protocols.
+   * Provider-specific model knobs (Lyria RealTime's density /
+   * brightness / mute-stems / BPM / scale, etc.) live on the
+   * provider-typed service (`LyriaRealtimeGenerator.streamGenerationFrom`),
+   * which extends this union with its own `config` variant.
+   *
+   * Output is `MusicStreamEvent`: `audio` chunks alongside in-band
+   * `warning` and `filteredPrompt` events the model emits server-side.
    *
    * Gated by the `MusicInteractiveSession` capability marker on the
-   * top-level helper — providers without bidirectional support don't
+   * top-level helper. Providers without bidirectional support don't
    * ship the marker, so calls fail at `Effect.provide` with a type
    * error.
    */
-  readonly streamGenerationFrom: <E, R>(input: Stream.Stream<MusicSessionInput, E, R>, request: CommonStreamGenerateMusicRequest) => Stream.Stream<AudioChunk, AiError | E, R>;
+  readonly streamGenerationFrom: <E, R>(input: Stream.Stream<MusicSessionInput, E, R>, request: CommonStreamGenerateMusicRequest) => Stream.Stream<MusicStreamEvent, AiError | E, R>;
 };
 declare const MusicGenerator_base: Context.ServiceClass<MusicGenerator, "@betalyra/effect-uai/MusicGenerator", MusicGeneratorService>;
 declare class MusicGenerator extends MusicGenerator_base {}
 declare const MusicInteractiveSession_base: Context.ServiceClass<MusicInteractiveSession, "@betalyra/effect-uai/capability/MusicInteractiveSession", void>;
 /**
- * Capability marker — provided by provider layers whose
+ * Capability marker, provided by provider layers whose
  * `streamGenerationFrom` is wired up at the wire level. Currently only
  * Lyria RealTime (via the BidiGenerateMusic WebSocket) ships it.
  * Calling `streamGenerationFrom` while only a non-interactive Layer is
  * in scope fails at `Effect.provide` with a type error.
  *
- * Phantom — the value is `void`; providers register with
+ * Phantom: the value is `void`; providers register with
  * `Layer.succeed(MusicInteractiveSession, undefined)`.
  */
 declare class MusicInteractiveSession extends MusicInteractiveSession_base {}
-/** One-shot generation. */
-declare const generate: (request: CommonGenerateMusicRequest) => Effect.Effect<MusicResult, AiError, MusicGenerator>;
+/** One-shot generation. Returns the full `GenerateResult`. */
+declare const generate: (request: CommonGenerateMusicRequest) => Effect.Effect<GenerateResult, AiError, MusicGenerator>;
 /** Prompt in, audio chunks out. */
 declare const streamGeneration: (request: CommonStreamGenerateMusicRequest) => Stream.Stream<AudioChunk, AiError, MusicGenerator>;
 /**
  * Bidirectional generation. Dual-arity: pipeable (data-last) and
- * direct (data-first). Requires `MusicInteractiveSession` in R —
+ * direct (data-first). Requires `MusicInteractiveSession` in R,
  * providers without bidirectional support are a type error at provide
  * time.
  *
+ * On the cross-provider surface, `input` is `Stream<unknown>` and
+ * output is `Stream<MusicStreamEvent>`. Use the provider-typed
+ * service (`LyriaRealtimeGenerator`) when you want to construct
+ * typed session messages.
+ *
  * @example
  * ```ts
- * const audio = Stream.fromIterable([
- *   Music.promptsInput([{ text: "minimal techno", weight: 1.0 }]),
- *   Music.configInput({ bpm: 124 }),
- * ]).pipe(
- *   MusicGenerator.streamGenerationFrom({ model: "lyria-realtime-001", prompts: "" }),
+ * // Generic surface (opaque input):
+ * const audio = inputs.pipe(
+ *   MusicGenerator.streamGenerationFrom({ model: "lyria-realtime-exp", prompt: "" }),
+ * )
+ *
+ * // Lyria-typed surface (full config knobs):
+ * const audio = inputs.pipe(
+ *   LyriaRealtimeGenerator.streamGenerationFrom({ model: "lyria-realtime-exp", prompt: "" }),
  * )
  * ```
  */
 declare const streamGenerationFrom: {
-  (request: CommonStreamGenerateMusicRequest): <E, R>(input: Stream.Stream<MusicSessionInput, E, R>) => Stream.Stream<AudioChunk, AiError | E, R | MusicGenerator | MusicInteractiveSession>;
-  <E, R>(input: Stream.Stream<MusicSessionInput, E, R>, request: CommonStreamGenerateMusicRequest): Stream.Stream<AudioChunk, AiError | E, R | MusicGenerator | MusicInteractiveSession>;
+  (request: CommonStreamGenerateMusicRequest): <E, R>(input: Stream.Stream<MusicSessionInput, E, R>) => Stream.Stream<MusicStreamEvent, AiError | E, R | MusicGenerator | MusicInteractiveSession>;
+  <E, R>(input: Stream.Stream<MusicSessionInput, E, R>, request: CommonStreamGenerateMusicRequest): Stream.Stream<MusicStreamEvent, AiError | E, R | MusicGenerator | MusicInteractiveSession>;
 };
 //#endregion
-export { type CommonGenerateMusicRequest, type CommonStreamGenerateMusicRequest, MusicGenerator, MusicGeneratorService, MusicInteractiveSession, type MusicResult, type MusicSessionInput, type WeightedPrompt, generate, streamGeneration, streamGenerationFrom, MusicGenerator_d_exports as t };
+export { type CommonGenerateMusicRequest, type CommonStreamGenerateMusicRequest, type GenerateResult, MusicGenerator, MusicGeneratorService, MusicInteractiveSession, type MusicResult, type MusicSection, type MusicSessionControl, type MusicSessionInput, type MusicStreamEvent, type Watermark, type WeightedPrompt, generate, streamGeneration, streamGenerationFrom, MusicGenerator_d_exports as t };
 //# sourceMappingURL=MusicGenerator.d.mts.map

package/dist/music-generator/MusicGenerator.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"MusicGenerator.d.mts","names":[],"sources":["../../src/music-generator/MusicGenerator.ts"],"mappings":";;;;;;;;;KAkBY,qBAAA;;;;;;WAMD,QAAA,GACP,OAAA,EAAS,0BAAA,KACN,MAAA,CAAO,MAAA,CAAO,WAAA,EAAa,OAAA;;;;;;;WAOvB,gBAAA,GACP,OAAA,EAAS,gCAAA,KACN,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA;;AAjBjC;;;;;;;;;;WA6BW,oBAAA,SACP,KAAA,EAAO,MAAA,CAAO,MAAA,CAAO,iBAAA,EAAmB,CAAA,EAAG,CAAA,GAC3C,OAAA,EAAS,gCAAA,KACN,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA,GAAkB,CAAA,EAAG,CAAA;AAAA;AAAA,cACrD,mBAAA;cAEY,cAAA,SAAuB,mBAAA;AAAA,cAEhC,4BAAA;;;;;;;;;;;cAYS,uBAAA,SAAgC,4BAAA;;cAKhC,QAAA,GACX,OAAA,EAAS,0BAAA,KACR,MAAA,CAAO,MAAA,CAAO,WAAA,EAAa,OAAA,EAAiB,cAAA;;cAIlC,gBAAA,GACX,OAAA,EAAS,gCAAA,KACR,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA,EAAiB,cAAA;;;;;;;;;;;;;;;;;cAmBjC,oBAAA;EAAA,CAET,OAAA,EAAS,gCAAA,UAET,KAAA,EAAO,MAAA,CAAO,MAAA,CAAO,iBAAA,EAAmB,CAAA,EAAG,CAAA,MACxC,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA,GAAkB,CAAA,EAAG,CAAA,GAAI,cAAA,GAAiB,uBAAA;EAAA,OAEvE,KAAA,EAAO,MAAA,CAAO,MAAA,CAAO,iBAAA,EAAmB,CAAA,EAAG,CAAA,GAC3C,OAAA,EAAS,gCAAA,GACR,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA,GAAkB,CAAA,EAAG,CAAA,GAAI,cAAA,GAAiB,uBAAA;AAAA"}
+{"version":3,"file":"MusicGenerator.d.mts","names":[],"sources":["../../src/music-generator/MusicGenerator.ts"],"mappings":";;;;;;;;;KAwBY,qBAAA;;;;;;;;;;WAUD,QAAA,GACP,OAAA,EAAS,0BAAA,KACN,MAAA,CAAO,MAAA,CAAO,cAAA,EAAgB,OAAA;;;;;;;WAO1B,gBAAA,GACP,OAAA,EAAS,gCAAA,KACN,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA;;;AArBjC;;;;;;;;;;;;;;;;;;;;WA4CW,oBAAA,SACP,KAAA,EAAO,MAAA,CAAO,MAAA,CAAO,iBAAA,EAAmB,CAAA,EAAG,CAAA,GAC3C,OAAA,EAAS,gCAAA,KACN,MAAA,CAAO,MAAA,CAAO,gBAAA,EAAkB,OAAA,GAAkB,CAAA,EAAG,CAAA;AAAA;AAAA,cAC3D,mBAAA;cAEY,cAAA,SAAuB,mBAAA;AAAA,cAEhC,4BAAA;;;;;;;;;;;cAYS,uBAAA,SAAgC,4BAAA;;cAKhC,QAAA,GACX,OAAA,EAAS,0BAAA,KACR,MAAA,CAAO,MAAA,CAAO,cAAA,EAAgB,OAAA,EAAiB,cAAA;;cAIrC,gBAAA,GACX,OAAA,EAAS,gCAAA,KACR,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA,EAAiB,cAAA;;;;;;;;;;;;;;;;;;AA7B7C;;;;;;;cAwDY,oBAAA;EAAA,CAET,OAAA,EAAS,gCAAA,UAET,KAAA,EAAO,MAAA,CAAO,MAAA,CAAO,iBAAA,EAAmB,CAAA,EAAG,CAAA,MACxC,MAAA,CAAO,MAAA,CACV,gBAAA,EACA,OAAA,GAAkB,CAAA,EAClB,CAAA,GAAI,cAAA,GAAiB,uBAAA;EAAA,OAGrB,KAAA,EAAO,MAAA,CAAO,MAAA,CAAO,iBAAA,EAAmB,CAAA,EAAG,CAAA,GAC3C,OAAA,EAAS,gCAAA,GACR,MAAA,CAAO,MAAA,CACR,gBAAA,EACA,OAAA,GAAkB,CAAA,EAClB,CAAA,GAAI,cAAA,GAAiB,uBAAA;AAAA"}

package/dist/music-generator/MusicGenerator.mjs

@@ -10,33 +10,41 @@ var MusicGenerator_exports = /* @__PURE__ */ __exportAll({
 });
 var MusicGenerator = class extends Context.Service()("@betalyra/effect-uai/MusicGenerator") {};
 /**
-* Capability marker — provided by provider layers whose
+* Capability marker, provided by provider layers whose
 * `streamGenerationFrom` is wired up at the wire level. Currently only
 * Lyria RealTime (via the BidiGenerateMusic WebSocket) ships it.
 * Calling `streamGenerationFrom` while only a non-interactive Layer is
 * in scope fails at `Effect.provide` with a type error.
 *
-* Phantom — the value is `void`; providers register with
+* Phantom: the value is `void`; providers register with
 * `Layer.succeed(MusicInteractiveSession, undefined)`.
 */
 var MusicInteractiveSession = class extends Context.Service()("@betalyra/effect-uai/capability/MusicInteractiveSession") {};
-/** One-shot generation. */
+/** One-shot generation. Returns the full `GenerateResult`. */
 const generate = (request) => Effect.flatMap(MusicGenerator.asEffect(), (s) => s.generate(request));
 /** Prompt in, audio chunks out. */
 const streamGeneration = (request) => Stream.unwrap(Effect.map(MusicGenerator.asEffect(), (s) => s.streamGeneration(request)));
 /**
 * Bidirectional generation. Dual-arity: pipeable (data-last) and
-* direct (data-first). Requires `MusicInteractiveSession` in R —
+* direct (data-first). Requires `MusicInteractiveSession` in R,
 * providers without bidirectional support are a type error at provide
 * time.
 *
+* On the cross-provider surface, `input` is `Stream<unknown>` and
+* output is `Stream<MusicStreamEvent>`. Use the provider-typed
+* service (`LyriaRealtimeGenerator`) when you want to construct
+* typed session messages.
+*
 * @example
 * ```ts
-* const audio = Stream.fromIterable([
-*   Music.promptsInput([{ text: "minimal techno", weight: 1.0 }]),
-*   Music.configInput({ bpm: 124 }),
-* ]).pipe(
-*   MusicGenerator.streamGenerationFrom({ model: "lyria-realtime-001", prompts: "" }),
+* // Generic surface (opaque input):
+* const audio = inputs.pipe(
+*   MusicGenerator.streamGenerationFrom({ model: "lyria-realtime-exp", prompt: "" }),
+* )
+*
+* // Lyria-typed surface (full config knobs):
+* const audio = inputs.pipe(
+*   LyriaRealtimeGenerator.streamGenerationFrom({ model: "lyria-realtime-exp", prompt: "" }),
 * )
 * ```
 */

package/dist/music-generator/MusicGenerator.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"MusicGenerator.mjs","names":[],"sources":["../../src/music-generator/MusicGenerator.ts"],"sourcesContent":["import { Context, Effect, Function, Stream } from \"effect\"\nimport * as AiError from \"../domain/AiError.js\"\nimport type { AudioChunk } from \"../domain/Audio.js\"\nimport type {\n  CommonGenerateMusicRequest,\n  CommonStreamGenerateMusicRequest,\n  MusicResult,\n  MusicSessionInput,\n} from \"../domain/Music.js\"\n\nexport type {\n  CommonGenerateMusicRequest,\n  CommonStreamGenerateMusicRequest,\n  MusicResult,\n  MusicSessionInput,\n  WeightedPrompt,\n} from \"../domain/Music.js\"\n\nexport type MusicGeneratorService = {\n  /**\n   * One-shot. Prompt in, full audio bytes out. Universally supported.\n   * Async/poll-based providers (Suno, Mureka) hide their poll loop\n   * inside the adapter — caller still sees a single `Effect`.\n   */\n  readonly generate: (\n    request: CommonGenerateMusicRequest,\n  ) => Effect.Effect<MusicResult, AiError.AiError>\n  /**\n   * Prompt in, audio chunks streamed out. Providers without a native\n   * chunked-output endpoint (Lyria 3 sync, Mureka, MiniMax, Stable\n   * Audio) emulate this by calling `generate` and emitting a single\n   * `AudioChunk` — first-class, no `Unsupported`.\n   */\n  readonly streamGeneration: (\n    request: CommonStreamGenerateMusicRequest,\n  ) => Stream.Stream<AudioChunk, AiError.AiError>\n  /**\n   * Bidirectional session: a `Stream` of prompt-or-config updates flows\n   * in, a `Stream` of audio chunks flows out. The session WS / RPC is\n   * acquired on first pull and released when the output stream is\n   * finalized via `Stream.scoped`.\n   *\n   * Gated by the `MusicInteractiveSession` capability marker on the\n   * top-level helper — providers without bidirectional support don't\n   * ship the marker, so calls fail at `Effect.provide` with a type\n   * error.\n   */\n  readonly streamGenerationFrom: <E, R>(\n    input: Stream.Stream<MusicSessionInput, E, R>,\n    request: CommonStreamGenerateMusicRequest,\n  ) => Stream.Stream<AudioChunk, AiError.AiError | E, R>\n}\n\nexport class MusicGenerator extends Context.Service<MusicGenerator, MusicGeneratorService>()(\n  \"@betalyra/effect-uai/MusicGenerator\",\n) {}\n\n/**\n * Capability marker — provided by provider layers whose\n * `streamGenerationFrom` is wired up at the wire level. Currently only\n * Lyria RealTime (via the BidiGenerateMusic WebSocket) ships it.\n * Calling `streamGenerationFrom` while only a non-interactive Layer is\n * in scope fails at `Effect.provide` with a type error.\n *\n * Phantom — the value is `void`; providers register with\n * `Layer.succeed(MusicInteractiveSession, undefined)`.\n */\nexport class MusicInteractiveSession extends Context.Service<MusicInteractiveSession, void>()(\n  \"@betalyra/effect-uai/capability/MusicInteractiveSession\",\n) {}\n\n/** One-shot generation. */\nexport const generate = (\n  request: CommonGenerateMusicRequest,\n): Effect.Effect<MusicResult, AiError.AiError, MusicGenerator> =>\n  Effect.flatMap(MusicGenerator.asEffect(), (s) => s.generate(request))\n\n/** Prompt in, audio chunks out. */\nexport const streamGeneration = (\n  request: CommonStreamGenerateMusicRequest,\n): Stream.Stream<AudioChunk, AiError.AiError, MusicGenerator> =>\n  Stream.unwrap(Effect.map(MusicGenerator.asEffect(), (s) => s.streamGeneration(request)))\n\n/**\n * Bidirectional generation. Dual-arity: pipeable (data-last) and\n * direct (data-first). Requires `MusicInteractiveSession` in R —\n * providers without bidirectional support are a type error at provide\n * time.\n *\n * @example\n * ```ts\n * const audio = Stream.fromIterable([\n *   Music.promptsInput([{ text: \"minimal techno\", weight: 1.0 }]),\n *   Music.configInput({ bpm: 124 }),\n * ]).pipe(\n *   MusicGenerator.streamGenerationFrom({ model: \"lyria-realtime-001\", prompts: \"\" }),\n * )\n * ```\n */\nexport const streamGenerationFrom: {\n  (\n    request: CommonStreamGenerateMusicRequest,\n  ): <E, R>(\n    input: Stream.Stream<MusicSessionInput, E, R>,\n  ) => Stream.Stream<AudioChunk, AiError.AiError | E, R | MusicGenerator | MusicInteractiveSession>\n  <E, R>(\n    input: Stream.Stream<MusicSessionInput, E, R>,\n    request: CommonStreamGenerateMusicRequest,\n  ): Stream.Stream<AudioChunk, AiError.AiError | E, R | MusicGenerator | MusicInteractiveSession>\n} = Function.dual(\n  2,\n  <E, R>(\n    input: Stream.Stream<MusicSessionInput, E, R>,\n    request: CommonStreamGenerateMusicRequest,\n  ) =>\n    Stream.unwrap(\n      Effect.gen(function* () {\n        const s = yield* MusicGenerator.asEffect()\n        yield* MusicInteractiveSession.asEffect()\n        return s.streamGenerationFrom(input, request)\n      }),\n    ),\n)\n"],"mappings":";;;;;;;;;;AAqDA,IAAa,iBAAb,cAAoC,QAAQ,SAAgD,CAC1F,sCACD,CAAC;;;;;;;;;;;AAYF,IAAa,0BAAb,cAA6C,QAAQ,SAAwC,CAC3F,0DACD,CAAC;;AAGF,MAAa,YACX,YAEA,OAAO,QAAQ,eAAe,UAAU,GAAG,MAAM,EAAE,SAAS,QAAQ,CAAC;;AAGvE,MAAa,oBACX,YAEA,OAAO,OAAO,OAAO,IAAI,eAAe,UAAU,GAAG,MAAM,EAAE,iBAAiB,QAAQ,CAAC,CAAC;;;;;;;;;;;;;;;;;AAkB1F,MAAa,uBAUT,SAAS,KACX,IAEE,OACA,YAEA,OAAO,OACL,OAAO,IAAI,aAAa;CACtB,MAAM,IAAI,OAAO,eAAe,UAAU;AAC1C,QAAO,wBAAwB,UAAU;AACzC,QAAO,EAAE,qBAAqB,OAAO,QAAQ;EAC7C,CACH,CACJ"}
+{"version":3,"file":"MusicGenerator.mjs","names":[],"sources":["../../src/music-generator/MusicGenerator.ts"],"sourcesContent":["import { Context, Effect, Function, Stream } from \"effect\"\nimport * as AiError from \"../domain/AiError.js\"\nimport type {\n  CommonGenerateMusicRequest,\n  CommonStreamGenerateMusicRequest,\n  GenerateResult,\n  MusicSessionInput,\n  MusicStreamEvent,\n} from \"../domain/Music.js\"\nimport type { AudioChunk } from \"../domain/Audio.js\"\n\nexport type {\n  CommonGenerateMusicRequest,\n  CommonStreamGenerateMusicRequest,\n  GenerateResult,\n  MusicResult,\n  MusicSection,\n  MusicSessionControl,\n  MusicSessionInput,\n  MusicStreamEvent,\n  Watermark,\n  WeightedPrompt,\n} from \"../domain/Music.js\"\n\nexport type MusicGeneratorService = {\n  /**\n   * One-shot. Prompt in, full audio bytes out. Universally supported.\n   * Async/poll-based providers (Suno, Mureka) hide their poll loop\n   * inside the adapter, caller still sees a single `Effect`.\n   *\n   * Returns `GenerateResult` with `primary` plus a `variants` array.\n   * Suno and Mureka always return 2 tracks; every other provider\n   * returns 1 (and `primary === variants[0]`).\n   */\n  readonly generate: (\n    request: CommonGenerateMusicRequest,\n  ) => Effect.Effect<GenerateResult, AiError.AiError>\n  /**\n   * Prompt in, audio chunks streamed out. Providers without a native\n   * chunked-output endpoint (Lyria 3 sync, Mureka, MiniMax, Stable\n   * Audio) emulate this by calling `generate` and emitting a single\n   * `AudioChunk`, first-class, no `Unsupported`.\n   */\n  readonly streamGeneration: (\n    request: CommonStreamGenerateMusicRequest,\n  ) => Stream.Stream<AudioChunk, AiError.AiError>\n  /**\n   * Bidirectional session: a `Stream` of `MusicSessionInput` (prompts\n   * + playback control) flows in, a `Stream` of `MusicStreamEvent`\n   * flows out. The session WS / RPC is acquired on first pull and\n   * released when the output stream is finalized via `Stream.scoped`.\n   *\n   * Cross-provider callers send `prompts` (steer the active\n   * generation) and `control` (play / pause / stop / reset) — the two\n   * actions that converge across interactive-media protocols.\n   * Provider-specific model knobs (Lyria RealTime's density /\n   * brightness / mute-stems / BPM / scale, etc.) live on the\n   * provider-typed service (`LyriaRealtimeGenerator.streamGenerationFrom`),\n   * which extends this union with its own `config` variant.\n   *\n   * Output is `MusicStreamEvent`: `audio` chunks alongside in-band\n   * `warning` and `filteredPrompt` events the model emits server-side.\n   *\n   * Gated by the `MusicInteractiveSession` capability marker on the\n   * top-level helper. Providers without bidirectional support don't\n   * ship the marker, so calls fail at `Effect.provide` with a type\n   * error.\n   */\n  readonly streamGenerationFrom: <E, R>(\n    input: Stream.Stream<MusicSessionInput, E, R>,\n    request: CommonStreamGenerateMusicRequest,\n  ) => Stream.Stream<MusicStreamEvent, AiError.AiError | E, R>\n}\n\nexport class MusicGenerator extends Context.Service<MusicGenerator, MusicGeneratorService>()(\n  \"@betalyra/effect-uai/MusicGenerator\",\n) {}\n\n/**\n * Capability marker, provided by provider layers whose\n * `streamGenerationFrom` is wired up at the wire level. Currently only\n * Lyria RealTime (via the BidiGenerateMusic WebSocket) ships it.\n * Calling `streamGenerationFrom` while only a non-interactive Layer is\n * in scope fails at `Effect.provide` with a type error.\n *\n * Phantom: the value is `void`; providers register with\n * `Layer.succeed(MusicInteractiveSession, undefined)`.\n */\nexport class MusicInteractiveSession extends Context.Service<MusicInteractiveSession, void>()(\n  \"@betalyra/effect-uai/capability/MusicInteractiveSession\",\n) {}\n\n/** One-shot generation. Returns the full `GenerateResult`. */\nexport const generate = (\n  request: CommonGenerateMusicRequest,\n): Effect.Effect<GenerateResult, AiError.AiError, MusicGenerator> =>\n  Effect.flatMap(MusicGenerator.asEffect(), (s) => s.generate(request))\n\n/** Prompt in, audio chunks out. */\nexport const streamGeneration = (\n  request: CommonStreamGenerateMusicRequest,\n): Stream.Stream<AudioChunk, AiError.AiError, MusicGenerator> =>\n  Stream.unwrap(Effect.map(MusicGenerator.asEffect(), (s) => s.streamGeneration(request)))\n\n/**\n * Bidirectional generation. Dual-arity: pipeable (data-last) and\n * direct (data-first). Requires `MusicInteractiveSession` in R,\n * providers without bidirectional support are a type error at provide\n * time.\n *\n * On the cross-provider surface, `input` is `Stream<unknown>` and\n * output is `Stream<MusicStreamEvent>`. Use the provider-typed\n * service (`LyriaRealtimeGenerator`) when you want to construct\n * typed session messages.\n *\n * @example\n * ```ts\n * // Generic surface (opaque input):\n * const audio = inputs.pipe(\n *   MusicGenerator.streamGenerationFrom({ model: \"lyria-realtime-exp\", prompt: \"\" }),\n * )\n *\n * // Lyria-typed surface (full config knobs):\n * const audio = inputs.pipe(\n *   LyriaRealtimeGenerator.streamGenerationFrom({ model: \"lyria-realtime-exp\", prompt: \"\" }),\n * )\n * ```\n */\nexport const streamGenerationFrom: {\n  (\n    request: CommonStreamGenerateMusicRequest,\n  ): <E, R>(\n    input: Stream.Stream<MusicSessionInput, E, R>,\n  ) => Stream.Stream<\n    MusicStreamEvent,\n    AiError.AiError | E,\n    R | MusicGenerator | MusicInteractiveSession\n  >\n  <E, R>(\n    input: Stream.Stream<MusicSessionInput, E, R>,\n    request: CommonStreamGenerateMusicRequest,\n  ): Stream.Stream<\n    MusicStreamEvent,\n    AiError.AiError | E,\n    R | MusicGenerator | MusicInteractiveSession\n  >\n} = Function.dual(\n  2,\n  <E, R>(\n    input: Stream.Stream<MusicSessionInput, E, R>,\n    request: CommonStreamGenerateMusicRequest,\n  ): Stream.Stream<\n    MusicStreamEvent,\n    AiError.AiError | E,\n    R | MusicGenerator | MusicInteractiveSession\n  > =>\n    Stream.unwrap(\n      Effect.gen(function* () {\n        const s = yield* MusicGenerator.asEffect()\n        yield* MusicInteractiveSession.asEffect()\n        return s.streamGenerationFrom(input, request)\n      }),\n    ),\n)\n"],"mappings":";;;;;;;;;;AA0EA,IAAa,iBAAb,cAAoC,QAAQ,SAAgD,CAC1F,sCACD,CAAC;;;;;;;;;;;AAYF,IAAa,0BAAb,cAA6C,QAAQ,SAAwC,CAC3F,0DACD,CAAC;;AAGF,MAAa,YACX,YAEA,OAAO,QAAQ,eAAe,UAAU,GAAG,MAAM,EAAE,SAAS,QAAQ,CAAC;;AAGvE,MAAa,oBACX,YAEA,OAAO,OAAO,OAAO,IAAI,eAAe,UAAU,GAAG,MAAM,EAAE,iBAAiB,QAAQ,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;AA0B1F,MAAa,uBAkBT,SAAS,KACX,IAEE,OACA,YAMA,OAAO,OACL,OAAO,IAAI,aAAa;CACtB,MAAM,IAAI,OAAO,eAAe,UAAU;AAC1C,QAAO,wBAAwB,UAAU;AACzC,QAAO,EAAE,qBAAqB,OAAO,QAAQ;EAC7C,CACH,CACJ"}

package/dist/music-generator/MusicGenerator.test.mjs

@@ -1,66 +1,90 @@
-import { configInput, promptsInput } from "../domain/Music.mjs";
+import { audioEvent, controlInput, promptsInput, singleVariant } from "../domain/Music.mjs";
 import { generate, streamGeneration, streamGenerationFrom } from "./MusicGenerator.mjs";
 import { i as it, n as globalExpect, r as describe, t as import_dist } from "../dist-DV5ISja1.mjs";
 import { layer, layerWithoutInteractive } from "../testing/MockMusicGenerator.mjs";
-import { Effect, Stream } from "effect";
+import { Duration, Effect, Stream } from "effect";
 //#region src/music-generator/MusicGenerator.test.ts
-const result = {
-	format: {
-		container: "mp3",
-		encoding: "mp3",
-		sampleRate: 44100,
-		channels: 2
+const oneResult = {
+	audio: {
+		format: {
+			container: "mp3",
+			encoding: "mp3",
+			sampleRate: 44100,
+			channels: 2
+		},
+		bytes: new Uint8Array([
+			255,
+			251,
+			144,
+			0
+		]),
+		duration: Duration.seconds(30)
 	},
-	bytes: new Uint8Array([
-		255,
-		251,
-		144,
-		0
-	]),
-	durationSeconds: 30,
+	provider: "mock-music",
 	lyrics: "[Verse]\nhello\n",
-	watermark: { kind: "synthid" }
+	watermark: "synthid"
 };
+const oneVariant = singleVariant(oneResult);
 const chunk = (n) => ({ bytes: new Uint8Array([n]) });
 describe("MusicGenerator.generate", () => {
-	it("returns the scripted MusicResult", async () => {
-		const mock = layer({ results: [result] });
+	it("returns the scripted GenerateResult", async () => {
+		const mock = layer({ results: [oneVariant] });
 		const program = generate({
 			model: "mock-music",
-			prompts: "upbeat indie pop"
+			prompt: "upbeat indie pop"
 		});
 		const out = await Effect.runPromise(program.pipe(Effect.provide(mock.layer)));
-		globalExpect(out.bytes).toEqual(result.bytes);
-		globalExpect(out.durationSeconds).toBe(30);
-		globalExpect(out.watermark?.kind).toBe("synthid");
-		globalExpect(out.lyrics).toContain("[Verse]");
+		globalExpect(out.primary.audio.bytes).toEqual(oneResult.audio.bytes);
+		globalExpect(out.primary.audio.duration).toEqual(Duration.seconds(30));
+		globalExpect(out.primary.watermark).toBe("synthid");
+		globalExpect(out.primary.lyrics).toContain("[Verse]");
+		globalExpect(out.variants).toHaveLength(1);
+		globalExpect(out.variants[0]).toBe(out.primary);
+	});
+	it("exposes multiple variants when the provider returned more than one", async () => {
+		const secondTrack = {
+			...oneResult,
+			audio: {
+				...oneResult.audio,
+				bytes: new Uint8Array([
+					255,
+					251,
+					160,
+					0
+				])
+			}
+		};
+		const mock = layer({ results: [{
+			primary: oneResult,
+			variants: [oneResult, secondTrack]
+		}] });
+		const program = generate({
+			model: "m",
+			prompt: "house"
+		});
+		const out = await Effect.runPromise(program.pipe(Effect.provide(mock.layer)));
+		globalExpect(out.variants).toHaveLength(2);
+		globalExpect(out.variants[1].audio.bytes).toEqual(secondTrack.audio.bytes);
 	});
 	it("records the request shape on the recorder", async () => {
-		const mock = layer({ results: [result, result] });
+		const mock = layer({ results: [oneVariant, oneVariant] });
 		const program = Effect.gen(function* () {
 			yield* generate({
 				model: "m",
-				prompts: "techno"
+				prompt: "techno"
 			});
 			yield* generate({
 				model: "m",
-				prompts: [{
-					text: "synthwave",
-					weight: 1
-				}, {
-					text: "80s movie OST",
-					weight: .4
-				}],
-				bpm: 120,
-				instrumental: true
+				prompt: "synthwave",
+				duration: Duration.seconds(45),
+				seed: 42
 			});
 			return yield* mock.recorder;
 		});
 		const rec = await Effect.runPromise(program.pipe(Effect.provide(mock.layer)));
 		globalExpect(rec.generateCalls.length).toBe(2);
-		globalExpect(rec.generateCalls[1].bpm).toBe(120);
-		globalExpect(rec.generateCalls[1].instrumental).toBe(true);
-		globalExpect(Array.isArray(rec.generateCalls[1].prompts)).toBe(true);
+		globalExpect(rec.generateCalls[1].duration).toEqual(Duration.seconds(45));
+		globalExpect(rec.generateCalls[1].seed).toBe(42);
 	});
 });
 describe("MusicGenerator.streamGeneration", () => {
@@ -72,7 +96,7 @@ describe("MusicGenerator.streamGeneration", () => {
 		]] });
 		const program = Stream.runCollect(streamGeneration({
 			model: "m",
-			prompts: "ambient"
+			prompt: "ambient"
 		}));
 		globalExpect((await Effect.runPromise(program.pipe(Effect.provide(mock.layer)))).map((c) => Array.from(c.bytes))).toEqual([
 			[1],
@@ -84,7 +108,7 @@ describe("MusicGenerator.streamGeneration", () => {
 describe("MusicGenerator capability marker (compile-time)", () => {
 	const sgfReq = {
 		model: "m",
-		prompts: ""
+		prompt: ""
 	};
 	it("requires `MusicInteractiveSession` on the R channel of streamGenerationFrom", () => {
 		(0, import_dist.expectTypeOf)(Stream.fromIterable([promptsInput([{ text: "techno" }])]).pipe(streamGenerationFrom(sgfReq))).toEqualTypeOf();
@@ -92,39 +116,39 @@ describe("MusicGenerator capability marker (compile-time)", () => {
 	it("does NOT require `MusicInteractiveSession` for sync `generate`", () => {
 		(0, import_dist.expectTypeOf)(generate({
 			model: "m",
-			prompts: "ambient"
+			prompt: "ambient"
 		})).toEqualTypeOf();
 	});
 	it("does NOT require `MusicInteractiveSession` for `streamGeneration`", () => {
 		(0, import_dist.expectTypeOf)(streamGeneration({
 			model: "m",
-			prompts: "ambient"
+			prompt: "ambient"
 		})).toEqualTypeOf();
 	});
 	it("a layer without the marker leaves `MusicInteractiveSession` unsatisfied in R", () => {
 		const noMarker = layerWithoutInteractive({});
-		const audio = Stream.fromIterable([promptsInput([{ text: "techno" }])]).pipe(streamGenerationFrom(sgfReq));
-		(0, import_dist.expectTypeOf)(Stream.runDrain(audio).pipe(Effect.provide(noMarker.layer))).toEqualTypeOf();
+		const events = Stream.fromIterable([promptsInput([{ text: "techno" }])]).pipe(streamGenerationFrom(sgfReq));
+		(0, import_dist.expectTypeOf)(Stream.runDrain(events).pipe(Effect.provide(noMarker.layer))).toEqualTypeOf();
 	});
 	it("a full layer (with marker) clears R to never", () => {
-		const fullMock = layer({ streamGenerationFromChunks: [[]] });
-		const audio = Stream.fromIterable([promptsInput([{ text: "techno" }])]).pipe(streamGenerationFrom(sgfReq));
-		(0, import_dist.expectTypeOf)(Stream.runDrain(audio).pipe(Effect.provide(fullMock.layer))).toEqualTypeOf();
+		const fullMock = layer({ streamGenerationFromEvents: [[]] });
+		const events = Stream.fromIterable([promptsInput([{ text: "techno" }])]).pipe(streamGenerationFrom(sgfReq));
+		(0, import_dist.expectTypeOf)(Stream.runDrain(events).pipe(Effect.provide(fullMock.layer))).toEqualTypeOf();
 	});
 });
 describe("MusicGenerator.streamGenerationFrom", () => {
 	const sgfReq = {
-		model: "lyria-realtime-001",
-		prompts: ""
+		model: "lyria-realtime-exp",
+		prompt: ""
 	};
-	it("drains a session-input stream and emits scripted audio", async () => {
-		const mock = layer({ streamGenerationFromChunks: [[chunk(10), chunk(20)]] });
-		const audio = Stream.fromIterable([
+	it("drains a session-input stream and emits scripted events", async () => {
+		const mock = layer({ streamGenerationFromEvents: [[audioEvent(chunk(10)), audioEvent(chunk(20))]] });
+		const events = Stream.fromIterable([
 			promptsInput([{
 				text: "minimal techno",
 				weight: 1
 			}]),
-			configInput({ bpm: 124 }),
+			controlInput("play"),
 			promptsInput([{
 				text: "minimal techno",
 				weight: 1
@@ -133,17 +157,18 @@ describe("MusicGenerator.streamGenerationFrom", () => {
 				weight: .3
 			}])
 		]).pipe(streamGenerationFrom(sgfReq));
-		globalExpect((await Effect.runPromise(Stream.runCollect(audio).pipe(Effect.provide(mock.layer)))).map((c) => Array.from(c.bytes))).toEqual([[10], [20]]);
+		globalExpect((await Effect.runPromise(Stream.runCollect(events).pipe(Effect.provide(mock.layer)))).flatMap((e) => e._tag === "audio" ? [e.chunk] : []).map((c) => Array.from(c.bytes))).toEqual([[10], [20]]);
 	});
 	it("records the request on the streamGenerationFrom call channel", async () => {
-		const mock = layer({ streamGenerationFromChunks: [[chunk(42)]] });
+		const mock = layer({ streamGenerationFromEvents: [[audioEvent(chunk(42))]] });
 		const program = Effect.gen(function* () {
-			yield* Stream.runDrain(Stream.fromIterable([promptsInput([{ text: "x" }])]).pipe(streamGenerationFrom(sgfReq)));
+			const inputs = Stream.fromIterable([promptsInput([{ text: "x" }])]);
+			yield* Stream.runDrain(inputs.pipe(streamGenerationFrom(sgfReq)));
 			return yield* mock.recorder;
 		});
 		const rec = await Effect.runPromise(program.pipe(Effect.provide(mock.layer)));
 		globalExpect(rec.streamGenerationFromCalls.length).toBe(1);
-		globalExpect(rec.streamGenerationFromCalls[0].model).toBe("lyria-realtime-001");
+		globalExpect(rec.streamGenerationFromCalls[0].model).toBe("lyria-realtime-exp");
 		globalExpect(rec.generateCalls.length).toBe(0);
 		globalExpect(rec.streamGenerationCalls.length).toBe(0);
 	});

package/dist/music-generator/MusicGenerator.test.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"MusicGenerator.test.mjs","names":["MockMusicGenerator.layer","MusicGenerator.generate","MusicGenerator.streamGeneration","MusicGenerator.streamGenerationFrom","MockMusicGenerator.layerWithoutInteractive"],"sources":["../../src/music-generator/MusicGenerator.test.ts"],"sourcesContent":["import { Effect, Stream } from \"effect\"\nimport { describe, expect, expectTypeOf, it } from \"vitest\"\nimport type * as AiError from \"../domain/AiError.js\"\nimport type { AudioChunk, AudioFormat } from \"../domain/Audio.js\"\nimport { configInput, promptsInput, type MusicResult } from \"../domain/Music.js\"\nimport * as MockMusicGenerator from \"../testing/MockMusicGenerator.js\"\nimport * as MusicGenerator from \"./MusicGenerator.js\"\n\nconst mp3Format: AudioFormat = {\n  container: \"mp3\",\n  encoding: \"mp3\",\n  sampleRate: 44100,\n  channels: 2,\n}\n\nconst result: MusicResult = {\n  format: mp3Format,\n  bytes: new Uint8Array([0xff, 0xfb, 0x90, 0x00]),\n  durationSeconds: 30,\n  lyrics: \"[Verse]\\nhello\\n\",\n  watermark: { kind: \"synthid\" },\n}\n\nconst chunk = (n: number): AudioChunk => ({ bytes: new Uint8Array([n]) })\n\ndescribe(\"MusicGenerator.generate\", () => {\n  it(\"returns the scripted MusicResult\", async () => {\n    const mock = MockMusicGenerator.layer({ results: [result] })\n    const program = MusicGenerator.generate({\n      model: \"mock-music\",\n      prompts: \"upbeat indie pop\",\n    })\n    const out = await Effect.runPromise(program.pipe(Effect.provide(mock.layer)))\n    expect(out.bytes).toEqual(result.bytes)\n    expect(out.durationSeconds).toBe(30)\n    expect(out.watermark?.kind).toBe(\"synthid\")\n    expect(out.lyrics).toContain(\"[Verse]\")\n  })\n\n  it(\"records the request shape on the recorder\", async () => {\n    const mock = MockMusicGenerator.layer({ results: [result, result] })\n    const program = Effect.gen(function* () {\n      yield* MusicGenerator.generate({ model: \"m\", prompts: \"techno\" })\n      yield* MusicGenerator.generate({\n        model: \"m\",\n        prompts: [\n          { text: \"synthwave\", weight: 1.0 },\n          { text: \"80s movie OST\", weight: 0.4 },\n        ],\n        bpm: 120,\n        instrumental: true,\n      })\n      return yield* mock.recorder\n    })\n    const rec = await Effect.runPromise(program.pipe(Effect.provide(mock.layer)))\n    expect(rec.generateCalls.length).toBe(2)\n    expect(rec.generateCalls[1]!.bpm).toBe(120)\n    expect(rec.generateCalls[1]!.instrumental).toBe(true)\n    expect(Array.isArray(rec.generateCalls[1]!.prompts)).toBe(true)\n  })\n})\n\ndescribe(\"MusicGenerator.streamGeneration\", () => {\n  it(\"emits scripted chunks\", async () => {\n    const mock = MockMusicGenerator.layer({\n      streamGenerationChunks: [[chunk(1), chunk(2), chunk(3)]],\n    })\n    const program = Stream.runCollect(\n      MusicGenerator.streamGeneration({ model: \"m\", prompts: \"ambient\" }),\n    )\n    const out = await Effect.runPromise(program.pipe(Effect.provide(mock.layer)))\n    expect(out.map((c) => Array.from(c.bytes))).toEqual([[1], [2], [3]])\n  })\n})\n\ndescribe(\"MusicGenerator capability marker (compile-time)\", () => {\n  const sgfReq: MusicGenerator.CommonStreamGenerateMusicRequest = {\n    model: \"m\",\n    prompts: \"\",\n  }\n\n  it(\"requires `MusicInteractiveSession` on the R channel of streamGenerationFrom\", () => {\n    const inputs = Stream.fromIterable([promptsInput([{ text: \"techno\" }])])\n    const audio = inputs.pipe(MusicGenerator.streamGenerationFrom(sgfReq))\n    expectTypeOf(audio).toEqualTypeOf<\n      Stream.Stream<\n        AudioChunk,\n        AiError.AiError,\n        MusicGenerator.MusicGenerator | MusicGenerator.MusicInteractiveSession\n      >\n    >()\n  })\n\n  it(\"does NOT require `MusicInteractiveSession` for sync `generate`\", () => {\n    const eff = MusicGenerator.generate({ model: \"m\", prompts: \"ambient\" })\n    expectTypeOf(eff).toEqualTypeOf<\n      Effect.Effect<MusicResult, AiError.AiError, MusicGenerator.MusicGenerator>\n    >()\n  })\n\n  it(\"does NOT require `MusicInteractiveSession` for `streamGeneration`\", () => {\n    const audio = MusicGenerator.streamGeneration({ model: \"m\", prompts: \"ambient\" })\n    expectTypeOf(audio).toEqualTypeOf<\n      Stream.Stream<AudioChunk, AiError.AiError, MusicGenerator.MusicGenerator>\n    >()\n  })\n\n  it(\"a layer without the marker leaves `MusicInteractiveSession` unsatisfied in R\", () => {\n    const noMarker = MockMusicGenerator.layerWithoutInteractive({})\n    const inputs = Stream.fromIterable([promptsInput([{ text: \"techno\" }])])\n    const audio = inputs.pipe(MusicGenerator.streamGenerationFrom(sgfReq))\n    const program = Stream.runDrain(audio).pipe(Effect.provide(noMarker.layer))\n    expectTypeOf(program).toEqualTypeOf<\n      Effect.Effect<void, AiError.AiError, MusicGenerator.MusicInteractiveSession>\n    >()\n  })\n\n  it(\"a full layer (with marker) clears R to never\", () => {\n    const fullMock = MockMusicGenerator.layer({\n      streamGenerationFromChunks: [[]],\n    })\n    const inputs = Stream.fromIterable([promptsInput([{ text: \"techno\" }])])\n    const audio = inputs.pipe(MusicGenerator.streamGenerationFrom(sgfReq))\n    const program = Stream.runDrain(audio).pipe(Effect.provide(fullMock.layer))\n    expectTypeOf(program).toEqualTypeOf<Effect.Effect<void, AiError.AiError, never>>()\n  })\n})\n\ndescribe(\"MusicGenerator.streamGenerationFrom\", () => {\n  const sgfReq: MusicGenerator.CommonStreamGenerateMusicRequest = {\n    model: \"lyria-realtime-001\",\n    prompts: \"\",\n  }\n\n  it(\"drains a session-input stream and emits scripted audio\", async () => {\n    const mock = MockMusicGenerator.layer({\n      streamGenerationFromChunks: [[chunk(10), chunk(20)]],\n    })\n    const inputs = Stream.fromIterable([\n      promptsInput([{ text: \"minimal techno\", weight: 1.0 }]),\n      configInput({ bpm: 124 }),\n      promptsInput([\n        { text: \"minimal techno\", weight: 1.0 },\n        { text: \"1980s synthwave\", weight: 0.3 },\n      ]),\n    ])\n    const audio = inputs.pipe(MusicGenerator.streamGenerationFrom(sgfReq))\n    const out = await Effect.runPromise(Stream.runCollect(audio).pipe(Effect.provide(mock.layer)))\n    expect(out.map((c) => Array.from(c.bytes))).toEqual([[10], [20]])\n  })\n\n  it(\"records the request on the streamGenerationFrom call channel\", async () => {\n    const mock = MockMusicGenerator.layer({\n      streamGenerationFromChunks: [[chunk(42)]],\n    })\n    const program = Effect.gen(function* () {\n      yield* Stream.runDrain(\n        Stream.fromIterable([promptsInput([{ text: \"x\" }])]).pipe(\n          MusicGenerator.streamGenerationFrom(sgfReq),\n        ),\n      )\n      return yield* mock.recorder\n    })\n    const rec = await Effect.runPromise(program.pipe(Effect.provide(mock.layer)))\n    expect(rec.streamGenerationFromCalls.length).toBe(1)\n    expect(rec.streamGenerationFromCalls[0]!.model).toBe(\"lyria-realtime-001\")\n    expect(rec.generateCalls.length).toBe(0)\n    expect(rec.streamGenerationCalls.length).toBe(0)\n  })\n})\n"],"mappings":"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"}
+{"version":3,"file":"MusicGenerator.test.mjs","names":["MockMusicGenerator.layer","MusicGenerator.generate","MusicGenerator.streamGeneration","MusicGenerator.streamGenerationFrom","MockMusicGenerator.layerWithoutInteractive"],"sources":["../../src/music-generator/MusicGenerator.test.ts"],"sourcesContent":["import { Duration, Effect, Stream } from \"effect\"\nimport { describe, expect, expectTypeOf, it } from \"vitest\"\nimport type * as AiError from \"../domain/AiError.js\"\nimport type { AudioChunk, AudioFormat } from \"../domain/Audio.js\"\nimport {\n  audioEvent,\n  controlInput,\n  type GenerateResult,\n  type MusicResult,\n  type MusicStreamEvent,\n  promptsInput,\n  singleVariant,\n} from \"../domain/Music.js\"\nimport * as MockMusicGenerator from \"../testing/MockMusicGenerator.js\"\nimport * as MusicGenerator from \"./MusicGenerator.js\"\n\nconst mp3Format: AudioFormat = {\n  container: \"mp3\",\n  encoding: \"mp3\",\n  sampleRate: 44100,\n  channels: 2,\n}\n\nconst oneResult: MusicResult = {\n  audio: {\n    format: mp3Format,\n    bytes: new Uint8Array([0xff, 0xfb, 0x90, 0x00]),\n    duration: Duration.seconds(30),\n  },\n  provider: \"mock-music\",\n  lyrics: \"[Verse]\\nhello\\n\",\n  watermark: \"synthid\",\n}\n\nconst oneVariant: GenerateResult = singleVariant(oneResult)\n\nconst chunk = (n: number): AudioChunk => ({ bytes: new Uint8Array([n]) })\n\ndescribe(\"MusicGenerator.generate\", () => {\n  it(\"returns the scripted GenerateResult\", async () => {\n    const mock = MockMusicGenerator.layer({ results: [oneVariant] })\n    const program = MusicGenerator.generate({\n      model: \"mock-music\",\n      prompt: \"upbeat indie pop\",\n    })\n    const out = await Effect.runPromise(program.pipe(Effect.provide(mock.layer)))\n    expect(out.primary.audio.bytes).toEqual(oneResult.audio.bytes)\n    expect(out.primary.audio.duration).toEqual(Duration.seconds(30))\n    expect(out.primary.watermark).toBe(\"synthid\")\n    expect(out.primary.lyrics).toContain(\"[Verse]\")\n    expect(out.variants).toHaveLength(1)\n    expect(out.variants[0]).toBe(out.primary)\n  })\n\n  it(\"exposes multiple variants when the provider returned more than one\", async () => {\n    const secondTrack: MusicResult = {\n      ...oneResult,\n      audio: { ...oneResult.audio, bytes: new Uint8Array([0xff, 0xfb, 0xa0, 0x00]) },\n    }\n    const twoVariants: GenerateResult = {\n      primary: oneResult,\n      variants: [oneResult, secondTrack],\n    }\n    const mock = MockMusicGenerator.layer({ results: [twoVariants] })\n    const program = MusicGenerator.generate({ model: \"m\", prompt: \"house\" })\n    const out = await Effect.runPromise(program.pipe(Effect.provide(mock.layer)))\n    expect(out.variants).toHaveLength(2)\n    expect(out.variants[1]!.audio.bytes).toEqual(secondTrack.audio.bytes)\n  })\n\n  it(\"records the request shape on the recorder\", async () => {\n    const mock = MockMusicGenerator.layer({ results: [oneVariant, oneVariant] })\n    const program = Effect.gen(function* () {\n      yield* MusicGenerator.generate({ model: \"m\", prompt: \"techno\" })\n      yield* MusicGenerator.generate({\n        model: \"m\",\n        prompt: \"synthwave\",\n        duration: Duration.seconds(45),\n        seed: 42,\n      })\n      return yield* mock.recorder\n    })\n    const rec = await Effect.runPromise(program.pipe(Effect.provide(mock.layer)))\n    expect(rec.generateCalls.length).toBe(2)\n    expect(rec.generateCalls[1]!.duration).toEqual(Duration.seconds(45))\n    expect(rec.generateCalls[1]!.seed).toBe(42)\n  })\n})\n\ndescribe(\"MusicGenerator.streamGeneration\", () => {\n  it(\"emits scripted chunks\", async () => {\n    const mock = MockMusicGenerator.layer({\n      streamGenerationChunks: [[chunk(1), chunk(2), chunk(3)]],\n    })\n    const program = Stream.runCollect(\n      MusicGenerator.streamGeneration({ model: \"m\", prompt: \"ambient\" }),\n    )\n    const out = await Effect.runPromise(program.pipe(Effect.provide(mock.layer)))\n    expect(out.map((c) => Array.from(c.bytes))).toEqual([[1], [2], [3]])\n  })\n})\n\ndescribe(\"MusicGenerator capability marker (compile-time)\", () => {\n  const sgfReq: MusicGenerator.CommonStreamGenerateMusicRequest = {\n    model: \"m\",\n    prompt: \"\",\n  }\n\n  it(\"requires `MusicInteractiveSession` on the R channel of streamGenerationFrom\", () => {\n    const inputs = Stream.fromIterable([promptsInput([{ text: \"techno\" }])])\n    const events = inputs.pipe(MusicGenerator.streamGenerationFrom(sgfReq))\n    expectTypeOf(events).toEqualTypeOf<\n      Stream.Stream<\n        MusicStreamEvent,\n        AiError.AiError,\n        MusicGenerator.MusicGenerator | MusicGenerator.MusicInteractiveSession\n      >\n    >()\n  })\n\n  it(\"does NOT require `MusicInteractiveSession` for sync `generate`\", () => {\n    const eff = MusicGenerator.generate({ model: \"m\", prompt: \"ambient\" })\n    expectTypeOf(eff).toEqualTypeOf<\n      Effect.Effect<GenerateResult, AiError.AiError, MusicGenerator.MusicGenerator>\n    >()\n  })\n\n  it(\"does NOT require `MusicInteractiveSession` for `streamGeneration`\", () => {\n    const audio = MusicGenerator.streamGeneration({ model: \"m\", prompt: \"ambient\" })\n    expectTypeOf(audio).toEqualTypeOf<\n      Stream.Stream<AudioChunk, AiError.AiError, MusicGenerator.MusicGenerator>\n    >()\n  })\n\n  it(\"a layer without the marker leaves `MusicInteractiveSession` unsatisfied in R\", () => {\n    const noMarker = MockMusicGenerator.layerWithoutInteractive({})\n    const inputs = Stream.fromIterable([promptsInput([{ text: \"techno\" }])])\n    const events = inputs.pipe(MusicGenerator.streamGenerationFrom(sgfReq))\n    const program = Stream.runDrain(events).pipe(Effect.provide(noMarker.layer))\n    expectTypeOf(program).toEqualTypeOf<\n      Effect.Effect<void, AiError.AiError, MusicGenerator.MusicInteractiveSession>\n    >()\n  })\n\n  it(\"a full layer (with marker) clears R to never\", () => {\n    const fullMock = MockMusicGenerator.layer({\n      streamGenerationFromEvents: [[]],\n    })\n    const inputs = Stream.fromIterable([promptsInput([{ text: \"techno\" }])])\n    const events = inputs.pipe(MusicGenerator.streamGenerationFrom(sgfReq))\n    const program = Stream.runDrain(events).pipe(Effect.provide(fullMock.layer))\n    expectTypeOf(program).toEqualTypeOf<Effect.Effect<void, AiError.AiError, never>>()\n  })\n})\n\ndescribe(\"MusicGenerator.streamGenerationFrom\", () => {\n  const sgfReq: MusicGenerator.CommonStreamGenerateMusicRequest = {\n    model: \"lyria-realtime-exp\",\n    prompt: \"\",\n  }\n\n  it(\"drains a session-input stream and emits scripted events\", async () => {\n    const mock = MockMusicGenerator.layer({\n      streamGenerationFromEvents: [[audioEvent(chunk(10)), audioEvent(chunk(20))]],\n    })\n    const inputs = Stream.fromIterable([\n      promptsInput([{ text: \"minimal techno\", weight: 1.0 }]),\n      controlInput(\"play\"),\n      promptsInput([\n        { text: \"minimal techno\", weight: 1.0 },\n        { text: \"1980s synthwave\", weight: 0.3 },\n      ]),\n    ])\n    const events = inputs.pipe(MusicGenerator.streamGenerationFrom(sgfReq))\n    const out = await Effect.runPromise(Stream.runCollect(events).pipe(Effect.provide(mock.layer)))\n    const audioChunks = out.flatMap((e) => (e._tag === \"audio\" ? [e.chunk] : []))\n    expect(audioChunks.map((c) => Array.from(c.bytes))).toEqual([[10], [20]])\n  })\n\n  it(\"records the request on the streamGenerationFrom call channel\", async () => {\n    const mock = MockMusicGenerator.layer({\n      streamGenerationFromEvents: [[audioEvent(chunk(42))]],\n    })\n    const program = Effect.gen(function* () {\n      const inputs = Stream.fromIterable([promptsInput([{ text: \"x\" }])])\n      yield* Stream.runDrain(inputs.pipe(MusicGenerator.streamGenerationFrom(sgfReq)))\n      return yield* mock.recorder\n    })\n    const rec = await Effect.runPromise(program.pipe(Effect.provide(mock.layer)))\n    expect(rec.streamGenerationFromCalls.length).toBe(1)\n    expect(rec.streamGenerationFromCalls[0]!.model).toBe(\"lyria-realtime-exp\")\n    expect(rec.generateCalls.length).toBe(0)\n    expect(rec.streamGenerationCalls.length).toBe(0)\n  })\n})\n"],"mappings":"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"}

package/dist/speech-synthesizer/SpeechSynthesizer.d.mts

@@ -1,36 +1,25 @@
 import { t as AiError } from "../AiError-CAX_48RU.mjs";
-import { n as AudioChunk, r as AudioFormat, t as AudioBlob } from "../Audio-BfCTGnH3.mjs";
+import { n as AudioChunk, r as AudioFormat, t as AudioBlob } from "../Audio-DPlTsNdz.mjs";
 import { Context, Effect, Stream } from "effect";
 
 //#region src/speech-synthesizer/SpeechSynthesizer.d.ts
 declare namespace SpeechSynthesizer_d_exports {
-  export { CommonStreamSynthesizeRequest, CommonSynthesizeDialogueRequest, CommonSynthesizeRequest, CustomPronunciation, DialogueTurn, MultiSpeakerTts, PhoneticEncoding, SpeechSynthesizer, SpeechSynthesizerService, TtsIncrementalText, streamSynthesis, streamSynthesisFrom, streamSynthesizeDialogue, synthesize, synthesizeDialogue };
+  export { CommonStreamSynthesizeRequest, CommonSynthesizeDialogueRequest, CommonSynthesizeRequest, CustomPronunciation, DialogueTurn, MultiSpeakerTts, SpeechSynthesizer, SpeechSynthesizerService, TtsIncrementalText, streamSynthesis, streamSynthesisFrom, streamSynthesizeDialogue, synthesize, synthesizeDialogue };
 }
 /**
- * Phonetic alphabets accepted by `CustomPronunciation`. Not every
- * provider supports every alphabet — adapters translate or warn+drop
- * unsupported entries.
+ * Per-phrase pronunciation override. `pronunciation` is always IPA, the
+ * universal phonetic interchange format. Adapters translate to the
+ * provider's wire form (inline `/ipa/` token, SSML `<phoneme>`, or a
+ * structured field), converting IPA to X-SAMPA internally where the wire
+ * requires it (Google, Azure).
  *
- * - `ipa` — universal lowest common denominator (Google, ElevenLabs,
- *   Inworld, Deepgram, Cartesia, MiniMax).
- * - `x-sampa` — Google Cloud TTS.
- * - `cmu-arpabet` — ElevenLabs `eleven_flash_v2` / `eleven_english_v1`.
- */
-type PhoneticEncoding = "ipa" | "x-sampa" | "cmu-arpabet";
-/**
- * Per-phrase pronunciation override. The same shape unifies the
- * structured-field providers (Google) and the inline-markup providers
- * (ElevenLabs SSML, Inworld `/ipa/`, Deepgram, Cartesia, MiniMax) — the
- * adapter does the wire translation.
- *
- * Unsupported alphabets are dropped at the adapter with a structured
- * `logWarning` (one per call). The audio still renders, just without
- * the override.
+ * Pronunciations are load-bearing (the configured word is mispronounced
+ * if dropped), so a provider with no stateless IPA path fails the call
+ * with `AiError.Unsupported` rather than silently degrading.
  */
 type CustomPronunciation = {
-  readonly phrase: string;
+  readonly phrase: string; /** IPA notation, e.g. `"ænˈθrɒpɪk"`. */
   readonly pronunciation: string;
-  readonly encoding: PhoneticEncoding;
 };
 /**
  * Cross-provider synthesis request. Provider-specific extensions
@@ -53,11 +42,10 @@ type CommonSynthesizeRequest = {
   readonly speed?: number;
   readonly languageCode?: string;
   /**
-   * Phoneme overrides for specific phrases. 7 of 9 TTS providers
-   * support some form of this; adapters either translate to a
-   * structured field, rewrite `text` inline, or `warn+drop` per-entry
-   * for alphabets they don't accept. OpenAI rejects non-empty arrays
-   * with `Unsupported`.
+   * IPA phoneme overrides for specific phrases. Adapters render them to
+   * the provider's wire form (inline token, SSML `<phoneme>`, structured
+   * field). Load-bearing: a provider with no stateless IPA path fails
+   * the call with `AiError.Unsupported` rather than mispronouncing.
    */
   readonly pronunciations?: ReadonlyArray<CustomPronunciation>;
 };
@@ -72,18 +60,15 @@ type CommonSynthesizeRequest = {
  */
 type CommonStreamSynthesizeRequest = Omit<CommonSynthesizeRequest, "text">;
 /**
- * One turn in a multi-speaker dialogue.
- *
- * `styleDescription` and `speed` are honored by providers that expose
- * per-turn knobs (Hume Octave-2) and silently ignored by others
- * (ElevenLabs `/v1/text-to-dialogue` accepts `{voice_id, text}` only;
- * Google Gemini TTS multi-speaker has no per-turn styling).
+ * One turn in a multi-speaker dialogue. Just a voice and its line; the
+ * only in-tree dialogue endpoint (ElevenLabs `/v1/text-to-dialogue`)
+ * accepts `{ voice_id, text }` per turn. Per-turn styling knobs
+ * (Hume Octave-2 `styleDescription` / `speed`) are provider-specific
+ * and belong on a provider-typed turn extension, not here.
  */
 type DialogueTurn = {
   readonly voiceId: string;
   readonly text: string;
-  readonly styleDescription?: string;
-  readonly speed?: number;
 };
 /**
  * Cross-provider dialogue request. Same return type as `synthesize` —
@@ -188,5 +173,5 @@ declare const synthesizeDialogue: (request: CommonSynthesizeDialogueRequest) =>
  */
 declare const streamSynthesizeDialogue: (request: CommonSynthesizeDialogueRequest) => Stream.Stream<AudioChunk, AiError, SpeechSynthesizer | MultiSpeakerTts>;
 //#endregion
-export { CommonStreamSynthesizeRequest, CommonSynthesizeDialogueRequest, CommonSynthesizeRequest, CustomPronunciation, DialogueTurn, MultiSpeakerTts, PhoneticEncoding, SpeechSynthesizer, SpeechSynthesizerService, TtsIncrementalText, streamSynthesis, streamSynthesisFrom, streamSynthesizeDialogue, synthesize, synthesizeDialogue, SpeechSynthesizer_d_exports as t };
+export { CommonStreamSynthesizeRequest, CommonSynthesizeDialogueRequest, CommonSynthesizeRequest, CustomPronunciation, DialogueTurn, MultiSpeakerTts, SpeechSynthesizer, SpeechSynthesizerService, TtsIncrementalText, streamSynthesis, streamSynthesisFrom, streamSynthesizeDialogue, synthesize, synthesizeDialogue, SpeechSynthesizer_d_exports as t };
 //# sourceMappingURL=SpeechSynthesizer.d.mts.map

package/dist/speech-synthesizer/SpeechSynthesizer.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"SpeechSynthesizer.d.mts","names":[],"sources":["../../src/speech-synthesizer/SpeechSynthesizer.ts"],"mappings":";;;;;;;;;;;;;;;;;;KAcY,gBAAA;;;;;;;;;;AAAZ;KAYY,mBAAA;EAAA,SACD,MAAA;EAAA,SACA,aAAA;EAAA,SACA,QAAA,EAAU,gBAAA;AAAA;;;;;;;;KAUT,uBAAA;EAAA,SACD,IAAA,UADC;EAAA,SAGD,KAAA;;;;;;;WAOA,OAAA;EAAA,SACA,YAAA,GAAe,WAAA;EAAA,SACf,KAAA;EAAA,SACA,YAAA;EAFe;;;;;;;EAAA,SAUf,cAAA,GAAiB,aAAA,CAAc,mBAAA;AAAA;;;;;AAsB1C;;;;;KAVY,6BAAA,GAAgC,IAAA,CAAK,uBAAA;;;;;AAsBjD;;;;KAZY,YAAA;EAAA,SACD,OAAA;EAAA,SACA,IAAA;EAAA,SACA,gBAAA;EAAA,SACA,KAAA;AAAA;;;;;;KAQC,+BAAA;EAAA,SACD,KAAA;EAAA,SACA,KAAA,EAAO,aAAA,CAAc,YAAA;EAAA,SACrB,YAAA,GAAe,WAAA;EAAA,SACf,YAAA;EAAA,SACA,cAAA,GAAiB,aAAA,CAAc,mBAAA;AAAA;AAAA,KAG9B,wBAAA;EAAwB,oFAEzB,UAAA,GACP,OAAA,EAAS,uBAAA,KACN,MAAA,CAAO,MAAA,CAAO,SAAA,EAAW,OAAA;EADnB;;;;EAAA,SAMF,eAAA,GACP,OAAA,EAAS,uBAAA,KACN,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA;EAAZ;;;;;;;;;;EAAA,SAWV,mBAAA,SACP,MAAA,EAAQ,MAAA,CAAO,MAAA,SAAe,CAAA,EAAG,CAAA,GACjC,OAAA,EAAS,6BAAA,KACN,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA,GAAkB,CAAA,EAAG,CAAA;EAA/C;;;;;;EAAA,SAOI,kBAAA,GACP,OAAA,EAAS,+BAAA,KACN,MAAA,CAAO,MAAA,CAAO,SAAA,EAAW,OAAA;EAWC;;;;;;;;EAAA,SAFtB,wBAAA,GACP,OAAA,EAAS,+BAAA,KACN,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA;AAAA;AAAA,cAChC,sBAAA;cAEY,iBAAA,SAA0B,sBAAA;AAAA,cAGS,uBAAA;;;;;;;;;;;cAYnC,kBAAA,SAA2B,uBAAA;AAAA,cAEpC,oBAAA;;;;;;;;;;cAWS,eAAA,SAAwB,oBAAA;;cAKxB,UAAA,GACX,OAAA,EAAS,uBAAA,KACR,MAAA,CAAO,MAAA,CAAO,SAAA,EAAW,OAAA,EAAiB,iBAAA;;cAIhC,eAAA,GACX,OAAA,EAAS,uBAAA,KACR,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA,EAAiB,iBAAA;;;;;;;;;;;;;;cAgBjC,mBAAA;EAAA,CAET,OAAA,EAAS,6BAAA,UAET,MAAA,EAAQ,MAAA,CAAO,MAAA,SAAe,CAAA,EAAG,CAAA,MAC9B,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA,GAAkB,CAAA,EAAG,CAAA,GAAI,iBAAA,GAAoB,kBAAA;EAAA,OAE1E,MAAA,EAAQ,MAAA,CAAO,MAAA,SAAe,CAAA,EAAG,CAAA,GACjC,OAAA,EAAS,6BAAA,GACR,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA,GAAkB,CAAA,EAAG,CAAA,GAAI,iBAAA,GAAoB,kBAAA;AAAA;;;;;cAiB/D,kBAAA,GACX,OAAA,EAAS,+BAAA,KACR,MAAA,CAAO,MAAA,CAAO,SAAA,EAAW,OAAA,EAAiB,iBAAA,GAAoB,eAAA;;;;cAUpD,wBAAA,GACX,OAAA,EAAS,+BAAA,KACR,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA,EAAiB,iBAAA,GAAoB,eAAA"}
+{"version":3,"file":"SpeechSynthesizer.d.mts","names":[],"sources":["../../src/speech-synthesizer/SpeechSynthesizer.ts"],"mappings":";;;;;;;;;;;;;;;;;;;KAeY,mBAAA;EAAA,SACD,MAAA;WAEA,aAAA;AAAA;;;;AAHX;;;;KAaY,uBAAA;EAAA,SACD,IAAA,UADwB;EAAA,SAGxB,KAAA;EAQe;;;;;;EAAA,SADf,OAAA;EAAA,SACA,YAAA,GAAe,WAAA;EAAA,SACf,KAAA;EAAA,SACA,YAAA;EADA;;;;;;EAAA,SAQA,cAAA,GAAiB,aAAA,CAAc,mBAAA;AAAA;;;;;AAqB1C;;;;;KATY,6BAAA,GAAgC,IAAA,CAAK,uBAAA;;;;;;;;KASrC,YAAA;EAAA,SACD,OAAA;EAAA,SACA,IAAA;AAAA;;;;;;KAQC,+BAAA;EAAA,SACD,KAAA;EAAA,SACA,KAAA,EAAO,aAAA,CAAc,YAAA;EAAA,SACrB,YAAA,GAAe,WAAA;EAAA,SACf,YAAA;EAAA,SACA,cAAA,GAAiB,aAAA,CAAc,mBAAA;AAAA;AAAA,KAG9B,wBAAA;EAGC,oFADF,UAAA,GACP,OAAA,EAAS,uBAAA,KACN,MAAA,CAAO,MAAA,CAAO,SAAA,EAAW,OAAA;EAAA;;;;EAAA,SAKrB,eAAA,GACP,OAAA,EAAS,uBAAA,KACN,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA;EAA1B;;;;;;;;;;EAAA,SAWI,mBAAA,SACP,MAAA,EAAQ,MAAA,CAAO,MAAA,SAAe,CAAA,EAAG,CAAA,GACjC,OAAA,EAAS,6BAAA,KACN,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA,GAAkB,CAAA,EAAG,CAAA;EASjC;;;;;;EAAA,SAFV,kBAAA,GACP,OAAA,EAAS,+BAAA,KACN,MAAA,CAAO,MAAA,CAAO,SAAA,EAAW,OAAA;EAWZ;;;;;;;;EAAA,SAFT,wBAAA,GACP,OAAA,EAAS,+BAAA,KACN,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA;AAAA;AAAA,cAChC,sBAAA;cAEY,iBAAA,SAA0B,sBAAA;AAAA,cAGS,uBAAA;;;;;;;;;;;cAYnC,kBAAA,SAA2B,uBAAA;AAAA,cAEpC,oBAAA;;;;;;;;;;cAWS,eAAA,SAAwB,oBAAA;;cAKxB,UAAA,GACX,OAAA,EAAS,uBAAA,KACR,MAAA,CAAO,MAAA,CAAO,SAAA,EAAW,OAAA,EAAiB,iBAAA;;cAIhC,eAAA,GACX,OAAA,EAAS,uBAAA,KACR,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA,EAAiB,iBAAA;;;;;;;;;;;;AA3C7C;;cA2DY,mBAAA;EAAA,CAET,OAAA,EAAS,6BAAA,UAET,MAAA,EAAQ,MAAA,CAAO,MAAA,SAAe,CAAA,EAAG,CAAA,MAC9B,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA,GAAkB,CAAA,EAAG,CAAA,GAAI,iBAAA,GAAoB,kBAAA;EAAA,OAE1E,MAAA,EAAQ,MAAA,CAAO,MAAA,SAAe,CAAA,EAAG,CAAA,GACjC,OAAA,EAAS,6BAAA,GACR,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA,GAAkB,CAAA,EAAG,CAAA,GAAI,iBAAA,GAAoB,kBAAA;AAAA;;;;;cAiB/D,kBAAA,GACX,OAAA,EAAS,+BAAA,KACR,MAAA,CAAO,MAAA,CAAO,SAAA,EAAW,OAAA,EAAiB,iBAAA,GAAoB,eAAA;;;;cAUpD,wBAAA,GACX,OAAA,EAAS,+BAAA,KACR,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA,EAAiB,iBAAA,GAAoB,eAAA"}