@effect-uai/responses 0.2.0 → 0.4.0

package/dist/codec.d.mts

@@ -0,0 +1,133 @@
+import { Schema } from "effect";
+import { Turn } from "@effect-uai/core/Turn";
+import { Item } from "@effect-uai/core/Items";
+
+//#region src/codec.d.ts
+declare namespace codec_d_exports {
+  export { WireOutputItem, WireResponseCompleted, itemsToInput, turnFromCompleted, wireItemToItem };
+}
+declare const WireOutputItem: Schema.Union<readonly [Schema.Struct<{
+  readonly type: Schema.Literal<"message">;
+  readonly id: Schema.optional<Schema.String>;
+  readonly role: Schema.Literal<"assistant">;
+  readonly content: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+    readonly type: Schema.Literal<"output_text">;
+    readonly text: Schema.String;
+    readonly annotations: Schema.optional<Schema.NullOr<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+      readonly type: Schema.Literal<"url_citation">;
+      readonly url: Schema.String;
+      readonly start_index: Schema.Number;
+      readonly end_index: Schema.Number;
+      readonly title: Schema.String;
+    }>, 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<"refusal">;
+    readonly refusal: Schema.String;
+  }>]>>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"function_call">;
+  readonly id: Schema.optional<Schema.String>;
+  readonly call_id: Schema.String;
+  readonly name: Schema.String;
+  readonly arguments: Schema.String;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"reasoning">;
+  readonly id: Schema.optional<Schema.String>;
+  readonly summary: Schema.optional<Schema.$Array<Schema.Struct<{
+    readonly type: Schema.Literal<"summary_text">;
+    readonly text: Schema.String;
+  }>>>;
+  readonly encrypted_content: Schema.optional<Schema.String>;
+}>]>;
+type WireOutputItem = typeof WireOutputItem.Type;
+declare const WireResponseCompleted: Schema.Struct<{
+  readonly id: Schema.optional<Schema.NullOr<Schema.String>>;
+  readonly status: Schema.optional<Schema.NullOr<Schema.String>>;
+  readonly output: Schema.optional<Schema.NullOr<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+    readonly type: Schema.Literal<"message">;
+    readonly id: Schema.optional<Schema.String>;
+    readonly role: Schema.Literal<"assistant">;
+    readonly content: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+      readonly type: Schema.Literal<"output_text">;
+      readonly text: Schema.String;
+      readonly annotations: Schema.optional<Schema.NullOr<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+        readonly type: Schema.Literal<"url_citation">;
+        readonly url: Schema.String;
+        readonly start_index: Schema.Number;
+        readonly end_index: Schema.Number;
+        readonly title: Schema.String;
+      }>, 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<"refusal">;
+      readonly refusal: Schema.String;
+    }>]>>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"function_call">;
+    readonly id: Schema.optional<Schema.String>;
+    readonly call_id: Schema.String;
+    readonly name: Schema.String;
+    readonly arguments: Schema.String;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"reasoning">;
+    readonly id: Schema.optional<Schema.String>;
+    readonly summary: Schema.optional<Schema.$Array<Schema.Struct<{
+      readonly type: Schema.Literal<"summary_text">;
+      readonly text: Schema.String;
+    }>>>;
+    readonly encrypted_content: Schema.optional<Schema.String>;
+  }>]>>>>;
+  readonly usage: Schema.optional<Schema.NullOr<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.NullOr<Schema.Struct<{
+      readonly cached_tokens: Schema.optional<Schema.NullOr<Schema.Number>>;
+    }>>>;
+    readonly output_tokens_details: Schema.optional<Schema.NullOr<Schema.Struct<{
+      readonly reasoning_tokens: Schema.optional<Schema.NullOr<Schema.Number>>;
+    }>>>;
+  }>>>;
+  readonly incomplete_details: Schema.optional<Schema.NullOr<Schema.Struct<{
+    readonly reason: Schema.optional<Schema.NullOr<Schema.String>>;
+  }>>>;
+  readonly error: Schema.optional<Schema.NullOr<Schema.Struct<{
+    readonly code: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly message: Schema.optional<Schema.NullOr<Schema.String>>;
+  }>>>;
+}>;
+type WireResponseCompleted = typeof WireResponseCompleted.Type;
+/** Convert our `Item[]` history into the Responses API `input` array. */
+declare const itemsToInput: (items: ReadonlyArray<Item>) => ReadonlyArray<Record<string, unknown>>;
+declare const wireItemToItem: (wire: WireOutputItem) => Item;
+declare const turnFromCompleted: (payload: WireResponseCompleted) => Turn;
+//#endregion
+export { WireOutputItem, WireResponseCompleted, itemsToInput, codec_d_exports as t, turnFromCompleted, wireItemToItem };
+//# 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":";;;;;;;;cAoFa,cAAA,EAAc,MAAA,CAAA,KAAA,WAAA,MAAA,CAAA,MAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KACf,cAAA,UAAwB,cAAA,CAAe,IAAA;AAAA,cA6BtC,qBAAA,EAAqB,MAAA,CAAA,MAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KActB,qBAAA,UAA+B,qBAAA,CAAsB,IAAA;;cA0EpD,YAAA,GAAgB,KAAA,EAAO,aAAA,CAAc,IAAA,MAAQ,aAAA,CAAc,MAAA;AAAA,cAkB3D,cAAA,GAAkB,IAAA,EAAM,cAAA,KAAiB,IAAA;AAAA,cA8DzC,iBAAA,GAAqB,OAAA,EAAS,qBAAA,KAAwB,IAAA"}

