@effect-uai/ui 0.0.0-stage → 0.17.0

package/dist/SseEncoding.d.mts

@@ -0,0 +1,437 @@
+import { Envelope } from "./RunEvent.mjs";
+import { Option, Schema, Stream } from "effect";
+import { Sse } from "effect/encoding";
+declare namespace SseEncoding_d_exports {
+  export { EnvelopeEvent, decode, encode, lastEventId, responseHeaders };
+}
+/** An envelope as an SSE event: `id` = seq, `event` = type, `data` = the envelope as JSON. */
+declare const EnvelopeEvent: Schema.decodeTo<Schema.toType<Schema.Struct<{
+  readonly streamId: Schema.brand<Schema.String, "StreamId">;
+  readonly seq: Schema.Int;
+  readonly runId: Schema.optional<Schema.brand<Schema.String, "RunId">>;
+  readonly event: Schema.Union<readonly [Schema.Struct<{
+    readonly type: Schema.Literal<"run-started">;
+  } & {
+    readonly runId: Schema.brand<Schema.String, "RunId">;
+    readonly name: Schema.optional<Schema.String>;
+    readonly inputs: Schema.$Array<Schema.brand<Schema.String, "InputId">>;
+    readonly protocol: Schema.Literal<2>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"run-failed">;
+  } & {
+    readonly reason: Schema.String;
+    readonly message: Schema.optional<Schema.String>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"run-stopped">;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"step-started">;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"step-finished">;
+  } & {
+    readonly usage: Schema.optional<Schema.Struct<{
+      readonly input_tokens: Schema.optional<Schema.Number>;
+      readonly output_tokens: Schema.optional<Schema.Number>;
+      readonly total_tokens: Schema.optional<Schema.Number>;
+      readonly input_tokens_details: Schema.optional<Schema.Struct<{
+        readonly cached_tokens: Schema.optional<Schema.Number>;
+        readonly cache_write_tokens: Schema.optional<Schema.Number>;
+      }>>;
+      readonly output_tokens_details: Schema.optional<Schema.Struct<{
+        readonly reasoning_tokens: Schema.optional<Schema.Number>;
+      }>>;
+    }>>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"step-reset">;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"text-delta">;
+  } & {
+    readonly text: Schema.String;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"refusal-delta">;
+  } & {
+    readonly text: Schema.String;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"reasoning-started">;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"reasoning-delta">;
+  } & {
+    readonly text: Schema.String;
+    readonly kind: Schema.Literals<readonly ["trace", "summary"]>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"citation">;
+  } & {
+    readonly annotation: Schema.Union<readonly [Schema.Struct<{
+      readonly type: Schema.Literal<"url_citation">;
+      readonly url: Schema.String;
+      readonly title: Schema.String;
+      readonly start_index: Schema.optional<Schema.Number>;
+      readonly end_index: Schema.optional<Schema.Number>;
+      readonly cited_text: Schema.optional<Schema.String>;
+      readonly marker: Schema.optional<Schema.Number>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"file_citation">;
+      readonly file_id: Schema.String;
+      readonly index: Schema.Number;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"container_file_citation">;
+      readonly container_id: Schema.String;
+      readonly file_id: Schema.String;
+      readonly start_index: Schema.Number;
+      readonly end_index: Schema.Number;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"file_path">;
+      readonly file_id: Schema.String;
+      readonly index: Schema.Number;
+    }>]>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"image">;
+  } & {
+    readonly image: Schema.Codec<import("@effect-uai/core/Image").ImageSource, import("@effect-uai/core/Image").ImageSource, never, never>;
+    readonly partialIndex: Schema.optional<Schema.Number>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"object-started">;
+  } & {
+    readonly id: Schema.String;
+    readonly name: Schema.optional<Schema.String>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"object-delta">;
+  } & {
+    readonly id: Schema.String;
+    readonly patch: Schema.optional<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+      readonly op: Schema.Literal<"add">;
+      readonly path: Schema.String;
+      readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    }>, Schema.Struct<{
+      readonly op: Schema.Literal<"remove">;
+      readonly path: Schema.String;
+    }>, Schema.Struct<{
+      readonly op: Schema.Literal<"replace">;
+      readonly path: Schema.String;
+      readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    }>]>>>;
+    readonly value: Schema.optional<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"object-failed">;
+  } & {
+    readonly id: Schema.String;
+    readonly issues: Schema.$Array<Schema.Struct<{
+      readonly path: Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Number]>>;
+      readonly message: Schema.String;
+    }>>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"tool-call-started">;
+  } & {
+    readonly callId: Schema.String;
+    readonly name: Schema.String;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"tool-call-args-delta">;
+  } & {
+    readonly callId: Schema.String;
+    readonly delta: Schema.String;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"usage">;
+  } & {
+    readonly usage: Schema.Struct<{
+      readonly input_tokens: Schema.optional<Schema.Number>;
+      readonly output_tokens: Schema.optional<Schema.Number>;
+      readonly total_tokens: Schema.optional<Schema.Number>;
+      readonly input_tokens_details: Schema.optional<Schema.Struct<{
+        readonly cached_tokens: Schema.optional<Schema.Number>;
+        readonly cache_write_tokens: Schema.optional<Schema.Number>;
+      }>>;
+      readonly output_tokens_details: Schema.optional<Schema.Struct<{
+        readonly reasoning_tokens: Schema.optional<Schema.Number>;
+      }>>;
+    }>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"input-accepted">;
+  } & {
+    readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"run-completed">;
+  } & {
+    readonly metadata: Schema.optional<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"run-interrupted">;
+  } & {
+    readonly interrupts: Schema.$Array<Schema.Struct<{
+      readonly callId: Schema.String;
+      readonly reason: Schema.Literal<"approval">;
+      readonly name: Schema.String;
+      readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    }>>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"object-done">;
+  } & {
+    readonly id: Schema.String;
+    readonly name: Schema.optional<Schema.String>;
+    readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"tool-call-ready">;
+  } & {
+    readonly callId: Schema.String;
+    readonly name: Schema.String;
+    readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"tool-approval-requested">;
+  } & {
+    readonly callId: Schema.String;
+    readonly name: Schema.String;
+    readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"tool-partial">;
+  } & {
+    readonly callId: Schema.String;
+    readonly name: Schema.String;
+    readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"tool-result">;
+  } & {
+    readonly callId: Schema.String;
+    readonly name: Schema.String;
+    readonly result: Schema.Union<readonly [Schema.TaggedStruct<"Success", {
+      readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    }>, Schema.TaggedStruct<"Failure", {
+      readonly error: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    }>]>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"data">;
+  } & {
+    readonly name: Schema.String;
+    readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    readonly id: Schema.optional<Schema.String>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"live">;
+  } & {
+    readonly name: Schema.String;
+    readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>]>;
+}>>, Schema.Struct<{
+  readonly id: Schema.optional<Schema.String>;
+  readonly event: Schema.String;
+  readonly data: Schema.fromJsonString<Schema.toCodecJson<Schema.Struct<{
+    readonly streamId: Schema.brand<Schema.String, "StreamId">;
+    readonly seq: Schema.Int;
+    readonly runId: Schema.optional<Schema.brand<Schema.String, "RunId">>;
+    readonly event: Schema.Union<readonly [Schema.Struct<{
+      readonly type: Schema.Literal<"run-started">;
+    } & {
+      readonly runId: Schema.brand<Schema.String, "RunId">;
+      readonly name: Schema.optional<Schema.String>;
+      readonly inputs: Schema.$Array<Schema.brand<Schema.String, "InputId">>;
+      readonly protocol: Schema.Literal<2>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"run-failed">;
+    } & {
+      readonly reason: Schema.String;
+      readonly message: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"run-stopped">;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"step-started">;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"step-finished">;
+    } & {
+      readonly usage: Schema.optional<Schema.Struct<{
+        readonly input_tokens: Schema.optional<Schema.Number>;
+        readonly output_tokens: Schema.optional<Schema.Number>;
+        readonly total_tokens: Schema.optional<Schema.Number>;
+        readonly input_tokens_details: Schema.optional<Schema.Struct<{
+          readonly cached_tokens: Schema.optional<Schema.Number>;
+          readonly cache_write_tokens: Schema.optional<Schema.Number>;
+        }>>;
+        readonly output_tokens_details: Schema.optional<Schema.Struct<{
+          readonly reasoning_tokens: Schema.optional<Schema.Number>;
+        }>>;
+      }>>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"step-reset">;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"text-delta">;
+    } & {
+      readonly text: Schema.String;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"refusal-delta">;
+    } & {
+      readonly text: Schema.String;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"reasoning-started">;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"reasoning-delta">;
+    } & {
+      readonly text: Schema.String;
+      readonly kind: Schema.Literals<readonly ["trace", "summary"]>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"citation">;
+    } & {
+      readonly annotation: Schema.Union<readonly [Schema.Struct<{
+        readonly type: Schema.Literal<"url_citation">;
+        readonly url: Schema.String;
+        readonly title: Schema.String;
+        readonly start_index: Schema.optional<Schema.Number>;
+        readonly end_index: Schema.optional<Schema.Number>;
+        readonly cited_text: Schema.optional<Schema.String>;
+        readonly marker: Schema.optional<Schema.Number>;
+      }>, Schema.Struct<{
+        readonly type: Schema.Literal<"file_citation">;
+        readonly file_id: Schema.String;
+        readonly index: Schema.Number;
+      }>, Schema.Struct<{
+        readonly type: Schema.Literal<"container_file_citation">;
+        readonly container_id: Schema.String;
+        readonly file_id: Schema.String;
+        readonly start_index: Schema.Number;
+        readonly end_index: Schema.Number;
+      }>, Schema.Struct<{
+        readonly type: Schema.Literal<"file_path">;
+        readonly file_id: Schema.String;
+        readonly index: Schema.Number;
+      }>]>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"image">;
+    } & {
+      readonly image: Schema.Codec<import("@effect-uai/core/Image").ImageSource, import("@effect-uai/core/Image").ImageSource, never, never>;
+      readonly partialIndex: Schema.optional<Schema.Number>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"object-started">;
+    } & {
+      readonly id: Schema.String;
+      readonly name: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"object-delta">;
+    } & {
+      readonly id: Schema.String;
+      readonly patch: Schema.optional<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+        readonly op: Schema.Literal<"add">;
+        readonly path: Schema.String;
+        readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+      }>, Schema.Struct<{
+        readonly op: Schema.Literal<"remove">;
+        readonly path: Schema.String;
+      }>, Schema.Struct<{
+        readonly op: Schema.Literal<"replace">;
+        readonly path: Schema.String;
+        readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+      }>]>>>;
+      readonly value: Schema.optional<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"object-failed">;
+    } & {
+      readonly id: Schema.String;
+      readonly issues: Schema.$Array<Schema.Struct<{
+        readonly path: Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Number]>>;
+        readonly message: Schema.String;
+      }>>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"tool-call-started">;
+    } & {
+      readonly callId: Schema.String;
+      readonly name: Schema.String;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"tool-call-args-delta">;
+    } & {
+      readonly callId: Schema.String;
+      readonly delta: Schema.String;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"usage">;
+    } & {
+      readonly usage: Schema.Struct<{
+        readonly input_tokens: Schema.optional<Schema.Number>;
+        readonly output_tokens: Schema.optional<Schema.Number>;
+        readonly total_tokens: Schema.optional<Schema.Number>;
+        readonly input_tokens_details: Schema.optional<Schema.Struct<{
+          readonly cached_tokens: Schema.optional<Schema.Number>;
+          readonly cache_write_tokens: Schema.optional<Schema.Number>;
+        }>>;
+        readonly output_tokens_details: Schema.optional<Schema.Struct<{
+          readonly reasoning_tokens: Schema.optional<Schema.Number>;
+        }>>;
+      }>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"input-accepted">;
+    } & {
+      readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"run-completed">;
+    } & {
+      readonly metadata: Schema.optional<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"run-interrupted">;
+    } & {
+      readonly interrupts: Schema.$Array<Schema.Struct<{
+        readonly callId: Schema.String;
+        readonly reason: Schema.Literal<"approval">;
+        readonly name: Schema.String;
+        readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+      }>>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"object-done">;
+    } & {
+      readonly id: Schema.String;
+      readonly name: Schema.optional<Schema.String>;
+      readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"tool-call-ready">;
+    } & {
+      readonly callId: Schema.String;
+      readonly name: Schema.String;
+      readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"tool-approval-requested">;
+    } & {
+      readonly callId: Schema.String;
+      readonly name: Schema.String;
+      readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"tool-partial">;
+    } & {
+      readonly callId: Schema.String;
+      readonly name: Schema.String;
+      readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"tool-result">;
+    } & {
+      readonly callId: Schema.String;
+      readonly name: Schema.String;
+      readonly result: Schema.Union<readonly [Schema.TaggedStruct<"Success", {
+        readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+      }>, Schema.TaggedStruct<"Failure", {
+        readonly error: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+      }>]>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"data">;
+    } & {
+      readonly name: Schema.String;
+      readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+      readonly id: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"live">;
+    } & {
+      readonly name: Schema.String;
+      readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    }>]>;
+  }>>>;
+}>, never, never>;
+/** Envelopes → an SSE response body. */
+declare const encode: <E, R>(self: Stream.Stream<Envelope, E, R>) => Stream.Stream<Uint8Array, E | Schema.SchemaError, R>;
+/** An SSE response body → envelopes. A `retry:` hint from the server fails with `Sse.Retry`. */
+declare const decode: <E, R>(self: Stream.Stream<Uint8Array, E, R>) => Stream.Stream<Envelope, E | Sse.Retry | Sse.SseError | Schema.SchemaError, R>;
+/**
+ * Headers an SSE response needs. Behind nginx-style proxies, also send
+ * `x-accel-buffering: no` so frames are not buffered.
+ */
+declare const responseHeaders: Readonly<Record<string, string>>;
+/**
+ * The `seq` a reconnecting SSE client last received, from the standard
+ * `Last-Event-ID` header (a browser's EventSource sends it on every
+ * auto-reconnect). Accepts web `Headers` or Effect's record headers.
+ *
+ * Prefer it over any position the app carries in the URL: EventSource keeps
+ * reconnecting to its original URL, so a URL position goes stale.
+ */
+declare const lastEventId: (headers: Headers | {
+  readonly [key: string]: string | undefined;
+}) => Option.Option<number>;
+//#endregion
+export { EnvelopeEvent, decode, encode, lastEventId, responseHeaders, SseEncoding_d_exports as t };
+//# sourceMappingURL=SseEncoding.d.mts.map

