@effect-uai/responses 0.6.0 → 0.7.0

package/dist/OpenAIEmbedding.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"OpenAIEmbedding.d.mts","names":[],"sources":["../src/OpenAIEmbedding.ts"],"mappings":";;;;;;;;;;;;;;;;;;KA+BY,kBAAA,GAAqB,IAAA,CAAK,kBAAA;+EAE3B,KAAA,EAAO,oBAAA;AAAA;AAAA,KAGN,sBAAA,GAAyB,IAAA,CAAK,kBAAA;EAAA,SAC/B,MAAA,EAAQ,aAAA,CAAc,UAAA;AAAA;AAAA,KAGrB,sBAAA;EAAA,SACD,KAAA,GAAQ,OAAA,EAAS,kBAAA,KAAuB,MAAA,CAAO,MAAA,CAAO,aAAA,EAAe,OAAA,CAAQ,OAAA;EAAA,SAC7E,SAAA,GACP,OAAA,EAAS,sBAAA,KACN,MAAA,CAAO,MAAA,CAAO,iBAAA,EAAmB,OAAA,CAAQ,OAAA;AAAA;AAAA,cAC/C,oBAAA;;;;;;cAOY,eAAA,SAAwB,oBAAA;AAAA,KAIzB,MAAA;EAAA,SACD,MAAA,EAAQ,QAAA,CAAS,QAAA;EAAA,SACjB,OAAA;EAAA,SACA,MAAA,GAAS,YAAA;AAAA;;;;;cA8LP,IAAA,GACX,GAAA,EAAK,MAAA,KACJ,MAAA,CAAO,MAAA,CAAO,sBAAA,SAA+B,UAAA,CAAW,UAAA;;;;;;;cAc9C,KAAA,GACX,GAAA,EAAK,MAAA,KACJ,KAAA,CAAM,KAAA,CAAM,eAAA,GAAkB,cAAA,SAAuB,UAAA,CAAW,UAAA"}
+{"version":3,"file":"OpenAIEmbedding.d.mts","names":[],"sources":["../src/OpenAIEmbedding.ts"],"mappings":";;;;;;;;;;;;;;;;;;KAiCY,kBAAA,GAAqB,IAAA,CAAK,kBAAA;+EAE3B,KAAA,EAAO,oBAAA;AAAA;AAAA,KAGN,sBAAA,GAAyB,IAAA,CAAK,kBAAA;EAAA,SAC/B,MAAA,EAAQ,aAAA,CAAc,UAAA;AAAA;AAAA,KAGrB,sBAAA;EAAA,SACD,KAAA,GAAQ,OAAA,EAAS,kBAAA,KAAuB,MAAA,CAAO,MAAA,CAAO,aAAA,EAAe,OAAA,CAAQ,OAAA;EAAA,SAC7E,SAAA,GACP,OAAA,EAAS,sBAAA,KACN,MAAA,CAAO,MAAA,CAAO,iBAAA,EAAmB,OAAA,CAAQ,OAAA;AAAA;AAAA,cAC/C,oBAAA;;;;;;cAOY,eAAA,SAAwB,oBAAA;AAAA,KAIzB,MAAA;EAAA,SACD,MAAA,EAAQ,QAAA,CAAS,QAAA;EAAA,SACjB,OAAA;EAAA,SACA,MAAA,GAAS,YAAA;AAAA;;;;;cAsMP,IAAA,GACX,GAAA,EAAK,MAAA,KACJ,MAAA,CAAO,MAAA,CAAO,sBAAA,SAA+B,UAAA,CAAW,UAAA;;;;;;;cAc9C,KAAA,GACX,GAAA,EAAK,MAAA,KACJ,KAAA,CAAM,KAAA,CAAM,eAAA,GAAkB,cAAA,SAAuB,UAAA,CAAW,UAAA"}

package/dist/OpenAIEmbedding.mjs

@@ -3,7 +3,8 @@ import { resolveHost } from "./region.mjs";
 import { Context, Effect, Layer, Schema } from "effect";
 import { HttpClient, HttpClientRequest } from "effect/unstable/http";
 import * as AiError from "@effect-uai/core/AiError";