package/dist/codec.mjs

@@ -0,0 +1,218 @@
+import { t as __exportAll } from "./chunk-CfYAbeIz.mjs";
+import { Encoding, Match, Option, Schema } from "effect";
+//#region src/codec.ts
+var codec_exports = /* @__PURE__ */ __exportAll({
+	WireOutputItem: () => WireOutputItem,
+	WireResponseCompleted: () => WireResponseCompleted,
+	itemsToInput: () => itemsToInput,
+	turnFromCompleted: () => turnFromCompleted,
+	wireItemToItem: () => wireItemToItem
+});
+const WireUrlCitation = Schema.Struct({
+	type: Schema.Literal("url_citation"),
+	url: Schema.String,
+	start_index: Schema.Number,
+	end_index: Schema.Number,
+	title: Schema.String
+});
+const WireFileCitation = Schema.Struct({
+	type: Schema.Literal("file_citation"),
+	file_id: Schema.String,
+	index: Schema.Number
+});
+const WireContainerFileCitation = Schema.Struct({
+	type: Schema.Literal("container_file_citation"),
+	container_id: Schema.String,
+	file_id: Schema.String,
+	start_index: Schema.Number,
+	end_index: Schema.Number
+});
+const WireFilePath = Schema.Struct({
+	type: Schema.Literal("file_path"),
+	file_id: Schema.String,
+	index: Schema.Number
+});
+const WireAnnotation = Schema.Union([
+	WireUrlCitation,
+	WireFileCitation,
+	WireContainerFileCitation,
+	WireFilePath
+]);
+const WireOutputTextContent = Schema.Struct({
+	type: Schema.Literal("output_text"),
+	text: Schema.String,
+	annotations: Schema.optional(Schema.NullOr(Schema.Array(WireAnnotation)))
+});
+const WireRefusalContent = Schema.Struct({
+	type: Schema.Literal("refusal"),
+	refusal: Schema.String
+});
+const WireMessageContent = Schema.Union([WireOutputTextContent, WireRefusalContent]);
+const WireSummaryText = Schema.Struct({
+	type: Schema.Literal("summary_text"),
+	text: Schema.String
+});
+const WireMessage = Schema.Struct({
+	type: Schema.Literal("message"),
+	id: Schema.optional(Schema.String),
+	role: Schema.Literal("assistant"),
+	content: Schema.Array(WireMessageContent)
+});
+const WireFunctionCall = Schema.Struct({
+	type: Schema.Literal("function_call"),
+	id: Schema.optional(Schema.String),
+	call_id: Schema.String,
+	name: Schema.String,
+	arguments: Schema.String
+});
+const WireReasoning = Schema.Struct({
+	type: Schema.Literal("reasoning"),
+	id: Schema.optional(Schema.String),
+	summary: Schema.optional(Schema.Array(WireSummaryText)),
+	encrypted_content: Schema.optional(Schema.String)
+});
+const WireOutputItem = Schema.Union([
+	WireMessage,
+	WireFunctionCall,
+	WireReasoning
+]);
+const WireInputTokensDetails = Schema.Struct({ cached_tokens: Schema.optional(Schema.NullOr(Schema.Number)) });
+const WireOutputTokensDetails = Schema.Struct({ reasoning_tokens: Schema.optional(Schema.NullOr(Schema.Number)) });
+const WireUsage = Schema.Struct({
+	input_tokens: Schema.optional(Schema.Number),
+	output_tokens: Schema.optional(Schema.Number),
+	total_tokens: Schema.optional(Schema.Number),
+	input_tokens_details: Schema.optional(Schema.NullOr(WireInputTokensDetails)),
+	output_tokens_details: Schema.optional(Schema.NullOr(WireOutputTokensDetails))
+});
+const WireResponseError = Schema.Struct({
+	code: Schema.optional(Schema.NullOr(Schema.String)),
+	message: Schema.optional(Schema.NullOr(Schema.String))
+});
+const WireResponseCompleted = Schema.Struct({
+	id: Schema.optional(Schema.NullOr(Schema.String)),
+	status: Schema.optional(Schema.NullOr(Schema.String)),
+	output: Schema.optional(Schema.NullOr(Schema.Array(WireOutputItem))),
+	usage: Schema.optional(Schema.NullOr(WireUsage)),
+	incomplete_details: Schema.optional(Schema.NullOr(Schema.Struct({ reason: Schema.optional(Schema.NullOr(Schema.String)) }))),
+	error: Schema.optional(Schema.NullOr(WireResponseError))
+});
+/**
+* If an item carries `providerData` from a prior OpenAI turn, re-emit it
+* verbatim - preserves `encrypted_content`, item ids, and any field this
+* codec doesn't model.
+*/
+const passthrough = (item) => item.providerData !== void 0 && typeof item.providerData === "object" && item.providerData !== null ? item.providerData : void 0;
+/**
+* OpenAI's `input_image` content block carries a single `image_url` field;
+* inline bytes get encoded as a `data:` URI. Either form (URL or data URI)
+* is fine - the model just dereferences `image_url`.
+*/
+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 contentBlockToInput = Match.type().pipe(Match.discriminatorsExhaustive("type")({
+	input_text: (b) => ({
+		type: "input_text",
+		text: b.text
+	}),
+	input_image: (b) => ({
+		type: "input_image",
+		image_url: imageSourceToUrl(b.source)
+	}),
+	output_text: (b) => ({
+		type: "output_text",
+		text: b.text
+	}),
+	refusal: (b) => ({
+		type: "refusal",
+		refusal: b.text
+	})
+}));
+const itemToInput = (item) => passthrough(item) ?? Match.value(item).pipe(Match.discriminatorsExhaustive("type")({
+	message: (m) => ({
+		type: "message",
+		role: m.role,
+		content: m.content.map(contentBlockToInput)
+	}),
+	function_call: (f) => ({
+		type: "function_call",
+		call_id: f.call_id,
+		name: f.name,
+		arguments: f.arguments
+	}),
+	function_call_output: (o) => ({
+		type: "function_call_output",
+		call_id: o.call_id,
+		output: o.output
+	}),
+	reasoning: (r) => ({
+		type: "reasoning",
+		...r.id !== void 0 && { id: r.id },
+		...r.summary !== void 0 && { summary: [{
+			type: "summary_text",
+			text: r.summary
+		}] },
+		...r.signature !== void 0 && { encrypted_content: r.signature }
+	})
+}));
+/** Convert our `Item[]` history into the Responses API `input` array. */
+const itemsToInput = (items) => items.map(itemToInput);
+const wireMessageContentToBlock = Match.type().pipe(Match.discriminatorsExhaustive("type")({
+	output_text: (c) => ({
+		type: "output_text",
+		text: c.text,
+		...c.annotations !== void 0 && c.annotations !== null && { annotations: c.annotations }
+	}),
+	refusal: (c) => ({
+		type: "refusal",
+		text: c.refusal
+	})
+}));
+const wireItemToItem = (wire) => Match.value(wire).pipe(Match.discriminatorsExhaustive("type")({
+	message: (m) => ({
+		type: "message",
+		role: m.role,
+		content: m.content.map(wireMessageContentToBlock),
+		providerData: m
+	}),
+	function_call: (f) => ({
+		type: "function_call",
+		call_id: f.call_id,
+		name: f.name,
+		arguments: f.arguments,
+		providerData: f
+	}),
+	reasoning: (r) => ({
+		type: "reasoning",
+		...r.id !== void 0 && { id: r.id },
+		...r.summary !== void 0 && { summary: r.summary.map((s) => s.text).join("\n") },
+		...r.encrypted_content !== void 0 && { signature: r.encrypted_content },
+		providerData: r
+	})
+}));
+const reasonToStop = Match.type().pipe(Match.when("max_output_tokens", () => "max_tokens"), Match.when("refusal", () => "refusal"), Match.when("content_filter", () => "content_filter"), Match.when("max_tool_calls", () => "max_tool_calls"), Match.option);
+const hasRefusalContent = (payload) => (payload.output ?? []).some((i) => i.type === "message" && i.content.some((c) => c.type === "refusal"));
+const stopReasonFromCompleted = (payload) => Option.match(reasonToStop(payload.incomplete_details?.reason ?? ""), {
+	onSome: (s) => s,
+	onNone: () => hasRefusalContent(payload) ? "refusal" : (payload.output ?? []).some((i) => i.type === "function_call") ? "tool_calls" : "stop"
+});
+const cachedTokens = (payload) => payload.usage?.input_tokens_details?.cached_tokens ?? void 0;
+const reasoningTokens = (payload) => payload.usage?.output_tokens_details?.reasoning_tokens ?? void 0;
+const turnFromCompleted = (payload) => {
+	const cached = cachedTokens(payload);
+	const reasoning = reasoningTokens(payload);
+	return {
+		items: (payload.output ?? []).map(wireItemToItem),
+		usage: {
+			...payload.usage?.input_tokens !== void 0 && { input_tokens: payload.usage.input_tokens },
+			...payload.usage?.output_tokens !== void 0 && { output_tokens: payload.usage.output_tokens },
+			...payload.usage?.total_tokens !== void 0 && { total_tokens: payload.usage.total_tokens },
+			...cached !== void 0 && { input_tokens_details: { cached_tokens: cached } },
+			...reasoning !== void 0 && { output_tokens_details: { reasoning_tokens: reasoning } }
+		},
+		stop_reason: stopReasonFromCompleted(payload)
+	};
+};
+//#endregion
+export { WireOutputItem, WireResponseCompleted, itemsToInput, codec_exports as t, turnFromCompleted, wireItemToItem };
+
+//# sourceMappingURL=codec.mjs.map

