@effect-uai/core 0.6.0 → 0.7.0

package/README.md

@@ -10,7 +10,7 @@ This package exposes:
 
 - **Domain types** - `Items`, `Turn`, `AiError`
 - **Provider contract** - `LanguageModel`
-- **Loop primitive** - `Loop` (`loop`, `loopWithState`, `value`, `next`, `stop`, `nextAfter`, `emitValues`, `emitNext`, `onTurnComplete`)
+- **Loop primitive** - `Loop` (`loop`, `loopWithState`, `value`, `next`, `stop`, `nextAfter`, `onTurnComplete`)
 - **Tools** - `Tool`, `Toolkit`, `Outcome`, `ToolEvent`, `Resolvers`, `HistoryCheck`
 - **Streaming codecs** - `SSE`, `JSONL`, `Lines`
 - **Structured output** - `StructuredFormat`

package/dist/{Audio-BfCTGnH3.d.mts → Audio-DPlTsNdz.d.mts}

@@ -1,4 +1,5 @@
 import { i as MediaUrl, n as MediaBytes, t as MediaBase64 } from "./Media-D_CpcM1Z.mjs";
+import { Duration } from "effect";
 
 //#region src/domain/Audio.d.ts
 declare namespace Audio_d_exports {
@@ -54,8 +55,8 @@ type AudioChunk = {
 type AudioBlob = {
   readonly format: AudioFormat;
   readonly bytes: Uint8Array;
-  readonly durationSeconds?: number;
+  readonly duration?: Duration.Duration;
 };
 //#endregion
 export { AudioSource as a, isAudioBytes as c, AudioMimeType as i, isAudioUrl as l, AudioChunk as n, Audio_d_exports as o, AudioFormat as r, isAudioBase64 as s, AudioBlob as t };
-//# sourceMappingURL=Audio-BfCTGnH3.d.mts.map
+//# sourceMappingURL=Audio-DPlTsNdz.d.mts.map

package/dist/Audio-DPlTsNdz.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Audio-DPlTsNdz.d.mts","names":[],"sources":["../src/domain/Audio.ts"],"mappings":";;;;;;;;;;;;;;;KAWY,aAAA;;;;;AAAZ;;;;;KA0BY,WAAA,GACR,QAAA,CAAS,aAAA,IACT,WAAA,CAAY,aAAA,IACZ,UAAA,CAAW,aAAA;AAAA,cAEF,UAAA,GAAc,CAAA,EAAG,WAAA,KAAc,CAAA,IAAK,QAAA,CAAS,aAAA;AAAA,cAC7C,aAAA,GAAiB,CAAA,EAAG,WAAA,KAAc,CAAA,IAAK,WAAA,CAAY,aAAA;AAAA,cAEnD,YAAA,GAAgB,CAAA,EAAG,WAAA,KAAc,CAAA,IAAK,UAAA,CAAW,aAAA;;;;;;;KAQlD,WAAA;EAAA,SACD,SAAA;EAAA,SACA,QAAA;EAAA,SAUA,UAAA,wDA1BK;EAAA,SA4BL,OAAA;EAAA,SACA,QAAA;AAAA;;AA1BX;;;;KAkCY,UAAA;EAAA,SACD,KAAA,EAAO,UAAA;AAAA;;;;;KAON,SAAA;EAAA,SACD,MAAA,EAAQ,WAAA;EAAA,SACR,KAAA,EAAO,UAAA;EAAA,SACP,QAAA,GAAW,QAAA,CAAS,QAAA;AAAA"}

package/dist/{Items-pXR5BAgW.d.mts → Items-D8UaXQx_.d.mts}

@@ -74,8 +74,8 @@ declare const Annotation: Schema.Union<readonly [Schema.Struct<{
 }>]>;
 type Annotation = typeof Annotation.Type;
 declare const isUrlCitation: <I>(input: I) => input is I & {
-  readonly url: string;
   readonly type: "url_citation";
+  readonly url: string;
   readonly start_index: number;
   readonly end_index: number;
   readonly title: string;
@@ -309,8 +309,8 @@ declare const isOutputText: <I>(input: I) => input is I & {
   readonly type: "output_text";
   readonly text: string;
   readonly annotations?: readonly ({
-    readonly url: string;
     readonly type: "url_citation";
+    readonly url: string;
     readonly start_index: number;
     readonly end_index: number;
     readonly title: string;
@@ -346,8 +346,8 @@ declare const isMessage: <I>(input: I) => input is I & {
     readonly type: "output_text";
     readonly text: string;
     readonly annotations?: readonly ({
-      readonly url: string;
       readonly type: "url_citation";
+      readonly url: string;
       readonly start_index: number;
       readonly end_index: number;
       readonly title: string;
@@ -421,4 +421,4 @@ declare const assistantText: (text: string) => Message;
 declare const toolCallOutput: (call_id: string, output: string) => ToolCallOutput;
 //#endregion
 export { isReasoning as A, isContainerFileCitation as C, isInputText as D, isInputImage as E, systemText as F, toolCallOutput as I, userText as L, isToolCall as M, isToolCallOutput as N, isMessage as O, isUrlCitation as P, assistantText as S, isFilePath as T, StopReason as _, FilePath as a, UrlCitation as b, InputText as c, Message as d, OutputText as f, Role as g, Refusal as h, FileCitation as i, isRefusal as j, isOutputText as k, InputTokensDetails as l, Reasoning as m, ContainerFileCitation as n, HistoryItem as o, OutputTokensDetails as p, ContentBlock as r, InputImage as s, Annotation as t, Items_d_exports as u, ToolCall as v, isFileCitation as w, Usage as x, ToolCallOutput as y };
-//# sourceMappingURL=Items-pXR5BAgW.d.mts.map
+//# sourceMappingURL=Items-D8UaXQx_.d.mts.map

package/dist/{Items-pXR5BAgW.d.mts.map → Items-D8UaXQx_.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"Items-pXR5BAgW.d.mts","names":[],"sources":["../src/domain/Items.ts"],"mappings":"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"}
+{"version":3,"file":"Items-D8UaXQx_.d.mts","names":[],"sources":["../src/domain/Items.ts"],"mappings":"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"}

package/dist/{Tool-DP-AwKOf.d.mts → Tool-CiFXYjmR.d.mts}

@@ -1,4 +1,4 @@
-import { v as ToolCall, y as ToolCallOutput } from "./Items-pXR5BAgW.mjs";
+import { v as ToolCall, y as ToolCallOutput } from "./Items-D8UaXQx_.mjs";
 import { Effect, Schema, Stream } from "effect";
 import * as _$effect_Cause0 from "effect/Cause";
 import { StandardJSONSchemaV1, StandardSchemaV1 } from "@standard-schema/spec";
@@ -99,4 +99,4 @@ declare const toDescriptors: <R>(tools: ReadonlyArray<AnyTool<R>>) => ReadonlyAr
 declare const execute: <Name extends string, Input, Output, R>(tool: Tool<Name, Input, Output, R>, call: ToolCall) => Effect.Effect<ToolCallOutput, ToolError, R>;
 //#endregion
 export { Tool as a, ToolInputSchema as c, fromEffectSchema as d, fromStandardSchema as f, toDescriptors as g, streaming as h, StreamingTool as i, Tool_d_exports as l, make as m, AnyStreamingTool as n, ToolDescriptor as o, isStreamingTool as p, AnyTool as r, ToolError as s, AnyPlainTool as t, execute as u };
-//# sourceMappingURL=Tool-DP-AwKOf.d.mts.map
+//# sourceMappingURL=Tool-CiFXYjmR.d.mts.map

package/dist/{Tool-DP-AwKOf.d.mts.map → Tool-CiFXYjmR.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"Tool-DP-AwKOf.d.mts","names":[],"sources":["../src/tool/Tool.ts"],"mappings":";;;;;;;;;cAEkE,cAAA;;;;;;cAGrD,SAAA,SAAkB,cAAA;;;;;;;;;;KAmBnB,eAAA,oBAAmC,gBAAA,UAA0B,KAAA,IACvE,oBAAA,UAA8B,KAAA;;;;AAvBkC;;cA8BrD,gBAAA,aAA8B,MAAA,CAAO,KAAA,wBAChD,MAAA,EAAQ,CAAA,KACP,CAAA,GAAI,eAAA,CAAgB,CAAA;;;;;;;;;;;;;;;;cAmBV,kBAAA,aAAgC,gBAAA,GAAmB,oBAAA,EAC9D,MAAA,EAAQ,CAAA,KACP,CAAA,GAAI,eAAA,CAAgB,gBAAA,CAAiB,WAAA,CAAY,CAAA;AAAA,KAGxC,IAAA;EAAA,SACD,IAAA,EAAM,IAAA;EAAA,SACN,WAAA;EAAA,SACA,WAAA,EAAa,eAAA,CAAgB,KAAA;EAAA,SAC7B,GAAA,GAAM,KAAA,EAAO,KAAA,KAAU,MAAA,CAAO,MAAA,CAAO,MAAA,WAAiB,CAAA;;;;;;;WAOtD,MAAA;AAAA;;;;;AAhEX;KAwEY,cAAA;EAAA,SACD,IAAA;EAAA,SACA,WAAA;EAAA,SACA,WAAA,EAAa,MAAA;EAAA,SACb,MAAA;AAAA;AAAA,cAGE,IAAA,kDACX,IAAA,EAAM,IAAA,CAAK,IAAA,EAAM,KAAA,EAAO,MAAA,EAAQ,CAAA,MAC/B,IAAA,CAAK,IAAA,EAAM,KAAA,EAAO,MAAA,EAAQ,CAAA;AAAA,KAWjB,aAAA;EAAA,SACD,KAAA;EAAA,SACA,IAAA,EAAM,IAAA;EAAA,SACN,WAAA;EAAA,SACA,WAAA,EAAa,eAAA,CAAgB,KAAA;EAAA,SAC7B,GAAA,GAAM,KAAA,EAAO,KAAA,KAAU,MAAA,CAAO,MAAA,CAAO,KAAA,WAAgB,CAAA;EAAA,SACrD,QAAA,GAAW,MAAA,EAAQ,aAAA,CAAc,KAAA,MAAW,MAAA;EAAA,SAC5C,MAAA;AAAA;AAAA,cAGE,SAAA,yDACX,IAAA,EAAM,IAAA,CAAK,aAAA,CAAc,IAAA,EAAM,KAAA,EAAO,KAAA,EAAO,MAAA,EAAQ,CAAA,gBACpD,aAAA,CAAc,IAAA,EAAM,KAAA,EAAO,KAAA,EAAO,MAAA,EAAQ,CAAA;AAAA,KAEjC,gBAAA,YAA4B,aAAA,wBAAqC,CAAA;AAAA,KACjE,YAAA,YAAwB,IAAA,mBAAuB,CAAA;AAAA,KAC/C,OAAA,YAAmB,gBAAA,CAAiB,CAAA,IAAK,YAAA,CAAa,CAAA;AAAA,cAErD,eAAA,MAAsB,CAAA,EAAG,OAAA,CAAQ,CAAA,MAAK,CAAA,IAAK,gBAAA,CAAiB,CAAA;;;;;;cAQ5D,aAAA,MAAoB,KAAA,EAAO,aAAA,CAAc,OAAA,CAAQ,CAAA,OAAM,aAAA,CAAc,cAAA;;;;;;cAkBrE,OAAA,0CACX,IAAA,EAAM,IAAA,CAAK,IAAA,EAAM,KAAA,EAAO,MAAA,EAAQ,CAAA,GAChC,IAAA,EAAM,QAAA,KACL,MAAA,CAAO,MAAA,CAAO,cAAA,EAAgB,SAAA,EAAW,CAAA"}
+{"version":3,"file":"Tool-CiFXYjmR.d.mts","names":[],"sources":["../src/tool/Tool.ts"],"mappings":";;;;;;;;;cAEkE,cAAA;;;;;;cAGrD,SAAA,SAAkB,cAAA;;;;;;;;;;KAmBnB,eAAA,oBAAmC,gBAAA,UAA0B,KAAA,IACvE,oBAAA,UAA8B,KAAA;;;;AAvBkC;;cA8BrD,gBAAA,aAA8B,MAAA,CAAO,KAAA,wBAChD,MAAA,EAAQ,CAAA,KACP,CAAA,GAAI,eAAA,CAAgB,CAAA;;;;;;;;;;;;;;;;cAmBV,kBAAA,aAAgC,gBAAA,GAAmB,oBAAA,EAC9D,MAAA,EAAQ,CAAA,KACP,CAAA,GAAI,eAAA,CAAgB,gBAAA,CAAiB,WAAA,CAAY,CAAA;AAAA,KAGxC,IAAA;EAAA,SACD,IAAA,EAAM,IAAA;EAAA,SACN,WAAA;EAAA,SACA,WAAA,EAAa,eAAA,CAAgB,KAAA;EAAA,SAC7B,GAAA,GAAM,KAAA,EAAO,KAAA,KAAU,MAAA,CAAO,MAAA,CAAO,MAAA,WAAiB,CAAA;;;;;;;WAOtD,MAAA;AAAA;;;;;AAhEX;KAwEY,cAAA;EAAA,SACD,IAAA;EAAA,SACA,WAAA;EAAA,SACA,WAAA,EAAa,MAAA;EAAA,SACb,MAAA;AAAA;AAAA,cAGE,IAAA,kDACX,IAAA,EAAM,IAAA,CAAK,IAAA,EAAM,KAAA,EAAO,MAAA,EAAQ,CAAA,MAC/B,IAAA,CAAK,IAAA,EAAM,KAAA,EAAO,MAAA,EAAQ,CAAA;AAAA,KAWjB,aAAA;EAAA,SACD,KAAA;EAAA,SACA,IAAA,EAAM,IAAA;EAAA,SACN,WAAA;EAAA,SACA,WAAA,EAAa,eAAA,CAAgB,KAAA;EAAA,SAC7B,GAAA,GAAM,KAAA,EAAO,KAAA,KAAU,MAAA,CAAO,MAAA,CAAO,KAAA,WAAgB,CAAA;EAAA,SACrD,QAAA,GAAW,MAAA,EAAQ,aAAA,CAAc,KAAA,MAAW,MAAA;EAAA,SAC5C,MAAA;AAAA;AAAA,cAGE,SAAA,yDACX,IAAA,EAAM,IAAA,CAAK,aAAA,CAAc,IAAA,EAAM,KAAA,EAAO,KAAA,EAAO,MAAA,EAAQ,CAAA,gBACpD,aAAA,CAAc,IAAA,EAAM,KAAA,EAAO,KAAA,EAAO,MAAA,EAAQ,CAAA;AAAA,KAEjC,gBAAA,YAA4B,aAAA,wBAAqC,CAAA;AAAA,KACjE,YAAA,YAAwB,IAAA,mBAAuB,CAAA;AAAA,KAC/C,OAAA,YAAmB,gBAAA,CAAiB,CAAA,IAAK,YAAA,CAAa,CAAA;AAAA,cAErD,eAAA,MAAsB,CAAA,EAAG,OAAA,CAAQ,CAAA,MAAK,CAAA,IAAK,gBAAA,CAAiB,CAAA;;;;;;cAQ5D,aAAA,MAAoB,KAAA,EAAO,aAAA,CAAc,OAAA,CAAQ,CAAA,OAAM,aAAA,CAAc,cAAA;;;;;;cAkBrE,OAAA,0CACX,IAAA,EAAM,IAAA,CAAK,IAAA,EAAM,KAAA,EAAO,MAAA,EAAQ,CAAA,GAChC,IAAA,EAAM,QAAA,KACL,MAAA,CAAO,MAAA,CAAO,cAAA,EAAgB,SAAA,EAAW,CAAA"}

package/dist/capabilities/Capabilities.d.mts

@@ -0,0 +1,78 @@
+import { Effect } from "effect";
+
+//#region src/capabilities/Capabilities.d.ts
+declare namespace Capabilities_d_exports {
+  export { CapabilityWarning, warnDropped, warnDroppedWhen };
+}
+/**
+ * Structured event emitted when a provider adapter drops a Common
+ * request field because its wire API has no place to put it (bucket 2
+ * per the capabilities policy: the provider has no structured
+ * interpretation; the output is still valid, just less aligned with
+ * the caller's hint).
+ *
+ * Carried on `Effect.logWarning` today for visibility; may be
+ * promoted to a typed `AiError` variant in the future if callers need
+ * to react programmatically. The shape itself is stable.
+ *
+ * @category capabilities
+ */
+type CapabilityWarning = {
+  readonly _tag: "CapabilityWarning";
+  readonly provider: string; /** The capability name as it appears in docs (`"lyrics"`, `"bpm"`). */
+  readonly capability: string; /** The Common-request field name that was dropped. */
+  readonly field: string; /** The value the caller passed; included when useful for debugging. */
+  readonly value?: unknown; /** Human-readable explanation; should suggest a workaround. */
+  readonly reason: string;
+};
+/**
+ * Emit a structured `CapabilityWarning` via `Effect.logWarning`. Use
+ * when a provider adapter receives a Common-request field it has no
+ * structured wire field for, and would otherwise drop silently.
+ *
+ * Bucket-2 cases only (per the capabilities policy): the provider has
+ * no interpretation; the output is still valid, just less aligned
+ * with the caller's hint. For bucket-1 cases (structurally broken
+ * output if dropped, like wrong audio format), fail
+ * `AiError.Unsupported` instead.
+ *
+ * @example
+ * ```ts
+ * if (request.lyrics !== undefined) {
+ *   yield* warnDropped({
+ *     provider: "lyria",
+ *     capability: "lyrics",
+ *     field: "lyrics",
+ *     reason: "Lyria 3 sync has no `lyrics` wire field. Embed in your prompt instead.",
+ *   })
+ * }
+ * ```
+ */
+declare const warnDropped: (warning: Omit<CapabilityWarning, "_tag">) => Effect.Effect<void>;
+/**
+ * Shorthand for the most common shape: warn-and-drop when a specific
+ * field on the Common request is set. The field's value is included
+ * automatically.
+ *
+ * @example
+ * ```ts
+ * yield* Effect.all([
+ *   warnDroppedWhen(request.lyrics, {
+ *     provider: "lyria",
+ *     capability: "lyrics",
+ *     field: "lyrics",
+ *     reason: "Lyria 3 sync has no `lyrics` wire field. Embed in your prompt instead.",
+ *   }),
+ *   warnDroppedWhen(request.duration, {
+ *     provider: "lyria",
+ *     capability: "duration",
+ *     field: "duration",
+ *     reason: "Lyria 3 clip is fixed at 30 s.",
+ *   }),
+ * ], { discard: true })
+ * ```
+ */
+declare const warnDroppedWhen: <T>(value: T | undefined, warning: Omit<CapabilityWarning, "_tag" | "value">) => Effect.Effect<void>;
+//#endregion
+export { CapabilityWarning, Capabilities_d_exports as t, warnDropped, warnDroppedWhen };
+//# sourceMappingURL=Capabilities.d.mts.map

package/dist/capabilities/Capabilities.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Capabilities.d.mts","names":[],"sources":["../../src/capabilities/Capabilities.ts"],"mappings":";;;;;;;;;;;;;;AAeA;;;;;KAAY,iBAAA;EAAA,SACD,IAAA;EAAA,SACA,QAAA,UAMA;EAAA,SAJA,UAAA,UAMM;EAAA,SAJN,KAAA,UA8BE;EAAA,SA5BF,KAAA;WAEA,MAAA;AAAA;;;;;;;;;;;AAoDX;;;;;;;;;;;;;cA1Ba,WAAA,GAAe,OAAA,EAAS,IAAA,CAAK,iBAAA,cAA6B,MAAA,CAAO,MAAA;;;;;;;;;;;;;;;;;;;;;;;;cA0BjE,eAAA,MACX,KAAA,EAAO,CAAA,cACP,OAAA,EAAS,IAAA,CAAK,iBAAA,wBACb,MAAA,CAAO,MAAA"}

package/dist/capabilities/Capabilities.mjs

@@ -0,0 +1,65 @@
+import { n as __exportAll } from "../chunk-uyGKjUfl.mjs";
+import { Effect } from "effect";
+//#region src/capabilities/Capabilities.ts
+var Capabilities_exports = /* @__PURE__ */ __exportAll({
+	warnDropped: () => warnDropped,
+	warnDroppedWhen: () => warnDroppedWhen
+});
+/**
+* Emit a structured `CapabilityWarning` via `Effect.logWarning`. Use
+* when a provider adapter receives a Common-request field it has no
+* structured wire field for, and would otherwise drop silently.
+*
+* Bucket-2 cases only (per the capabilities policy): the provider has
+* no interpretation; the output is still valid, just less aligned
+* with the caller's hint. For bucket-1 cases (structurally broken
+* output if dropped, like wrong audio format), fail
+* `AiError.Unsupported` instead.
+*
+* @example
+* ```ts
+* if (request.lyrics !== undefined) {
+*   yield* warnDropped({
+*     provider: "lyria",
+*     capability: "lyrics",
+*     field: "lyrics",
+*     reason: "Lyria 3 sync has no `lyrics` wire field. Embed in your prompt instead.",
+*   })
+* }
+* ```
+*/
+const warnDropped = (warning) => Effect.logWarning("Capability dropped", {
+	...warning,
+	_tag: "CapabilityWarning"
+});
+/**
+* Shorthand for the most common shape: warn-and-drop when a specific
+* field on the Common request is set. The field's value is included
+* automatically.
+*
+* @example
+* ```ts
+* yield* Effect.all([
+*   warnDroppedWhen(request.lyrics, {
+*     provider: "lyria",
+*     capability: "lyrics",
+*     field: "lyrics",
+*     reason: "Lyria 3 sync has no `lyrics` wire field. Embed in your prompt instead.",
+*   }),
+*   warnDroppedWhen(request.duration, {
+*     provider: "lyria",
+*     capability: "duration",
+*     field: "duration",
+*     reason: "Lyria 3 clip is fixed at 30 s.",
+*   }),
+* ], { discard: true })
+* ```
+*/
+const warnDroppedWhen = (value, warning) => value === void 0 ? Effect.void : warnDropped({
+	...warning,
+	value
+});
+//#endregion
+export { Capabilities_exports as t, warnDropped, warnDroppedWhen };
+
+//# sourceMappingURL=Capabilities.mjs.map

package/dist/capabilities/Capabilities.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Capabilities.mjs","names":[],"sources":["../../src/capabilities/Capabilities.ts"],"sourcesContent":["import { Effect } from \"effect\"\n\n/**\n * Structured event emitted when a provider adapter drops a Common\n * request field because its wire API has no place to put it (bucket 2\n * per the capabilities policy: the provider has no structured\n * interpretation; the output is still valid, just less aligned with\n * the caller's hint).\n *\n * Carried on `Effect.logWarning` today for visibility; may be\n * promoted to a typed `AiError` variant in the future if callers need\n * to react programmatically. The shape itself is stable.\n *\n * @category capabilities\n */\nexport type CapabilityWarning = {\n  readonly _tag: \"CapabilityWarning\"\n  readonly provider: string\n  /** The capability name as it appears in docs (`\"lyrics\"`, `\"bpm\"`). */\n  readonly capability: string\n  /** The Common-request field name that was dropped. */\n  readonly field: string\n  /** The value the caller passed; included when useful for debugging. */\n  readonly value?: unknown\n  /** Human-readable explanation; should suggest a workaround. */\n  readonly reason: string\n}\n\n/**\n * Emit a structured `CapabilityWarning` via `Effect.logWarning`. Use\n * when a provider adapter receives a Common-request field it has no\n * structured wire field for, and would otherwise drop silently.\n *\n * Bucket-2 cases only (per the capabilities policy): the provider has\n * no interpretation; the output is still valid, just less aligned\n * with the caller's hint. For bucket-1 cases (structurally broken\n * output if dropped, like wrong audio format), fail\n * `AiError.Unsupported` instead.\n *\n * @example\n * ```ts\n * if (request.lyrics !== undefined) {\n *   yield* warnDropped({\n *     provider: \"lyria\",\n *     capability: \"lyrics\",\n *     field: \"lyrics\",\n *     reason: \"Lyria 3 sync has no `lyrics` wire field. Embed in your prompt instead.\",\n *   })\n * }\n * ```\n */\nexport const warnDropped = (warning: Omit<CapabilityWarning, \"_tag\">): Effect.Effect<void> =>\n  Effect.logWarning(\"Capability dropped\", { ...warning, _tag: \"CapabilityWarning\" })\n\n/**\n * Shorthand for the most common shape: warn-and-drop when a specific\n * field on the Common request is set. The field's value is included\n * automatically.\n *\n * @example\n * ```ts\n * yield* Effect.all([\n *   warnDroppedWhen(request.lyrics, {\n *     provider: \"lyria\",\n *     capability: \"lyrics\",\n *     field: \"lyrics\",\n *     reason: \"Lyria 3 sync has no `lyrics` wire field. Embed in your prompt instead.\",\n *   }),\n *   warnDroppedWhen(request.duration, {\n *     provider: \"lyria\",\n *     capability: \"duration\",\n *     field: \"duration\",\n *     reason: \"Lyria 3 clip is fixed at 30 s.\",\n *   }),\n * ], { discard: true })\n * ```\n */\nexport const warnDroppedWhen = <T>(\n  value: T | undefined,\n  warning: Omit<CapabilityWarning, \"_tag\" | \"value\">,\n): Effect.Effect<void> => (value === undefined ? Effect.void : warnDropped({ ...warning, value }))\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDA,MAAa,eAAe,YAC1B,OAAO,WAAW,sBAAsB;CAAE,GAAG;CAAS,MAAM;CAAqB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;AAyBpF,MAAa,mBACX,OACA,YACyB,UAAU,KAAA,IAAY,OAAO,OAAO,YAAY;CAAE,GAAG;CAAS;CAAO,CAAC"}

package/dist/domain/Audio.d.mts

@@ -1,2 +1,2 @@
-import { a as AudioSource, c as isAudioBytes, i as AudioMimeType, l as isAudioUrl, n as AudioChunk, r as AudioFormat, s as isAudioBase64, t as AudioBlob } from "../Audio-BfCTGnH3.mjs";
+import { a as AudioSource, c as isAudioBytes, i as AudioMimeType, l as isAudioUrl, n as AudioChunk, r as AudioFormat, s as isAudioBase64, t as AudioBlob } from "../Audio-DPlTsNdz.mjs";
 export { AudioBlob, AudioChunk, AudioFormat, AudioMimeType, AudioSource, isAudioBase64, isAudioBytes, isAudioUrl };

package/dist/domain/Audio.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Audio.mjs","names":[],"sources":["../../src/domain/Audio.ts"],"sourcesContent":["import type { MediaBase64, MediaBytes, MediaUrl } from \"./Media.js\"\n\n/**\n * MIME types we care about across STT input and TTS output. Container-\n * level only — sample rate / encoding flavours live on `AudioFormat`.\n *\n * Per-provider request types narrow this further. The `(string & {})`\n * tail keeps autocomplete on the literals while still accepting any\n * string, so unusual formats work without an SDK update.\n */\nexport type AudioMimeType =\n  | \"audio/mpeg\"\n  | \"audio/wav\"\n  | \"audio/x-wav\"\n  | \"audio/ogg\"\n  | \"audio/opus\"\n  | \"audio/flac\"\n  | \"audio/aac\"\n  | \"audio/mp4\"\n  | \"audio/webm\"\n  | \"audio/L16\"\n  | \"audio/pcm\"\n  | \"audio/mulaw\"\n  | \"audio/alaw\"\n  // eslint-disable-next-line @typescript-eslint/ban-types\n  | (string & {})\n\n/**\n * Audio at rest — instantiates `MediaSource` with the audio MIME union.\n * Used for sync STT input.\n *\n * URL variant is best-effort: some providers (OpenAI, Cartesia, Azure\n * short-audio) reject URL ingestion and the adapter must upload via the\n * `bytes` or `base64` variant instead. Adapter layers reject unsupported\n * shapes up front with `AiError.InvalidRequest`.\n */\nexport type AudioSource =\n  | MediaUrl<AudioMimeType>\n  | MediaBase64<AudioMimeType>\n  | MediaBytes<AudioMimeType>\n\nexport const isAudioUrl = (s: AudioSource): s is MediaUrl<AudioMimeType> => s._tag === \"url\"\nexport const isAudioBase64 = (s: AudioSource): s is MediaBase64<AudioMimeType> =>\n  s._tag === \"base64\"\nexport const isAudioBytes = (s: AudioSource): s is MediaBytes<AudioMimeType> => s._tag === \"bytes\"\n\n/**\n * Structural audio format. Used both as TTS output spec and as STT\n * streaming-input declaration. Providers that use compound slugs\n * (`mp3_44100_128`, `audio-16khz-128kbitrate-mono-mp3`,\n * `aura-2-thalia-en`) are encoded at the adapter layer.\n */\nexport type AudioFormat = {\n  readonly container: \"mp3\" | \"wav\" | \"ogg\" | \"opus\" | \"flac\" | \"aac\" | \"webm\" | \"raw\"\n  readonly encoding:\n    | \"pcm_s16le\"\n    | \"pcm_f32le\"\n    | \"pcm_mulaw\"\n    | \"pcm_alaw\"\n    | \"mp3\"\n    | \"opus\"\n    | \"vorbis\"\n    | \"flac\"\n    | \"aac\"\n  readonly sampleRate: 8000 | 16000 | 22050 | 24000 | 32000 | 44100 | 48000\n  /** mp3 / opus only. */\n  readonly bitRate?: number\n  readonly channels?: 1 | 2\n}\n\n/**\n * Streamed audio chunk. `bytes` carries the codec-encoded payload as\n * declared on the stream's `AudioFormat`. No per-chunk timestamp here —\n * providers that emit timing do so via `TranscriptEvent.words[]`.\n */\nexport type AudioChunk = {\n  readonly bytes: Uint8Array\n}\n\n/**\n * Full audio result for sync TTS. Format mirrors the request; provider\n * layers normalize.\n */\nexport type AudioBlob = {\n  readonly format: AudioFormat\n  readonly bytes: Uint8Array\n  readonly durationSeconds?: number\n}\n"],"mappings":";;;;;;;AAyCA,MAAa,cAAc,MAAiD,EAAE,SAAS;AACvF,MAAa,iBAAiB,MAC5B,EAAE,SAAS;AACb,MAAa,gBAAgB,MAAmD,EAAE,SAAS"}
+{"version":3,"file":"Audio.mjs","names":[],"sources":["../../src/domain/Audio.ts"],"sourcesContent":["import type { Duration } from \"effect\"\nimport type { MediaBase64, MediaBytes, MediaUrl } from \"./Media.js\"\n\n/**\n * MIME types we care about across STT input and TTS output. Container-\n * level only — sample rate / encoding flavours live on `AudioFormat`.\n *\n * Per-provider request types narrow this further. The `(string & {})`\n * tail keeps autocomplete on the literals while still accepting any\n * string, so unusual formats work without an SDK update.\n */\nexport type AudioMimeType =\n  | \"audio/mpeg\"\n  | \"audio/wav\"\n  | \"audio/x-wav\"\n  | \"audio/ogg\"\n  | \"audio/opus\"\n  | \"audio/flac\"\n  | \"audio/aac\"\n  | \"audio/mp4\"\n  | \"audio/webm\"\n  | \"audio/L16\"\n  | \"audio/pcm\"\n  | \"audio/mulaw\"\n  | \"audio/alaw\"\n  // eslint-disable-next-line @typescript-eslint/ban-types\n  | (string & {})\n\n/**\n * Audio at rest — instantiates `MediaSource` with the audio MIME union.\n * Used for sync STT input.\n *\n * URL variant is best-effort: some providers (OpenAI, Cartesia, Azure\n * short-audio) reject URL ingestion and the adapter must upload via the\n * `bytes` or `base64` variant instead. Adapter layers reject unsupported\n * shapes up front with `AiError.InvalidRequest`.\n */\nexport type AudioSource =\n  | MediaUrl<AudioMimeType>\n  | MediaBase64<AudioMimeType>\n  | MediaBytes<AudioMimeType>\n\nexport const isAudioUrl = (s: AudioSource): s is MediaUrl<AudioMimeType> => s._tag === \"url\"\nexport const isAudioBase64 = (s: AudioSource): s is MediaBase64<AudioMimeType> =>\n  s._tag === \"base64\"\nexport const isAudioBytes = (s: AudioSource): s is MediaBytes<AudioMimeType> => s._tag === \"bytes\"\n\n/**\n * Structural audio format. Used both as TTS output spec and as STT\n * streaming-input declaration. Providers that use compound slugs\n * (`mp3_44100_128`, `audio-16khz-128kbitrate-mono-mp3`,\n * `aura-2-thalia-en`) are encoded at the adapter layer.\n */\nexport type AudioFormat = {\n  readonly container: \"mp3\" | \"wav\" | \"ogg\" | \"opus\" | \"flac\" | \"aac\" | \"webm\" | \"raw\"\n  readonly encoding:\n    | \"pcm_s16le\"\n    | \"pcm_f32le\"\n    | \"pcm_mulaw\"\n    | \"pcm_alaw\"\n    | \"mp3\"\n    | \"opus\"\n    | \"vorbis\"\n    | \"flac\"\n    | \"aac\"\n  readonly sampleRate: 8000 | 16000 | 22050 | 24000 | 32000 | 44100 | 48000\n  /** mp3 / opus only. */\n  readonly bitRate?: number\n  readonly channels?: 1 | 2\n}\n\n/**\n * Streamed audio chunk. `bytes` carries the codec-encoded payload as\n * declared on the stream's `AudioFormat`. No per-chunk timestamp here —\n * providers that emit timing do so via `TranscriptEvent.words[]`.\n */\nexport type AudioChunk = {\n  readonly bytes: Uint8Array\n}\n\n/**\n * Full audio result for sync TTS. Format mirrors the request; provider\n * layers normalize.\n */\nexport type AudioBlob = {\n  readonly format: AudioFormat\n  readonly bytes: Uint8Array\n  readonly duration?: Duration.Duration\n}\n"],"mappings":";;;;;;;AA0CA,MAAa,cAAc,MAAiD,EAAE,SAAS;AACvF,MAAa,iBAAiB,MAC5B,EAAE,SAAS;AACb,MAAa,gBAAgB,MAAmD,EAAE,SAAS"}

package/dist/domain/Items.d.mts

@@ -1,2 +1,2 @@
-import { A as isReasoning, C as isContainerFileCitation, D as isInputText, E as isInputImage, F as systemText, I as toolCallOutput, L as userText, M as isToolCall, N as isToolCallOutput, O as isMessage, P as isUrlCitation, S as assistantText, T as isFilePath, _ as StopReason, a as FilePath, b as UrlCitation, c as InputText, d as Message, f as OutputText, g as Role, h as Refusal, i as FileCitation, j as isRefusal, k as isOutputText, l as InputTokensDetails, m as Reasoning, n as ContainerFileCitation, o as HistoryItem, p as OutputTokensDetails, r as ContentBlock, s as InputImage, t as Annotation, v as ToolCall, w as isFileCitation, x as Usage, y as ToolCallOutput } from "../Items-pXR5BAgW.mjs";
+import { A as isReasoning, C as isContainerFileCitation, D as isInputText, E as isInputImage, F as systemText, I as toolCallOutput, L as userText, M as isToolCall, N as isToolCallOutput, O as isMessage, P as isUrlCitation, S as assistantText, T as isFilePath, _ as StopReason, a as FilePath, b as UrlCitation, c as InputText, d as Message, f as OutputText, g as Role, h as Refusal, i as FileCitation, j as isRefusal, k as isOutputText, l as InputTokensDetails, m as Reasoning, n as ContainerFileCitation, o as HistoryItem, p as OutputTokensDetails, r as ContentBlock, s as InputImage, t as Annotation, v as ToolCall, w as isFileCitation, x as Usage, y as ToolCallOutput } from "../Items-D8UaXQx_.mjs";
 export { Annotation, ContainerFileCitation, ContentBlock, FileCitation, FilePath, HistoryItem, InputImage, InputText, InputTokensDetails, Message, OutputText, OutputTokensDetails, Reasoning, Refusal, Role, StopReason, ToolCall, ToolCallOutput, UrlCitation, Usage, assistantText, isContainerFileCitation, isFileCitation, isFilePath, isInputImage, isInputText, isMessage, isOutputText, isReasoning, isRefusal, isToolCall, isToolCallOutput, isUrlCitation, systemText, toolCallOutput, userText };

package/dist/domain/Music.d.mts

@@ -1,116 +1,175 @@
-import { 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 { Duration } from "effect";
 
 //#region src/domain/Music.d.ts
 declare namespace Music_d_exports {
-  export { CommonGenerateMusicRequest, CommonStreamGenerateMusicRequest, MusicResult, MusicSessionInput, WeightedPrompt, configInput, controlInput, isConfigInput, isControlInput, isPromptsInput, promptsInput };
+  export { CommonGenerateMusicRequest, CommonStreamGenerateMusicRequest, GenerateResult, MusicResult, MusicSection, MusicSessionControl, MusicSessionInput, MusicStreamEvent, Watermark, WeightedPrompt, audioEvent, controlInput, filteredPromptEvent, isAudioEvent, isControlInput, isFilteredPromptEvent, isPromptsInput, isWarningEvent, promptsInput, singleVariant, warningEvent };
 }
 /**
  * Prompt fragment with a relative weight. Native to Lyria RealTime
- * (`{ text, weight }` pairs blended in the model). Single-prompt
- * providers (Suno, Mureka, MiniMax) flatten to text at the adapter
- * layer.
+ * (`{ text, weight }` pairs blended in the model) and Riffusion compose.
+ * Single-prompt providers (the majority) treat a 1-element array with
+ * `weight: 1` as a plain prompt.
  */
 type WeightedPrompt = {
   readonly text: string; /** Default `1.0`. Range typically `[0, 1]`; provider-dependent. */
   readonly weight?: number;
 };
 /**
- * Cross-provider music-generation request. Provider-specific extras
- * (Lyria `mode`, ElevenLabs `composition_plan`, Suno custom-mode `title`,
- * MiniMax `lyrics_optimizer`) live on each provider's typed request
- * which extends this and narrows `model`.
+ * Cross-provider music-generation request. Trimmed to fields the
+ * majority of music providers honor structurally; provider-specific
+ * extras (Lyria `bpm` / `scale`, ElevenLabs `compositionPlan` /
+ * `signWithC2pa`, Suno `style` / `personaId`, MiniMax `lyricsOptimizer`,
+ * `instrumental` on providers that ship a wire toggle) live on each
+ * provider's typed request which extends this and narrows `model`.
+ *
+ * Music providers are one-shot text-to-audio, not conversational. No
+ * `messages[]` shape applies.
  */
 type CommonGenerateMusicRequest = {
-  /** Model identifier. Each provider narrows. */readonly model: string; /** Single prompt string or weighted-prompt list (blended where supported). */
-  readonly prompts: string | ReadonlyArray<WeightedPrompt>;
+  /** Model identifier. Each provider narrows. */readonly model: string; /** Single prompt string. Weighted blends are provider-typed extras. */
+  readonly prompt: string;
   /**
-   * Lyrics text, optionally with section tags like `[Verse]` / `[Chorus]` /
-   * `[Bridge]` / `[Outro]`. Ignored for instrumental-only providers or
-   * when `instrumental: true`.
+   * Lyrics text, optionally with section tags like `[Verse]` /
+   * `[Chorus]` / `[Bridge]` / `[Outro]`. Routed to a structured wire
+   * field on providers that have one (ElevenLabs `lines`, MiniMax
+   * `lyrics`, Mureka `lyrics`, Suno custom-mode `prompt`); embedded in
+   * the prompt with a warning on providers without one (Lyria 3,
+   * Riffusion).
    */
-  readonly lyrics?: string; /** Target duration in seconds. Provider may treat as a hint or hard limit. */
-  readonly durationSeconds?: number; /** Beats per minute (60–200 typical). */
-  readonly bpm?: number;
+  readonly lyrics?: string; /** Target duration. Provider may treat as a hint or hard limit. */
+  readonly duration?: Duration.Duration;
   /**
-   * Musical key/mode hint. Provider-specific vocabulary (e.g. Lyria
-   * RealTime uses enum values like `"C_MAJOR"`, `"A_MINOR"`).
+   * Reproducibility seed. Tuning hint (bucket 3): honored where the
+   * provider takes one (Lyria 2 Vertex, Lyria RealTime, ElevenLabs
+   * with `compositionPlan`, Stable Audio, MusicGen); silently ignored
+   * elsewhere.
    */
-  readonly scale?: string; /** Skip vocals / lyrics. */
-  readonly instrumental?: boolean; /** Preferred output format. Provider may override. */
+  readonly seed?: number; /** Preferred output format. Provider may override. */
   readonly outputFormat?: AudioFormat;
 };
 /**
- * Streamed-output request. Same shape as the sync request — the
+ * Streamed-output request. Same shape as the sync request: the
  * streaming variant only differs in how the response is delivered.
  */
 type CommonStreamGenerateMusicRequest = CommonGenerateMusicRequest;
 /**
- * Bidirectional-session input. The user pushes one of these per
- * change: a new prompt blend, a config delta, or a playback control.
- * Lyria RealTime is the only provider currently surfacing these.
+ * Playback-control vocabulary that converges across interactive-media
+ * protocols (Web Audio, MIDI sequencer control, music SDK surfaces).
+ * Provider-specific control actions (Lyria's `reset_context` and any
+ * future provider's extras) live on the provider-typed session-input
+ * union.
+ */
+type MusicSessionControl = "play" | "pause" | "stop" | "reset";
+/**
+ * Bidirectional-session input on the cross-provider surface. Two
+ * load-bearing actions every interactive music session needs:
+ *
+ * - `prompts` — steer the active generation with a (single or
+ *   weighted) prompt blend.
+ * - `control` — play / pause / stop / reset.
+ *
+ * Provider-typed services extend this union with their own `config`
+ * variant for model-specific knobs (Lyria RealTime exposes density /
+ * brightness / mute-stems / BPM / scale / etc. via its own
+ * `LyriaRealtimeSessionInput`).
  */
 type MusicSessionInput = {
   readonly _tag: "prompts";
   readonly prompts: ReadonlyArray<WeightedPrompt>;
-} | {
-  readonly _tag: "config";
-  readonly config: {
-    readonly bpm?: number;
-    readonly scale?: string;
-    readonly density?: number;
-    readonly brightness?: number;
-    readonly guidance?: number;
-    readonly temperature?: number;
-    readonly topK?: number;
-    readonly seed?: number;
-    readonly muteBass?: boolean;
-    readonly muteDrums?: boolean;
-    readonly onlyBassAndDrums?: boolean;
-  };
 } | {
   readonly _tag: "control";
-  readonly action: "play" | "pause" | "stop" | "reset_context";
+  readonly action: MusicSessionControl;
 };
 declare const promptsInput: (prompts: ReadonlyArray<WeightedPrompt>) => MusicSessionInput;
-declare const configInput: (config: (MusicSessionInput & {
-  _tag: "config";
-})["config"]) => MusicSessionInput;
-declare const controlInput: (action: (MusicSessionInput & {
-  _tag: "control";
-})["action"]) => MusicSessionInput;
+declare const controlInput: (action: MusicSessionControl) => MusicSessionInput;
 /**
- * Sync-generation result. Extends `AudioBlob` with provider-side
- * metadata that's common across music providers:
- *
- * - `songId` — Suno task id, ElevenLabs `song_id`, etc. Used for
- *   back-reference (re-download, stem export, follow-up edits).
- * - `lyrics` — generated lyrics when the model returned them (Lyria
- *   text part, Mureka, Suno).
- * - `sections` — structured section markers (Lyria optional JSON
- *   structure response).
- * - `watermark` — presence marker (Lyria SynthID is always set).
+ * Watermark kind on the response. SynthID is mandatory on Lyria; C2PA
+ * is opt-in on ElevenLabs. No provider exposes additional metadata
+ * about the watermark itself, so a bare literal-union is enough.
  */
-type MusicResult = AudioBlob & {
-  readonly songId?: string;
-  readonly lyrics?: string;
-  readonly sections?: ReadonlyArray<{
-    readonly label: string;
-    readonly startSeconds: number;
-    readonly endSeconds: number;
-  }>;
-  readonly watermark?: {
-    readonly kind: string;
-  };
+type Watermark = "synthid" | "c2pa" | (string & {});
+/**
+ * Labelled section with absolute timing. Populated when the provider
+ * returns structured section metadata (Lyria text part, ElevenLabs
+ * `/v1/music/detailed` with `with_timestamps`).
+ */
+type MusicSection = {
+  readonly label: string;
+  readonly startSeconds: number;
+  readonly endSeconds: number;
+};
+/**
+ * Single generated track. Composes `AudioBlob` rather than extending
+ * it — `result.audio` is the raw blob, `result.songId` / `lyrics` /
+ * `sections` / `watermark` are provider-side metadata when returned.
+ */
+type MusicResult = {
+  readonly audio: AudioBlob;
+  /**
+   * Provider identifier, useful when routing through multiple
+   * providers in a single pipeline (`"lyria"`, `"elevenlabs-music"`,
+   * etc.).
+   */
+  readonly provider?: string; /** Provider-side ID for back-reference (re-download, extension, stems). */
+  readonly songId?: string; /** Generated or transcribed lyrics when the provider returned them. */
+  readonly lyrics?: string; /** Structured section markers when the provider returned them. */
+  readonly sections?: ReadonlyArray<MusicSection>; /** Watermark presence indicator when the provider applied one. */
+  readonly watermark?: Watermark;
+};
+/**
+ * Result of a `generate` call. Suno and Mureka always return 2 tracks
+ * per request; every other provider returns 1. `primary` is the
+ * caller-friendly convenience; `variants` carries every track the
+ * provider produced (length ≥ 1; `primary === variants[0]`).
+ */
+type GenerateResult = {
+  readonly primary: MusicResult;
+  readonly variants: ReadonlyArray<MusicResult>;
+};
+/**
+ * In-band event on the bidirectional `streamGenerationFrom` output
+ * stream. Audio chunks flow as `audio`; server-side warnings
+ * (`warning`) and prompt-filter rejections (`filteredPrompt`) flow
+ * alongside rather than going to a side-channel log.
+ */
+type MusicStreamEvent = {
+  readonly _tag: "audio";
+  readonly chunk: AudioChunk;
+} | {
+  readonly _tag: "warning";
+  readonly message: string;
+} | {
+  readonly _tag: "filteredPrompt";
+  readonly prompt: string;
+  readonly reason: string;
 };
 declare const isPromptsInput: (i: MusicSessionInput) => i is MusicSessionInput & {
   _tag: "prompts";
 };
-declare const isConfigInput: (i: MusicSessionInput) => i is MusicSessionInput & {
-  _tag: "config";
-};
 declare const isControlInput: (i: MusicSessionInput) => i is MusicSessionInput & {
   _tag: "control";
 };
+declare const audioEvent: (chunk: AudioChunk) => MusicStreamEvent;
+declare const warningEvent: (message: string) => MusicStreamEvent;
+declare const filteredPromptEvent: (prompt: string, reason: string) => MusicStreamEvent;
+declare const isAudioEvent: (e: MusicStreamEvent) => e is MusicStreamEvent & {
+  _tag: "audio";
+};
+declare const isWarningEvent: (e: MusicStreamEvent) => e is MusicStreamEvent & {
+  _tag: "warning";
+};
+declare const isFilteredPromptEvent: (e: MusicStreamEvent) => e is MusicStreamEvent & {
+  _tag: "filteredPrompt";
+};
+/**
+ * Build a single-variant `GenerateResult` from a `MusicResult`.
+ * Convenience for providers that always return exactly one track
+ * (Lyria, ElevenLabs, MiniMax, Stable Audio, MusicGen, Riffusion,
+ * Tencent). Providers that return multiple tracks (Suno, Mureka)
+ * construct the `GenerateResult` directly.
+ */
+declare const singleVariant: (result: MusicResult) => GenerateResult;
 //#endregion
-export { CommonGenerateMusicRequest, CommonStreamGenerateMusicRequest, MusicResult, MusicSessionInput, WeightedPrompt, configInput, controlInput, isConfigInput, isControlInput, isPromptsInput, promptsInput, Music_d_exports as t };
+export { CommonGenerateMusicRequest, CommonStreamGenerateMusicRequest, GenerateResult, MusicResult, MusicSection, MusicSessionControl, MusicSessionInput, MusicStreamEvent, Watermark, WeightedPrompt, audioEvent, controlInput, filteredPromptEvent, isAudioEvent, isControlInput, isFilteredPromptEvent, isPromptsInput, isWarningEvent, promptsInput, singleVariant, Music_d_exports as t, warningEvent };
 //# sourceMappingURL=Music.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Music.d.mts","names":[],"sources":["../../src/domain/Music.ts"],"mappings":";;;;;;;;;;;;KAQY,cAAA;EAAA,SACD,IAAA;WAEA,MAAA;AAAA;;;;;;AAHX;KAYY,0BAAA;0DAED,KAAA,UAXM;EAAA,SAaN,OAAA,WAAkB,aAAA,CAAc,cAAA;EAJL;;;;;EAAA,SAU3B,MAAA,WAa0B;EAAA,SAX1B,eAAA,WARA;EAAA,SAUA,GAAA;EAVgC;;;;EAAA,SAehC,KAAA,WAEA;EAAA,SAAA,YAAA,YAEe;EAAA,SAAf,YAAA,GAAe,WAAA;AAAA;AAO1B;;;;AAAA,KAAY,gCAAA,GAAmC,0BAAA;AAO/C;;;;;AAAA,KAAY,iBAAA;EAAA,SACG,IAAA;EAAA,SAA0B,OAAA,EAAS,aAAA,CAAc,cAAA;AAAA;EAAA,SAEjD,IAAA;EAAA,SACA,MAAA;IAAA,SACE,GAAA;IAAA,SACA,KAAA;IAAA,SACA,OAAA;IAAA,SACA,UAAA;IAAA,SACA,QAAA;IAAA,SACA,WAAA;IAAA,SACA,IAAA;IAAA,SACA,IAAA;IAAA,SACA,QAAA;IAAA,SACA,SAAA;IAAA,SACA,gBAAA;EAAA;AAAA;EAAA,SAGF,IAAA;EAAA,SAA0B,MAAA;AAAA;AAAA,cAE5B,YAAA,GAAgB,OAAA,EAAS,aAAA,CAAc,cAAA,MAAkB,iBAAA;AAAA,cAKzD,WAAA,GACX,MAAA,GAAS,iBAAA;EAAsB,IAAA;AAAA,iBAC9B,iBAAA;AAAA,cAEU,YAAA,GACX,MAAA,GAAS,iBAAA;EAAsB,IAAA;AAAA,iBAC9B,iBAAA;;;;;;AANH;;;;;;;KAoBY,WAAA,GAAc,SAAA;EAAA,SACf,MAAA;EAAA,SACA,MAAA;EAAA,SACA,QAAA,GAAW,aAAA;IAAA,SACT,KAAA;IAAA,SACA,YAAA;IAAA,SACA,UAAA;EAAA;EAAA,SAEF,SAAA;IAAA,SAAuB,IAAA;EAAA;AAAA;AAAA,cAGrB,cAAA,GACX,CAAA,EAAG,iBAAA,KACF,CAAA,IAAK,iBAAA;EAAsB,IAAA;AAAA;AAAA,cACjB,aAAA,GAAiB,CAAA,EAAG,iBAAA,KAAoB,CAAA,IAAK,iBAAA;EAAsB,IAAA;AAAA;AAAA,cAEnE,cAAA,GACX,CAAA,EAAG,iBAAA,KACF,CAAA,IAAK,iBAAA;EAAsB,IAAA;AAAA"}
+{"version":3,"file":"Music.d.mts","names":[],"sources":["../../src/domain/Music.ts"],"mappings":";;;;;;;;;;;;;KASY,cAAA;EAAA,SACD,IAAA;WAEA,MAAA;AAAA;;;;;;;;;;;;KAcC,0BAAA;0DAED,KAAA;WAEA,MAAA;EArBe;;;;AAiB1B;;;;EAjB0B,SA8Bf,MAAA,WATA;EAAA,SAWA,QAAA,GAAW,QAAA,CAAS,QAAA;EAApB;;;;;;EAAA,SAOA,IAAA,WAE0B;EAAA,SAA1B,YAAA,GAAe,WAAA;AAAA;;;;AAgB1B;KATY,gCAAA,GAAmC,0BAAA;;;;AAwB/C;;;;KAfY,mBAAA;;;;;;;;;;;;;AAmBZ;KAJY,iBAAA;EAAA,SACG,IAAA;EAAA,SAA0B,OAAA,EAAS,aAAA,CAAc,cAAA;AAAA;EAAA,SACjD,IAAA;EAAA,SAA0B,MAAA,EAAQ,mBAAA;AAAA;AAAA,cAEpC,YAAA,GAAgB,OAAA,EAAS,aAAA,CAAc,cAAA,MAAkB,iBAAA;AAAA,cAKzD,YAAA,GAAgB,MAAA,EAAQ,mBAAA,KAAsB,iBAAA;;;;;AAA3D;KAUY,SAAA;;;;;;KAOA,YAAA;EAAA,SACD,KAAA;EAAA,SACA,YAAA;EAAA,SACA,UAAA;AAAA;;;AAHX;;;KAWY,WAAA;EAAA,SACD,KAAA,EAAO,SAAA;EAVP;;;;AASX;EATW,SAgBA,QAAA;WAEA,MAAA,WAIyB;EAAA,SAFzB,MAAA,WAIY;EAAA,SAFZ,QAAA,GAAW,aAAA,CAAc,YAAA,GAEJ;EAAA,SAArB,SAAA,GAAY,SAAA;AAAA;;;;;;;KASX,cAAA;EAAA,SACD,OAAA,EAAS,WAAA;EAAA,SACT,QAAA,EAAU,aAAA,CAAc,WAAA;AAAA;AAFnC;;;;;;AAAA,KAWY,gBAAA;EAAA,SACG,IAAA;EAAA,SAAwB,KAAA,EAAO,UAAA;AAAA;EAAA,SAC/B,IAAA;EAAA,SAA0B,OAAA;AAAA;EAAA,SAC1B,IAAA;EAAA,SAAiC,MAAA;EAAA,SAAyB,MAAA;AAAA;AAAA,cAE5D,cAAA,GACX,CAAA,EAAG,iBAAA,KACF,CAAA,IAAK,iBAAA;EAAsB,IAAA;AAAA;AAAA,cACjB,cAAA,GACX,CAAA,EAAG,iBAAA,KACF,CAAA,IAAK,iBAAA;EAAsB,IAAA;AAAA;AAAA,cAEjB,UAAA,GAAc,KAAA,EAAO,UAAA,KAAa,gBAAA;AAAA,cAClC,YAAA,GAAgB,OAAA,aAAkB,gBAAA;AAAA,cAIlC,mBAAA,GAAuB,MAAA,UAAgB,MAAA,aAAiB,gBAAA;AAAA,cAMxD,YAAA,GAAgB,CAAA,EAAG,gBAAA,KAAmB,CAAA,IAAK,gBAAA;EAAqB,IAAA;AAAA;AAAA,cAEhE,cAAA,GAAkB,CAAA,EAAG,gBAAA,KAAmB,CAAA,IAAK,gBAAA;EAAqB,IAAA;AAAA;AAAA,cAElE,qBAAA,GACX,CAAA,EAAG,gBAAA,KACF,CAAA,IAAK,gBAAA;EAAqB,IAAA;AAAA;;;;;;AArB7B;;cA8Ba,aAAA,GAAiB,MAAA,EAAQ,WAAA,KAAc,cAAA"}

package/dist/domain/Music.mjs

@@ -1,29 +1,56 @@
 import { n as __exportAll } from "../chunk-uyGKjUfl.mjs";
 //#region src/domain/Music.ts
 var Music_exports = /* @__PURE__ */ __exportAll({
-	configInput: () => configInput,
+	audioEvent: () => audioEvent,
 	controlInput: () => controlInput,
-	isConfigInput: () => isConfigInput,
+	filteredPromptEvent: () => filteredPromptEvent,
+	isAudioEvent: () => isAudioEvent,
 	isControlInput: () => isControlInput,
+	isFilteredPromptEvent: () => isFilteredPromptEvent,
 	isPromptsInput: () => isPromptsInput,
-	promptsInput: () => promptsInput
+	isWarningEvent: () => isWarningEvent,
+	promptsInput: () => promptsInput,
+	singleVariant: () => singleVariant,
+	warningEvent: () => warningEvent
 });
 const promptsInput = (prompts) => ({
 	_tag: "prompts",
 	prompts
 });
-const configInput = (config) => ({
-	_tag: "config",
-	config
-});
 const controlInput = (action) => ({
 	_tag: "control",
 	action
 });
 const isPromptsInput = (i) => i._tag === "prompts";
-const isConfigInput = (i) => i._tag === "config";
 const isControlInput = (i) => i._tag === "control";
+const audioEvent = (chunk) => ({
+	_tag: "audio",
+	chunk
+});
+const warningEvent = (message) => ({
+	_tag: "warning",
+	message
+});
+const filteredPromptEvent = (prompt, reason) => ({
+	_tag: "filteredPrompt",
+	prompt,
+	reason
+});
+const isAudioEvent = (e) => e._tag === "audio";
+const isWarningEvent = (e) => e._tag === "warning";
+const isFilteredPromptEvent = (e) => e._tag === "filteredPrompt";
+/**
+* Build a single-variant `GenerateResult` from a `MusicResult`.
+* Convenience for providers that always return exactly one track
+* (Lyria, ElevenLabs, MiniMax, Stable Audio, MusicGen, Riffusion,
+* Tencent). Providers that return multiple tracks (Suno, Mureka)
+* construct the `GenerateResult` directly.
+*/
+const singleVariant = (result) => ({
+	primary: result,
+	variants: [result]
+});
 //#endregion
-export { configInput, controlInput, isConfigInput, isControlInput, isPromptsInput, promptsInput, Music_exports as t };
+export { audioEvent, controlInput, filteredPromptEvent, isAudioEvent, isControlInput, isFilteredPromptEvent, isPromptsInput, isWarningEvent, promptsInput, singleVariant, Music_exports as t, warningEvent };
 
 //# sourceMappingURL=Music.mjs.map