@effect-uai/ui 0.0.0-stage → 0.19.0-dev-20261109183959

package/dist/Thread-CAXsjhpX.d.mts

@@ -0,0 +1,474 @@
+import { Envelope, InputId, Payloads, StreamId, Untyped } from "./RunEvent.mjs";
+import { p as UserMessage } from "./Input-Cz-Kxusm.mjs";
+import { h as ToolUpdate, l as RunView } from "./RunView-nHfJwN8t.mjs";
+import { Option, Schema } from "effect";
+declare namespace Thread_d_exports {
+  export { AssistantEntry, Config, Entry, Fold, Message, PresetInput, State, Thread, UserContent, UserEntry, ended, hasInput, initial, make, preset, presetFor, step, submitted, truncateAfter };
+}
+type UserEntry<U> = {
+  readonly role: "user";
+  readonly id: InputId;
+  readonly value: U;
+};
+type AssistantEntry<A> = {
+  readonly role: "assistant";
+  readonly id: string;
+  readonly value: A;
+};
+type Entry<U, A> = UserEntry<U> | AssistantEntry<A>;
+/** `P` types the active run's payloads (see `UiContract`). */
+type State<U, A, P extends Payloads = Untyped> = {
+  readonly messages: ReadonlyArray<Entry<U, A>>;
+  /** The run still streaming, if any. */
+  readonly active: RunView<P> | null;
+  /**
+   * Inputs waiting for their own run (sent during a run, or echoed by a
+   * server that queues). They join `messages` when a `run-started` lists them.
+   */
+  readonly pending: ReadonlyArray<UserEntry<U>>;
+  /** The stream `lastSeq` counts in; a frame from another stream starts a new count. */
+  readonly streamId: StreamId | null;
+  /** Highest applied `seq` across runs, so a settled run's frames stay deduplicated. */
+  readonly lastSeq: number;
+};
+/**
+ * The state as a Schema, for persisting or sending it. `view` is the active
+ * run's schema: `RunView.RunView` (default) or a contract's `RunView`.
+ */
+declare const State: <U, A, V>(user: Schema.Codec<U, unknown, never, never>, assistant: Schema.Codec<A, unknown, never, never>, view: Schema.Codec<V, unknown, never, never>) => Schema.Struct<{
+  readonly messages: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+    readonly role: Schema.Literal<"user">;
+    readonly id: Schema.brand<Schema.String, "InputId">;
+    readonly value: Schema.Codec<U, unknown, never, never>;
+  }>, Schema.Struct<{
+    readonly role: Schema.Literal<"assistant">;
+    readonly id: Schema.String;
+    readonly value: Schema.Codec<A, unknown, never, never>;
+  }>]>>;
+  readonly active: Schema.NullOr<Schema.Codec<V, unknown, never, never>>;
+  readonly pending: Schema.$Array<Schema.Struct<{
+    readonly role: Schema.Literal<"user">;
+    readonly id: Schema.brand<Schema.String, "InputId">;
+    readonly value: Schema.Codec<U, unknown, never, never>;
+  }>>;
+  readonly streamId: Schema.NullOr<Schema.brand<Schema.String, "StreamId">>;
+  readonly lastSeq: Schema.Number;
+}>;
+type Config<I, U, A, P extends Payloads = Untyped> = {
+  /** The user entry for an input; `None` for inputs without one (approvals). */
+  readonly toUser: (input: I) => Option.Option<U>;
+  /** The assistant entry a finished run settles into. */
+  readonly settle: (run: RunView<P>) => A;
+  /** Decodes an `input-accepted` echo into an input; without it, echoes are ignored. */
+  readonly decodeInput?: (value: unknown) => Option.Option<I>;
+  /**
+   * Applies a tool event to a settled entry that holds the call (`None` if it
+   * doesn't). An approved call's result arrives in the next run; with this,
+   * it updates the card it was asked from. Without it, it lands in the new run.
+   */
+  readonly updateTool?: (entry: A, event: ToolUpdate<P>) => Option.Option<A>;
+};
+type Fold<I, U, A, P extends Payloads = Untyped> = {
+  readonly initial: State<U, A, P>;
+  readonly step: (state: State<U, A, P>, envelope: Envelope<P>) => State<U, A, P>;
+  /** Optimistic: show the input before the server answers. */
+  readonly submitted: (state: State<U, A, P>, input: I) => State<U, A, P>;
+  /** Settle the active run when its stream ends without a terminal. */
+  readonly ended: (state: State<U, A, P>, reason: "stopped" | "disconnected") => State<U, A, P>;
+};
+/** Whether the state already shows the input `id` (settled or pending). */
+declare const hasInput: <U, A, P extends Payloads>(state: State<U, A, P>, id: InputId) => boolean;
+/** Drop everything after the entry `id` (regenerate, edit). */
+declare const truncateAfter: <U, A, P extends Payloads>(state: State<U, A, P>, id: string) => State<U, A, P>;
+declare function make<I extends {
+  readonly id: InputId;
+}, U, A, P extends Payloads = Untyped>(config: Config<I, U, A, P>): Fold<I, U, A, P>;
+/** A user entry's value in the preset: the messages the input carried. */
+declare const UserContent: Schema.Struct<{
+  readonly messages: Schema.$Array<Schema.Struct<{
+    readonly type: Schema.Literal<"message">;
+    readonly role: Schema.Literal<"user">;
+    readonly content: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+      readonly type: Schema.Literal<"input_text">;
+      readonly text: Schema.String;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"input_image">;
+      readonly source: Schema.Codec<import("@effect-uai/core/Image").ImageSource, import("@effect-uai/core/Image").ImageSource, never, never>;
+    }>]>>;
+  }>>;
+}>;
+type UserContent = typeof UserContent.Type;
+declare const Thread: Schema.Struct<{
+  readonly messages: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+    readonly role: Schema.Literal<"user">;
+    readonly id: Schema.brand<Schema.String, "InputId">;
+    readonly value: Schema.Codec<{
+      readonly messages: readonly {
+        readonly type: "message";
+        readonly role: "user";
+        readonly content: readonly ({
+          readonly type: "input_text";
+          readonly text: string;
+        } | {
+          readonly type: "input_image";
+          readonly source: import("@effect-uai/core/Image").ImageSource;
+        })[];
+      }[];
+    }, unknown, never, never>;
+  }>, Schema.Struct<{
+    readonly role: Schema.Literal<"assistant">;
+    readonly id: Schema.String;
+    readonly value: Schema.Codec<{
+      readonly runId?: string & import("effect/Brand").Brand<"RunId">;
+      readonly name?: string;
+      readonly inputs: readonly (string & import("effect/Brand").Brand<"InputId">)[];
+      readonly status: "completed" | "failed" | "idle" | "interrupted" | "stopped" | "streaming" | "submitted";
+      readonly blocks: readonly ({
+        readonly type: "output_text";
+        readonly text: string;
+        readonly annotations?: readonly ({
+          readonly type: "url_citation";
+          readonly url: string;
+          readonly title: string;
+          readonly start_index?: number | undefined;
+          readonly end_index?: number | undefined;
+          readonly cited_text?: string | undefined;
+          readonly marker?: number | undefined;
+        } | {
+          readonly type: "file_citation";
+          readonly file_id: string;
+          readonly index: number;
+        } | {
+          readonly type: "container_file_citation";
+          readonly container_id: string;
+          readonly file_id: string;
+          readonly start_index: number;
+          readonly end_index: number;
+        } | {
+          readonly type: "file_path";
+          readonly file_id: string;
+          readonly index: number;
+        })[] | undefined;
+        readonly id: string;
+      } | {
+        readonly type: "refusal";
+        readonly text: string;
+        readonly id: string;
+      } | {
+        readonly type: "output_image";
+        readonly source: import("@effect-uai/core/Image").ImageSource;
+        readonly id: string;
+        readonly partialIndex?: number;
+      } | {
+        readonly type: "reasoning";
+        readonly id: string;
+        readonly text: string;
+      } | {
+        readonly type: "tool";
+        readonly id: string;
+        readonly name: string;
+        readonly status: "awaiting-approval" | "done" | "failed" | "input-streaming" | "ready" | "running";
+        readonly input?: Schema.Json;
+        readonly argsText?: string;
+        readonly partial?: Schema.Json;
+        readonly outcome?: {
+          readonly _tag: "Success";
+          readonly value: Schema.Json;
+        } | {
+          readonly _tag: "Failure";
+          readonly error: Schema.Json;
+        };
+      } | {
+        readonly type: "object";
+        readonly id: string;
+        readonly name: string;
+        readonly status: "done" | "failed" | "streaming";
+        readonly partial?: Schema.Json;
+        readonly value?: Schema.Json;
+        readonly issues?: readonly Schema.Json[];
+      } | {
+        readonly type: "object";
+        readonly id: string;
+        readonly status: "done" | "failed" | "streaming";
+        readonly partial?: Schema.Json;
+        readonly value?: Schema.Json;
+        readonly issues?: readonly Schema.Json[];
+      } | {
+        readonly type: "data";
+        readonly id: string;
+        readonly name: string;
+        readonly value: Schema.Json;
+      })[];
+      readonly interrupts: readonly {
+        readonly callId: string;
+        readonly reason: "approval";
+        readonly name: string;
+        readonly input: Schema.Json;
+      }[];
+      readonly live: {
+        readonly [x: string]: Schema.Json;
+      };
+      readonly usage?: {
+        readonly input_tokens?: number | undefined;
+        readonly output_tokens?: number | undefined;
+        readonly total_tokens?: number | undefined;
+        readonly input_tokens_details?: {
+          readonly cached_tokens?: number | undefined;
+          readonly cache_write_tokens?: number | undefined;
+        } | undefined;
+        readonly output_tokens_details?: {
+          readonly reasoning_tokens?: number | undefined;
+        } | undefined;
+      };
+      readonly metadata?: Schema.Json;
+      readonly error?: {
+        readonly reason: string;
+        readonly message?: string;
+      };
+      readonly lastSeq: number;
+      readonly stepStart: number;
+      readonly nextBlock: number;
+    }, unknown, never, never>;
+  }>]>>;
+  readonly active: Schema.NullOr<Schema.Codec<{
+    readonly runId?: string & import("effect/Brand").Brand<"RunId">;
+    readonly name?: string;
+    readonly inputs: readonly (string & import("effect/Brand").Brand<"InputId">)[];
+    readonly status: "completed" | "failed" | "idle" | "interrupted" | "stopped" | "streaming" | "submitted";
+    readonly blocks: readonly ({
+      readonly type: "output_text";
+      readonly text: string;
+      readonly annotations?: readonly ({
+        readonly type: "url_citation";
+        readonly url: string;
+        readonly title: string;
+        readonly start_index?: number | undefined;
+        readonly end_index?: number | undefined;
+        readonly cited_text?: string | undefined;
+        readonly marker?: number | undefined;
+      } | {
+        readonly type: "file_citation";
+        readonly file_id: string;
+        readonly index: number;
+      } | {
+        readonly type: "container_file_citation";
+        readonly container_id: string;
+        readonly file_id: string;
+        readonly start_index: number;
+        readonly end_index: number;
+      } | {
+        readonly type: "file_path";
+        readonly file_id: string;
+        readonly index: number;
+      })[] | undefined;
+      readonly id: string;
+    } | {
+      readonly type: "refusal";
+      readonly text: string;
+      readonly id: string;
+    } | {
+      readonly type: "output_image";
+      readonly source: import("@effect-uai/core/Image").ImageSource;
+      readonly id: string;
+      readonly partialIndex?: number;
+    } | {
+      readonly type: "reasoning";
+      readonly id: string;
+      readonly text: string;
+    } | {
+      readonly type: "tool";
+      readonly id: string;
+      readonly name: string;
+      readonly status: "awaiting-approval" | "done" | "failed" | "input-streaming" | "ready" | "running";
+      readonly input?: Schema.Json;
+      readonly argsText?: string;
+      readonly partial?: Schema.Json;
+      readonly outcome?: {
+        readonly _tag: "Success";
+        readonly value: Schema.Json;
+      } | {
+        readonly _tag: "Failure";
+        readonly error: Schema.Json;
+      };
+    } | {
+      readonly type: "object";
+      readonly id: string;
+      readonly name: string;
+      readonly status: "done" | "failed" | "streaming";
+      readonly partial?: Schema.Json;
+      readonly value?: Schema.Json;
+      readonly issues?: readonly Schema.Json[];
+    } | {
+      readonly type: "object";
+      readonly id: string;
+      readonly status: "done" | "failed" | "streaming";
+      readonly partial?: Schema.Json;
+      readonly value?: Schema.Json;
+      readonly issues?: readonly Schema.Json[];
+    } | {
+      readonly type: "data";
+      readonly id: string;
+      readonly name: string;
+      readonly value: Schema.Json;
+    })[];
+    readonly interrupts: readonly {
+      readonly callId: string;
+      readonly reason: "approval";
+      readonly name: string;
+      readonly input: Schema.Json;
+    }[];
+    readonly live: {
+      readonly [x: string]: Schema.Json;
+    };
+    readonly usage?: {
+      readonly input_tokens?: number | undefined;
+      readonly output_tokens?: number | undefined;
+      readonly total_tokens?: number | undefined;
+      readonly input_tokens_details?: {
+        readonly cached_tokens?: number | undefined;
+        readonly cache_write_tokens?: number | undefined;
+      } | undefined;
+      readonly output_tokens_details?: {
+        readonly reasoning_tokens?: number | undefined;
+      } | undefined;
+    };
+    readonly metadata?: Schema.Json;
+    readonly error?: {
+      readonly reason: string;
+      readonly message?: string;
+    };
+    readonly lastSeq: number;
+    readonly stepStart: number;
+    readonly nextBlock: number;
+  }, unknown, never, never>>;
+  readonly pending: Schema.$Array<Schema.Struct<{
+    readonly role: Schema.Literal<"user">;
+    readonly id: Schema.brand<Schema.String, "InputId">;
+    readonly value: Schema.Codec<{
+      readonly messages: readonly {
+        readonly type: "message";
+        readonly role: "user";
+        readonly content: readonly ({
+          readonly type: "input_text";
+          readonly text: string;
+        } | {
+          readonly type: "input_image";
+          readonly source: import("@effect-uai/core/Image").ImageSource;
+        })[];
+      }[];
+    }, unknown, never, never>;
+  }>>;
+  readonly streamId: Schema.NullOr<Schema.brand<Schema.String, "StreamId">>;
+  readonly lastSeq: Schema.Number;
+}>;
+/** The preset's state; with a contract's `P`, runs carry decoded payloads. */
+type Thread<P extends Payloads = Untyped> = State<UserContent, RunView<P>, P>;
+type Message<P extends Payloads = Untyped> = Entry<UserContent, RunView<P>>;
+/** Inputs the preset understands: any with an id; those with messages get a user entry. */
+type PresetInput = {
+  readonly id: InputId;
+  readonly messages?: ReadonlyArray<UserMessage>;
+};
+/** The preset's fold for a contract's `P` (`UiContract` and `Atoms` use it). */
+declare const presetFor: <P extends Payloads = Untyped>() => Fold<PresetInput, UserContent, RunView<P>, P>;
+declare const preset: Fold<PresetInput, {
+  readonly messages: readonly {
+    readonly type: "message";
+    readonly role: "user";
+    readonly content: readonly ({
+      readonly type: "input_text";
+      readonly text: string;
+    } | {
+      readonly type: "input_image";
+      readonly source: import("@effect-uai/core/Image").ImageSource;
+    })[];
+  }[];
+}, RunView<Untyped>, Untyped>;
+declare const initial: State<{
+  readonly messages: readonly {
+    readonly type: "message";
+    readonly role: "user";
+    readonly content: readonly ({
+      readonly type: "input_text";
+      readonly text: string;
+    } | {
+      readonly type: "input_image";
+      readonly source: import("@effect-uai/core/Image").ImageSource;
+    })[];
+  }[];
+}, RunView<Untyped>, Untyped>, step: (state: State<{
+  readonly messages: readonly {
+    readonly type: "message";
+    readonly role: "user";
+    readonly content: readonly ({
+      readonly type: "input_text";
+      readonly text: string;
+    } | {
+      readonly type: "input_image";
+      readonly source: import("@effect-uai/core/Image").ImageSource;
+    })[];
+  }[];
+}, RunView<Untyped>, Untyped>, envelope: Envelope<Untyped>) => State<{
+  readonly messages: readonly {
+    readonly type: "message";
+    readonly role: "user";
+    readonly content: readonly ({
+      readonly type: "input_text";
+      readonly text: string;
+    } | {
+      readonly type: "input_image";
+      readonly source: import("@effect-uai/core/Image").ImageSource;
+    })[];
+  }[];
+}, RunView<Untyped>, Untyped>, submitted: (state: State<{
+  readonly messages: readonly {
+    readonly type: "message";
+    readonly role: "user";
+    readonly content: readonly ({
+      readonly type: "input_text";
+      readonly text: string;
+    } | {
+      readonly type: "input_image";
+      readonly source: import("@effect-uai/core/Image").ImageSource;
+    })[];
+  }[];
+}, RunView<Untyped>, Untyped>, input: PresetInput) => State<{
+  readonly messages: readonly {
+    readonly type: "message";
+    readonly role: "user";
+    readonly content: readonly ({
+      readonly type: "input_text";
+      readonly text: string;
+    } | {
+      readonly type: "input_image";
+      readonly source: import("@effect-uai/core/Image").ImageSource;
+    })[];
+  }[];
+}, RunView<Untyped>, Untyped>, ended: (state: State<{
+  readonly messages: readonly {
+    readonly type: "message";
+    readonly role: "user";
+    readonly content: readonly ({
+      readonly type: "input_text";
+      readonly text: string;
+    } | {
+      readonly type: "input_image";
+      readonly source: import("@effect-uai/core/Image").ImageSource;
+    })[];
+  }[];
+}, RunView<Untyped>, Untyped>, reason: "stopped" | "disconnected") => State<{
+  readonly messages: readonly {
+    readonly type: "message";
+    readonly role: "user";
+    readonly content: readonly ({
+      readonly type: "input_text";
+      readonly text: string;
+    } | {
+      readonly type: "input_image";
+      readonly source: import("@effect-uai/core/Image").ImageSource;
+    })[];
+  }[];
+}, RunView<Untyped>, Untyped>;
+//#endregion
+export { presetFor as _, Message as a, truncateAfter as b, Thread as c, UserEntry as d, ended as f, preset as g, make as h, Fold as i, Thread_d_exports as l, initial as m, Config as n, PresetInput as o, hasInput as p, Entry as r, State as s, AssistantEntry as t, UserContent as u, step as v, submitted as y };
+//# sourceMappingURL=Thread-CAXsjhpX.d.mts.map

