@effect-uai/core 0.15.0 → 0.17.0

package/dist/domain/Realtime.d.mts

@@ -0,0 +1,616 @@
+import { o as ImageSource } from "../Image-Cv6iBLTy.mjs";
+import { S as Usage, b as ToolCallOutput, o as HistoryItem, y as ToolCall } from "../Items-C7MyrYPX.mjs";
+import { u as ToolDescriptor } from "../Tool-BF78QWtn.mjs";
+import { r as AudioFormat } from "../Audio-_nGR4V0X.mjs";
+import { Data, Duration } from "effect";
+declare namespace Realtime_d_exports {
+  export { CommonSessionRequest, RealtimeEvent, RealtimeInput };
+}
+/**
+ * What the caller pushes into a live session.
+ *
+ * - `Audio`: encoded per `request.inputFormat`. The adapter neither paces nor
+ *   buffers; send at real time.
+ * - `Text`: role `system` maps to a system item where the provider has one and
+ *   fails `Unsupported` where it does not.
+ * - `Interrupt`: cancel the response in flight.
+ * - `VideoFrame`: gated by the `RealtimeVideoInput` marker.
+ * - `ActivityStart` / `ActivityEnd`: manual turn detection only; `ActivityEnd`
+ *   also asks for a response. Dropped with a warning on a `"server"` session.
+ * - `PlaybackPosition`: how much of a response the user actually heard, so the
+ *   adapter can trim the rest from context. A no-op where the wire has no
+ *   truncate.
+ */
+type RealtimeInput = Data.TaggedEnum<{
+  Audio: {
+    readonly bytes: Uint8Array;
+  };
+  Text: {
+    readonly text: string;
+    readonly role?: "user" | "system";
+  };
+  ToolResult: {
+    readonly output: ToolCallOutput;
+  };
+  Interrupt: {};
+  VideoFrame: {
+    readonly frame: ImageSource;
+  };
+  ActivityStart: {};
+  ActivityEnd: {};
+  PlaybackPosition: {
+    readonly responseId: string;
+    readonly playedMs: number;
+  };
+}>;
+declare const RealtimeInput: {
+  readonly $is: <Tag extends "ActivityEnd" | "ActivityStart" | "Audio" | "Interrupt" | "PlaybackPosition" | "Text" | "ToolResult" | "VideoFrame">(tag: Tag) => (u: unknown) => u is Extract<{
+    readonly _tag: "ActivityEnd";
+  }, {
+    readonly _tag: Tag;
+  }> | Extract<{
+    readonly _tag: "ActivityStart";
+  }, {
+    readonly _tag: Tag;
+  }> | Extract<{
+    readonly _tag: "Audio";
+    readonly bytes: Uint8Array;
+  }, {
+    readonly _tag: Tag;
+  }> | Extract<{
+    readonly _tag: "Interrupt";
+  }, {
+    readonly _tag: Tag;
+  }> | Extract<{
+    readonly _tag: "PlaybackPosition";
+    readonly responseId: string;
+    readonly playedMs: number;
+  }, {
+    readonly _tag: Tag;
+  }> | Extract<{
+    readonly _tag: "Text";
+    readonly text: string;
+    readonly role?: "user" | "system";
+  }, {
+    readonly _tag: Tag;
+  }> | Extract<{
+    readonly _tag: "ToolResult";
+    readonly output: ToolCallOutput;
+  }, {
+    readonly _tag: Tag;
+  }> | Extract<{
+    readonly _tag: "VideoFrame";
+    readonly frame: ImageSource;
+  }, {
+    readonly _tag: Tag;
+  }>;
+  readonly $match: {
+    <Cases extends { readonly [Tag in "ActivityEnd" | "ActivityStart" | "Audio" | "Interrupt" | "PlaybackPosition" | "Text" | "ToolResult" | "VideoFrame"]: (args: Extract<{
+      readonly _tag: "ActivityEnd";
+    } | {
+      readonly _tag: "ActivityStart";
+    } | {
+      readonly _tag: "Audio";
+      readonly bytes: Uint8Array;
+    } | {
+      readonly _tag: "Interrupt";
+    } | {
+      readonly _tag: "PlaybackPosition";
+      readonly responseId: string;
+      readonly playedMs: number;
+    } | {
+      readonly _tag: "Text";
+      readonly text: string;
+      readonly role?: "user" | "system";
+    } | {
+      readonly _tag: "ToolResult";
+      readonly output: ToolCallOutput;
+    } | {
+      readonly _tag: "VideoFrame";
+      readonly frame: ImageSource;
+    }, {
+      readonly _tag: Tag;
+    }>) => any; }>(cases: Cases): (value: {
+      readonly _tag: "ActivityEnd";
+    } | {
+      readonly _tag: "ActivityStart";
+    } | {
+      readonly _tag: "Audio";
+      readonly bytes: Uint8Array;
+    } | {
+      readonly _tag: "Interrupt";
+    } | {
+      readonly _tag: "PlaybackPosition";
+      readonly responseId: string;
+      readonly playedMs: number;
+    } | {
+      readonly _tag: "Text";
+      readonly text: string;
+      readonly role?: "user" | "system";
+    } | {
+      readonly _tag: "ToolResult";
+      readonly output: ToolCallOutput;
+    } | {
+      readonly _tag: "VideoFrame";
+      readonly frame: ImageSource;
+    }) => import("effect/Unify").Unify<ReturnType<Cases["ActivityEnd" | "ActivityStart" | "Audio" | "Interrupt" | "PlaybackPosition" | "Text" | "ToolResult" | "VideoFrame"]>>;
+    <Cases extends { readonly [Tag in "ActivityEnd" | "ActivityStart" | "Audio" | "Interrupt" | "PlaybackPosition" | "Text" | "ToolResult" | "VideoFrame"]: (args: Extract<{
+      readonly _tag: "ActivityEnd";
+    } | {
+      readonly _tag: "ActivityStart";
+    } | {
+      readonly _tag: "Audio";
+      readonly bytes: Uint8Array;
+    } | {
+      readonly _tag: "Interrupt";
+    } | {
+      readonly _tag: "PlaybackPosition";
+      readonly responseId: string;
+      readonly playedMs: number;
+    } | {
+      readonly _tag: "Text";
+      readonly text: string;
+      readonly role?: "user" | "system";
+    } | {
+      readonly _tag: "ToolResult";
+      readonly output: ToolCallOutput;
+    } | {
+      readonly _tag: "VideoFrame";
+      readonly frame: ImageSource;
+    }, {
+      readonly _tag: Tag;
+    }>) => any; }>(value: {
+      readonly _tag: "ActivityEnd";
+    } | {
+      readonly _tag: "ActivityStart";
+    } | {
+      readonly _tag: "Audio";
+      readonly bytes: Uint8Array;
+    } | {
+      readonly _tag: "Interrupt";
+    } | {
+      readonly _tag: "PlaybackPosition";
+      readonly responseId: string;
+      readonly playedMs: number;
+    } | {
+      readonly _tag: "Text";
+      readonly text: string;
+      readonly role?: "user" | "system";
+    } | {
+      readonly _tag: "ToolResult";
+      readonly output: ToolCallOutput;
+    } | {
+      readonly _tag: "VideoFrame";
+      readonly frame: ImageSource;
+    }, cases: Cases): import("effect/Unify").Unify<ReturnType<Cases["ActivityEnd" | "ActivityStart" | "Audio" | "Interrupt" | "PlaybackPosition" | "Text" | "ToolResult" | "VideoFrame"]>>;
+  };
+  readonly ActivityEnd: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "ActivityEnd";
+  }, "_tag">;
+  readonly ActivityStart: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "ActivityStart";
+  }, "_tag">;
+  readonly Audio: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "Audio";
+    readonly bytes: Uint8Array;
+  }, "_tag">;
+  readonly Interrupt: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "Interrupt";
+  }, "_tag">;
+  readonly PlaybackPosition: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "PlaybackPosition";
+    readonly responseId: string;
+    readonly playedMs: number;
+  }, "_tag">;
+  readonly Text: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "Text";
+    readonly text: string;
+    readonly role?: "user" | "system";
+  }, "_tag">;
+  readonly ToolResult: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "ToolResult";
+    readonly output: ToolCallOutput;
+  }, "_tag">;
+  readonly VideoFrame: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "VideoFrame";
+    readonly frame: ImageSource;
+  }, "_tag">;
+};
+/**
+ * What the session emits. Every `AudioDelta` and `OutputTranscriptDelta` is
+ * bracketed by `ResponseStarted` and `ResponseDone` carrying the same
+ * `responseId`.
+ *
+ * - `InputTranscript`: transcription of the user's own speech.
+ * - `SpeechStarted` / `SpeechStopped`: sparse. OpenAI emits them, Gemini
+ *   does not.
+ * - `Interrupted`: stop and flush playback now. Always precedes the
+ *   `ResponseDone { reason: "interrupted" }` for that response.
+ * - `ToolCallCancelled`: calls of an interrupted response that will never be
+ *   answered.
+ * - `ResumptionHandle`: Gemini only; pass it back as `request.resume`.
+ * - `SessionEnding`: the connection is about to close on the server's terms.
+ * - `Error`: non-fatal. A fatal error fails the stream instead.
+ */
+type RealtimeEvent = Data.TaggedEnum<{
+  ResponseStarted: {
+    readonly responseId: string;
+  };
+  AudioDelta: {
+    readonly responseId: string;
+    readonly bytes: Uint8Array;
+  };
+  OutputTranscriptDelta: {
+    readonly responseId: string;
+    readonly text: string;
+  };
+  InputTranscript: {
+    readonly text: string;
+    readonly final: boolean;
+  };
+  SpeechStarted: {};
+  SpeechStopped: {};
+  ToolCall: {
+    readonly responseId: string;
+    readonly call: ToolCall;
+  };
+  ToolCallCancelled: {
+    readonly callIds: ReadonlyArray<string>;
+  };
+  Interrupted: {
+    readonly responseId: string;
+  };
+  ResponseDone: {
+    readonly responseId: string;
+    readonly reason: "complete" | "interrupted" | "cancelled" | "error";
+    readonly usage?: Usage;
+  };
+  ResumptionHandle: {
+    readonly handle: string;
+  };
+  SessionEnding: {
+    readonly timeLeft?: Duration.Duration;
+  };
+  Error: {
+    readonly code?: string;
+    readonly message: string;
+  };
+}>;
+declare const RealtimeEvent: {
+  readonly $is: <Tag extends "AudioDelta" | "Error" | "InputTranscript" | "Interrupted" | "OutputTranscriptDelta" | "ResponseDone" | "ResponseStarted" | "ResumptionHandle" | "SessionEnding" | "SpeechStarted" | "SpeechStopped" | "ToolCall" | "ToolCallCancelled">(tag: Tag) => (u: unknown) => u is Extract<{
+    readonly _tag: "AudioDelta";
+    readonly responseId: string;
+    readonly bytes: Uint8Array;
+  }, {
+    readonly _tag: Tag;
+  }> | Extract<{
+    readonly _tag: "Error";
+    readonly code?: string;
+    readonly message: string;
+  }, {
+    readonly _tag: Tag;
+  }> | Extract<{
+    readonly _tag: "InputTranscript";
+    readonly text: string;
+    readonly final: boolean;
+  }, {
+    readonly _tag: Tag;
+  }> | Extract<{
+    readonly _tag: "Interrupted";
+    readonly responseId: string;
+  }, {
+    readonly _tag: Tag;
+  }> | Extract<{
+    readonly _tag: "OutputTranscriptDelta";
+    readonly responseId: string;
+    readonly text: string;
+  }, {
+    readonly _tag: Tag;
+  }> | Extract<{
+    readonly _tag: "ResponseDone";
+    readonly responseId: string;
+    readonly reason: "complete" | "interrupted" | "cancelled" | "error";
+    readonly usage?: Usage;
+  }, {
+    readonly _tag: Tag;
+  }> | Extract<{
+    readonly _tag: "ResponseStarted";
+    readonly responseId: string;
+  }, {
+    readonly _tag: Tag;
+  }> | Extract<{
+    readonly _tag: "ResumptionHandle";
+    readonly handle: string;
+  }, {
+    readonly _tag: Tag;
+  }> | Extract<{
+    readonly _tag: "SessionEnding";
+    readonly timeLeft?: Duration.Duration;
+  }, {
+    readonly _tag: Tag;
+  }> | Extract<{
+    readonly _tag: "SpeechStarted";
+  }, {
+    readonly _tag: Tag;
+  }> | Extract<{
+    readonly _tag: "SpeechStopped";
+  }, {
+    readonly _tag: Tag;
+  }> | Extract<{
+    readonly _tag: "ToolCall";
+    readonly responseId: string;
+    readonly call: ToolCall;
+  }, {
+    readonly _tag: Tag;
+  }> | Extract<{
+    readonly _tag: "ToolCallCancelled";
+    readonly callIds: ReadonlyArray<string>;
+  }, {
+    readonly _tag: Tag;
+  }>;
+  readonly $match: {
+    <Cases extends { readonly [Tag in "AudioDelta" | "Error" | "InputTranscript" | "Interrupted" | "OutputTranscriptDelta" | "ResponseDone" | "ResponseStarted" | "ResumptionHandle" | "SessionEnding" | "SpeechStarted" | "SpeechStopped" | "ToolCall" | "ToolCallCancelled"]: (args: Extract<{
+      readonly _tag: "AudioDelta";
+      readonly responseId: string;
+      readonly bytes: Uint8Array;
+    } | {
+      readonly _tag: "Error";
+      readonly code?: string;
+      readonly message: string;
+    } | {
+      readonly _tag: "InputTranscript";
+      readonly text: string;
+      readonly final: boolean;
+    } | {
+      readonly _tag: "Interrupted";
+      readonly responseId: string;
+    } | {
+      readonly _tag: "OutputTranscriptDelta";
+      readonly responseId: string;
+      readonly text: string;
+    } | {
+      readonly _tag: "ResponseDone";
+      readonly responseId: string;
+      readonly reason: "complete" | "interrupted" | "cancelled" | "error";
+      readonly usage?: Usage;
+    } | {
+      readonly _tag: "ResponseStarted";
+      readonly responseId: string;
+    } | {
+      readonly _tag: "ResumptionHandle";
+      readonly handle: string;
+    } | {
+      readonly _tag: "SessionEnding";
+      readonly timeLeft?: Duration.Duration;
+    } | {
+      readonly _tag: "SpeechStarted";
+    } | {
+      readonly _tag: "SpeechStopped";
+    } | {
+      readonly _tag: "ToolCall";
+      readonly responseId: string;
+      readonly call: ToolCall;
+    } | {
+      readonly _tag: "ToolCallCancelled";
+      readonly callIds: ReadonlyArray<string>;
+    }, {
+      readonly _tag: Tag;
+    }>) => any; }>(cases: Cases): (value: {
+      readonly _tag: "AudioDelta";
+      readonly responseId: string;
+      readonly bytes: Uint8Array;
+    } | {
+      readonly _tag: "Error";
+      readonly code?: string;
+      readonly message: string;
+    } | {
+      readonly _tag: "InputTranscript";
+      readonly text: string;
+      readonly final: boolean;
+    } | {
+      readonly _tag: "Interrupted";
+      readonly responseId: string;
+    } | {
+      readonly _tag: "OutputTranscriptDelta";
+      readonly responseId: string;
+      readonly text: string;
+    } | {
+      readonly _tag: "ResponseDone";
+      readonly responseId: string;
+      readonly reason: "complete" | "interrupted" | "cancelled" | "error";
+      readonly usage?: Usage;
+    } | {
+      readonly _tag: "ResponseStarted";
+      readonly responseId: string;
+    } | {
+      readonly _tag: "ResumptionHandle";
+      readonly handle: string;
+    } | {
+      readonly _tag: "SessionEnding";
+      readonly timeLeft?: Duration.Duration;
+    } | {
+      readonly _tag: "SpeechStarted";
+    } | {
+      readonly _tag: "SpeechStopped";
+    } | {
+      readonly _tag: "ToolCall";
+      readonly responseId: string;
+      readonly call: ToolCall;
+    } | {
+      readonly _tag: "ToolCallCancelled";
+      readonly callIds: ReadonlyArray<string>;
+    }) => import("effect/Unify").Unify<ReturnType<Cases["AudioDelta" | "Error" | "InputTranscript" | "Interrupted" | "OutputTranscriptDelta" | "ResponseDone" | "ResponseStarted" | "ResumptionHandle" | "SessionEnding" | "SpeechStarted" | "SpeechStopped" | "ToolCall" | "ToolCallCancelled"]>>;
+    <Cases extends { readonly [Tag in "AudioDelta" | "Error" | "InputTranscript" | "Interrupted" | "OutputTranscriptDelta" | "ResponseDone" | "ResponseStarted" | "ResumptionHandle" | "SessionEnding" | "SpeechStarted" | "SpeechStopped" | "ToolCall" | "ToolCallCancelled"]: (args: Extract<{
+      readonly _tag: "AudioDelta";
+      readonly responseId: string;
+      readonly bytes: Uint8Array;
+    } | {
+      readonly _tag: "Error";
+      readonly code?: string;
+      readonly message: string;
+    } | {
+      readonly _tag: "InputTranscript";
+      readonly text: string;
+      readonly final: boolean;
+    } | {
+      readonly _tag: "Interrupted";
+      readonly responseId: string;
+    } | {
+      readonly _tag: "OutputTranscriptDelta";
+      readonly responseId: string;
+      readonly text: string;
+    } | {
+      readonly _tag: "ResponseDone";
+      readonly responseId: string;
+      readonly reason: "complete" | "interrupted" | "cancelled" | "error";
+      readonly usage?: Usage;
+    } | {
+      readonly _tag: "ResponseStarted";
+      readonly responseId: string;
+    } | {
+      readonly _tag: "ResumptionHandle";
+      readonly handle: string;
+    } | {
+      readonly _tag: "SessionEnding";
+      readonly timeLeft?: Duration.Duration;
+    } | {
+      readonly _tag: "SpeechStarted";
+    } | {
+      readonly _tag: "SpeechStopped";
+    } | {
+      readonly _tag: "ToolCall";
+      readonly responseId: string;
+      readonly call: ToolCall;
+    } | {
+      readonly _tag: "ToolCallCancelled";
+      readonly callIds: ReadonlyArray<string>;
+    }, {
+      readonly _tag: Tag;
+    }>) => any; }>(value: {
+      readonly _tag: "AudioDelta";
+      readonly responseId: string;
+      readonly bytes: Uint8Array;
+    } | {
+      readonly _tag: "Error";
+      readonly code?: string;
+      readonly message: string;
+    } | {
+      readonly _tag: "InputTranscript";
+      readonly text: string;
+      readonly final: boolean;
+    } | {
+      readonly _tag: "Interrupted";
+      readonly responseId: string;
+    } | {
+      readonly _tag: "OutputTranscriptDelta";
+      readonly responseId: string;
+      readonly text: string;
+    } | {
+      readonly _tag: "ResponseDone";
+      readonly responseId: string;
+      readonly reason: "complete" | "interrupted" | "cancelled" | "error";
+      readonly usage?: Usage;
+    } | {
+      readonly _tag: "ResponseStarted";
+      readonly responseId: string;
+    } | {
+      readonly _tag: "ResumptionHandle";
+      readonly handle: string;
+    } | {
+      readonly _tag: "SessionEnding";
+      readonly timeLeft?: Duration.Duration;
+    } | {
+      readonly _tag: "SpeechStarted";
+    } | {
+      readonly _tag: "SpeechStopped";
+    } | {
+      readonly _tag: "ToolCall";
+      readonly responseId: string;
+      readonly call: ToolCall;
+    } | {
+      readonly _tag: "ToolCallCancelled";
+      readonly callIds: ReadonlyArray<string>;
+    }, cases: Cases): import("effect/Unify").Unify<ReturnType<Cases["AudioDelta" | "Error" | "InputTranscript" | "Interrupted" | "OutputTranscriptDelta" | "ResponseDone" | "ResponseStarted" | "ResumptionHandle" | "SessionEnding" | "SpeechStarted" | "SpeechStopped" | "ToolCall" | "ToolCallCancelled"]>>;
+  };
+  readonly AudioDelta: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "AudioDelta";
+    readonly responseId: string;
+    readonly bytes: Uint8Array;
+  }, "_tag">;
+  readonly Error: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "Error";
+    readonly code?: string;
+    readonly message: string;
+  }, "_tag">;
+  readonly InputTranscript: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "InputTranscript";
+    readonly text: string;
+    readonly final: boolean;
+  }, "_tag">;
+  readonly Interrupted: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "Interrupted";
+    readonly responseId: string;
+  }, "_tag">;
+  readonly OutputTranscriptDelta: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "OutputTranscriptDelta";
+    readonly responseId: string;
+    readonly text: string;
+  }, "_tag">;
+  readonly ResponseDone: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "ResponseDone";
+    readonly responseId: string;
+    readonly reason: "complete" | "interrupted" | "cancelled" | "error";
+    readonly usage?: Usage;
+  }, "_tag">;
+  readonly ResponseStarted: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "ResponseStarted";
+    readonly responseId: string;
+  }, "_tag">;
+  readonly ResumptionHandle: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "ResumptionHandle";
+    readonly handle: string;
+  }, "_tag">;
+  readonly SessionEnding: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "SessionEnding";
+    readonly timeLeft?: Duration.Duration;
+  }, "_tag">;
+  readonly SpeechStarted: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "SpeechStarted";
+  }, "_tag">;
+  readonly SpeechStopped: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "SpeechStopped";
+  }, "_tag">;
+  readonly ToolCall: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "ToolCall";
+    readonly responseId: string;
+    readonly call: ToolCall;
+  }, "_tag">;
+  readonly ToolCallCancelled: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "ToolCallCancelled";
+    readonly callIds: ReadonlyArray<string>;
+  }, "_tag">;
+};
+/**
+ * Cross-provider session setup. Each adapter extends this, narrowing `model`
+ * and adding its own knobs.
+ */
+type CommonSessionRequest = {
+  readonly model: string;
+  readonly instructions?: string;
+  readonly voiceId?: string;
+  /** `Toolkit.descriptors(toolkit)`. Immutable for the connection on Gemini. */
+  readonly tools?: ReadonlyArray<ToolDescriptor>;
+  readonly inputFormat: AudioFormat;
+  readonly outputFormat: AudioFormat;
+  /** Who decides a turn ended. Defaults to `"server"`. */
+  readonly turnDetection?: "server" | "manual";
+  /** Transcribe the user's own audio. Defaults to `true`. */
+  readonly transcribeInput?: boolean;
+  /** Text-only conversation seed. */
+  readonly history?: ReadonlyArray<HistoryItem>;
+  /** A `ResumptionHandle` from a previous session. `Unsupported` off Gemini. */
+  readonly resume?: string;
+};
+//#endregion
+export { CommonSessionRequest, RealtimeEvent, RealtimeInput, Realtime_d_exports as t };
+//# sourceMappingURL=Realtime.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Realtime.d.mts","names":[],"sources":["../../src/domain/Realtime.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;KA6BY,gBAAgB,KAAK;EAC/B;aAAkB,OAAO;;EACzB;aAAiB;aAAuB;;EACxC;aAAuB,QAAQ;;EAC/B;EACA;aAAuB,OAAO;;EAC9B;EACA;EACA;aAA6B;aAA6B;;;cAG/C;;;;;;;;;;;aAVc,OAAA;;;;;;;;;aAOgB;aAA2B;;;;;aAN7C;aAAwB;;;;;aAChB,QAAA;;;;;aAED,OAAA;;;;;;;;;;;eAJL,OAAA;;;;;eAOgB;eAA2B;;;eAN7C;eAAwB;;;eAChB,QAAA;;;eAED,OAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAJL,OAAA;;;;;eAOgB;eAA2B;;;eAN7C;eAAwB;;;eAChB,QAAA;;;eAED,OAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAJL,OAAA;;;;;;;aAOgB;aAA2B;;;;aAN7C;aAAwB;;;;aAChB,QAAA;;;;aAED,OAAA;;;;;;;;;;;;;;;;;;;KAwBpB,gBAAgB,KAAK;EAC/B;aAA4B;;EAC5B;aAAuB;aAA6B,OAAO;;EAC3D;aAAkC;aAA6B;;EAC/D;aAA4B;aAAuB;;EACnD;EACA;EACA;aAAqB;aAA6B,MAAM;;EACxD;aAA8B,SAAS;;EACvC;aAAwB;;EACxB;aACW;aACA;aACA,QAAQ;;EAEnB;aAA6B;;EAC7B;aAA0B,WAAW,SAAS;;EAC9C;aAAkB;aAAwB;;;cAG/B;;;aAlBwB;aAAwB,OAAA;;;;;aAelC;aAA0B;;;;;aAbjB;aAAwB;;;;;aAKtB;;;;;aANU;aAAuB;;;;;aAQ9C;aACJ;aACA,QAAA;;;;;aAZqB;;;;;aAcH;;;;;aACA,WAAA,SAAS;;;;;;;;;;;;;aATb;aAAuB,MAAA;;;;;aACjB,SAAA;;;;;;;eANJ;eAAwB,OAAA;;;eAelC;eAA0B;;;eAbjB;eAAwB;;;eAKtB;;;eANU;eAAuB;;;eAQ9C;eACJ;eACA,QAAA;;;eAZqB;;;eAcH;;;eACA,WAAA,SAAS;;;;;;;eATb;eAAuB,MAAA;;;eACjB,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eANJ;eAAwB,OAAA;;;eAelC;eAA0B;;;eAbjB;eAAwB;;;eAKtB;;;eANU;eAAuB;;;eAQ9C;eACJ;eACA,QAAA;;;eAZqB;;;eAcH;;;eACA,WAAA,SAAS;;;;;;;eATb;eAAuB,MAAA;;;eACjB,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aANJ;aAAwB,OAAA;;;;aAelC;aAA0B;;;;aAbjB;aAAwB;;;;aAKtB;;;;aANU;aAAuB;;;;aAQ9C;aACJ;aACA,QAAA;;;;aAZqB;;;;aAcH;;;;aACA,WAAA,SAAS;;;;;;;;;;aATb;aAAuB,MAAA;;;;aACjB,SAAA;;;;;;;KAkB7B;WACD;WACA;WACA;;WAEA,QAAQ,cAAc;WACtB,aAAa;WACb,cAAc;;WAEd;;WAEA;;WAEA,UAAU,cAAc;;WAExB"}

