@effect-uai/core 0.3.0 → 0.4.0

package/dist/domain/Transcript.d.mts

@@ -0,0 +1,95 @@
+declare namespace Transcript_d_exports {
+  export { TranscriptEvent, TranscriptResult, WordTimestamp, isAudioEvent, isError, isFinal, isMetadata, isPartial, isSpeechStarted, isUtteranceEnded };
+}
+/**
+ * Per-word timing + metadata. `confidence` and `speakerId` are optional
+ * because providers vary widely in what they emit and when (some only on
+ * final, some only with diarization enabled, some not at all).
+ */
+type WordTimestamp = {
+  readonly text: string;
+  readonly startSeconds: number;
+  readonly endSeconds: number;
+  readonly confidence?: number;
+  readonly speakerId?: string;
+  readonly languageCode?: string;
+};
+/**
+ * Sync STT result. `raw` preserves the provider-specific response for
+ * consumers that need fields the common shape doesn't expose
+ * (alternatives, segments, NBest, audio events, etc.).
+ */
+type TranscriptResult = {
+  readonly text: string;
+  readonly languageCode?: string;
+  readonly durationSeconds?: number;
+  readonly words?: ReadonlyArray<WordTimestamp>;
+  readonly raw?: unknown;
+};
+/**
+ * Streaming STT event union. Collapses every provider's vocabulary into
+ * a small set; provider-specific shapes survive on `metadata.raw`.
+ *
+ * - `partial`: interim hypothesis. `stability` is Google-only.
+ * - `final`: committed transcript for the current utterance / segment.
+ * - `speech-started` / `utterance-ended`: VAD-derived boundaries. Not
+ *   all providers emit them (OpenAI Realtime, Google with
+ *   `voice_activity_events`, Deepgram with `vad_events`, AssemblyAI).
+ * - `audio-event`: non-speech label (`(laughter)`, `(music)`) — ElevenLabs only.
+ * - `metadata`: opaque server-side bookkeeping (request_id, model info).
+ * - `error`: non-fatal provider error mid-stream. Fatal errors surface
+ *   on the `Stream`'s error channel as `AiError.AiError`.
+ */
+type TranscriptEvent = {
+  readonly _tag: "partial";
+  readonly text: string;
+  readonly words?: ReadonlyArray<WordTimestamp>;
+  readonly stability?: number;
+} | {
+  readonly _tag: "final";
+  readonly text: string;
+  readonly words?: ReadonlyArray<WordTimestamp>;
+  readonly languageCode?: string;
+} | {
+  readonly _tag: "speech-started";
+  readonly atSeconds: number;
+} | {
+  readonly _tag: "utterance-ended";
+  readonly atSeconds: number;
+} | {
+  readonly _tag: "audio-event";
+  readonly label: string;
+  readonly startSeconds: number;
+  readonly endSeconds: number;
+} | {
+  readonly _tag: "metadata";
+  readonly raw: unknown;
+} | {
+  readonly _tag: "error";
+  readonly code?: string;
+  readonly message: string;
+};
+declare const isPartial: (e: TranscriptEvent) => e is Extract<TranscriptEvent, {
+  _tag: "partial";
+}>;
+declare const isFinal: (e: TranscriptEvent) => e is Extract<TranscriptEvent, {
+  _tag: "final";
+}>;
+declare const isSpeechStarted: (e: TranscriptEvent) => e is Extract<TranscriptEvent, {
+  _tag: "speech-started";
+}>;
+declare const isUtteranceEnded: (e: TranscriptEvent) => e is Extract<TranscriptEvent, {
+  _tag: "utterance-ended";
+}>;
+declare const isAudioEvent: (e: TranscriptEvent) => e is Extract<TranscriptEvent, {
+  _tag: "audio-event";
+}>;
+declare const isMetadata: (e: TranscriptEvent) => e is Extract<TranscriptEvent, {
+  _tag: "metadata";
+}>;
+declare const isError: (e: TranscriptEvent) => e is Extract<TranscriptEvent, {
+  _tag: "error";
+}>;
+//#endregion
+export { TranscriptEvent, TranscriptResult, WordTimestamp, isAudioEvent, isError, isFinal, isMetadata, isPartial, isSpeechStarted, isUtteranceEnded, Transcript_d_exports as t };
+//# sourceMappingURL=Transcript.d.mts.map

