@effect-uai/responses 0.9.0 → 0.11.0

package/dist/responsesTools.test.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/responsesTools.test.mjs

@@ -0,0 +1,138 @@
+import { codeInterpreterTool, fileSearchTool, renderProviderTools, webSearchTool } from "./ResponsesTools.mjs";
+import { KnownProviderEvent, eventToDeltas, makeCallIdLookup } from "./streamEvents.mjs";
+import { n as describe, r as it, t as globalExpect } from "./test.DNmyFkvJ-CPKukVWS.mjs";
+import { Result, Schema } from "effect";
+import * as Tool from "@effect-uai/core/Tool";
+import { providerToolsOf } from "@effect-uai/core/Tool";
+//#region src/responsesTools.test.ts
+const wireFor = (toolkit) => Result.getOrThrow(renderProviderTools(providerToolsOf(toolkit)));
+describe("Responses provider tool rendering", () => {
+	it("maps web_search options onto the native wire fields", () => {
+		globalExpect(wireFor({ web_search: webSearchTool({
+			searchContextSize: "high",
+			filters: {
+				allowedDomains: ["example.com"],
+				blockedDomains: ["spam.com"]
+			},
+			userLocation: {
+				city: "Berlin",
+				country: "DE"
+			}
+		}) })).toEqual([{
+			type: "web_search",
+			filters: {
+				allowed_domains: ["example.com"],
+				blocked_domains: ["spam.com"]
+			},
+			user_location: {
+				type: "approximate",
+				city: "Berlin",
+				country: "DE"
+			},
+			search_context_size: "high"
+		}]);
+	});
+	it("maps code_interpreter to an auto container (with file ids when given)", () => {
+		globalExpect(wireFor({ ci: codeInterpreterTool() })).toEqual([{
+			type: "code_interpreter",
+			container: { type: "auto" }
+		}]);
+		globalExpect(wireFor({ ci: codeInterpreterTool({ fileIds: ["file_1"] }) })).toEqual([{
+			type: "code_interpreter",
+			container: {
+				type: "auto",
+				file_ids: ["file_1"]
+			}
+		}]);
+	});
+	it("maps file_search to its vector store ids", () => {
+		globalExpect(wireFor({ fs: fileSearchTool({ vectorStoreIds: ["vs_1", "vs_2"] }) })).toEqual([{
+			type: "file_search",
+			vector_store_ids: ["vs_1", "vs_2"]
+		}]);
+	});
+	it("fails on a tool hosted by a different provider", () => {
+		const foreign = Tool.provider({
+			name: "google_search",
+			description: "Gemini grounding.",
+			inputSchema: Tool.noInput,
+			provider: "gemini",
+			config: { kind: "google_search" }
+		});
+		globalExpect(Result.isFailure(renderProviderTools(providerToolsOf({ foreign })))).toBe(true);
+	});
+	it("fails on an unrecognized config", () => {
+		const bogus = Tool.provider({
+			name: "mystery",
+			description: "Unknown Responses tool.",
+			inputSchema: Tool.noInput,
+			provider: "openai",
+			config: { kind: "telepathy" }
+		});
+		globalExpect(Result.isFailure(renderProviderTools(providerToolsOf({ bogus })))).toBe(true);
+	});
+});
+describe("Responses hosted-tool response tolerance", () => {
+	const decodeEvent = Schema.decodeUnknownSync(KnownProviderEvent);
+	it("emits TurnComplete with just the text answer for a grounded completion", () => {
+		const complete = eventToDeltas(decodeEvent({
+			type: "response.completed",
+			response: {
+				status: "completed",
+				output: [{
+					type: "web_search_call",
+					id: "ws_1",
+					status: "completed"
+				}, {
+					type: "message",
+					role: "assistant",
+					content: [{
+						type: "output_text",
+						text: "Grounded answer."
+					}]
+				}]
+			}
+		}), makeCallIdLookup()).find((d) => d._tag === "TurnComplete");
+		globalExpect(complete).toBeDefined();
+		const turn = complete?._tag === "TurnComplete" ? complete.turn : void 0;
+		globalExpect(turn?.stop_reason).toBe("stop");
+		globalExpect(turn?.items).toEqual([{
+			type: "message",
+			role: "assistant",
+			content: [{
+				type: "output_text",
+				text: "Grounded answer."
+			}],
+			providerData: globalExpect.anything()
+		}]);
+	});
+	it("projects a streamed url_citation to CitationAdded", () => {
+		globalExpect(eventToDeltas(decodeEvent({
+			type: "response.output_text.annotation.added",
+			item_id: "msg_1",
+			output_index: 0,
+			content_index: 0,
+			annotation_index: 0,
+			annotation: {
+				type: "url_citation",
+				url: "https://example.com/a",
+				title: "A",
+				start_index: 10,
+				end_index: 20
+			}
+		}), makeCallIdLookup())).toEqual([{
+			_tag: "CitationAdded",
+			annotation: {
+				type: "url_citation",
+				url: "https://example.com/a",
+				title: "A",
+				start_index: 10,
+				end_index: 20
+			}
+		}]);
+	});
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=responsesTools.test.mjs.map

package/dist/responsesTools.test.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"responsesTools.test.mjs","names":["expect"],"sources":["../src/responsesTools.test.ts"],"sourcesContent":["import { Result, Schema } from \"effect\"\nimport * as Tool from \"@effect-uai/core/Tool\"\nimport { providerToolsOf } from \"@effect-uai/core/Tool\"\nimport { describe, expect, it } from \"vitest\"\nimport { KnownProviderEvent, eventToDeltas, makeCallIdLookup } from \"./streamEvents.js\"\nimport {\n  codeInterpreterTool,\n  fileSearchTool,\n  renderProviderTools,\n  webSearchTool,\n} from \"./ResponsesTools.js\"\n\nconst wireFor = (toolkit: Record<string, Tool.AnyTool>) =>\n  Result.getOrThrow(renderProviderTools(providerToolsOf(toolkit)))\n\ndescribe(\"Responses provider tool rendering\", () => {\n  it(\"maps web_search options onto the native wire fields\", () => {\n    expect(\n      wireFor({\n        web_search: webSearchTool({\n          searchContextSize: \"high\",\n          filters: { allowedDomains: [\"example.com\"], blockedDomains: [\"spam.com\"] },\n          userLocation: { city: \"Berlin\", country: \"DE\" },\n        }),\n      }),\n    ).toEqual([\n      {\n        type: \"web_search\",\n        filters: { allowed_domains: [\"example.com\"], blocked_domains: [\"spam.com\"] },\n        user_location: { type: \"approximate\", city: \"Berlin\", country: \"DE\" },\n        search_context_size: \"high\",\n      },\n    ])\n  })\n\n  it(\"maps code_interpreter to an auto container (with file ids when given)\", () => {\n    expect(wireFor({ ci: codeInterpreterTool() })).toEqual([\n      { type: \"code_interpreter\", container: { type: \"auto\" } },\n    ])\n    expect(wireFor({ ci: codeInterpreterTool({ fileIds: [\"file_1\"] }) })).toEqual([\n      { type: \"code_interpreter\", container: { type: \"auto\", file_ids: [\"file_1\"] } },\n    ])\n  })\n\n  it(\"maps file_search to its vector store ids\", () => {\n    expect(wireFor({ fs: fileSearchTool({ vectorStoreIds: [\"vs_1\", \"vs_2\"] }) })).toEqual([\n      { type: \"file_search\", vector_store_ids: [\"vs_1\", \"vs_2\"] },\n    ])\n  })\n\n  it(\"fails on a tool hosted by a different provider\", () => {\n    const foreign = Tool.provider({\n      name: \"google_search\",\n      description: \"Gemini grounding.\",\n      inputSchema: Tool.noInput,\n      provider: \"gemini\",\n      config: { kind: \"google_search\" },\n    })\n    expect(Result.isFailure(renderProviderTools(providerToolsOf({ foreign })))).toBe(true)\n  })\n\n  it(\"fails on an unrecognized config\", () => {\n    const bogus = Tool.provider({\n      name: \"mystery\",\n      description: \"Unknown Responses tool.\",\n      inputSchema: Tool.noInput,\n      provider: \"openai\",\n      config: { kind: \"telepathy\" },\n    })\n    expect(Result.isFailure(renderProviderTools(providerToolsOf({ bogus })))).toBe(true)\n  })\n})\n\ndescribe(\"Responses hosted-tool response tolerance\", () => {\n  // The real regression: a hosted-tool output item in `response.completed` must\n  // not break the event decode, or `TurnComplete` would never fire. Decoding\n  // through the actual event schema (throws on failure) and projecting to\n  // TurnEvents proves the grounded text still assembles into a turn.\n  const decodeEvent = Schema.decodeUnknownSync(KnownProviderEvent)\n\n  it(\"emits TurnComplete with just the text answer for a grounded completion\", () => {\n    const event = decodeEvent({\n      type: \"response.completed\",\n      response: {\n        status: \"completed\",\n        output: [\n          { type: \"web_search_call\", id: \"ws_1\", status: \"completed\" },\n          {\n            type: \"message\",\n            role: \"assistant\",\n            content: [{ type: \"output_text\", text: \"Grounded answer.\" }],\n          },\n        ],\n      },\n    })\n    const deltas = eventToDeltas(event, makeCallIdLookup())\n    const complete = deltas.find((d) => d._tag === \"TurnComplete\")\n    expect(complete).toBeDefined()\n    const turn = complete?._tag === \"TurnComplete\" ? complete.turn : undefined\n    expect(turn?.stop_reason).toBe(\"stop\")\n    expect(turn?.items).toEqual([\n      {\n        type: \"message\",\n        role: \"assistant\",\n        content: [{ type: \"output_text\", text: \"Grounded answer.\" }],\n        providerData: expect.anything(),\n      },\n    ])\n  })\n\n  // The new streamed-citation path: a real `annotation.added` payload (with the\n  // wire's positional fields) must decode and project to a `CitationAdded`\n  // carrying a domain `Annotation`. This is what makes native-grounding\n  // citations stream instead of only landing on the final turn.\n  it(\"projects a streamed url_citation to CitationAdded\", () => {\n    const deltas = eventToDeltas(\n      decodeEvent({\n        type: \"response.output_text.annotation.added\",\n        item_id: \"msg_1\",\n        output_index: 0,\n        content_index: 0,\n        annotation_index: 0,\n        annotation: {\n          type: \"url_citation\",\n          url: \"https://example.com/a\",\n          title: \"A\",\n          start_index: 10,\n          end_index: 20,\n        },\n      }),\n      makeCallIdLookup(),\n    )\n    expect(deltas).toEqual([\n      {\n        _tag: \"CitationAdded\",\n        annotation: {\n          type: \"url_citation\",\n          url: \"https://example.com/a\",\n          title: \"A\",\n          start_index: 10,\n          end_index: 20,\n        },\n      },\n    ])\n  })\n})\n"],"mappings":";;;;;;;AAYA,MAAM,WAAW,YACf,OAAO,WAAW,oBAAoB,gBAAgB,QAAQ,CAAC,CAAC;AAElE,SAAS,2CAA2C;AAClD,IAAG,6DAA6D;AAC9D,eACE,QAAQ,EACN,YAAY,cAAc;GACxB,mBAAmB;GACnB,SAAS;IAAE,gBAAgB,CAAC,cAAc;IAAE,gBAAgB,CAAC,WAAW;IAAE;GAC1E,cAAc;IAAE,MAAM;IAAU,SAAS;IAAM;GAChD,CAAC,EACH,CAAC,CACH,CAAC,QAAQ,CACR;GACE,MAAM;GACN,SAAS;IAAE,iBAAiB,CAAC,cAAc;IAAE,iBAAiB,CAAC,WAAW;IAAE;GAC5E,eAAe;IAAE,MAAM;IAAe,MAAM;IAAU,SAAS;IAAM;GACrE,qBAAqB;GACtB,CACF,CAAC;GACF;AAEF,IAAG,+EAA+E;AAChF,eAAO,QAAQ,EAAE,IAAI,qBAAqB,EAAE,CAAC,CAAC,CAAC,QAAQ,CACrD;GAAE,MAAM;GAAoB,WAAW,EAAE,MAAM,QAAQ;GAAE,CAC1D,CAAC;AACF,eAAO,QAAQ,EAAE,IAAI,oBAAoB,EAAE,SAAS,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAC5E;GAAE,MAAM;GAAoB,WAAW;IAAE,MAAM;IAAQ,UAAU,CAAC,SAAS;IAAE;GAAE,CAChF,CAAC;GACF;AAEF,IAAG,kDAAkD;AACnD,eAAO,QAAQ,EAAE,IAAI,eAAe,EAAE,gBAAgB,CAAC,QAAQ,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CACpF;GAAE,MAAM;GAAe,kBAAkB,CAAC,QAAQ,OAAO;GAAE,CAC5D,CAAC;GACF;AAEF,IAAG,wDAAwD;EACzD,MAAM,UAAU,KAAK,SAAS;GAC5B,MAAM;GACN,aAAa;GACb,aAAa,KAAK;GAClB,UAAU;GACV,QAAQ,EAAE,MAAM,iBAAiB;GAClC,CAAC;AACF,eAAO,OAAO,UAAU,oBAAoB,gBAAgB,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK;GACtF;AAEF,IAAG,yCAAyC;EAC1C,MAAM,QAAQ,KAAK,SAAS;GAC1B,MAAM;GACN,aAAa;GACb,aAAa,KAAK;GAClB,UAAU;GACV,QAAQ,EAAE,MAAM,aAAa;GAC9B,CAAC;AACF,eAAO,OAAO,UAAU,oBAAoB,gBAAgB,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK;GACpF;EACF;AAEF,SAAS,kDAAkD;CAKzD,MAAM,cAAc,OAAO,kBAAkB,mBAAmB;AAEhE,IAAG,gFAAgF;EAgBjF,MAAM,WADS,cAdD,YAAY;GACxB,MAAM;GACN,UAAU;IACR,QAAQ;IACR,QAAQ,CACN;KAAE,MAAM;KAAmB,IAAI;KAAQ,QAAQ;KAAa,EAC5D;KACE,MAAM;KACN,MAAM;KACN,SAAS,CAAC;MAAE,MAAM;MAAe,MAAM;MAAoB,CAAC;KAC7D,CACF;IACF;GACF,CACiC,EAAE,kBAAkB,CAC/B,CAAC,MAAM,MAAM,EAAE,SAAS,eAAe;AAC9D,eAAO,SAAS,CAAC,aAAa;EAC9B,MAAM,OAAO,UAAU,SAAS,iBAAiB,SAAS,OAAO,KAAA;AACjE,eAAO,MAAM,YAAY,CAAC,KAAK,OAAO;AACtC,eAAO,MAAM,MAAM,CAAC,QAAQ,CAC1B;GACE,MAAM;GACN,MAAM;GACN,SAAS,CAAC;IAAE,MAAM;IAAe,MAAM;IAAoB,CAAC;GAC5D,cAAcA,aAAO,UAAU;GAChC,CACF,CAAC;GACF;AAMF,IAAG,2DAA2D;AAkB5D,eAjBe,cACb,YAAY;GACV,MAAM;GACN,SAAS;GACT,cAAc;GACd,eAAe;GACf,kBAAkB;GAClB,YAAY;IACV,MAAM;IACN,KAAK;IACL,OAAO;IACP,aAAa;IACb,WAAW;IACZ;GACF,CAAC,EACF,kBAAkB,CAEP,CAAC,CAAC,QAAQ,CACrB;GACE,MAAM;GACN,YAAY;IACV,MAAM;IACN,KAAK;IACL,OAAO;IACP,aAAa;IACb,WAAW;IACZ;GACF,CACF,CAAC;GACF;EACF"}

package/dist/streamEvents.d.mts

@@ -57,6 +57,15 @@ declare const KnownProviderEvent: Schema.Union<readonly [Schema.Struct<{
       readonly text: Schema.String;
     }>>>;
     readonly encrypted_content: Schema.optional<Schema.String>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"web_search_call">;
+    readonly id: Schema.optional<Schema.String>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"code_interpreter_call">;
+    readonly id: Schema.optional<Schema.String>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"file_search_call">;
+    readonly id: Schema.optional<Schema.String>;
   }>]>;
 }>, Schema.Struct<{
   readonly type: Schema.Literal<"response.output_text.delta">;
@@ -77,6 +86,35 @@ declare const KnownProviderEvent: Schema.Union<readonly [Schema.Struct<{
 }>, Schema.Struct<{
   readonly type: Schema.Literal<"response.refusal.done">;
   readonly refusal: Schema.optional<Schema.String>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"response.web_search_call.in_progress">;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"response.web_search_call.searching">;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"response.web_search_call.completed">;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"response.output_text.annotation.added">;
+  readonly annotation: 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<"response.completed">;
   readonly response: Schema.Struct<{
@@ -128,6 +166,15 @@ declare const KnownProviderEvent: Schema.Union<readonly [Schema.Struct<{
         readonly text: Schema.String;
       }>>>;
       readonly encrypted_content: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"web_search_call">;
+      readonly id: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"code_interpreter_call">;
+      readonly id: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"file_search_call">;
+      readonly id: Schema.optional<Schema.String>;
     }>]>>>>;
     readonly usage: Schema.optional<Schema.NullOr<Schema.Struct<{
       readonly input_tokens: Schema.optional<Schema.Number>;
@@ -199,6 +246,15 @@ declare const KnownProviderEvent: Schema.Union<readonly [Schema.Struct<{
         readonly text: Schema.String;
       }>>>;
       readonly encrypted_content: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"web_search_call">;
+      readonly id: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"code_interpreter_call">;
+      readonly id: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"file_search_call">;
+      readonly id: Schema.optional<Schema.String>;
     }>]>>>>;
     readonly usage: Schema.optional<Schema.NullOr<Schema.Struct<{
       readonly input_tokens: Schema.optional<Schema.Number>;
@@ -270,6 +326,15 @@ declare const KnownProviderEvent: Schema.Union<readonly [Schema.Struct<{
         readonly text: Schema.String;
       }>>>;
       readonly encrypted_content: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"web_search_call">;
+      readonly id: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"code_interpreter_call">;
+      readonly id: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"file_search_call">;
+      readonly id: Schema.optional<Schema.String>;
     }>]>>>>;
     readonly usage: Schema.optional<Schema.NullOr<Schema.Struct<{
       readonly input_tokens: Schema.optional<Schema.Number>;
@@ -294,6 +359,12 @@ declare const KnownProviderEvent: Schema.Union<readonly [Schema.Struct<{
   readonly type: Schema.Literal<"error">;
   readonly message: Schema.optional<Schema.String>;
   readonly code: Schema.optional<Schema.String>;
+  readonly error: Schema.optional<Schema.Struct<{
+    readonly message: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly code: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly type: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly param: Schema.optional<Schema.NullOr<Schema.String>>;
+  }>>;
 }>]>;
 /**
  * Public: every event the native stream can emit. Discriminated on `type`.
@@ -348,6 +419,15 @@ declare const ProviderEvent: Schema.Union<readonly [Schema.Struct<{
       readonly text: Schema.String;
     }>>>;
     readonly encrypted_content: Schema.optional<Schema.String>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"web_search_call">;
+    readonly id: Schema.optional<Schema.String>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"code_interpreter_call">;
+    readonly id: Schema.optional<Schema.String>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"file_search_call">;
+    readonly id: Schema.optional<Schema.String>;
   }>]>;
 }>, Schema.Struct<{
   readonly type: Schema.Literal<"response.output_text.delta">;
@@ -368,6 +448,35 @@ declare const ProviderEvent: Schema.Union<readonly [Schema.Struct<{
 }>, Schema.Struct<{
   readonly type: Schema.Literal<"response.refusal.done">;
   readonly refusal: Schema.optional<Schema.String>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"response.web_search_call.in_progress">;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"response.web_search_call.searching">;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"response.web_search_call.completed">;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"response.output_text.annotation.added">;
+  readonly annotation: 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<"response.completed">;
   readonly response: Schema.Struct<{
@@ -419,6 +528,15 @@ declare const ProviderEvent: Schema.Union<readonly [Schema.Struct<{
         readonly text: Schema.String;
       }>>>;
       readonly encrypted_content: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"web_search_call">;
+      readonly id: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"code_interpreter_call">;
+      readonly id: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"file_search_call">;
+      readonly id: Schema.optional<Schema.String>;
     }>]>>>>;
     readonly usage: Schema.optional<Schema.NullOr<Schema.Struct<{
       readonly input_tokens: Schema.optional<Schema.Number>;
@@ -490,6 +608,15 @@ declare const ProviderEvent: Schema.Union<readonly [Schema.Struct<{
         readonly text: Schema.String;
       }>>>;
       readonly encrypted_content: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"web_search_call">;
+      readonly id: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"code_interpreter_call">;
+      readonly id: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"file_search_call">;
+      readonly id: Schema.optional<Schema.String>;
     }>]>>>>;
     readonly usage: Schema.optional<Schema.NullOr<Schema.Struct<{
       readonly input_tokens: Schema.optional<Schema.Number>;
@@ -561,6 +688,15 @@ declare const ProviderEvent: Schema.Union<readonly [Schema.Struct<{
         readonly text: Schema.String;
       }>>>;
       readonly encrypted_content: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"web_search_call">;
+      readonly id: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"code_interpreter_call">;
+      readonly id: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"file_search_call">;
+      readonly id: Schema.optional<Schema.String>;
     }>]>>>>;
     readonly usage: Schema.optional<Schema.NullOr<Schema.Struct<{
       readonly input_tokens: Schema.optional<Schema.Number>;
@@ -585,6 +721,12 @@ declare const ProviderEvent: Schema.Union<readonly [Schema.Struct<{
   readonly type: Schema.Literal<"error">;
   readonly message: Schema.optional<Schema.String>;
   readonly code: Schema.optional<Schema.String>;
+  readonly error: Schema.optional<Schema.Struct<{
+    readonly message: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly code: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly type: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly param: Schema.optional<Schema.NullOr<Schema.String>>;
+  }>>;
 }>, Schema.Struct<{
   readonly type: Schema.Literal<"_unknown">;
   readonly raw: Schema.Unknown;

package/dist/streamEvents.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"streamEvents.d.mts","names":[],"sources":["../src/streamEvents.ts"],"mappings":";;;;;;;;;;;cAkFa,kBAAA,EAAkB,MAAA,CAAA,KAAA,WAAA,MAAA,CAAA,MAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAmBlB,aAAA,EAAa,MAAA,CAAA,KAAA,WAAA,MAAA,CAAA,MAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAcd,aAAA,UAAuB,aAAA,CAAc,IAAA;AAAA,KAKrC,YAAA;EAAA,SACD,OAAA,GAAU,MAAA;EAAA,SACV,QAAA,GAAW,MAAA,UAAgB,MAAA;AAAA;AAAA,cAGzB,gBAAA,QAAuB,YAAA;;;;;;;cAgBvB,aAAA,GACX,KAAA,EAAO,aAAA,EACP,MAAA,EAAQ,YAAA,KACP,aAAA,CAAc,SAAA"}
+{"version":3,"file":"streamEvents.d.mts","names":[],"sources":["../src/streamEvents.ts"],"mappings":";;;;;;;;;;;cAuHa,kBAAA,EAAkB,MAAA,CAAA,KAAA,WAAA,MAAA,CAAA,MAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAuBlB,aAAA,EAAa,MAAA,CAAA,KAAA,WAAA,MAAA,CAAA,MAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAkBd,aAAA,UAAuB,aAAA,CAAc,IAAA;AAAA,KAKrC,YAAA;EAAA,SACD,OAAA,GAAU,MAAA;EAAA,SACV,QAAA,GAAW,MAAA,UAAgB,MAAA;AAAA;AAAA,cAGzB,gBAAA,QAAuB,YAAA;;;;;;;cAgBvB,aAAA,GACX,KAAA,EAAO,aAAA,EACP,MAAA,EAAQ,YAAA,KACP,aAAA,CAAc,SAAA"}

package/dist/streamEvents.mjs

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./chunk-CfYAbeIz.mjs";
-import { WireOutputItem, WireResponseCompleted, turnFromCompleted } from "./codec.mjs";
+import { WireAnnotation, WireOutputItem, WireResponseCompleted, turnFromCompleted } from "./codec.mjs";
 import { Match, Schema } from "effect";
 import { TurnEvent } from "@effect-uai/core/Turn";
 //#region src/streamEvents.ts
@@ -38,6 +38,13 @@ const RefusalDone = Schema.Struct({
 	type: Schema.Literal("response.refusal.done"),
 	refusal: Schema.optional(Schema.String)
 });
+const WebSearchInProgress = Schema.Struct({ type: Schema.Literal("response.web_search_call.in_progress") });
+const WebSearchSearching = Schema.Struct({ type: Schema.Literal("response.web_search_call.searching") });
+const WebSearchCompleted = Schema.Struct({ type: Schema.Literal("response.web_search_call.completed") });
+const AnnotationAdded = Schema.Struct({
+	type: Schema.Literal("response.output_text.annotation.added"),
+	annotation: WireAnnotation
+});
 const Completed = Schema.Struct({
 	type: Schema.Literal("response.completed"),
 	response: WireResponseCompleted
@@ -53,7 +60,13 @@ const Failed = Schema.Struct({
 const ErrorEvent = Schema.Struct({
 	type: Schema.Literal("error"),
 	message: Schema.optional(Schema.String),
-	code: Schema.optional(Schema.String)
+	code: Schema.optional(Schema.String),
+	error: Schema.optional(Schema.Struct({
+		message: Schema.optional(Schema.NullOr(Schema.String)),
+		code: Schema.optional(Schema.NullOr(Schema.String)),
+		type: Schema.optional(Schema.NullOr(Schema.String)),
+		param: Schema.optional(Schema.NullOr(Schema.String))
+	}))
 });
 /**
 * Catch-all variant for wire events that fail to decode against any known
@@ -77,6 +90,10 @@ const KnownProviderEvent = Schema.Union([
 	ReasoningSummaryDelta,
 	RefusalDelta,
 	RefusalDone,
+	WebSearchInProgress,
+	WebSearchSearching,
+	WebSearchCompleted,
+	AnnotationAdded,
 	Completed,
 	Incomplete,
 	Failed,
@@ -95,6 +112,10 @@ const ProviderEvent = Schema.Union([
 	ReasoningSummaryDelta,
 	RefusalDelta,
 	RefusalDone,
+	WebSearchInProgress,
+	WebSearchSearching,
+	WebSearchCompleted,
+	AnnotationAdded,
 	Completed,
 	Incomplete,
 	Failed,
@@ -143,6 +164,10 @@ const eventToDeltas = (event, lookup) => Match.value(event).pipe(Match.discrimin
 	})],
 	"response.refusal.delta": ({ delta }) => [TurnEvent.RefusalDelta({ text: delta })],
 	"response.refusal.done": () => [],
+	"response.web_search_call.in_progress": () => [TurnEvent.WebSearchCall({ status: "started" })],
+	"response.web_search_call.searching": () => [TurnEvent.WebSearchCall({ status: "searching" })],
+	"response.web_search_call.completed": () => [TurnEvent.WebSearchCall({ status: "completed" })],
+	"response.output_text.annotation.added": ({ annotation }) => [TurnEvent.CitationAdded({ annotation })],
 	"response.completed": ({ response }) => [TurnEvent.TurnComplete({ turn: turnFromCompleted(response) })],
 	"response.incomplete": ({ response }) => [TurnEvent.TurnComplete({ turn: turnFromCompleted(response) })],
 	"response.failed": () => [],

package/dist/streamEvents.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"streamEvents.mjs","names":[],"sources":["../src/streamEvents.ts"],"sourcesContent":["import { Match, Schema } from \"effect\"\nimport { TurnEvent } from \"@effect-uai/core/Turn\"\nimport { WireOutputItem, WireResponseCompleted, turnFromCompleted } from \"./codec.js\"\n\n// ---------------------------------------------------------------------------\n// Schemas for the SSE event payloads we care about. The Responses API ships\n// many event types; we model only the ones that map to a `TurnEvent`. All\n// others are silently ignored at the dispatch site.\n// ---------------------------------------------------------------------------\n\nconst OutputItemAdded = Schema.Struct({\n  type: Schema.Literal(\"response.output_item.added\"),\n  item: WireOutputItem,\n})\n\nconst OutputTextDelta = Schema.Struct({\n  type: Schema.Literal(\"response.output_text.delta\"),\n  delta: Schema.String,\n})\n\nconst FunctionArgsDelta = Schema.Struct({\n  type: Schema.Literal(\"response.function_call_arguments.delta\"),\n  item_id: Schema.String,\n  delta: Schema.String,\n})\n\nconst ReasoningTextDelta = Schema.Struct({\n  type: Schema.Literal(\"response.reasoning_text.delta\"),\n  delta: Schema.String,\n})\n\nconst ReasoningSummaryDelta = Schema.Struct({\n  type: Schema.Literal(\"response.reasoning_summary_text.delta\"),\n  delta: Schema.String,\n})\n\nconst RefusalDelta = Schema.Struct({\n  type: Schema.Literal(\"response.refusal.delta\"),\n  delta: Schema.String,\n})\n\nconst RefusalDone = Schema.Struct({\n  type: Schema.Literal(\"response.refusal.done\"),\n  refusal: Schema.optional(Schema.String),\n})\n\nconst Completed = Schema.Struct({\n  type: Schema.Literal(\"response.completed\"),\n  response: WireResponseCompleted,\n})\n\nconst Incomplete = Schema.Struct({\n  type: Schema.Literal(\"response.incomplete\"),\n  response: WireResponseCompleted,\n})\n\nconst Failed = Schema.Struct({\n  type: Schema.Literal(\"response.failed\"),\n  response: WireResponseCompleted,\n})\n\nconst ErrorEvent = Schema.Struct({\n  type: Schema.Literal(\"error\"),\n  message: Schema.optional(Schema.String),\n  code: Schema.optional(Schema.String),\n})\n\n/**\n * Catch-all variant for wire events that fail to decode against any known\n * schema, plus events that fail to JSON-parse. The decoder never produces\n * this directly - it's synthesized by `sseEventToProviderEvent` when\n * `decodeKnown` fails.\n */\nconst Unknown = Schema.Struct({\n  type: Schema.Literal(\"_unknown\"),\n  raw: Schema.Unknown,\n})\n\n/**\n * Internal: union of variants we actually know how to decode from the wire.\n * Used as the decode target; failures are caught and re-emitted as `Unknown`.\n */\nexport const KnownProviderEvent = Schema.Union([\n  OutputItemAdded,\n  OutputTextDelta,\n  FunctionArgsDelta,\n  ReasoningTextDelta,\n  ReasoningSummaryDelta,\n  RefusalDelta,\n  RefusalDone,\n  Completed,\n  Incomplete,\n  Failed,\n  ErrorEvent,\n])\n\n/**\n * Public: every event the native stream can emit. Discriminated on `type`.\n * The `_unknown` branch closes the cardinality so downstream `Match.exhaustive`\n * cannot silently miss a wire event we didn't model.\n */\nexport const ProviderEvent = Schema.Union([\n  OutputItemAdded,\n  OutputTextDelta,\n  FunctionArgsDelta,\n  ReasoningTextDelta,\n  ReasoningSummaryDelta,\n  RefusalDelta,\n  RefusalDone,\n  Completed,\n  Incomplete,\n  Failed,\n  ErrorEvent,\n  Unknown,\n])\nexport type ProviderEvent = typeof ProviderEvent.Type\n\n// `call_id` lookup for `function_call_arguments.delta`. The SSE event\n// references the *item id*, not the call id; we keep a small map populated\n// from the `output_item.added` events.\nexport type CallIdLookup = {\n  readonly resolve: (itemId: string) => string | undefined\n  readonly remember: (itemId: string, callId: string) => void\n}\n\nexport const makeCallIdLookup = (): CallIdLookup => {\n  const map = new Map<string, string>()\n  return {\n    resolve: (id) => map.get(id),\n    remember: (id, callId) => {\n      map.set(id, callId)\n    },\n  }\n}\n\n/**\n * Translate a decoded provider event into zero-or-more `TurnEvent`s.\n * Mutates `lookup` to record `(item_id → call_id)` from `output_item.added`\n * so subsequent `function_call_arguments.delta` events can be tagged with\n * the right call id.\n */\nexport const eventToDeltas = (\n  event: ProviderEvent,\n  lookup: CallIdLookup,\n): ReadonlyArray<TurnEvent> =>\n  Match.value(event).pipe(\n    Match.discriminatorsExhaustive(\"type\")({\n      \"response.output_item.added\": ({ item }) => {\n        if (item.type !== \"function_call\") return []\n        if (item.id !== undefined) lookup.remember(item.id, item.call_id)\n        return [TurnEvent.ToolCallStart({ call_id: item.call_id, name: item.name })]\n      },\n      \"response.output_text.delta\": ({ delta }) => [TurnEvent.TextDelta({ text: delta })],\n      \"response.function_call_arguments.delta\": ({ item_id, delta }) => {\n        const call_id = lookup.resolve(item_id)\n        return call_id === undefined ? [] : [TurnEvent.ToolCallArgsDelta({ call_id, delta })]\n      },\n      \"response.reasoning_text.delta\": ({ delta }) => [\n        TurnEvent.ReasoningDelta({ text: delta, kind: \"trace\" }),\n      ],\n      \"response.reasoning_summary_text.delta\": ({ delta }) => [\n        TurnEvent.ReasoningDelta({ text: delta, kind: \"summary\" }),\n      ],\n      \"response.refusal.delta\": ({ delta }) => [TurnEvent.RefusalDelta({ text: delta })],\n      // Terminal marker for the refusal stream; the deltas already covered\n      // the text, so no canonical event is emitted here.\n      \"response.refusal.done\": () => [],\n      \"response.completed\": ({ response }) => [\n        TurnEvent.TurnComplete({ turn: turnFromCompleted(response) }),\n      ],\n      // Incomplete = the model stopped early but produced a usable partial\n      // turn (max_tokens, content_filter, max_tool_calls, refusal). Same\n      // payload shape as `response.completed`; the stop_reason carries the\n      // reason.\n      \"response.incomplete\": ({ response }) => [\n        TurnEvent.TurnComplete({ turn: turnFromCompleted(response) }),\n      ],\n      // Failed and error are surfaced separately as `AiError` by the stream\n      // pipeline, not as canonical events.\n      \"response.failed\": () => [],\n      error: () => [],\n      // No silent drops: unknown wire events flow through `streamNative` but\n      // produce no canonical delta. Step 3 (canonical `other` event) replaces\n      // this with a forwarded `other` delta on `TurnEvent`.\n      _unknown: () => [],\n    }),\n  )\n"],"mappings":";;;;;;;;;;;AAUA,MAAM,kBAAkB,OAAO,OAAO;CACpC,MAAM,OAAO,QAAQ,6BAA6B;CAClD,MAAM;CACP,CAAC;AAEF,MAAM,kBAAkB,OAAO,OAAO;CACpC,MAAM,OAAO,QAAQ,6BAA6B;CAClD,OAAO,OAAO;CACf,CAAC;AAEF,MAAM,oBAAoB,OAAO,OAAO;CACtC,MAAM,OAAO,QAAQ,yCAAyC;CAC9D,SAAS,OAAO;CAChB,OAAO,OAAO;CACf,CAAC;AAEF,MAAM,qBAAqB,OAAO,OAAO;CACvC,MAAM,OAAO,QAAQ,gCAAgC;CACrD,OAAO,OAAO;CACf,CAAC;AAEF,MAAM,wBAAwB,OAAO,OAAO;CAC1C,MAAM,OAAO,QAAQ,wCAAwC;CAC7D,OAAO,OAAO;CACf,CAAC;AAEF,MAAM,eAAe,OAAO,OAAO;CACjC,MAAM,OAAO,QAAQ,yBAAyB;CAC9C,OAAO,OAAO;CACf,CAAC;AAEF,MAAM,cAAc,OAAO,OAAO;CAChC,MAAM,OAAO,QAAQ,wBAAwB;CAC7C,SAAS,OAAO,SAAS,OAAO,OAAO;CACxC,CAAC;AAEF,MAAM,YAAY,OAAO,OAAO;CAC9B,MAAM,OAAO,QAAQ,qBAAqB;CAC1C,UAAU;CACX,CAAC;AAEF,MAAM,aAAa,OAAO,OAAO;CAC/B,MAAM,OAAO,QAAQ,sBAAsB;CAC3C,UAAU;CACX,CAAC;AAEF,MAAM,SAAS,OAAO,OAAO;CAC3B,MAAM,OAAO,QAAQ,kBAAkB;CACvC,UAAU;CACX,CAAC;AAEF,MAAM,aAAa,OAAO,OAAO;CAC/B,MAAM,OAAO,QAAQ,QAAQ;CAC7B,SAAS,OAAO,SAAS,OAAO,OAAO;CACvC,MAAM,OAAO,SAAS,OAAO,OAAO;CACrC,CAAC;;;;;;;AAQF,MAAM,UAAU,OAAO,OAAO;CAC5B,MAAM,OAAO,QAAQ,WAAW;CAChC,KAAK,OAAO;CACb,CAAC;;;;;AAMF,MAAa,qBAAqB,OAAO,MAAM;CAC7C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;;;;;;AAOF,MAAa,gBAAgB,OAAO,MAAM;CACxC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AAWF,MAAa,yBAAuC;CAClD,MAAM,sBAAM,IAAI,KAAqB;AACrC,QAAO;EACL,UAAU,OAAO,IAAI,IAAI,GAAG;EAC5B,WAAW,IAAI,WAAW;AACxB,OAAI,IAAI,IAAI,OAAO;;EAEtB;;;;;;;;AASH,MAAa,iBACX,OACA,WAEA,MAAM,MAAM,MAAM,CAAC,KACjB,MAAM,yBAAyB,OAAO,CAAC;CACrC,+BAA+B,EAAE,WAAW;AAC1C,MAAI,KAAK,SAAS,gBAAiB,QAAO,EAAE;AAC5C,MAAI,KAAK,OAAO,KAAA,EAAW,QAAO,SAAS,KAAK,IAAI,KAAK,QAAQ;AACjE,SAAO,CAAC,UAAU,cAAc;GAAE,SAAS,KAAK;GAAS,MAAM,KAAK;GAAM,CAAC,CAAC;;CAE9E,+BAA+B,EAAE,YAAY,CAAC,UAAU,UAAU,EAAE,MAAM,OAAO,CAAC,CAAC;CACnF,2CAA2C,EAAE,SAAS,YAAY;EAChE,MAAM,UAAU,OAAO,QAAQ,QAAQ;AACvC,SAAO,YAAY,KAAA,IAAY,EAAE,GAAG,CAAC,UAAU,kBAAkB;GAAE;GAAS;GAAO,CAAC,CAAC;;CAEvF,kCAAkC,EAAE,YAAY,CAC9C,UAAU,eAAe;EAAE,MAAM;EAAO,MAAM;EAAS,CAAC,CACzD;CACD,0CAA0C,EAAE,YAAY,CACtD,UAAU,eAAe;EAAE,MAAM;EAAO,MAAM;EAAW,CAAC,CAC3D;CACD,2BAA2B,EAAE,YAAY,CAAC,UAAU,aAAa,EAAE,MAAM,OAAO,CAAC,CAAC;CAGlF,+BAA+B,EAAE;CACjC,uBAAuB,EAAE,eAAe,CACtC,UAAU,aAAa,EAAE,MAAM,kBAAkB,SAAS,EAAE,CAAC,CAC9D;CAKD,wBAAwB,EAAE,eAAe,CACvC,UAAU,aAAa,EAAE,MAAM,kBAAkB,SAAS,EAAE,CAAC,CAC9D;CAGD,yBAAyB,EAAE;CAC3B,aAAa,EAAE;CAIf,gBAAgB,EAAE;CACnB,CAAC,CACH"}
+{"version":3,"file":"streamEvents.mjs","names":[],"sources":["../src/streamEvents.ts"],"sourcesContent":["import { Match, Schema } from \"effect\"\nimport { TurnEvent } from \"@effect-uai/core/Turn\"\nimport {\n  WireAnnotation,\n  WireOutputItem,\n  WireResponseCompleted,\n  turnFromCompleted,\n} from \"./codec.js\"\n\n// ---------------------------------------------------------------------------\n// Schemas for the SSE event payloads we care about. The Responses API ships\n// many event types; we model only the ones that map to a `TurnEvent`. All\n// others are silently ignored at the dispatch site.\n// ---------------------------------------------------------------------------\n\nconst OutputItemAdded = Schema.Struct({\n  type: Schema.Literal(\"response.output_item.added\"),\n  item: WireOutputItem,\n})\n\nconst OutputTextDelta = Schema.Struct({\n  type: Schema.Literal(\"response.output_text.delta\"),\n  delta: Schema.String,\n})\n\nconst FunctionArgsDelta = Schema.Struct({\n  type: Schema.Literal(\"response.function_call_arguments.delta\"),\n  item_id: Schema.String,\n  delta: Schema.String,\n})\n\nconst ReasoningTextDelta = Schema.Struct({\n  type: Schema.Literal(\"response.reasoning_text.delta\"),\n  delta: Schema.String,\n})\n\nconst ReasoningSummaryDelta = Schema.Struct({\n  type: Schema.Literal(\"response.reasoning_summary_text.delta\"),\n  delta: Schema.String,\n})\n\nconst RefusalDelta = Schema.Struct({\n  type: Schema.Literal(\"response.refusal.delta\"),\n  delta: Schema.String,\n})\n\nconst RefusalDone = Schema.Struct({\n  type: Schema.Literal(\"response.refusal.done\"),\n  refusal: Schema.optional(Schema.String),\n})\n\n// Web-search lifecycle. The three phases carry `item_id` / `output_index` /\n// `sequence_number`; we map each to a `WebSearchCall` status. `query` / `action`\n// ride on the `web_search_call` output item, not these lifecycle events.\nconst WebSearchInProgress = Schema.Struct({\n  type: Schema.Literal(\"response.web_search_call.in_progress\"),\n})\n\nconst WebSearchSearching = Schema.Struct({\n  type: Schema.Literal(\"response.web_search_call.searching\"),\n})\n\nconst WebSearchCompleted = Schema.Struct({\n  type: Schema.Literal(\"response.web_search_call.completed\"),\n})\n\n// A citation attached to the answer as it is written. `annotation` is the\n// same shape as the ones bundled on the final `output_text` block.\nconst AnnotationAdded = Schema.Struct({\n  type: Schema.Literal(\"response.output_text.annotation.added\"),\n  annotation: WireAnnotation,\n})\n\nconst Completed = Schema.Struct({\n  type: Schema.Literal(\"response.completed\"),\n  response: WireResponseCompleted,\n})\n\nconst Incomplete = Schema.Struct({\n  type: Schema.Literal(\"response.incomplete\"),\n  response: WireResponseCompleted,\n})\n\nconst Failed = Schema.Struct({\n  type: Schema.Literal(\"response.failed\"),\n  response: WireResponseCompleted,\n})\n\nconst ErrorEvent = Schema.Struct({\n  type: Schema.Literal(\"error\"),\n  // Flat form (top-level `message`/`code`) and the nested form the Responses API\n  // uses for request rejections: `error: { message, code, type, param }`.\n  message: Schema.optional(Schema.String),\n  code: Schema.optional(Schema.String),\n  error: Schema.optional(\n    Schema.Struct({\n      message: Schema.optional(Schema.NullOr(Schema.String)),\n      code: Schema.optional(Schema.NullOr(Schema.String)),\n      type: Schema.optional(Schema.NullOr(Schema.String)),\n      param: Schema.optional(Schema.NullOr(Schema.String)),\n    }),\n  ),\n})\n\n/**\n * Catch-all variant for wire events that fail to decode against any known\n * schema, plus events that fail to JSON-parse. The decoder never produces\n * this directly - it's synthesized by `sseEventToProviderEvent` when\n * `decodeKnown` fails.\n */\nconst Unknown = Schema.Struct({\n  type: Schema.Literal(\"_unknown\"),\n  raw: Schema.Unknown,\n})\n\n/**\n * Internal: union of variants we actually know how to decode from the wire.\n * Used as the decode target; failures are caught and re-emitted as `Unknown`.\n */\nexport const KnownProviderEvent = Schema.Union([\n  OutputItemAdded,\n  OutputTextDelta,\n  FunctionArgsDelta,\n  ReasoningTextDelta,\n  ReasoningSummaryDelta,\n  RefusalDelta,\n  RefusalDone,\n  WebSearchInProgress,\n  WebSearchSearching,\n  WebSearchCompleted,\n  AnnotationAdded,\n  Completed,\n  Incomplete,\n  Failed,\n  ErrorEvent,\n])\n\n/**\n * Public: every event the native stream can emit. Discriminated on `type`.\n * The `_unknown` branch closes the cardinality so downstream `Match.exhaustive`\n * cannot silently miss a wire event we didn't model.\n */\nexport const ProviderEvent = Schema.Union([\n  OutputItemAdded,\n  OutputTextDelta,\n  FunctionArgsDelta,\n  ReasoningTextDelta,\n  ReasoningSummaryDelta,\n  RefusalDelta,\n  RefusalDone,\n  WebSearchInProgress,\n  WebSearchSearching,\n  WebSearchCompleted,\n  AnnotationAdded,\n  Completed,\n  Incomplete,\n  Failed,\n  ErrorEvent,\n  Unknown,\n])\nexport type ProviderEvent = typeof ProviderEvent.Type\n\n// `call_id` lookup for `function_call_arguments.delta`. The SSE event\n// references the *item id*, not the call id; we keep a small map populated\n// from the `output_item.added` events.\nexport type CallIdLookup = {\n  readonly resolve: (itemId: string) => string | undefined\n  readonly remember: (itemId: string, callId: string) => void\n}\n\nexport const makeCallIdLookup = (): CallIdLookup => {\n  const map = new Map<string, string>()\n  return {\n    resolve: (id) => map.get(id),\n    remember: (id, callId) => {\n      map.set(id, callId)\n    },\n  }\n}\n\n/**\n * Translate a decoded provider event into zero-or-more `TurnEvent`s.\n * Mutates `lookup` to record `(item_id → call_id)` from `output_item.added`\n * so subsequent `function_call_arguments.delta` events can be tagged with\n * the right call id.\n */\nexport const eventToDeltas = (\n  event: ProviderEvent,\n  lookup: CallIdLookup,\n): ReadonlyArray<TurnEvent> =>\n  Match.value(event).pipe(\n    Match.discriminatorsExhaustive(\"type\")({\n      \"response.output_item.added\": ({ item }) => {\n        if (item.type !== \"function_call\") return []\n        if (item.id !== undefined) lookup.remember(item.id, item.call_id)\n        return [TurnEvent.ToolCallStart({ call_id: item.call_id, name: item.name })]\n      },\n      \"response.output_text.delta\": ({ delta }) => [TurnEvent.TextDelta({ text: delta })],\n      \"response.function_call_arguments.delta\": ({ item_id, delta }) => {\n        const call_id = lookup.resolve(item_id)\n        return call_id === undefined ? [] : [TurnEvent.ToolCallArgsDelta({ call_id, delta })]\n      },\n      \"response.reasoning_text.delta\": ({ delta }) => [\n        TurnEvent.ReasoningDelta({ text: delta, kind: \"trace\" }),\n      ],\n      \"response.reasoning_summary_text.delta\": ({ delta }) => [\n        TurnEvent.ReasoningDelta({ text: delta, kind: \"summary\" }),\n      ],\n      \"response.refusal.delta\": ({ delta }) => [TurnEvent.RefusalDelta({ text: delta })],\n      // Terminal marker for the refusal stream; the deltas already covered\n      // the text, so no canonical event is emitted here.\n      \"response.refusal.done\": () => [],\n      \"response.web_search_call.in_progress\": () => [\n        TurnEvent.WebSearchCall({ status: \"started\" }),\n      ],\n      \"response.web_search_call.searching\": () => [\n        TurnEvent.WebSearchCall({ status: \"searching\" }),\n      ],\n      \"response.web_search_call.completed\": () => [\n        TurnEvent.WebSearchCall({ status: \"completed\" }),\n      ],\n      \"response.output_text.annotation.added\": ({ annotation }) => [\n        TurnEvent.CitationAdded({ annotation }),\n      ],\n      \"response.completed\": ({ response }) => [\n        TurnEvent.TurnComplete({ turn: turnFromCompleted(response) }),\n      ],\n      // Incomplete = the model stopped early but produced a usable partial\n      // turn (max_tokens, content_filter, max_tool_calls, refusal). Same\n      // payload shape as `response.completed`; the stop_reason carries the\n      // reason.\n      \"response.incomplete\": ({ response }) => [\n        TurnEvent.TurnComplete({ turn: turnFromCompleted(response) }),\n      ],\n      // Failed and error are surfaced separately as `AiError` by the stream\n      // pipeline, not as canonical events.\n      \"response.failed\": () => [],\n      error: () => [],\n      // No silent drops: unknown wire events flow through `streamNative` but\n      // produce no canonical delta. Step 3 (canonical `other` event) replaces\n      // this with a forwarded `other` delta on `TurnEvent`.\n      _unknown: () => [],\n    }),\n  )\n"],"mappings":"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"}