package/dist/domain/Realtime.mjs

@@ -0,0 +1,21 @@
+import { n as __exportAll } from "../rolldown-runtime-EAsCxrDo.mjs";
+import { Data } from "effect";
+//#region src/domain/Realtime.ts
+/**
+* Types for a duplex speech-to-speech session: one long-lived connection the
+* server drives, rather than a caller-driven turn.
+*
+* Only what both OpenAI Realtime and Gemini Live do natively lives here. VAD
+* knobs, truncation, resumption, thinking, grounding and noise reduction are
+* provider-typed on each adapter's request.
+*/
+var Realtime_exports = /* @__PURE__ */ __exportAll({
+	RealtimeEvent: () => RealtimeEvent,
+	RealtimeInput: () => RealtimeInput
+});
+const RealtimeInput = Data.taggedEnum();
+const RealtimeEvent = Data.taggedEnum();
+//#endregion
+export { RealtimeEvent, RealtimeInput, Realtime_exports as t };
+
+//# sourceMappingURL=Realtime.mjs.map

package/dist/domain/Realtime.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Realtime.mjs","names":[],"sources":["../../src/domain/Realtime.ts"],"sourcesContent":["/**\n * Types for a duplex speech-to-speech session: one long-lived connection the\n * server drives, rather than a caller-driven turn.\n *\n * Only what both OpenAI Realtime and Gemini Live do natively lives here. VAD\n * knobs, truncation, resumption, thinking, grounding and noise reduction are\n * provider-typed on each adapter's request.\n */\nimport { Data, type Duration } from \"effect\"\nimport type { AudioFormat } from \"./Audio.js\"\nimport type { ImageSource } from \"./Image.js\"\nimport type { HistoryItem, ToolCall, ToolCallOutput, Usage } from \"./Items.js\"\nimport type { ToolDescriptor } from \"../tool/Tool.js\"\n\n/**\n * What the caller pushes into a live session.\n *\n * - `Audio`: encoded per `request.inputFormat`. The adapter neither paces nor\n *   buffers; send at real time.\n * - `Text`: role `system` maps to a system item where the provider has one and\n *   fails `Unsupported` where it does not.\n * - `Interrupt`: cancel the response in flight.\n * - `VideoFrame`: gated by the `RealtimeVideoInput` marker.\n * - `ActivityStart` / `ActivityEnd`: manual turn detection only; `ActivityEnd`\n *   also asks for a response. Dropped with a warning on a `\"server\"` session.\n * - `PlaybackPosition`: how much of a response the user actually heard, so the\n *   adapter can trim the rest from context. A no-op where the wire has no\n *   truncate.\n */\nexport type RealtimeInput = Data.TaggedEnum<{\n  Audio: { readonly bytes: Uint8Array }\n  Text: { readonly text: string; readonly role?: \"user\" | \"system\" }\n  ToolResult: { readonly output: ToolCallOutput }\n  Interrupt: {}\n  VideoFrame: { readonly frame: ImageSource }\n  ActivityStart: {}\n  ActivityEnd: {}\n  PlaybackPosition: { readonly responseId: string; readonly playedMs: number }\n}>\n\nexport const RealtimeInput = Data.taggedEnum<RealtimeInput>()\n\n/**\n * What the session emits. Every `AudioDelta` and `OutputTranscriptDelta` is\n * bracketed by `ResponseStarted` and `ResponseDone` carrying the same\n * `responseId`.\n *\n * - `InputTranscript`: transcription of the user's own speech.\n * - `SpeechStarted` / `SpeechStopped`: sparse. OpenAI emits them, Gemini\n *   does not.\n * - `Interrupted`: stop and flush playback now. Always precedes the\n *   `ResponseDone { reason: \"interrupted\" }` for that response.\n * - `ToolCallCancelled`: calls of an interrupted response that will never be\n *   answered.\n * - `ResumptionHandle`: Gemini only; pass it back as `request.resume`.\n * - `SessionEnding`: the connection is about to close on the server's terms.\n * - `Error`: non-fatal. A fatal error fails the stream instead.\n */\nexport type RealtimeEvent = Data.TaggedEnum<{\n  ResponseStarted: { readonly responseId: string }\n  AudioDelta: { readonly responseId: string; readonly bytes: Uint8Array }\n  OutputTranscriptDelta: { readonly responseId: string; readonly text: string }\n  InputTranscript: { readonly text: string; readonly final: boolean }\n  SpeechStarted: {}\n  SpeechStopped: {}\n  ToolCall: { readonly responseId: string; readonly call: ToolCall }\n  ToolCallCancelled: { readonly callIds: ReadonlyArray<string> }\n  Interrupted: { readonly responseId: string }\n  ResponseDone: {\n    readonly responseId: string\n    readonly reason: \"complete\" | \"interrupted\" | \"cancelled\" | \"error\"\n    readonly usage?: Usage\n  }\n  ResumptionHandle: { readonly handle: string }\n  SessionEnding: { readonly timeLeft?: Duration.Duration }\n  Error: { readonly code?: string; readonly message: string }\n}>\n\nexport const RealtimeEvent = Data.taggedEnum<RealtimeEvent>()\n\n/**\n * Cross-provider session setup. Each adapter extends this, narrowing `model`\n * and adding its own knobs.\n */\nexport type CommonSessionRequest = {\n  readonly model: string\n  readonly instructions?: string\n  readonly voiceId?: string\n  /** `Toolkit.descriptors(toolkit)`. Immutable for the connection on Gemini. */\n  readonly tools?: ReadonlyArray<ToolDescriptor>\n  readonly inputFormat: AudioFormat\n  readonly outputFormat: AudioFormat\n  /** Who decides a turn ended. Defaults to `\"server\"`. */\n  readonly turnDetection?: \"server\" | \"manual\"\n  /** Transcribe the user's own audio. Defaults to `true`. */\n  readonly transcribeInput?: boolean\n  /** Text-only conversation seed. */\n  readonly history?: ReadonlyArray<HistoryItem>\n  /** A `ResumptionHandle` from a previous session. `Unsupported` off Gemini. */\n  readonly resume?: string\n}\n"],"mappings":";;;;;;;;;;;;;;;AAwCA,MAAa,gBAAgB,KAAK,WAA0B;AAsC5D,MAAa,gBAAgB,KAAK,WAA0B"}