package/dist/SseEncoding.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SseEncoding.d.mts","names":[],"sources":["../src/SseEncoding.ts"],"mappings":";;;;;;;cAaa,eAAa,OAAA,SAAA,OAAA,OAAA,OAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAqBb,SAAU,GAAG,GAAC,MACnB,OAAO,OAAO,UAAU,GAAG,OAChC,OAAO,OAAO,YAAY,IAAI,OAAO,aAAa;;cAWxC,SAAU,GAAG,GAAC,MACnB,OAAO,OAAO,YAAY,GAAG,OAClC,OAAO,OAAO,UAAU,IAAI,IAAI,QAAQ,IAAI,WAAW,OAAO,aAAa;;;;;cAOjE,iBAAiB,SAAS;;;;;;;;;cAe1B,cAAW,SACb;YAAsB;MAC9B,OAAO"}

package/dist/SseEncoding.mjs

@@ -0,0 +1,64 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
+import { Envelope, EnvelopeJson } from "./RunEvent.mjs";
+import { Effect, Option, Schema, SchemaTransformation, Stream } from "effect";
+import { Sse } from "effect/encoding";
+//#region src/SseEncoding.ts
+/**
+* SSE framing for envelopes, on Effect's `effect/encoding/Sse`. A frame
+* carries `id: <seq>` (so a browser's auto-reconnect sends `Last-Event-ID`),
+* `event: <type>` and the envelope's JSON in `data`. `EnvelopeEvent` is that
+* mapping as a Schema; `encode` / `decode` run it with Effect's SSE
+* encoder and parser.
+* For NDJSON use `effect/encoding/Ndjson` with `RunEvent.EnvelopeJson`.
+*/
+var SseEncoding_exports = /* @__PURE__ */ __exportAll({
+	EnvelopeEvent: () => EnvelopeEvent,
+	decode: () => decode,
+	encode: () => encode,
+	lastEventId: () => lastEventId,
+	responseHeaders: () => responseHeaders
+});
+/** An envelope as an SSE event: `id` = seq, `event` = type, `data` = the envelope as JSON. */
+const EnvelopeEvent = Schema.Struct({
+	id: Schema.optional(Schema.String),
+	event: Schema.String,
+	data: Schema.fromJsonString(EnvelopeJson)
+}).pipe(Schema.decodeTo(Schema.toType(Envelope), SchemaTransformation.transform({
+	decode: (event) => event.data,
+	encode: (envelope) => ({
+		id: String(envelope.seq),
+		event: envelope.event.type,
+		data: envelope
+	})
+})));
+const encodeEvent = Schema.encodeEffect(EnvelopeEvent);
+/** Envelopes → an SSE response body. */
+const encode = (self) => self.pipe(Stream.mapEffect((envelope) => encodeEvent(envelope).pipe(Effect.map((event) => Sse.encoder.write({
+	_tag: "Event",
+	id: event.id,
+	...event
+})))), Stream.encodeText);
+/** An SSE response body → envelopes. A `retry:` hint from the server fails with `Sse.Retry`. */
+const decode = (self) => self.pipe(Stream.decodeText, Stream.pipeThroughChannelOrFail(Sse.decodeSchema(EnvelopeEvent)));
+/**
+* Headers an SSE response needs. Behind nginx-style proxies, also send
+* `x-accel-buffering: no` so frames are not buffered.
+*/
+const responseHeaders = {
+	"content-type": "text/event-stream",
+	"cache-control": "no-cache"
+};
+const parseSeq = Schema.decodeUnknownOption(Schema.FiniteFromString.check(Schema.isInt()));
+/**
+* The `seq` a reconnecting SSE client last received, from the standard
+* `Last-Event-ID` header (a browser's EventSource sends it on every
+* auto-reconnect). Accepts web `Headers` or Effect's record headers.
+*
+* Prefer it over any position the app carries in the URL: EventSource keeps
+* reconnecting to its original URL, so a URL position goes stale.
+*/
+const lastEventId = (headers) => Option.fromNullishOr(headers instanceof Headers ? headers.get("last-event-id") : headers["last-event-id"]).pipe(Option.flatMap(parseSeq));
+//#endregion
+export { EnvelopeEvent, decode, encode, lastEventId, responseHeaders, SseEncoding_exports as t };
+
+//# sourceMappingURL=SseEncoding.mjs.map