-import { EmbeddingModel } from "@effect-uai/core/EmbeddingModel";
+import * as Capabilities from "@effect-uai/core/Capabilities";
+import { EmbeddingModel, assertEncoding } from "@effect-uai/core/EmbeddingModel";
 //#region src/OpenAIEmbedding.ts
 var OpenAIEmbedding_exports = /* @__PURE__ */ __exportAll({
 	OpenAIEmbedding: () => OpenAIEmbedding,
@@ -16,22 +17,22 @@ var OpenAIEmbedding_exports = /* @__PURE__ */ __exportAll({
 * code. Both are registered by `layer`.
 */
 var OpenAIEmbedding = class extends Context.Service()("@betalyra/effect-uai/providers/responses/OpenAIEmbedding") {};
-const imageRejected = (param) => new AiError.InvalidRequest({
+const imageRejected = new AiError.Unsupported({
 	provider: "openai",
-	param,
-	raw: "OpenAI embeddings are text-only; pass a string or { text }"
+	capability: "imageEmbedding",
+	reason: "OpenAI embeddings are text-only; pass a string or { text }."
 });
-const partToText = (param, part) => "text" in part ? Effect.succeed(part.text) : Effect.fail(imageRejected(param));
+const partToText = (part) => "text" in part ? Effect.succeed(part.text) : Effect.fail(imageRejected);
 /**
 * OpenAI accepts a single string per input. Pure-text `content[]` is
 * concatenated with newlines (treats them as paragraphs of one document);
-* any image part fails with `InvalidRequest`.
+* any image part fails with `Unsupported`.
 */
 const inputToString = (input) => {
 	if (typeof input === "string") return Effect.succeed(input);
 	if ("text" in input) return Effect.succeed(input.text);
-	if ("image" in input) return Effect.fail(imageRejected("input.image"));
-	return Effect.forEach(input.content, (p, i) => partToText(`input.content[${i}].image`, p)).pipe(Effect.map((texts) => texts.join("\n")));
+	if ("image" in input) return Effect.fail(imageRejected);
+	return Effect.forEach(input.content, partToText).pipe(Effect.map((texts) => texts.join("\n")));
 };
 const buildSingleBody = (request) => inputToString(request.input).pipe(Effect.map((input) => ({
 	model: request.model,
@@ -117,6 +118,12 @@ const postEmbed = (cfg, body) => Effect.gen(function* () {
 	return yield* Schema.decodeUnknownEffect(WireResponse)(json).pipe(Effect.mapError(transportFailure));
 });
 const usageOf = (u) => ({ inputTokens: u.prompt_tokens });
+const warnTaskDropped = (task) => Capabilities.warnDroppedWhen(task, {
+	provider: "openai",
+	capability: "task",
+	field: "task",
+	reason: "OpenAI embeddings have no task-type parameter."
+});
 const embedImpl = (cfg) => (request) => buildSingleBody(request).pipe(Effect.flatMap((body) => postEmbed(cfg, body)), Effect.flatMap((decoded) => {
 	const first = decoded.data[0];
 	if (first === void 0) return Effect.fail(transportFailure("OpenAI returned empty `data` array"));
@@ -146,8 +153,8 @@ const make = (cfg) => Effect.map(HttpClient.HttpClient.asEffect(), (client) => (
 const layer = (cfg) => {
 	const typed = Layer.effect(OpenAIEmbedding, make(cfg));
 	const generic = Layer.effect(EmbeddingModel, Effect.map(make(cfg), (s) => ({
-		embed: (req) => s.embed(req),
-		embedMany: (req) => s.embedMany(req)
+		embed: (req) => assertEncoding(req.encoding, ["float32"], "openai").pipe(Effect.andThen(warnTaskDropped(req.task)), Effect.andThen(s.embed(req))),
+		embedMany: (req) => assertEncoding(req.encoding, ["float32"], "openai").pipe(Effect.andThen(warnTaskDropped(req.task)), Effect.andThen(s.embedMany(req)))
 	})));
 	return Layer.merge(typed, generic);
 };

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 type {\n  EmbedContentPart,\n  EmbedInput,\n  Float32Embedding,\n  Usage,\n} from \"@effect-uai/core/Embedding\"\nimport {\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\nconst imageRejected = (param: string): AiError.AiError =>\n  new AiError.InvalidRequest({\n    provider: \"openai\",\n    param,\n    raw: \"OpenAI embeddings are text-only; pass a string or { text }\",\n  })\n\nconst partToText = (\n  param: string,\n  part: EmbedContentPart,\n): Effect.Effect<string, AiError.AiError> =>\n  \"text\" in part ? Effect.succeed(part.text) : Effect.fail(imageRejected(param))\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 `InvalidRequest`.\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(\"input.image\"))\n  return Effect.forEach(input.content, (p, i) => partToText(`input.content[${i}].image`, p)).pipe(\n    Effect.map((texts) => texts.join(\"\\n\")),\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\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 only emits float32; the cast is sound for the 99% case.\n        // A caller asking for a non-float32 encoding via the generic tag\n        // gets the type they requested but the runtime returns float32.\n        embed: <E extends EmbedEncoding | undefined = undefined>(\n          req: Omit<CommonEmbedRequest, \"encoding\"> & { readonly encoding?: E },\n        ) => s.embed(req as OpenAIEmbedRequest) as Effect.Effect<EmbedResponse<E>, AiError.AiError>,\n        embedMany: <E extends EmbedEncoding | undefined = undefined>(\n          req: Omit<CommonEmbedManyRequest, \"encoding\"> & { readonly encoding?: E },\n        ) =>\n          s.embedMany(req as OpenAIEmbedManyRequest) as Effect.Effect<\n            EmbedManyResponse<E>,\n            AiError.AiError\n          >,\n      }),\n    ),\n  )\n  return Layer.merge(typed, generic)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAoDA,IAAa,kBAAb,cAAqC,QAAQ,SAAkD,CAC7F,2DACD,CAAC;AAYF,MAAM,iBAAiB,UACrB,IAAI,QAAQ,eAAe;CACzB,UAAU;CACV;CACA,KAAK;CACN,CAAC;AAEJ,MAAM,cACJ,OACA,SAEA,UAAU,OAAO,OAAO,QAAQ,KAAK,KAAK,GAAG,OAAO,KAAK,cAAc,MAAM,CAAC;;;;;;AAOhF,MAAM,iBAAiB,UAA8D;AACnF,KAAI,OAAO,UAAU,SAAU,QAAO,OAAO,QAAQ,MAAM;AAC3D,KAAI,UAAU,MAAO,QAAO,OAAO,QAAQ,MAAM,KAAK;AACtD,KAAI,WAAW,MAAO,QAAO,OAAO,KAAK,cAAc,cAAc,CAAC;AACtE,QAAO,OAAO,QAAQ,MAAM,UAAU,GAAG,MAAM,WAAW,iBAAiB,EAAE,UAAU,EAAE,CAAC,CAAC,KACzF,OAAO,KAAK,UAAU,MAAM,KAAK,KAAK,CAAC,CACxC;;AAcH,MAAM,mBAAmB,YACvB,cAAc,QAAQ,MAAM,CAAC,KAC3B,OAAO,KAAK,WAAW;CACrB,OAAO,QAAQ;CACf;CACA,GAAI,QAAQ,eAAe,KAAA,KAAa,EAAE,YAAY,QAAQ,YAAY;CAC3E,EAAE,CACJ;AAEH,MAAM,kBACJ,YAEA,OAAO,QAAQ,QAAQ,QAAQ,cAAc,CAAC,KAC5C,OAAO,KAAK,YAAY;CACtB,OAAO,QAAQ;CACf,OAAO;CACP,GAAI,QAAQ,eAAe,KAAA,KAAa,EAAE,YAAY,QAAQ,YAAY;CAC3E,EAAE,CACJ;AAMH,MAAM,oBAAoB,OAAO,OAAO;CACtC,WAAW,OAAO,MAAM,OAAO,OAAO;CACtC,OAAO,OAAO;CACf,CAAC;AAEF,MAAM,YAAY,OAAO,OAAO;CAC9B,eAAe,OAAO;CACtB,cAAc,OAAO;CACtB,CAAC;AAEF,MAAM,eAAe,OAAO,OAAO;CACjC,MAAM,OAAO,MAAM,kBAAkB;CACrC,OAAO,OAAO;CACd,OAAO;CACR,CAAC;AAEF,MAAM,qBAAqB,YAAqD;CAC9E,MAAM;CACN,QAAQ,aAAa,KAAK,OAAO;CAClC;AAID,MAAM,qBACJ,SAEA,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,SAAS,kBAAkB,KAAK,UAAU,CAAC;AAM9F,MAAM,mBAAmB,QAAgB,SAAkC;CACzE,MAAM,WAAW;CACjB,MAAM,MAAM;AACZ,KAAI,WAAW,IAAK,QAAO,IAAI,QAAQ,YAAY;EAAE;EAAU;EAAK,CAAC;AACrE,KAAI,WAAW,OAAO,WAAW,IAAK,QAAO,IAAI,QAAQ,QAAQ;EAAE;EAAU;EAAK,CAAC;AACnF,KAAI,WAAW,IAAK,QAAO,IAAI,QAAQ,WAAW;EAAE;EAAU,SAAS;EAAQ;EAAK,CAAC;AACrF,KAAI,WAAW,IAAK,QAAO,IAAI,QAAQ,WAAW;EAAE;EAAU,SAAS;EAAc;EAAK,CAAC;AAC3F,KAAI,WAAW,IAAK,QAAO,IAAI,QAAQ,WAAW;EAAE;EAAU,SAAS;EAAW;EAAK,CAAC;AACxF,KAAI,WAAW,IAAK,QAAO,IAAI,QAAQ,sBAAsB;EAAE;EAAU;EAAK,CAAC;AAC/E,KAAI,UAAU,IAAK,QAAO,IAAI,QAAQ,YAAY;EAAE;EAAU;EAAQ;EAAK,CAAC;AAC5E,QAAO,IAAI,QAAQ,eAAe;EAAE;EAAU;EAAK,CAAC;;AAGtD,MAAM,oBAAoB,UACxB,IAAI,QAAQ,YAAY;CAAE,UAAU;CAAU,KAAK;CAAO,CAAC;AAM7D,MAAM,aACJ,KACA,SAEA,OAAO,IAAI,aAAa;CACtB,MAAM,SAAS,OAAO,WAAW;CACjC,MAAM,cAAc,kBAAkB,KAAK,GAAG,YAAY,IAAI,CAAC,aAAa,CAAC,KAC3E,kBAAkB,YAAY,IAAI,OAAO,EACzC,kBAAkB,eAAe,KAAK,CACvC;CACD,MAAM,WAAW,OAAO,OAAO,QAAQ,YAAY,CAAC,KAAK,OAAO,SAAS,iBAAiB,CAAC;AAC3F,KAAI,SAAS,UAAU,KAAK;EAC1B,MAAM,OAAO,OAAO,SAAS,KAAK,KAAK,OAAO,oBAAoB,GAAG,CAAC;AACtE,SAAO,OAAO,gBAAgB,SAAS,QAAQ,KAAK;;CAEtD,MAAM,OAAO,OAAO,SAAS,KAAK,KAAK,OAAO,SAAS,iBAAiB,CAAC;AACzE,QAAO,OAAO,OAAO,oBAAoB,aAAa,CAAC,KAAK,CAAC,KAC3D,OAAO,SAAS,iBAAiB,CAClC;EACD;AAMJ,MAAM,WAAW,OAAqC,EAAE,aAAa,EAAE,eAAe;AAEtF,MAAM,aACH,SAEC,YAEA,gBAAgB,QAAQ,CAAC,KACvB,OAAO,SAAS,SAAS,UAAU,KAAK,KAAK,CAAC,EAC9C,OAAO,SAAS,YAAY;CAC1B,MAAM,QAAQ,QAAQ,KAAK;AAC3B,KAAI,UAAU,KAAA,EACZ,QAAO,OAAO,KAAK,iBAAiB,qCAAqC,CAAC;AAE5E,QAAO,OAAO,QAAuB;EACnC,WAAW,kBAAkB,MAAM,UAAU;EAC7C,OAAO,QAAQ,QAAQ,MAAM;EAC9B,CAAC;EACF,CACH;AAEL,MAAM,iBACH,SAEC,YAEA,eAAe,QAAQ,CAAC,KACtB,OAAO,SAAS,SAAS,UAAU,KAAK,KAAK,CAAC,EAC9C,OAAO,KACJ,aAAgC;CAC/B,YAAY,kBAAkB,QAAQ,KAAK;CAC3C,OAAO,QAAQ,QAAQ,MAAM;CAC9B,EACF,CACF;;;;;AAUL,MAAa,QACX,QAEA,OAAO,IAAI,WAAW,WAAW,UAAU,GAAG,YAAY;CACxD,QAAQ,YACN,UAAU,IAAI,CAAC,QAAQ,CAAC,KAAK,OAAO,eAAe,WAAW,YAAY,OAAO,CAAC;CACpF,YAAY,YACV,cAAc,IAAI,CAAC,QAAQ,CAAC,KAAK,OAAO,eAAe,WAAW,YAAY,OAAO,CAAC;CACzF,EAAE;;;;;;;AAQL,MAAa,SACX,QACgF;CAChF,MAAM,QAAQ,MAAM,OAAO,iBAAiB,KAAK,IAAI,CAAC;CACtD,MAAM,UAAU,MAAM,OACpB,gBACA,OAAO,IACL,KAAK,IAAI,GACR,OAA8B;EAI7B,QACE,QACG,EAAE,MAAM,IAA0B;EACvC,YACE,QAEA,EAAE,UAAU,IAA8B;EAI7C,EACF,CACF;AACD,QAAO,MAAM,MAAM,OAAO,QAAQ"}
+{"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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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@effect-uai/responses",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "OpenAI Responses API provider for @effect-uai/core.",
   "keywords": [
     "ai",
@@ -49,7 +49,7 @@
   "devDependencies": {
     "effect": "4.0.0-beta.57",
     "typescript": "^6.0.3",
-    "@effect-uai/core": "0.6.0"
+    "@effect-uai/core": "0.7.0"
   },
   "peerDependencies": {
     "@effect-uai/core": ">=0.2.0 <1",

package/src/OpenAIEmbedding.ts

@@ -1,6 +1,7 @@
 import { Context, Effect, Layer, Redacted, Schema } from "effect"
 import { HttpClient, HttpClientRequest } from "effect/unstable/http"
 import * as AiError from "@effect-uai/core/AiError"
+import * as Capabilities from "@effect-uai/core/Capabilities"
 import type {
   EmbedContentPart,
   EmbedInput,
@@ -8,6 +9,7 @@ import type {
   Usage,
 } from "@effect-uai/core/Embedding"
 import {
+  assertEncoding,
   type CommonEmbedManyRequest,
   type CommonEmbedRequest,
   type EmbedEncoding,
@@ -64,31 +66,29 @@ export type Config = {
 // Codec - input flattening to the single string OpenAI expects
 // ---------------------------------------------------------------------------
 
-const imageRejected = (param: string): AiError.AiError =>
-  new AiError.InvalidRequest({
-    provider: "openai",
-    param,
-    raw: "OpenAI embeddings are text-only; pass a string or { text }",
-  })
+// Image input on a text-only embedder is bucket 1: a silently dropped image
+// yields a vector that represents the wrong thing. Reject with `Unsupported`
+// (capability gap), not `InvalidRequest` (which is for wire-shape mismatches).
+// OpenAI's embeddings API remains text-only as of June 2026.
+const imageRejected: AiError.AiError = new AiError.Unsupported({
+  provider: "openai",
+  capability: "imageEmbedding",
+  reason: "OpenAI embeddings are text-only; pass a string or { text }.",
+})
 
-const partToText = (
-  param: string,
-  part: EmbedContentPart,
-): Effect.Effect<string, AiError.AiError> =>
-  "text" in part ? Effect.succeed(part.text) : Effect.fail(imageRejected(param))
+const partToText = (part: EmbedContentPart): Effect.Effect<string, AiError.AiError> =>
+  "text" in part ? Effect.succeed(part.text) : Effect.fail(imageRejected)
 
 /**
  * OpenAI accepts a single string per input. Pure-text `content[]` is
  * concatenated with newlines (treats them as paragraphs of one document);
- * any image part fails with `InvalidRequest`.
+ * any image part fails with `Unsupported`.
  */
 const inputToString = (input: EmbedInput): Effect.Effect<string, AiError.AiError> => {
   if (typeof input === "string") return Effect.succeed(input)
   if ("text" in input) return Effect.succeed(input.text)
-  if ("image" in input) return Effect.fail(imageRejected("input.image"))
-  return Effect.forEach(input.content, (p, i) => partToText(`input.content[${i}].image`, p)).pipe(
-    Effect.map((texts) => texts.join("\n")),
-  )
+  if ("image" in input) return Effect.fail(imageRejected)
+  return Effect.forEach(input.content, partToText).pipe(Effect.map((texts) => texts.join("\n")))
 }
 
 // ---------------------------------------------------------------------------
@@ -205,6 +205,16 @@ const postEmbed = (
 
 const usageOf = (u: typeof WireUsage.Type): Usage => ({ inputTokens: u.prompt_tokens })
 
+// `task` is dropped on the generic path (OpenAI has no task parameter on any
+// model, so this is a per-Layer gap, not per-model). Bucket 2: warn, don't fail.
+const warnTaskDropped = (task: CommonEmbedRequest["task"]): Effect.Effect<void> =>
+  Capabilities.warnDroppedWhen(task, {
+    provider: "openai",
+    capability: "task",
+    field: "task",
+    reason: "OpenAI embeddings have no task-type parameter.",
+  })
+
 const embedImpl =
   (cfg: Config) =>
   (
@@ -272,19 +282,24 @@ export const layer = (
     Effect.map(
       make(cfg),
       (s): EmbeddingModelService => ({
-        // OpenAI only emits float32; the cast is sound for the 99% case.
-        // A caller asking for a non-float32 encoding via the generic tag
-        // gets the type they requested but the runtime returns float32.
+        // OpenAI emits float32 only and has no task parameter. Reject a
+        // non-float32 `encoding` (bucket 1, else a float32 vector comes back
+        // mislabeled as the requested type) and warn on a dropped `task`
+        // (bucket 2).
         embed: <E extends EmbedEncoding | undefined = undefined>(
           req: Omit<CommonEmbedRequest, "encoding"> & { readonly encoding?: E },
-        ) => s.embed(req as OpenAIEmbedRequest) as Effect.Effect<EmbedResponse<E>, AiError.AiError>,
+        ) =>
+          assertEncoding(req.encoding, ["float32"], "openai").pipe(
+            Effect.andThen(warnTaskDropped(req.task)),
+            Effect.andThen(s.embed(req as OpenAIEmbedRequest)),
+          ) as Effect.Effect<EmbedResponse<E>, AiError.AiError>,
         embedMany: <E extends EmbedEncoding | undefined = undefined>(
           req: Omit<CommonEmbedManyRequest, "encoding"> & { readonly encoding?: E },
         ) =>
-          s.embedMany(req as OpenAIEmbedManyRequest) as Effect.Effect<
-            EmbedManyResponse<E>,
-            AiError.AiError
-          >,
+          assertEncoding(req.encoding, ["float32"], "openai").pipe(
+            Effect.andThen(warnTaskDropped(req.task)),
+            Effect.andThen(s.embedMany(req as OpenAIEmbedManyRequest)),
+          ) as Effect.Effect<EmbedManyResponse<E>, AiError.AiError>,
       }),
     ),
   )