package/dist/domain/Transcript.d.mts

@@ -1,6 +1,6 @@
-import { Duration } from "effect";
+import { Duration, Stream } from "effect";
 declare namespace Transcript_d_exports {
-  export { TranscriptEvent, TranscriptResult, WordTimestamp, isAudioEvent, isError, isFinal, isMetadata, isPartial, isSpeechStarted, isUtteranceEnded };
+  export { AccumulatePartialsOptions, TranscriptEvent, TranscriptResult, WordTimestamp, accumulatePartials, isAudioEvent, isError, isFinal, isMetadata, isPartial, isSpeechStarted, isUtteranceEnded };
 }
 /**
  * Per-word timing + metadata. `confidence` and `speakerId` are optional
@@ -95,6 +95,20 @@ declare const isMetadata: (e: TranscriptEvent) => e is Extract<TranscriptEvent,
 declare const isError: (e: TranscriptEvent) => e is Extract<TranscriptEvent, {
   _tag: "error";
 }>;
+type AccumulatePartialsOptions = {
+  /** Silence after the last `partial` before the text so far is committed. */
+  readonly silence?: Duration.Input;
+};
+/**
+ * Join fragment `partial`s into the running hypothesis and commit it as a
+ * `final` after `silence`. For providers that stream token-sized deltas
+ * (OpenAI Realtime) or never segment; piping one that already accumulates
+ * repeats its text.
+ *
+ * Partials are forwarded as they arrive; only the synthetic `final` waits.
+ * A real `final` resets the accumulator, and the stream end flushes it.
+ */
+declare const accumulatePartials: (options?: AccumulatePartialsOptions) => <E, R>(self: Stream.Stream<TranscriptEvent, E, R>) => Stream.Stream<TranscriptEvent, E, R>;
 //#endregion
