@effect-uai/core 0.13.0 → 0.14.0

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

package/dist/domain/Items.mjs

@@ -13,6 +13,7 @@ var Items_exports = /* @__PURE__ */ __exportAll({
 	InputText: () => InputText,
 	InputTokensDetails: () => InputTokensDetails,
 	Message: () => Message,
+	OutputImage: () => OutputImage,
 	OutputText: () => OutputText,
 	OutputTokensDetails: () => OutputTokensDetails,
 	Reasoning: () => Reasoning,
@@ -30,6 +31,7 @@ var Items_exports = /* @__PURE__ */ __exportAll({
 	isInputImage: () => isInputImage,
 	isInputText: () => isInputText,
 	isMessage: () => isMessage,
+	isOutputImage: () => isOutputImage,
 	isOutputText: () => isOutputText,
 	isReasoning: () => isReasoning,
 	isRefusal: () => isRefusal,
@@ -106,6 +108,20 @@ const OutputText = Schema.Struct({
 	annotations: Schema.optional(Schema.Array(Annotation))
 });
 /**
+* Model-emitted image. The counterpart to {@link InputImage}: same
+* `ImageSource`, so an image the model drew goes straight back into the
+* next turn with no conversion.
+*
+* How the pixels were produced is not modelled here. A provider may draw
+* them itself, as an image part of the turn, or reach a hosted tool that
+* draws them; either way the fact is the same, and enabling it is
+* provider-specific.
+*/
+const OutputImage = Schema.Struct({
+	type: Schema.Literal("output_image"),
+	source: ImageSource
+});
+/**
 * Model-emitted refusal. Distinct from `output_text`: the model declined
 * to answer rather than producing normal output. Pair with
 * `stop_reason: "refusal"` on the surrounding `Turn`. Streamed via the
@@ -119,6 +135,7 @@ const ContentBlock = Schema.Union([
 	InputText,
 	InputImage,
 	OutputText,
+	OutputImage,
 	Refusal
 ]);
 const Role = Schema.Literals([
@@ -168,6 +185,7 @@ const HistoryItem = Schema.Union([
 const isInputText = Schema.is(InputText);
 const isInputImage = Schema.is(InputImage);
 const isOutputText = Schema.is(OutputText);
+const isOutputImage = Schema.is(OutputImage);
 const isRefusal = Schema.is(Refusal);
 const isMessage = Schema.is(Message);
 const isToolCall = Schema.is(ToolCall);
@@ -234,6 +252,6 @@ const toolCallOutput = (call_id, output) => ({
 	output
 });
 //#endregion
-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 };
+export { Annotation, ContainerFileCitation, ContentBlock, FileCitation, FilePath, HistoryItem, InputImage, InputText, InputTokensDetails, Message, OutputImage, OutputText, OutputTokensDetails, Reasoning, Refusal, Role, StopReason, ToolCall, ToolCallOutput, UrlCitation, Usage, assistantText, isContainerFileCitation, isFileCitation, isFilePath, isInputImage, isInputText, isMessage, isOutputImage, 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// Provider-agnostic: each provider populates the fields it has (character\n// span, quote, or positional marker) and omits the rest.\n// ---------------------------------------------------------------------------\n\n/**\n * A cited source. `url` + `title` are the only near-universal fields; the\n * link from a source to the answer text varies by provider, so it is optional\n * and expressed three ways: `start_index`/`end_index` (a character span into\n * the answer), `cited_text` (an exact quote of the source, when no offsets are\n * given), or `marker` (a positional `[n]` reference into an ordered list). A\n * provider populates whichever it has; a bare source list sets none.\n */\nexport const UrlCitation = Schema.Struct({\n  type: Schema.Literal(\"url_citation\"),\n  url: Schema.String,\n  title: Schema.String,\n  start_index: Schema.optional(Schema.Number),\n  end_index: Schema.optional(Schema.Number),\n  cited_text: Schema.optional(Schema.String),\n  marker: Schema.optional(Schema.Number),\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// The slot is shared, so a provider keys its data under its own name\n// (`{ responses: ... }`, `{ gemini: ... }`) and reads only that key. One item\n// can pass through several providers - falling back from one to another\n// leaves both keys on it - and a provider that finds no key of its own must\n// encode the item normally rather than assume the slot is its own.\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\n/**\n * Prompt-cache token breakdown. `cached_tokens` is cache reads;\n * `cache_write_tokens` is tokens written to the cache this turn (billed at a\n * premium). Field names mirror the OpenAI Responses usage shape.\n *\n * Whether these are a subset of `input_tokens` or a separate bucket is\n * provider-specific: OpenAI counts cache reads inside `input_tokens`, while\n * Anthropic reports `input_tokens` as post-breakpoint tokens only, with reads\n * and writes as separate additive buckets. Read a provider's usage in its own\n * terms; do not assume one relationship holds everywhere.\n */\nexport const InputTokensDetails = Schema.Struct({\n  cached_tokens: Schema.optional(Schema.Number),\n  cache_write_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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"}
+{"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// Provider-agnostic: each provider populates the fields it has (character\n// span, quote, or positional marker) and omits the rest.\n// ---------------------------------------------------------------------------\n\n/**\n * A cited source. `url` + `title` are the only near-universal fields; the\n * link from a source to the answer text varies by provider, so it is optional\n * and expressed three ways: `start_index`/`end_index` (a character span into\n * the answer), `cited_text` (an exact quote of the source, when no offsets are\n * given), or `marker` (a positional `[n]` reference into an ordered list). A\n * provider populates whichever it has; a bare source list sets none.\n */\nexport const UrlCitation = Schema.Struct({\n  type: Schema.Literal(\"url_citation\"),\n  url: Schema.String,\n  title: Schema.String,\n  start_index: Schema.optional(Schema.Number),\n  end_index: Schema.optional(Schema.Number),\n  cited_text: Schema.optional(Schema.String),\n  marker: Schema.optional(Schema.Number),\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 image. The counterpart to {@link InputImage}: same\n * `ImageSource`, so an image the model drew goes straight back into the\n * next turn with no conversion.\n *\n * How the pixels were produced is not modelled here. A provider may draw\n * them itself, as an image part of the turn, or reach a hosted tool that\n * draws them; either way the fact is the same, and enabling it is\n * provider-specific.\n */\nexport const OutputImage = Schema.Struct({\n  type: Schema.Literal(\"output_image\"),\n  source: ImageSource,\n})\nexport type OutputImage = typeof OutputImage.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, OutputImage, 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// The slot is shared, so a provider keys its data under its own name\n// (`{ responses: ... }`, `{ gemini: ... }`) and reads only that key. One item\n// can pass through several providers - falling back from one to another\n// leaves both keys on it - and a provider that finds no key of its own must\n// encode the item normally rather than assume the slot is its own.\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 isOutputImage = Schema.is(OutputImage)\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\n/**\n * Prompt-cache token breakdown. `cached_tokens` is cache reads;\n * `cache_write_tokens` is tokens written to the cache this turn (billed at a\n * premium). Field names mirror the OpenAI Responses usage shape.\n *\n * Whether these are a subset of `input_tokens` or a separate bucket is\n * provider-specific: OpenAI counts cache reads inside `input_tokens`, while\n * Anthropic reports `input_tokens` as post-breakpoint tokens only, with reads\n * and writes as separate additive buckets. Read a provider's usage in its own\n * terms; do not assume one relationship holds everywhere.\n */\nexport const InputTokensDetails = Schema.Struct({\n  cached_tokens: Schema.optional(Schema.Number),\n  cache_write_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/Media.d.mts

@@ -1,2 +1,2 @@
-import { c as isMediaUrl, i as MediaUrl, n as MediaBytes, o as isMediaBase64, r as MediaSource, s as isMediaBytes, t as MediaBase64 } from "../Media-DwgpifPD.mjs";
-export { MediaBase64, MediaBytes, MediaSource, MediaUrl, isMediaBase64, isMediaBytes, isMediaUrl };
+import { a as MediaSource, c as Watermark, d as isMediaUrl, f as parseAspectRatio, i as MediaBytes, l as isMediaBase64, n as Dimensions, o as MediaUrl, p as round16, r as MediaBase64, t as AspectRatio, u as isMediaBytes } from "../Media-BbX7BAaO.mjs";
+export { AspectRatio, Dimensions, MediaBase64, MediaBytes, MediaSource, MediaUrl, Watermark, isMediaBase64, isMediaBytes, isMediaUrl, parseAspectRatio, round16 };

package/dist/domain/Media.mjs

@@ -1,14 +1,63 @@
 import { n as __exportAll } from "../rolldown-runtime-EAsCxrDo.mjs";
+import { Result } from "effect";
 //#region src/domain/Media.ts
+/**
+* Cross-modality media reference shape.
+*
+* Every "media at rest" reference - image, audio, video, document - is one
+* of three variants:
+*
+*   - `url`    : a remote address (HTTP, GCS, etc.). The model fetches it.
+*               `mimeType` is optional - servers usually set Content-Type.
+*               Some providers (Gemini `fileData`) want it explicit.
+*
+*   - `base64` : an inline base64-encoded payload. Always carries a
+*               `mimeType` so the consumer knows how to decode.
+*
+*   - `bytes`  : raw `Uint8Array`. Provider layers normalize to base64 or
+*               multipart upload at the wire boundary - users don't need
+*               to encode themselves.
+*
+* Per-modality files (`Image.ts`, future `Audio.ts` / `Video.ts` /
+* `Document.ts`) instantiate this shape with their typed MIME union to
+* get autocomplete on common formats while keeping the structural type
+* uniform across modalities.
+*
+* Streaming media (live mic feed, streaming TTS playback) is *not*
+* modeled here. Streams carry effect parameters (`Stream<A, E, R>`) and
+* lifecycle (Scope, cancellation) that don't apply to media at rest. The
+* complementary type lives alongside this one as `*Stream` in each
+* per-modality file when those modalities land.
+*
+* Provider-uploaded asset references (OpenAI Files `file_id`, Gemini
+* Files API URIs, Anthropic file IDs) are also out of scope here -
+* they're a separate union (`FileRef`) added when needed.
+*/
 var Media_exports = /* @__PURE__ */ __exportAll({
 	isMediaBase64: () => isMediaBase64,
 	isMediaBytes: () => isMediaBytes,
-	isMediaUrl: () => isMediaUrl
+	isMediaUrl: () => isMediaUrl,
+	parseAspectRatio: () => parseAspectRatio,
+	round16: () => round16
 });
+const positive = (n) => n !== void 0 && Number.isFinite(n) && n > 0;
+/**
+* Read `"W:H"` as a pair. Fails when the ratio is not arithmetic, which
+* the `(string & {})` tail on {@link AspectRatio} lets through: a caller
+* asking for `"cinematic"` gets a message rather than NaN pixels. The
+* failure is a plain string so this file stays free of provider
+* vocabulary; each adapter wraps it in its own error.
+*/
+const parseAspectRatio = (ratio) => {
+	const [w, h, ...rest] = ratio.split(":").map(Number);
+	return positive(w) && positive(h) && rest.length === 0 ? Result.succeed([w, h]) : Result.fail(`aspectRatio "${ratio}" must read "W:H" with positive numbers.`);
+};
+/** Several image endpoints require both edges to be multiples of 16. */
+const round16 = (n) => Math.max(16, Math.round(n / 16) * 16);
 const isMediaUrl = (s) => s._tag === "url";
 const isMediaBase64 = (s) => s._tag === "base64";
 const isMediaBytes = (s) => s._tag === "bytes";
 //#endregion
-export { isMediaBase64, isMediaBytes, isMediaUrl, Media_exports as t };
+export { isMediaBase64, isMediaBytes, isMediaUrl, parseAspectRatio, round16, Media_exports as t };
 
 //# sourceMappingURL=Media.mjs.map

package/dist/domain/Media.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Media.mjs","names":[],"sources":["../../src/domain/Media.ts"],"sourcesContent":["/**\n * Cross-modality media reference shape.\n *\n * Every \"media at rest\" reference - image, audio, video, document - is one\n * of three variants:\n *\n *   - `url`    : a remote address (HTTP, GCS, etc.). The model fetches it.\n *               `mimeType` is optional - servers usually set Content-Type.\n *               Some providers (Gemini `fileData`) want it explicit.\n *\n *   - `base64` : an inline base64-encoded payload. Always carries a\n *               `mimeType` so the consumer knows how to decode.\n *\n *   - `bytes`  : raw `Uint8Array`. Provider layers normalize to base64 or\n *               multipart upload at the wire boundary - users don't need\n *               to encode themselves.\n *\n * Per-modality files (`Image.ts`, future `Audio.ts` / `Video.ts` /\n * `Document.ts`) instantiate this shape with their typed MIME union to\n * get autocomplete on common formats while keeping the structural type\n * uniform across modalities.\n *\n * Streaming media (live mic feed, streaming TTS playback) is *not*\n * modeled here. Streams carry effect parameters (`Stream<A, E, R>`) and\n * lifecycle (Scope, cancellation) that don't apply to media at rest. The\n * complementary type lives alongside this one as `*Stream` in each\n * per-modality file when those modalities land.\n *\n * Provider-uploaded asset references (OpenAI Files `file_id`, Gemini\n * Files API URIs, Anthropic file IDs) are also out of scope here -\n * they're a separate union (`FileRef`) added when needed.\n */\n\nexport type MediaUrl<M extends string = string> = {\n  readonly _tag: \"url\"\n  readonly url: string\n  readonly mimeType?: M\n}\n\nexport type MediaBase64<M extends string = string> = {\n  readonly _tag: \"base64\"\n  readonly base64: string\n  readonly mimeType: M\n}\n\nexport type MediaBytes<M extends string = string> = {\n  readonly _tag: \"bytes\"\n  readonly bytes: Uint8Array\n  readonly mimeType: M\n}\n\nexport type MediaSource<M extends string = string> = MediaUrl<M> | MediaBase64<M> | MediaBytes<M>\n\nexport const isMediaUrl = <M extends string>(s: MediaSource<M>): s is MediaUrl<M> =>\n  s._tag === \"url\"\n\nexport const isMediaBase64 = <M extends string>(s: MediaSource<M>): s is MediaBase64<M> =>\n  s._tag === \"base64\"\n\nexport const isMediaBytes = <M extends string>(s: MediaSource<M>): s is MediaBytes<M> =>\n  s._tag === \"bytes\"\n"],"mappings":";;;;;;;AAqDA,MAAa,cAAgC,MAC3C,EAAE,SAAS;AAEb,MAAa,iBAAmC,MAC9C,EAAE,SAAS;AAEb,MAAa,gBAAkC,MAC7C,EAAE,SAAS"}
+{"version":3,"file":"Media.mjs","names":[],"sources":["../../src/domain/Media.ts"],"sourcesContent":["/**\n * Cross-modality media reference shape.\n *\n * Every \"media at rest\" reference - image, audio, video, document - is one\n * of three variants:\n *\n *   - `url`    : a remote address (HTTP, GCS, etc.). The model fetches it.\n *               `mimeType` is optional - servers usually set Content-Type.\n *               Some providers (Gemini `fileData`) want it explicit.\n *\n *   - `base64` : an inline base64-encoded payload. Always carries a\n *               `mimeType` so the consumer knows how to decode.\n *\n *   - `bytes`  : raw `Uint8Array`. Provider layers normalize to base64 or\n *               multipart upload at the wire boundary - users don't need\n *               to encode themselves.\n *\n * Per-modality files (`Image.ts`, future `Audio.ts` / `Video.ts` /\n * `Document.ts`) instantiate this shape with their typed MIME union to\n * get autocomplete on common formats while keeping the structural type\n * uniform across modalities.\n *\n * Streaming media (live mic feed, streaming TTS playback) is *not*\n * modeled here. Streams carry effect parameters (`Stream<A, E, R>`) and\n * lifecycle (Scope, cancellation) that don't apply to media at rest. The\n * complementary type lives alongside this one as `*Stream` in each\n * per-modality file when those modalities land.\n *\n * Provider-uploaded asset references (OpenAI Files `file_id`, Gemini\n * Files API URIs, Anthropic file IDs) are also out of scope here -\n * they're a separate union (`FileRef`) added when needed.\n */\n\nimport { Result } from \"effect\"\n\n/**\n * Watermark kind a provider embedded in generated media. Shared across\n * modalities (audio, image). No provider exposes metadata beyond the\n * kind, so a bare literal union is enough.\n */\nexport type Watermark = \"synthid\" | \"c2pa\" | (string & {})\n\n/**\n * Requested shape of generated visual media, width to height. Shared by\n * image and video generation: the listed ratios are the ones providers\n * accept as literals, and the `(string & {})` tail keeps a\n * newly-supported ratio working without an SDK update. Which ratios a\n * given model accepts is not checked here; the provider rejects what it\n * cannot render and the adapter translates that error.\n *\n * Resolution is NOT shared: image models tier by short edge\n * (`ImageResolution`), video models by scan height. Each modality types\n * its own.\n */\nexport type AspectRatio =\n  | \"1:1\"\n  | \"2:3\"\n  | \"3:2\"\n  | \"3:4\"\n  | \"4:3\"\n  | \"4:5\"\n  | \"5:4\"\n  | \"9:16\"\n  | \"16:9\"\n  | \"21:9\"\n  | \"1:4\"\n  | \"4:1\"\n  | \"1:8\"\n  | \"8:1\"\n  | (string & {})\n\n/** Exact pixels, for adapters whose wire takes dimensions rather than a ratio. */\nexport type Dimensions = {\n  readonly width: number\n  readonly height: number\n}\n\nconst positive = (n: number | undefined): n is number =>\n  n !== undefined && Number.isFinite(n) && n > 0\n\n/**\n * Read `\"W:H\"` as a pair. Fails when the ratio is not arithmetic, which\n * the `(string & {})` tail on {@link AspectRatio} lets through: a caller\n * asking for `\"cinematic\"` gets a message rather than NaN pixels. The\n * failure is a plain string so this file stays free of provider\n * vocabulary; each adapter wraps it in its own error.\n */\nexport const parseAspectRatio = (\n  ratio: AspectRatio,\n): Result.Result<readonly [number, number], string> => {\n  const [w, h, ...rest] = ratio.split(\":\").map(Number)\n  return positive(w) && positive(h) && rest.length === 0\n    ? Result.succeed([w, h] as const)\n    : Result.fail(`aspectRatio \"${ratio}\" must read \"W:H\" with positive numbers.`)\n}\n\n/** Several image endpoints require both edges to be multiples of 16. */\nexport const round16 = (n: number): number => Math.max(16, Math.round(n / 16) * 16)\n\nexport type MediaUrl<M extends string = string> = {\n  readonly _tag: \"url\"\n  readonly url: string\n  readonly mimeType?: M\n}\n\nexport type MediaBase64<M extends string = string> = {\n  readonly _tag: \"base64\"\n  readonly base64: string\n  readonly mimeType: M\n}\n\nexport type MediaBytes<M extends string = string> = {\n  readonly _tag: \"bytes\"\n  readonly bytes: Uint8Array\n  readonly mimeType: M\n}\n\nexport type MediaSource<M extends string = string> = MediaUrl<M> | MediaBase64<M> | MediaBytes<M>\n\nexport const isMediaUrl = <M extends string>(s: MediaSource<M>): s is MediaUrl<M> =>\n  s._tag === \"url\"\n\nexport const isMediaBase64 = <M extends string>(s: MediaSource<M>): s is MediaBase64<M> =>\n  s._tag === \"base64\"\n\nexport const isMediaBytes = <M extends string>(s: MediaSource<M>): s is MediaBytes<M> =>\n  s._tag === \"bytes\"\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6EA,MAAM,YAAY,MAChB,MAAM,KAAA,KAAa,OAAO,SAAS,CAAC,KAAK,IAAI;;;;;;;;AAS/C,MAAa,oBACX,UACqD;CACrD,MAAM,CAAC,GAAG,GAAG,GAAG,QAAQ,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,MAAM;CACnD,OAAO,SAAS,CAAC,KAAK,SAAS,CAAC,KAAK,KAAK,WAAW,IACjD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAU,IAC9B,OAAO,KAAK,gBAAgB,MAAM,yCAAyC;AACjF;;AAGA,MAAa,WAAW,MAAsB,KAAK,IAAI,IAAI,KAAK,MAAM,IAAI,EAAE,IAAI,EAAE;AAsBlF,MAAa,cAAgC,MAC3C,EAAE,SAAS;AAEb,MAAa,iBAAmC,MAC9C,EAAE,SAAS;AAEb,MAAa,gBAAkC,MAC7C,EAAE,SAAS"}

package/dist/domain/Music.d.mts

@@ -1,4 +1,5 @@
-import { n as AudioChunk, r as AudioFormat, t as AudioBlob } from "../Audio-60lKKHxS.mjs";
+import { c as Watermark } from "../Media-BbX7BAaO.mjs";
+import { n as AudioChunk, r as AudioFormat, t as AudioBlob } from "../Audio-_nGR4V0X.mjs";
 import { Duration } from "effect";
 declare namespace Music_d_exports {
   export { CommonGenerateMusicRequest, CommonStreamGenerateMusicRequest, GenerateResult, MusicResult, MusicSection, MusicSessionControl, MusicSessionInput, MusicStreamEvent, Watermark, WeightedPrompt, audioEvent, controlInput, filteredPromptEvent, isAudioEvent, isControlInput, isFilteredPromptEvent, isPromptsInput, isWarningEvent, promptsInput, singleVariant, warningEvent };
@@ -86,12 +87,6 @@ type MusicSessionInput = {
 };
 declare const promptsInput: (prompts: ReadonlyArray<WeightedPrompt>) => MusicSessionInput;
 declare const controlInput: (action: MusicSessionControl) => MusicSessionInput;
-/**
- * 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 Watermark = "synthid" | "c2pa" | (string & {});
 /**
  * Labelled section with absolute timing. Populated when the provider
  * returns structured section metadata (Lyria text part, ElevenLabs
@@ -178,5 +173,5 @@ declare const isFilteredPromptEvent: (e: MusicStreamEvent) => e is MusicStreamEv
  */
 declare const singleVariant: (result: MusicResult) => GenerateResult;
 //#endregion
-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 };
+export { CommonGenerateMusicRequest, CommonStreamGenerateMusicRequest, GenerateResult, MusicResult, MusicSection, MusicSessionControl, MusicSessionInput, MusicStreamEvent, type 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":";;;;;;;;;;;KASY;WACD;;WAEA;;;;;;;;;;;;;KAcC;;WAED;;WAEA;;;;;;;;;WASA;;WAEA,WAAW,SAAS;;;;;;;WAOpB;;WAEA,eAAe;;;;;;KAOd,mCAAmC;;;;;;;;KASnC;;;;;;;;;;;;;;KAeA;WACG;WAA0B,SAAS,cAAc;;WACjD;WAA0B,QAAQ;;cAEpC,eAAY,SAAa,cAAc,oBAAkB;cAKzD,eAAY,QAAY,wBAAsB;;;;;;KAU/C;;;;;;KAOA;WACD;WACA;WACA;;;;;;;KAQC;WACD,OAAO;;;;;;WAMP;;WAEA;;WAEA;;WAEA,WAAW,cAAc;;WAEzB,YAAY;;;;;;;;KASX;WACD,SAAS;WACT,UAAU,cAAc;;;;;;;;KASvB;WACG;WAAwB,OAAO;;WAC/B;WAA0B;;WAC1B;WAAiC;WAAyB;;cAE5D,iBAAc,GACtB,sBACF,KAAK;EAAsB;;cACjB,iBAAc,GACtB,sBACF,KAAK;EAAsB;;cAEjB,aAAU,OAAW,eAAa;cAClC,eAAY,oBAAsB;cAIlC,sBAAmB,gBAAkB,mBAAmB;cAMxD,eAAY,GAAO,qBAAmB,KAAK;EAAqB;;cAEhE,iBAAc,GAAO,qBAAmB,KAAK;EAAqB;;cAElE,wBAAqB,GAC7B,qBACF,KAAK;EAAqB;;;;;;;;;cAShB,gBAAa,QAAY,gBAAc"}
+{"version":3,"file":"Music.d.mts","names":[],"sources":["../../src/domain/Music.ts"],"mappings":";;;;;;;;;;;;KAUY;WACD;;WAEA;;;;;;;;;;;;;KAcC;;WAED;;WAEA;;;;;;;;;WASA;;WAEA,WAAW,SAAS;;;;;;;WAOpB;;WAEA,eAAe;;;;;;KAOd,mCAAmC;;;;;;;;KASnC;;;;;;;;;;;;;;KAeA;WACG;WAA0B,SAAS,cAAc;;WACjD;WAA0B,QAAQ;;cAEpC,eAAY,SAAa,cAAc,oBAAkB;cAKzD,eAAY,QAAY,wBAAsB;;;;;;KAiB/C;WACD;WACA;WACA;;;;;;;KAQC;WACD,OAAO;;;;;;WAMP;;WAEA;;WAEA;;WAEA,WAAW,cAAc;;WAEzB,YAAY;;;;;;;;KASX;WACD,SAAS;WACT,UAAU,cAAc;;;;;;;;KASvB;WACG;WAAwB,OAAO;;WAC/B;WAA0B;;WAC1B;WAAiC;WAAyB;;cAE5D,iBAAc,GACtB,sBACF,KAAK;EAAsB;;cACjB,iBAAc,GACtB,sBACF,KAAK;EAAsB;;cAEjB,aAAU,OAAW,eAAa;cAClC,eAAY,oBAAsB;cAIlC,sBAAmB,gBAAkB,mBAAmB;cAMxD,eAAY,GAAO,qBAAmB,KAAK;EAAqB;;cAEhE,iBAAc,GAAO,qBAAmB,KAAK;EAAqB;;cAElE,wBAAqB,GAC7B,qBACF,KAAK;EAAqB;;;;;;;;;cAShB,gBAAa,QAAY,gBAAc"}

package/dist/domain/Music.mjs.map

@@ -1 +1 @@
-{"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;AACF;AAEA,MAAa,gBAAgB,YAAoD;CAC/E,MAAM;CACN;AACF;AAiEA,MAAa,kBACX,MACiD,EAAE,SAAS;AAC9D,MAAa,kBACX,MACiD,EAAE,SAAS;AAE9D,MAAa,cAAc,WAAyC;CAAE,MAAM;CAAS;AAAM;AAC3F,MAAa,gBAAgB,aAAuC;CAClE,MAAM;CACN;AACF;AACA,MAAa,uBAAuB,QAAgB,YAAsC;CACxF,MAAM;CACN;CACA;AACF;AAEA,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,MAAM;AACnB"}
+{"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\"\nimport type { Watermark } from \"./Media.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. Lives in `Media.ts` since image providers\n * report the same kinds; re-exported here unchanged.\n */\nexport type { Watermark } from \"./Media.js\"\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":";;;;;;;;;;;;;;;AAsFA,MAAa,gBAAgB,aAA+D;CAC1F,MAAM;CACN;AACF;AAEA,MAAa,gBAAgB,YAAoD;CAC/E,MAAM;CACN;AACF;AAiEA,MAAa,kBACX,MACiD,EAAE,SAAS;AAC9D,MAAa,kBACX,MACiD,EAAE,SAAS;AAE9D,MAAa,cAAc,WAAyC;CAAE,MAAM;CAAS;AAAM;AAC3F,MAAa,gBAAgB,aAAuC;CAClE,MAAM;CACN;AACF;AACA,MAAa,uBAAuB,QAAgB,YAAsC;CACxF,MAAM;CACN;CACA;AACF;AAEA,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,MAAM;AACnB"}

package/dist/domain/Research.d.mts

@@ -1,4 +1,4 @@
-import { o as HistoryItem } from "../Items-SfUabNuB.mjs";
+import { o as HistoryItem } from "../Items-C7MyrYPX.mjs";
 import { JobRef, JobState } from "../job/Job.mjs";
 import { Turn } from "./Turn.mjs";
 declare namespace Research_d_exports {

package/dist/domain/Turn.d.mts

@@ -1,9 +1,9 @@
-import { i as ImageSource } from "../Image-BK8-4H6s.mjs";
-import { d as Message, m as Reasoning, o as HistoryItem, t as Annotation, v as ToolCall, x as Usage, y as ToolCallOutput } from "../Items-SfUabNuB.mjs";
+import { o as ImageSource } from "../Image-Cv6iBLTy.mjs";
+import { S as Usage, b as ToolCallOutput, d as Message, h as Reasoning, o as HistoryItem, t as Annotation, y as ToolCall } from "../Items-C7MyrYPX.mjs";
 import { i as StructuredFormat, n as JsonParseError, r as StructuredDecodeError } from "../StructuredFormat-BlZhyOsi.mjs";
 import { Data, Effect, Schema, Stream } from "effect";
 declare namespace Turn_d_exports {
-  export { InteractionEvent, RefusalRejected, Turn, TurnEvent, appendToHistory, assistantMessages, assistantText, assistantTexts, citations, decodeStructured, getToolCalls, isTurnComplete, reasonings, textDeltas };
+  export { InteractionEvent, RefusalRejected, Turn, TurnEvent, appendToHistory, assistantImages, assistantMessages, assistantText, assistantTexts, citations, decodeStructured, getToolCalls, imagesAsInput, isTurnComplete, reasonings, textDeltas };
 }
 /**
  * The result of a single LLM generation. A turn produces zero or more items
@@ -46,6 +46,9 @@ declare const Turn: Schema.Struct<{
         readonly file_id: Schema.String;
         readonly index: Schema.Number;
       }>]>>>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"output_image">;
+      readonly source: Schema.Schema<ImageSource>;
     }>, Schema.Struct<{
       readonly type: Schema.Literal<"refusal">;
       readonly text: Schema.String;
@@ -106,6 +109,12 @@ type Turn = typeof Turn.Type;
  * `WebSearchCall`: lifecycle of a provider-executed web search within the
  * turn. Fires only when the turn grounds against search; absent otherwise.
  *
+ * `ImageOutput`: an image the model produced, whether it drew it as part
+ * of its turn or reached a hosted tool for it. `partialIndex` marks a
+ * preview frame from providers that stream them; the finished image
+ * arrives without one and is also on `TurnComplete.turn` as an
+ * `OutputImage` block.
+ *
  * `CitationAdded`: a citation attached to the answer, emitted incrementally
  * where the provider streams citations. Providers that bundle citations emit
  * none of these; their citations still arrive on `TurnComplete.turn`
@@ -138,6 +147,11 @@ type TurnEvent = Data.TaggedEnum<{
     readonly query?: string;
     readonly action?: "search" | "open_page" | "find_in_page";
   };
+  ImageOutput: {
+    readonly image: ImageSource;
+    /** Set only on a preview frame, counting from 0. Absent means finished. */
+    readonly partialIndex?: number;
+  };
   CitationAdded: {
     readonly annotation: Annotation;
   };
@@ -146,11 +160,17 @@ type TurnEvent = Data.TaggedEnum<{
   };
 }>;
 declare const TurnEvent: {
-  readonly $is: <Tag extends "CitationAdded" | "ReasoningDelta" | "RefusalDelta" | "TextDelta" | "ToolCallArgsDelta" | "ToolCallStart" | "TurnComplete" | "UsageUpdate" | "WebSearchCall">(tag: Tag) => (u: unknown) => u is Extract<{
+  readonly $is: <Tag extends "CitationAdded" | "ImageOutput" | "ReasoningDelta" | "RefusalDelta" | "TextDelta" | "ToolCallArgsDelta" | "ToolCallStart" | "TurnComplete" | "UsageUpdate" | "WebSearchCall">(tag: Tag) => (u: unknown) => u is Extract<{
     readonly _tag: "CitationAdded";
     readonly annotation: Annotation;
   }, {
     readonly _tag: Tag;
+  }> | Extract<{
+    readonly _tag: "ImageOutput";
+    readonly image: ImageSource;
+    readonly partialIndex?: number;
+  }, {
+    readonly _tag: Tag;
   }> | Extract<{
     readonly _tag: "ReasoningDelta";
     readonly text: string;
@@ -198,9 +218,13 @@ declare const TurnEvent: {
     readonly _tag: Tag;
   }>;
   readonly $match: {
-    <Cases extends { readonly [Tag in "CitationAdded" | "ReasoningDelta" | "RefusalDelta" | "TextDelta" | "ToolCallArgsDelta" | "ToolCallStart" | "TurnComplete" | "UsageUpdate" | "WebSearchCall"]: (args: Extract<{
+    <Cases extends { readonly [Tag in "CitationAdded" | "ImageOutput" | "ReasoningDelta" | "RefusalDelta" | "TextDelta" | "ToolCallArgsDelta" | "ToolCallStart" | "TurnComplete" | "UsageUpdate" | "WebSearchCall"]: (args: Extract<{
       readonly _tag: "CitationAdded";
       readonly annotation: Annotation;
+    } | {
+      readonly _tag: "ImageOutput";
+      readonly image: ImageSource;
+      readonly partialIndex?: number;
     } | {
       readonly _tag: "ReasoningDelta";
       readonly text: string;
@@ -235,6 +259,10 @@ declare const TurnEvent: {
     }>) => any; }>(cases: Cases): (value: {
       readonly _tag: "CitationAdded";
       readonly annotation: Annotation;
+    } | {
+      readonly _tag: "ImageOutput";
+      readonly image: ImageSource;
+      readonly partialIndex?: number;
     } | {
       readonly _tag: "ReasoningDelta";
       readonly text: string;
@@ -264,10 +292,14 @@ declare const TurnEvent: {
       readonly status: "started" | "searching" | "completed";
       readonly query?: string;
       readonly action?: "search" | "open_page" | "find_in_page";
-    }) => import("effect/Unify").Unify<ReturnType<Cases["CitationAdded" | "ReasoningDelta" | "RefusalDelta" | "TextDelta" | "ToolCallArgsDelta" | "ToolCallStart" | "TurnComplete" | "UsageUpdate" | "WebSearchCall"]>>;
-    <Cases extends { readonly [Tag in "CitationAdded" | "ReasoningDelta" | "RefusalDelta" | "TextDelta" | "ToolCallArgsDelta" | "ToolCallStart" | "TurnComplete" | "UsageUpdate" | "WebSearchCall"]: (args: Extract<{
+    }) => import("effect/Unify").Unify<ReturnType<Cases["CitationAdded" | "ImageOutput" | "ReasoningDelta" | "RefusalDelta" | "TextDelta" | "ToolCallArgsDelta" | "ToolCallStart" | "TurnComplete" | "UsageUpdate" | "WebSearchCall"]>>;
+    <Cases extends { readonly [Tag in "CitationAdded" | "ImageOutput" | "ReasoningDelta" | "RefusalDelta" | "TextDelta" | "ToolCallArgsDelta" | "ToolCallStart" | "TurnComplete" | "UsageUpdate" | "WebSearchCall"]: (args: Extract<{
       readonly _tag: "CitationAdded";
       readonly annotation: Annotation;
+    } | {
+      readonly _tag: "ImageOutput";
+      readonly image: ImageSource;
+      readonly partialIndex?: number;
     } | {
       readonly _tag: "ReasoningDelta";
       readonly text: string;
@@ -302,6 +334,10 @@ declare const TurnEvent: {
     }>) => any; }>(value: {
       readonly _tag: "CitationAdded";
       readonly annotation: Annotation;
+    } | {
+      readonly _tag: "ImageOutput";
+      readonly image: ImageSource;
+      readonly partialIndex?: number;
     } | {
       readonly _tag: "ReasoningDelta";
       readonly text: string;
@@ -331,12 +367,17 @@ declare const TurnEvent: {
       readonly status: "started" | "searching" | "completed";
       readonly query?: string;
       readonly action?: "search" | "open_page" | "find_in_page";
-    }, cases: Cases): import("effect/Unify").Unify<ReturnType<Cases["CitationAdded" | "ReasoningDelta" | "RefusalDelta" | "TextDelta" | "ToolCallArgsDelta" | "ToolCallStart" | "TurnComplete" | "UsageUpdate" | "WebSearchCall"]>>;
+    }, cases: Cases): import("effect/Unify").Unify<ReturnType<Cases["CitationAdded" | "ImageOutput" | "ReasoningDelta" | "RefusalDelta" | "TextDelta" | "ToolCallArgsDelta" | "ToolCallStart" | "TurnComplete" | "UsageUpdate" | "WebSearchCall"]>>;
   };
   readonly CitationAdded: Data.TaggedEnum.ConstructorFrom<{
     readonly _tag: "CitationAdded";
     readonly annotation: Annotation;
   }, "_tag">;
+  readonly ImageOutput: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "ImageOutput";
+    readonly image: ImageSource;
+    readonly partialIndex?: number;
+  }, "_tag">;
   readonly ReasoningDelta: Data.TaggedEnum.ConstructorFrom<{
     readonly _tag: "ReasoningDelta";
     readonly text: string;
@@ -403,6 +444,29 @@ declare const assistantTexts: (turn: Turn) => ReadonlyArray<string>;
  * that want one concatenated string.
  */
 declare const assistantText: (turn: Turn) => string;
+/**
+ * Every image the model produced this turn, in order. The counterpart to
+ * {@link assistantTexts}: each is an `ImageSource`, so it can be written
+ * to disk or passed straight back as an `input_image` on the next turn.
+ */
+declare const assistantImages: (turn: Turn) => ReadonlyArray<ImageSource>;
+/**
+ * Rewrite assistant `output_image` blocks into a user message carrying
+ * the same pictures as `input_image`, so another provider can look at
+ * what this one drew.
+ *
+ * Only Gemini's wire has an assistant-role image part; every other
+ * adapter omits an `output_image` on replay and says so. Moving it to a
+ * user message is the conversion that makes it portable, and it is
+ * yours to make rather than the adapter's: "the assistant drew this" and
+ * "here is an image, look at it" are different claims, and silently
+ * swapping one for the other behind your back would be the wrong kind of
+ * helpful.
+ *
+ * Items with no images pass through untouched, and the new user message
+ * follows the assistant message it came from.
+ */
+declare const imagesAsInput: (history: ReadonlyArray<HistoryItem>) => ReadonlyArray<HistoryItem>;
 /**
  * Every citation annotation attached to the turn's assistant `output_text`
  * blocks, in order. The flat view of a grounded turn's sources, whether the
@@ -446,5 +510,5 @@ declare class RefusalRejected extends RefusalRejected_base<{
  */
 declare const decodeStructured: <A>(turn: Turn, format: StructuredFormat<A>) => Effect.Effect<A, RefusalRejected | JsonParseError | StructuredDecodeError>;
 //#endregion
-export { InteractionEvent, RefusalRejected, Turn, TurnEvent, appendToHistory, assistantMessages, assistantText, assistantTexts, citations, decodeStructured, getToolCalls, isTurnComplete, reasonings, Turn_d_exports as t, textDeltas };
+export { InteractionEvent, RefusalRejected, Turn, TurnEvent, appendToHistory, assistantImages, assistantMessages, assistantText, assistantTexts, citations, decodeStructured, getToolCalls, imagesAsInput, isTurnComplete, reasonings, Turn_d_exports as t, textDeltas };
 //# sourceMappingURL=Turn.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Turn.d.mts","names":[],"sources":["../../src/domain/Turn.ts"],"mappings":";;;;;;;;;;;;cAsBa,MAAI,OAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAKL,cAAc,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA6BnB,YAAY,KAAK;EAC3B;aAAsB;;EACtB;aAA2B;aAAuB;;EAClD;aAAyB;;EACzB;aAA0B;aAA0B;;EACpD;aAA8B;aAA0B;;EACxD;aAAwB,OAAO;;EAC/B;aACW;aACA;aACA;;EAEX;aAA0B,YAAY;;EACtC;aAAyB,MAAM;;;cAGpB;;;aAJ2B,YAAA;;;;;aAVL;aAAuB;;;;;aACzB;;;;;aAFH;;;;;aAIW;aAAwB;;;;;aAD5B;aAAuB;;;;;aAS3B,MAAA;;;;;aAPA,OAAA;;;;;aAEZ;aACA;aACC;;;;;;;eAEkB,YAAA;;;eAVL;eAAuB;;;eACzB;;;eAFH;;;eAIW;eAAwB;;;eAD5B;eAAuB;;;eAS3B,MAAA;;;eAPA,OAAA;;;eAEZ;eACA;eACC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAEkB,YAAA;;;eAVL;eAAuB;;;eACzB;;;eAFH;;;eAIW;eAAwB;;;eAD5B;eAAuB;;;eAS3B,MAAA;;;eAPA,OAAA;;;eAEZ;eACA;eACC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAEkB,YAAA;;;;aAVL;aAAuB;;;;aACzB;;;;aAFH;;;;aAIW;aAAwB;;;;aAD5B;aAAuB;;;;aAS3B,MAAA;;;;aAPA,OAAA;;;;aAEZ;aACA;aACC;;;;;;;;;KAcV,mBAAmB,YAAY;cAE9B,iBAAc,eAAA;;WAbM,MAAA;;cAepB,eAAY,MAAU,SAAO,cAAc;cAE3C,aAAU,MAAU,SAAO,cAAc;cAEzC,oBAAiB,MAAU,SAAO,cAAc;;;;;;;;cAUhD,iBAAc,MAAU,SAAO;;;;;;cAW/B,gBAAa,MAAU;;;;;;cAOvB,YAAS,MAAU,SAAO,cAAc;;;;;;cAWxC,kBAAmB;WAAqB,SAAS,cAAc;GAAc,OACjF,GAAC,MACF,MAAI,QACH,cAAc,iBACpB;;;;;;cAcU,aAAc,GAAG,GAAC,MACvB,OAAO,OAAO,WAAW,GAAG,OACjC,OAAO,eAAe,GAAG;;;;;;;;;cAcf,wBAAwB;WAC1B,MAAM;;;;;;;;;;;;cAyBJ,mBAAoB,GAAC,MAC1B,MAAI,QACF,iBAAkC,OACzC,OAAO,OACR,GACA,kBAAkB,iBAAkC"}
+{"version":3,"file":"Turn.d.mts","names":[],"sources":["../../src/domain/Turn.ts"],"mappings":";;;;;;;;;;;;cAwBa,MAAI,OAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAKL,cAAc,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAmCnB,YAAY,KAAK;EAC3B;aAAsB;;EACtB;aAA2B;aAAuB;;EAClD;aAAyB;;EACzB;aAA0B;aAA0B;;EACpD;aAA8B;aAA0B;;EACxD;aAAwB,OAAO;;EAC/B;aACW;aACA;aACA;;EAEX;aACW,OAAO;;aAEP;;EAEX;aAA0B,YAAY;;EACtC;aAAyB,MAAM;;;cAGpB;;;aAJ2B,YAAA;;;;;aAJpB,OAAA;aAEQ;;;;;aAbO;aAAuB;;;;;aACzB;;;;;aAFH;;;;;aAIW;aAAwB;;;;;aAD5B;aAAuB;;;;;aAc3B,MAAA;;;;;aAZA,OAAA;;;;;aAEZ;aACA;aACC;;;;;;;eAOkB,YAAA;;;eAJpB,OAAA;eAEQ;;;eAbO;eAAuB;;;eACzB;;;eAFH;;;eAIW;eAAwB;;;eAD5B;eAAuB;;;eAc3B,MAAA;;;eAZA,OAAA;;;eAEZ;eACA;eACC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAOkB,YAAA;;;eAJpB,OAAA;eAEQ;;;eAbO;eAAuB;;;eACzB;;;eAFH;;;eAIW;eAAwB;;;eAD5B;eAAuB;;;eAc3B,MAAA;;;eAZA,OAAA;;;eAEZ;eACA;eACC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAOkB,YAAA;;;;aAJpB,OAAA;aAEQ;;;;aAbO;aAAuB;;;;aACzB;;;;aAFH;;;;aAIW;aAAwB;;;;aAD5B;aAAuB;;;;aAc3B,MAAA;;;;aAZA,OAAA;;;;aAEZ;aACA;aACC;;;;;;;;;KAmBV,mBAAmB,YAAY;cAE9B,iBAAc,eAAA;;WAbM,MAAA;;cAepB,eAAY,MAAU,SAAO,cAAc;cAE3C,aAAU,MAAU,SAAO,cAAc;cAEzC,oBAAiB,MAAU,SAAO,cAAc;;;;;;;;cAUhD,iBAAc,MAAU,SAAO;;;;;;cAW/B,gBAAa,MAAU;;;;;;cAOvB,kBAAe,MAAU,SAAO,cAAc;;;;;;;;;;;;;;;;;cAsB9C,gBAAa,SAAa,cAAc,iBAAe,cAAc;;;;;;cAqBrE,YAAS,MAAU,SAAO,cAAc;;;;;;cAWxC,kBAAmB;WAAqB,SAAS,cAAc;GAAc,OACjF,GAAC,MACF,MAAI,QACH,cAAc,iBACpB;;;;;;cAcU,aAAc,GAAG,GAAC,MACvB,OAAO,OAAO,WAAW,GAAG,OACjC,OAAO,eAAe,GAAG;;;;;;;;;cAcf,wBAAwB;WAC1B,MAAM;;;;;;;;;;;;cAyBJ,mBAAoB,GAAC,MAC1B,MAAI,QACF,iBAAkC,OACzC,OAAO,OACR,GACA,kBAAkB,iBAAkC"}

package/dist/domain/Turn.mjs

@@ -1,5 +1,5 @@
 import { n as __exportAll } from "../rolldown-runtime-EAsCxrDo.mjs";
-import { HistoryItem, StopReason, Usage, isOutputText, isReasoning, isRefusal, isToolCall } from "./Items.mjs";
+import { HistoryItem, StopReason, Usage, isOutputImage, isOutputText, isReasoning, isRefusal, isToolCall } from "./Items.mjs";
 import { parseJson } from "../structured-format/StructuredFormat.mjs";
 import { Data, Effect, Result, Schema, Stream, pipe } from "effect";
 //#region src/domain/Turn.ts
@@ -8,12 +8,14 @@ var Turn_exports = /* @__PURE__ */ __exportAll({
 	Turn: () => Turn,
 	TurnEvent: () => TurnEvent,
 	appendToHistory: () => appendToHistory,
+	assistantImages: () => assistantImages,
 	assistantMessages: () => assistantMessages,
 	assistantText: () => assistantText,
 	assistantTexts: () => assistantTexts,
 	citations: () => citations,
 	decodeStructured: () => decodeStructured,
 	getToolCalls: () => getToolCalls,
+	imagesAsInput: () => imagesAsInput,
 	isTurnComplete: () => isTurnComplete,
 	reasonings: () => reasonings,
 	textDeltas: () => textDeltas
@@ -48,6 +50,40 @@ const assistantTexts = (turn) => assistantMessages(turn).flatMap((m) => m.conten
 */
 const assistantText = (turn) => assistantTexts(turn).join("");
 /**
+* Every image the model produced this turn, in order. The counterpart to
+* {@link assistantTexts}: each is an `ImageSource`, so it can be written
+* to disk or passed straight back as an `input_image` on the next turn.
+*/
+const assistantImages = (turn) => assistantMessages(turn).flatMap((m) => m.content).filter(isOutputImage).map((b) => b.source);
+/**
+* Rewrite assistant `output_image` blocks into a user message carrying
+* the same pictures as `input_image`, so another provider can look at
+* what this one drew.
+*
+* Only Gemini's wire has an assistant-role image part; every other
+* adapter omits an `output_image` on replay and says so. Moving it to a
+* user message is the conversion that makes it portable, and it is
+* yours to make rather than the adapter's: "the assistant drew this" and
+* "here is an image, look at it" are different claims, and silently
+* swapping one for the other behind your back would be the wrong kind of
+* helpful.
+*
+* Items with no images pass through untouched, and the new user message
+* follows the assistant message it came from.
+*/
+const imagesAsInput = (history) => history.flatMap((item) => {
+	if (item.type !== "message" || item.role !== "assistant") return [item];
+	const images = item.content.filter(isOutputImage);
+	return images.length === 0 ? [item] : [item, {
+		type: "message",
+		role: "user",
+		content: images.map((b) => ({
+			type: "input_image",
+			source: b.source
+		}))
+	}];
+});
+/**
 * Every citation annotation attached to the turn's assistant `output_text`
 * blocks, in order. The flat view of a grounded turn's sources, whether the
 * turn came from a normal generation with native search or a deep-research job.
@@ -106,6 +142,6 @@ const lastAssistantContent = (turn) => {
 */
 const decodeStructured = (turn, format) => pipe(lastAssistantContent(turn), ({ text, refused }) => refused ? Effect.fail(new RefusalRejected({ turn })) : parseJson(format)(text));
 //#endregion
-export { RefusalRejected, Turn, TurnEvent, appendToHistory, assistantMessages, assistantText, assistantTexts, citations, decodeStructured, getToolCalls, isTurnComplete, reasonings, Turn_exports as t, textDeltas };
+export { RefusalRejected, Turn, TurnEvent, appendToHistory, assistantImages, assistantMessages, assistantText, assistantTexts, citations, decodeStructured, getToolCalls, imagesAsInput, isTurnComplete, reasonings, Turn_exports as t, textDeltas };
 
 //# sourceMappingURL=Turn.mjs.map