@effect-uai/chat-completions 0.11.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Betalyra Sociedade Unipessoal Lda.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,57 @@
+# @effect-uai/chat-completions
+
+Reusable OpenAI Chat Completions provider for [`@effect-uai/core`](https://www.npmjs.com/package/@effect-uai/core).
+
+Implements the `LanguageModel` contract against the `POST /chat/completions`
+wire dialect (SSE streaming, `messages[]`, `tool_calls`, `response_format`).
+Point it at any compatible endpoint by setting `baseUrl`: OpenRouter, Requesty,
+Groq, Together, or a self-hosted gateway.
+
+> Prefer [`@effect-uai/responses`](https://www.npmjs.com/package/@effect-uai/responses)
+> when the endpoint speaks the Responses protocol. Reach for chat-completions
+> only when it does not: this dialect has no typed reasoning items and no
+> server-side state (`store` / `previousResponseId`).
+
+## Install
+
+```sh
+pnpm add @effect-uai/chat-completions @effect-uai/core effect
+```
+
+ESM-only. Requires `effect@4.x` and `@effect-uai/core` as peers.
+
+## Usage
+
+```ts
+import { Config, Effect, Layer } from "effect"
+import { FetchHttpClient } from "effect/unstable/http"
+import { layer as chatLayer } from "@effect-uai/chat-completions/ChatCompletions"
+
+const provider = Layer.unwrap(
+  Effect.gen(function* () {
+    const apiKey = yield* Config.redacted("LLM_API_KEY")
+    return chatLayer({
+      apiKey,
+      baseUrl: "https://openrouter.ai/api/v1",
+      provider: "openrouter",
+    })
+  }),
+)
+
+const layer = Layer.provide(provider, FetchHttpClient.layer)
+```
+
+The layer registers the generic `LanguageModel` tag, so provider-agnostic loop
+bodies run against it unchanged. `model` is a plain string: these gateways ship
+hundreds of models, so there is no typed union.
+
+`ChatConfig` also accepts `path`, `authHeader`, `extraHeaders`, and `extraBody`
+for endpoints that diverge from the OpenRouter defaults.
+
+## Docs
+
+<https://effect-uai.betalyra.com/providers/>
+
+## License
+
+MIT

package/dist/ChatCompletions.d.mts

@@ -0,0 +1,28 @@
+import { Effect, Layer, Redacted } from "effect";
+import { HttpClient, HttpClientRequest } from "effect/unstable/http";
+import { CommonRequest, LanguageModel, LanguageModelService } from "@effect-uai/core/LanguageModel";
+
+//#region src/ChatCompletions.d.ts
+declare namespace ChatCompletions_d_exports {
+  export { ChatConfig, layer, make };
+}
+type ChatConfig = {
+  readonly apiKey: Redacted.Redacted; /** Provider base URL, e.g. `https://openrouter.ai/api/v1`. No trailing slash. */
+  readonly baseUrl: string; /** Name used to tag `AiError`s from this provider. */
+  readonly provider: string; /** Request path appended to `baseUrl`. Defaults to `/chat/completions`. */
+  readonly path?: string;
+  /**
+   * Override the auth header. Defaults to `Authorization: Bearer <apiKey>`.
+   * Supply this for gateways that authenticate differently (e.g. Azure `api-key`).
+   */
+  readonly authHeader?: (request: HttpClientRequest.HttpClientRequest) => HttpClientRequest.HttpClientRequest; /** Extra headers merged into every request (e.g. OpenRouter `HTTP-Referer`). */
+  readonly extraHeaders?: Record<string, string>; /** Provider-specific request-body fields merged into the wire body. */
+  readonly extraBody?: (request: CommonRequest) => Record<string, unknown>;
+};
+/** Build a generic chat-completions `LanguageModelService`. */
+declare const make: (cfg: ChatConfig) => Effect.Effect<LanguageModelService, never, HttpClient.HttpClient>;
+/** Layer registering the generic `LanguageModel` tag for a compatible gateway. */
+declare const layer: (cfg: ChatConfig) => Layer.Layer<LanguageModel, never, HttpClient.HttpClient>;
+//#endregion
+export { ChatConfig, layer, make, ChatCompletions_d_exports as t };
+//# sourceMappingURL=ChatCompletions.d.mts.map

package/dist/ChatCompletions.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatCompletions.d.mts","names":[],"sources":["../src/ChatCompletions.ts"],"mappings":";;;;;;;;KA8BY,UAAA;EAAA,SACD,MAAA,EAAQ,QAAA,CAAS,QAAA;WAEjB,OAAA;WAEA,QAAA;WAEA,IAAA;EAPC;;;;EAAA,SAYD,UAAA,IACP,OAAA,EAAS,iBAAA,CAAkB,iBAAA,KACxB,iBAAA,CAAkB,iBAAA,EAAlB;EAAA,SAEI,YAAA,GAAe,MAAA,kBAEO;EAAA,SAAtB,SAAA,IAAa,OAAA,EAAS,aAAA,KAAkB,MAAA;AAAA;;cAgGtC,IAAA,GACX,GAAA,EAAK,UAAA,KACJ,MAAA,CAAO,MAAA,CAAO,oBAAA,SAA6B,UAAA,CAAW,UAAA;;cAW5C,KAAA,GAAS,GAAA,EAAK,UAAA,KAAa,KAAA,CAAM,KAAA,CAAM,aAAA,SAAsB,UAAA,CAAW,UAAA"}

package/dist/ChatCompletions.mjs

@@ -0,0 +1,68 @@
+import { t as __exportAll } from "./chunk-CfYAbeIz.mjs";
+import { accumulatorToTurn, applyChunk, decodeChunk, emptyAccumulator, itemsToMessages, responseFormatWire, toolChoiceWire, toolsWire } from "./codec.mjs";
+import { httpStatusError, transportFailure } from "./http.mjs";
+import { Effect, Layer, Option, Result, Schema, Stream } from "effect";
+import { HttpClient, HttpClientRequest } from "effect/unstable/http";
+import * as AiError from "@effect-uai/core/AiError";
+import { LanguageModel, turnFromStream } from "@effect-uai/core/LanguageModel";
+import * as SSE from "@effect-uai/core/SSE";
+import { descriptorsOf } from "@effect-uai/core/Tool";
+import { TurnEvent } from "@effect-uai/core/Turn";
+//#region src/ChatCompletions.ts
+var ChatCompletions_exports = /* @__PURE__ */ __exportAll({
+	layer: () => layer,
+	make: () => make
+});
+const buildRequestBody = (cfg, request) => {
+	const tools = toolsWire(descriptorsOf(request.tools));
+	return {
+		model: request.model,
+		stream: true,
+		messages: itemsToMessages(request.history),
+		...request.temperature !== void 0 && { temperature: request.temperature },
+		...request.topP !== void 0 && { top_p: request.topP },
+		...request.maxOutputTokens !== void 0 && { max_tokens: request.maxOutputTokens },
+		...Option.isSome(tools) && { tools: tools.value },
+		...request.toolChoice !== void 0 && { tool_choice: toolChoiceWire(request.toolChoice) },
+		...request.structured !== void 0 && { response_format: responseFormatWire(request.structured) },
+		...cfg.extraBody?.(request) ?? {}
+	};
+};
+const parseJsonUnknown = Schema.decodeUnknownEffect(Schema.fromJsonString(Schema.Unknown));
+/**
+* Decode one SSE event's `data` payload into a `WireChunk`. Returns `None` for
+* the `[DONE]` sentinel and for any payload that isn't a chunk we model, so a
+* stray keep-alive never aborts the turn.
+*/
+const decodeEvent = (data) => data.trim() === "[DONE]" ? Effect.succeedNone : parseJsonUnknown(data).pipe(Effect.flatMap(decodeChunk), Effect.option);
+const buildStream = (cfg) => {
+	const url = `${cfg.baseUrl}${cfg.path ?? "/chat/completions"}`;
+	const auth = cfg.authHeader ?? HttpClientRequest.bearerToken(cfg.apiKey);
+	return (request) => Stream.unwrap(Effect.gen(function* () {
+		const client = yield* HttpClient.HttpClient;
+		const httpRequest = HttpClientRequest.post(url).pipe(auth, HttpClientRequest.setHeaders(cfg.extraHeaders ?? {}), HttpClientRequest.bodyJsonUnsafe(buildRequestBody(cfg, request)), HttpClientRequest.accept("text/event-stream"));
+		const response = yield* client.execute(httpRequest).pipe(Effect.mapError((cause) => transportFailure(cfg.provider, cause)));
+		if (response.status >= 400) {
+			const text = yield* response.text.pipe(Effect.orElseSucceed(() => ""));
+			return Stream.fail(httpStatusError(cfg.provider, response.status, text));
+		}
+		return response.stream.pipe(Stream.mapError((cause) => new AiError.Unavailable({
+			provider: cfg.provider,
+			raw: cause
+		})), SSE.fromBytes, Stream.mapEffect((ev) => decodeEvent(ev.data)), Stream.filterMap((chunk) => Option.isSome(chunk) ? Result.succeed(chunk.value) : Result.failVoid), Stream.mapAccum(() => emptyAccumulator, applyChunk, { onHalt: (acc) => Option.isSome(acc.finishReason) ? [TurnEvent.TurnComplete({ turn: accumulatorToTurn(acc) })] : [] }));
+	}));
+};
+/** Build a generic chat-completions `LanguageModelService`. */
+const make = (cfg) => Effect.map(HttpClient.HttpClient, (client) => {
+	const streamTurn = (request) => buildStream(cfg)(request).pipe(Stream.provideService(HttpClient.HttpClient, client));
+	return {
+		streamTurn,
+		turn: turnFromStream(streamTurn)
+	};
+});
+/** Layer registering the generic `LanguageModel` tag for a compatible gateway. */
+const layer = (cfg) => Layer.effect(LanguageModel, make(cfg));
+//#endregion
+export { layer, make, ChatCompletions_exports as t };
+
+//# sourceMappingURL=ChatCompletions.mjs.map

package/dist/ChatCompletions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatCompletions.mjs","names":[],"sources":["../src/ChatCompletions.ts"],"sourcesContent":["import { Effect, Layer, Option, Redacted, Result, Schema, Stream } from \"effect\"\nimport { HttpClient, HttpClientRequest } from \"effect/unstable/http\"\nimport * as AiError from \"@effect-uai/core/AiError\"\nimport {\n  type CommonRequest,\n  LanguageModel,\n  type LanguageModelService,\n  turnFromStream,\n} from \"@effect-uai/core/LanguageModel\"\nimport * as SSE from \"@effect-uai/core/SSE\"\nimport { descriptorsOf } from \"@effect-uai/core/Tool\"\nimport { TurnEvent } from \"@effect-uai/core/Turn\"\nimport {\n  type Accumulator,\n  type WireChunk,\n  accumulatorToTurn,\n  applyChunk,\n  decodeChunk,\n  emptyAccumulator,\n  itemsToMessages,\n  responseFormatWire,\n  toolChoiceWire,\n  toolsWire,\n} from \"./codec.js\"\nimport { httpStatusError, transportFailure } from \"./http.js\"\n\n// ---------------------------------------------------------------------------\n// Config\n// ---------------------------------------------------------------------------\n\nexport type ChatConfig = {\n  readonly apiKey: Redacted.Redacted\n  /** Provider base URL, e.g. `https://openrouter.ai/api/v1`. No trailing slash. */\n  readonly baseUrl: string\n  /** Name used to tag `AiError`s from this provider. */\n  readonly provider: string\n  /** Request path appended to `baseUrl`. Defaults to `/chat/completions`. */\n  readonly path?: string\n  /**\n   * Override the auth header. Defaults to `Authorization: Bearer <apiKey>`.\n   * Supply this for gateways that authenticate differently (e.g. Azure `api-key`).\n   */\n  readonly authHeader?: (\n    request: HttpClientRequest.HttpClientRequest,\n  ) => HttpClientRequest.HttpClientRequest\n  /** Extra headers merged into every request (e.g. OpenRouter `HTTP-Referer`). */\n  readonly extraHeaders?: Record<string, string>\n  /** Provider-specific request-body fields merged into the wire body. */\n  readonly extraBody?: (request: CommonRequest) => Record<string, unknown>\n}\n\n// ---------------------------------------------------------------------------\n// Request body\n// ---------------------------------------------------------------------------\n\nconst buildRequestBody = (cfg: ChatConfig, request: CommonRequest): Record<string, unknown> => {\n  const tools = toolsWire(descriptorsOf(request.tools))\n  return {\n    model: request.model,\n    stream: true,\n    messages: itemsToMessages(request.history),\n    ...(request.temperature !== undefined && { temperature: request.temperature }),\n    ...(request.topP !== undefined && { top_p: request.topP }),\n    ...(request.maxOutputTokens !== undefined && { max_tokens: request.maxOutputTokens }),\n    ...(Option.isSome(tools) && { tools: tools.value }),\n    ...(request.toolChoice !== undefined && { tool_choice: toolChoiceWire(request.toolChoice) }),\n    ...(request.structured !== undefined && {\n      response_format: responseFormatWire(request.structured),\n    }),\n    ...(cfg.extraBody?.(request) ?? {}),\n  }\n}\n\n// ---------------------------------------------------------------------------\n// SSE → WireChunk\n// ---------------------------------------------------------------------------\n\nconst parseJsonUnknown = Schema.decodeUnknownEffect(Schema.fromJsonString(Schema.Unknown))\n\n/**\n * Decode one SSE event's `data` payload into a `WireChunk`. Returns `None` for\n * the `[DONE]` sentinel and for any payload that isn't a chunk we model, so a\n * stray keep-alive never aborts the turn.\n */\nconst decodeEvent = (data: string): Effect.Effect<Option.Option<WireChunk>> =>\n  data.trim() === \"[DONE]\"\n    ? Effect.succeedNone\n    : parseJsonUnknown(data).pipe(Effect.flatMap(decodeChunk), Effect.option)\n\n// ---------------------------------------------------------------------------\n// Stream\n// ---------------------------------------------------------------------------\n\nconst buildStream = (cfg: ChatConfig) => {\n  const url = `${cfg.baseUrl}${cfg.path ?? \"/chat/completions\"}`\n  const auth = cfg.authHeader ?? HttpClientRequest.bearerToken(cfg.apiKey)\n  return (\n    request: CommonRequest,\n  ): Stream.Stream<TurnEvent, AiError.AiError, HttpClient.HttpClient> =>\n    Stream.unwrap(\n      Effect.gen(function* () {\n        const client = yield* HttpClient.HttpClient\n        const httpRequest = HttpClientRequest.post(url).pipe(\n          auth,\n          HttpClientRequest.setHeaders(cfg.extraHeaders ?? {}),\n          HttpClientRequest.bodyJsonUnsafe(buildRequestBody(cfg, request)),\n          HttpClientRequest.accept(\"text/event-stream\"),\n        )\n        const response = yield* client\n          .execute(httpRequest)\n          .pipe(Effect.mapError((cause) => transportFailure(cfg.provider, cause)))\n        if (response.status >= 400) {\n          const text = yield* response.text.pipe(Effect.orElseSucceed(() => \"\"))\n          return Stream.fail(httpStatusError(cfg.provider, response.status, text))\n        }\n\n        return response.stream.pipe(\n          Stream.mapError(\n            (cause): AiError.AiError =>\n              new AiError.Unavailable({ provider: cfg.provider, raw: cause }),\n          ),\n          SSE.fromBytes,\n          Stream.mapEffect((ev) => decodeEvent(ev.data)),\n          Stream.filterMap((chunk) =>\n            Option.isSome(chunk) ? Result.succeed(chunk.value) : Result.failVoid,\n          ),\n          Stream.mapAccum((): Accumulator => emptyAccumulator, applyChunk, {\n            // `onHalt` also fires on upstream failure and truncated streams, so\n            // only emit `TurnComplete` once a `finish_reason` was observed.\n            onHalt: (acc) =>\n              Option.isSome(acc.finishReason)\n                ? [TurnEvent.TurnComplete({ turn: accumulatorToTurn(acc) })]\n                : [],\n          }),\n        )\n      }),\n    )\n}\n\n// ---------------------------------------------------------------------------\n// Constructors\n// ---------------------------------------------------------------------------\n\n/** Build a generic chat-completions `LanguageModelService`. */\nexport const make = (\n  cfg: ChatConfig,\n): Effect.Effect<LanguageModelService, never, HttpClient.HttpClient> =>\n  Effect.map(HttpClient.HttpClient, (client) => {\n    const streamTurn: LanguageModelService[\"streamTurn\"] = (request) =>\n      buildStream(cfg)(request).pipe(Stream.provideService(HttpClient.HttpClient, client))\n    return {\n      streamTurn,\n      turn: turnFromStream(streamTurn),\n    }\n  })\n\n/** Layer registering the generic `LanguageModel` tag for a compatible gateway. */\nexport const layer = (cfg: ChatConfig): Layer.Layer<LanguageModel, never, HttpClient.HttpClient> =>\n  Layer.effect(LanguageModel, make(cfg))\n"],"mappings":";;;;;;;;;;;;;;;AAuDA,MAAM,oBAAoB,KAAiB,YAAoD;CAC7F,MAAM,QAAQ,UAAU,cAAc,QAAQ,MAAM,CAAC;AACrD,QAAO;EACL,OAAO,QAAQ;EACf,QAAQ;EACR,UAAU,gBAAgB,QAAQ,QAAQ;EAC1C,GAAI,QAAQ,gBAAgB,KAAA,KAAa,EAAE,aAAa,QAAQ,aAAa;EAC7E,GAAI,QAAQ,SAAS,KAAA,KAAa,EAAE,OAAO,QAAQ,MAAM;EACzD,GAAI,QAAQ,oBAAoB,KAAA,KAAa,EAAE,YAAY,QAAQ,iBAAiB;EACpF,GAAI,OAAO,OAAO,MAAM,IAAI,EAAE,OAAO,MAAM,OAAO;EAClD,GAAI,QAAQ,eAAe,KAAA,KAAa,EAAE,aAAa,eAAe,QAAQ,WAAW,EAAE;EAC3F,GAAI,QAAQ,eAAe,KAAA,KAAa,EACtC,iBAAiB,mBAAmB,QAAQ,WAAW,EACxD;EACD,GAAI,IAAI,YAAY,QAAQ,IAAI,EAAE;EACnC;;AAOH,MAAM,mBAAmB,OAAO,oBAAoB,OAAO,eAAe,OAAO,QAAQ,CAAC;;;;;;AAO1F,MAAM,eAAe,SACnB,KAAK,MAAM,KAAK,WACZ,OAAO,cACP,iBAAiB,KAAK,CAAC,KAAK,OAAO,QAAQ,YAAY,EAAE,OAAO,OAAO;AAM7E,MAAM,eAAe,QAAoB;CACvC,MAAM,MAAM,GAAG,IAAI,UAAU,IAAI,QAAQ;CACzC,MAAM,OAAO,IAAI,cAAc,kBAAkB,YAAY,IAAI,OAAO;AACxE,SACE,YAEA,OAAO,OACL,OAAO,IAAI,aAAa;EACtB,MAAM,SAAS,OAAO,WAAW;EACjC,MAAM,cAAc,kBAAkB,KAAK,IAAI,CAAC,KAC9C,MACA,kBAAkB,WAAW,IAAI,gBAAgB,EAAE,CAAC,EACpD,kBAAkB,eAAe,iBAAiB,KAAK,QAAQ,CAAC,EAChE,kBAAkB,OAAO,oBAAoB,CAC9C;EACD,MAAM,WAAW,OAAO,OACrB,QAAQ,YAAY,CACpB,KAAK,OAAO,UAAU,UAAU,iBAAiB,IAAI,UAAU,MAAM,CAAC,CAAC;AAC1E,MAAI,SAAS,UAAU,KAAK;GAC1B,MAAM,OAAO,OAAO,SAAS,KAAK,KAAK,OAAO,oBAAoB,GAAG,CAAC;AACtE,UAAO,OAAO,KAAK,gBAAgB,IAAI,UAAU,SAAS,QAAQ,KAAK,CAAC;;AAG1E,SAAO,SAAS,OAAO,KACrB,OAAO,UACJ,UACC,IAAI,QAAQ,YAAY;GAAE,UAAU,IAAI;GAAU,KAAK;GAAO,CAAC,CAClE,EACD,IAAI,WACJ,OAAO,WAAW,OAAO,YAAY,GAAG,KAAK,CAAC,EAC9C,OAAO,WAAW,UAChB,OAAO,OAAO,MAAM,GAAG,OAAO,QAAQ,MAAM,MAAM,GAAG,OAAO,SAC7D,EACD,OAAO,eAA4B,kBAAkB,YAAY,EAG/D,SAAS,QACP,OAAO,OAAO,IAAI,aAAa,GAC3B,CAAC,UAAU,aAAa,EAAE,MAAM,kBAAkB,IAAI,EAAE,CAAC,CAAC,GAC1D,EAAE,EACT,CAAC,CACH;GACD,CACH;;;AAQL,MAAa,QACX,QAEA,OAAO,IAAI,WAAW,aAAa,WAAW;CAC5C,MAAM,cAAkD,YACtD,YAAY,IAAI,CAAC,QAAQ,CAAC,KAAK,OAAO,eAAe,WAAW,YAAY,OAAO,CAAC;AACtF,QAAO;EACL;EACA,MAAM,eAAe,WAAW;EACjC;EACD;;AAGJ,MAAa,SAAS,QACpB,MAAM,OAAO,eAAe,KAAK,IAAI,CAAC"}