package/dist/Thread-CAXsjhpX.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Thread-CAXsjhpX.d.mts","names":[],"sources":["../src/Thread.ts"],"mappings":";;;;;;;KAuBY,UAAU;WAAgB;WAAuB,IAAI;WAAkB,OAAO;;KAC9E,eAAe;WAChB;WACA;WACA,OAAO;;KAEN,MAAM,GAAG,KAAK,UAAU,KAAK,eAAe;;KAG5C,MAAM,GAAG,GAAG,UAAU,WAAW;WAClC,UAAU,cAAc,MAAM,GAAG;;WAEjC,QAAQ,QAAgB;;;;;WAKxB,SAAS,cAAc,UAAU;;WAEjC,UAAU;;WAEV;;;;;;cAOE,QAAS,GAAG,GAAG,GAAC,MACrB,OAAO,MAAM,2BAAyB,WACjC,OAAO,MAAM,2BAAyB,MAC3C,OAAO,MAAM,8BAAyB,OAAA;;;;;;;;;;;;;;;;;;;KAiBlC,OAAO,GAAG,GAAG,GAAG,UAAU,WAAW;;WAEtC,SAAS,OAAO,MAAM,OAAO,OAAO;;WAEpC,SAAS,KAAK,QAAgB,OAAO;;WAErC,eAAe,mBAAmB,OAAO,OAAO;;;;;;WAMhD,cAAc,OAAO,GAAG,OAAO,WAAmB,OAAO,OAAO,OAAO;;KAGtE,KAAK,GAAG,GAAG,GAAG,UAAU,WAAW;WACpC,SAAS,MAAM,GAAG,GAAG;WACrB,OAAO,OAAO,MAAM,GAAG,GAAG,IAAI,UAAU,SAAS,OAAO,MAAM,GAAG,GAAG;;WAEpE,YAAY,OAAO,MAAM,GAAG,GAAG,IAAI,OAAO,MAAM,MAAM,GAAG,GAAG;;WAE5D,QAAQ,OAAO,MAAM,GAAG,GAAG,IAAI,uCAAuC,MAAM,GAAG,GAAG;;;cAIhF,WAAY,GAAG,GAAG,UAAU,UAAQ,OAAS,MAAM,GAAG,GAAG,IAAE,IAAM;;cAKjE,gBAAiB,GAAG,GAAG,UAAU,UAAQ,OAC7C,MAAM,GAAG,GAAG,IAAE,eAEpB,MAAM,GAAG,GAAG;iBAQC,KAAK;WAAqB,IAAI;GAAW,GAAG,GAAG,UAAU,WAAW,SAClF,QAAQ,OAAO,GAAG,GAAG,GAAG,KACvB,KAAK,GAAG,GAAG,GAAG;;cA4IJ,aAAW,OAAA;;;;;;;;;;;;;KACZ,qBAAqB,YAAY;cAEhC,QAAM,OAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAEP,OAAO,UAAU,WAAW,WAAW,MAAM,aAAa,QAAgB,IAAI;KAC9E,QAAQ,UAAU,WAAW,WAAW,MAAM,aAAa,QAAgB;;KAG3E;WACD,IAAI;WACJ,WAAW,cAAc;;;cAIvB,YAAa,UAAU,WAAW,cAAY,KACzD,aACA,aACA,QAAgB,IAChB;cAUW,QAAM,KAAA;;;;;;;;;;;;GAAc,QAAA,UAAA;cAElB,SAAO;;;;;;;;;;;;GAAE,QAAA,UAAA,UAAA,OAAI,OAAA;;;;;;;;;;;;;;;;;;;;;;;;GAAE,QAAA,UAAA,UAAA,YAAS,OAAA;;;;;;;;;;;;;;;;;;;;;;;;GAAE,QAAA,UAAA,UAAA,QAAK,OAAA;;;;;;;;;;;;GAjMI,QAAA,UAAA,UAAA,uCAA0B;;;;;;;;;;;;GAiMnB,QAAA,UAAA"}

package/dist/Thread.d.mts

@@ -0,0 +1,2 @@
+import { _ as presetFor, a as Message, b as truncateAfter, c as Thread, d as UserEntry, f as ended, g as preset, h as make, i as Fold, m as initial, n as Config, o as PresetInput, p as hasInput, r as Entry, s as State, t as AssistantEntry, u as UserContent, v as step, y as submitted } from "./Thread-CAXsjhpX.mjs";
+export { AssistantEntry, Config, Entry, Fold, Message, PresetInput, State, Thread, UserContent, UserEntry, ended, hasInput, initial, make, preset, presetFor, step, submitted, truncateAfter };