package/dist/SseEncoding.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SseEncoding.mjs","names":[],"sources":["../src/SseEncoding.ts"],"sourcesContent":["/**\n * SSE framing for envelopes, on Effect's `effect/encoding/Sse`. A frame\n * carries `id: <seq>` (so a browser's auto-reconnect sends `Last-Event-ID`),\n * `event: <type>` and the envelope's JSON in `data`. `EnvelopeEvent` is that\n * mapping as a Schema; `encode` / `decode` run it with Effect's SSE\n * encoder and parser.\n * For NDJSON use `effect/encoding/Ndjson` with `RunEvent.EnvelopeJson`.\n */\nimport { Effect, Option, Schema, SchemaTransformation, Stream } from \"effect\"\nimport { Sse } from \"effect/encoding\"\nimport { Envelope, EnvelopeJson } from \"./RunEvent.js\"\n\n/** An envelope as an SSE event: `id` = seq, `event` = type, `data` = the envelope as JSON. */\nexport const EnvelopeEvent = Schema.Struct({\n  id: Schema.optional(Schema.String),\n  event: Schema.String,\n  data: Schema.fromJsonString(EnvelopeJson),\n}).pipe(\n  Schema.decodeTo(\n    Schema.toType(Envelope),\n    SchemaTransformation.transform({\n      decode: (event) => event.data,\n      encode: (envelope) => ({\n        id: String(envelope.seq),\n        event: envelope.event.type,\n        data: envelope,\n      }),\n    }),\n  ),\n)\n\nconst encodeEvent = Schema.encodeEffect(EnvelopeEvent)\n\n/** Envelopes → an SSE response body. */\nexport const encode = <E, R>(\n  self: Stream.Stream<Envelope, E, R>,\n): Stream.Stream<Uint8Array, E | Schema.SchemaError, R> =>\n  self.pipe(\n    Stream.mapEffect((envelope) =>\n      encodeEvent(envelope).pipe(\n        Effect.map((event) => Sse.encoder.write({ _tag: \"Event\", id: event.id, ...event })),\n      ),\n    ),\n    Stream.encodeText,\n  )\n\n/** An SSE response body → envelopes. A `retry:` hint from the server fails with `Sse.Retry`. */\nexport const decode = <E, R>(\n  self: Stream.Stream<Uint8Array, E, R>,\n): Stream.Stream<Envelope, E | Sse.Retry | Sse.SseError | Schema.SchemaError, R> =>\n  self.pipe(Stream.decodeText, Stream.pipeThroughChannelOrFail(Sse.decodeSchema(EnvelopeEvent)))\n\n/**\n * Headers an SSE response needs. Behind nginx-style proxies, also send\n * `x-accel-buffering: no` so frames are not buffered.\n */\nexport const responseHeaders: Readonly<Record<string, string>> = {\n  \"content-type\": \"text/event-stream\",\n  \"cache-control\": \"no-cache\",\n}\n\nconst parseSeq = Schema.decodeUnknownOption(Schema.FiniteFromString.check(Schema.isInt()))\n\n/**\n * The `seq` a reconnecting SSE client last received, from the standard\n * `Last-Event-ID` header (a browser's EventSource sends it on every\n * auto-reconnect). Accepts web `Headers` or Effect's record headers.\n *\n * Prefer it over any position the app carries in the URL: EventSource keeps\n * reconnecting to its original URL, so a URL position goes stale.\n */\nexport const lastEventId = (\n  headers: Headers | { readonly [key: string]: string | undefined },\n): Option.Option<number> =>\n  Option.fromNullishOr(\n    headers instanceof Headers ? headers.get(\"last-event-id\") : headers[\"last-event-id\"],\n  ).pipe(Option.flatMap(parseSeq))\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAaA,MAAa,gBAAgB,OAAO,OAAO;CACzC,IAAI,OAAO,SAAS,OAAO,MAAM;CACjC,OAAO,OAAO;CACd,MAAM,OAAO,eAAe,YAAY;AAC1C,CAAC,CAAC,CAAC,KACD,OAAO,SACL,OAAO,OAAO,QAAQ,GACtB,qBAAqB,UAAU;CAC7B,SAAS,UAAU,MAAM;CACzB,SAAS,cAAc;EACrB,IAAI,OAAO,SAAS,GAAG;EACvB,OAAO,SAAS,MAAM;EACtB,MAAM;CACR;AACF,CAAC,CACH,CACF;AAEA,MAAM,cAAc,OAAO,aAAa,aAAa;;AAGrD,MAAa,UACX,SAEA,KAAK,KACH,OAAO,WAAW,aAChB,YAAY,QAAQ,CAAC,CAAC,KACpB,OAAO,KAAK,UAAU,IAAI,QAAQ,MAAM;CAAE,MAAM;CAAS,IAAI,MAAM;CAAI,GAAG;AAAM,CAAC,CAAC,CACpF,CACF,GACA,OAAO,UACT;;AAGF,MAAa,UACX,SAEA,KAAK,KAAK,OAAO,YAAY,OAAO,yBAAyB,IAAI,aAAa,aAAa,CAAC,CAAC;;;;;AAM/F,MAAa,kBAAoD;CAC/D,gBAAgB;CAChB,iBAAiB;AACnB;AAEA,MAAM,WAAW,OAAO,oBAAoB,OAAO,iBAAiB,MAAM,OAAO,MAAM,CAAC,CAAC;;;;;;;;;AAUzF,MAAa,eACX,YAEA,OAAO,cACL,mBAAmB,UAAU,QAAQ,IAAI,eAAe,IAAI,QAAQ,gBACtE,CAAC,CAAC,KAAK,OAAO,QAAQ,QAAQ,CAAC"}