package/dist/chunk-CfYAbeIz.mjs

@@ -0,0 +1,13 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+export { __exportAll as t };

package/dist/codec.d.mts

@@ -0,0 +1,99 @@
+import { Option, Schema } from "effect";
+import { ToolDescriptor } from "@effect-uai/core/Tool";
+import { Turn, TurnEvent } from "@effect-uai/core/Turn";
+import * as _$effect_SchemaAST0 from "effect/SchemaAST";
+import * as _$effect_Effect0 from "effect/Effect";
+import { HistoryItem, Usage } from "@effect-uai/core/Items";
+import { StructuredFormat } from "@effect-uai/core/StructuredFormat";
+
+//#region src/codec.d.ts
+declare namespace codec_d_exports {
+  export { Accumulator, WireChunk, accumulatorToTurn, applyChunk, decodeChunk, emptyAccumulator, itemsToMessages, responseFormatWire, toolChoiceWire, toolsWire };
+}
+type WireMessage = {
+  role: string;
+  content: string | ReadonlyArray<Record<string, unknown>>;
+  tool_calls?: ReadonlyArray<Record<string, unknown>>;
+  tool_call_id?: string;
+};
+/** Convert our `HistoryItem[]` history into chat `messages`. */
+declare const itemsToMessages: (items: ReadonlyArray<HistoryItem>) => ReadonlyArray<WireMessage>;
+declare const toolsWire: (descriptors: ReadonlyArray<ToolDescriptor>) => Option.Option<ReadonlyArray<Record<string, unknown>>>;
+type ToolChoice = "auto" | "required" | "none" | {
+  readonly type: "function";
+  readonly name: string;
+};
+declare const toolChoiceWire: (choice: ToolChoice) => string | Record<string, unknown>;
+declare const responseFormatWire: (structured: StructuredFormat<unknown>) => Record<string, unknown>;
+declare const WireChunk: Schema.Struct<{
+  readonly choices: Schema.optional<Schema.$Array<Schema.Struct<{
+    readonly index: Schema.optional<Schema.Number>;
+    readonly delta: Schema.optional<Schema.Struct<{
+      readonly role: Schema.optional<Schema.NullOr<Schema.String>>;
+      readonly content: Schema.optional<Schema.NullOr<Schema.String>>;
+      readonly tool_calls: Schema.optional<Schema.NullOr<Schema.$Array<Schema.Struct<{
+        readonly index: Schema.optional<Schema.Number>;
+        readonly id: Schema.optional<Schema.NullOr<Schema.String>>;
+        readonly function: Schema.optional<Schema.Struct<{
+          readonly name: Schema.optional<Schema.NullOr<Schema.String>>;
+          readonly arguments: Schema.optional<Schema.NullOr<Schema.String>>;
+        }>>;
+      }>>>>;
+    }>>;
+    readonly finish_reason: Schema.optional<Schema.NullOr<Schema.String>>;
+  }>>>;
+  readonly usage: Schema.optional<Schema.NullOr<Schema.Struct<{
+    readonly prompt_tokens: Schema.optional<Schema.Number>;
+    readonly completion_tokens: Schema.optional<Schema.Number>;
+    readonly total_tokens: Schema.optional<Schema.Number>;
+  }>>>;
+}>;
+type WireChunk = typeof WireChunk.Type;
+declare const decodeChunk: (input: unknown, options?: _$effect_SchemaAST0.ParseOptions) => _$effect_Effect0.Effect<{
+  readonly choices?: readonly {
+    readonly index?: number | undefined;
+    readonly delta?: {
+      readonly role?: string | null | undefined;
+      readonly content?: string | null | undefined;
+      readonly tool_calls?: readonly {
+        readonly function?: {
+          readonly name?: string | null | undefined;
+          readonly arguments?: string | null | undefined;
+        } | undefined;
+        readonly id?: string | null | undefined;
+        readonly index?: number | undefined;
+      }[] | null | undefined;
+    } | undefined;
+    readonly finish_reason?: string | null | undefined;
+  }[] | undefined;
+  readonly usage?: {
+    readonly prompt_tokens?: number | undefined;
+    readonly completion_tokens?: number | undefined;
+    readonly total_tokens?: number | undefined;
+  } | null | undefined;
+}, Schema.SchemaError, never>;
+type ToolAcc = {
+  readonly call_id: string;
+  readonly name: string;
+  readonly arguments: string;
+};
+type Accumulator = {
+  readonly text: string; /** Tool calls keyed by their wire `index` (defaults to position when absent). */
+  readonly tools: ReadonlyMap<number, ToolAcc>;
+  readonly order: ReadonlyArray<number>;
+  readonly usage: Usage;
+  readonly finishReason: Option.Option<string>;
+};
+declare const emptyAccumulator: Accumulator;
+/** State threaded through the fold plus the events the step produced. */
+type Step = readonly [Accumulator, ReadonlyArray<TurnEvent>];
+/**
+ * Fold one decoded chunk into the accumulator, returning the next state and the
+ * `TurnEvent`s the chunk produced.
+ */
+declare const applyChunk: (acc: Accumulator, chunk: WireChunk) => Step;
+/** Assemble the terminal `Turn` from the accumulated state. */
+declare const accumulatorToTurn: (acc: Accumulator) => Turn;
+//#endregion
+export { Accumulator, WireChunk, accumulatorToTurn, applyChunk, decodeChunk, emptyAccumulator, itemsToMessages, responseFormatWire, codec_d_exports as t, toolChoiceWire, toolsWire };
+//# sourceMappingURL=codec.d.mts.map

