@effect-uai/core 0.12.1 → 0.14.0

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

package/dist/domain/Turn.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Turn.mjs","names":["StructuredFormat.parseJson"],"sources":["../../src/domain/Turn.ts"],"sourcesContent":["import { Data, Effect, Result, Schema, Stream, pipe } from \"effect\"\nimport * as StructuredFormat from \"../structured-format/StructuredFormat.js\"\nimport {\n  type Annotation,\n  HistoryItem,\n  Message,\n  Reasoning,\n  StopReason,\n  ToolCall,\n  ToolCallOutput,\n  Usage,\n  isOutputText,\n  isReasoning,\n  isRefusal,\n  isToolCall,\n} from \"./Items.js\"\n\n/**\n * The result of a single LLM generation. A turn produces zero or more items\n * (typically one assistant message and zero or more function_call items)\n * and reports usage + a stop reason.\n */\nexport const Turn = Schema.Struct({\n  items: Schema.Array(HistoryItem),\n  usage: Usage,\n  stop_reason: StopReason,\n})\nexport type Turn = typeof Turn.Type\n\n/**\n * Canonical events emitted while a single turn is being generated. Most\n * variants are streaming deltas (text, reasoning, tool-call args); the\n * terminal `TurnComplete` carries the assembled `Turn`. Lifecycle members\n * aren't deltas, hence the union name.\n *\n * `ReasoningDelta.kind`: `trace` is the model's raw chain-of-thought;\n * `summary` is a model-written summary intended for display. OpenAI\n * Responses emits both; Anthropic and Gemini only emit `trace`.\n *\n * `RefusalDelta`: the model declined to answer. OpenAI Responses emits\n * this as its own event; Anthropic surfaces refusals via `stop_reason`\n * and Gemini collapses them into `finishReason: SAFETY` — both go\n * without a `RefusalDelta`.\n *\n * `UsageUpdate`: mid-stream cumulative usage. Anthropic emits this on\n * `message_start` and `message_delta`; other providers may only deliver\n * usage via `TurnComplete.turn.usage`.\n *\n * `WebSearchCall`: lifecycle of a provider-executed web search within the\n * turn. Fires only when the turn grounds against search; absent otherwise.\n *\n * `CitationAdded`: a citation attached to the answer, emitted incrementally\n * where the provider streams citations. Providers that bundle citations emit\n * none of these; their citations still arrive on `TurnComplete.turn`\n * (`OutputText.annotations`). Either way the final set is on the assembled turn.\n */\nexport type TurnEvent = Data.TaggedEnum<{\n  TextDelta: { readonly text: string }\n  ReasoningDelta: { readonly text: string; readonly kind: \"trace\" | \"summary\" }\n  RefusalDelta: { readonly text: string }\n  ToolCallStart: { readonly call_id: string; readonly name: string }\n  ToolCallArgsDelta: { readonly call_id: string; readonly delta: string }\n  UsageUpdate: { readonly usage: Usage }\n  WebSearchCall: {\n    readonly status: \"started\" | \"searching\" | \"completed\"\n    readonly query?: string\n    readonly action?: \"search\" | \"open_page\" | \"find_in_page\"\n  }\n  CitationAdded: { readonly annotation: Annotation }\n  TurnComplete: { readonly turn: Turn }\n}>\n\nexport const TurnEvent = Data.taggedEnum<TurnEvent>()\n\n/**\n * What flows out of an agent loop body to its consumer per turn: every\n * `TurnEvent` the provider emits (including the terminal `TurnComplete`\n * carrying the assembled `Turn`), plus the output of any tool the loop ran.\n * Both variants carry a `_tag` discriminator.\n */\nexport type InteractionEvent = TurnEvent | ToolCallOutput\n\nexport const isTurnComplete = TurnEvent.$is(\"TurnComplete\")\n\nexport const getToolCalls = (turn: Turn): ReadonlyArray<ToolCall> => turn.items.filter(isToolCall)\n\nexport const reasonings = (turn: Turn): ReadonlyArray<Reasoning> => turn.items.filter(isReasoning)\n\nexport const assistantMessages = (turn: Turn): ReadonlyArray<Message> =>\n  turn.items.filter((i): i is Message => i.type === \"message\" && i.role === \"assistant\")\n\n/**\n * Every `output_text` payload across every assistant message in the turn,\n * preserving order. Refusals and other content blocks are dropped — use\n * `assistantMessages` if you need to inspect them. The primitive for\n * \"give me the assistant's text\"; callers decide how to combine\n * (typically `.join(\"\")` for prose or `.join(\" \")` for log strings).\n */\nexport const assistantTexts = (turn: Turn): ReadonlyArray<string> =>\n  assistantMessages(turn)\n    .flatMap((m) => m.content)\n    .filter(isOutputText)\n    .map((b) => b.text)\n\n/**\n * Sugar over `assistantTexts(turn).join(\"\")` — the common case for\n * summarizers, classifiers, judge calls, and structured-output backstops\n * that want one concatenated string.\n */\nexport const assistantText = (turn: Turn): string => assistantTexts(turn).join(\"\")\n\n/**\n * Every citation annotation attached to the turn's assistant `output_text`\n * blocks, in order. The flat view of a grounded turn's sources, whether the\n * turn came from a normal generation with native search or a deep-research job.\n */\nexport const citations = (turn: Turn): ReadonlyArray<Annotation> =>\n  assistantMessages(turn)\n    .flatMap((m) => m.content)\n    .filter(isOutputText)\n    .flatMap((b) => b.annotations ?? [])\n\n/**\n * Append a completed turn and optional follow-up items to a state record's\n * history. Recipes use this at the point where structured tool results are\n * converted to model-facing `ToolCallOutput`s.\n */\nexport const appendToHistory = <S extends { readonly history: ReadonlyArray<HistoryItem> }>(\n  state: S,\n  turn: Turn,\n  items: ReadonlyArray<HistoryItem> = [],\n): S => ({\n  ...state,\n  history: [...state.history, ...turn.items, ...items],\n})\n\n// ---------------------------------------------------------------------------\n// Stream operators\n// ---------------------------------------------------------------------------\n\n/**\n * Project a `TurnEvent` stream onto its `TextDelta` payloads. Other\n * variants are dropped. Composes with `Lines.lines` +\n * `decodeJsonLines` for prompted-JSONL streaming.\n */\nexport const textDeltas = <E, R>(\n  self: Stream.Stream<TurnEvent, E, R>,\n): Stream.Stream<string, E, R> =>\n  self.pipe(\n    Stream.filterMap((ev) => (ev._tag === \"TextDelta\" ? Result.succeed(ev.text) : Result.failVoid)),\n  )\n\n// ---------------------------------------------------------------------------\n// Structured-output integration\n// ---------------------------------------------------------------------------\n\n/**\n * The assistant message on the just-completed turn was a refusal block,\n * not an `output_text` payload. Returned by `decodeStructured` to short-circuit\n * decoding before `JSON.parse` / schema validation runs.\n */\nexport class RefusalRejected extends Data.TaggedError(\"RefusalRejected\")<{\n  readonly turn: Turn\n}> {}\n\nconst lastAssistantContent = (turn: Turn): { readonly text: string; readonly refused: boolean } => {\n  const assistants = assistantMessages(turn)\n  const last = assistants[assistants.length - 1]\n  if (last === undefined) return { text: \"\", refused: false }\n  if (last.content.some(isRefusal)) return { text: \"\", refused: true }\n  const text = last.content\n    .filter(isOutputText)\n    .map((b) => b.text)\n    .join(\"\")\n  return { text, refused: false }\n}\n\n/**\n * Validate a completed `Turn` against a `StructuredFormat`. Concatenates\n * `output_text` blocks on the last assistant message, then runs\n * `JSON.parse` + the format's schema validation.\n *\n * Three failure modes:\n * - `RefusalRejected` — the assistant emitted a refusal block.\n * - `JsonParseError` — the assembled text wasn't valid JSON.\n * - `StructuredDecodeError` — the JSON didn't match the schema.\n */\nexport const decodeStructured = <A>(\n  turn: Turn,\n  format: StructuredFormat.StructuredFormat<A>,\n): Effect.Effect<\n  A,\n  RefusalRejected | StructuredFormat.JsonParseError | StructuredFormat.StructuredDecodeError\n> =>\n  pipe(lastAssistantContent(turn), ({ text, refused }) =>\n    refused ? Effect.fail(new RefusalRejected({ turn })) : StructuredFormat.parseJson(format)(text),\n  )\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAsBA,MAAa,OAAO,OAAO,OAAO;CAChC,OAAO,OAAO,MAAM,WAAW;CAC/B,OAAO;CACP,aAAa;AACf,CAAC;AA8CD,MAAa,YAAY,KAAK,WAAsB;AAUpD,MAAa,iBAAiB,UAAU,IAAI,cAAc;AAE1D,MAAa,gBAAgB,SAAwC,KAAK,MAAM,OAAO,UAAU;AAEjG,MAAa,cAAc,SAAyC,KAAK,MAAM,OAAO,WAAW;AAEjG,MAAa,qBAAqB,SAChC,KAAK,MAAM,QAAQ,MAAoB,EAAE,SAAS,aAAa,EAAE,SAAS,WAAW;;;;;;;;AASvF,MAAa,kBAAkB,SAC7B,kBAAkB,IAAI,CAAC,CACpB,SAAS,MAAM,EAAE,OAAO,CAAC,CACzB,OAAO,YAAY,CAAC,CACpB,KAAK,MAAM,EAAE,IAAI;;;;;;AAOtB,MAAa,iBAAiB,SAAuB,eAAe,IAAI,CAAC,CAAC,KAAK,EAAE;;;;;;AAOjF,MAAa,aAAa,SACxB,kBAAkB,IAAI,CAAC,CACpB,SAAS,MAAM,EAAE,OAAO,CAAC,CACzB,OAAO,YAAY,CAAC,CACpB,SAAS,MAAM,EAAE,eAAe,CAAC,CAAC;;;;;;AAOvC,MAAa,mBACX,OACA,MACA,QAAoC,CAAC,OAC9B;CACP,GAAG;CACH,SAAS;EAAC,GAAG,MAAM;EAAS,GAAG,KAAK;EAAO,GAAG;CAAK;AACrD;;;;;;AAWA,MAAa,cACX,SAEA,KAAK,KACH,OAAO,WAAW,OAAQ,GAAG,SAAS,cAAc,OAAO,QAAQ,GAAG,IAAI,IAAI,OAAO,QAAS,CAChG;;;;;;AAWF,IAAa,kBAAb,cAAqC,KAAK,YAAY,iBAAiB,CAAC,CAErE,CAAC;AAEJ,MAAM,wBAAwB,SAAqE;CACjG,MAAM,aAAa,kBAAkB,IAAI;CACzC,MAAM,OAAO,WAAW,WAAW,SAAS;CAC5C,IAAI,SAAS,KAAA,GAAW,OAAO;EAAE,MAAM;EAAI,SAAS;CAAM;CAC1D,IAAI,KAAK,QAAQ,KAAK,SAAS,GAAG,OAAO;EAAE,MAAM;EAAI,SAAS;CAAK;CAKnE,OAAO;EAAE,MAJI,KAAK,QACf,OAAO,YAAY,CAAC,CACpB,KAAK,MAAM,EAAE,IAAI,CAAC,CAClB,KAAK,EACI;EAAG,SAAS;CAAM;AAChC;;;;;;;;;;;AAYA,MAAa,oBACX,MACA,WAKA,KAAK,qBAAqB,IAAI,IAAI,EAAE,MAAM,cACxC,UAAU,OAAO,KAAK,IAAI,gBAAgB,EAAE,KAAK,CAAC,CAAC,IAAIA,UAA2B,MAAM,CAAC,CAAC,IAAI,CAChG"}
+{"version":3,"file":"Turn.mjs","names":["StructuredFormat.parseJson"],"sources":["../../src/domain/Turn.ts"],"sourcesContent":["import { Data, Effect, Result, Schema, Stream, pipe } from \"effect\"\nimport * as StructuredFormat from \"../structured-format/StructuredFormat.js\"\nimport type { ImageSource } from \"./Image.js\"\nimport {\n  type Annotation,\n  HistoryItem,\n  Message,\n  Reasoning,\n  StopReason,\n  ToolCall,\n  ToolCallOutput,\n  Usage,\n  isOutputImage,\n  isOutputText,\n  isReasoning,\n  isRefusal,\n  isToolCall,\n} from \"./Items.js\"\n\n/**\n * The result of a single LLM generation. A turn produces zero or more items\n * (typically one assistant message and zero or more function_call items)\n * and reports usage + a stop reason.\n */\nexport const Turn = Schema.Struct({\n  items: Schema.Array(HistoryItem),\n  usage: Usage,\n  stop_reason: StopReason,\n})\nexport type Turn = typeof Turn.Type\n\n/**\n * Canonical events emitted while a single turn is being generated. Most\n * variants are streaming deltas (text, reasoning, tool-call args); the\n * terminal `TurnComplete` carries the assembled `Turn`. Lifecycle members\n * aren't deltas, hence the union name.\n *\n * `ReasoningDelta.kind`: `trace` is the model's raw chain-of-thought;\n * `summary` is a model-written summary intended for display. OpenAI\n * Responses emits both; Anthropic and Gemini only emit `trace`.\n *\n * `RefusalDelta`: the model declined to answer. OpenAI Responses emits\n * this as its own event; Anthropic surfaces refusals via `stop_reason`\n * and Gemini collapses them into `finishReason: SAFETY` — both go\n * without a `RefusalDelta`.\n *\n * `UsageUpdate`: mid-stream cumulative usage. Anthropic emits this on\n * `message_start` and `message_delta`; other providers may only deliver\n * usage via `TurnComplete.turn.usage`.\n *\n * `WebSearchCall`: lifecycle of a provider-executed web search within the\n * turn. Fires only when the turn grounds against search; absent otherwise.\n *\n * `ImageOutput`: an image the model produced, whether it drew it as part\n * of its turn or reached a hosted tool for it. `partialIndex` marks a\n * preview frame from providers that stream them; the finished image\n * arrives without one and is also on `TurnComplete.turn` as an\n * `OutputImage` block.\n *\n * `CitationAdded`: a citation attached to the answer, emitted incrementally\n * where the provider streams citations. Providers that bundle citations emit\n * none of these; their citations still arrive on `TurnComplete.turn`\n * (`OutputText.annotations`). Either way the final set is on the assembled turn.\n */\nexport type TurnEvent = Data.TaggedEnum<{\n  TextDelta: { readonly text: string }\n  ReasoningDelta: { readonly text: string; readonly kind: \"trace\" | \"summary\" }\n  RefusalDelta: { readonly text: string }\n  ToolCallStart: { readonly call_id: string; readonly name: string }\n  ToolCallArgsDelta: { readonly call_id: string; readonly delta: string }\n  UsageUpdate: { readonly usage: Usage }\n  WebSearchCall: {\n    readonly status: \"started\" | \"searching\" | \"completed\"\n    readonly query?: string\n    readonly action?: \"search\" | \"open_page\" | \"find_in_page\"\n  }\n  ImageOutput: {\n    readonly image: ImageSource\n    /** Set only on a preview frame, counting from 0. Absent means finished. */\n    readonly partialIndex?: number\n  }\n  CitationAdded: { readonly annotation: Annotation }\n  TurnComplete: { readonly turn: Turn }\n}>\n\nexport const TurnEvent = Data.taggedEnum<TurnEvent>()\n\n/**\n * What flows out of an agent loop body to its consumer per turn: every\n * `TurnEvent` the provider emits (including the terminal `TurnComplete`\n * carrying the assembled `Turn`), plus the output of any tool the loop ran.\n * Both variants carry a `_tag` discriminator.\n */\nexport type InteractionEvent = TurnEvent | ToolCallOutput\n\nexport const isTurnComplete = TurnEvent.$is(\"TurnComplete\")\n\nexport const getToolCalls = (turn: Turn): ReadonlyArray<ToolCall> => turn.items.filter(isToolCall)\n\nexport const reasonings = (turn: Turn): ReadonlyArray<Reasoning> => turn.items.filter(isReasoning)\n\nexport const assistantMessages = (turn: Turn): ReadonlyArray<Message> =>\n  turn.items.filter((i): i is Message => i.type === \"message\" && i.role === \"assistant\")\n\n/**\n * Every `output_text` payload across every assistant message in the turn,\n * preserving order. Refusals and other content blocks are dropped — use\n * `assistantMessages` if you need to inspect them. The primitive for\n * \"give me the assistant's text\"; callers decide how to combine\n * (typically `.join(\"\")` for prose or `.join(\" \")` for log strings).\n */\nexport const assistantTexts = (turn: Turn): ReadonlyArray<string> =>\n  assistantMessages(turn)\n    .flatMap((m) => m.content)\n    .filter(isOutputText)\n    .map((b) => b.text)\n\n/**\n * Sugar over `assistantTexts(turn).join(\"\")` — the common case for\n * summarizers, classifiers, judge calls, and structured-output backstops\n * that want one concatenated string.\n */\nexport const assistantText = (turn: Turn): string => assistantTexts(turn).join(\"\")\n\n/**\n * Every image the model produced this turn, in order. The counterpart to\n * {@link assistantTexts}: each is an `ImageSource`, so it can be written\n * to disk or passed straight back as an `input_image` on the next turn.\n */\nexport const assistantImages = (turn: Turn): ReadonlyArray<ImageSource> =>\n  assistantMessages(turn)\n    .flatMap((m) => m.content)\n    .filter(isOutputImage)\n    .map((b) => b.source)\n\n/**\n * Rewrite assistant `output_image` blocks into a user message carrying\n * the same pictures as `input_image`, so another provider can look at\n * what this one drew.\n *\n * Only Gemini's wire has an assistant-role image part; every other\n * adapter omits an `output_image` on replay and says so. Moving it to a\n * user message is the conversion that makes it portable, and it is\n * yours to make rather than the adapter's: \"the assistant drew this\" and\n * \"here is an image, look at it\" are different claims, and silently\n * swapping one for the other behind your back would be the wrong kind of\n * helpful.\n *\n * Items with no images pass through untouched, and the new user message\n * follows the assistant message it came from.\n */\nexport const imagesAsInput = (history: ReadonlyArray<HistoryItem>): ReadonlyArray<HistoryItem> =>\n  history.flatMap((item) => {\n    if (item.type !== \"message\" || item.role !== \"assistant\") return [item]\n    const images = item.content.filter(isOutputImage)\n    return images.length === 0\n      ? [item]\n      : [\n          item,\n          {\n            type: \"message\" as const,\n            role: \"user\" as const,\n            content: images.map((b) => ({ type: \"input_image\" as const, source: b.source })),\n          },\n        ]\n  })\n\n/**\n * Every citation annotation attached to the turn's assistant `output_text`\n * blocks, in order. The flat view of a grounded turn's sources, whether the\n * turn came from a normal generation with native search or a deep-research job.\n */\nexport const citations = (turn: Turn): ReadonlyArray<Annotation> =>\n  assistantMessages(turn)\n    .flatMap((m) => m.content)\n    .filter(isOutputText)\n    .flatMap((b) => b.annotations ?? [])\n\n/**\n * Append a completed turn and optional follow-up items to a state record's\n * history. Recipes use this at the point where structured tool results are\n * converted to model-facing `ToolCallOutput`s.\n */\nexport const appendToHistory = <S extends { readonly history: ReadonlyArray<HistoryItem> }>(\n  state: S,\n  turn: Turn,\n  items: ReadonlyArray<HistoryItem> = [],\n): S => ({\n  ...state,\n  history: [...state.history, ...turn.items, ...items],\n})\n\n// ---------------------------------------------------------------------------\n// Stream operators\n// ---------------------------------------------------------------------------\n\n/**\n * Project a `TurnEvent` stream onto its `TextDelta` payloads. Other\n * variants are dropped. Composes with `Lines.lines` +\n * `decodeJsonLines` for prompted-JSONL streaming.\n */\nexport const textDeltas = <E, R>(\n  self: Stream.Stream<TurnEvent, E, R>,\n): Stream.Stream<string, E, R> =>\n  self.pipe(\n    Stream.filterMap((ev) => (ev._tag === \"TextDelta\" ? Result.succeed(ev.text) : Result.failVoid)),\n  )\n\n// ---------------------------------------------------------------------------\n// Structured-output integration\n// ---------------------------------------------------------------------------\n\n/**\n * The assistant message on the just-completed turn was a refusal block,\n * not an `output_text` payload. Returned by `decodeStructured` to short-circuit\n * decoding before `JSON.parse` / schema validation runs.\n */\nexport class RefusalRejected extends Data.TaggedError(\"RefusalRejected\")<{\n  readonly turn: Turn\n}> {}\n\nconst lastAssistantContent = (turn: Turn): { readonly text: string; readonly refused: boolean } => {\n  const assistants = assistantMessages(turn)\n  const last = assistants[assistants.length - 1]\n  if (last === undefined) return { text: \"\", refused: false }\n  if (last.content.some(isRefusal)) return { text: \"\", refused: true }\n  const text = last.content\n    .filter(isOutputText)\n    .map((b) => b.text)\n    .join(\"\")\n  return { text, refused: false }\n}\n\n/**\n * Validate a completed `Turn` against a `StructuredFormat`. Concatenates\n * `output_text` blocks on the last assistant message, then runs\n * `JSON.parse` + the format's schema validation.\n *\n * Three failure modes:\n * - `RefusalRejected` — the assistant emitted a refusal block.\n * - `JsonParseError` — the assembled text wasn't valid JSON.\n * - `StructuredDecodeError` — the JSON didn't match the schema.\n */\nexport const decodeStructured = <A>(\n  turn: Turn,\n  format: StructuredFormat.StructuredFormat<A>,\n): Effect.Effect<\n  A,\n  RefusalRejected | StructuredFormat.JsonParseError | StructuredFormat.StructuredDecodeError\n> =>\n  pipe(lastAssistantContent(turn), ({ text, refused }) =>\n    refused ? Effect.fail(new RefusalRejected({ turn })) : StructuredFormat.parseJson(format)(text),\n  )\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAwBA,MAAa,OAAO,OAAO,OAAO;CAChC,OAAO,OAAO,MAAM,WAAW;CAC/B,OAAO;CACP,aAAa;AACf,CAAC;AAyDD,MAAa,YAAY,KAAK,WAAsB;AAUpD,MAAa,iBAAiB,UAAU,IAAI,cAAc;AAE1D,MAAa,gBAAgB,SAAwC,KAAK,MAAM,OAAO,UAAU;AAEjG,MAAa,cAAc,SAAyC,KAAK,MAAM,OAAO,WAAW;AAEjG,MAAa,qBAAqB,SAChC,KAAK,MAAM,QAAQ,MAAoB,EAAE,SAAS,aAAa,EAAE,SAAS,WAAW;;;;;;;;AASvF,MAAa,kBAAkB,SAC7B,kBAAkB,IAAI,CAAC,CACpB,SAAS,MAAM,EAAE,OAAO,CAAC,CACzB,OAAO,YAAY,CAAC,CACpB,KAAK,MAAM,EAAE,IAAI;;;;;;AAOtB,MAAa,iBAAiB,SAAuB,eAAe,IAAI,CAAC,CAAC,KAAK,EAAE;;;;;;AAOjF,MAAa,mBAAmB,SAC9B,kBAAkB,IAAI,CAAC,CACpB,SAAS,MAAM,EAAE,OAAO,CAAC,CACzB,OAAO,aAAa,CAAC,CACrB,KAAK,MAAM,EAAE,MAAM;;;;;;;;;;;;;;;;;AAkBxB,MAAa,iBAAiB,YAC5B,QAAQ,SAAS,SAAS;CACxB,IAAI,KAAK,SAAS,aAAa,KAAK,SAAS,aAAa,OAAO,CAAC,IAAI;CACtE,MAAM,SAAS,KAAK,QAAQ,OAAO,aAAa;CAChD,OAAO,OAAO,WAAW,IACrB,CAAC,IAAI,IACL,CACE,MACA;EACE,MAAM;EACN,MAAM;EACN,SAAS,OAAO,KAAK,OAAO;GAAE,MAAM;GAAwB,QAAQ,EAAE;EAAO,EAAE;CACjF,CACF;AACN,CAAC;;;;;;AAOH,MAAa,aAAa,SACxB,kBAAkB,IAAI,CAAC,CACpB,SAAS,MAAM,EAAE,OAAO,CAAC,CACzB,OAAO,YAAY,CAAC,CACpB,SAAS,MAAM,EAAE,eAAe,CAAC,CAAC;;;;;;AAOvC,MAAa,mBACX,OACA,MACA,QAAoC,CAAC,OAC9B;CACP,GAAG;CACH,SAAS;EAAC,GAAG,MAAM;EAAS,GAAG,KAAK;EAAO,GAAG;CAAK;AACrD;;;;;;AAWA,MAAa,cACX,SAEA,KAAK,KACH,OAAO,WAAW,OAAQ,GAAG,SAAS,cAAc,OAAO,QAAQ,GAAG,IAAI,IAAI,OAAO,QAAS,CAChG;;;;;;AAWF,IAAa,kBAAb,cAAqC,KAAK,YAAY,iBAAiB,CAAC,CAErE,CAAC;AAEJ,MAAM,wBAAwB,SAAqE;CACjG,MAAM,aAAa,kBAAkB,IAAI;CACzC,MAAM,OAAO,WAAW,WAAW,SAAS;CAC5C,IAAI,SAAS,KAAA,GAAW,OAAO;EAAE,MAAM;EAAI,SAAS;CAAM;CAC1D,IAAI,KAAK,QAAQ,KAAK,SAAS,GAAG,OAAO;EAAE,MAAM;EAAI,SAAS;CAAK;CAKnE,OAAO;EAAE,MAJI,KAAK,QACf,OAAO,YAAY,CAAC,CACpB,KAAK,MAAM,EAAE,IAAI,CAAC,CAClB,KAAK,EACI;EAAG,SAAS;CAAM;AAChC;;;;;;;;;;;AAYA,MAAa,oBACX,MACA,WAKA,KAAK,qBAAqB,IAAI,IAAI,EAAE,MAAM,cACxC,UAAU,OAAO,KAAK,IAAI,gBAAgB,EAAE,KAAK,CAAC,CAAC,IAAIA,UAA2B,MAAM,CAAC,CAAC,IAAI,CAChG"}

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

@@ -1,4 +1,4 @@
-import { i as ImageSource } from "../Image-BK8-4H6s.mjs";
+import { o as ImageSource } from "../Image-Cv6iBLTy.mjs";
 declare namespace Embedding_d_exports {
   export { BinaryEmbedding, EmbedContentPart, EmbedInput, Embedding, EmbeddingFor, Float32Embedding, Int8Embedding, MultivectorEmbedding, ResponseEncoding, SparseEmbedding, Usage, isBinary, isFloat32, isInt8, isMultivector, isSparse };
 }

package/dist/image-generator/ImageGenerator.d.mts

@@ -0,0 +1,188 @@
+import { t as AspectRatio } from "../Media-BbX7BAaO.mjs";
+import { a as ImageResolution, l as ProviderData, o as ImageSource, t as GeneratedImage } from "../Image-Cv6iBLTy.mjs";
+import { t as AiError } from "../AiError-eLV9t1lU.mjs";
+import { Context, Data, Effect, Stream } from "effect";
+declare namespace ImageGenerator_d_exports {
+  export { AspectRatio, CommonImageEditRequest, CommonImageGenerateRequest, CommonStreamImageEditRequest, CommonStreamImageRequest, GeneratedImage, ImageGenerator, ImageGeneratorService, ImageResolution, ImageResponse, ImageStreamEvent, ImageStreaming, ImageUsage, ProviderData, edit, generate, isComplete, isPartialImage, streamEdit, streamGeneration };
+}
+/**
+ * Cross-provider text-to-image request. Shape and resolution are given
+ * as a ratio plus a tier rather than exact pixels: every provider takes
+ * one or derives the other. Exact dimensions, quality tiers, output
+ * encodings, and moderation knobs are vendor-specific and live on each
+ * provider's typed request.
+ */
+type CommonImageGenerateRequest = {
+  readonly prompt: string;
+  /** Each provider narrows this to its typed literal union. */
+  readonly model: string;
+  readonly aspectRatio?: AspectRatio;
+  readonly resolution?: ImageResolution;
+  /** Default 1. Implementors without multi-image output fail `Unsupported` for more. */
+  readonly n?: number;
+};
+/**
+ * Edit request: the same prompt-driven generation, conditioned on
+ * reference images. Separate from `generate` because the reference set
+ * is required here and absent there, and providers expose the two as
+ * distinct wire shapes. Per-provider caps on the array length apply.
+ */
+type CommonImageEditRequest = CommonImageGenerateRequest & {
+  readonly images: ReadonlyArray<ImageSource>;
+};
+/** Gated by {@link ImageStreaming}; `partialImages` is the preview-frame count. */
+type CommonStreamImageRequest = CommonImageGenerateRequest & {
+  readonly partialImages: 1 | 2 | 3;
+};
+/** The same previews, for an edit. Gated by {@link ImageStreaming}. */
+type CommonStreamImageEditRequest = CommonImageEditRequest & {
+  readonly partialImages: 1 | 2 | 3;
+};
+/** Optional throughout: not every provider bills or reports per token. */
+type ImageUsage = {
+  readonly inputTokens?: number;
+  readonly outputTokens?: number;
+  readonly totalTokens?: number;
+};
+type ImageResponse = {
+  readonly images: ReadonlyArray<GeneratedImage>;
+  readonly usage: ImageUsage;
+  /**
+   * Response-level extras, keyed by provider name: the seed a request
+   * resolved to, timings, safety flags. Per-image extras live on each
+   * {@link GeneratedImage} instead. See `Image.ProviderData`.
+   */
+  readonly providerData?: ProviderData;
+};
+/**
+ * Zero or more `PartialImage` previews, then exactly one `Complete`.
+ * `Complete` carries the `ImageResponse` fields flat, so it is
+ * assignable to `ImageResponse` and needs no unwrapping.
+ */
+type ImageStreamEvent = Data.TaggedEnum<{
+  PartialImage: {
+    readonly image: ImageSource;
+    /** Counts from 0 in emission order. */
+    readonly index: number;
+  };
+  Complete: {
+    readonly images: ReadonlyArray<GeneratedImage>;
+    readonly usage: ImageUsage;
+  };
+}>;
+/**
+ * Namespace of constructors, type guards, and matchers for
+ * `ImageStreamEvent`, provided by `Data.taggedEnum`.
+ */
+declare const ImageStreamEvent: {
+  readonly $is: <Tag extends "Complete" | "PartialImage">(tag: Tag) => (u: unknown) => u is Extract<{
+    readonly _tag: "Complete";
+    readonly images: ReadonlyArray<GeneratedImage>;
+    readonly usage: ImageUsage;
+  }, {
+    readonly _tag: Tag;
+  }> | Extract<{
+    readonly _tag: "PartialImage";
+    readonly image: ImageSource;
+    readonly index: number;
+  }, {
+    readonly _tag: Tag;
+  }>;
+  readonly $match: {
+    <Cases extends { readonly [Tag in "Complete" | "PartialImage"]: (args: Extract<{
+      readonly _tag: "Complete";
+      readonly images: ReadonlyArray<GeneratedImage>;
+      readonly usage: ImageUsage;
+    } | {
+      readonly _tag: "PartialImage";
+      readonly image: ImageSource;
+      readonly index: number;
+    }, {
+      readonly _tag: Tag;
+    }>) => any; }>(cases: Cases): (value: {
+      readonly _tag: "Complete";
+      readonly images: ReadonlyArray<GeneratedImage>;
+      readonly usage: ImageUsage;
+    } | {
+      readonly _tag: "PartialImage";
+      readonly image: ImageSource;
+      readonly index: number;
+    }) => import("effect/Unify").Unify<ReturnType<Cases["Complete" | "PartialImage"]>>;
+    <Cases extends { readonly [Tag in "Complete" | "PartialImage"]: (args: Extract<{
+      readonly _tag: "Complete";
+      readonly images: ReadonlyArray<GeneratedImage>;
+      readonly usage: ImageUsage;
+    } | {
+      readonly _tag: "PartialImage";
+      readonly image: ImageSource;
+      readonly index: number;
+    }, {
+      readonly _tag: Tag;
+    }>) => any; }>(value: {
+      readonly _tag: "Complete";
+      readonly images: ReadonlyArray<GeneratedImage>;
+      readonly usage: ImageUsage;
+    } | {
+      readonly _tag: "PartialImage";
+      readonly image: ImageSource;
+      readonly index: number;
+    }, cases: Cases): import("effect/Unify").Unify<ReturnType<Cases["Complete" | "PartialImage"]>>;
+  };
+  readonly Complete: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "Complete";
+    readonly images: ReadonlyArray<GeneratedImage>;
+    readonly usage: ImageUsage;
+  }, "_tag">;
+  readonly PartialImage: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "PartialImage";
+    readonly image: ImageSource;
+    readonly index: number;
+  }, "_tag">;
+};
+declare const isPartialImage: (u: unknown) => u is {
+  readonly _tag: "PartialImage";
+  readonly image: ImageSource;
+  readonly index: number;
+};
+declare const isComplete: (u: unknown) => u is {
+  readonly _tag: "Complete";
+  readonly images: ReadonlyArray<GeneratedImage>;
+  readonly usage: ImageUsage;
+};
+type ImageGeneratorService = {
+  /** Prompt in, images out. Universally supported. */
+  readonly generate: (request: CommonImageGenerateRequest) => Effect.Effect<ImageResponse, AiError>;
+  /** Prompt plus reference images in, images out. Universally supported. */
+  readonly edit: (request: CommonImageEditRequest) => Effect.Effect<ImageResponse, AiError>;
+  /**
+   * Preview frames as the image resolves, then the final response.
+   * Implementors without a partial-image wire return `Unsupported` and
+   * do NOT register {@link ImageStreaming}, so the top-level helper is
+   * a compile-time error against their Layer.
+   */
+  readonly streamGeneration: (request: CommonStreamImageRequest) => Stream.Stream<ImageStreamEvent, AiError>;
+  /** {@link streamGeneration} conditioned on reference images. */
+  readonly streamEdit: (request: CommonStreamImageEditRequest) => Stream.Stream<ImageStreamEvent, AiError>;
+};
+declare const ImageGenerator_base: Context.ServiceClass<ImageGenerator, "@betalyra/effect-uai/ImageGenerator", ImageGeneratorService>;
+declare class ImageGenerator extends ImageGenerator_base {}
+declare const ImageStreaming_base: Context.ServiceClass<ImageStreaming, "@betalyra/effect-uai/capability/ImageStreaming", void>;
+/**
+ * Capability marker for partial-image streaming. Phantom: the value is
+ * `void`, providers register with
+ * `Layer.succeed(ImageStreaming, undefined)`. Calling
+ * {@link streamGeneration} while only a non-streaming Layer is in scope
+ * fails at `Effect.provide` with a type error.
+ */
+declare class ImageStreaming extends ImageStreaming_base {}
+/** Text to image. */
+declare const generate: (request: CommonImageGenerateRequest) => Effect.Effect<ImageResponse, AiError, ImageGenerator>;
+/** Text plus reference images to image. */
+declare const edit: (request: CommonImageEditRequest) => Effect.Effect<ImageResponse, AiError, ImageGenerator>;
+/** Preview frames then the final response. Requires {@link ImageStreaming} in R. */
+declare const streamGeneration: (request: CommonStreamImageRequest) => Stream.Stream<ImageStreamEvent, AiError, ImageGenerator | ImageStreaming>;
+/** The same, conditioned on reference images. Requires {@link ImageStreaming} in R. */
+declare const streamEdit: (request: CommonStreamImageEditRequest) => Stream.Stream<ImageStreamEvent, AiError, ImageGenerator | ImageStreaming>;
+//#endregion
+export { type AspectRatio, CommonImageEditRequest, CommonImageGenerateRequest, CommonStreamImageEditRequest, CommonStreamImageRequest, type GeneratedImage, ImageGenerator, ImageGeneratorService, type ImageResolution, ImageResponse, ImageStreamEvent, ImageStreaming, ImageUsage, type ProviderData, edit, generate, isComplete, isPartialImage, streamEdit, streamGeneration, ImageGenerator_d_exports as t };
+//# sourceMappingURL=ImageGenerator.d.mts.map

