@effect-uai/responses 0.9.0 → 0.11.0

package/dist/OpenAIDeepResearch.d.mts

@@ -0,0 +1,54 @@
+import { WireResponseCompleted } from "./codec.mjs";
+import { OpenAIDeepResearchModel } from "./models.mjs";
+import { OpenAiRegion } from "./region.mjs";
+import { Context, Effect, Layer, Redacted } from "effect";
+import { HttpClient } from "effect/unstable/http";
+import { DeepResearch, DeepResearchServiceShape } from "@effect-uai/core/DeepResearch";
+import * as Job from "@effect-uai/core/Job";
+import { ResearchRequest, ResearchState } from "@effect-uai/core/Research";
+
+//#region src/OpenAIDeepResearch.d.ts
+declare namespace OpenAIDeepResearch_d_exports {
+  export { Config, OpenAIDeepResearch, OpenAIDeepResearchService, OpenAIResearchRequest, jobStateOf, layer, make };
+}
+/**
+ * OpenAI-typed research request. Narrows `model` to the deep-research ids and
+ * adds `maxSearches` (mapped to `max_tool_calls`) and a `reasoning` hint.
+ * Provider-portable code uses the generic `DeepResearch` tag instead.
+ */
+type OpenAIResearchRequest = Omit<ResearchRequest, "model"> & {
+  readonly model?: OpenAIDeepResearchModel; /** Cost/latency cap on the agent's tool calls. Maps to `max_tool_calls`. */
+  readonly maxSearches?: number; /** Reasoning-effort hint; `summary: "auto"` streams reasoning summaries. */
+  readonly reasoning?: {
+    readonly effort?: "low" | "medium" | "high";
+    readonly summary?: "auto" | "concise" | "detailed";
+  };
+};
+type OpenAIDeepResearchService = DeepResearchServiceShape<OpenAIResearchRequest>;
+declare const OpenAIDeepResearch_base: Context.ServiceClass<OpenAIDeepResearch, "@betalyra/effect-uai/providers/responses/OpenAIDeepResearch", OpenAIDeepResearchService>;
+/**
+ * Provider-typed tag. Yield this for the OpenAI model / `maxSearches` knobs;
+ * yield the generic `DeepResearch` tag for provider-portable code. The
+ * background job is detachable and streams live over the resumable Responses
+ * SSE, so `streamFrom` is a real event stream (not the synthesized fallback) and
+ * a persisted ref survives a restart.
+ */
+declare class OpenAIDeepResearch extends OpenAIDeepResearch_base {}
+type Config = {
+  readonly apiKey: Redacted.Redacted;
+  readonly baseUrl?: string;
+  readonly region?: OpenAiRegion; /** Poll cadence / overall timeout for the derived poll loops. */
+  readonly job?: Job.JobConfig;
+};
+declare const jobStateOf: (wire: WireResponseCompleted) => ResearchState;
+/** Build an `OpenAIDeepResearchService`. For Layer setup, prefer {@link layer}. */
+declare const make: (cfg: Config) => Effect.Effect<OpenAIDeepResearchService, never, HttpClient.HttpClient>;
+/**
+ * Layer registering the provider-typed `OpenAIDeepResearch` tag and the generic
+ * `DeepResearch` tag. No capability markers: the whole surface (detach, live
+ * stream, cancel) is universal.
+ */
+declare const layer: (cfg: Config) => Layer.Layer<OpenAIDeepResearch | DeepResearch, never, HttpClient.HttpClient>;
+//#endregion
+export { Config, OpenAIDeepResearch, OpenAIDeepResearchService, OpenAIResearchRequest, jobStateOf, layer, make, OpenAIDeepResearch_d_exports as t };
+//# sourceMappingURL=OpenAIDeepResearch.d.mts.map

package/dist/OpenAIDeepResearch.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenAIDeepResearch.d.mts","names":[],"sources":["../src/OpenAIDeepResearch.ts"],"mappings":";;;;;;;;;;;;;;;;;;KA4BY,qBAAA,GAAwB,IAAA,CAAK,eAAA;EAAA,SAC9B,KAAA,GAAQ,uBAAA;WAER,WAAA;WAEA,SAAA;IAAA,SACE,MAAA;IAAA,SACA,OAAA;EAAA;AAAA;AAAA,KAID,yBAAA,GAA4B,wBAAA,CAAyB,qBAAA;AAAA,cAAsB,uBAAA;;;;;;;;cAS1E,kBAAA,SAA2B,uBAAA;AAAA,KAK5B,MAAA;EAAA,SACD,MAAA,EAAQ,QAAA,CAAS,QAAA;EAAA,SACjB,OAAA;EAAA,SACA,MAAA,GAAS,YAAA,EAjBR;EAAA,SAmBD,GAAA,GAAM,GAAA,CAAI,SAAA;AAAA;AAAA,cA2BR,UAAA,GAAc,IAAA,EAAM,qBAAA,KAAwB,aAAA;;cA2J5C,IAAA,GACX,GAAA,EAAK,MAAA,KACJ,MAAA,CAAO,MAAA,CAAO,yBAAA,SAAkC,UAAA,CAAW,UAAA;;;;;;cAQjD,KAAA,GACX,GAAA,EAAK,MAAA,KACJ,KAAA,CAAM,KAAA,CAAM,kBAAA,GAAqB,YAAA,SAAqB,UAAA,CAAW,UAAA"}

package/dist/OpenAIDeepResearch.mjs

@@ -0,0 +1,121 @@
+import { t as __exportAll } from "./chunk-CfYAbeIz.mjs";
+import { WireResponseCompleted, itemsToInput, turnFromCompleted } from "./codec.mjs";
+import { resolveHost } from "./region.mjs";
+import { httpStatusError, providerEventsOfResponse, toCanonical } from "./Responses.mjs";
+import { Context, Effect, Layer, Match, Option, Schema, Stream } from "effect";
+import { HttpClient, HttpClientRequest } from "effect/unstable/http";
+import * as AiError from "@effect-uai/core/AiError";
+import { DeepResearch, fromJob } from "@effect-uai/core/DeepResearch";
+import * as Job from "@effect-uai/core/Job";
+//#region src/OpenAIDeepResearch.ts
+var OpenAIDeepResearch_exports = /* @__PURE__ */ __exportAll({
+	OpenAIDeepResearch: () => OpenAIDeepResearch,
+	jobStateOf: () => jobStateOf,
+	layer: () => layer,
+	make: () => make
+});
+/**
+* Provider-typed tag. Yield this for the OpenAI model / `maxSearches` knobs;
+* yield the generic `DeepResearch` tag for provider-portable code. The
+* background job is detachable and streams live over the resumable Responses
+* SSE, so `streamFrom` is a real event stream (not the synthesized fallback) and
+* a persisted ref survives a restart.
+*/
+var OpenAIDeepResearch = class extends Context.Service()("@betalyra/effect-uai/providers/responses/OpenAIDeepResearch") {};
+const decodeResponse = Schema.decodeUnknownEffect(WireResponseCompleted);
+const WireCreated = Schema.Struct({ response: Schema.Struct({ id: Schema.String }) });
+const decodeCreated = Schema.decodeUnknownEffect(WireCreated);
+const responseIdOf = (event) => event.type === "_unknown" ? decodeCreated(event.raw).pipe(Effect.map((wire) => Option.some(wire.response.id)), Effect.orElseSucceed(() => Option.none())) : Effect.succeedNone;
+const jobStateOf = (wire) => Match.value(wire.status ?? "").pipe(Match.when("queued", () => ({ _tag: "Pending" })), Match.when("in_progress", () => ({ _tag: "Running" })), Match.whenOr("completed", "incomplete", () => ({
+	_tag: "Succeeded",
+	result: turnFromCompleted(wire)
+})), Match.whenOr("failed", "cancelled", () => ({
+	_tag: "Failed",
+	...wire.error?.message != null && { reason: wire.error.message },
+	raw: wire
+})), Match.orElse(() => ({ _tag: "Running" })));
+const transportFailure = (cause) => new AiError.Unavailable({
+	provider: "responses",
+	raw: cause
+});
+const submitBody = (request) => ({
+	model: request.model ?? "o3-deep-research",
+	input: itemsToInput(request.history),
+	background: true,
+	store: true,
+	tools: [{ type: "web_search_preview" }],
+	...request.maxSearches !== void 0 && { max_tool_calls: request.maxSearches },
+	...request.reasoning !== void 0 && { reasoning: request.reasoning }
+});
+const submitJob = (cfg, request) => Effect.gen(function* () {
+	const client = yield* HttpClient.HttpClient;
+	const httpRequest = HttpClientRequest.post(`${resolveHost(cfg)}/responses`).pipe(HttpClientRequest.bearerToken(cfg.apiKey), HttpClientRequest.accept("text/event-stream"), HttpClientRequest.bodyJsonUnsafe({
+		...submitBody(request),
+		stream: true
+	}));
+	const id = yield* providerEventsOfResponse(yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure))).pipe(Stream.mapEffect(responseIdOf), Stream.filter(Option.isSome), Stream.map((some) => some.value), Stream.runHead);
+	return yield* Option.match(id, {
+		onNone: () => Effect.fail(new AiError.GenerationFailed({
+			provider: "responses",
+			message: "streaming create ended without a response id",
+			raw: submitBody(request)
+		})),
+		onSome: (value) => Effect.succeed(Job.jobRef("responses", value))
+	});
+});
+const pollJob = (cfg, ref) => Effect.gen(function* () {
+	const client = yield* HttpClient.HttpClient;
+	const httpRequest = HttpClientRequest.get(`${resolveHost(cfg)}/responses/${ref.id}`).pipe(HttpClientRequest.bearerToken(cfg.apiKey));
+	const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure));
+	if (response.status >= 400) {
+		const text = yield* response.text.pipe(Effect.orElseSucceed(() => ""));
+		return yield* httpStatusError(response.status, text);
+	}
+	return jobStateOf(yield* decodeResponse(yield* response.json.pipe(Effect.mapError(transportFailure))).pipe(Effect.mapError(transportFailure)));
+});
+const cancelJob = (cfg, ref) => Effect.gen(function* () {
+	const client = yield* HttpClient.HttpClient;
+	const httpRequest = HttpClientRequest.post(`${resolveHost(cfg)}/responses/${ref.id}/cancel`).pipe(HttpClientRequest.bearerToken(cfg.apiKey));
+	const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure));
+	if (response.status >= 400) {
+		const text = yield* response.text.pipe(Effect.orElseSucceed(() => ""));
+		return yield* httpStatusError(response.status, text);
+	}
+});
+const streamFromRef = (cfg, ref) => Stream.unwrap(Effect.gen(function* () {
+	const client = yield* HttpClient.HttpClient;
+	const httpRequest = HttpClientRequest.get(`${resolveHost(cfg)}/responses/${ref.id}?stream=true`).pipe(HttpClientRequest.bearerToken(cfg.apiKey), HttpClientRequest.accept("text/event-stream"));
+	return toCanonical(providerEventsOfResponse(yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure))));
+}));
+const jobOps = (cfg, client) => {
+	const withClient = (e) => Effect.provideService(e, HttpClient.HttpClient, client);
+	const withClientStream = (s) => Stream.provideService(s, HttpClient.HttpClient, client);
+	return {
+		submit: (request) => withClient(submitJob(cfg, request)),
+		poll: (ref) => withClient(pollJob(cfg, ref)),
+		cancel: (ref) => withClient(cancelJob(cfg, ref)),
+		streamFrom: (ref) => withClientStream(streamFromRef(cfg, ref))
+	};
+};
+/** Build an `OpenAIDeepResearchService`. For Layer setup, prefer {@link layer}. */
+const make = (cfg) => Effect.map(HttpClient.HttpClient, (client) => fromJob(jobOps(cfg, client), cfg.job));
+/**
+* Layer registering the provider-typed `OpenAIDeepResearch` tag and the generic
+* `DeepResearch` tag. No capability markers: the whole surface (detach, live
+* stream, cancel) is universal.
+*/
+const layer = (cfg) => {
+	const typed = Layer.effect(OpenAIDeepResearch, make(cfg));
+	const generic = Layer.effect(DeepResearch, Effect.map(HttpClient.HttpClient, (client) => {
+		const ops = jobOps(cfg, client);
+		return fromJob({
+			...ops,
+			submit: (request) => ops.submit(request)
+		}, cfg.job);
+	}));
+	return Layer.merge(typed, generic);
+};
+//#endregion
+export { OpenAIDeepResearch, jobStateOf, layer, make, OpenAIDeepResearch_exports as t };
+
+//# sourceMappingURL=OpenAIDeepResearch.mjs.map