package/dist/codec.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.d.mts","names":[],"sources":["../src/codec.ts"],"mappings":";;;;;;;;;;;;KAwBK,WAAA;EACH,IAAA;EACA,OAAA,WAAkB,aAAA,CAAc,MAAA;EAChC,UAAA,GAAa,aAAA,CAAc,MAAA;EAC3B,YAAA;AAAA;;cAuEW,eAAA,GAAmB,KAAA,EAAO,aAAA,CAAc,WAAA,MAAe,aAAA,CAAc,WAAA;AAAA,cAOrE,SAAA,GACX,WAAA,EAAa,aAAA,CAAc,cAAA,MAC1B,MAAA,CAAO,MAAA,CAAO,aAAA,CAAc,MAAA;AAAA,KAe1B,UAAA;EAAA,SAIU,IAAA;EAAA,SAA2B,IAAA;AAAA;AAAA,cAE7B,cAAA,GAAkB,MAAA,EAAQ,UAAA,cAAsB,MAAA;AAAA,cAQhD,kBAAA,GACX,UAAA,EAAY,gBAAA,cACX,MAAA;AAAA,cA0CU,SAAA,EAAS,MAAA,CAAA,MAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;KAIV,SAAA,UAAmB,SAAA,CAAU,IAAA;AAAA,cAE5B,WAAA,GAAW,KAAA,WAAA,OAAA,GAAwC,mBAAA,CAAxC,YAAA,sBAAA,MAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;KAMnB,OAAA;EAAA,SACM,OAAA;EAAA,SACA,IAAA;EAAA,SACA,SAAA;AAAA;AAAA,KAGC,WAAA;EAAA,SACD,IAAA,UA5F0B;EAAA,SA8F1B,KAAA,EAAO,WAAA,SAAoB,OAAA;EAAA,SAC3B,KAAA,EAAO,aAAA;EAAA,SACP,KAAA,EAAO,KAAA;EAAA,SACP,YAAA,EAAc,MAAA,CAAO,MAAA;AAAA;AAAA,cAGnB,gBAAA,EAAkB,WAAA;;KAS1B,IAAA,aAAiB,WAAA,EAAa,aAAA,CAAc,SAAA;;;;;cAqFpC,UAAA,GAAc,GAAA,EAAK,WAAA,EAAa,KAAA,EAAO,SAAA,KAAY,IAAA;;cAYnD,iBAAA,GAAqB,GAAA,EAAK,WAAA,KAAc,IAAA"}

package/dist/codec.mjs