package/dist/image-generator/ImageGenerator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageGenerator.d.mts","names":[],"sources":["../../src/image-generator/ImageGenerator.ts"],"mappings":";;;;;;;;;;;;;;KAmBY;WACD;;WAEA;WACA,cAAc;WACd,aAAa;;WAEb;;;;;;;;KASC,yBAAyB;WAC1B,QAAQ,cAAc;;;KAIrB,2BAA2B;WAC5B;;;KAIC,+BAA+B;WAChC;;;KAIC;WACD;WACA;WACA;;KAGC;WACD,QAAQ,cAAc;WACtB,OAAO;;;;;;WAMP,eAAe;;;;;;;KAQd,mBAAmB,KAAK;EAClC;aACW,OAAO;;aAEP;;EAEX;aACW,QAAQ,cAAc;aACtB,OAAO;;;;;;;cAQP;;;aATQ,QAAA,cAAc;aACf,OAAA;;;;;aANA,OAAA;aAEA;;;;;;;eAGC,QAAA,cAAc;eACf,OAAA;;;eANA,OAAA;eAEA;;;;;;;;;;;;;;eAGC,QAAA,cAAc;eACf,OAAA;;;eANA,OAAA;eAEA;;;;;;;;;;;;;;;aAGC,QAAA,cAAc;aACf,OAAA;;;;aANA,OAAA;aAEA;;;cAcP,iBAAc,eAAA;;WAhBP,OAAA;WAEA;;cAeP,aAAU,eAAA;;WAZF,QAAA,cAAc;WACf,OAAA;;KAaR;;WAED,WACP,SAAS,+BACN,OAAO,OAAO,eAAe;;WAEzB,OAAO,SAAS,2BAA2B,OAAO,OAAO,eAAe;;;;;;;WAOxE,mBACP,SAAS,6BACN,OAAO,OAAO,kBAAkB;;WAE5B,aACP,SAAS,iCACN,OAAO,OAAO,kBAAkB;;;cAG1B,uBAAuB;;;;;;;;;cAWvB,uBAAuB;;cAKvB,WAAQ,SACV,+BACR,OAAO,OAAO,eAAe,SAAiB;;cAIpC,OAAI,SACN,2BACR,OAAO,OAAO,eAAe,SAAiB;;cAIpC,mBAAgB,SAClB,6BACR,OAAO,OAAO,kBAAkB,SAAiB,iBAAiB;;cAUxD,aAAU,SACZ,iCACR,OAAO,OAAO,kBAAkB,SAAiB,iBAAiB"}

