@effect-uai/core 0.5.2 → 0.7.0

package/dist/domain/Items.mjs

@@ -8,12 +8,10 @@ var Items_exports = /* @__PURE__ */ __exportAll({
 	ContentBlock: () => ContentBlock,
 	FileCitation: () => FileCitation,
 	FilePath: () => FilePath,
-	FunctionCall: () => FunctionCall,
-	FunctionCallOutput: () => FunctionCallOutput,
+	HistoryItem: () => HistoryItem,
 	InputImage: () => InputImage,
 	InputText: () => InputText,
 	InputTokensDetails: () => InputTokensDetails,
-	Item: () => Item,
 	Message: () => Message,
 	OutputText: () => OutputText,
 	OutputTokensDetails: () => OutputTokensDetails,
@@ -21,23 +19,25 @@ var Items_exports = /* @__PURE__ */ __exportAll({
 	Refusal: () => Refusal,
 	Role: () => Role,
 	StopReason: () => StopReason,
+	ToolCall: () => ToolCall,
+	ToolCallOutput: () => ToolCallOutput,
 	UrlCitation: () => UrlCitation,
 	Usage: () => Usage,
 	assistantText: () => assistantText,
-	functionCallOutput: () => functionCallOutput,
 	isContainerFileCitation: () => isContainerFileCitation,
 	isFileCitation: () => isFileCitation,
 	isFilePath: () => isFilePath,
-	isFunctionCall: () => isFunctionCall,
-	isFunctionCallOutput: () => isFunctionCallOutput,
 	isInputImage: () => isInputImage,
 	isInputText: () => isInputText,
 	isMessage: () => isMessage,
 	isOutputText: () => isOutputText,
 	isReasoning: () => isReasoning,
 	isRefusal: () => isRefusal,
+	isToolCall: () => isToolCall,
+	isToolCallOutput: () => isToolCallOutput,
 	isUrlCitation: () => isUrlCitation,
 	systemText: () => systemText,
+	toolCallOutput: () => toolCallOutput,
 	userText: () => userText
 });
 const InputText = Schema.Struct({
@@ -123,14 +123,14 @@ const Message = Schema.Struct({
 	content: Schema.Array(ContentBlock),
 	providerData: ProviderData
 });
-const FunctionCall = Schema.Struct({
+const ToolCall = Schema.Struct({
 	type: Schema.Literal("function_call"),
 	call_id: Schema.String,
 	name: Schema.String,
 	arguments: Schema.String,
 	providerData: ProviderData
 });
-const FunctionCallOutput = Schema.Struct({
+const ToolCallOutput = Schema.Struct({
 	type: Schema.Literal("function_call_output"),
 	call_id: Schema.String,
 	output: Schema.String,
@@ -149,10 +149,10 @@ const Reasoning = Schema.Struct({
 	signature: Schema.optional(Schema.String),
 	providerData: ProviderData
 });
-const Item = Schema.Union([
+const HistoryItem = Schema.Union([
 	Message,
-	FunctionCall,
-	FunctionCallOutput,
+	ToolCall,
+	ToolCallOutput,
 	Reasoning
 ]);
 const isInputText = Schema.is(InputText);
@@ -160,8 +160,8 @@ const isInputImage = Schema.is(InputImage);
 const isOutputText = Schema.is(OutputText);
 const isRefusal = Schema.is(Refusal);
 const isMessage = Schema.is(Message);
-const isFunctionCall = Schema.is(FunctionCall);
-const isFunctionCallOutput = Schema.is(FunctionCallOutput);
+const isToolCall = Schema.is(ToolCall);
+const isToolCallOutput = Schema.is(ToolCallOutput);
 const isReasoning = Schema.is(Reasoning);
 const InputTokensDetails = Schema.Struct({ cached_tokens: Schema.optional(Schema.Number) });
 const OutputTokensDetails = Schema.Struct({ reasoning_tokens: Schema.optional(Schema.Number) });
@@ -204,12 +204,12 @@ const assistantText = (text) => ({
 		text
 	}]
 });
-const functionCallOutput = (call_id, output) => ({
+const toolCallOutput = (call_id, output) => ({
 	type: "function_call_output",
 	call_id,
 	output
 });
 //#endregion
-export { Annotation, ContainerFileCitation, ContentBlock, FileCitation, FilePath, FunctionCall, FunctionCallOutput, InputImage, InputText, InputTokensDetails, Item, Message, OutputText, OutputTokensDetails, Reasoning, Refusal, Role, StopReason, UrlCitation, Usage, assistantText, functionCallOutput, isContainerFileCitation, isFileCitation, isFilePath, isFunctionCall, isFunctionCallOutput, isInputImage, isInputText, isMessage, isOutputText, isReasoning, isRefusal, isUrlCitation, systemText, Items_exports as t, userText };
+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, Items_exports as t, toolCallOutput, userText };
 
 //# sourceMappingURL=Items.mjs.map

package/dist/domain/Items.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Items.mjs","names":[],"sources":["../../src/domain/Items.ts"],"sourcesContent":["import { Schema } from \"effect\"\nimport { ImageSource } from \"./Image.js\"\n\n// ---------------------------------------------------------------------------\n// Content blocks (inside Message.content)\n// ---------------------------------------------------------------------------\n\nexport const InputText = Schema.Struct({\n  type: Schema.Literal(\"input_text\"),\n  text: Schema.String,\n})\nexport type InputText = typeof InputText.Type\n\n/**\n * User-provided image content block. Pair with `InputText` inside a\n * `Message.content` array to ask \"what's in this image?\" style questions.\n *\n * `source` is the cross-modality `ImageSource` from `domain/Image.ts` -\n * url, base64, or raw bytes. Provider codecs encode bytes to whatever\n * wire format the provider wants.\n */\nexport const InputImage = Schema.Struct({\n  type: Schema.Literal(\"input_image\"),\n  source: ImageSource,\n})\nexport type InputImage = typeof InputImage.Type\n\n// ---------------------------------------------------------------------------\n// Annotations - source / citation pointers attached to `output_text` blocks.\n// Mirrors OpenAI Responses API; other providers can omit or map onto these\n// shapes.\n// ---------------------------------------------------------------------------\n\nexport const UrlCitation = Schema.Struct({\n  type: Schema.Literal(\"url_citation\"),\n  url: Schema.String,\n  start_index: Schema.Number,\n  end_index: Schema.Number,\n  title: Schema.String,\n})\nexport type UrlCitation = typeof UrlCitation.Type\n\nexport const FileCitation = Schema.Struct({\n  type: Schema.Literal(\"file_citation\"),\n  file_id: Schema.String,\n  index: Schema.Number,\n})\nexport type FileCitation = typeof FileCitation.Type\n\nexport const ContainerFileCitation = Schema.Struct({\n  type: Schema.Literal(\"container_file_citation\"),\n  container_id: Schema.String,\n  file_id: Schema.String,\n  start_index: Schema.Number,\n  end_index: Schema.Number,\n})\nexport type ContainerFileCitation = typeof ContainerFileCitation.Type\n\nexport const FilePath = Schema.Struct({\n  type: Schema.Literal(\"file_path\"),\n  file_id: Schema.String,\n  index: Schema.Number,\n})\nexport type FilePath = typeof FilePath.Type\n\nexport const Annotation = Schema.Union([UrlCitation, FileCitation, ContainerFileCitation, FilePath])\nexport type Annotation = typeof Annotation.Type\n\nexport const isUrlCitation = Schema.is(UrlCitation)\nexport const isFileCitation = Schema.is(FileCitation)\nexport const isContainerFileCitation = Schema.is(ContainerFileCitation)\nexport const isFilePath = Schema.is(FilePath)\n\nexport const OutputText = Schema.Struct({\n  type: Schema.Literal(\"output_text\"),\n  text: Schema.String,\n  annotations: Schema.optional(Schema.Array(Annotation)),\n})\nexport type OutputText = typeof OutputText.Type\n\n/**\n * Model-emitted refusal. Distinct from `output_text`: the model declined\n * to answer rather than producing normal output. Pair with\n * `stop_reason: \"refusal\"` on the surrounding `Turn`. Streamed via the\n * `RefusalDelta` `TurnEvent`.\n */\nexport const Refusal = Schema.Struct({\n  type: Schema.Literal(\"refusal\"),\n  text: Schema.String,\n})\nexport type Refusal = typeof Refusal.Type\n\nexport const ContentBlock = Schema.Union([InputText, InputImage, OutputText, Refusal])\nexport type ContentBlock = typeof ContentBlock.Type\n\nexport const Role = Schema.Literals([\"user\", \"assistant\", \"system\"])\nexport type Role = typeof Role.Type\n\n// ---------------------------------------------------------------------------\n// Provider passthrough - every Item type carries this opaque slot.\n// The framework never reads or interprets it; provider modules decode\n// their own data via their own typed readers (see e.g.\n// the `@effect-uai/responses` package).\n// ---------------------------------------------------------------------------\n\nconst ProviderData = Schema.optional(Schema.Unknown)\n\n// ---------------------------------------------------------------------------\n// Items\n// ---------------------------------------------------------------------------\n\nexport const Message = Schema.Struct({\n  type: Schema.Literal(\"message\"),\n  role: Role,\n  content: Schema.Array(ContentBlock),\n  providerData: ProviderData,\n})\nexport type Message = typeof Message.Type\n\nexport const FunctionCall = Schema.Struct({\n  type: Schema.Literal(\"function_call\"),\n  call_id: Schema.String,\n  name: Schema.String,\n  // JSON-encoded arguments string, mirroring OpenAI Responses API\n  arguments: Schema.String,\n  providerData: ProviderData,\n})\nexport type FunctionCall = typeof FunctionCall.Type\n\nexport const FunctionCallOutput = Schema.Struct({\n  type: Schema.Literal(\"function_call_output\"),\n  call_id: Schema.String,\n  output: Schema.String,\n  providerData: ProviderData,\n})\nexport type FunctionCallOutput = typeof FunctionCallOutput.Type\n\n/**\n * Reasoning item - top-level, mirrors OpenAI Responses API. Common shape\n * across providers covers `summary` (human-readable text) and `signature`\n * (opaque round-trip blob - Anthropic's signed thinking, OpenAI's\n * encrypted_content, etc.). Provider-specific fields go in `providerData`.\n */\nexport const Reasoning = Schema.Struct({\n  type: Schema.Literal(\"reasoning\"),\n  id: Schema.optional(Schema.String),\n  summary: Schema.optional(Schema.String),\n  signature: Schema.optional(Schema.String),\n  providerData: ProviderData,\n})\nexport type Reasoning = typeof Reasoning.Type\n\nexport const Item = Schema.Union([Message, FunctionCall, FunctionCallOutput, Reasoning])\nexport type Item = typeof Item.Type\n\n// ---------------------------------------------------------------------------\n// Type guards\n// ---------------------------------------------------------------------------\n\nexport const isInputText = Schema.is(InputText)\nexport const isInputImage = Schema.is(InputImage)\nexport const isOutputText = Schema.is(OutputText)\nexport const isRefusal = Schema.is(Refusal)\n\nexport const isMessage = Schema.is(Message)\nexport const isFunctionCall = Schema.is(FunctionCall)\nexport const isFunctionCallOutput = Schema.is(FunctionCallOutput)\nexport const isReasoning = Schema.is(Reasoning)\n\n// ---------------------------------------------------------------------------\n// Usage and stop reason\n// ---------------------------------------------------------------------------\n\nexport const InputTokensDetails = Schema.Struct({\n  cached_tokens: Schema.optional(Schema.Number),\n})\nexport type InputTokensDetails = typeof InputTokensDetails.Type\n\nexport const OutputTokensDetails = Schema.Struct({\n  reasoning_tokens: Schema.optional(Schema.Number),\n})\nexport type OutputTokensDetails = typeof OutputTokensDetails.Type\n\nexport const Usage = Schema.Struct({\n  input_tokens: Schema.optional(Schema.Number),\n  output_tokens: Schema.optional(Schema.Number),\n  total_tokens: Schema.optional(Schema.Number),\n  input_tokens_details: Schema.optional(InputTokensDetails),\n  output_tokens_details: Schema.optional(OutputTokensDetails),\n})\nexport type Usage = typeof Usage.Type\n\nexport const StopReason = Schema.Literals([\n  \"stop\",\n  \"tool_calls\",\n  \"max_tokens\",\n  \"refusal\",\n  /** Provider-side safety classifier flagged the output. */\n  \"content_filter\",\n  /** Server-enforced cap on tool calls per turn was hit. */\n  \"max_tool_calls\",\n])\nexport type StopReason = typeof StopReason.Type\n\n// ---------------------------------------------------------------------------\n// Helper constructors\n// ---------------------------------------------------------------------------\n\nexport const userText = (text: string): Message => ({\n  type: \"message\",\n  role: \"user\",\n  content: [{ type: \"input_text\", text }],\n})\n\nexport const systemText = (text: string): Message => ({\n  type: \"message\",\n  role: \"system\",\n  content: [{ type: \"input_text\", text }],\n})\n\nexport const assistantText = (text: string): Message => ({\n  type: \"message\",\n  role: \"assistant\",\n  content: [{ type: \"output_text\", text }],\n})\n\nexport const functionCallOutput = (call_id: string, output: string): FunctionCallOutput => ({\n  type: \"function_call_output\",\n  call_id,\n  output,\n})\n"],"mappings":"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"}
+{"version":3,"file":"Items.mjs","names":[],"sources":["../../src/domain/Items.ts"],"sourcesContent":["import { Schema } from \"effect\"\nimport { ImageSource } from \"./Image.js\"\n\n// ---------------------------------------------------------------------------\n// Content blocks (inside Message.content)\n// ---------------------------------------------------------------------------\n\nexport const InputText = Schema.Struct({\n  type: Schema.Literal(\"input_text\"),\n  text: Schema.String,\n})\nexport type InputText = typeof InputText.Type\n\n/**\n * User-provided image content block. Pair with `InputText` inside a\n * `Message.content` array to ask \"what's in this image?\" style questions.\n *\n * `source` is the cross-modality `ImageSource` from `domain/Image.ts` -\n * url, base64, or raw bytes. Provider codecs encode bytes to whatever\n * wire format the provider wants.\n */\nexport const InputImage = Schema.Struct({\n  type: Schema.Literal(\"input_image\"),\n  source: ImageSource,\n})\nexport type InputImage = typeof InputImage.Type\n\n// ---------------------------------------------------------------------------\n// Annotations - source / citation pointers attached to `output_text` blocks.\n// Mirrors OpenAI Responses API; other providers can omit or map onto these\n// shapes.\n// ---------------------------------------------------------------------------\n\nexport const UrlCitation = Schema.Struct({\n  type: Schema.Literal(\"url_citation\"),\n  url: Schema.String,\n  start_index: Schema.Number,\n  end_index: Schema.Number,\n  title: Schema.String,\n})\nexport type UrlCitation = typeof UrlCitation.Type\n\nexport const FileCitation = Schema.Struct({\n  type: Schema.Literal(\"file_citation\"),\n  file_id: Schema.String,\n  index: Schema.Number,\n})\nexport type FileCitation = typeof FileCitation.Type\n\nexport const ContainerFileCitation = Schema.Struct({\n  type: Schema.Literal(\"container_file_citation\"),\n  container_id: Schema.String,\n  file_id: Schema.String,\n  start_index: Schema.Number,\n  end_index: Schema.Number,\n})\nexport type ContainerFileCitation = typeof ContainerFileCitation.Type\n\nexport const FilePath = Schema.Struct({\n  type: Schema.Literal(\"file_path\"),\n  file_id: Schema.String,\n  index: Schema.Number,\n})\nexport type FilePath = typeof FilePath.Type\n\nexport const Annotation = Schema.Union([UrlCitation, FileCitation, ContainerFileCitation, FilePath])\nexport type Annotation = typeof Annotation.Type\n\nexport const isUrlCitation = Schema.is(UrlCitation)\nexport const isFileCitation = Schema.is(FileCitation)\nexport const isContainerFileCitation = Schema.is(ContainerFileCitation)\nexport const isFilePath = Schema.is(FilePath)\n\nexport const OutputText = Schema.Struct({\n  type: Schema.Literal(\"output_text\"),\n  text: Schema.String,\n  annotations: Schema.optional(Schema.Array(Annotation)),\n})\nexport type OutputText = typeof OutputText.Type\n\n/**\n * Model-emitted refusal. Distinct from `output_text`: the model declined\n * to answer rather than producing normal output. Pair with\n * `stop_reason: \"refusal\"` on the surrounding `Turn`. Streamed via the\n * `RefusalDelta` `TurnEvent`.\n */\nexport const Refusal = Schema.Struct({\n  type: Schema.Literal(\"refusal\"),\n  text: Schema.String,\n})\nexport type Refusal = typeof Refusal.Type\n\nexport const ContentBlock = Schema.Union([InputText, InputImage, OutputText, Refusal])\nexport type ContentBlock = typeof ContentBlock.Type\n\nexport const Role = Schema.Literals([\"user\", \"assistant\", \"system\"])\nexport type Role = typeof Role.Type\n\n// ---------------------------------------------------------------------------\n// Provider passthrough - every Item type carries this opaque slot.\n// The framework never reads or interprets it; provider modules decode\n// their own data via their own typed readers (see e.g.\n// the `@effect-uai/responses` package).\n// ---------------------------------------------------------------------------\n\nconst ProviderData = Schema.optional(Schema.Unknown)\n\n// ---------------------------------------------------------------------------\n// Items\n// ---------------------------------------------------------------------------\n\nexport const Message = Schema.Struct({\n  type: Schema.Literal(\"message\"),\n  role: Role,\n  content: Schema.Array(ContentBlock),\n  providerData: ProviderData,\n})\nexport type Message = typeof Message.Type\n\nexport const ToolCall = Schema.Struct({\n  type: Schema.Literal(\"function_call\"),\n  call_id: Schema.String,\n  name: Schema.String,\n  // JSON-encoded arguments string, mirroring OpenAI Responses API\n  arguments: Schema.String,\n  providerData: ProviderData,\n})\nexport type ToolCall = typeof ToolCall.Type\n\nexport const ToolCallOutput = Schema.Struct({\n  type: Schema.Literal(\"function_call_output\"),\n  call_id: Schema.String,\n  output: Schema.String,\n  providerData: ProviderData,\n})\nexport type ToolCallOutput = typeof ToolCallOutput.Type\n\n/**\n * Reasoning item - top-level, mirrors OpenAI Responses API. Common shape\n * across providers covers `summary` (human-readable text) and `signature`\n * (opaque round-trip blob - Anthropic's signed thinking, OpenAI's\n * encrypted_content, etc.). Provider-specific fields go in `providerData`.\n */\nexport const Reasoning = Schema.Struct({\n  type: Schema.Literal(\"reasoning\"),\n  id: Schema.optional(Schema.String),\n  summary: Schema.optional(Schema.String),\n  signature: Schema.optional(Schema.String),\n  providerData: ProviderData,\n})\nexport type Reasoning = typeof Reasoning.Type\n\nexport const HistoryItem = Schema.Union([Message, ToolCall, ToolCallOutput, Reasoning])\nexport type HistoryItem = typeof HistoryItem.Type\n\n// ---------------------------------------------------------------------------\n// Type guards\n// ---------------------------------------------------------------------------\n\nexport const isInputText = Schema.is(InputText)\nexport const isInputImage = Schema.is(InputImage)\nexport const isOutputText = Schema.is(OutputText)\nexport const isRefusal = Schema.is(Refusal)\n\nexport const isMessage = Schema.is(Message)\nexport const isToolCall = Schema.is(ToolCall)\nexport const isToolCallOutput = Schema.is(ToolCallOutput)\nexport const isReasoning = Schema.is(Reasoning)\n\n// ---------------------------------------------------------------------------\n// Usage and stop reason\n// ---------------------------------------------------------------------------\n\nexport const InputTokensDetails = Schema.Struct({\n  cached_tokens: Schema.optional(Schema.Number),\n})\nexport type InputTokensDetails = typeof InputTokensDetails.Type\n\nexport const OutputTokensDetails = Schema.Struct({\n  reasoning_tokens: Schema.optional(Schema.Number),\n})\nexport type OutputTokensDetails = typeof OutputTokensDetails.Type\n\nexport const Usage = Schema.Struct({\n  input_tokens: Schema.optional(Schema.Number),\n  output_tokens: Schema.optional(Schema.Number),\n  total_tokens: Schema.optional(Schema.Number),\n  input_tokens_details: Schema.optional(InputTokensDetails),\n  output_tokens_details: Schema.optional(OutputTokensDetails),\n})\nexport type Usage = typeof Usage.Type\n\nexport const StopReason = Schema.Literals([\n  \"stop\",\n  \"tool_calls\",\n  \"max_tokens\",\n  \"refusal\",\n  /** Provider-side safety classifier flagged the output. */\n  \"content_filter\",\n  /** Server-enforced cap on tool calls per turn was hit. */\n  \"max_tool_calls\",\n])\nexport type StopReason = typeof StopReason.Type\n\n// ---------------------------------------------------------------------------\n// Helper constructors\n// ---------------------------------------------------------------------------\n\nexport const userText = (text: string): Message => ({\n  type: \"message\",\n  role: \"user\",\n  content: [{ type: \"input_text\", text }],\n})\n\nexport const systemText = (text: string): Message => ({\n  type: \"message\",\n  role: \"system\",\n  content: [{ type: \"input_text\", text }],\n})\n\nexport const assistantText = (text: string): Message => ({\n  type: \"message\",\n  role: \"assistant\",\n  content: [{ type: \"output_text\", text }],\n})\n\nexport const toolCallOutput = (call_id: string, output: string): ToolCallOutput => ({\n  type: \"function_call_output\",\n  call_id,\n  output,\n})\n"],"mappings":"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"}

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

package/dist/domain/Music.mjs.map

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

package/dist/domain/Transcript.d.mts

@@ -1,3 +1,6 @@
+import { Duration } from "effect";
+
+//#region src/domain/Transcript.d.ts
 declare namespace Transcript_d_exports {
   export { TranscriptEvent, TranscriptResult, WordTimestamp, isAudioEvent, isError, isFinal, isMetadata, isPartial, isSpeechStarted, isUtteranceEnded };
 }
@@ -5,6 +8,9 @@ declare namespace Transcript_d_exports {
  * 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).
+ *
+ * `startSeconds` / `endSeconds` stay raw `number` offsets (not `Duration`)
+ * — they're positions in the audio, not durations.
  */
 type WordTimestamp = {
   readonly text: string;
@@ -21,8 +27,8 @@ type WordTimestamp = {
  */
 type TranscriptResult = {
   readonly text: string;
-  readonly languageCode?: string;
-  readonly durationSeconds?: number;
+  readonly languageCode?: string; /** Total audio duration. (Word offsets stay raw seconds on `WordTimestamp`.) */
+  readonly duration?: Duration.Duration;
   readonly words?: ReadonlyArray<WordTimestamp>;
   readonly raw?: unknown;
 };

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

@@ -1 +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"}
+{"version":3,"file":"Transcript.d.mts","names":[],"sources":["../../src/domain/Transcript.ts"],"mappings":";;;;;;;;;;;;;;KAUY,aAAA;EAAA,SACD,IAAA;EAAA,SACA,YAAA;EAAA,SACA,UAAA;EAAA,SACA,UAAA;EAAA,SACA,SAAA;EAAA,SACA,YAAA;AAAA;;;;;;KAQC,gBAAA;EAAA,SACD,IAAA;EAAA,SACA,YAAA,WAVA;EAAA,SAYA,QAAA,GAAW,QAAA,CAAS,QAAA;EAAA,SACpB,KAAA,GAAQ,aAAA,CAAc,aAAA;EAAA,SACtB,GAAA;AAAA;;;;;;;;;;;;;;;KAiBC,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.map

@@ -1 +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"}
+{"version":3,"file":"Transcript.mjs","names":[],"sources":["../../src/domain/Transcript.ts"],"sourcesContent":["import type { Duration } from \"effect\"\n\n/**\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 *\n * `startSeconds` / `endSeconds` stay raw `number` offsets (not `Duration`)\n * — they're positions in the audio, not durations.\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  /** Total audio duration. (Word offsets stay raw seconds on `WordTimestamp`.) */\n  readonly duration?: Duration.Duration\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":";;;;;;;;;;;AAuEA,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"}