@@ -0,0 +1,242 @@
+import { t as __exportAll } from "./chunk-CfYAbeIz.mjs";
+import { Array, Encoding, Match, Option, Schema } from "effect";
+import { TurnEvent } from "@effect-uai/core/Turn";
+//#region src/codec.ts
+var codec_exports = /* @__PURE__ */ __exportAll({
+	WireChunk: () => WireChunk,
+	accumulatorToTurn: () => accumulatorToTurn,
+	applyChunk: () => applyChunk,
+	decodeChunk: () => decodeChunk,
+	emptyAccumulator: () => emptyAccumulator,
+	itemsToMessages: () => itemsToMessages,
+	responseFormatWire: () => responseFormatWire,
+	toolChoiceWire: () => toolChoiceWire,
+	toolsWire: () => toolsWire
+});
+/** A `data:` URI for inline image bytes; URLs pass through untouched. */
+const imageSourceToUrl = Match.type().pipe(Match.tag("url", (s) => s.url), Match.tag("base64", (s) => `data:${s.mimeType};base64,${s.base64}`), Match.tag("bytes", (s) => `data:${s.mimeType};base64,${Encoding.encodeBase64(s.bytes)}`), Match.exhaustive);
+const blockToPart = Match.type().pipe(Match.discriminatorsExhaustive("type")({
+	input_text: (b) => ({
+		type: "text",
+		text: b.text
+	}),
+	output_text: (b) => ({
+		type: "text",
+		text: b.text
+	}),
+	refusal: (b) => ({
+		type: "text",
+		text: b.text
+	}),
+	input_image: (b) => ({
+		type: "image_url",
+		image_url: { url: imageSourceToUrl(b.source) }
+	})
+}));
+const isTextBlock = (b) => b.type === "input_text" || b.type === "output_text" || b.type === "refusal";
+const textOfBlock = (b) => b.type === "input_image" ? "" : b.text;
+/**
+* Collapse a message's content to a plain string when it is text-only (the
+* common case), otherwise emit the multimodal parts array.
+*/
+const encodeContent = (content) => Array.every(content, isTextBlock) ? content.map(textOfBlock).join("") : content.map(blockToPart);
+const toolCallWire = (call_id, name, args) => ({
+	id: call_id,
+	type: "function",
+	function: {
+		name,
+		arguments: args
+	}
+});
+const appendToolCall = (acc, call_id, name, args) => {
+	const last = acc[acc.length - 1];
+	const wire = toolCallWire(call_id, name, args);
+	if (last !== void 0 && last.role === "assistant" && last.tool_call_id === void 0) return [...acc.slice(0, -1), {
+		...last,
+		tool_calls: [...last.tool_calls ?? [], wire]
+	}];
+	return [...acc, {
+		role: "assistant",
+		content: "",
+		tool_calls: [wire]
+	}];
+};
+const foldItem = (acc, item) => Match.value(item).pipe(Match.discriminatorsExhaustive("type")({
+	message: (m) => [...acc, {
+		role: m.role,
+		content: encodeContent(m.content)
+	}],
+	function_call: (f) => appendToolCall(acc, f.call_id, f.name, f.arguments),
+	function_call_output: (o) => [...acc, {
+		role: "tool",
+		tool_call_id: o.call_id,
+		content: o.output
+	}],
+	reasoning: () => acc
+}));
+/** Convert our `HistoryItem[]` history into chat `messages`. */
+const itemsToMessages = (items) => Array.reduce(items, [], foldItem);
+const toolsWire = (descriptors) => descriptors.length > 0 ? Option.some(descriptors.map((t) => ({
+	type: "function",
+	function: {
+		name: t.name,
+		description: t.description,
+		parameters: t.inputSchema,
+		...t.strict !== void 0 && { strict: t.strict }
+	}
+}))) : Option.none();
+const toolChoiceWire = (choice) => Match.value(choice).pipe(Match.when("auto", () => "auto"), Match.when("required", () => "required"), Match.when("none", () => "none"), Match.orElse((c) => ({
+	type: "function",
+	function: { name: c.name }
+})));
+const responseFormatWire = (structured) => ({
+	type: "json_schema",
+	json_schema: {
+		name: structured.name,
+		schema: structured.schema["~standard"].jsonSchema.input({ target: "draft-2020-12" }),
+		...structured.strict !== void 0 && { strict: structured.strict }
+	}
+});
+const WireFunction = Schema.Struct({
+	name: Schema.optional(Schema.NullOr(Schema.String)),
+	arguments: Schema.optional(Schema.NullOr(Schema.String))
+});
+const WireToolCall = Schema.Struct({
+	index: Schema.optional(Schema.Number),
+	id: Schema.optional(Schema.NullOr(Schema.String)),
+	function: Schema.optional(WireFunction)
+});
+const WireDelta = Schema.Struct({
+	role: Schema.optional(Schema.NullOr(Schema.String)),
+	content: Schema.optional(Schema.NullOr(Schema.String)),
+	tool_calls: Schema.optional(Schema.NullOr(Schema.Array(WireToolCall)))
+});
+const WireChoice = Schema.Struct({
+	index: Schema.optional(Schema.Number),
+	delta: Schema.optional(WireDelta),
+	finish_reason: Schema.optional(Schema.NullOr(Schema.String))
+});
+const WireUsage = Schema.Struct({
+	prompt_tokens: Schema.optional(Schema.Number),
+	completion_tokens: Schema.optional(Schema.Number),
+	total_tokens: Schema.optional(Schema.Number)
+});
+const WireChunk = Schema.Struct({
+	choices: Schema.optional(Schema.Array(WireChoice)),
+	usage: Schema.optional(Schema.NullOr(WireUsage))
+});
+const decodeChunk = Schema.decodeUnknownEffect(WireChunk);
+const emptyAccumulator = {
+	text: "",
+	tools: /* @__PURE__ */ new Map(),
+	order: [],
+	usage: {},
+	finishReason: Option.none()
+};
+const usageFrom = (wire) => ({
+	...wire.prompt_tokens !== void 0 && { input_tokens: wire.prompt_tokens },
+	...wire.completion_tokens !== void 0 && { output_tokens: wire.completion_tokens },
+	...wire.total_tokens !== void 0 && { total_tokens: wire.total_tokens }
+});
+const reasonToStop = Match.type().pipe(Match.when("stop", () => "stop"), Match.when("length", () => "max_tokens"), Match.when("tool_calls", () => "tool_calls"), Match.when("content_filter", () => "content_filter"), Match.orElse(() => "stop"));
+const stopReasonOf = (acc) => Option.match(acc.finishReason, {
+	onNone: () => acc.tools.size > 0 ? "tool_calls" : "stop",
+	onSome: reasonToStop
+});
+const withTool = (acc, index, tool, isNew) => ({
+	...acc,
+	tools: new Map(acc.tools).set(index, tool),
+	order: isNew ? [...acc.order, index] : acc.order
+});
+const applyContent = (acc, delta) => {
+	const content = delta?.content;
+	return content !== void 0 && content !== null && content.length > 0 ? [{
+		...acc,
+		text: acc.text + content
+	}, [TurnEvent.TextDelta({ text: content })]] : [acc, []];
+};
+const applyToolCall = (acc, tc, position) => {
+	const index = tc.index ?? position;
+	const argsDelta = tc.function?.arguments ?? "";
+	const existing = acc.tools.get(index);
+	if (existing === void 0) {
+		const call_id = tc.id ?? String(index).padStart(9, "0");
+		const name = tc.function?.name ?? "";
+		return [withTool(acc, index, {
+			call_id,
+			name,
+			arguments: argsDelta
+		}, true), [TurnEvent.ToolCallStart({
+			call_id,
+			name
+		}), ...argsDelta.length > 0 ? [TurnEvent.ToolCallArgsDelta({
+			call_id,
+			delta: argsDelta
+		})] : []]];
+	}
+	return argsDelta.length > 0 ? [withTool(acc, index, {
+		...existing,
+		arguments: existing.arguments + argsDelta
+	}, false), [TurnEvent.ToolCallArgsDelta({
+		call_id: existing.call_id,
+		delta: argsDelta
+	})]] : [acc, []];
+};
+const chain = (step, next) => {
+	const [acc, events] = step;
+	const [acc2, more] = next(acc);
+	return [acc2, [...events, ...more]];
+};
+const applyChoice = (step, choice) => {
+	const withContent = chain(step, (acc) => applyContent(acc, choice.delta));
+	const withTools = Array.reduce(choice.delta?.tool_calls ?? [], withContent, (s, tc, i) => chain(s, (acc) => applyToolCall(acc, tc, i)));
+	const reason = choice.finish_reason;
+	return reason !== void 0 && reason !== null ? [{
+		...withTools[0],
+		finishReason: Option.some(reason)
+	}, withTools[1]] : withTools;
+};
+/**
+* Fold one decoded chunk into the accumulator, returning the next state and the
+* `TurnEvent`s the chunk produced.
+*/
+const applyChunk = (acc, chunk) => {
+	const afterChoices = Array.reduce(chunk.choices ?? [], [acc, []], applyChoice);
+	const usage = chunk.usage;
+	return usage !== void 0 && usage !== null ? chain(afterChoices, (a) => {
+		const u = usageFrom(usage);
+		return [{
+			...a,
+			usage: u
+		}, [TurnEvent.UsageUpdate({ usage: u })]];
+	}) : afterChoices;
+};
+/** Assemble the terminal `Turn` from the accumulated state. */
+const accumulatorToTurn = (acc) => {
+	const message = acc.text.length > 0 ? [{
+		type: "message",
+		role: "assistant",
+		content: [{
+			type: "output_text",
+			text: acc.text
+		}]
+	}] : [];
+	const toolCalls = acc.order.flatMap((index) => {
+		const t = acc.tools.get(index);
+		return t === void 0 ? [] : [{
+			type: "function_call",
+			call_id: t.call_id,
+			name: t.name,
+			arguments: t.arguments
+		}];
+	});
+	return {
+		items: [...message, ...toolCalls],
+		usage: acc.usage,
+		stop_reason: stopReasonOf(acc)
+	};
+};
+//#endregion
+export { WireChunk, accumulatorToTurn, applyChunk, decodeChunk, emptyAccumulator, itemsToMessages, responseFormatWire, codec_exports as t, toolChoiceWire, toolsWire };
+
+//# sourceMappingURL=codec.mjs.map