package/dist/image-generator/ImageGenerator.mjs

@@ -0,0 +1,50 @@
+import { n as __exportAll } from "../rolldown-runtime-EAsCxrDo.mjs";
+import { Context, Data, Effect, Stream } from "effect";
+//#region src/image-generator/ImageGenerator.ts
+var ImageGenerator_exports = /* @__PURE__ */ __exportAll({
+	ImageGenerator: () => ImageGenerator,
+	ImageStreamEvent: () => ImageStreamEvent,
+	ImageStreaming: () => ImageStreaming,
+	edit: () => edit,
+	generate: () => generate,
+	isComplete: () => isComplete,
+	isPartialImage: () => isPartialImage,
+	streamEdit: () => streamEdit,
+	streamGeneration: () => streamGeneration
+});
+/**
+* Namespace of constructors, type guards, and matchers for
+* `ImageStreamEvent`, provided by `Data.taggedEnum`.
+*/
+const ImageStreamEvent = Data.taggedEnum();
+const isPartialImage = ImageStreamEvent.$is("PartialImage");
+const isComplete = ImageStreamEvent.$is("Complete");
+var ImageGenerator = class extends Context.Service()("@betalyra/effect-uai/ImageGenerator") {};
+/**
+* Capability marker for partial-image streaming. Phantom: the value is
+* `void`, providers register with
+* `Layer.succeed(ImageStreaming, undefined)`. Calling
+* {@link streamGeneration} while only a non-streaming Layer is in scope
+* fails at `Effect.provide` with a type error.
+*/
+var ImageStreaming = class extends Context.Service()("@betalyra/effect-uai/capability/ImageStreaming") {};
+/** Text to image. */
+const generate = (request) => Effect.flatMap(ImageGenerator, (g) => g.generate(request));
+/** Text plus reference images to image. */
+const edit = (request) => Effect.flatMap(ImageGenerator, (g) => g.edit(request));
+/** Preview frames then the final response. Requires {@link ImageStreaming} in R. */
+const streamGeneration = (request) => Stream.unwrap(Effect.gen(function* () {
+	const g = yield* ImageGenerator;
+	yield* ImageStreaming;
+	return g.streamGeneration(request);
+}));
+/** The same, conditioned on reference images. Requires {@link ImageStreaming} in R. */
+const streamEdit = (request) => Stream.unwrap(Effect.gen(function* () {
+	const g = yield* ImageGenerator;
+	yield* ImageStreaming;
+	return g.streamEdit(request);
+}));
+//#endregion
+export { ImageGenerator, ImageStreamEvent, ImageStreaming, edit, generate, isComplete, isPartialImage, streamEdit, streamGeneration, ImageGenerator_exports as t };
+
+//# sourceMappingURL=ImageGenerator.mjs.map