package/dist/OpenAIDeepResearch.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenAIDeepResearch.mjs","names":[],"sources":["../src/OpenAIDeepResearch.ts"],"sourcesContent":["import { Context, Effect, Layer, Match, Option, Redacted, Schema, Stream } from \"effect\"\nimport { HttpClient, HttpClientRequest } from \"effect/unstable/http\"\nimport * as AiError from \"@effect-uai/core/AiError\"\nimport {\n  DeepResearch,\n  type DeepResearchService,\n  type DeepResearchServiceShape,\n  fromJob,\n  type ResearchJobOps,\n} from \"@effect-uai/core/DeepResearch\"\nimport * as Job from \"@effect-uai/core/Job\"\nimport type { ResearchJobRef, ResearchRequest, ResearchState } from \"@effect-uai/core/Research\"\nimport type { Turn, TurnEvent } from \"@effect-uai/core/Turn\"\nimport { WireResponseCompleted, turnFromCompleted, itemsToInput } from \"./codec.js\"\nimport type { OpenAIDeepResearchModel } from \"./models.js\"\nimport { type OpenAiRegion, resolveHost } from \"./region.js\"\nimport { httpStatusError, providerEventsOfResponse, toCanonical } from \"./Responses.js\"\nimport type { ProviderEvent } from \"./streamEvents.js\"\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\n/**\n * OpenAI-typed research request. Narrows `model` to the deep-research ids and\n * adds `maxSearches` (mapped to `max_tool_calls`) and a `reasoning` hint.\n * Provider-portable code uses the generic `DeepResearch` tag instead.\n */\nexport type OpenAIResearchRequest = Omit<ResearchRequest, \"model\"> & {\n  readonly model?: OpenAIDeepResearchModel\n  /** Cost/latency cap on the agent's tool calls. Maps to `max_tool_calls`. */\n  readonly maxSearches?: number\n  /** Reasoning-effort hint; `summary: \"auto\"` streams reasoning summaries. */\n  readonly reasoning?: {\n    readonly effort?: \"low\" | \"medium\" | \"high\"\n    readonly summary?: \"auto\" | \"concise\" | \"detailed\"\n  }\n}\n\nexport type OpenAIDeepResearchService = DeepResearchServiceShape<OpenAIResearchRequest>\n\n/**\n * Provider-typed tag. Yield this for the OpenAI model / `maxSearches` knobs;\n * yield the generic `DeepResearch` tag for provider-portable code. The\n * background job is detachable and streams live over the resumable Responses\n * SSE, so `streamFrom` is a real event stream (not the synthesized fallback) and\n * a persisted ref survives a restart.\n */\nexport class OpenAIDeepResearch extends Context.Service<\n  OpenAIDeepResearch,\n  OpenAIDeepResearchService\n>()(\"@betalyra/effect-uai/providers/responses/OpenAIDeepResearch\") {}\n\nexport type Config = {\n  readonly apiKey: Redacted.Redacted\n  readonly baseUrl?: string\n  readonly region?: OpenAiRegion\n  /** Poll cadence / overall timeout for the derived poll loops. */\n  readonly job?: Job.JobConfig\n}\n\n// ---------------------------------------------------------------------------\n// Wire codec\n// ---------------------------------------------------------------------------\n\nconst decodeResponse = Schema.decodeUnknownEffect(WireResponseCompleted)\n\n// Any early lifecycle event (`response.created` / `response.queued` / ...)\n// carries the response object; only its id matters here. These events are not\n// in the modeled `ProviderEvent` union, so they arrive as `_unknown`.\nconst WireCreated = Schema.Struct({ response: Schema.Struct({ id: Schema.String }) })\nconst decodeCreated = Schema.decodeUnknownEffect(WireCreated)\n\nconst responseIdOf = (event: ProviderEvent): Effect.Effect<Option.Option<string>> =>\n  event.type === \"_unknown\"\n    ? decodeCreated(event.raw).pipe(\n        Effect.map((wire) => Option.some(wire.response.id)),\n        Effect.orElseSucceed(() => Option.none<string>()),\n      )\n    : Effect.succeedNone\n\n// Map a Responses object's `status` onto the generic `JobState`. `completed`\n// and `incomplete` both carry a usable turn (incomplete = stopped early with a\n// partial answer, same shape); `failed` / `cancelled` are terminal failures.\n// An unknown / absent status keeps the loop polling (bounded by the timeout).\nexport const jobStateOf = (wire: WireResponseCompleted): ResearchState =>\n  Match.value(wire.status ?? \"\").pipe(\n    Match.when(\"queued\", (): ResearchState => ({ _tag: \"Pending\" })),\n    Match.when(\"in_progress\", (): ResearchState => ({ _tag: \"Running\" })),\n    Match.whenOr(\n      \"completed\",\n      \"incomplete\",\n      (): ResearchState => ({ _tag: \"Succeeded\", result: turnFromCompleted(wire) }),\n    ),\n    Match.whenOr(\n      \"failed\",\n      \"cancelled\",\n      (): ResearchState => ({\n        _tag: \"Failed\",\n        ...(wire.error?.message != null && { reason: wire.error.message }),\n        raw: wire,\n      }),\n    ),\n    Match.orElse((): ResearchState => ({ _tag: \"Running\" })),\n  )\n\n// ---------------------------------------------------------------------------\n// HTTP\n// ---------------------------------------------------------------------------\n\nconst transportFailure = (cause: unknown): AiError.AiError =>\n  new AiError.Unavailable({ provider: \"responses\", raw: cause })\n\n// Deep research requires at least one data-source tool; default to web search.\nconst submitBody = (request: OpenAIResearchRequest): Record<string, unknown> => ({\n  model: request.model ?? \"o3-deep-research\",\n  input: itemsToInput(request.history),\n  background: true,\n  store: true,\n  tools: [{ type: \"web_search_preview\" }],\n  ...(request.maxSearches !== undefined && { max_tool_calls: request.maxSearches }),\n  ...(request.reasoning !== undefined && { reasoning: request.reasoning }),\n})\n\n// The job is created with `stream: true` on top of `background: true`: OpenAI\n// only exposes a resumable event feed on responses *created* streaming, so this\n// keeps every submitted ref attachable via `streamFrom`. Only the first SSE\n// event is read (for the response id); the connection is then dropped and the\n// background job keeps running server-side.\nconst submitJob = (\n  cfg: Config,\n  request: OpenAIResearchRequest,\n): Effect.Effect<ResearchJobRef, AiError.AiError, HttpClient.HttpClient> =>\n  Effect.gen(function* () {\n    const client = yield* HttpClient.HttpClient\n    const httpRequest = HttpClientRequest.post(`${resolveHost(cfg)}/responses`).pipe(\n      HttpClientRequest.bearerToken(cfg.apiKey),\n      HttpClientRequest.accept(\"text/event-stream\"),\n      HttpClientRequest.bodyJsonUnsafe({ ...submitBody(request), stream: true }),\n    )\n    const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure))\n    const id = yield* providerEventsOfResponse(response).pipe(\n      Stream.mapEffect(responseIdOf),\n      Stream.filter(Option.isSome),\n      Stream.map((some) => some.value),\n      Stream.runHead,\n    )\n    return yield* Option.match(id, {\n      onNone: () =>\n        Effect.fail(\n          new AiError.GenerationFailed({\n            provider: \"responses\",\n            message: \"streaming create ended without a response id\",\n            raw: submitBody(request),\n          }),\n        ),\n      onSome: (value) => Effect.succeed(Job.jobRef<Turn>(\"responses\", value)),\n    })\n  })\n\nconst pollJob = (\n  cfg: Config,\n  ref: ResearchJobRef,\n): Effect.Effect<ResearchState, AiError.AiError, HttpClient.HttpClient> =>\n  Effect.gen(function* () {\n    const client = yield* HttpClient.HttpClient\n    const httpRequest = HttpClientRequest.get(`${resolveHost(cfg)}/responses/${ref.id}`).pipe(\n      HttpClientRequest.bearerToken(cfg.apiKey),\n    )\n    const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure))\n    if (response.status >= 400) {\n      const text = yield* response.text.pipe(Effect.orElseSucceed(() => \"\"))\n      return yield* httpStatusError(response.status, text)\n    }\n    const json = yield* response.json.pipe(Effect.mapError(transportFailure))\n    const wire = yield* decodeResponse(json).pipe(Effect.mapError(transportFailure))\n    return jobStateOf(wire)\n  })\n\nconst cancelJob = (\n  cfg: Config,\n  ref: ResearchJobRef,\n): Effect.Effect<void, AiError.AiError, HttpClient.HttpClient> =>\n  Effect.gen(function* () {\n    const client = yield* HttpClient.HttpClient\n    const httpRequest = HttpClientRequest.post(\n      `${resolveHost(cfg)}/responses/${ref.id}/cancel`,\n    ).pipe(HttpClientRequest.bearerToken(cfg.apiKey))\n    const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure))\n    if (response.status >= 400) {\n      const text = yield* response.text.pipe(Effect.orElseSucceed(() => \"\"))\n      return yield* httpStatusError(response.status, text)\n    }\n  })\n\n// Attach a live event stream to a detached job via the resumable Responses SSE,\n// reusing the shared decode pipeline and the canonical `TurnEvent` projection.\nconst streamFromRef = (\n  cfg: Config,\n  ref: ResearchJobRef,\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.get(\n        `${resolveHost(cfg)}/responses/${ref.id}?stream=true`,\n      ).pipe(\n        HttpClientRequest.bearerToken(cfg.apiKey),\n        HttpClientRequest.accept(\"text/event-stream\"),\n      )\n      const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure))\n      return toCanonical(providerEventsOfResponse(response))\n    }),\n  )\n\n// ---------------------------------------------------------------------------\n// Constructors\n// ---------------------------------------------------------------------------\n\n// The job ops. OpenAI streams live over the resumable Responses SSE, so it\n// supplies a real `streamFrom` (not the synthesized fallback). Since `submit`\n// creates the job streaming, `fromJob`'s default `researchStream`\n// (submit-then-attach) streams real events too.\nconst jobOps = (\n  cfg: Config,\n  client: HttpClient.HttpClient,\n): ResearchJobOps<OpenAIResearchRequest> => {\n  const withClient = <A>(e: Effect.Effect<A, AiError.AiError, HttpClient.HttpClient>) =>\n    Effect.provideService(e, HttpClient.HttpClient, client)\n  const withClientStream = <A>(s: Stream.Stream<A, AiError.AiError, HttpClient.HttpClient>) =>\n    Stream.provideService(s, HttpClient.HttpClient, client)\n  return {\n    submit: (request) => withClient(submitJob(cfg, request)),\n    poll: (ref) => withClient(pollJob(cfg, ref)),\n    cancel: (ref) => withClient(cancelJob(cfg, ref)),\n    streamFrom: (ref) => withClientStream(streamFromRef(cfg, ref)),\n  }\n}\n\n/** Build an `OpenAIDeepResearchService`. For Layer setup, prefer {@link layer}. */\nexport const make = (\n  cfg: Config,\n): Effect.Effect<OpenAIDeepResearchService, never, HttpClient.HttpClient> =>\n  Effect.map(HttpClient.HttpClient, (client) => fromJob(jobOps(cfg, client), cfg.job))\n\n/**\n * Layer registering the provider-typed `OpenAIDeepResearch` tag and the generic\n * `DeepResearch` tag. No capability markers: the whole surface (detach, live\n * stream, cancel) is universal.\n */\nexport const layer = (\n  cfg: Config,\n): Layer.Layer<OpenAIDeepResearch | DeepResearch, never, HttpClient.HttpClient> => {\n  const typed = Layer.effect(OpenAIDeepResearch, make(cfg))\n  const generic = Layer.effect(\n    DeepResearch,\n    Effect.map(HttpClient.HttpClient, (client): DeepResearchService => {\n      const ops = jobOps(cfg, client)\n      return fromJob<ResearchRequest>(\n        { ...ops, submit: (request) => ops.submit(request as OpenAIResearchRequest) },\n        cfg.job,\n      )\n    }),\n  )\n  return Layer.merge(typed, generic)\n}\n"],"mappings":"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"}