package/dist/codec.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.mjs","names":["Arr"],"sources":["../src/codec.ts"],"sourcesContent":["import { Array as Arr, Encoding, Match, Option, Schema } from \"effect\"\nimport type {\n  ContentBlock,\n  HistoryItem,\n  InputImage,\n  StopReason,\n  Usage,\n} from \"@effect-uai/core/Items\"\nimport type { StructuredFormat } from \"@effect-uai/core/StructuredFormat\"\nimport type { ToolDescriptor } from \"@effect-uai/core/Tool\"\nimport type { Turn } from \"@effect-uai/core/Turn\"\nimport { TurnEvent } from \"@effect-uai/core/Turn\"\n\n// ---------------------------------------------------------------------------\n// History → chat `messages`\n//\n// The OpenAI Chat Completions dialect: a flat list of `{ role, content, ... }`\n// objects where an assistant turn's tool calls live on the assistant message\n// (`tool_calls`) and each tool result is its own\n// `{ role: \"tool\", tool_call_id, content }` message. Our history is a flatter\n// item list (assistant message, then separate `function_call` items), so we\n// fold consecutive `function_call`s onto the preceding assistant message.\n// ---------------------------------------------------------------------------\n\ntype WireMessage = {\n  role: string\n  content: string | ReadonlyArray<Record<string, unknown>>\n  tool_calls?: ReadonlyArray<Record<string, unknown>>\n  tool_call_id?: string\n}\n\n/** A `data:` URI for inline image bytes; URLs pass through untouched. */\nconst imageSourceToUrl = Match.type<InputImage[\"source\"]>().pipe(\n  Match.tag(\"url\", (s) => s.url),\n  Match.tag(\"base64\", (s) => `data:${s.mimeType};base64,${s.base64}`),\n  Match.tag(\"bytes\", (s) => `data:${s.mimeType};base64,${Encoding.encodeBase64(s.bytes)}`),\n  Match.exhaustive,\n)\n\nconst blockToPart = Match.type<ContentBlock>().pipe(\n  Match.discriminatorsExhaustive(\"type\")({\n    input_text: (b) => ({ type: \"text\", text: b.text }),\n    output_text: (b) => ({ type: \"text\", text: b.text }),\n    refusal: (b) => ({ type: \"text\", text: b.text }),\n    input_image: (b) => ({ type: \"image_url\", image_url: { url: imageSourceToUrl(b.source) } }),\n  }),\n)\n\nconst isTextBlock = (b: ContentBlock): boolean =>\n  b.type === \"input_text\" || b.type === \"output_text\" || b.type === \"refusal\"\n\nconst textOfBlock = (b: ContentBlock): string => (b.type === \"input_image\" ? \"\" : b.text)\n\n/**\n * Collapse a message's content to a plain string when it is text-only (the\n * common case), otherwise emit the multimodal parts array.\n */\nconst encodeContent = (\n  content: ReadonlyArray<ContentBlock>,\n): string | ReadonlyArray<Record<string, unknown>> =>\n  Arr.every(content, isTextBlock) ? content.map(textOfBlock).join(\"\") : content.map(blockToPart)\n\nconst toolCallWire = (call_id: string, name: string, args: string): Record<string, unknown> => ({\n  id: call_id,\n  type: \"function\",\n  function: { name, arguments: args },\n})\n\nconst appendToolCall = (\n  acc: ReadonlyArray<WireMessage>,\n  call_id: string,\n  name: string,\n  args: string,\n): ReadonlyArray<WireMessage> => {\n  const last = acc[acc.length - 1]\n  const wire = toolCallWire(call_id, name, args)\n  // Attach to the immediately-preceding assistant message (not a tool result),\n  // matching the shape where tool calls ride the assistant turn.\n  if (last !== undefined && last.role === \"assistant\" && last.tool_call_id === undefined) {\n    return [...acc.slice(0, -1), { ...last, tool_calls: [...(last.tool_calls ?? []), wire] }]\n  }\n  return [...acc, { role: \"assistant\", content: \"\", tool_calls: [wire] }]\n}\n\nconst foldItem = (acc: ReadonlyArray<WireMessage>, item: HistoryItem): ReadonlyArray<WireMessage> =>\n  Match.value(item).pipe(\n    Match.discriminatorsExhaustive(\"type\")({\n      message: (m) => [...acc, { role: m.role, content: encodeContent(m.content) }],\n      function_call: (f) => appendToolCall(acc, f.call_id, f.name, f.arguments),\n      function_call_output: (o) => [\n        ...acc,\n        { role: \"tool\", tool_call_id: o.call_id, content: o.output },\n      ],\n      // Reasoning items are not replayed to the chat-completions endpoint.\n      reasoning: () => acc,\n    }),\n  )\n\n/** Convert our `HistoryItem[]` history into chat `messages`. */\nexport const itemsToMessages = (items: ReadonlyArray<HistoryItem>): ReadonlyArray<WireMessage> =>\n  Arr.reduce(items, [] as ReadonlyArray<WireMessage>, foldItem)\n\n// ---------------------------------------------------------------------------\n// tools / tool_choice / response_format\n// ---------------------------------------------------------------------------\n\nexport const toolsWire = (\n  descriptors: ReadonlyArray<ToolDescriptor>,\n): Option.Option<ReadonlyArray<Record<string, unknown>>> =>\n  descriptors.length > 0\n    ? Option.some(\n        descriptors.map((t) => ({\n          type: \"function\",\n          function: {\n            name: t.name,\n            description: t.description,\n            parameters: t.inputSchema,\n            ...(t.strict !== undefined && { strict: t.strict }),\n          },\n        })),\n      )\n    : Option.none()\n\ntype ToolChoice =\n  | \"auto\"\n  | \"required\"\n  | \"none\"\n  | { readonly type: \"function\"; readonly name: string }\n\nexport const toolChoiceWire = (choice: ToolChoice): string | Record<string, unknown> =>\n  Match.value(choice).pipe(\n    Match.when(\"auto\", () => \"auto\" as const),\n    Match.when(\"required\", () => \"required\" as const),\n    Match.when(\"none\", () => \"none\" as const),\n    Match.orElse((c) => ({ type: \"function\", function: { name: c.name } })),\n  )\n\nexport const responseFormatWire = (\n  structured: StructuredFormat<unknown>,\n): Record<string, unknown> => ({\n  type: \"json_schema\",\n  json_schema: {\n    name: structured.name,\n    schema: structured.schema[\"~standard\"].jsonSchema.input({ target: \"draft-2020-12\" }),\n    ...(structured.strict !== undefined && { strict: structured.strict }),\n  },\n})\n\n// ---------------------------------------------------------------------------\n// Streaming decode: chat.completion.chunk → TurnEvent\n// ---------------------------------------------------------------------------\n\nconst WireFunction = Schema.Struct({\n  name: Schema.optional(Schema.NullOr(Schema.String)),\n  arguments: Schema.optional(Schema.NullOr(Schema.String)),\n})\n\nconst WireToolCall = Schema.Struct({\n  index: Schema.optional(Schema.Number),\n  id: Schema.optional(Schema.NullOr(Schema.String)),\n  function: Schema.optional(WireFunction),\n})\n\nconst WireDelta = Schema.Struct({\n  role: Schema.optional(Schema.NullOr(Schema.String)),\n  content: Schema.optional(Schema.NullOr(Schema.String)),\n  tool_calls: Schema.optional(Schema.NullOr(Schema.Array(WireToolCall))),\n})\n\nconst WireChoice = Schema.Struct({\n  index: Schema.optional(Schema.Number),\n  delta: Schema.optional(WireDelta),\n  finish_reason: Schema.optional(Schema.NullOr(Schema.String)),\n})\n\nconst WireUsage = Schema.Struct({\n  prompt_tokens: Schema.optional(Schema.Number),\n  completion_tokens: Schema.optional(Schema.Number),\n  total_tokens: Schema.optional(Schema.Number),\n})\n\nexport const WireChunk = Schema.Struct({\n  choices: Schema.optional(Schema.Array(WireChoice)),\n  usage: Schema.optional(Schema.NullOr(WireUsage)),\n})\nexport type WireChunk = typeof WireChunk.Type\n\nexport const decodeChunk = Schema.decodeUnknownEffect(WireChunk)\n\n// ---------------------------------------------------------------------------\n// Accumulator\n// ---------------------------------------------------------------------------\n\ntype ToolAcc = {\n  readonly call_id: string\n  readonly name: string\n  readonly arguments: string\n}\n\nexport type Accumulator = {\n  readonly text: string\n  /** Tool calls keyed by their wire `index` (defaults to position when absent). */\n  readonly tools: ReadonlyMap<number, ToolAcc>\n  readonly order: ReadonlyArray<number>\n  readonly usage: Usage\n  readonly finishReason: Option.Option<string>\n}\n\nexport const emptyAccumulator: Accumulator = {\n  text: \"\",\n  tools: new Map(),\n  order: [],\n  usage: {},\n  finishReason: Option.none(),\n}\n\n/** State threaded through the fold plus the events the step produced. */\ntype Step = readonly [Accumulator, ReadonlyArray<TurnEvent>]\n\nconst usageFrom = (wire: typeof WireUsage.Type): Usage => ({\n  ...(wire.prompt_tokens !== undefined && { input_tokens: wire.prompt_tokens }),\n  ...(wire.completion_tokens !== undefined && { output_tokens: wire.completion_tokens }),\n  ...(wire.total_tokens !== undefined && { total_tokens: wire.total_tokens }),\n})\n\nconst reasonToStop = Match.type<string>().pipe(\n  Match.when(\"stop\", () => \"stop\" as const),\n  Match.when(\"length\", () => \"max_tokens\" as const),\n  Match.when(\"tool_calls\", () => \"tool_calls\" as const),\n  Match.when(\"content_filter\", () => \"content_filter\" as const),\n  Match.orElse(() => \"stop\" as const),\n)\n\nconst stopReasonOf = (acc: Accumulator): StopReason =>\n  Option.match(acc.finishReason, {\n    onNone: () => (acc.tools.size > 0 ? \"tool_calls\" : \"stop\"),\n    onSome: reasonToStop,\n  })\n\nconst withTool = (acc: Accumulator, index: number, tool: ToolAcc, isNew: boolean): Accumulator => ({\n  ...acc,\n  tools: new Map(acc.tools).set(index, tool),\n  order: isNew ? [...acc.order, index] : acc.order,\n})\n\nconst applyContent = (acc: Accumulator, delta: typeof WireDelta.Type | undefined): Step => {\n  const content = delta?.content\n  return content !== undefined && content !== null && content.length > 0\n    ? [{ ...acc, text: acc.text + content }, [TurnEvent.TextDelta({ text: content })]]\n    : [acc, []]\n}\n\nconst applyToolCall = (acc: Accumulator, tc: typeof WireToolCall.Type, position: number): Step => {\n  const index = tc.index ?? position\n  const argsDelta = tc.function?.arguments ?? \"\"\n  const existing = acc.tools.get(index)\n  if (existing === undefined) {\n    // Only `index` is guaranteed on a streaming tool-call chunk, so the id may\n    // be absent. The synthesised fallback is 9-char alphanumeric: valid on every\n    // chat-completions wire (Mistral additionally requires `^[a-zA-Z0-9]{9}$`),\n    // and it is replayed on the next turn.\n    const call_id = tc.id ?? String(index).padStart(9, \"0\")\n    const name = tc.function?.name ?? \"\"\n    return [\n      withTool(acc, index, { call_id, name, arguments: argsDelta }, true),\n      [\n        TurnEvent.ToolCallStart({ call_id, name }),\n        ...(argsDelta.length > 0\n          ? [TurnEvent.ToolCallArgsDelta({ call_id, delta: argsDelta })]\n          : []),\n      ],\n    ]\n  }\n  return argsDelta.length > 0\n    ? [\n        withTool(acc, index, { ...existing, arguments: existing.arguments + argsDelta }, false),\n        [TurnEvent.ToolCallArgsDelta({ call_id: existing.call_id, delta: argsDelta })],\n      ]\n    : [acc, []]\n}\n\nconst chain = (step: Step, next: (acc: Accumulator) => Step): Step => {\n  const [acc, events] = step\n  const [acc2, more] = next(acc)\n  return [acc2, [...events, ...more]]\n}\n\nconst applyChoice = (step: Step, choice: typeof WireChoice.Type): Step => {\n  const withContent = chain(step, (acc) => applyContent(acc, choice.delta))\n  const withTools = Arr.reduce(choice.delta?.tool_calls ?? [], withContent, (s: Step, tc, i) =>\n    chain(s, (acc) => applyToolCall(acc, tc, i)),\n  )\n  const reason = choice.finish_reason\n  return reason !== undefined && reason !== null\n    ? [{ ...withTools[0], finishReason: Option.some(reason) }, withTools[1]]\n    : withTools\n}\n\n/**\n * Fold one decoded chunk into the accumulator, returning the next state and the\n * `TurnEvent`s the chunk produced.\n */\nexport const applyChunk = (acc: Accumulator, chunk: WireChunk): Step => {\n  const afterChoices = Arr.reduce(chunk.choices ?? [], [acc, []] as Step, applyChoice)\n  const usage = chunk.usage\n  return usage !== undefined && usage !== null\n    ? chain(afterChoices, (a) => {\n        const u = usageFrom(usage)\n        return [{ ...a, usage: u }, [TurnEvent.UsageUpdate({ usage: u })]]\n      })\n    : afterChoices\n}\n\n/** Assemble the terminal `Turn` from the accumulated state. */\nexport const accumulatorToTurn = (acc: Accumulator): Turn => {\n  const message: ReadonlyArray<HistoryItem> =\n    acc.text.length > 0\n      ? [{ type: \"message\", role: \"assistant\", content: [{ type: \"output_text\", text: acc.text }] }]\n      : []\n  const toolCalls: ReadonlyArray<HistoryItem> = acc.order.flatMap((index) => {\n    const t = acc.tools.get(index)\n    return t === undefined\n      ? []\n      : [\n          {\n            type: \"function_call\" as const,\n            call_id: t.call_id,\n            name: t.name,\n            arguments: t.arguments,\n          },\n        ]\n  })\n  return {\n    items: [...message, ...toolCalls],\n    usage: acc.usage,\n    stop_reason: stopReasonOf(acc),\n  }\n}\n"],"mappings":"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"}