package/dist/domain/Transcript.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Transcript.d.mts","names":[],"sources":["../../src/domain/Transcript.ts"],"mappings":";;;;;;;;KAKY,aAAA;EAAA,SACD,IAAA;EAAA,SACA,YAAA;EAAA,SACA,UAAA;EAAA,SACA,UAAA;EAAA,SACA,SAAA;EAAA,SACA,YAAA;AAAA;;;AANX;;;KAcY,gBAAA;EAAA,SACD,IAAA;EAAA,SACA,YAAA;EAAA,SACA,eAAA;EAAA,SACA,KAAA,GAAQ,aAAA,CAAc,aAAA;EAAA,SACtB,GAAA;AAAA;;;AALX;;;;;;;;;;;;KAsBY,eAAA;EAAA,SAEG,IAAA;EAAA,SACA,IAAA;EAAA,SACA,KAAA,GAAQ,aAAA,CAAc,aAAA;EAAA,SACtB,SAAA;AAAA;EAAA,SAGA,IAAA;EAAA,SACA,IAAA;EAAA,SACA,KAAA,GAAQ,aAAA,CAAc,aAAA;EAAA,SACtB,YAAA;AAAA;EAAA,SAEA,IAAA;EAAA,SAAiC,SAAA;AAAA;EAAA,SACjC,IAAA;EAAA,SAAkC,SAAA;AAAA;EAAA,SAElC,IAAA;EAAA,SACA,KAAA;EAAA,SACA,YAAA;EAAA,SACA,UAAA;AAAA;EAAA,SAEA,IAAA;EAAA,SAA2B,GAAA;AAAA;EAAA,SAC3B,IAAA;EAAA,SAAwB,IAAA;EAAA,SAAwB,OAAA;AAAA;AAAA,cAElD,SAAA,GAAa,CAAA,EAAG,eAAA,KAAkB,CAAA,IAAK,OAAA,CAAQ,eAAA;EAAmB,IAAA;AAAA;AAAA,cAElE,OAAA,GAAW,CAAA,EAAG,eAAA,KAAkB,CAAA,IAAK,OAAA,CAAQ,eAAA;EAAmB,IAAA;AAAA;AAAA,cAEhE,eAAA,GACX,CAAA,EAAG,eAAA,KACF,CAAA,IAAK,OAAA,CAAQ,eAAA;EAAmB,IAAA;AAAA;AAAA,cACtB,gBAAA,GACX,CAAA,EAAG,eAAA,KACF,CAAA,IAAK,OAAA,CAAQ,eAAA;EAAmB,IAAA;AAAA;AAAA,cACtB,YAAA,GACX,CAAA,EAAG,eAAA,KACF,CAAA,IAAK,OAAA,CAAQ,eAAA;EAAmB,IAAA;AAAA;AAAA,cACtB,UAAA,GACX,CAAA,EAAG,eAAA,KACF,CAAA,IAAK,OAAA,CAAQ,eAAA;EAAmB,IAAA;AAAA;AAAA,cACtB,OAAA,GAAW,CAAA,EAAG,eAAA,KAAkB,CAAA,IAAK,OAAA,CAAQ,eAAA;EAAmB,IAAA;AAAA"}

package/dist/domain/Transcript.mjs