package/dist/image-generator/ImageGenerator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageGenerator.mjs","names":[],"sources":["../../src/image-generator/ImageGenerator.ts"],"sourcesContent":["import { Context, Data, Effect, Stream } from \"effect\"\nimport type * as AiError from \"../domain/AiError.js\"\nimport type {\n  AspectRatio,\n  GeneratedImage,\n  ImageResolution,\n  ImageSource,\n  ProviderData,\n} from \"../domain/Image.js\"\n\nexport type { AspectRatio, GeneratedImage, ImageResolution, ProviderData } from \"../domain/Image.js\"\n\n/**\n * Cross-provider text-to-image request. Shape and resolution are given\n * as a ratio plus a tier rather than exact pixels: every provider takes\n * one or derives the other. Exact dimensions, quality tiers, output\n * encodings, and moderation knobs are vendor-specific and live on each\n * provider's typed request.\n */\nexport type CommonImageGenerateRequest = {\n  readonly prompt: string\n  /** Each provider narrows this to its typed literal union. */\n  readonly model: string\n  readonly aspectRatio?: AspectRatio\n  readonly resolution?: ImageResolution\n  /** Default 1. Implementors without multi-image output fail `Unsupported` for more. */\n  readonly n?: number\n}\n\n/**\n * Edit request: the same prompt-driven generation, conditioned on\n * reference images. Separate from `generate` because the reference set\n * is required here and absent there, and providers expose the two as\n * distinct wire shapes. Per-provider caps on the array length apply.\n */\nexport type CommonImageEditRequest = CommonImageGenerateRequest & {\n  readonly images: ReadonlyArray<ImageSource>\n}\n\n/** Gated by {@link ImageStreaming}; `partialImages` is the preview-frame count. */\nexport type CommonStreamImageRequest = CommonImageGenerateRequest & {\n  readonly partialImages: 1 | 2 | 3\n}\n\n/** The same previews, for an edit. Gated by {@link ImageStreaming}. */\nexport type CommonStreamImageEditRequest = CommonImageEditRequest & {\n  readonly partialImages: 1 | 2 | 3\n}\n\n/** Optional throughout: not every provider bills or reports per token. */\nexport type ImageUsage = {\n  readonly inputTokens?: number\n  readonly outputTokens?: number\n  readonly totalTokens?: number\n}\n\nexport type ImageResponse = {\n  readonly images: ReadonlyArray<GeneratedImage>\n  readonly usage: ImageUsage\n  /**\n   * Response-level extras, keyed by provider name: the seed a request\n   * resolved to, timings, safety flags. Per-image extras live on each\n   * {@link GeneratedImage} instead. See `Image.ProviderData`.\n   */\n  readonly providerData?: ProviderData\n}\n\n/**\n * Zero or more `PartialImage` previews, then exactly one `Complete`.\n * `Complete` carries the `ImageResponse` fields flat, so it is\n * assignable to `ImageResponse` and needs no unwrapping.\n */\nexport type ImageStreamEvent = Data.TaggedEnum<{\n  PartialImage: {\n    readonly image: ImageSource\n    /** Counts from 0 in emission order. */\n    readonly index: number\n  }\n  Complete: {\n    readonly images: ReadonlyArray<GeneratedImage>\n    readonly usage: ImageUsage\n  }\n}>\n\n/**\n * Namespace of constructors, type guards, and matchers for\n * `ImageStreamEvent`, provided by `Data.taggedEnum`.\n */\nexport const ImageStreamEvent = Data.taggedEnum<ImageStreamEvent>()\n\nexport const isPartialImage = ImageStreamEvent.$is(\"PartialImage\")\nexport const isComplete = ImageStreamEvent.$is(\"Complete\")\n\nexport type ImageGeneratorService = {\n  /** Prompt in, images out. Universally supported. */\n  readonly generate: (\n    request: CommonImageGenerateRequest,\n  ) => Effect.Effect<ImageResponse, AiError.AiError>\n  /** Prompt plus reference images in, images out. Universally supported. */\n  readonly edit: (request: CommonImageEditRequest) => Effect.Effect<ImageResponse, AiError.AiError>\n  /**\n   * Preview frames as the image resolves, then the final response.\n   * Implementors without a partial-image wire return `Unsupported` and\n   * do NOT register {@link ImageStreaming}, so the top-level helper is\n   * a compile-time error against their Layer.\n   */\n  readonly streamGeneration: (\n    request: CommonStreamImageRequest,\n  ) => Stream.Stream<ImageStreamEvent, AiError.AiError>\n  /** {@link streamGeneration} conditioned on reference images. */\n  readonly streamEdit: (\n    request: CommonStreamImageEditRequest,\n  ) => Stream.Stream<ImageStreamEvent, AiError.AiError>\n}\n\nexport class ImageGenerator extends Context.Service<ImageGenerator, ImageGeneratorService>()(\n  \"@betalyra/effect-uai/ImageGenerator\",\n) {}\n\n/**\n * Capability marker for partial-image streaming. Phantom: the value is\n * `void`, providers register with\n * `Layer.succeed(ImageStreaming, undefined)`. Calling\n * {@link streamGeneration} while only a non-streaming Layer is in scope\n * fails at `Effect.provide` with a type error.\n */\nexport class ImageStreaming extends Context.Service<ImageStreaming, void>()(\n  \"@betalyra/effect-uai/capability/ImageStreaming\",\n) {}\n\n/** Text to image. */\nexport const generate = (\n  request: CommonImageGenerateRequest,\n): Effect.Effect<ImageResponse, AiError.AiError, ImageGenerator> =>\n  Effect.flatMap(ImageGenerator, (g) => g.generate(request))\n\n/** Text plus reference images to image. */\nexport const edit = (\n  request: CommonImageEditRequest,\n): Effect.Effect<ImageResponse, AiError.AiError, ImageGenerator> =>\n  Effect.flatMap(ImageGenerator, (g) => g.edit(request))\n\n/** Preview frames then the final response. Requires {@link ImageStreaming} in R. */\nexport const streamGeneration = (\n  request: CommonStreamImageRequest,\n): Stream.Stream<ImageStreamEvent, AiError.AiError, ImageGenerator | ImageStreaming> =>\n  Stream.unwrap(\n    Effect.gen(function* () {\n      const g = yield* ImageGenerator\n      yield* ImageStreaming\n      return g.streamGeneration(request)\n    }),\n  )\n\n/** The same, conditioned on reference images. Requires {@link ImageStreaming} in R. */\nexport const streamEdit = (\n  request: CommonStreamImageEditRequest,\n): Stream.Stream<ImageStreamEvent, AiError.AiError, ImageGenerator | ImageStreaming> =>\n  Stream.unwrap(\n    Effect.gen(function* () {\n      const g = yield* ImageGenerator\n      yield* ImageStreaming\n      return g.streamEdit(request)\n    }),\n  )\n"],"mappings":";;;;;;;;;;;;;;;;;;AAwFA,MAAa,mBAAmB,KAAK,WAA6B;AAElE,MAAa,iBAAiB,iBAAiB,IAAI,cAAc;AACjE,MAAa,aAAa,iBAAiB,IAAI,UAAU;AAwBzD,IAAa,iBAAb,cAAoC,QAAQ,QAA+C,CAAC,CAC1F,qCACF,CAAC,CAAC,CAAC;;;;;;;;AASH,IAAa,iBAAb,cAAoC,QAAQ,QAA8B,CAAC,CACzE,gDACF,CAAC,CAAC,CAAC;;AAGH,MAAa,YACX,YAEA,OAAO,QAAQ,iBAAiB,MAAM,EAAE,SAAS,OAAO,CAAC;;AAG3D,MAAa,QACX,YAEA,OAAO,QAAQ,iBAAiB,MAAM,EAAE,KAAK,OAAO,CAAC;;AAGvD,MAAa,oBACX,YAEA,OAAO,OACL,OAAO,IAAI,aAAa;CACtB,MAAM,IAAI,OAAO;CACjB,OAAO;CACP,OAAO,EAAE,iBAAiB,OAAO;AACnC,CAAC,CACH;;AAGF,MAAa,cACX,YAEA,OAAO,OACL,OAAO,IAAI,aAAa;CACtB,MAAM,IAAI,OAAO;CACjB,OAAO;CACP,OAAO,EAAE,WAAW,OAAO;AAC7B,CAAC,CACH"}

