@effect-uai/responses 0.10.0 → 0.12.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"> & {
   /**
@@ -29,6 +30,20 @@ type ResponsesRequest = Omit<CommonRequest, "model"> & {
   readonly safetyIdentifier?: string;
   readonly promptCacheKey?: string;
   readonly truncation?: "auto" | "disabled";
+  /**
+   * Vendor-specific body fields merged into the request as-is.
+   *
+   * The Responses dialect is spoken by gateways as well as by OpenAI, and a
+   * gateway carries its own parameters — Requesty's `{ requesty: { auto_cache:
+   * true } }`, for example. Modelling each one would tie this provider to a
+   * catalogue of gateways it cannot see; passing them through keeps the typed
+   * surface OpenAI's and the untyped surface open.
+   *
+   * Merged over the built body, so a field named here wins over the one this
+   * provider would have sent. Per-request keys win over the layer's
+   * {@link Config.extraBody}.
+   */
+  readonly extraBody?: Readonly<Record<string, unknown>>;
   /**
    * Free-form JSON output: model emits valid JSON without schema
    * constraints. Mutually exclusive with `structured` (schema wins if
@@ -80,7 +95,22 @@ type Config = {
   readonly apiKey: Redacted.Redacted;
   readonly baseUrl?: string;
   readonly region?: OpenAiRegion;
+  /**
+   * Vendor-specific body fields sent on every request from this layer — the
+   * place for a gateway's standing configuration, so call sites do not repeat
+   * it. Overridden per request by {@link ResponsesRequest.extraBody}.
+   */
+  readonly extraBody?: Readonly<Record<string, unknown>>;
 };
+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 +130,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;;;;;;;;;;;WA6BW,SAAA,GAAY,QAAA,CAAS,MAAA;EA7BD;;;;;EAAA,SAmCpB,cAAA;IAAA,SAA4B,IAAA;EAAA;EA1B5B;;;;EAAA,SA+BA,SAAA;AAAA;AAAA,KAGC,gBAAA;EA7BD;;;;;EAAA,SAmCA,YAAA,GACP,OAAA,EAAS,gBAAA,KACN,MAAA,CAAO,MAAA,CAAO,aAAA,EAAe,OAAA,CAAQ,OAAA;EAhBL;;;;EAAA,SAqB5B,UAAA,GAAa,OAAA,EAAS,gBAAA,KAAqB,MAAA,CAAO,MAAA,CAAO,SAAA,EAAW,OAAA,CAAQ,OAAA;EAb3D;;;;;EAAA,SAmBjB,IAAA,GAAO,OAAA,EAAS,gBAAA,KAAqB,MAAA,CAAO,MAAA,CAAO,IAAA,EAAM,OAAA,CAAQ,OAAA;EAN3C;;;;;EAAA,SAYtB,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;EApChB;;;;;EAAA,SA0CO,SAAA,GAAY,QAAA,CAAS,MAAA;AAAA;AAAA,cA0InB,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, cfg) => {
 	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 },
@@ -64,7 +70,9 @@ const buildBody = (request) => {
 		...request.safetyIdentifier !== void 0 && { safety_identifier: request.safetyIdentifier },
 		...request.promptCacheKey !== void 0 && { prompt_cache_key: request.promptCacheKey },
 		...request.truncation !== void 0 && { truncation: request.truncation },
-		...text !== void 0 && { text }
+		...text !== void 0 && { text },
+		...cfg.extraBody,
+		...request.extraBody
 	};
 };
 const decodeKnown = Schema.decodeUnknownEffect(KnownProviderEvent);
@@ -78,10 +86,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 +155,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, cfg)), 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 +206,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 +232,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