package/dist/http.d.mts

@@ -0,0 +1,12 @@
+import * as AiError from "@effect-uai/core/AiError";
+
+//#region src/http.d.ts
+declare namespace http_d_exports {
+  export { httpStatusError, transportFailure };
+}
+/** Map an HTTP status from a chat-completions endpoint to an `AiError` variant. */
+declare const httpStatusError: (provider: string, status: number, body: string) => AiError.AiError;
+declare const transportFailure: (provider: string, cause: unknown) => AiError.AiError;
+//#endregion
+export { httpStatusError, http_d_exports as t, transportFailure };
+//# sourceMappingURL=http.d.mts.map

package/dist/http.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.mts","names":[],"sources":["../src/http.ts"],"mappings":";;;;;;;cAIa,eAAA,GAAmB,QAAA,UAAkB,MAAA,UAAgB,IAAA,aAAe,OAAA,CAAQ,OAAA;AAAA,cA2B5E,gBAAA,GAAoB,QAAA,UAAkB,KAAA,cAAiB,OAAA,CAAQ,OAAA"}

package/dist/http.mjs

@@ -0,0 +1,46 @@
+import { t as __exportAll } from "./chunk-CfYAbeIz.mjs";
+import { Match } from "effect";
+import * as AiError from "@effect-uai/core/AiError";
+//#region src/http.ts
+var http_exports = /* @__PURE__ */ __exportAll({
+	httpStatusError: () => httpStatusError,
+	transportFailure: () => transportFailure
+});
+/** Map an HTTP status from a chat-completions endpoint to an `AiError` variant. */
+const httpStatusError = (provider, status, body) => Match.value(status).pipe(Match.when(429, () => new AiError.RateLimited({
+	provider,
+	raw: body
+})), Match.whenOr(408, 504, () => new AiError.Timeout({
+	provider,
+	raw: body
+})), Match.when(401, () => new AiError.AuthFailed({
+	provider,
+	subtype: "auth",
+	raw: body
+})), Match.when(403, () => new AiError.AuthFailed({
+	provider,
+	subtype: "permission",
+	raw: body
+})), Match.when(402, () => new AiError.AuthFailed({
+	provider,
+	subtype: "billing",
+	raw: body
+})), Match.when(413, () => new AiError.ContextLengthExceeded({
+	provider,
+	raw: body
+})), Match.when((n) => n >= 500, (n) => new AiError.Unavailable({
+	provider,
+	status: n,
+	raw: body
+})), Match.orElse(() => new AiError.InvalidRequest({
+	provider,
+	raw: body
+})));
+const transportFailure = (provider, cause) => new AiError.Unavailable({
+	provider,
+	raw: cause
+});
+//#endregion
+export { httpStatusError, http_exports as t, transportFailure };
+
+//# sourceMappingURL=http.mjs.map

package/dist/http.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.mjs","names":[],"sources":["../src/http.ts"],"sourcesContent":["import { Match } from \"effect\"\nimport * as AiError from \"@effect-uai/core/AiError\"\n\n/** Map an HTTP status from a chat-completions endpoint to an `AiError` variant. */\nexport const httpStatusError = (provider: string, status: number, body: string): AiError.AiError =>\n  Match.value(status).pipe(\n    Match.when(429, (): AiError.AiError => new AiError.RateLimited({ provider, raw: body })),\n    Match.whenOr(408, 504, (): AiError.AiError => new AiError.Timeout({ provider, raw: body })),\n    Match.when(\n      401,\n      (): AiError.AiError => new AiError.AuthFailed({ provider, subtype: \"auth\", raw: body }),\n    ),\n    Match.when(\n      403,\n      (): AiError.AiError => new AiError.AuthFailed({ provider, subtype: \"permission\", raw: body }),\n    ),\n    Match.when(\n      402,\n      (): AiError.AiError => new AiError.AuthFailed({ provider, subtype: \"billing\", raw: body }),\n    ),\n    Match.when(\n      413,\n      (): AiError.AiError => new AiError.ContextLengthExceeded({ provider, raw: body }),\n    ),\n    Match.when(\n      (n) => n >= 500,\n      (n): AiError.AiError => new AiError.Unavailable({ provider, status: n, raw: body }),\n    ),\n    Match.orElse((): AiError.AiError => new AiError.InvalidRequest({ provider, raw: body })),\n  )\n\nexport const transportFailure = (provider: string, cause: unknown): AiError.AiError =>\n  new AiError.Unavailable({ provider, raw: cause })\n"],"mappings":";;;;;;;;;AAIA,MAAa,mBAAmB,UAAkB,QAAgB,SAChE,MAAM,MAAM,OAAO,CAAC,KAClB,MAAM,KAAK,WAA4B,IAAI,QAAQ,YAAY;CAAE;CAAU,KAAK;CAAM,CAAC,CAAC,EACxF,MAAM,OAAO,KAAK,WAA4B,IAAI,QAAQ,QAAQ;CAAE;CAAU,KAAK;CAAM,CAAC,CAAC,EAC3F,MAAM,KACJ,WACuB,IAAI,QAAQ,WAAW;CAAE;CAAU,SAAS;CAAQ,KAAK;CAAM,CAAC,CACxF,EACD,MAAM,KACJ,WACuB,IAAI,QAAQ,WAAW;CAAE;CAAU,SAAS;CAAc,KAAK;CAAM,CAAC,CAC9F,EACD,MAAM,KACJ,WACuB,IAAI,QAAQ,WAAW;CAAE;CAAU,SAAS;CAAW,KAAK;CAAM,CAAC,CAC3F,EACD,MAAM,KACJ,WACuB,IAAI,QAAQ,sBAAsB;CAAE;CAAU,KAAK;CAAM,CAAC,CAClF,EACD,MAAM,MACH,MAAM,KAAK,MACX,MAAuB,IAAI,QAAQ,YAAY;CAAE;CAAU,QAAQ;CAAG,KAAK;CAAM,CAAC,CACpF,EACD,MAAM,aAA8B,IAAI,QAAQ,eAAe;CAAE;CAAU,KAAK;CAAM,CAAC,CAAC,CACzF;AAEH,MAAa,oBAAoB,UAAkB,UACjD,IAAI,QAAQ,YAAY;CAAE;CAAU,KAAK;CAAO,CAAC"}

package/dist/index.d.mts

@@ -0,0 +1,4 @@
+import { t as ChatCompletions_d_exports } from "./ChatCompletions.mjs";
+import { t as codec_d_exports } from "./codec.mjs";
+import { t as http_d_exports } from "./http.mjs";
+export { ChatCompletions_d_exports as ChatCompletions, codec_d_exports as codec, http_d_exports as http };

package/dist/index.mjs