package/dist/index.d.mts

@@ -1,13 +1,14 @@
 import { t as BrowserError_d_exports } from "./browser/BrowserError.mjs";
 import { t as Browser_d_exports } from "./browser/Browser.mjs";
-import { a as Media_d_exports } from "./Media-DwgpifPD.mjs";
-import { o as Image_d_exports } from "./Image-BK8-4H6s.mjs";
-import { u as Items_d_exports } from "./Items-SfUabNuB.mjs";
-import { _ as Tool_d_exports } from "./Tool-DE-rnvkw.mjs";
+import { s as Media_d_exports } from "./Media-BbX7BAaO.mjs";
+import { c as Image_d_exports } from "./Image-Cv6iBLTy.mjs";
+import { u as Items_d_exports } from "./Items-C7MyrYPX.mjs";
+import { _ as Tool_d_exports } from "./Tool-BF78QWtn.mjs";
 import { t as BrowserTool_d_exports } from "./browser/BrowserTool.mjs";
 import { t as Capabilities_d_exports } from "./capabilities/Capabilities.mjs";
 import { n as AiError_d_exports } from "./AiError-eLV9t1lU.mjs";
-import { o as Audio_d_exports } from "./Audio-60lKKHxS.mjs";
+import { t as Chunker_d_exports } from "./chunker/Chunker.mjs";
+import { o as Audio_d_exports } from "./Audio-_nGR4V0X.mjs";
 import { t as Citation_d_exports } from "./domain/Citation.mjs";
 import { t as Music_d_exports } from "./domain/Music.mjs";
 import { t as Job_d_exports } from "./job/Job.mjs";