-export { TranscriptEvent, TranscriptResult, WordTimestamp, isAudioEvent, isError, isFinal, isMetadata, isPartial, isSpeechStarted, isUtteranceEnded, Transcript_d_exports as t };
+export { AccumulatePartialsOptions, TranscriptEvent, TranscriptResult, WordTimestamp, accumulatePartials, isAudioEvent, isError, isFinal, isMetadata, isPartial, isSpeechStarted, isUtteranceEnded, Transcript_d_exports as t };
 //# sourceMappingURL=Transcript.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Transcript.d.mts","names":[],"sources":["../../src/domain/Transcript.ts"],"mappings":";;;;;;;;;;;;KAUY;WACD;WACA;WACA;WACA;WACA;WACA;;;;;;;KAQC;WACD;WACA;;WAEA,WAAW,SAAS;WACpB,QAAQ,cAAc;WACtB;;;;;;;;;;;;;;;;KAiBC;WAEG;WACA;WACA,QAAQ,cAAc;WACtB;;WAGA;WACA;WACA,QAAQ,cAAc;WACtB;;WAEA;WAAiC;;WACjC;WAAkC;;WAElC;WACA;WACA;WACA;;WAEA;WAA2B;;WAC3B;WAAwB;WAAwB;;cAElD,YAAS,GAAO,oBAAkB,KAAK,QAAQ;EAAmB;;cAElE,UAAO,GAAO,oBAAkB,KAAK,QAAQ;EAAmB;;cAEhE,kBAAe,GACvB,oBACF,KAAK,QAAQ;EAAmB;;cACtB,mBAAgB,GACxB,oBACF,KAAK,QAAQ;EAAmB;;cACtB,eAAY,GACpB,oBACF,KAAK,QAAQ;EAAmB;;cACtB,aAAU,GAClB,oBACF,KAAK,QAAQ;EAAmB;;cACtB,UAAO,GAAO,oBAAkB,KAAK,QAAQ;EAAmB"}