@@ -0,0 +1,22 @@
+import { n as __exportAll } from "../chunk-uyGKjUfl.mjs";
+//#region src/domain/Transcript.ts
+var Transcript_exports = /* @__PURE__ */ __exportAll({
+	isAudioEvent: () => isAudioEvent,
+	isError: () => isError,
+	isFinal: () => isFinal,
+	isMetadata: () => isMetadata,
+	isPartial: () => isPartial,
+	isSpeechStarted: () => isSpeechStarted,
+	isUtteranceEnded: () => isUtteranceEnded
+});
+const isPartial = (e) => e._tag === "partial";
+const isFinal = (e) => e._tag === "final";
+const isSpeechStarted = (e) => e._tag === "speech-started";
+const isUtteranceEnded = (e) => e._tag === "utterance-ended";
+const isAudioEvent = (e) => e._tag === "audio-event";
+const isMetadata = (e) => e._tag === "metadata";
+const isError = (e) => e._tag === "error";
+//#endregion
+export { isAudioEvent, isError, isFinal, isMetadata, isPartial, isSpeechStarted, isUtteranceEnded, Transcript_exports as t };
+
+//# sourceMappingURL=Transcript.mjs.map

package/dist/domain/Transcript.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Transcript.mjs","names":[],"sources":["../../src/domain/Transcript.ts"],"sourcesContent":["/**\n * Per-word timing + metadata. `confidence` and `speakerId` are optional\n * because providers vary widely in what they emit and when (some only on\n * final, some only with diarization enabled, some not at all).\n */\nexport type WordTimestamp = {\n  readonly text: string\n  readonly startSeconds: number\n  readonly endSeconds: number\n  readonly confidence?: number\n  readonly speakerId?: string\n  readonly languageCode?: string\n}\n\n/**\n * Sync STT result. `raw` preserves the provider-specific response for\n * consumers that need fields the common shape doesn't expose\n * (alternatives, segments, NBest, audio events, etc.).\n */\nexport type TranscriptResult = {\n  readonly text: string\n  readonly languageCode?: string\n  readonly durationSeconds?: number\n  readonly words?: ReadonlyArray<WordTimestamp>\n  readonly raw?: unknown\n}\n\n/**\n * Streaming STT event union. Collapses every provider's vocabulary into\n * a small set; provider-specific shapes survive on `metadata.raw`.\n *\n * - `partial`: interim hypothesis. `stability` is Google-only.\n * - `final`: committed transcript for the current utterance / segment.\n * - `speech-started` / `utterance-ended`: VAD-derived boundaries. Not\n *   all providers emit them (OpenAI Realtime, Google with\n *   `voice_activity_events`, Deepgram with `vad_events`, AssemblyAI).\n * - `audio-event`: non-speech label (`(laughter)`, `(music)`) — ElevenLabs only.\n * - `metadata`: opaque server-side bookkeeping (request_id, model info).\n * - `error`: non-fatal provider error mid-stream. Fatal errors surface\n *   on the `Stream`'s error channel as `AiError.AiError`.\n */\nexport type TranscriptEvent =\n  | {\n      readonly _tag: \"partial\"\n      readonly text: string\n      readonly words?: ReadonlyArray<WordTimestamp>\n      readonly stability?: number\n    }\n  | {\n      readonly _tag: \"final\"\n      readonly text: string\n      readonly words?: ReadonlyArray<WordTimestamp>\n      readonly languageCode?: string\n    }\n  | { readonly _tag: \"speech-started\"; readonly atSeconds: number }\n  | { readonly _tag: \"utterance-ended\"; readonly atSeconds: number }\n  | {\n      readonly _tag: \"audio-event\"\n      readonly label: string\n      readonly startSeconds: number\n      readonly endSeconds: number\n    }\n  | { readonly _tag: \"metadata\"; readonly raw: unknown }\n  | { readonly _tag: \"error\"; readonly code?: string; readonly message: string }\n\nexport const isPartial = (e: TranscriptEvent): e is Extract<TranscriptEvent, { _tag: \"partial\" }> =>\n  e._tag === \"partial\"\nexport const isFinal = (e: TranscriptEvent): e is Extract<TranscriptEvent, { _tag: \"final\" }> =>\n  e._tag === \"final\"\nexport const isSpeechStarted = (\n  e: TranscriptEvent,\n): e is Extract<TranscriptEvent, { _tag: \"speech-started\" }> => e._tag === \"speech-started\"\nexport const isUtteranceEnded = (\n  e: TranscriptEvent,\n): e is Extract<TranscriptEvent, { _tag: \"utterance-ended\" }> => e._tag === \"utterance-ended\"\nexport const isAudioEvent = (\n  e: TranscriptEvent,\n): e is Extract<TranscriptEvent, { _tag: \"audio-event\" }> => e._tag === \"audio-event\"\nexport const isMetadata = (\n  e: TranscriptEvent,\n): e is Extract<TranscriptEvent, { _tag: \"metadata\" }> => e._tag === \"metadata\"\nexport const isError = (e: TranscriptEvent): e is Extract<TranscriptEvent, { _tag: \"error\" }> =>\n  e._tag === \"error\"\n"],"mappings":";;;;;;;;;;;AAiEA,MAAa,aAAa,MACxB,EAAE,SAAS;AACb,MAAa,WAAW,MACtB,EAAE,SAAS;AACb,MAAa,mBACX,MAC8D,EAAE,SAAS;AAC3E,MAAa,oBACX,MAC+D,EAAE,SAAS;AAC5E,MAAa,gBACX,MAC2D,EAAE,SAAS;AACxE,MAAa,cACX,MACwD,EAAE,SAAS;AACrE,MAAa,WAAW,MACtB,EAAE,SAAS"}