@@ -17,13 +18,15 @@ import { t as Research_d_exports } from "./domain/Research.mjs";
 import { t as Transcript_d_exports } from "./domain/Transcript.mjs";
 import { t as Embedding_d_exports } from "./embedding-model/Embedding.mjs";
 import { t as EmbeddingModel_d_exports } from "./embedding-model/EmbeddingModel.mjs";
+import { t as ImageGenerator_d_exports } from "./image-generator/ImageGenerator.mjs";
 import { t as DeepResearch_d_exports } from "./research/DeepResearch.mjs";
 import { t as Loop_d_exports } from "./Loop-B54AB1ME.mjs";
-import { n as ToolResult_d_exports } from "./ToolResult-Cj8ChodL.mjs";
-import { n as ToolEvent_d_exports } from "./ToolEvent-D99MGQYH.mjs";
-import { l as Toolkit_d_exports } from "./Toolkit-BEZrNPTI.mjs";
+import { n as ToolResult_d_exports } from "./ToolResult-BsYQRjmW.mjs";
+import { n as ToolEvent_d_exports } from "./ToolEvent-Di4a723B.mjs";
+import { l as Toolkit_d_exports } from "./Toolkit-DAjJ9Tvl.mjs";
 import { t as LanguageModel_d_exports } from "./language-model/LanguageModel.mjs";
 import { t as MusicGenerator_d_exports } from "./music-generator/MusicGenerator.mjs";
+import { t as Reranker_d_exports } from "./reranker/Reranker.mjs";
 import { t as Memory_d_exports } from "./sandbox/Memory.mjs";
 import { o as SandboxError_d_exports } from "./SandboxError-BN8b28Bh.mjs";
 import { t as Sandbox_d_exports } from "./sandbox/Sandbox.mjs";
@@ -36,12 +39,14 @@ import { t as WebReadTool_d_exports } from "./web-read/WebReadTool.mjs";
 import { t as WebSearch_d_exports } from "./web-search/WebSearch.mjs";
 import { t as WebSearchTool_d_exports } from "./web-search/WebSearchTool.mjs";
 import { t as Vector_d_exports } from "./math/Vector.mjs";
+import { t as Tokenizer_d_exports } from "./tokenizer/Tokenizer.mjs";
 import { t as Retry_d_exports } from "./retry/Retry.mjs";
 import { t as Approval_d_exports } from "./tool/Approval.mjs";
 import { t as HistoryCheck_d_exports } from "./tool/HistoryCheck.mjs";
 import { t as JSONL_d_exports } from "./streaming/JSONL.mjs";
 import { t as Lines_d_exports } from "./streaming/Lines.mjs";
+import { t as Multipart_d_exports } from "./streaming/Multipart.mjs";
 import { t as SSE_d_exports } from "./streaming/SSE.mjs";
 import { t as Metrics_d_exports } from "./observability/Metrics.mjs";
 import { t as Telemetry_d_exports } from "./observability/Telemetry.mjs";
-export { AiError_d_exports as AiError, Approval_d_exports as Approval, Audio_d_exports as Audio, Browser_d_exports as Browser, BrowserError_d_exports as BrowserError, BrowserTool_d_exports as BrowserTool, Capabilities_d_exports as Capabilities, Citation_d_exports as Citation, DeepResearch_d_exports as DeepResearch, Embedding_d_exports as Embedding, EmbeddingModel_d_exports as EmbeddingModel, HistoryCheck_d_exports as HistoryCheck, Image_d_exports as Image, Items_d_exports as Items, JSONL_d_exports as JSONL, Job_d_exports as Job, LanguageModel_d_exports as LanguageModel, Lines_d_exports as Lines, Loop_d_exports as Loop, Media_d_exports as Media, Memory_d_exports as Memory, Metrics_d_exports as Metrics, Music_d_exports as Music, MusicGenerator_d_exports as MusicGenerator, Research_d_exports as Research, Retry_d_exports as Retry, SSE_d_exports as SSE, Sandbox_d_exports as Sandbox, SandboxError_d_exports as SandboxError, SandboxImage_d_exports as SandboxImage, SandboxNetwork_d_exports as SandboxNetwork, SpeechSynthesizer_d_exports as SpeechSynthesizer, StructuredFormat_d_exports as StructuredFormat, Telemetry_d_exports as Telemetry, Tool_d_exports as Tool, ToolEvent_d_exports as ToolEvent, ToolResult_d_exports as ToolResult, Toolkit_d_exports as Toolkit, Transcriber_d_exports as Transcriber, Transcript_d_exports as Transcript, Turn_d_exports as Turn, Vector_d_exports as Vector, WebRead_d_exports as WebRead, WebReadTool_d_exports as WebReadTool, WebSearch_d_exports as WebSearch, WebSearchTool_d_exports as WebSearchTool };
+export { AiError_d_exports as AiError, Approval_d_exports as Approval, Audio_d_exports as Audio, Browser_d_exports as Browser, BrowserError_d_exports as BrowserError, BrowserTool_d_exports as BrowserTool, Capabilities_d_exports as Capabilities, Chunker_d_exports as Chunker, Citation_d_exports as Citation, DeepResearch_d_exports as DeepResearch, Embedding_d_exports as Embedding, EmbeddingModel_d_exports as EmbeddingModel, HistoryCheck_d_exports as HistoryCheck, Image_d_exports as Image, ImageGenerator_d_exports as ImageGenerator, Items_d_exports as Items, JSONL_d_exports as JSONL, Job_d_exports as Job, LanguageModel_d_exports as LanguageModel, Lines_d_exports as Lines, Loop_d_exports as Loop, Media_d_exports as Media, Memory_d_exports as Memory, Metrics_d_exports as Metrics, Multipart_d_exports as Multipart, Music_d_exports as Music, MusicGenerator_d_exports as MusicGenerator, Reranker_d_exports as Reranker, Research_d_exports as Research, Retry_d_exports as Retry, SSE_d_exports as SSE, Sandbox_d_exports as Sandbox, SandboxError_d_exports as SandboxError, SandboxImage_d_exports as SandboxImage, SandboxNetwork_d_exports as SandboxNetwork, SpeechSynthesizer_d_exports as SpeechSynthesizer, StructuredFormat_d_exports as StructuredFormat, Telemetry_d_exports as Telemetry, Tokenizer_d_exports as Tokenizer, Tool_d_exports as Tool, ToolEvent_d_exports as ToolEvent, ToolResult_d_exports as ToolResult, Toolkit_d_exports as Toolkit, Transcriber_d_exports as Transcriber, Transcript_d_exports as Transcript, Turn_d_exports as Turn, Vector_d_exports as Vector, WebRead_d_exports as WebRead, WebReadTool_d_exports as WebReadTool, WebSearch_d_exports as WebSearch, WebSearchTool_d_exports as WebSearchTool };