package/dist/codec.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.mjs","names":[],"sources":["../src/codec.ts"],"sourcesContent":["import { Encoding, Match, Option, Schema } from \"effect\"\nimport type { ContentBlock, InputImage, Item } from \"@effect-uai/core/Items\"\nimport type { Turn } from \"@effect-uai/core/Turn\"\n\n// ---------------------------------------------------------------------------\n// Wire schemas - minimal subset of the Responses API output we consume.\n// Reference: https://www.openresponses.org/specification\n// ---------------------------------------------------------------------------\n\nconst WireUrlCitation = Schema.Struct({\n  type: Schema.Literal(\"url_citation\"),\n  url: Schema.String,\n  start_index: Schema.Number,\n  end_index: Schema.Number,\n  title: Schema.String,\n})\n\nconst WireFileCitation = Schema.Struct({\n  type: Schema.Literal(\"file_citation\"),\n  file_id: Schema.String,\n  index: Schema.Number,\n})\n\nconst WireContainerFileCitation = Schema.Struct({\n  type: Schema.Literal(\"container_file_citation\"),\n  container_id: Schema.String,\n  file_id: Schema.String,\n  start_index: Schema.Number,\n  end_index: Schema.Number,\n})\n\nconst WireFilePath = Schema.Struct({\n  type: Schema.Literal(\"file_path\"),\n  file_id: Schema.String,\n  index: Schema.Number,\n})\n\nconst WireAnnotation = Schema.Union([\n  WireUrlCitation,\n  WireFileCitation,\n  WireContainerFileCitation,\n  WireFilePath,\n])\n\nconst WireOutputTextContent = Schema.Struct({\n  type: Schema.Literal(\"output_text\"),\n  text: Schema.String,\n  annotations: Schema.optional(Schema.NullOr(Schema.Array(WireAnnotation))),\n})\n\nconst WireRefusalContent = Schema.Struct({\n  type: Schema.Literal(\"refusal\"),\n  refusal: Schema.String,\n})\n\nconst WireMessageContent = Schema.Union([WireOutputTextContent, WireRefusalContent])\n\nconst WireSummaryText = Schema.Struct({\n  type: Schema.Literal(\"summary_text\"),\n  text: Schema.String,\n})\n\nconst WireMessage = Schema.Struct({\n  type: Schema.Literal(\"message\"),\n  id: Schema.optional(Schema.String),\n  role: Schema.Literal(\"assistant\"),\n  content: Schema.Array(WireMessageContent),\n})\n\nconst WireFunctionCall = Schema.Struct({\n  type: Schema.Literal(\"function_call\"),\n  id: Schema.optional(Schema.String),\n  call_id: Schema.String,\n  name: Schema.String,\n  arguments: Schema.String,\n})\n\nconst WireReasoning = Schema.Struct({\n  type: Schema.Literal(\"reasoning\"),\n  id: Schema.optional(Schema.String),\n  summary: Schema.optional(Schema.Array(WireSummaryText)),\n  encrypted_content: Schema.optional(Schema.String),\n})\n\nexport const WireOutputItem = Schema.Union([WireMessage, WireFunctionCall, WireReasoning])\nexport type WireOutputItem = typeof WireOutputItem.Type\n\nconst WireInputTokensDetails = Schema.Struct({\n  cached_tokens: Schema.optional(Schema.NullOr(Schema.Number)),\n})\n\nconst WireOutputTokensDetails = Schema.Struct({\n  reasoning_tokens: Schema.optional(Schema.NullOr(Schema.Number)),\n})\n\nconst WireUsage = Schema.Struct({\n  input_tokens: Schema.optional(Schema.Number),\n  output_tokens: Schema.optional(Schema.Number),\n  total_tokens: Schema.optional(Schema.Number),\n  input_tokens_details: Schema.optional(Schema.NullOr(WireInputTokensDetails)),\n  output_tokens_details: Schema.optional(Schema.NullOr(WireOutputTokensDetails)),\n})\n\nconst WireResponseError = Schema.Struct({\n  code: Schema.optional(Schema.NullOr(Schema.String)),\n  message: Schema.optional(Schema.NullOr(Schema.String)),\n})\n\n// Many Responses-API fields are emitted as explicit `null` rather than\n// missing - `Schema.optional` alone (T | undefined) doesn't cover that, so\n// we lift each through `NullOr` first. Used by `response.completed`,\n// `response.incomplete`, and `response.failed` events; not every field is\n// populated on every event (e.g. `error` only on failed, `incomplete_details`\n// only on incomplete).\nexport const WireResponseCompleted = Schema.Struct({\n  id: Schema.optional(Schema.NullOr(Schema.String)),\n  status: Schema.optional(Schema.NullOr(Schema.String)),\n  output: Schema.optional(Schema.NullOr(Schema.Array(WireOutputItem))),\n  usage: Schema.optional(Schema.NullOr(WireUsage)),\n  incomplete_details: Schema.optional(\n    Schema.NullOr(\n      Schema.Struct({\n        reason: Schema.optional(Schema.NullOr(Schema.String)),\n      }),\n    ),\n  ),\n  error: Schema.optional(Schema.NullOr(WireResponseError)),\n})\nexport type WireResponseCompleted = typeof WireResponseCompleted.Type\n\n// ---------------------------------------------------------------------------\n// History → request body input\n// ---------------------------------------------------------------------------\n\n/**\n * If an item carries `providerData` from a prior OpenAI turn, re-emit it\n * verbatim - preserves `encrypted_content`, item ids, and any field this\n * codec doesn't model.\n */\nconst passthrough = (item: Item): Record<string, unknown> | undefined =>\n  item.providerData !== undefined &&\n  typeof item.providerData === \"object\" &&\n  item.providerData !== null\n    ? (item.providerData as Record<string, unknown>)\n    : undefined\n\n/**\n * OpenAI's `input_image` content block carries a single `image_url` field;\n * inline bytes get encoded as a `data:` URI. Either form (URL or data URI)\n * is fine - the model just dereferences `image_url`.\n */\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 contentBlockToInput = Match.type<ContentBlock>().pipe(\n  Match.discriminatorsExhaustive(\"type\")({\n    input_text: (b) => ({ type: \"input_text\", text: b.text }),\n    input_image: (b) => ({\n      type: \"input_image\",\n      image_url: imageSourceToUrl(b.source),\n    }),\n    output_text: (b) => ({ type: \"output_text\", text: b.text }),\n    refusal: (b) => ({ type: \"refusal\", refusal: b.text }),\n  }),\n)\n\nconst itemToInput = (item: Item): Record<string, unknown> =>\n  passthrough(item) ??\n  Match.value(item).pipe(\n    Match.discriminatorsExhaustive(\"type\")({\n      message: (m) => ({\n        type: \"message\",\n        role: m.role,\n        content: m.content.map(contentBlockToInput),\n      }),\n      function_call: (f) => ({\n        type: \"function_call\",\n        call_id: f.call_id,\n        name: f.name,\n        arguments: f.arguments,\n      }),\n      function_call_output: (o) => ({\n        type: \"function_call_output\",\n        call_id: o.call_id,\n        output: o.output,\n      }),\n      reasoning: (r) => ({\n        type: \"reasoning\",\n        ...(r.id !== undefined && { id: r.id }),\n        ...(r.summary !== undefined && {\n          summary: [{ type: \"summary_text\", text: r.summary }],\n        }),\n        ...(r.signature !== undefined && { encrypted_content: r.signature }),\n      }),\n    }),\n  )\n\n/** Convert our `Item[]` history into the Responses API `input` array. */\nexport const itemsToInput = (items: ReadonlyArray<Item>): ReadonlyArray<Record<string, unknown>> =>\n  items.map(itemToInput)\n\n// ---------------------------------------------------------------------------\n// Wire output items → our Items\n// ---------------------------------------------------------------------------\n\nconst wireMessageContentToBlock = Match.type<typeof WireMessageContent.Type>().pipe(\n  Match.discriminatorsExhaustive(\"type\")({\n    output_text: (c): ContentBlock => ({\n      type: \"output_text\",\n      text: c.text,\n      ...(c.annotations !== undefined && c.annotations !== null && { annotations: c.annotations }),\n    }),\n    refusal: (c): ContentBlock => ({ type: \"refusal\", text: c.refusal }),\n  }),\n)\n\nexport const wireItemToItem = (wire: WireOutputItem): Item =>\n  Match.value(wire).pipe(\n    Match.discriminatorsExhaustive(\"type\")({\n      message: (m) => ({\n        type: \"message\" as const,\n        role: m.role,\n        content: m.content.map(wireMessageContentToBlock),\n        providerData: m,\n      }),\n      function_call: (f) => ({\n        type: \"function_call\" as const,\n        call_id: f.call_id,\n        name: f.name,\n        arguments: f.arguments,\n        providerData: f,\n      }),\n      reasoning: (r) => ({\n        type: \"reasoning\" as const,\n        ...(r.id !== undefined && { id: r.id }),\n        ...(r.summary !== undefined && {\n          summary: r.summary.map((s) => s.text).join(\"\\n\"),\n        }),\n        ...(r.encrypted_content !== undefined && { signature: r.encrypted_content }),\n        providerData: r,\n      }),\n    }),\n  )\n\n// ---------------------------------------------------------------------------\n// response.completed → Turn\n// ---------------------------------------------------------------------------\n\nconst reasonToStop = Match.type<string>().pipe(\n  Match.when(\"max_output_tokens\", () => \"max_tokens\" as const),\n  Match.when(\"refusal\", () => \"refusal\" as const),\n  Match.when(\"content_filter\", () => \"content_filter\" as const),\n  Match.when(\"max_tool_calls\", () => \"max_tool_calls\" as const),\n  Match.option,\n)\n\nconst hasRefusalContent = (payload: WireResponseCompleted): boolean =>\n  (payload.output ?? []).some(\n    (i) => i.type === \"message\" && i.content.some((c) => c.type === \"refusal\"),\n  )\n\nconst stopReasonFromCompleted = (payload: WireResponseCompleted): Turn[\"stop_reason\"] =>\n  Option.match(reasonToStop(payload.incomplete_details?.reason ?? \"\"), {\n    onSome: (s) => s,\n    onNone: () =>\n      hasRefusalContent(payload)\n        ? (\"refusal\" as const)\n        : (payload.output ?? []).some((i) => i.type === \"function_call\")\n          ? (\"tool_calls\" as const)\n          : (\"stop\" as const),\n  })\n\nconst cachedTokens = (payload: WireResponseCompleted): number | undefined =>\n  payload.usage?.input_tokens_details?.cached_tokens ?? undefined\n\nconst reasoningTokens = (payload: WireResponseCompleted): number | undefined =>\n  payload.usage?.output_tokens_details?.reasoning_tokens ?? undefined\n\nexport const turnFromCompleted = (payload: WireResponseCompleted): Turn => {\n  const cached = cachedTokens(payload)\n  const reasoning = reasoningTokens(payload)\n  return {\n    items: (payload.output ?? []).map(wireItemToItem),\n    usage: {\n      ...(payload.usage?.input_tokens !== undefined && {\n        input_tokens: payload.usage.input_tokens,\n      }),\n      ...(payload.usage?.output_tokens !== undefined && {\n        output_tokens: payload.usage.output_tokens,\n      }),\n      ...(payload.usage?.total_tokens !== undefined && {\n        total_tokens: payload.usage.total_tokens,\n      }),\n      ...(cached !== undefined && {\n        input_tokens_details: { cached_tokens: cached },\n      }),\n      ...(reasoning !== undefined && {\n        output_tokens_details: { reasoning_tokens: reasoning },\n      }),\n    },\n    stop_reason: stopReasonFromCompleted(payload),\n  }\n}\n"],"mappings":"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"}