package/dist/domain/Turn.d.mts

@@ -1,2 +1,2 @@
-import { c as functionCalls, d as textDeltas, f as toStructured, i as TurnEvent, l as isTurnComplete, n as RefusalRejected, o as appendTurn, r as Turn, s as assistantMessages, t as InteractionEvent, u as reasonings } from "../Turn-OPaILVIB.mjs";
+import { c as functionCalls, d as textDeltas, f as toStructured, i as TurnEvent, l as isTurnComplete, n as RefusalRejected, o as appendTurn, r as Turn, s as assistantMessages, t as InteractionEvent, u as reasonings } from "../Turn-7geUcKsf.mjs";
 export { InteractionEvent, RefusalRejected, Turn, TurnEvent, appendTurn, assistantMessages, functionCalls, isTurnComplete, reasonings, textDeltas, toStructured };

package/dist/embedding-model/Embedding.d.mts

@@ -1,4 +1,4 @@
-import { i as ImageSource } from "../Image-BZmKfIdq.mjs";
+import { i as ImageSource } from "../Image-DxyXqzAM.mjs";
 
 //#region src/embedding-model/Embedding.d.ts
 declare namespace Embedding_d_exports {

package/dist/embedding-model/EmbeddingModel.d.mts

@@ -1,4 +1,4 @@
-import { t as AiError } from "../AiError-CBuPHVKA.mjs";
+import { t as AiError } from "../AiError-csR8Bhxx.mjs";
 import { EmbedInput, Embedding, Usage } from "./Embedding.mjs";
 import { Context, Effect } from "effect";
 

package/dist/index.d.mts

@@ -1,13 +1,19 @@
-import { n as AiError_d_exports } from "./AiError-CBuPHVKA.mjs";
+import { n as AiError_d_exports } from "./AiError-csR8Bhxx.mjs";
 import { a as Media_d_exports } from "./Media-D_CpcM1Z.mjs";
-import { o as Image_d_exports } from "./Image-BZmKfIdq.mjs";
-import { f as Items_d_exports } from "./Items-CB8Bo3FI.mjs";
-import { a as StructuredFormat_d_exports } from "./StructuredFormat-BWq5Hd1O.mjs";
-import { a as Turn_d_exports } from "./Turn-OPaILVIB.mjs";
+import { o as Audio_d_exports } from "./Audio-BfCTGnH3.mjs";
+import { o as Image_d_exports } from "./Image-DxyXqzAM.mjs";
+import { f as Items_d_exports } from "./Items-Hg5AsYxl.mjs";
+import { t as Music_d_exports } from "./domain/Music.mjs";
+import { t as Transcript_d_exports } from "./domain/Transcript.mjs";
+import { a as StructuredFormat_d_exports } from "./StructuredFormat-Cl41C56K.mjs";
+import { a as Turn_d_exports } from "./Turn-7geUcKsf.mjs";
 import { t as Embedding_d_exports } from "./embedding-model/Embedding.mjs";
 import { t as EmbeddingModel_d_exports } from "./embedding-model/EmbeddingModel.mjs";
-import { l as Tool_d_exports } from "./Tool-DjVufH7i.mjs";
+import { l as Tool_d_exports } from "./Tool-B8B5qVEy.mjs";
 import { t as LanguageModel_d_exports } from "./language-model/LanguageModel.mjs";
+import { t as MusicGenerator_d_exports } from "./music-generator/MusicGenerator.mjs";
+import { t as SpeechSynthesizer_d_exports } from "./speech-synthesizer/SpeechSynthesizer.mjs";
+import { t as Transcriber_d_exports } from "./transcriber/Transcriber.mjs";
 import { t as Vector_d_exports } from "./math/Vector.mjs";
 import { t as Loop_d_exports } from "./loop/Loop.mjs";
 import { t as Outcome_d_exports } from "./tool/Outcome.mjs";
@@ -19,4 +25,4 @@ import { t as JSONL_d_exports } from "./streaming/JSONL.mjs";
 import { t as Lines_d_exports } from "./streaming/Lines.mjs";
 import { t as SSE_d_exports } from "./streaming/SSE.mjs";
 import { t as Metrics_d_exports } from "./observability/Metrics.mjs";
-export { AiError_d_exports as AiError, Embedding_d_exports as Embedding, EmbeddingModel_d_exports as EmbeddingModel, HistoryCheck_d_exports as HistoryCheck, Image_d_exports as Image, Items_d_exports as Items, JSONL_d_exports as JSONL, LanguageModel_d_exports as LanguageModel, Lines_d_exports as Lines, Loop_d_exports as Loop, Media_d_exports as Media, Metrics_d_exports as Metrics, Outcome_d_exports as Outcome, Resolvers_d_exports as Resolvers, SSE_d_exports as SSE, StructuredFormat_d_exports as StructuredFormat, Tool_d_exports as Tool, ToolEvent_d_exports as ToolEvent, Toolkit_d_exports as Toolkit, Turn_d_exports as Turn, Vector_d_exports as Vector };
+export { AiError_d_exports as AiError, Audio_d_exports as Audio, Embedding_d_exports as Embedding, EmbeddingModel_d_exports as EmbeddingModel, HistoryCheck_d_exports as HistoryCheck, Image_d_exports as Image, Items_d_exports as Items, JSONL_d_exports as JSONL, LanguageModel_d_exports as LanguageModel, Lines_d_exports as Lines, Loop_d_exports as Loop, Media_d_exports as Media, Metrics_d_exports as Metrics, Music_d_exports as Music, MusicGenerator_d_exports as MusicGenerator, Outcome_d_exports as Outcome, Resolvers_d_exports as Resolvers, SSE_d_exports as SSE, SpeechSynthesizer_d_exports as SpeechSynthesizer, StructuredFormat_d_exports as StructuredFormat, Tool_d_exports as Tool, ToolEvent_d_exports as ToolEvent, Toolkit_d_exports as Toolkit, Transcriber_d_exports as Transcriber, Transcript_d_exports as Transcript, Turn_d_exports as Turn, Vector_d_exports as Vector };

package/dist/index.mjs

@@ -1,12 +1,18 @@
 import { t as AiError_exports } from "./domain/AiError.mjs";
+import { t as Audio_exports } from "./domain/Audio.mjs";
 import { t as Image_exports } from "./domain/Image.mjs";
 import { t as Items_exports } from "./domain/Items.mjs";
 import { t as Media_exports } from "./domain/Media.mjs";
+import { t as Music_exports } from "./domain/Music.mjs";
+import { t as Transcript_exports } from "./domain/Transcript.mjs";
 import { t as StructuredFormat_exports } from "./structured-format/StructuredFormat.mjs";
 import { t as Turn_exports } from "./domain/Turn.mjs";
 import { t as Embedding_exports } from "./embedding-model/Embedding.mjs";
 import { t as EmbeddingModel_exports } from "./embedding-model/EmbeddingModel.mjs";
 import { t as LanguageModel_exports } from "./language-model/LanguageModel.mjs";
+import { t as MusicGenerator_exports } from "./music-generator/MusicGenerator.mjs";
+import { t as SpeechSynthesizer_exports } from "./speech-synthesizer/SpeechSynthesizer.mjs";
+import { t as Transcriber_exports } from "./transcriber/Transcriber.mjs";
 import { t as Vector_exports } from "./math/Vector.mjs";
 import { t as Loop_exports } from "./loop/Loop.mjs";
 import { t as Tool_exports } from "./tool/Tool.mjs";
@@ -19,4 +25,4 @@ import { t as JSONL_exports } from "./streaming/JSONL.mjs";
 import { t as Lines_exports } from "./streaming/Lines.mjs";
 import { t as SSE_exports } from "./streaming/SSE.mjs";
 import { t as Metrics_exports } from "./observability/Metrics.mjs";
-export { AiError_exports as AiError, Embedding_exports as Embedding, EmbeddingModel_exports as EmbeddingModel, HistoryCheck_exports as HistoryCheck, Image_exports as Image, Items_exports as Items, JSONL_exports as JSONL, LanguageModel_exports as LanguageModel, Lines_exports as Lines, Loop_exports as Loop, Media_exports as Media, Metrics_exports as Metrics, Outcome_exports as Outcome, Resolvers_exports as Resolvers, SSE_exports as SSE, StructuredFormat_exports as StructuredFormat, Tool_exports as Tool, ToolEvent_exports as ToolEvent, Toolkit_exports as Toolkit, Turn_exports as Turn, Vector_exports as Vector };
+export { AiError_exports as AiError, Audio_exports as Audio, Embedding_exports as Embedding, EmbeddingModel_exports as EmbeddingModel, HistoryCheck_exports as HistoryCheck, Image_exports as Image, Items_exports as Items, JSONL_exports as JSONL, LanguageModel_exports as LanguageModel, Lines_exports as Lines, Loop_exports as Loop, Media_exports as Media, Metrics_exports as Metrics, Music_exports as Music, MusicGenerator_exports as MusicGenerator, Outcome_exports as Outcome, Resolvers_exports as Resolvers, SSE_exports as SSE, SpeechSynthesizer_exports as SpeechSynthesizer, StructuredFormat_exports as StructuredFormat, Tool_exports as Tool, ToolEvent_exports as ToolEvent, Toolkit_exports as Toolkit, Transcriber_exports as Transcriber, Transcript_exports as Transcript, Turn_exports as Turn, Vector_exports as Vector };

package/dist/language-model/LanguageModel.d.mts

@@ -1,8 +1,8 @@
-import { t as AiError } from "../AiError-CBuPHVKA.mjs";
-import { d as Item } from "../Items-CB8Bo3FI.mjs";
-import { i as StructuredFormat } from "../StructuredFormat-BWq5Hd1O.mjs";
-import { i as TurnEvent } from "../Turn-OPaILVIB.mjs";
-import { o as ToolDescriptor } from "../Tool-DjVufH7i.mjs";
+import { t as AiError } from "../AiError-csR8Bhxx.mjs";
+import { d as Item } from "../Items-Hg5AsYxl.mjs";
+import { i as StructuredFormat } from "../StructuredFormat-Cl41C56K.mjs";
+import { i as TurnEvent } from "../Turn-7geUcKsf.mjs";
+import { o as ToolDescriptor } from "../Tool-B8B5qVEy.mjs";
 import { Context, Stream } from "effect";
 
 //#region src/language-model/LanguageModel.d.ts

package/dist/loop/Loop.d.mts

@@ -1,5 +1,5 @@
-import { l as IncompleteTurn } from "../AiError-CBuPHVKA.mjs";
-import { i as TurnEvent, r as Turn } from "../Turn-OPaILVIB.mjs";
+import { l as IncompleteTurn } from "../AiError-csR8Bhxx.mjs";
+import { i as TurnEvent, r as Turn } from "../Turn-7geUcKsf.mjs";
 import { Data, Effect, Stream, SubscriptionRef } from "effect";
 
 //#region src/loop/Loop.d.ts

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

@@ -0,0 +1,77 @@
+import { t as AiError } from "../AiError-csR8Bhxx.mjs";
+import { n as AudioChunk } from "../Audio-BfCTGnH3.mjs";
+import { CommonGenerateMusicRequest, CommonStreamGenerateMusicRequest, MusicResult, MusicSessionInput, 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 };
+}
+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`.
+   */
+  readonly generate: (request: CommonGenerateMusicRequest) => Effect.Effect<MusicResult, 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`.
+   */
+  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`.
+   *
+   * Gated by the `MusicInteractiveSession` capability marker on the
+   * 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>;
+};
+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
+ * `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
+ * `Layer.succeed(MusicInteractiveSession, undefined)`.
+ */
+declare class MusicInteractiveSession extends MusicInteractiveSession_base {}
+/** One-shot generation. */
+declare const generate: (request: CommonGenerateMusicRequest) => Effect.Effect<MusicResult, 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 —
+ * providers without bidirectional support are a type error at provide
+ * time.
+ *
+ * @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: "" }),
+ * )
+ * ```
+ */
+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>;
+};
+//#endregion
+export { type CommonGenerateMusicRequest, type CommonStreamGenerateMusicRequest, MusicGenerator, MusicGeneratorService, MusicInteractiveSession, type MusicResult, type MusicSessionInput, type WeightedPrompt, generate, streamGeneration, streamGenerationFrom, MusicGenerator_d_exports as t };
+//# sourceMappingURL=MusicGenerator.d.mts.map

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

@@ -0,0 +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"}

package/dist/music-generator/MusicGenerator.mjs

@@ -0,0 +1,51 @@
+import { n as __exportAll } from "../chunk-uyGKjUfl.mjs";
+import { Context, Effect, Function, Stream } from "effect";
+//#region src/music-generator/MusicGenerator.ts
+var MusicGenerator_exports = /* @__PURE__ */ __exportAll({
+	MusicGenerator: () => MusicGenerator,
+	MusicInteractiveSession: () => MusicInteractiveSession,
+	generate: () => generate,
+	streamGeneration: () => streamGeneration,
+	streamGenerationFrom: () => streamGenerationFrom
+});
+var MusicGenerator = class extends Context.Service()("@betalyra/effect-uai/MusicGenerator") {};
+/**
+* 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
+* `Layer.succeed(MusicInteractiveSession, undefined)`.
+*/
+var MusicInteractiveSession = class extends Context.Service()("@betalyra/effect-uai/capability/MusicInteractiveSession") {};
+/** One-shot generation. */
+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 —
+* providers without bidirectional support are a type error at provide
+* time.
+*
+* @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: "" }),
+* )
+* ```
+*/
+const streamGenerationFrom = Function.dual(2, (input, request) => Stream.unwrap(Effect.gen(function* () {
+	const s = yield* MusicGenerator.asEffect();
+	yield* MusicInteractiveSession.asEffect();
+	return s.streamGenerationFrom(input, request);
+})));
+//#endregion
+export { MusicGenerator, MusicInteractiveSession, generate, streamGeneration, streamGenerationFrom, MusicGenerator_exports as t };
+
+//# sourceMappingURL=MusicGenerator.mjs.map

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