package/dist/index.mjs

@@ -2,6 +2,7 @@ import { t as AiError_exports } from "./domain/AiError.mjs";
 import { t as Audio_exports } from "./domain/Audio.mjs";
 import { t as Browser_exports } from "./browser/Browser.mjs";
 import { t as BrowserError_exports } from "./browser/BrowserError.mjs";
+import { t as Media_exports } from "./domain/Media.mjs";
 import { t as Image_exports } from "./domain/Image.mjs";
 import { t as Items_exports } from "./domain/Items.mjs";
 import { t as ToolResult_exports } from "./tool/ToolResult.mjs";
@@ -13,17 +14,19 @@ import { t as ToolEvent_exports } from "./tool/ToolEvent.mjs";
 import { t as Toolkit_exports } from "./tool/Toolkit.mjs";
 import { t as BrowserTool_exports } from "./browser/BrowserTool.mjs";
 import { t as Capabilities_exports } from "./capabilities/Capabilities.mjs";
+import { t as Chunker_exports } from "./chunker/Chunker.mjs";
 import { t as Citation_exports } from "./domain/Citation.mjs";
 import { t as Job_exports } from "./job/Job.mjs";
 import { t as DeepResearch_exports } from "./research/DeepResearch.mjs";
-import { t as Media_exports } from "./domain/Media.mjs";
 import { t as Music_exports } from "./domain/Music.mjs";
 import { t as Research_exports } from "./domain/Research.mjs";
 import { t as Transcript_exports } from "./domain/Transcript.mjs";
 import { t as Embedding_exports } from "./embedding-model/Embedding.mjs";
 import { t as EmbeddingModel_exports } from "./embedding-model/EmbeddingModel.mjs";
+import { t as ImageGenerator_exports } from "./image-generator/ImageGenerator.mjs";
 import { t as LanguageModel_exports } from "./language-model/LanguageModel.mjs";
 import { t as MusicGenerator_exports } from "./music-generator/MusicGenerator.mjs";
+import { t as Reranker_exports } from "./reranker/Reranker.mjs";
 import { t as Memory_exports } from "./sandbox/Memory.mjs";
 import { t as Sandbox_exports } from "./sandbox/Sandbox.mjs";
 import { t as SandboxError_exports } from "./sandbox/SandboxError.mjs";
@@ -36,12 +39,14 @@ import { t as WebReadTool_exports } from "./web-read/WebReadTool.mjs";
 import { t as WebSearch_exports } from "./web-search/WebSearch.mjs";
 import { t as WebSearchTool_exports } from "./web-search/WebSearchTool.mjs";
 import { t as Vector_exports } from "./math/Vector.mjs";
+import { t as Tokenizer_exports } from "./tokenizer/Tokenizer.mjs";
 import { t as Retry_exports } from "./retry/Retry.mjs";
 import { t as Approval_exports } from "./tool/Approval.mjs";
 import { t as HistoryCheck_exports } from "./tool/HistoryCheck.mjs";
 import { t as JSONL_exports } from "./streaming/JSONL.mjs";
 import { t as Lines_exports } from "./streaming/Lines.mjs";
+import { t as Multipart_exports } from "./streaming/Multipart.mjs";
 import { t as SSE_exports } from "./streaming/SSE.mjs";
 import { t as Metrics_exports } from "./observability/Metrics.mjs";
 import { t as Telemetry_exports } from "./observability/Telemetry.mjs";
-export { AiError_exports as AiError, Approval_exports as Approval, Audio_exports as Audio, Browser_exports as Browser, BrowserError_exports as BrowserError, BrowserTool_exports as BrowserTool, Capabilities_exports as Capabilities, Citation_exports as Citation, DeepResearch_exports as DeepResearch, Embedding_exports as Embedding, EmbeddingModel_exports as EmbeddingModel, HistoryCheck_exports as HistoryCheck, Image_exports as Image, Items_exports as Items, JSONL_exports as JSONL, Job_exports as Job, LanguageModel_exports as LanguageModel, Lines_exports as Lines, Loop_exports as Loop, Media_exports as Media, Memory_exports as Memory, Metrics_exports as Metrics, Music_exports as Music, MusicGenerator_exports as MusicGenerator, Research_exports as Research, Retry_exports as Retry, SSE_exports as SSE, Sandbox_exports as Sandbox, SandboxError_exports as SandboxError, SandboxImage_exports as SandboxImage, SandboxNetwork_exports as SandboxNetwork, SpeechSynthesizer_exports as SpeechSynthesizer, StructuredFormat_exports as StructuredFormat, Telemetry_exports as Telemetry, Tool_exports as Tool, ToolEvent_exports as ToolEvent, ToolResult_exports as ToolResult, Toolkit_exports as Toolkit, Transcriber_exports as Transcriber, Transcript_exports as Transcript, Turn_exports as Turn, Vector_exports as Vector, WebRead_exports as WebRead, WebReadTool_exports as WebReadTool, WebSearch_exports as WebSearch, WebSearchTool_exports as WebSearchTool };
+export { AiError_exports as AiError, Approval_exports as Approval, Audio_exports as Audio, Browser_exports as Browser, BrowserError_exports as BrowserError, BrowserTool_exports as BrowserTool, Capabilities_exports as Capabilities, Chunker_exports as Chunker, Citation_exports as Citation, DeepResearch_exports as DeepResearch, Embedding_exports as Embedding, EmbeddingModel_exports as EmbeddingModel, HistoryCheck_exports as HistoryCheck, Image_exports as Image, ImageGenerator_exports as ImageGenerator, Items_exports as Items, JSONL_exports as JSONL, Job_exports as Job, LanguageModel_exports as LanguageModel, Lines_exports as Lines, Loop_exports as Loop, Media_exports as Media, Memory_exports as Memory, Metrics_exports as Metrics, Multipart_exports as Multipart, Music_exports as Music, MusicGenerator_exports as MusicGenerator, Reranker_exports as Reranker, Research_exports as Research, Retry_exports as Retry, SSE_exports as SSE, Sandbox_exports as Sandbox, SandboxError_exports as SandboxError, SandboxImage_exports as SandboxImage, SandboxNetwork_exports as SandboxNetwork, SpeechSynthesizer_exports as SpeechSynthesizer, StructuredFormat_exports as StructuredFormat, Telemetry_exports as Telemetry, Tokenizer_exports as Tokenizer, Tool_exports as Tool, ToolEvent_exports as ToolEvent, ToolResult_exports as ToolResult, Toolkit_exports as Toolkit, Transcriber_exports as Transcriber, Transcript_exports as Transcript, Turn_exports as Turn, Vector_exports as Vector, WebRead_exports as WebRead, WebReadTool_exports as WebReadTool, WebSearch_exports as WebSearch, WebSearchTool_exports as WebSearchTool };

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

@@ -1,8 +1,8 @@
-import { o as HistoryItem } from "../Items-SfUabNuB.mjs";
+import { o as HistoryItem } from "../Items-C7MyrYPX.mjs";
 import { t as AiError } from "../AiError-eLV9t1lU.mjs";
 import { i as StructuredFormat } from "../StructuredFormat-BlZhyOsi.mjs";
 import { Turn, TurnEvent } from "../domain/Turn.mjs";