package/dist/OpenAIEmbedding.mjs

@@ -140,7 +140,7 @@ const embedManyImpl = (cfg) => (request) => buildBatchBody(request).pipe(Effect.
 * Build an `OpenAIEmbeddingService` value. For Layer-based setup, prefer
 * `layer`.
 */
-const make = (cfg) => Effect.map(HttpClient.HttpClient.asEffect(), (client) => ({
+const make = (cfg) => Effect.map(HttpClient.HttpClient, (client) => ({
 	embed: (request) => embedImpl(cfg)(request).pipe(Effect.provideService(HttpClient.HttpClient, client)),
 	embedMany: (request) => embedManyImpl(cfg)(request).pipe(Effect.provideService(HttpClient.HttpClient, client))
 }));

package/dist/OpenAIEmbedding.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"OpenAIEmbedding.mjs","names":[],"sources":["../src/OpenAIEmbedding.ts"],"sourcesContent":["import { Context, Effect, Layer, Redacted, Schema } from \"effect\"\nimport { HttpClient, HttpClientRequest } from \"effect/unstable/http\"\nimport * as AiError from \"@effect-uai/core/AiError\"\nimport * as Capabilities from \"@effect-uai/core/Capabilities\"\nimport type {\n  EmbedContentPart,\n  EmbedInput,\n  Float32Embedding,\n  Usage,\n} from \"@effect-uai/core/Embedding\"\nimport {\n  assertEncoding,\n  type CommonEmbedManyRequest,\n  type CommonEmbedRequest,\n  type EmbedEncoding,\n  EmbeddingModel,\n  type EmbeddingModelService,\n  type EmbedManyResponse,\n  type EmbedResponse,\n} from \"@effect-uai/core/EmbeddingModel\"\nimport type { OpenAIEmbeddingModel } from \"./models.js\"\nimport { type OpenAiRegion, resolveHost } from \"./region.js\"\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\n/**\n * OpenAI's embedding API has no task-type semantics, so `task` is omitted\n * from the request type intentionally - passing it would be a compile\n * error. The generic `EmbeddingModel` registration accepts and silently\n * ignores `task` from `CommonEmbedRequest`.\n */\nexport type OpenAIEmbedRequest = Omit<CommonEmbedRequest, \"model\" | \"task\" | \"encoding\"> & {\n  /** Narrows `CommonEmbedRequest.model` to the typed OpenAI union. */\n  readonly model: OpenAIEmbeddingModel\n}\n\nexport type OpenAIEmbedManyRequest = Omit<OpenAIEmbedRequest, \"input\"> & {\n  readonly inputs: ReadonlyArray<EmbedInput>\n}\n\nexport type OpenAIEmbeddingService = {\n  readonly embed: (request: OpenAIEmbedRequest) => Effect.Effect<EmbedResponse, AiError.AiError>\n  readonly embedMany: (\n    request: OpenAIEmbedManyRequest,\n  ) => Effect.Effect<EmbedManyResponse, AiError.AiError>\n}\n\n/**\n * Provider-typed service tag. Yield this for OpenAI-typed embedding\n * requests; yield the generic `EmbeddingModel` tag for provider-portable\n * code. Both are registered by `layer`.\n */\nexport class OpenAIEmbedding extends Context.Service<OpenAIEmbedding, OpenAIEmbeddingService>()(\n  \"@betalyra/effect-uai/providers/responses/OpenAIEmbedding\",\n) {}\n\nexport type Config = {\n  readonly apiKey: Redacted.Redacted\n  readonly baseUrl?: string\n  readonly region?: OpenAiRegion\n}\n\n// ---------------------------------------------------------------------------\n// Codec - input flattening to the single string OpenAI expects\n// ---------------------------------------------------------------------------\n\n// Image input on a text-only embedder is bucket 1: a silently dropped image\n// yields a vector that represents the wrong thing. Reject with `Unsupported`\n// (capability gap), not `InvalidRequest` (which is for wire-shape mismatches).\n// OpenAI's embeddings API remains text-only as of June 2026.\nconst imageRejected: AiError.AiError = new AiError.Unsupported({\n  provider: \"openai\",\n  capability: \"imageEmbedding\",\n  reason: \"OpenAI embeddings are text-only; pass a string or { text }.\",\n})\n\nconst partToText = (part: EmbedContentPart): Effect.Effect<string, AiError.AiError> =>\n  \"text\" in part ? Effect.succeed(part.text) : Effect.fail(imageRejected)\n\n/**\n * OpenAI accepts a single string per input. Pure-text `content[]` is\n * concatenated with newlines (treats them as paragraphs of one document);\n * any image part fails with `Unsupported`.\n */\nconst inputToString = (input: EmbedInput): Effect.Effect<string, AiError.AiError> => {\n  if (typeof input === \"string\") return Effect.succeed(input)\n  if (\"text\" in input) return Effect.succeed(input.text)\n  if (\"image\" in input) return Effect.fail(imageRejected)\n  return Effect.forEach(input.content, partToText).pipe(Effect.map((texts) => texts.join(\"\\n\")))\n}\n\n// ---------------------------------------------------------------------------\n// Codec - request body\n// ---------------------------------------------------------------------------\n\ntype WireBody = {\n  readonly model: string\n  readonly input: string | ReadonlyArray<string>\n  readonly dimensions?: number\n  readonly encoding_format?: \"float\" | \"base64\"\n}\n\nconst buildSingleBody = (request: OpenAIEmbedRequest): Effect.Effect<WireBody, AiError.AiError> =>\n  inputToString(request.input).pipe(\n    Effect.map((input) => ({\n      model: request.model,\n      input,\n      ...(request.dimensions !== undefined && { dimensions: request.dimensions }),\n    })),\n  )\n\nconst buildBatchBody = (\n  request: OpenAIEmbedManyRequest,\n): Effect.Effect<WireBody, AiError.AiError> =>\n  Effect.forEach(request.inputs, inputToString).pipe(\n    Effect.map((inputs) => ({\n      model: request.model,\n      input: inputs,\n      ...(request.dimensions !== undefined && { dimensions: request.dimensions }),\n    })),\n  )\n\n// ---------------------------------------------------------------------------\n// Codec - response\n// ---------------------------------------------------------------------------\n\nconst WireEmbeddingItem = Schema.Struct({\n  embedding: Schema.Array(Schema.Number),\n  index: Schema.Number,\n})\n\nconst WireUsage = Schema.Struct({\n  prompt_tokens: Schema.Number,\n  total_tokens: Schema.Number,\n})\n\nconst WireResponse = Schema.Struct({\n  data: Schema.Array(WireEmbeddingItem),\n  model: Schema.String,\n  usage: WireUsage,\n})\n\nconst valuesToEmbedding = (values: ReadonlyArray<number>): Float32Embedding => ({\n  _tag: \"float32\",\n  vector: Float32Array.from(values),\n})\n\n// OpenAI returns `data[]` unsorted in theory; sort by `index` so caller\n// gets results in the order they passed inputs.\nconst orderedEmbeddings = (\n  data: ReadonlyArray<{ readonly embedding: ReadonlyArray<number>; readonly index: number }>,\n): ReadonlyArray<Float32Embedding> =>\n  [...data].sort((a, b) => a.index - b.index).map((item) => valuesToEmbedding(item.embedding))\n\n// ---------------------------------------------------------------------------\n// HTTP errors\n// ---------------------------------------------------------------------------\n\nconst httpStatusError = (status: number, body: string): AiError.AiError => {\n  const provider = \"openai\"\n  const raw = body\n  if (status === 429) return new AiError.RateLimited({ provider, raw })\n  if (status === 408 || status === 504) return new AiError.Timeout({ provider, raw })\n  if (status === 401) return new AiError.AuthFailed({ provider, subtype: \"auth\", raw })\n  if (status === 403) return new AiError.AuthFailed({ provider, subtype: \"permission\", raw })\n  if (status === 402) return new AiError.AuthFailed({ provider, subtype: \"billing\", raw })\n  if (status === 413) return new AiError.ContextLengthExceeded({ provider, raw })\n  if (status >= 500) return new AiError.Unavailable({ provider, status, raw })\n  return new AiError.InvalidRequest({ provider, raw })\n}\n\nconst transportFailure = (cause: unknown): AiError.AiError =>\n  new AiError.Unavailable({ provider: \"openai\", raw: cause })\n\n// ---------------------------------------------------------------------------\n// HTTP plumbing\n// ---------------------------------------------------------------------------\n\nconst postEmbed = (\n  cfg: Config,\n  body: WireBody,\n): Effect.Effect<typeof WireResponse.Type, AiError.AiError, HttpClient.HttpClient> =>\n  Effect.gen(function* () {\n    const client = yield* HttpClient.HttpClient\n    const httpRequest = HttpClientRequest.post(`${resolveHost(cfg)}/embeddings`).pipe(\n      HttpClientRequest.bearerToken(cfg.apiKey),\n      HttpClientRequest.bodyJsonUnsafe(body),\n    )\n    const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure))\n    if (response.status >= 400) {\n      const text = yield* response.text.pipe(Effect.orElseSucceed(() => \"\"))\n      return yield* httpStatusError(response.status, text)\n    }\n    const json = yield* response.json.pipe(Effect.mapError(transportFailure))\n    return yield* Schema.decodeUnknownEffect(WireResponse)(json).pipe(\n      Effect.mapError(transportFailure),\n    )\n  })\n\n// ---------------------------------------------------------------------------\n// Service implementation\n// ---------------------------------------------------------------------------\n\nconst usageOf = (u: typeof WireUsage.Type): Usage => ({ inputTokens: u.prompt_tokens })\n\n// `task` is dropped on the generic path (OpenAI has no task parameter on any\n// model, so this is a per-Layer gap, not per-model). Bucket 2: warn, don't fail.\nconst warnTaskDropped = (task: CommonEmbedRequest[\"task\"]): Effect.Effect<void> =>\n  Capabilities.warnDroppedWhen(task, {\n    provider: \"openai\",\n    capability: \"task\",\n    field: \"task\",\n    reason: \"OpenAI embeddings have no task-type parameter.\",\n  })\n\nconst embedImpl =\n  (cfg: Config) =>\n  (\n    request: OpenAIEmbedRequest,\n  ): Effect.Effect<EmbedResponse, AiError.AiError, HttpClient.HttpClient> =>\n    buildSingleBody(request).pipe(\n      Effect.flatMap((body) => postEmbed(cfg, body)),\n      Effect.flatMap((decoded) => {\n        const first = decoded.data[0]\n        if (first === undefined) {\n          return Effect.fail(transportFailure(\"OpenAI returned empty `data` array\"))\n        }\n        return Effect.succeed<EmbedResponse>({\n          embedding: valuesToEmbedding(first.embedding),\n          usage: usageOf(decoded.usage),\n        })\n      }),\n    )\n\nconst embedManyImpl =\n  (cfg: Config) =>\n  (\n    request: OpenAIEmbedManyRequest,\n  ): Effect.Effect<EmbedManyResponse, AiError.AiError, HttpClient.HttpClient> =>\n    buildBatchBody(request).pipe(\n      Effect.flatMap((body) => postEmbed(cfg, body)),\n      Effect.map(\n        (decoded): EmbedManyResponse => ({\n          embeddings: orderedEmbeddings(decoded.data),\n          usage: usageOf(decoded.usage),\n        }),\n      ),\n    )\n\n// ---------------------------------------------------------------------------\n// Constructors\n// ---------------------------------------------------------------------------\n\n/**\n * Build an `OpenAIEmbeddingService` value. For Layer-based setup, prefer\n * `layer`.\n */\nexport const make = (\n  cfg: Config,\n): Effect.Effect<OpenAIEmbeddingService, never, HttpClient.HttpClient> =>\n  Effect.map(HttpClient.HttpClient.asEffect(), (client) => ({\n    embed: (request) =>\n      embedImpl(cfg)(request).pipe(Effect.provideService(HttpClient.HttpClient, client)),\n    embedMany: (request) =>\n      embedManyImpl(cfg)(request).pipe(Effect.provideService(HttpClient.HttpClient, client)),\n  }))\n\n/**\n * Layer that registers both the provider-specific `OpenAIEmbedding` tag\n * and the generic `EmbeddingModel` tag, sharing one underlying\n * implementation. The generic registration trusts the caller; invalid\n * encodings produce an `InvalidRequest` from OpenAI's API.\n */\nexport const layer = (\n  cfg: Config,\n): Layer.Layer<OpenAIEmbedding | EmbeddingModel, never, HttpClient.HttpClient> => {\n  const typed = Layer.effect(OpenAIEmbedding, make(cfg))\n  const generic = Layer.effect(\n    EmbeddingModel,\n    Effect.map(\n      make(cfg),\n      (s): EmbeddingModelService => ({\n        // OpenAI emits float32 only and has no task parameter. Reject a\n        // non-float32 `encoding` (bucket 1, else a float32 vector comes back\n        // mislabeled as the requested type) and warn on a dropped `task`\n        // (bucket 2).\n        embed: <E extends EmbedEncoding | undefined = undefined>(\n          req: Omit<CommonEmbedRequest, \"encoding\"> & { readonly encoding?: E },\n        ) =>\n          assertEncoding(req.encoding, [\"float32\"], \"openai\").pipe(\n            Effect.andThen(warnTaskDropped(req.task)),\n            Effect.andThen(s.embed(req as OpenAIEmbedRequest)),\n          ) as Effect.Effect<EmbedResponse<E>, AiError.AiError>,\n        embedMany: <E extends EmbedEncoding | undefined = undefined>(\n          req: Omit<CommonEmbedManyRequest, \"encoding\"> & { readonly encoding?: E },\n        ) =>\n          assertEncoding(req.encoding, [\"float32\"], \"openai\").pipe(\n            Effect.andThen(warnTaskDropped(req.task)),\n            Effect.andThen(s.embedMany(req as OpenAIEmbedManyRequest)),\n          ) as Effect.Effect<EmbedManyResponse<E>, AiError.AiError>,\n      }),\n    ),\n  )\n  return Layer.merge(typed, generic)\n}\n"],"mappings":"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"}
+{"version":3,"file":"OpenAIEmbedding.mjs","names":[],"sources":["../src/OpenAIEmbedding.ts"],"sourcesContent":["import { Context, Effect, Layer, Redacted, Schema } from \"effect\"\nimport { HttpClient, HttpClientRequest } from \"effect/unstable/http\"\nimport * as AiError from \"@effect-uai/core/AiError\"\nimport * as Capabilities from \"@effect-uai/core/Capabilities\"\nimport type {\n  EmbedContentPart,\n  EmbedInput,\n  Float32Embedding,\n  Usage,\n} from \"@effect-uai/core/Embedding\"\nimport {\n  assertEncoding,\n  type CommonEmbedManyRequest,\n  type CommonEmbedRequest,\n  type EmbedEncoding,\n  EmbeddingModel,\n  type EmbeddingModelService,\n  type EmbedManyResponse,\n  type EmbedResponse,\n} from \"@effect-uai/core/EmbeddingModel\"\nimport type { OpenAIEmbeddingModel } from \"./models.js\"\nimport { type OpenAiRegion, resolveHost } from \"./region.js\"\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\n/**\n * OpenAI's embedding API has no task-type semantics, so `task` is omitted\n * from the request type intentionally - passing it would be a compile\n * error. The generic `EmbeddingModel` registration accepts and silently\n * ignores `task` from `CommonEmbedRequest`.\n */\nexport type OpenAIEmbedRequest = Omit<CommonEmbedRequest, \"model\" | \"task\" | \"encoding\"> & {\n  /** Narrows `CommonEmbedRequest.model` to the typed OpenAI union. */\n  readonly model: OpenAIEmbeddingModel\n}\n\nexport type OpenAIEmbedManyRequest = Omit<OpenAIEmbedRequest, \"input\"> & {\n  readonly inputs: ReadonlyArray<EmbedInput>\n}\n\nexport type OpenAIEmbeddingService = {\n  readonly embed: (request: OpenAIEmbedRequest) => Effect.Effect<EmbedResponse, AiError.AiError>\n  readonly embedMany: (\n    request: OpenAIEmbedManyRequest,\n  ) => Effect.Effect<EmbedManyResponse, AiError.AiError>\n}\n\n/**\n * Provider-typed service tag. Yield this for OpenAI-typed embedding\n * requests; yield the generic `EmbeddingModel` tag for provider-portable\n * code. Both are registered by `layer`.\n */\nexport class OpenAIEmbedding extends Context.Service<OpenAIEmbedding, OpenAIEmbeddingService>()(\n  \"@betalyra/effect-uai/providers/responses/OpenAIEmbedding\",\n) {}\n\nexport type Config = {\n  readonly apiKey: Redacted.Redacted\n  readonly baseUrl?: string\n  readonly region?: OpenAiRegion\n}\n\n// ---------------------------------------------------------------------------\n// Codec - input flattening to the single string OpenAI expects\n// ---------------------------------------------------------------------------\n\n// Image input on a text-only embedder is bucket 1: a silently dropped image\n// yields a vector that represents the wrong thing. Reject with `Unsupported`\n// (capability gap), not `InvalidRequest` (which is for wire-shape mismatches).\n// OpenAI's embeddings API remains text-only as of June 2026.\nconst imageRejected: AiError.AiError = new AiError.Unsupported({\n  provider: \"openai\",\n  capability: \"imageEmbedding\",\n  reason: \"OpenAI embeddings are text-only; pass a string or { text }.\",\n})\n\nconst partToText = (part: EmbedContentPart): Effect.Effect<string, AiError.AiError> =>\n  \"text\" in part ? Effect.succeed(part.text) : Effect.fail(imageRejected)\n\n/**\n * OpenAI accepts a single string per input. Pure-text `content[]` is\n * concatenated with newlines (treats them as paragraphs of one document);\n * any image part fails with `Unsupported`.\n */\nconst inputToString = (input: EmbedInput): Effect.Effect<string, AiError.AiError> => {\n  if (typeof input === \"string\") return Effect.succeed(input)\n  if (\"text\" in input) return Effect.succeed(input.text)\n  if (\"image\" in input) return Effect.fail(imageRejected)\n  return Effect.forEach(input.content, partToText).pipe(Effect.map((texts) => texts.join(\"\\n\")))\n}\n\n// ---------------------------------------------------------------------------\n// Codec - request body\n// ---------------------------------------------------------------------------\n\ntype WireBody = {\n  readonly model: string\n  readonly input: string | ReadonlyArray<string>\n  readonly dimensions?: number\n  readonly encoding_format?: \"float\" | \"base64\"\n}\n\nconst buildSingleBody = (request: OpenAIEmbedRequest): Effect.Effect<WireBody, AiError.AiError> =>\n  inputToString(request.input).pipe(\n    Effect.map((input) => ({\n      model: request.model,\n      input,\n      ...(request.dimensions !== undefined && { dimensions: request.dimensions }),\n    })),\n  )\n\nconst buildBatchBody = (\n  request: OpenAIEmbedManyRequest,\n): Effect.Effect<WireBody, AiError.AiError> =>\n  Effect.forEach(request.inputs, inputToString).pipe(\n    Effect.map((inputs) => ({\n      model: request.model,\n      input: inputs,\n      ...(request.dimensions !== undefined && { dimensions: request.dimensions }),\n    })),\n  )\n\n// ---------------------------------------------------------------------------\n// Codec - response\n// ---------------------------------------------------------------------------\n\nconst WireEmbeddingItem = Schema.Struct({\n  embedding: Schema.Array(Schema.Number),\n  index: Schema.Number,\n})\n\nconst WireUsage = Schema.Struct({\n  prompt_tokens: Schema.Number,\n  total_tokens: Schema.Number,\n})\n\nconst WireResponse = Schema.Struct({\n  data: Schema.Array(WireEmbeddingItem),\n  model: Schema.String,\n  usage: WireUsage,\n})\n\nconst valuesToEmbedding = (values: ReadonlyArray<number>): Float32Embedding => ({\n  _tag: \"float32\",\n  vector: Float32Array.from(values),\n})\n\n// OpenAI returns `data[]` unsorted in theory; sort by `index` so caller\n// gets results in the order they passed inputs.\nconst orderedEmbeddings = (\n  data: ReadonlyArray<{ readonly embedding: ReadonlyArray<number>; readonly index: number }>,\n): ReadonlyArray<Float32Embedding> =>\n  [...data].sort((a, b) => a.index - b.index).map((item) => valuesToEmbedding(item.embedding))\n\n// ---------------------------------------------------------------------------\n// HTTP errors\n// ---------------------------------------------------------------------------\n\nconst httpStatusError = (status: number, body: string): AiError.AiError => {\n  const provider = \"openai\"\n  const raw = body\n  if (status === 429) return new AiError.RateLimited({ provider, raw })\n  if (status === 408 || status === 504) return new AiError.Timeout({ provider, raw })\n  if (status === 401) return new AiError.AuthFailed({ provider, subtype: \"auth\", raw })\n  if (status === 403) return new AiError.AuthFailed({ provider, subtype: \"permission\", raw })\n  if (status === 402) return new AiError.AuthFailed({ provider, subtype: \"billing\", raw })\n  if (status === 413) return new AiError.ContextLengthExceeded({ provider, raw })\n  if (status >= 500) return new AiError.Unavailable({ provider, status, raw })\n  return new AiError.InvalidRequest({ provider, raw })\n}\n\nconst transportFailure = (cause: unknown): AiError.AiError =>\n  new AiError.Unavailable({ provider: \"openai\", raw: cause })\n\n// ---------------------------------------------------------------------------\n// HTTP plumbing\n// ---------------------------------------------------------------------------\n\nconst postEmbed = (\n  cfg: Config,\n  body: WireBody,\n): Effect.Effect<typeof WireResponse.Type, AiError.AiError, HttpClient.HttpClient> =>\n  Effect.gen(function* () {\n    const client = yield* HttpClient.HttpClient\n    const httpRequest = HttpClientRequest.post(`${resolveHost(cfg)}/embeddings`).pipe(\n      HttpClientRequest.bearerToken(cfg.apiKey),\n      HttpClientRequest.bodyJsonUnsafe(body),\n    )\n    const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure))\n    if (response.status >= 400) {\n      const text = yield* response.text.pipe(Effect.orElseSucceed(() => \"\"))\n      return yield* httpStatusError(response.status, text)\n    }\n    const json = yield* response.json.pipe(Effect.mapError(transportFailure))\n    return yield* Schema.decodeUnknownEffect(WireResponse)(json).pipe(\n      Effect.mapError(transportFailure),\n    )\n  })\n\n// ---------------------------------------------------------------------------\n// Service implementation\n// ---------------------------------------------------------------------------\n\nconst usageOf = (u: typeof WireUsage.Type): Usage => ({ inputTokens: u.prompt_tokens })\n\n// `task` is dropped on the generic path (OpenAI has no task parameter on any\n// model, so this is a per-Layer gap, not per-model). Bucket 2: warn, don't fail.\nconst warnTaskDropped = (task: CommonEmbedRequest[\"task\"]): Effect.Effect<void> =>\n  Capabilities.warnDroppedWhen(task, {\n    provider: \"openai\",\n    capability: \"task\",\n    field: \"task\",\n    reason: \"OpenAI embeddings have no task-type parameter.\",\n  })\n\nconst embedImpl =\n  (cfg: Config) =>\n  (\n    request: OpenAIEmbedRequest,\n  ): Effect.Effect<EmbedResponse, AiError.AiError, HttpClient.HttpClient> =>\n    buildSingleBody(request).pipe(\n      Effect.flatMap((body) => postEmbed(cfg, body)),\n      Effect.flatMap((decoded) => {\n        const first = decoded.data[0]\n        if (first === undefined) {\n          return Effect.fail(transportFailure(\"OpenAI returned empty `data` array\"))\n        }\n        return Effect.succeed<EmbedResponse>({\n          embedding: valuesToEmbedding(first.embedding),\n          usage: usageOf(decoded.usage),\n        })\n      }),\n    )\n\nconst embedManyImpl =\n  (cfg: Config) =>\n  (\n    request: OpenAIEmbedManyRequest,\n  ): Effect.Effect<EmbedManyResponse, AiError.AiError, HttpClient.HttpClient> =>\n    buildBatchBody(request).pipe(\n      Effect.flatMap((body) => postEmbed(cfg, body)),\n      Effect.map(\n        (decoded): EmbedManyResponse => ({\n          embeddings: orderedEmbeddings(decoded.data),\n          usage: usageOf(decoded.usage),\n        }),\n      ),\n    )\n\n// ---------------------------------------------------------------------------\n// Constructors\n// ---------------------------------------------------------------------------\n\n/**\n * Build an `OpenAIEmbeddingService` value. For Layer-based setup, prefer\n * `layer`.\n */\nexport const make = (\n  cfg: Config,\n): Effect.Effect<OpenAIEmbeddingService, never, HttpClient.HttpClient> =>\n  Effect.map(HttpClient.HttpClient, (client) => ({\n    embed: (request) =>\n      embedImpl(cfg)(request).pipe(Effect.provideService(HttpClient.HttpClient, client)),\n    embedMany: (request) =>\n      embedManyImpl(cfg)(request).pipe(Effect.provideService(HttpClient.HttpClient, client)),\n  }))\n\n/**\n * Layer that registers both the provider-specific `OpenAIEmbedding` tag\n * and the generic `EmbeddingModel` tag, sharing one underlying\n * implementation. The generic registration trusts the caller; invalid\n * encodings produce an `InvalidRequest` from OpenAI's API.\n */\nexport const layer = (\n  cfg: Config,\n): Layer.Layer<OpenAIEmbedding | EmbeddingModel, never, HttpClient.HttpClient> => {\n  const typed = Layer.effect(OpenAIEmbedding, make(cfg))\n  const generic = Layer.effect(\n    EmbeddingModel,\n    Effect.map(\n      make(cfg),\n      (s): EmbeddingModelService => ({\n        // OpenAI emits float32 only and has no task parameter. Reject a\n        // non-float32 `encoding` (bucket 1, else a float32 vector comes back\n        // mislabeled as the requested type) and warn on a dropped `task`\n        // (bucket 2).\n        embed: <E extends EmbedEncoding | undefined = undefined>(\n          req: Omit<CommonEmbedRequest, \"encoding\"> & { readonly encoding?: E },\n        ) =>\n          assertEncoding(req.encoding, [\"float32\"], \"openai\").pipe(\n            Effect.andThen(warnTaskDropped(req.task)),\n            Effect.andThen(s.embed(req as OpenAIEmbedRequest)),\n          ) as Effect.Effect<EmbedResponse<E>, AiError.AiError>,\n        embedMany: <E extends EmbedEncoding | undefined = undefined>(\n          req: Omit<CommonEmbedManyRequest, \"encoding\"> & { readonly encoding?: E },\n        ) =>\n          assertEncoding(req.encoding, [\"float32\"], \"openai\").pipe(\n            Effect.andThen(warnTaskDropped(req.task)),\n            Effect.andThen(s.embedMany(req as OpenAIEmbedManyRequest)),\n          ) as Effect.Effect<EmbedManyResponse<E>, AiError.AiError>,\n      }),\n    ),\n  )\n  return Layer.merge(typed, generic)\n}\n"],"mappings":"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"}

package/dist/Responses.d.mts

@@ -1,15 +1,16 @@
 import { OpenAIModel } from "./models.mjs";
 import { OpenAiRegion } from "./region.mjs";
+import { UserLocation, WebSearchFilters, WebSearchOptions, codeInterpreterTool, fileSearchTool, webSearchTool } from "./ResponsesTools.mjs";
 import { ProviderEvent } from "./streamEvents.mjs";
 import { Context, Effect, Layer, Redacted, Stream } from "effect";
-import { HttpClient } from "effect/unstable/http";
+import { HttpClient, HttpClientResponse } from "effect/unstable/http";
 import * as AiError from "@effect-uai/core/AiError";
 import { CommonRequest, LanguageModel } from "@effect-uai/core/LanguageModel";
 import { Turn, TurnEvent } from "@effect-uai/core/Turn";
 
 //#region src/Responses.d.ts
 declare namespace Responses_d_exports {
-  export { Config, Responses, ResponsesRequest, ResponsesService, layer, make, toCanonical };
+  export { Config, Responses, ResponsesRequest, ResponsesService, UserLocation, WebSearchFilters, WebSearchOptions, codeInterpreterTool, fileSearchTool, httpStatusError, layer, make, providerEventsOfResponse, toCanonical, webSearchTool };
 }
 type ResponsesRequest = Omit<CommonRequest, "model"> & {
   /**
@@ -81,6 +82,15 @@ type Config = {
   readonly baseUrl?: string;
   readonly region?: OpenAiRegion;
 };
+declare const httpStatusError: (status: number, body: string) => AiError.AiError;
+/**
+ * Decode an already-executed `/responses` HTTP response into the native
+ * `ProviderEvent` stream: fail on a >=400 status, else SSE-decode the body and
+ * lift terminal `error` / `response.failed` events to a typed `AiError`. Shared
+ * by the streaming turn path (POST) and the deep-research resume stream (GET
+ * `?stream=true`).
+ */
+declare const providerEventsOfResponse: (response: HttpClientResponse.HttpClientResponse) => Stream.Stream<ProviderEvent, AiError.AiError>;
 /**
  * Project a stream of native `ProviderEvent`s into canonical `TurnEvent`s.
  * Threads a fresh `CallIdLookup` per stream so `function_call_arguments.delta`
@@ -100,5 +110,5 @@ declare const make: (cfg: Config) => Effect.Effect<ResponsesService, never, Http
  */
 declare const layer: (cfg: Config) => Layer.Layer<Responses | LanguageModel, never, HttpClient.HttpClient>;
 //#endregion
-export { Config, Responses, ResponsesRequest, ResponsesService, layer, make, Responses_d_exports as t, toCanonical };
+export { Config, Responses, ResponsesRequest, ResponsesService, type UserLocation, type WebSearchFilters, type WebSearchOptions, codeInterpreterTool, fileSearchTool, httpStatusError, layer, make, providerEventsOfResponse, Responses_d_exports as t, toCanonical, webSearchTool };
 //# sourceMappingURL=Responses.d.mts.map

package/dist/Responses.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"Responses.d.mts","names":[],"sources":["../src/Responses.ts"],"mappings":";;;;;;;;;;;;;KA2BY,gBAAA,GAAmB,IAAA,CAAK,aAAA;;;;;WAKzB,KAAA,EAAO,WAAA;EAAA,SACP,SAAA;IAAA,SAAuB,MAAA;EAAA;EAAA,SACvB,KAAA;EAAA,SACA,kBAAA;EAAA,SACA,YAAA;EAAA,SACA,iBAAA;EAAA,SACA,QAAA,GAAW,QAAA,CAAS,MAAA;EAAA,SACpB,IAAA;EAAA,SACA,gBAAA;EAAA,SACA,cAAA;EAAA,SACA,UAAA;EAJoB;;;;;EAAA,SAUpB,cAAA;IAAA,SAA4B,IAAA;EAAA;EAf5B;;;;EAAA,SAoBA,SAAA;AAAA;AAAA,KAGC,gBAAA;EAlBU;;;;;EAAA,SAwBX,YAAA,GACP,OAAA,EAAS,gBAAA,KACN,MAAA,CAAO,MAAA,CAAO,aAAA,EAAe,OAAA,CAAQ,OAAA;EAhBjC;;;;EAAA,SAqBA,UAAA,GAAa,OAAA,EAAS,gBAAA,KAAqB,MAAA,CAAO,MAAA,CAAO,SAAA,EAAW,OAAA,CAAQ,OAAA;EAb3E;;;;;EAAA,SAmBD,IAAA,GAAO,OAAA,EAAS,gBAAA,KAAqB,MAAA,CAAO,MAAA,CAAO,IAAA,EAAM,OAAA,CAAQ,OAAA;EAXrE;;;;;EAAA,SAiBI,WAAA,SACP,CAAA,EAAG,MAAA,CAAO,MAAA,CAAO,aAAA,EAAe,CAAA,EAAG,CAAA,MAChC,MAAA,CAAO,MAAA,CAAO,SAAA,EAAW,CAAA,EAAG,CAAA;AAAA;AAAA,cAClC,cAAA;;;;;;;cAQY,SAAA,SAAkB,cAAA;AAAA,KAInB,MAAA;EAAA,SACD,MAAA,EAAQ,QAAA,CAAS,QAAA;EAAA,SACjB,OAAA;EAAA,SACA,MAAA,GAAS,YAAA;AAAA;;;;;;cA8KP,WAAA,SACX,CAAA,EAAG,MAAA,CAAO,MAAA,CAAO,aAAA,EAAe,CAAA,EAAG,CAAA,MAClC,MAAA,CAAO,MAAA,CAAO,SAAA,EAAW,CAAA,EAAG,CAAA;;;;cAelB,IAAA,GAAQ,GAAA,EAAK,MAAA,KAAS,MAAA,CAAO,MAAA,CAAO,gBAAA,SAAyB,UAAA,CAAW,UAAA;;;;;;;;cAqBxE,KAAA,GACX,GAAA,EAAK,MAAA,KACJ,KAAA,CAAM,KAAA,CAAM,SAAA,GAAY,aAAA,SAAsB,UAAA,CAAW,UAAA"}
+{"version":3,"file":"Responses.d.mts","names":[],"sources":["../src/Responses.ts"],"mappings":";;;;;;;;;;;;;;KAqCY,gBAAA,GAAmB,IAAA,CAAK,aAAA;;;;;WAKzB,KAAA,EAAO,WAAA;EAAA,SACP,SAAA;IAAA,SAAuB,MAAA;EAAA;EAAA,SACvB,KAAA;EAAA,SACA,kBAAA;EAAA,SACA,YAAA;EAAA,SACA,iBAAA;EAAA,SACA,QAAA,GAAW,QAAA,CAAS,MAAA;EAAA,SACpB,IAAA;EAAA,SACA,gBAAA;EAAA,SACA,cAAA;EAAA,SACA,UAAA;;;AAfX;;;WAqBW,cAAA;IAAA,SAA4B,IAAA;EAAA;EAVR;;;;EAAA,SAepB,SAAA;AAAA;AAAA,KAGC,gBAAA;EAxBM;;;;;EAAA,SA8BP,YAAA,GACP,OAAA,EAAS,gBAAA,KACN,MAAA,CAAO,MAAA,CAAO,aAAA,EAAe,OAAA,CAAQ,OAAA;EA3BjC;;;;EAAA,SAgCA,UAAA,GAAa,OAAA,EAAS,gBAAA,KAAqB,MAAA,CAAO,MAAA,CAAO,SAAA,EAAW,OAAA,CAAQ,OAAA;EA7B5E;;;;;EAAA,SAmCA,IAAA,GAAO,OAAA,EAAS,gBAAA,KAAqB,MAAA,CAAO,MAAA,CAAO,IAAA,EAAM,OAAA,CAAQ,OAAA;EAtBxD;;AAGpB;;;EAHoB,SA4BT,WAAA,SACP,CAAA,EAAG,MAAA,CAAO,MAAA,CAAO,aAAA,EAAe,CAAA,EAAG,CAAA,MAChC,MAAA,CAAO,MAAA,CAAO,SAAA,EAAW,CAAA,EAAG,CAAA;AAAA;AAAA,cAClC,cAAA;;;;;;;cAQY,SAAA,SAAkB,cAAA;AAAA,KAInB,MAAA;EAAA,SACD,MAAA,EAAQ,QAAA,CAAS,QAAA;EAAA,SACjB,OAAA;EAAA,SACA,MAAA,GAAS,YAAA;AAAA;AAAA,cAuIP,eAAA,GAAmB,MAAA,UAAgB,IAAA,aAAe,OAAA,CAAQ,OAAA;;;;;;;;cAoB1D,wBAAA,GACX,QAAA,EAAU,kBAAA,CAAmB,kBAAA,KAC5B,MAAA,CAAO,MAAA,CAAO,aAAA,EAAe,OAAA,CAAQ,OAAA;;;;;;cAiE3B,WAAA,SACX,CAAA,EAAG,MAAA,CAAO,MAAA,CAAO,aAAA,EAAe,CAAA,EAAG,CAAA,MAClC,MAAA,CAAO,MAAA,CAAO,SAAA,EAAW,CAAA,EAAG,CAAA;;;;cAelB,IAAA,GAAQ,GAAA,EAAK,MAAA,KAAS,MAAA,CAAO,MAAA,CAAO,gBAAA,SAAyB,UAAA,CAAW,UAAA;;;;;;;;cAqBxE,KAAA,GACX,GAAA,EAAK,MAAA,KACJ,KAAA,CAAM,KAAA,CAAM,SAAA,GAAY,aAAA,SAAsB,UAAA,CAAW,UAAA"}

package/dist/Responses.mjs

@@ -1,19 +1,25 @@
 import { t as __exportAll } from "./chunk-CfYAbeIz.mjs";
-import { resolveHost } from "./region.mjs";
 import { itemsToInput } from "./codec.mjs";
+import { resolveHost } from "./region.mjs";
+import { codeInterpreterTool, fileSearchTool, renderProviderTools, webSearchTool } from "./ResponsesTools.mjs";
 import { KnownProviderEvent, eventToDeltas, makeCallIdLookup } from "./streamEvents.mjs";
-import { Context, Effect, Layer, Match, Option, Schema, Stream } from "effect";
+import { Context, Effect, Layer, Match, 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 { descriptorsOf, providerToolsOf } from "@effect-uai/core/Tool";
 //#region src/Responses.ts
 var Responses_exports = /* @__PURE__ */ __exportAll({
 	Responses: () => Responses,
+	codeInterpreterTool: () => codeInterpreterTool,
+	fileSearchTool: () => fileSearchTool,
+	httpStatusError: () => httpStatusError,
 	layer: () => layer,
 	make: () => make,
-	toCanonical: () => toCanonical
+	providerEventsOfResponse: () => providerEventsOfResponse,
+	toCanonical: () => toCanonical,
+	webSearchTool: () => webSearchTool
 });
 /**
 * Provider-typed service tag. Yield this when you want Responses-specific
@@ -36,20 +42,20 @@ const buildText = (request) => {
 	if (request.verbosity !== void 0) text.verbosity = request.verbosity;
 	return Object.keys(text).length === 0 ? void 0 : text;
 };
-const buildBody = (request) => {
+const buildBody = (request, providerToolWire) => {
 	const text = buildText(request);
-	const tools = descriptorsOf(request.tools);
+	const tools = [...descriptorsOf(request.tools).map((t) => ({
+		type: "function",
+		name: t.name,
+		description: t.description,
+		parameters: t.inputSchema,
+		...t.strict !== void 0 && { strict: t.strict }
+	})), ...providerToolWire];
 	return {
 		model: request.model,
 		input: itemsToInput(request.history),
 		stream: true,
-		...tools.length > 0 && { tools: tools.map((t) => ({
-			type: "function",
-			name: t.name,
-			description: t.description,
-			parameters: t.inputSchema,
-			...t.strict !== void 0 && { strict: t.strict }
-		})) },
+		...tools.length > 0 && { tools },
 		...request.toolChoice !== void 0 && { tool_choice: request.toolChoice },
 		...request.temperature !== void 0 && { temperature: request.temperature },
 		...request.maxOutputTokens !== void 0 && { max_output_tokens: request.maxOutputTokens },
@@ -78,10 +84,22 @@ const makeUnknown = (raw) => ({
 * and produce `Option.none`.
 */
 const eventToError = Match.type().pipe(Match.discriminators("type")({
-	error: (e) => new AiError.Unavailable({
-		provider: "responses",
-		raw: e
-	}),
+	error: (e) => {
+		const detail = e.error;
+		const message = detail?.message ?? e.message;
+		const code = detail?.code ?? e.code;
+		const param = detail?.param;
+		return detail?.type === "invalid_request_error" ? new AiError.InvalidRequest({
+			provider: "responses",
+			...param != null && { param },
+			raw: e
+		}) : new AiError.GenerationFailed({
+			provider: "responses",
+			...code != null && { code },
+			...message != null && { message },
+			raw: e
+		});
+	},
 	"response.failed": (e) => {
 		const code = e.response.error?.code;
 		const message = e.response.error?.message;
@@ -135,26 +153,43 @@ const httpStatusError = (status, body) => {
 		raw
 	});
 };
+/**
+* Decode an already-executed `/responses` HTTP response into the native
+* `ProviderEvent` stream: fail on a >=400 status, else SSE-decode the body and
+* lift terminal `error` / `response.failed` events to a typed `AiError`. Shared
+* by the streaming turn path (POST) and the deep-research resume stream (GET
+* `?stream=true`).
+*/
+const providerEventsOfResponse = (response) => Stream.unwrap(Effect.gen(function* () {
+	if (response.status >= 400) {
+		const body = yield* response.text.pipe(Effect.orElseSucceed(() => ""));
+		return Stream.fail(httpStatusError(response.status, body));
+	}
+	return response.stream.pipe(Stream.mapError((cause) => new AiError.Unavailable({
+		provider: "responses",
+		raw: cause
+	})), SSE.fromBytes, Stream.mapEffect(sseEventToProviderEvent), Stream.flatMap((event) => Option.match(eventToError(event), {
+		onNone: () => Stream.succeed(event),
+		onSome: Stream.fail
+	})));
+}));
 const buildNativeStream = (cfg) => {
 	const url = `${resolveHost(cfg)}/responses`;
 	return (request) => Stream.unwrap(Effect.gen(function* () {
 		const client = yield* HttpClient.HttpClient;
-		const httpRequest = HttpClientRequest.post(url).pipe(HttpClientRequest.bearerToken(cfg.apiKey), HttpClientRequest.bodyJsonUnsafe(buildBody(request)), HttpClientRequest.accept("text/event-stream"));
-		const response = yield* client.execute(httpRequest).pipe(Effect.mapError((cause) => new AiError.Unavailable({
-			provider: "responses",
-			raw: cause
-		})));
-		if (response.status >= 400) {
-			const body = yield* response.text.pipe(Effect.orElseSucceed(() => ""));
-			return Stream.fail(httpStatusError(response.status, body));
-		}
-		return response.stream.pipe(Stream.mapError((cause) => new AiError.Unavailable({
+		const providerToolWire = yield* Result.match(renderProviderTools(providerToolsOf(request.tools)), {
+			onFailure: (e) => Effect.fail(new AiError.Unsupported({
+				provider: "responses",
+				capability: e.capability,
+				reason: e.reason
+			})),
+			onSuccess: (wire) => Effect.succeed(wire)
+		});
+		const httpRequest = HttpClientRequest.post(url).pipe(HttpClientRequest.bearerToken(cfg.apiKey), HttpClientRequest.bodyJsonUnsafe(buildBody(request, providerToolWire)), HttpClientRequest.accept("text/event-stream"));
+		return providerEventsOfResponse(yield* client.execute(httpRequest).pipe(Effect.mapError((cause) => new AiError.Unavailable({
 			provider: "responses",
 			raw: cause
-		})), SSE.fromBytes, Stream.mapEffect(sseEventToProviderEvent), Stream.flatMap((event) => Option.match(eventToError(event), {
-			onNone: () => Stream.succeed(event),
-			onSome: Stream.fail
-		})));
+		}))));
 	}));
 };
 /**
@@ -169,7 +204,7 @@ const toCanonical = (s) => Stream.unwrap(Effect.sync(() => {
 /**
 * Build a `ResponsesService` value. For Layer-based setup, prefer `layer`.
 */
-const make = (cfg) => Effect.map(HttpClient.HttpClient.asEffect(), (client) => {
+const make = (cfg) => Effect.map(HttpClient.HttpClient, (client) => {
 	const streamNative = (request) => buildNativeStream(cfg)(request).pipe(Stream.provideService(HttpClient.HttpClient, client));
 	const streamTurn = (request) => toCanonical(streamNative(request));
 	return {
@@ -195,6 +230,6 @@ const layer = (cfg) => {
 	return Layer.merge(typed, generic);
 };
 //#endregion
-export { Responses, layer, make, Responses_exports as t, toCanonical };
+export { Responses, codeInterpreterTool, fileSearchTool, httpStatusError, layer, make, providerEventsOfResponse, Responses_exports as t, toCanonical, webSearchTool };
 
 //# sourceMappingURL=Responses.mjs.map

package/dist/Responses.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Responses.mjs","names":[],"sources":["../src/Responses.ts"],"sourcesContent":["import { Context, Effect, Layer, Match, Option, Redacted, Schema, Stream } from \"effect\"\nimport { HttpClient, HttpClientRequest } from \"effect/unstable/http\"\nimport * as AiError from \"@effect-uai/core/AiError\"\nimport * as StructuredFormat from \"@effect-uai/core/StructuredFormat\"\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 type { Turn, TurnEvent } from \"@effect-uai/core/Turn\"\nimport { itemsToInput } from \"./codec.js\"\nimport type { OpenAIModel } from \"./models.js\"\nimport { type OpenAiRegion, resolveHost } from \"./region.js\"\nimport {\n  KnownProviderEvent,\n  ProviderEvent,\n  eventToDeltas,\n  makeCallIdLookup,\n} from \"./streamEvents.js\"\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\nexport type ResponsesRequest = Omit<CommonRequest, \"model\"> & {\n  /**\n   * Narrows `CommonRequest.model` (`string`) to the typed `OpenAIModel`\n   * literal union for autocomplete.\n   */\n  readonly model: OpenAIModel\n  readonly reasoning?: { readonly effort: \"low\" | \"medium\" | \"high\" }\n  readonly store?: boolean\n  readonly previousResponseId?: string\n  readonly instructions?: string\n  readonly parallelToolCalls?: boolean\n  readonly metadata?: Readonly<Record<string, string>>\n  readonly user?: string\n  readonly safetyIdentifier?: string\n  readonly promptCacheKey?: string\n  readonly truncation?: \"auto\" | \"disabled\"\n  /**\n   * Free-form JSON output: model emits valid JSON without schema\n   * constraints. Mutually exclusive with `structured` (schema wins if\n   * both are set).\n   */\n  readonly responseFormat?: { readonly type: \"json_object\" }\n  /**\n   * Answer length / level-of-detail hint. GPT-5+ models honour it;\n   * earlier models ignore.\n   */\n  readonly verbosity?: \"low\" | \"medium\" | \"high\"\n}\n\nexport type ResponsesService = {\n  /**\n   * Stream the provider's native event vocabulary (post-SSE-decode).\n   * Use this when you need full vendor fidelity. For provider-portable\n   * code, use `streamTurn` instead.\n   */\n  readonly streamNative: (\n    request: ResponsesRequest,\n  ) => Stream.Stream<ProviderEvent, AiError.AiError>\n  /**\n   * Stream canonical `TurnEvent`s. Implemented as\n   * `streamNative |> toCanonical`.\n   */\n  readonly streamTurn: (request: ResponsesRequest) => Stream.Stream<TurnEvent, AiError.AiError>\n  /**\n   * Drain a single turn and return the assembled `Turn`. Derived from\n   * `streamTurn` — Responses doesn't expose a native non-streaming\n   * complete endpoint we'd want to take advantage of.\n   */\n  readonly turn: (request: ResponsesRequest) => Effect.Effect<Turn, AiError.AiError>\n  /**\n   * Project a stream of native `ProviderEvent`s into canonical `TurnEvent`s.\n   * Exposed for cases where consumers want to compose with `streamNative`\n   * directly (e.g. tap into natives + still get canonical downstream).\n   */\n  readonly toCanonical: <E, R>(\n    s: Stream.Stream<ProviderEvent, E, R>,\n  ) => Stream.Stream<TurnEvent, E, R>\n}\n\n/**\n * Provider-typed service tag. Yield this when you want Responses-specific\n * options (`reasoning.effort`, `store`, `previousResponseId`) at the call\n * site. Yield the generic `LanguageModel` tag for provider-portable code -\n * both are registered by `layer`.\n */\nexport class Responses extends Context.Service<Responses, ResponsesService>()(\n  \"@betalyra/effect-uai/providers/responses/Responses\",\n) {}\n\nexport type Config = {\n  readonly apiKey: Redacted.Redacted\n  readonly baseUrl?: string\n  readonly region?: OpenAiRegion\n}\n\n// ---------------------------------------------------------------------------\n// Request body\n// ---------------------------------------------------------------------------\n\nconst jsonSchemaFormat = (\n  format: StructuredFormat.StructuredFormat<unknown>,\n): Record<string, unknown> => ({\n  type: \"json_schema\",\n  name: format.name,\n  schema: format.schema[\"~standard\"].jsonSchema.input({ target: \"draft-2020-12\" }),\n  ...(format.description !== undefined && { description: format.description }),\n  ...(format.strict !== undefined && { strict: format.strict }),\n})\n\nconst buildText = (request: ResponsesRequest): Record<string, unknown> | undefined => {\n  const format =\n    request.structured !== undefined ? jsonSchemaFormat(request.structured) : request.responseFormat\n  const text: Record<string, unknown> = {}\n  if (format !== undefined) text.format = format\n  if (request.verbosity !== undefined) text.verbosity = request.verbosity\n  return Object.keys(text).length === 0 ? undefined : text\n}\n\nconst buildBody = (request: ResponsesRequest): Record<string, unknown> => {\n  const text = buildText(request)\n  const tools = descriptorsOf(request.tools)\n  return {\n    model: request.model,\n    input: itemsToInput(request.history),\n    stream: true,\n    ...(tools.length > 0 && {\n      tools: tools.map((t) => ({\n        type: \"function\",\n        name: t.name,\n        description: t.description,\n        parameters: t.inputSchema,\n        ...(t.strict !== undefined && { strict: t.strict }),\n      })),\n    }),\n    ...(request.toolChoice !== undefined && { tool_choice: request.toolChoice }),\n    ...(request.temperature !== undefined && { temperature: request.temperature }),\n    ...(request.maxOutputTokens !== undefined && {\n      max_output_tokens: request.maxOutputTokens,\n    }),\n    ...(request.reasoning !== undefined && { reasoning: request.reasoning }),\n    ...(request.store !== undefined && { store: request.store }),\n    ...(request.previousResponseId !== undefined && {\n      previous_response_id: request.previousResponseId,\n    }),\n    ...(request.instructions !== undefined && { instructions: request.instructions }),\n    ...(request.topP !== undefined && { top_p: request.topP }),\n    ...(request.parallelToolCalls !== undefined && {\n      parallel_tool_calls: request.parallelToolCalls,\n    }),\n    ...(request.metadata !== undefined && { metadata: request.metadata }),\n    ...(request.user !== undefined && { user: request.user }),\n    ...(request.safetyIdentifier !== undefined && {\n      safety_identifier: request.safetyIdentifier,\n    }),\n    ...(request.promptCacheKey !== undefined && {\n      prompt_cache_key: request.promptCacheKey,\n    }),\n    ...(request.truncation !== undefined && { truncation: request.truncation }),\n    ...(text !== undefined && { text }),\n  }\n}\n\n// ---------------------------------------------------------------------------\n// SSE event → provider event\n// ---------------------------------------------------------------------------\n\nconst decodeKnown = Schema.decodeUnknownEffect(KnownProviderEvent)\n\nconst makeUnknown = (raw: unknown): ProviderEvent => ({ type: \"_unknown\", raw })\n\n/**\n * Lift events that carry a terminal failure signal (`error`,\n * `response.failed`) to a typed `AiError`. Other events are not failures\n * and produce `Option.none`.\n */\nconst eventToError = Match.type<ProviderEvent>().pipe(\n  Match.discriminators(\"type\")({\n    error: (e): AiError.AiError => new AiError.Unavailable({ provider: \"responses\", raw: e }),\n    \"response.failed\": (e): AiError.AiError => {\n      const code = e.response.error?.code\n      const message = e.response.error?.message\n      return new AiError.GenerationFailed({\n        provider: \"responses\",\n        ...(code !== undefined && code !== null && { code }),\n        ...(message !== undefined && message !== null && { message }),\n        raw: e,\n      })\n    },\n  }),\n  Match.option,\n)\n\nconst parseJsonUnknown = Schema.decodeUnknownEffect(Schema.fromJsonString(Schema.Unknown))\n\nconst sseEventToProviderEvent = (ev: SSE.Event): Effect.Effect<ProviderEvent> =>\n  parseJsonUnknown(ev.data).pipe(\n    Effect.flatMap((parsed) =>\n      decodeKnown(parsed).pipe(Effect.orElseSucceed(() => makeUnknown(parsed))),\n    ),\n    Effect.orElseSucceed(() => makeUnknown(ev.data)),\n  )\n\n// ---------------------------------------------------------------------------\n// Service implementation\n// ---------------------------------------------------------------------------\n\nconst httpStatusError = (status: number, body: string): AiError.AiError => {\n  const provider = \"responses\"\n  const raw = body\n  if (status === 429) return new AiError.RateLimited({ provider, raw })\n  if (status === 408 || status === 504) return new AiError.Timeout({ provider, raw })\n  if (status === 401) return new AiError.AuthFailed({ provider, subtype: \"auth\", raw })\n  if (status === 403) return new AiError.AuthFailed({ provider, subtype: \"permission\", raw })\n  if (status === 402) return new AiError.AuthFailed({ provider, subtype: \"billing\", raw })\n  if (status === 413) return new AiError.ContextLengthExceeded({ provider, raw })\n  if (status >= 500) return new AiError.Unavailable({ provider, status, raw })\n  return new AiError.InvalidRequest({ provider, raw })\n}\n\nconst buildNativeStream = (cfg: Config) => {\n  const url = `${resolveHost(cfg)}/responses`\n  return (\n    request: ResponsesRequest,\n  ): Stream.Stream<ProviderEvent, 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          HttpClientRequest.bearerToken(cfg.apiKey),\n          HttpClientRequest.bodyJsonUnsafe(buildBody(request)),\n          HttpClientRequest.accept(\"text/event-stream\"),\n        )\n        const response = yield* client\n          .execute(httpRequest)\n          .pipe(\n            Effect.mapError(\n              (cause) => new AiError.Unavailable({ provider: \"responses\", raw: cause }),\n            ),\n          )\n        if (response.status >= 400) {\n          const body = yield* response.text.pipe(Effect.orElseSucceed(() => \"\"))\n          return Stream.fail(httpStatusError(response.status, body))\n        }\n\n        return response.stream.pipe(\n          Stream.mapError(\n            (cause) => new AiError.Unavailable({ provider: \"responses\", raw: cause }),\n          ),\n          SSE.fromBytes,\n          Stream.mapEffect(sseEventToProviderEvent),\n          Stream.flatMap((event) =>\n            Option.match(eventToError(event), {\n              onNone: () => Stream.succeed(event),\n              onSome: Stream.fail,\n            }),\n          ),\n        )\n      }),\n    )\n}\n\n/**\n * Project a stream of native `ProviderEvent`s into canonical `TurnEvent`s.\n * Threads a fresh `CallIdLookup` per stream so `function_call_arguments.delta`\n * can be tagged with the right `call_id`.\n */\nexport const toCanonical = <E, R>(\n  s: Stream.Stream<ProviderEvent, E, R>,\n): Stream.Stream<TurnEvent, E, R> =>\n  Stream.unwrap(\n    Effect.sync(() => {\n      const lookup = makeCallIdLookup()\n      return s.pipe(Stream.flatMap((event) => Stream.fromIterable(eventToDeltas(event, lookup))))\n    }),\n  )\n\n// ---------------------------------------------------------------------------\n// Constructors\n// ---------------------------------------------------------------------------\n\n/**\n * Build a `ResponsesService` value. For Layer-based setup, prefer `layer`.\n */\nexport const make = (cfg: Config): Effect.Effect<ResponsesService, never, HttpClient.HttpClient> =>\n  Effect.map(HttpClient.HttpClient.asEffect(), (client) => {\n    const streamNative: ResponsesService[\"streamNative\"] = (request) =>\n      buildNativeStream(cfg)(request).pipe(Stream.provideService(HttpClient.HttpClient, client))\n    const streamTurn: ResponsesService[\"streamTurn\"] = (request) =>\n      toCanonical(streamNative(request))\n    return {\n      streamNative,\n      streamTurn,\n      turn: turnFromStream(streamTurn),\n      toCanonical,\n    }\n  })\n\n/**\n * Layer that registers both the provider-specific `Responses` tag and the\n * generic `LanguageModel` tag, sharing one underlying implementation.\n *\n * The generic tag accepts `CommonRequest`; the typed tag accepts the full\n * `ResponsesRequest` surface.\n */\nexport const layer = (\n  cfg: Config,\n): Layer.Layer<Responses | LanguageModel, never, HttpClient.HttpClient> => {\n  const typed = Layer.effect(Responses, make(cfg))\n  const generic = Layer.effect(\n    LanguageModel,\n    Effect.map(\n      make(cfg),\n      (s): LanguageModelService => ({\n        streamTurn: (request) => s.streamTurn(request as ResponsesRequest),\n        turn: (request) => s.turn(request as ResponsesRequest),\n      }),\n    ),\n  )\n  return Layer.merge(typed, generic)\n}\n"],"mappings":"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"}
+{"version":3,"file":"Responses.mjs","names":[],"sources":["../src/Responses.ts"],"sourcesContent":["import { Context, Effect, Layer, Match, Option, Redacted, Result, Schema, Stream } from \"effect\"\nimport { HttpClient, HttpClientRequest, HttpClientResponse } from \"effect/unstable/http\"\nimport * as AiError from \"@effect-uai/core/AiError\"\nimport * as StructuredFormat from \"@effect-uai/core/StructuredFormat\"\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, providerToolsOf } from \"@effect-uai/core/Tool\"\nimport type { Turn, TurnEvent } from \"@effect-uai/core/Turn\"\nimport { itemsToInput } from \"./codec.js\"\nimport { renderProviderTools } from \"./ResponsesTools.js\"\n\nexport {\n  codeInterpreterTool,\n  fileSearchTool,\n  webSearchTool,\n  type WebSearchOptions,\n  type WebSearchFilters,\n  type UserLocation,\n} from \"./ResponsesTools.js\"\nimport type { OpenAIModel } from \"./models.js\"\nimport { type OpenAiRegion, resolveHost } from \"./region.js\"\nimport {\n  KnownProviderEvent,\n  ProviderEvent,\n  eventToDeltas,\n  makeCallIdLookup,\n} from \"./streamEvents.js\"\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\nexport type ResponsesRequest = Omit<CommonRequest, \"model\"> & {\n  /**\n   * Narrows `CommonRequest.model` (`string`) to the typed `OpenAIModel`\n   * literal union for autocomplete.\n   */\n  readonly model: OpenAIModel\n  readonly reasoning?: { readonly effort: \"low\" | \"medium\" | \"high\" }\n  readonly store?: boolean\n  readonly previousResponseId?: string\n  readonly instructions?: string\n  readonly parallelToolCalls?: boolean\n  readonly metadata?: Readonly<Record<string, string>>\n  readonly user?: string\n  readonly safetyIdentifier?: string\n  readonly promptCacheKey?: string\n  readonly truncation?: \"auto\" | \"disabled\"\n  /**\n   * Free-form JSON output: model emits valid JSON without schema\n   * constraints. Mutually exclusive with `structured` (schema wins if\n   * both are set).\n   */\n  readonly responseFormat?: { readonly type: \"json_object\" }\n  /**\n   * Answer length / level-of-detail hint. GPT-5+ models honour it;\n   * earlier models ignore.\n   */\n  readonly verbosity?: \"low\" | \"medium\" | \"high\"\n}\n\nexport type ResponsesService = {\n  /**\n   * Stream the provider's native event vocabulary (post-SSE-decode).\n   * Use this when you need full vendor fidelity. For provider-portable\n   * code, use `streamTurn` instead.\n   */\n  readonly streamNative: (\n    request: ResponsesRequest,\n  ) => Stream.Stream<ProviderEvent, AiError.AiError>\n  /**\n   * Stream canonical `TurnEvent`s. Implemented as\n   * `streamNative |> toCanonical`.\n   */\n  readonly streamTurn: (request: ResponsesRequest) => Stream.Stream<TurnEvent, AiError.AiError>\n  /**\n   * Drain a single turn and return the assembled `Turn`. Derived from\n   * `streamTurn` — Responses doesn't expose a native non-streaming\n   * complete endpoint we'd want to take advantage of.\n   */\n  readonly turn: (request: ResponsesRequest) => Effect.Effect<Turn, AiError.AiError>\n  /**\n   * Project a stream of native `ProviderEvent`s into canonical `TurnEvent`s.\n   * Exposed for cases where consumers want to compose with `streamNative`\n   * directly (e.g. tap into natives + still get canonical downstream).\n   */\n  readonly toCanonical: <E, R>(\n    s: Stream.Stream<ProviderEvent, E, R>,\n  ) => Stream.Stream<TurnEvent, E, R>\n}\n\n/**\n * Provider-typed service tag. Yield this when you want Responses-specific\n * options (`reasoning.effort`, `store`, `previousResponseId`) at the call\n * site. Yield the generic `LanguageModel` tag for provider-portable code -\n * both are registered by `layer`.\n */\nexport class Responses extends Context.Service<Responses, ResponsesService>()(\n  \"@betalyra/effect-uai/providers/responses/Responses\",\n) {}\n\nexport type Config = {\n  readonly apiKey: Redacted.Redacted\n  readonly baseUrl?: string\n  readonly region?: OpenAiRegion\n}\n\n// ---------------------------------------------------------------------------\n// Request body\n// ---------------------------------------------------------------------------\n\nconst jsonSchemaFormat = (\n  format: StructuredFormat.StructuredFormat<unknown>,\n): Record<string, unknown> => ({\n  type: \"json_schema\",\n  name: format.name,\n  schema: format.schema[\"~standard\"].jsonSchema.input({ target: \"draft-2020-12\" }),\n  ...(format.description !== undefined && { description: format.description }),\n  ...(format.strict !== undefined && { strict: format.strict }),\n})\n\nconst buildText = (request: ResponsesRequest): Record<string, unknown> | undefined => {\n  const format =\n    request.structured !== undefined ? jsonSchemaFormat(request.structured) : request.responseFormat\n  const text: Record<string, unknown> = {}\n  if (format !== undefined) text.format = format\n  if (request.verbosity !== undefined) text.verbosity = request.verbosity\n  return Object.keys(text).length === 0 ? undefined : text\n}\n\nconst buildBody = (\n  request: ResponsesRequest,\n  providerToolWire: ReadonlyArray<Record<string, unknown>>,\n): Record<string, unknown> => {\n  const text = buildText(request)\n  const functionTools = descriptorsOf(request.tools).map((t) => ({\n    type: \"function\",\n    name: t.name,\n    description: t.description,\n    parameters: t.inputSchema,\n    ...(t.strict !== undefined && { strict: t.strict }),\n  }))\n  const tools = [...functionTools, ...providerToolWire]\n  return {\n    model: request.model,\n    input: itemsToInput(request.history),\n    stream: true,\n    ...(tools.length > 0 && { tools }),\n    ...(request.toolChoice !== undefined && { tool_choice: request.toolChoice }),\n    ...(request.temperature !== undefined && { temperature: request.temperature }),\n    ...(request.maxOutputTokens !== undefined && {\n      max_output_tokens: request.maxOutputTokens,\n    }),\n    ...(request.reasoning !== undefined && { reasoning: request.reasoning }),\n    ...(request.store !== undefined && { store: request.store }),\n    ...(request.previousResponseId !== undefined && {\n      previous_response_id: request.previousResponseId,\n    }),\n    ...(request.instructions !== undefined && { instructions: request.instructions }),\n    ...(request.topP !== undefined && { top_p: request.topP }),\n    ...(request.parallelToolCalls !== undefined && {\n      parallel_tool_calls: request.parallelToolCalls,\n    }),\n    ...(request.metadata !== undefined && { metadata: request.metadata }),\n    ...(request.user !== undefined && { user: request.user }),\n    ...(request.safetyIdentifier !== undefined && {\n      safety_identifier: request.safetyIdentifier,\n    }),\n    ...(request.promptCacheKey !== undefined && {\n      prompt_cache_key: request.promptCacheKey,\n    }),\n    ...(request.truncation !== undefined && { truncation: request.truncation }),\n    ...(text !== undefined && { text }),\n  }\n}\n\n// ---------------------------------------------------------------------------\n// SSE event → provider event\n// ---------------------------------------------------------------------------\n\nconst decodeKnown = Schema.decodeUnknownEffect(KnownProviderEvent)\n\nconst makeUnknown = (raw: unknown): ProviderEvent => ({ type: \"_unknown\", raw })\n\n/**\n * Lift events that carry a terminal failure signal (`error`,\n * `response.failed`) to a typed `AiError`. Other events are not failures\n * and produce `Option.none`.\n */\nconst eventToError = Match.type<ProviderEvent>().pipe(\n  Match.discriminators(\"type\")({\n    error: (e): AiError.AiError => {\n      const detail = e.error\n      const message = detail?.message ?? e.message\n      const code = detail?.code ?? e.code\n      const param = detail?.param\n      // A top-level SSE `error` is usually a request rejection (bad model,\n      // missing access, malformed body): non-retryable, so `InvalidRequest`.\n      return detail?.type === \"invalid_request_error\"\n        ? new AiError.InvalidRequest({\n            provider: \"responses\",\n            ...(param != null && { param }),\n            raw: e,\n          })\n        : new AiError.GenerationFailed({\n            provider: \"responses\",\n            ...(code != null && { code }),\n            ...(message != null && { message }),\n            raw: e,\n          })\n    },\n    \"response.failed\": (e): AiError.AiError => {\n      const code = e.response.error?.code\n      const message = e.response.error?.message\n      return new AiError.GenerationFailed({\n        provider: \"responses\",\n        ...(code !== undefined && code !== null && { code }),\n        ...(message !== undefined && message !== null && { message }),\n        raw: e,\n      })\n    },\n  }),\n  Match.option,\n)\n\nconst parseJsonUnknown = Schema.decodeUnknownEffect(Schema.fromJsonString(Schema.Unknown))\n\nconst sseEventToProviderEvent = (ev: SSE.Event): Effect.Effect<ProviderEvent> =>\n  parseJsonUnknown(ev.data).pipe(\n    Effect.flatMap((parsed) =>\n      decodeKnown(parsed).pipe(Effect.orElseSucceed(() => makeUnknown(parsed))),\n    ),\n    Effect.orElseSucceed(() => makeUnknown(ev.data)),\n  )\n\n// ---------------------------------------------------------------------------\n// Service implementation\n// ---------------------------------------------------------------------------\n\nexport const httpStatusError = (status: number, body: string): AiError.AiError => {\n  const provider = \"responses\"\n  const raw = body\n  if (status === 429) return new AiError.RateLimited({ provider, raw })\n  if (status === 408 || status === 504) return new AiError.Timeout({ provider, raw })\n  if (status === 401) return new AiError.AuthFailed({ provider, subtype: \"auth\", raw })\n  if (status === 403) return new AiError.AuthFailed({ provider, subtype: \"permission\", raw })\n  if (status === 402) return new AiError.AuthFailed({ provider, subtype: \"billing\", raw })\n  if (status === 413) return new AiError.ContextLengthExceeded({ provider, raw })\n  if (status >= 500) return new AiError.Unavailable({ provider, status, raw })\n  return new AiError.InvalidRequest({ provider, raw })\n}\n\n/**\n * Decode an already-executed `/responses` HTTP response into the native\n * `ProviderEvent` stream: fail on a >=400 status, else SSE-decode the body and\n * lift terminal `error` / `response.failed` events to a typed `AiError`. Shared\n * by the streaming turn path (POST) and the deep-research resume stream (GET\n * `?stream=true`).\n */\nexport const providerEventsOfResponse = (\n  response: HttpClientResponse.HttpClientResponse,\n): Stream.Stream<ProviderEvent, AiError.AiError> =>\n  Stream.unwrap(\n    Effect.gen(function* () {\n      if (response.status >= 400) {\n        const body = yield* response.text.pipe(Effect.orElseSucceed(() => \"\"))\n        return Stream.fail(httpStatusError(response.status, body))\n      }\n      return response.stream.pipe(\n        Stream.mapError((cause) => new AiError.Unavailable({ provider: \"responses\", raw: cause })),\n        SSE.fromBytes,\n        Stream.mapEffect(sseEventToProviderEvent),\n        Stream.flatMap((event) =>\n          Option.match(eventToError(event), {\n            onNone: () => Stream.succeed(event),\n            onSome: Stream.fail,\n          }),\n        ),\n      )\n    }),\n  )\n\nconst buildNativeStream = (cfg: Config) => {\n  const url = `${resolveHost(cfg)}/responses`\n  return (\n    request: ResponsesRequest,\n  ): Stream.Stream<ProviderEvent, AiError.AiError, HttpClient.HttpClient> =>\n    Stream.unwrap(\n      Effect.gen(function* () {\n        const client = yield* HttpClient.HttpClient\n        const providerToolWire = yield* Result.match(\n          renderProviderTools(providerToolsOf(request.tools)),\n          {\n            onFailure: (e) =>\n              Effect.fail(\n                new AiError.Unsupported({\n                  provider: \"responses\",\n                  capability: e.capability,\n                  reason: e.reason,\n                }),\n              ),\n            onSuccess: (wire) => Effect.succeed(wire),\n          },\n        )\n        const httpRequest = HttpClientRequest.post(url).pipe(\n          HttpClientRequest.bearerToken(cfg.apiKey),\n          HttpClientRequest.bodyJsonUnsafe(buildBody(request, providerToolWire)),\n          HttpClientRequest.accept(\"text/event-stream\"),\n        )\n        const response = yield* client\n          .execute(httpRequest)\n          .pipe(\n            Effect.mapError(\n              (cause) => new AiError.Unavailable({ provider: \"responses\", raw: cause }),\n            ),\n          )\n        return providerEventsOfResponse(response)\n      }),\n    )\n}\n\n/**\n * Project a stream of native `ProviderEvent`s into canonical `TurnEvent`s.\n * Threads a fresh `CallIdLookup` per stream so `function_call_arguments.delta`\n * can be tagged with the right `call_id`.\n */\nexport const toCanonical = <E, R>(\n  s: Stream.Stream<ProviderEvent, E, R>,\n): Stream.Stream<TurnEvent, E, R> =>\n  Stream.unwrap(\n    Effect.sync(() => {\n      const lookup = makeCallIdLookup()\n      return s.pipe(Stream.flatMap((event) => Stream.fromIterable(eventToDeltas(event, lookup))))\n    }),\n  )\n\n// ---------------------------------------------------------------------------\n// Constructors\n// ---------------------------------------------------------------------------\n\n/**\n * Build a `ResponsesService` value. For Layer-based setup, prefer `layer`.\n */\nexport const make = (cfg: Config): Effect.Effect<ResponsesService, never, HttpClient.HttpClient> =>\n  Effect.map(HttpClient.HttpClient, (client) => {\n    const streamNative: ResponsesService[\"streamNative\"] = (request) =>\n      buildNativeStream(cfg)(request).pipe(Stream.provideService(HttpClient.HttpClient, client))\n    const streamTurn: ResponsesService[\"streamTurn\"] = (request) =>\n      toCanonical(streamNative(request))\n    return {\n      streamNative,\n      streamTurn,\n      turn: turnFromStream(streamTurn),\n      toCanonical,\n    }\n  })\n\n/**\n * Layer that registers both the provider-specific `Responses` tag and the\n * generic `LanguageModel` tag, sharing one underlying implementation.\n *\n * The generic tag accepts `CommonRequest`; the typed tag accepts the full\n * `ResponsesRequest` surface.\n */\nexport const layer = (\n  cfg: Config,\n): Layer.Layer<Responses | LanguageModel, never, HttpClient.HttpClient> => {\n  const typed = Layer.effect(Responses, make(cfg))\n  const generic = Layer.effect(\n    LanguageModel,\n    Effect.map(\n      make(cfg),\n      (s): LanguageModelService => ({\n        streamTurn: (request) => s.streamTurn(request as ResponsesRequest),\n        turn: (request) => s.turn(request as ResponsesRequest),\n      }),\n    ),\n  )\n  return Layer.merge(typed, generic)\n}\n"],"mappings":"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"}