@@ -0,0 +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"}

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

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

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

@@ -0,0 +1,154 @@
+import { configInput, promptsInput } 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";
+//#region src/music-generator/MusicGenerator.test.ts
+const result = {
+	format: {
+		container: "mp3",
+		encoding: "mp3",
+		sampleRate: 44100,
+		channels: 2
+	},
+	bytes: new Uint8Array([
+		255,
+		251,
+		144,
+		0
+	]),
+	durationSeconds: 30,
+	lyrics: "[Verse]\nhello\n",
+	watermark: { kind: "synthid" }
+};
+const chunk = (n) => ({ bytes: new Uint8Array([n]) });
+describe("MusicGenerator.generate", () => {
+	it("returns the scripted MusicResult", async () => {
+		const mock = layer({ results: [result] });
+		const program = generate({
+			model: "mock-music",
+			prompts: "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]");
+	});
+	it("records the request shape on the recorder", async () => {
+		const mock = layer({ results: [result, result] });
+		const program = Effect.gen(function* () {
+			yield* generate({
+				model: "m",
+				prompts: "techno"
+			});
+			yield* generate({
+				model: "m",
+				prompts: [{
+					text: "synthwave",
+					weight: 1
+				}, {
+					text: "80s movie OST",
+					weight: .4
+				}],
+				bpm: 120,
+				instrumental: true
+			});
+			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);
+	});
+});
+describe("MusicGenerator.streamGeneration", () => {
+	it("emits scripted chunks", async () => {
+		const mock = layer({ streamGenerationChunks: [[
+			chunk(1),
+			chunk(2),
+			chunk(3)
+		]] });
+		const program = Stream.runCollect(streamGeneration({
+			model: "m",
+			prompts: "ambient"
+		}));
+		globalExpect((await Effect.runPromise(program.pipe(Effect.provide(mock.layer)))).map((c) => Array.from(c.bytes))).toEqual([
+			[1],
+			[2],
+			[3]
+		]);
+	});
+});
+describe("MusicGenerator capability marker (compile-time)", () => {
+	const sgfReq = {
+		model: "m",
+		prompts: ""
+	};
+	it("requires `MusicInteractiveSession` on the R channel of streamGenerationFrom", () => {
+		(0, import_dist.expectTypeOf)(Stream.fromIterable([promptsInput([{ text: "techno" }])]).pipe(streamGenerationFrom(sgfReq))).toEqualTypeOf();
+	});
+	it("does NOT require `MusicInteractiveSession` for sync `generate`", () => {
+		(0, import_dist.expectTypeOf)(generate({
+			model: "m",
+			prompts: "ambient"
+		})).toEqualTypeOf();
+	});
+	it("does NOT require `MusicInteractiveSession` for `streamGeneration`", () => {
+		(0, import_dist.expectTypeOf)(streamGeneration({
+			model: "m",
+			prompts: "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();
+	});
+	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();
+	});
+});
+describe("MusicGenerator.streamGenerationFrom", () => {
+	const sgfReq = {
+		model: "lyria-realtime-001",
+		prompts: ""
+	};
+	it("drains a session-input stream and emits scripted audio", async () => {
+		const mock = layer({ streamGenerationFromChunks: [[chunk(10), chunk(20)]] });
+		const audio = Stream.fromIterable([
+			promptsInput([{
+				text: "minimal techno",
+				weight: 1
+			}]),
+			configInput({ bpm: 124 }),
+			promptsInput([{
+				text: "minimal techno",
+				weight: 1
+			}, {
+				text: "1980s synthwave",
+				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]]);
+	});
+	it("records the request on the streamGenerationFrom call channel", async () => {
+		const mock = layer({ streamGenerationFromChunks: [[chunk(42)]] });
+		const program = Effect.gen(function* () {
+			yield* Stream.runDrain(Stream.fromIterable([promptsInput([{ text: "x" }])]).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.generateCalls.length).toBe(0);
+		globalExpect(rec.streamGenerationCalls.length).toBe(0);
+	});
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=MusicGenerator.test.mjs.map

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

@@ -0,0 +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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"}