-import { o as Toolkit } from "../Toolkit-BEZrNPTI.mjs";
+import { o as Toolkit } from "../Toolkit-DAjJ9Tvl.mjs";
 import { Context, Effect, Stream } from "effect";
 declare namespace LanguageModel_d_exports {
   export { CommonRequest, LanguageModel, LanguageModelService, streamTurn, turn, turnFromStream };

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

@@ -1,6 +1,7 @@
+import { c as Watermark } from "../Media-BbX7BAaO.mjs";
 import { t as AiError } from "../AiError-eLV9t1lU.mjs";
-import { n as AudioChunk } from "../Audio-60lKKHxS.mjs";
-import { CommonGenerateMusicRequest, CommonStreamGenerateMusicRequest, GenerateResult, MusicResult, MusicSection, MusicSessionControl, MusicSessionInput, MusicStreamEvent, Watermark, WeightedPrompt } from "../domain/Music.mjs";
+import { n as AudioChunk } from "../Audio-_nGR4V0X.mjs";
+import { CommonGenerateMusicRequest, CommonStreamGenerateMusicRequest, GenerateResult, MusicResult, MusicSection, MusicSessionControl, MusicSessionInput, MusicStreamEvent, WeightedPrompt } from "../domain/Music.mjs";
 import { Context, Effect, Stream } from "effect";
 declare namespace MusicGenerator_d_exports {
   export { CommonGenerateMusicRequest, CommonStreamGenerateMusicRequest, GenerateResult, MusicGenerator, MusicGeneratorService, MusicInteractiveSession, MusicResult, MusicSection, MusicSessionControl, MusicSessionInput, MusicStreamEvent, Watermark, WeightedPrompt, generate, streamGeneration, streamGenerationFrom };

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

@@ -1 +1 @@
-{"version":3,"file":"MusicGenerator.d.mts","names":[],"sources":["../../src/music-generator/MusicGenerator.ts"],"mappings":";;;;;;;KAwBY;;;;;;;;;;WAUD,WACP,SAAS,+BACN,OAAO,OAAO,gBAAgB;;;;;;;WAO1B,mBACP,SAAS,qCACN,OAAO,OAAO,YAAY;;;;;;;;;;;;;;;;;;;;;;;WAuBtB,uBAAuB,GAAG,GACjC,OAAO,OAAO,OAAO,mBAAmB,GAAG,IAC3C,SAAS,qCACN,OAAO,OAAO,kBAAkB,UAAkB,GAAG;;;cAG/C,uBAAuB;;;;;;;;;;;;cAcvB,gCAAgC;;cAKhC,WAAQ,SACV,+BACR,OAAO,OAAO,gBAAgB,SAAiB;;cAIrC,mBAAgB,SAClB,qCACR,OAAO,OAAO,YAAY,SAAiB;;;;;;;;;;;;;;;;;;;;;;;;;cA2BjC;GAET,SAAS,oCACP,GAAG,GACL,OAAO,OAAO,OAAO,mBAAmB,GAAG,OACxC,OAAO,OACV,kBACA,UAAkB,GAClB,IAAI,iBAAiB;GAEtB,GAAG,GACF,OAAO,OAAO,OAAO,mBAAmB,GAAG,IAC3C,SAAS,mCACR,OAAO,OACR,kBACA,UAAkB,GAClB,IAAI,iBAAiB"}
+{"version":3,"file":"MusicGenerator.d.mts","names":[],"sources":["../../src/music-generator/MusicGenerator.ts"],"mappings":";;;;;;;;KAwBY;;;;;;;;;;WAUD,WACP,SAAS,+BACN,OAAO,OAAO,gBAAgB;;;;;;;WAO1B,mBACP,SAAS,qCACN,OAAO,OAAO,YAAY;;;;;;;;;;;;;;;;;;;;;;;WAuBtB,uBAAuB,GAAG,GACjC,OAAO,OAAO,OAAO,mBAAmB,GAAG,IAC3C,SAAS,qCACN,OAAO,OAAO,kBAAkB,UAAkB,GAAG;;;cAG/C,uBAAuB;;;;;;;;;;;;cAcvB,gCAAgC;;cAKhC,WAAQ,SACV,+BACR,OAAO,OAAO,gBAAgB,SAAiB;;cAIrC,mBAAgB,SAClB,qCACR,OAAO,OAAO,YAAY,SAAiB;;;;;;;;;;;;;;;;;;;;;;;;;cA2BjC;GAET,SAAS,oCACP,GAAG,GACL,OAAO,OAAO,OAAO,mBAAmB,GAAG,OACxC,OAAO,OACV,kBACA,UAAkB,GAClB,IAAI,iBAAiB;GAEtB,GAAG,GACF,OAAO,OAAO,OAAO,mBAAmB,GAAG,IAC3C,SAAS,mCACR,OAAO,OACR,kBACA,UAAkB,GAClB,IAAI,iBAAiB"}

package/dist/observability/Metrics.d.mts

@@ -1,4 +1,4 @@
-import { x as Usage } from "../Items-SfUabNuB.mjs";
+import { S as Usage } from "../Items-C7MyrYPX.mjs";
 import { TurnEvent } from "../domain/Turn.mjs";
 import { Duration, Effect, Option, Stream } from "effect";
 declare namespace Metrics_d_exports {

package/dist/reranker/Reranker.d.mts

@@ -0,0 +1,46 @@
+import { t as AiError } from "../AiError-eLV9t1lU.mjs";
+import { Context, Effect } from "effect";
+declare namespace Reranker_d_exports {
+  export { CommonRerankRequest, RerankResponse, RerankResult, RerankUsage, Reranker, RerankerService, rerank };
+}
+/**
+ * Cross-provider rerank request. Vendor knobs (multimodal documents,
+ * instruction fields, truncation) live on the provider's typed request.
+ */
+type CommonRerankRequest = {
+  readonly query: string;
+  readonly documents: ReadonlyArray<string>;
+  /** Each provider narrows this to its typed literal union. */
+  readonly model: string;
+  /** Keep only the top N results. Default: all documents. */
+  readonly topN?: number;
+};
+type RerankResult = {
+  /** Position in the request's `documents`. */
+  readonly index: number;
+  readonly score: number;
+};
+/** Optional throughout: some providers bill per search unit, not per token. */
+type RerankUsage = {
+  readonly totalTokens?: number;
+};
+/**
+ * Score contract: `results` is sorted descending, higher is better. Scores
+ * order candidates within one call; no range or calibration is promised and
+ * they are not comparable across requests. Implementors must sort descending
+ * if the wire does not.
+ */
+type RerankResponse = {
+  readonly results: ReadonlyArray<RerankResult>;
+  readonly usage: RerankUsage;
+};
+type RerankerService = {
+  readonly rerank: (request: CommonRerankRequest) => Effect.Effect<RerankResponse, AiError>;
+};
+declare const Reranker_base: Context.ServiceClass<Reranker, "@betalyra/effect-uai/Reranker", RerankerService>;
+declare class Reranker extends Reranker_base {}
+/** Score a candidate set against a query, best first. */
+declare const rerank: (request: CommonRerankRequest) => Effect.Effect<RerankResponse, AiError, Reranker>;
+//#endregion
+export { CommonRerankRequest, RerankResponse, RerankResult, RerankUsage, Reranker, RerankerService, rerank, Reranker_d_exports as t };
+//# sourceMappingURL=Reranker.d.mts.map

package/dist/reranker/Reranker.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Reranker.d.mts","names":[],"sources":["../../src/reranker/Reranker.ts"],"mappings":";;;;;;;;;KAOY;WACD;WACA,WAAW;;WAEX;;WAEA;;KAGC;;WAED;WACA;;;KAIC;WACD;;;;;;;;KASC;WACD,SAAS,cAAc;WACvB,OAAO;;KAGN;WACD,SAAS,SAAS,wBAAwB,OAAO,OAAO,gBAAgB;;;cAGtE,iBAAiB;;cAKjB,SAAM,SACR,wBACR,OAAO,OAAO,gBAAgB,SAAiB"}

package/dist/reranker/Reranker.mjs

@@ -0,0 +1,14 @@
+import { n as __exportAll } from "../rolldown-runtime-EAsCxrDo.mjs";
+import { Context, Effect } from "effect";
+//#region src/reranker/Reranker.ts
+var Reranker_exports = /* @__PURE__ */ __exportAll({
+	Reranker: () => Reranker,
+	rerank: () => rerank
+});
+var Reranker = class extends Context.Service()("@betalyra/effect-uai/Reranker") {};
+/** Score a candidate set against a query, best first. */
+const rerank = (request) => Effect.flatMap(Reranker, (r) => r.rerank(request));
+//#endregion
+export { Reranker, rerank, Reranker_exports as t };
+
+//# sourceMappingURL=Reranker.mjs.map

package/dist/reranker/Reranker.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Reranker.mjs","names":[],"sources":["../../src/reranker/Reranker.ts"],"sourcesContent":["import { Context, Effect } from \"effect\"\nimport type * as AiError from \"../domain/AiError.js\"\n\n/**\n * Cross-provider rerank request. Vendor knobs (multimodal documents,\n * instruction fields, truncation) live on the provider's typed request.\n */\nexport type CommonRerankRequest = {\n  readonly query: string\n  readonly documents: ReadonlyArray<string>\n  /** Each provider narrows this to its typed literal union. */\n  readonly model: string\n  /** Keep only the top N results. Default: all documents. */\n  readonly topN?: number\n}\n\nexport type RerankResult = {\n  /** Position in the request's `documents`. */\n  readonly index: number\n  readonly score: number\n}\n\n/** Optional throughout: some providers bill per search unit, not per token. */\nexport type RerankUsage = {\n  readonly totalTokens?: number\n}\n\n/**\n * Score contract: `results` is sorted descending, higher is better. Scores\n * order candidates within one call; no range or calibration is promised and\n * they are not comparable across requests. Implementors must sort descending\n * if the wire does not.\n */\nexport type RerankResponse = {\n  readonly results: ReadonlyArray<RerankResult>\n  readonly usage: RerankUsage\n}\n\nexport type RerankerService = {\n  readonly rerank: (request: CommonRerankRequest) => Effect.Effect<RerankResponse, AiError.AiError>\n}\n\nexport class Reranker extends Context.Service<Reranker, RerankerService>()(\n  \"@betalyra/effect-uai/Reranker\",\n) {}\n\n/** Score a candidate set against a query, best first. */\nexport const rerank = (\n  request: CommonRerankRequest,\n): Effect.Effect<RerankResponse, AiError.AiError, Reranker> =>\n  Effect.flatMap(Reranker, (r) => r.rerank(request))\n"],"mappings":";;;;;;;AA0CA,IAAa,WAAb,cAA8B,QAAQ,QAAmC,CAAC,CACxE,+BACF,CAAC,CAAC,CAAC;;AAGH,MAAa,UACX,YAEA,OAAO,QAAQ,WAAW,MAAM,EAAE,OAAO,OAAO,CAAC"}

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

@@ -1,5 +1,5 @@
 import { t as AiError } from "../AiError-eLV9t1lU.mjs";
-import { n as AudioChunk, r as AudioFormat, t as AudioBlob } from "../Audio-60lKKHxS.mjs";
+import { n as AudioChunk, r as AudioFormat, t as AudioBlob } from "../Audio-_nGR4V0X.mjs";
 import { Context, Effect, Stream } from "effect";
 declare namespace SpeechSynthesizer_d_exports {
   export { CommonStreamSynthesizeRequest, CommonSynthesizeDialogueRequest, CommonSynthesizeRequest, CustomPronunciation, DialogueTurn, MultiSpeakerTts, SpeechSynthesizer, SpeechSynthesizerService, TtsIncrementalText, streamSynthesis, streamSynthesisFrom, streamSynthesizeDialogue, synthesize, synthesizeDialogue };