@@ -0,0 +1,4 @@
+import { t as codec_exports } from "./codec.mjs";
+import { t as http_exports } from "./http.mjs";
+import { t as ChatCompletions_exports } from "./ChatCompletions.mjs";
+export { ChatCompletions_exports as ChatCompletions, codec_exports as codec, http_exports as http };

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@effect-uai/chat-completions",
+  "version": "0.11.0",
+  "description": "Reusable OpenAI Chat Completions (`/chat/completions`) LanguageModel base for @effect-uai/core. Point it at any compatible gateway (OpenRouter, Groq, Together, self-hosted).",
+  "keywords": [
+    "ai",
+    "chat-completions",
+    "effect",
+    "gateway",
+    "llm",
+    "openai",
+    "openrouter"
+  ],
+  "homepage": "https://github.com/betalyra/effect-uai/tree/main/packages/providers/chat-completions",
+  "bugs": {
+    "url": "https://github.com/betalyra/effect-uai/issues"
+  },
+  "license": "MIT",
+  "author": "Betalyra",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/betalyra/effect-uai",
+    "directory": "packages/providers/chat-completions"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    },
+    "./ChatCompletions": {
+      "types": "./dist/ChatCompletions.d.mts",
+      "import": "./dist/ChatCompletions.mjs"
+    },
+    "./codec": {
+      "types": "./dist/codec.d.mts",
+      "import": "./dist/codec.mjs"
+    },
+    "./http": {
+      "types": "./dist/http.d.mts",
+      "import": "./dist/http.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "effect": "4.0.0-beta.94",
+    "typescript": "^6.0.3",
+    "@effect-uai/core": "0.11.1"
+  },
+  "peerDependencies": {
+    "@effect-uai/core": ">=0.2.0 <1",
+    "effect": ">=4.0.0-beta.94 <5.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/ChatCompletions.ts

@@ -0,0 +1,159 @@
+import { Effect, Layer, Option, Redacted, Result, Schema, Stream } from "effect"
+import { HttpClient, HttpClientRequest } from "effect/unstable/http"
+import * as AiError from "@effect-uai/core/AiError"
+import {
+  type CommonRequest,
+  LanguageModel,
+  type LanguageModelService,
+  turnFromStream,
+} from "@effect-uai/core/LanguageModel"
+import * as SSE from "@effect-uai/core/SSE"
+import { descriptorsOf } from "@effect-uai/core/Tool"
+import { TurnEvent } from "@effect-uai/core/Turn"
+import {
+  type Accumulator,
+  type WireChunk,
+  accumulatorToTurn,
+  applyChunk,
+  decodeChunk,
+  emptyAccumulator,
+  itemsToMessages,
+  responseFormatWire,
+  toolChoiceWire,
+  toolsWire,
+} from "./codec.js"
+import { httpStatusError, transportFailure } from "./http.js"
+
+// ---------------------------------------------------------------------------
+// Config
+// ---------------------------------------------------------------------------
+
+export type ChatConfig = {
+  readonly apiKey: Redacted.Redacted
+  /** Provider base URL, e.g. `https://openrouter.ai/api/v1`. No trailing slash. */
+  readonly baseUrl: string
+  /** Name used to tag `AiError`s from this provider. */
+  readonly provider: string
+  /** Request path appended to `baseUrl`. Defaults to `/chat/completions`. */
+  readonly path?: string
+  /**
+   * Override the auth header. Defaults to `Authorization: Bearer <apiKey>`.
+   * Supply this for gateways that authenticate differently (e.g. Azure `api-key`).
+   */
+  readonly authHeader?: (
+    request: HttpClientRequest.HttpClientRequest,
+  ) => HttpClientRequest.HttpClientRequest
+  /** Extra headers merged into every request (e.g. OpenRouter `HTTP-Referer`). */
+  readonly extraHeaders?: Record<string, string>
+  /** Provider-specific request-body fields merged into the wire body. */
+  readonly extraBody?: (request: CommonRequest) => Record<string, unknown>
+}
+
+// ---------------------------------------------------------------------------
+// Request body
+// ---------------------------------------------------------------------------
+
+const buildRequestBody = (cfg: ChatConfig, request: CommonRequest): Record<string, unknown> => {
+  const tools = toolsWire(descriptorsOf(request.tools))
+  return {
+    model: request.model,
+    stream: true,
+    messages: itemsToMessages(request.history),
+    ...(request.temperature !== undefined && { temperature: request.temperature }),
+    ...(request.topP !== undefined && { top_p: request.topP }),
+    ...(request.maxOutputTokens !== undefined && { max_tokens: request.maxOutputTokens }),
+    ...(Option.isSome(tools) && { tools: tools.value }),
+    ...(request.toolChoice !== undefined && { tool_choice: toolChoiceWire(request.toolChoice) }),
+    ...(request.structured !== undefined && {
+      response_format: responseFormatWire(request.structured),
+    }),
+    ...(cfg.extraBody?.(request) ?? {}),
+  }
+}
+
+// ---------------------------------------------------------------------------
+// SSE → WireChunk
+// ---------------------------------------------------------------------------
+
+const parseJsonUnknown = Schema.decodeUnknownEffect(Schema.fromJsonString(Schema.Unknown))
+
+/**
+ * Decode one SSE event's `data` payload into a `WireChunk`. Returns `None` for
+ * the `[DONE]` sentinel and for any payload that isn't a chunk we model, so a
+ * stray keep-alive never aborts the turn.
+ */
+const decodeEvent = (data: string): Effect.Effect<Option.Option<WireChunk>> =>
+  data.trim() === "[DONE]"
+    ? Effect.succeedNone
+    : parseJsonUnknown(data).pipe(Effect.flatMap(decodeChunk), Effect.option)
+
+// ---------------------------------------------------------------------------
+// Stream
+// ---------------------------------------------------------------------------
+
+const buildStream = (cfg: ChatConfig) => {
+  const url = `${cfg.baseUrl}${cfg.path ?? "/chat/completions"}`
+  const auth = cfg.authHeader ?? HttpClientRequest.bearerToken(cfg.apiKey)
+  return (
+    request: CommonRequest,
+  ): Stream.Stream<TurnEvent, AiError.AiError, HttpClient.HttpClient> =>
+    Stream.unwrap(
+      Effect.gen(function* () {
+        const client = yield* HttpClient.HttpClient
+        const httpRequest = HttpClientRequest.post(url).pipe(
+          auth,
+          HttpClientRequest.setHeaders(cfg.extraHeaders ?? {}),
+          HttpClientRequest.bodyJsonUnsafe(buildRequestBody(cfg, request)),
+          HttpClientRequest.accept("text/event-stream"),
+        )
+        const response = yield* client
+          .execute(httpRequest)
+          .pipe(Effect.mapError((cause) => transportFailure(cfg.provider, cause)))
+        if (response.status >= 400) {
+          const text = yield* response.text.pipe(Effect.orElseSucceed(() => ""))
+          return Stream.fail(httpStatusError(cfg.provider, response.status, text))
+        }
+
+        return response.stream.pipe(
+          Stream.mapError(
+            (cause): AiError.AiError =>
+              new AiError.Unavailable({ provider: cfg.provider, raw: cause }),
+          ),
+          SSE.fromBytes,
+          Stream.mapEffect((ev) => decodeEvent(ev.data)),
+          Stream.filterMap((chunk) =>
+            Option.isSome(chunk) ? Result.succeed(chunk.value) : Result.failVoid,
+          ),
+          Stream.mapAccum((): Accumulator => emptyAccumulator, applyChunk, {
+            // `onHalt` also fires on upstream failure and truncated streams, so
+            // only emit `TurnComplete` once a `finish_reason` was observed.
+            onHalt: (acc) =>
+              Option.isSome(acc.finishReason)
+                ? [TurnEvent.TurnComplete({ turn: accumulatorToTurn(acc) })]
+                : [],
+          }),
+        )
+      }),
+    )
+}
+
+// ---------------------------------------------------------------------------
+// Constructors
+// ---------------------------------------------------------------------------
+
+/** Build a generic chat-completions `LanguageModelService`. */
+export const make = (
+  cfg: ChatConfig,
+): Effect.Effect<LanguageModelService, never, HttpClient.HttpClient> =>
+  Effect.map(HttpClient.HttpClient, (client) => {
+    const streamTurn: LanguageModelService["streamTurn"] = (request) =>
+      buildStream(cfg)(request).pipe(Stream.provideService(HttpClient.HttpClient, client))
+    return {
+      streamTurn,
+      turn: turnFromStream(streamTurn),
+    }
+  })
+
+/** Layer registering the generic `LanguageModel` tag for a compatible gateway. */
+export const layer = (cfg: ChatConfig): Layer.Layer<LanguageModel, never, HttpClient.HttpClient> =>
+  Layer.effect(LanguageModel, make(cfg))

package/src/codec.ts

@@ -0,0 +1,338 @@
+import { Array as Arr, Encoding, Match, Option, Schema } from "effect"
+import type {
+  ContentBlock,
+  HistoryItem,
+  InputImage,
+  StopReason,
+  Usage,
+} from "@effect-uai/core/Items"
+import type { StructuredFormat } from "@effect-uai/core/StructuredFormat"
+import type { ToolDescriptor } from "@effect-uai/core/Tool"
+import type { Turn } from "@effect-uai/core/Turn"
+import { TurnEvent } from "@effect-uai/core/Turn"
+
+// ---------------------------------------------------------------------------
+// History → chat `messages`
+//
+// The OpenAI Chat Completions dialect: a flat list of `{ role, content, ... }`
+// objects where an assistant turn's tool calls live on the assistant message
+// (`tool_calls`) and each tool result is its own
+// `{ role: "tool", tool_call_id, content }` message. Our history is a flatter
+// item list (assistant message, then separate `function_call` items), so we
+// fold consecutive `function_call`s onto the preceding assistant message.
+// ---------------------------------------------------------------------------
+
+type WireMessage = {
+  role: string
+  content: string | ReadonlyArray<Record<string, unknown>>
+  tool_calls?: ReadonlyArray<Record<string, unknown>>
+  tool_call_id?: string
+}
+
+/** A `data:` URI for inline image bytes; URLs pass through untouched. */
+const imageSourceToUrl = Match.type<InputImage["source"]>().pipe(
+  Match.tag("url", (s) => s.url),
+  Match.tag("base64", (s) => `data:${s.mimeType};base64,${s.base64}`),
+  Match.tag("bytes", (s) => `data:${s.mimeType};base64,${Encoding.encodeBase64(s.bytes)}`),
+  Match.exhaustive,
+)
+
+const blockToPart = Match.type<ContentBlock>().pipe(
+  Match.discriminatorsExhaustive("type")({
+    input_text: (b) => ({ type: "text", text: b.text }),
+    output_text: (b) => ({ type: "text", text: b.text }),
+    refusal: (b) => ({ type: "text", text: b.text }),
+    input_image: (b) => ({ type: "image_url", image_url: { url: imageSourceToUrl(b.source) } }),
+  }),
+)
+
+const isTextBlock = (b: ContentBlock): boolean =>
+  b.type === "input_text" || b.type === "output_text" || b.type === "refusal"
+
+const textOfBlock = (b: ContentBlock): string => (b.type === "input_image" ? "" : b.text)
+
+/**
+ * Collapse a message's content to a plain string when it is text-only (the
+ * common case), otherwise emit the multimodal parts array.
+ */
+const encodeContent = (
+  content: ReadonlyArray<ContentBlock>,
+): string | ReadonlyArray<Record<string, unknown>> =>
+  Arr.every(content, isTextBlock) ? content.map(textOfBlock).join("") : content.map(blockToPart)
+
+const toolCallWire = (call_id: string, name: string, args: string): Record<string, unknown> => ({
+  id: call_id,
+  type: "function",
+  function: { name, arguments: args },
+})
+
+const appendToolCall = (
+  acc: ReadonlyArray<WireMessage>,
+  call_id: string,
+  name: string,
+  args: string,
+): ReadonlyArray<WireMessage> => {
+  const last = acc[acc.length - 1]
+  const wire = toolCallWire(call_id, name, args)
+  // Attach to the immediately-preceding assistant message (not a tool result),
+  // matching the shape where tool calls ride the assistant turn.
+  if (last !== undefined && last.role === "assistant" && last.tool_call_id === undefined) {
+    return [...acc.slice(0, -1), { ...last, tool_calls: [...(last.tool_calls ?? []), wire] }]
+  }
+  return [...acc, { role: "assistant", content: "", tool_calls: [wire] }]
+}
+
+const foldItem = (acc: ReadonlyArray<WireMessage>, item: HistoryItem): ReadonlyArray<WireMessage> =>
+  Match.value(item).pipe(
+    Match.discriminatorsExhaustive("type")({
+      message: (m) => [...acc, { role: m.role, content: encodeContent(m.content) }],
+      function_call: (f) => appendToolCall(acc, f.call_id, f.name, f.arguments),
+      function_call_output: (o) => [
+        ...acc,
+        { role: "tool", tool_call_id: o.call_id, content: o.output },
+      ],
+      // Reasoning items are not replayed to the chat-completions endpoint.
+      reasoning: () => acc,
+    }),
+  )
+
+/** Convert our `HistoryItem[]` history into chat `messages`. */
+export const itemsToMessages = (items: ReadonlyArray<HistoryItem>): ReadonlyArray<WireMessage> =>
+  Arr.reduce(items, [] as ReadonlyArray<WireMessage>, foldItem)
+
+// ---------------------------------------------------------------------------
+// tools / tool_choice / response_format
+// ---------------------------------------------------------------------------
+
+export const toolsWire = (
+  descriptors: ReadonlyArray<ToolDescriptor>,
+): Option.Option<ReadonlyArray<Record<string, unknown>>> =>
+  descriptors.length > 0
+    ? Option.some(
+        descriptors.map((t) => ({
+          type: "function",
+          function: {
+            name: t.name,
+            description: t.description,
+            parameters: t.inputSchema,
+            ...(t.strict !== undefined && { strict: t.strict }),
+          },
+        })),
+      )
+    : Option.none()
+
+type ToolChoice =
+  | "auto"
+  | "required"
+  | "none"
+  | { readonly type: "function"; readonly name: string }
+
+export const toolChoiceWire = (choice: ToolChoice): string | Record<string, unknown> =>
+  Match.value(choice).pipe(
+    Match.when("auto", () => "auto" as const),
+    Match.when("required", () => "required" as const),
+    Match.when("none", () => "none" as const),
+    Match.orElse((c) => ({ type: "function", function: { name: c.name } })),
+  )
+
+export const responseFormatWire = (
+  structured: StructuredFormat<unknown>,
+): Record<string, unknown> => ({
+  type: "json_schema",
+  json_schema: {
+    name: structured.name,
+    schema: structured.schema["~standard"].jsonSchema.input({ target: "draft-2020-12" }),
+    ...(structured.strict !== undefined && { strict: structured.strict }),
+  },
+})
+
+// ---------------------------------------------------------------------------
+// Streaming decode: chat.completion.chunk → TurnEvent
+// ---------------------------------------------------------------------------
+
+const WireFunction = Schema.Struct({
+  name: Schema.optional(Schema.NullOr(Schema.String)),
+  arguments: Schema.optional(Schema.NullOr(Schema.String)),
+})
+
+const WireToolCall = Schema.Struct({
+  index: Schema.optional(Schema.Number),
+  id: Schema.optional(Schema.NullOr(Schema.String)),
+  function: Schema.optional(WireFunction),
+})
+
+const WireDelta = Schema.Struct({
+  role: Schema.optional(Schema.NullOr(Schema.String)),
+  content: Schema.optional(Schema.NullOr(Schema.String)),
+  tool_calls: Schema.optional(Schema.NullOr(Schema.Array(WireToolCall))),
+})
+
+const WireChoice = Schema.Struct({
+  index: Schema.optional(Schema.Number),
+  delta: Schema.optional(WireDelta),
+  finish_reason: Schema.optional(Schema.NullOr(Schema.String)),
+})
+
+const WireUsage = Schema.Struct({
+  prompt_tokens: Schema.optional(Schema.Number),
+  completion_tokens: Schema.optional(Schema.Number),
+  total_tokens: Schema.optional(Schema.Number),
+})
+
+export const WireChunk = Schema.Struct({
+  choices: Schema.optional(Schema.Array(WireChoice)),
+  usage: Schema.optional(Schema.NullOr(WireUsage)),
+})
+export type WireChunk = typeof WireChunk.Type
+
+export const decodeChunk = Schema.decodeUnknownEffect(WireChunk)
+
+// ---------------------------------------------------------------------------
+// Accumulator
+// ---------------------------------------------------------------------------
+
+type ToolAcc = {
+  readonly call_id: string
+  readonly name: string
+  readonly arguments: string
+}
+
+export type Accumulator = {
+  readonly text: string
+  /** Tool calls keyed by their wire `index` (defaults to position when absent). */
+  readonly tools: ReadonlyMap<number, ToolAcc>
+  readonly order: ReadonlyArray<number>
+  readonly usage: Usage
+  readonly finishReason: Option.Option<string>
+}
+
+export const emptyAccumulator: Accumulator = {
+  text: "",
+  tools: new Map(),
+  order: [],
+  usage: {},
+  finishReason: Option.none(),
+}
+
+/** State threaded through the fold plus the events the step produced. */
+type Step = readonly [Accumulator, ReadonlyArray<TurnEvent>]
+
+const usageFrom = (wire: typeof WireUsage.Type): Usage => ({
+  ...(wire.prompt_tokens !== undefined && { input_tokens: wire.prompt_tokens }),
+  ...(wire.completion_tokens !== undefined && { output_tokens: wire.completion_tokens }),
+  ...(wire.total_tokens !== undefined && { total_tokens: wire.total_tokens }),
+})
+
+const reasonToStop = Match.type<string>().pipe(
+  Match.when("stop", () => "stop" as const),
+  Match.when("length", () => "max_tokens" as const),
+  Match.when("tool_calls", () => "tool_calls" as const),
+  Match.when("content_filter", () => "content_filter" as const),
+  Match.orElse(() => "stop" as const),
+)
+
+const stopReasonOf = (acc: Accumulator): StopReason =>
+  Option.match(acc.finishReason, {
+    onNone: () => (acc.tools.size > 0 ? "tool_calls" : "stop"),
+    onSome: reasonToStop,
+  })
+
+const withTool = (acc: Accumulator, index: number, tool: ToolAcc, isNew: boolean): Accumulator => ({
+  ...acc,
+  tools: new Map(acc.tools).set(index, tool),
+  order: isNew ? [...acc.order, index] : acc.order,
+})
+
+const applyContent = (acc: Accumulator, delta: typeof WireDelta.Type | undefined): Step => {
+  const content = delta?.content
+  return content !== undefined && content !== null && content.length > 0
+    ? [{ ...acc, text: acc.text + content }, [TurnEvent.TextDelta({ text: content })]]
+    : [acc, []]
+}
+
+const applyToolCall = (acc: Accumulator, tc: typeof WireToolCall.Type, position: number): Step => {
+  const index = tc.index ?? position
+  const argsDelta = tc.function?.arguments ?? ""
+  const existing = acc.tools.get(index)
+  if (existing === undefined) {
+    // Only `index` is guaranteed on a streaming tool-call chunk, so the id may
+    // be absent. The synthesised fallback is 9-char alphanumeric: valid on every
+    // chat-completions wire (Mistral additionally requires `^[a-zA-Z0-9]{9}$`),
+    // and it is replayed on the next turn.
+    const call_id = tc.id ?? String(index).padStart(9, "0")
+    const name = tc.function?.name ?? ""
+    return [
+      withTool(acc, index, { call_id, name, arguments: argsDelta }, true),
+      [
+        TurnEvent.ToolCallStart({ call_id, name }),
+        ...(argsDelta.length > 0
+          ? [TurnEvent.ToolCallArgsDelta({ call_id, delta: argsDelta })]
+          : []),
+      ],
+    ]
+  }
+  return argsDelta.length > 0
+    ? [
+        withTool(acc, index, { ...existing, arguments: existing.arguments + argsDelta }, false),
+        [TurnEvent.ToolCallArgsDelta({ call_id: existing.call_id, delta: argsDelta })],
+      ]
+    : [acc, []]
+}
+
+const chain = (step: Step, next: (acc: Accumulator) => Step): Step => {
+  const [acc, events] = step
+  const [acc2, more] = next(acc)
+  return [acc2, [...events, ...more]]
+}
+
+const applyChoice = (step: Step, choice: typeof WireChoice.Type): Step => {
+  const withContent = chain(step, (acc) => applyContent(acc, choice.delta))
+  const withTools = Arr.reduce(choice.delta?.tool_calls ?? [], withContent, (s: Step, tc, i) =>
+    chain(s, (acc) => applyToolCall(acc, tc, i)),
+  )
+  const reason = choice.finish_reason
+  return reason !== undefined && reason !== null
+    ? [{ ...withTools[0], finishReason: Option.some(reason) }, withTools[1]]
+    : withTools
+}
+
+/**
+ * Fold one decoded chunk into the accumulator, returning the next state and the
+ * `TurnEvent`s the chunk produced.
+ */
+export const applyChunk = (acc: Accumulator, chunk: WireChunk): Step => {
+  const afterChoices = Arr.reduce(chunk.choices ?? [], [acc, []] as Step, applyChoice)
+  const usage = chunk.usage
+  return usage !== undefined && usage !== null
+    ? chain(afterChoices, (a) => {
+        const u = usageFrom(usage)
+        return [{ ...a, usage: u }, [TurnEvent.UsageUpdate({ usage: u })]]
+      })
+    : afterChoices
+}
+
+/** Assemble the terminal `Turn` from the accumulated state. */
+export const accumulatorToTurn = (acc: Accumulator): Turn => {
+  const message: ReadonlyArray<HistoryItem> =
+    acc.text.length > 0
+      ? [{ type: "message", role: "assistant", content: [{ type: "output_text", text: acc.text }] }]
+      : []
+  const toolCalls: ReadonlyArray<HistoryItem> = acc.order.flatMap((index) => {
+    const t = acc.tools.get(index)
+    return t === undefined
+      ? []
+      : [
+          {
+            type: "function_call" as const,
+            call_id: t.call_id,
+            name: t.name,
+            arguments: t.arguments,
+          },
+        ]
+  })
+  return {
+    items: [...message, ...toolCalls],
+    usage: acc.usage,
+    stop_reason: stopReasonOf(acc),
+  }
+}

package/src/http.ts

@@ -0,0 +1,33 @@
+import { Match } from "effect"
+import * as AiError from "@effect-uai/core/AiError"
+
+/** Map an HTTP status from a chat-completions endpoint to an `AiError` variant. */
+export const httpStatusError = (provider: string, status: number, body: string): AiError.AiError =>
+  Match.value(status).pipe(
+    Match.when(429, (): AiError.AiError => new AiError.RateLimited({ provider, raw: body })),
+    Match.whenOr(408, 504, (): AiError.AiError => new AiError.Timeout({ provider, raw: body })),
+    Match.when(
+      401,
+      (): AiError.AiError => new AiError.AuthFailed({ provider, subtype: "auth", raw: body }),
+    ),
+    Match.when(
+      403,
+      (): AiError.AiError => new AiError.AuthFailed({ provider, subtype: "permission", raw: body }),
+    ),
+    Match.when(
+      402,
+      (): AiError.AiError => new AiError.AuthFailed({ provider, subtype: "billing", raw: body }),
+    ),
+    Match.when(
+      413,
+      (): AiError.AiError => new AiError.ContextLengthExceeded({ provider, raw: body }),
+    ),
+    Match.when(
+      (n) => n >= 500,
+      (n): AiError.AiError => new AiError.Unavailable({ provider, status: n, raw: body }),
+    ),
+    Match.orElse((): AiError.AiError => new AiError.InvalidRequest({ provider, raw: body })),
+  )
+
+export const transportFailure = (provider: string, cause: unknown): AiError.AiError =>
+  new AiError.Unavailable({ provider, raw: cause })

package/src/index.ts

@@ -0,0 +1,3 @@
+export * as ChatCompletions from "./ChatCompletions.js"
+export * as codec from "./codec.js"
+export * as http from "./http.js"