+{"version":3,"file":"Transcript.d.mts","names":[],"sources":["../../src/domain/Transcript.ts"],"mappings":";;;;;;;;;;;;KAWY;WACD;WACA;WACA;WACA;WACA;WACA;;;;;;;KAQC;WACD;WACA;;WAEA,WAAW,SAAS;WACpB,QAAQ,cAAc;WACtB;;;;;;;;;;;;;;;;KAiBC;WAEG;WACA;WACA,QAAQ,cAAc;WACtB;;WAGA;WACA;WACA,QAAQ,cAAc;WACtB;;WAEA;WAAiC;;WACjC;WAAkC;;WAElC;WACA;WACA;WACA;;WAEA;WAA2B;;WAC3B;WAAwB;WAAwB;;cAElD,YAAS,GAAO,oBAAkB,KAAK,QAAQ;EAAmB;;cAElE,UAAO,GAAO,oBAAkB,KAAK,QAAQ;EAAmB;;cAEhE,kBAAe,GACvB,oBACF,KAAK,QAAQ;EAAmB;;cACtB,mBAAgB,GACxB,oBACF,KAAK,QAAQ;EAAmB;;cACtB,eAAY,GACpB,oBACF,KAAK,QAAQ;EAAmB;;cACtB,aAAU,GAClB,oBACF,KAAK,QAAQ;EAAmB;;cACtB,UAAO,GAAO,oBAAkB,KAAK,QAAQ;EAAmB;;KAGjE;;WAED,UAAU,SAAS;;;;;;;;;;;cAiBjB,qBAAkB,UAClB,+BACV,GAAG,GAAC,MAAQ,OAAO,OAAO,iBAAiB,GAAG,OAAK,OAAO,OAAO,iBAAiB,GAAG"}