@effect-uai/responses 0.11.0 → 0.12.0

package/dist/Responses.d.mts

@@ -30,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
@@ -81,6 +95,12 @@ 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;
 /**

package/dist/Responses.d.mts.map

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

@@ -42,7 +42,7 @@ const buildText = (request) => {
 	if (request.verbosity !== void 0) text.verbosity = request.verbosity;
 	return Object.keys(text).length === 0 ? void 0 : text;
 };
-const buildBody = (request, providerToolWire) => {
+const buildBody = (request, providerToolWire, cfg) => {
 	const text = buildText(request);
 	const tools = [...descriptorsOf(request.tools).map((t) => ({
 		type: "function",
@@ -70,7 +70,9 @@ const buildBody = (request, providerToolWire) => {
 		...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);
@@ -185,7 +187,7 @@ const buildNativeStream = (cfg) => {
 			})),
 			onSuccess: (wire) => Effect.succeed(wire)
 		});
-		const httpRequest = HttpClientRequest.post(url).pipe(HttpClientRequest.bearerToken(cfg.apiKey), HttpClientRequest.bodyJsonUnsafe(buildBody(request, providerToolWire)), HttpClientRequest.accept("text/event-stream"));
+		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

package/dist/Responses.mjs.map

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

package/dist/codec.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"codec.d.mts","names":[],"sources":["../src/codec.ts"],"mappings":";;;;;;;;cAqCa,cAAA,EAAc,MAAA,CAAA,KAAA,WAAA,MAAA,CAAA,MAAA;EAAA;;;;;;;;;;;;;;;;;;;;cAkEd,cAAA,EAAc,MAAA,CAAA,KAAA,WAAA,MAAA,CAAA,MAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAQf,cAAA,UAAwB,cAAA,CAAe,IAAA;AAAA,cA6BtC,qBAAA,EAAqB,MAAA,CAAA,MAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KActB,qBAAA,UAA+B,qBAAA,CAAsB,IAAA;;cA0EpD,YAAA,GACX,KAAA,EAAO,aAAA,CAAc,WAAA,MACpB,aAAA,CAAc,MAAA;AAAA,cAiBJ,cAAA,GAAkB,IAAA,EAAM,cAAA,KAAiB,aAAA,CAAc,WAAA;AAAA,cAwEvD,iBAAA,GAAqB,OAAA,EAAS,qBAAA,KAAwB,IAAA"}
+{"version":3,"file":"codec.d.mts","names":[],"sources":["../src/codec.ts"],"mappings":";;;;;;;;cAqCa,cAAA,EAAc,MAAA,CAAA,KAAA,WAAA,MAAA,CAAA,MAAA;EAAA;;;;;;;;;;;;;;;;;;;;cAkEd,cAAA,EAAc,MAAA,CAAA,KAAA,WAAA,MAAA,CAAA,MAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAQf,cAAA,UAAwB,cAAA,CAAe,IAAA;AAAA,cA6BtC,qBAAA,EAAqB,MAAA,CAAA,MAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KActB,qBAAA,UAA+B,qBAAA,CAAsB,IAAA;;cA8FpD,YAAA,GACX,KAAA,EAAO,aAAA,CAAc,WAAA,MACpB,aAAA,CAAc,MAAA;AAAA,cAiBJ,cAAA,GAAkB,IAAA,EAAM,cAAA,KAAiB,aAAA,CAAc,WAAA;AAAA,cAwEvD,iBAAA,GAAqB,OAAA,EAAS,qBAAA,KAAwB,IAAA"}

package/dist/codec.mjs

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./chunk-CfYAbeIz.mjs";
-import { Encoding, Match, Option, Schema } from "effect";
+import { Encoding, Match, Option, Result, Schema, pipe } from "effect";
 //#region src/codec.ts
 var codec_exports = /* @__PURE__ */ __exportAll({
 	WireAnnotation: () => WireAnnotation,
@@ -114,11 +114,33 @@ const WireResponseCompleted = Schema.Struct({
 	error: Schema.optional(Schema.NullOr(WireResponseError))
 });
 /**
-* If an item carries `providerData` from a prior OpenAI turn, re-emit it
-* verbatim - preserves `encrypted_content`, item ids, and any field this
-* codec doesn't model.
+* The item shapes we stash for round-tripping. Narrower than
+* `WireOutputItem`: the provider-hosted call variants are dropped from the
+* turn, so they are never stored. Composed from the internal `Wire*` structs,
+* which keeps the wire model out of the package's public surface.
 */
-const passthrough = (item) => item.providerData !== void 0 && typeof item.providerData === "object" && item.providerData !== null ? item.providerData : void 0;
+const StoredItem = Schema.Union([
+	WireMessage,
+	WireFunctionCall,
+	WireReasoning
+]);
+const ProviderDataResponses = Schema.Struct({ responses: StoredItem });
+const decodeResponsesData = Schema.decodeUnknownResult(ProviderDataResponses);
+/**
+* If an item carries `providerData.responses` from a prior turn on this API,
+* re-emit it verbatim - preserves `encrypted_content` and item ids, which a
+* fresh encode from our `HistoryItem` shape cannot reconstruct.
+*
+* Namespaced because `providerData` is a shared slot: an item routed through
+* another provider first (dynamic fallback) carries that provider's key, and
+* re-emitting the whole object would send that provider's data as the wire
+* item and drop the real content. Anything that fails to decode is not ours,
+* so we fall back to encoding the item normally.
+*/
+const passthrough = (item) => pipe(decodeResponsesData(item.providerData), Result.match({
+	onSuccess: (data) => data.responses,
+	onFailure: () => void 0
+}));
 /**
 * OpenAI's `input_image` content block carries a single `image_url` field;
 * inline bytes get encoded as a `data:` URI. Either form (URL or data URI)
@@ -188,21 +210,21 @@ const wireItemToItem = (wire) => Match.value(wire).pipe(Match.discriminatorsExha
 		type: "message",
 		role: m.role,
 		content: m.content.map(wireMessageContentToBlock),
-		providerData: m
+		providerData: { responses: m }
 	}],
 	function_call: (f) => [{
 		type: "function_call",
 		call_id: f.call_id,
 		name: f.name,
 		arguments: f.arguments,
-		providerData: f
+		providerData: { responses: f }
 	}],
 	reasoning: (r) => [{
 		type: "reasoning",
 		...r.id !== void 0 && { id: r.id },
 		...r.summary !== void 0 && { summary: r.summary.map((s) => s.text).join("\n") },
 		...r.encrypted_content !== void 0 && { signature: r.encrypted_content },
-		providerData: r
+		providerData: { responses: r }
 	}],
 	web_search_call: () => [],
 	code_interpreter_call: () => [],

package/dist/codec.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"codec.mjs","names":[],"sources":["../src/codec.ts"],"sourcesContent":["import { Encoding, Match, Option, Schema } from \"effect\"\nimport type { ContentBlock, InputImage, HistoryItem } from \"@effect-uai/core/Items\"\nimport type { Turn } from \"@effect-uai/core/Turn\"\n\n// ---------------------------------------------------------------------------\n// Wire schemas - minimal subset of the Responses API output we consume.\n// Reference: https://www.openresponses.org/specification\n// ---------------------------------------------------------------------------\n\nconst WireUrlCitation = Schema.Struct({\n  type: Schema.Literal(\"url_citation\"),\n  url: Schema.String,\n  start_index: Schema.Number,\n  end_index: Schema.Number,\n  title: Schema.String,\n})\n\nconst WireFileCitation = Schema.Struct({\n  type: Schema.Literal(\"file_citation\"),\n  file_id: Schema.String,\n  index: Schema.Number,\n})\n\nconst WireContainerFileCitation = Schema.Struct({\n  type: Schema.Literal(\"container_file_citation\"),\n  container_id: Schema.String,\n  file_id: Schema.String,\n  start_index: Schema.Number,\n  end_index: Schema.Number,\n})\n\nconst WireFilePath = Schema.Struct({\n  type: Schema.Literal(\"file_path\"),\n  file_id: Schema.String,\n  index: Schema.Number,\n})\n\nexport const WireAnnotation = Schema.Union([\n  WireUrlCitation,\n  WireFileCitation,\n  WireContainerFileCitation,\n  WireFilePath,\n])\n\nconst WireOutputTextContent = Schema.Struct({\n  type: Schema.Literal(\"output_text\"),\n  text: Schema.String,\n  annotations: Schema.optional(Schema.NullOr(Schema.Array(WireAnnotation))),\n})\n\nconst WireRefusalContent = Schema.Struct({\n  type: Schema.Literal(\"refusal\"),\n  refusal: Schema.String,\n})\n\nconst WireMessageContent = Schema.Union([WireOutputTextContent, WireRefusalContent])\n\nconst WireSummaryText = Schema.Struct({\n  type: Schema.Literal(\"summary_text\"),\n  text: Schema.String,\n})\n\nconst WireMessage = Schema.Struct({\n  type: Schema.Literal(\"message\"),\n  id: Schema.optional(Schema.String),\n  role: Schema.Literal(\"assistant\"),\n  content: Schema.Array(WireMessageContent),\n})\n\nconst WireFunctionCall = Schema.Struct({\n  type: Schema.Literal(\"function_call\"),\n  id: Schema.optional(Schema.String),\n  call_id: Schema.String,\n  name: Schema.String,\n  arguments: Schema.String,\n})\n\nconst WireReasoning = Schema.Struct({\n  type: Schema.Literal(\"reasoning\"),\n  id: Schema.optional(Schema.String),\n  summary: Schema.optional(Schema.Array(WireSummaryText)),\n  encrypted_content: Schema.optional(Schema.String),\n})\n\n// Provider-hosted tool call items (web search, code interpreter, file search).\n// The provider executes them, not us — we model them only so a grounded\n// `response.completed` still decodes and assembles a Turn; they are dropped\n// from the turn's items in Phase 1. Surfacing them is a follow-up.\nconst WireWebSearchCall = Schema.Struct({\n  type: Schema.Literal(\"web_search_call\"),\n  id: Schema.optional(Schema.String),\n})\n\nconst WireCodeInterpreterCall = Schema.Struct({\n  type: Schema.Literal(\"code_interpreter_call\"),\n  id: Schema.optional(Schema.String),\n})\n\nconst WireFileSearchCall = Schema.Struct({\n  type: Schema.Literal(\"file_search_call\"),\n  id: Schema.optional(Schema.String),\n})\n\nexport const WireOutputItem = Schema.Union([\n  WireMessage,\n  WireFunctionCall,\n  WireReasoning,\n  WireWebSearchCall,\n  WireCodeInterpreterCall,\n  WireFileSearchCall,\n])\nexport type WireOutputItem = typeof WireOutputItem.Type\n\nconst WireInputTokensDetails = Schema.Struct({\n  cached_tokens: Schema.optional(Schema.NullOr(Schema.Number)),\n})\n\nconst WireOutputTokensDetails = Schema.Struct({\n  reasoning_tokens: Schema.optional(Schema.NullOr(Schema.Number)),\n})\n\nconst WireUsage = Schema.Struct({\n  input_tokens: Schema.optional(Schema.Number),\n  output_tokens: Schema.optional(Schema.Number),\n  total_tokens: Schema.optional(Schema.Number),\n  input_tokens_details: Schema.optional(Schema.NullOr(WireInputTokensDetails)),\n  output_tokens_details: Schema.optional(Schema.NullOr(WireOutputTokensDetails)),\n})\n\nconst WireResponseError = Schema.Struct({\n  code: Schema.optional(Schema.NullOr(Schema.String)),\n  message: Schema.optional(Schema.NullOr(Schema.String)),\n})\n\n// Many Responses-API fields are emitted as explicit `null` rather than\n// missing - `Schema.optional` alone (T | undefined) doesn't cover that, so\n// we lift each through `NullOr` first. Used by `response.completed`,\n// `response.incomplete`, and `response.failed` events; not every field is\n// populated on every event (e.g. `error` only on failed, `incomplete_details`\n// only on incomplete).\nexport const WireResponseCompleted = Schema.Struct({\n  id: Schema.optional(Schema.NullOr(Schema.String)),\n  status: Schema.optional(Schema.NullOr(Schema.String)),\n  output: Schema.optional(Schema.NullOr(Schema.Array(WireOutputItem))),\n  usage: Schema.optional(Schema.NullOr(WireUsage)),\n  incomplete_details: Schema.optional(\n    Schema.NullOr(\n      Schema.Struct({\n        reason: Schema.optional(Schema.NullOr(Schema.String)),\n      }),\n    ),\n  ),\n  error: Schema.optional(Schema.NullOr(WireResponseError)),\n})\nexport type WireResponseCompleted = typeof WireResponseCompleted.Type\n\n// ---------------------------------------------------------------------------\n// History → request body input\n// ---------------------------------------------------------------------------\n\n/**\n * If an item carries `providerData` from a prior OpenAI turn, re-emit it\n * verbatim - preserves `encrypted_content`, item ids, and any field this\n * codec doesn't model.\n */\nconst passthrough = (item: HistoryItem): Record<string, unknown> | undefined =>\n  item.providerData !== undefined &&\n  typeof item.providerData === \"object\" &&\n  item.providerData !== null\n    ? (item.providerData as Record<string, unknown>)\n    : undefined\n\n/**\n * OpenAI's `input_image` content block carries a single `image_url` field;\n * inline bytes get encoded as a `data:` URI. Either form (URL or data URI)\n * is fine - the model just dereferences `image_url`.\n */\nconst imageSourceToUrl = Match.type<InputImage[\"source\"]>().pipe(\n  Match.tag(\"url\", (s) => s.url),\n  Match.tag(\"base64\", (s) => `data:${s.mimeType};base64,${s.base64}`),\n  Match.tag(\"bytes\", (s) => `data:${s.mimeType};base64,${Encoding.encodeBase64(s.bytes)}`),\n  Match.exhaustive,\n)\n\nconst contentBlockToInput = Match.type<ContentBlock>().pipe(\n  Match.discriminatorsExhaustive(\"type\")({\n    input_text: (b) => ({ type: \"input_text\", text: b.text }),\n    input_image: (b) => ({\n      type: \"input_image\",\n      image_url: imageSourceToUrl(b.source),\n    }),\n    output_text: (b) => ({ type: \"output_text\", text: b.text }),\n    refusal: (b) => ({ type: \"refusal\", refusal: b.text }),\n  }),\n)\n\nconst itemToInput = (item: HistoryItem): Record<string, unknown> =>\n  passthrough(item) ??\n  Match.value(item).pipe(\n    Match.discriminatorsExhaustive(\"type\")({\n      message: (m) => ({\n        type: \"message\",\n        role: m.role,\n        content: m.content.map(contentBlockToInput),\n      }),\n      function_call: (f) => ({\n        type: \"function_call\",\n        call_id: f.call_id,\n        name: f.name,\n        arguments: f.arguments,\n      }),\n      function_call_output: (o) => ({\n        type: \"function_call_output\",\n        call_id: o.call_id,\n        output: o.output,\n      }),\n      reasoning: (r) => ({\n        type: \"reasoning\",\n        ...(r.id !== undefined && { id: r.id }),\n        ...(r.summary !== undefined && {\n          summary: [{ type: \"summary_text\", text: r.summary }],\n        }),\n        ...(r.signature !== undefined && { encrypted_content: r.signature }),\n      }),\n    }),\n  )\n\n/** Convert our `HistoryItem[]` history into the Responses API `input` array. */\nexport const itemsToInput = (\n  items: ReadonlyArray<HistoryItem>,\n): ReadonlyArray<Record<string, unknown>> => items.map(itemToInput)\n\n// ---------------------------------------------------------------------------\n// Wire output items → our Items\n// ---------------------------------------------------------------------------\n\nconst wireMessageContentToBlock = Match.type<typeof WireMessageContent.Type>().pipe(\n  Match.discriminatorsExhaustive(\"type\")({\n    output_text: (c): ContentBlock => ({\n      type: \"output_text\",\n      text: c.text,\n      ...(c.annotations !== undefined && c.annotations !== null && { annotations: c.annotations }),\n    }),\n    refusal: (c): ContentBlock => ({ type: \"refusal\", text: c.refusal }),\n  }),\n)\n\nexport const wireItemToItem = (wire: WireOutputItem): ReadonlyArray<HistoryItem> =>\n  Match.value(wire).pipe(\n    Match.discriminatorsExhaustive(\"type\")({\n      message: (m): ReadonlyArray<HistoryItem> => [\n        {\n          type: \"message\" as const,\n          role: m.role,\n          content: m.content.map(wireMessageContentToBlock),\n          providerData: m,\n        },\n      ],\n      function_call: (f): ReadonlyArray<HistoryItem> => [\n        {\n          type: \"function_call\" as const,\n          call_id: f.call_id,\n          name: f.name,\n          arguments: f.arguments,\n          providerData: f,\n        },\n      ],\n      reasoning: (r): ReadonlyArray<HistoryItem> => [\n        {\n          type: \"reasoning\" as const,\n          ...(r.id !== undefined && { id: r.id }),\n          ...(r.summary !== undefined && {\n            summary: r.summary.map((s) => s.text).join(\"\\n\"),\n          }),\n          ...(r.encrypted_content !== undefined && { signature: r.encrypted_content }),\n          providerData: r,\n        },\n      ],\n      // Hosted-tool calls are provider-executed; drop from the turn (Phase 1).\n      web_search_call: (): ReadonlyArray<HistoryItem> => [],\n      code_interpreter_call: (): ReadonlyArray<HistoryItem> => [],\n      file_search_call: (): ReadonlyArray<HistoryItem> => [],\n    }),\n  )\n\n// ---------------------------------------------------------------------------\n// response.completed → Turn\n// ---------------------------------------------------------------------------\n\nconst reasonToStop = Match.type<string>().pipe(\n  Match.when(\"max_output_tokens\", () => \"max_tokens\" as const),\n  Match.when(\"refusal\", () => \"refusal\" as const),\n  Match.when(\"content_filter\", () => \"content_filter\" as const),\n  Match.when(\"max_tool_calls\", () => \"max_tool_calls\" as const),\n  Match.option,\n)\n\nconst hasRefusalContent = (payload: WireResponseCompleted): boolean =>\n  (payload.output ?? []).some(\n    (i) => i.type === \"message\" && i.content.some((c) => c.type === \"refusal\"),\n  )\n\nconst stopReasonFromCompleted = (payload: WireResponseCompleted): Turn[\"stop_reason\"] =>\n  Option.match(reasonToStop(payload.incomplete_details?.reason ?? \"\"), {\n    onSome: (s) => s,\n    onNone: () =>\n      hasRefusalContent(payload)\n        ? (\"refusal\" as const)\n        : (payload.output ?? []).some((i) => i.type === \"function_call\")\n          ? (\"tool_calls\" as const)\n          : (\"stop\" as const),\n  })\n\nconst cachedTokens = (payload: WireResponseCompleted): number | undefined =>\n  payload.usage?.input_tokens_details?.cached_tokens ?? undefined\n\nconst reasoningTokens = (payload: WireResponseCompleted): number | undefined =>\n  payload.usage?.output_tokens_details?.reasoning_tokens ?? undefined\n\nexport const turnFromCompleted = (payload: WireResponseCompleted): Turn => {\n  const cached = cachedTokens(payload)\n  const reasoning = reasoningTokens(payload)\n  return {\n    items: (payload.output ?? []).flatMap(wireItemToItem),\n    usage: {\n      ...(payload.usage?.input_tokens !== undefined && {\n        input_tokens: payload.usage.input_tokens,\n      }),\n      ...(payload.usage?.output_tokens !== undefined && {\n        output_tokens: payload.usage.output_tokens,\n      }),\n      ...(payload.usage?.total_tokens !== undefined && {\n        total_tokens: payload.usage.total_tokens,\n      }),\n      ...(cached !== undefined && {\n        input_tokens_details: { cached_tokens: cached },\n      }),\n      ...(reasoning !== undefined && {\n        output_tokens_details: { reasoning_tokens: reasoning },\n      }),\n    },\n    stop_reason: stopReasonFromCompleted(payload),\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"codec.mjs","names":[],"sources":["../src/codec.ts"],"sourcesContent":["import { Encoding, Match, Option, Result, Schema, pipe } from \"effect\"\nimport type { ContentBlock, InputImage, HistoryItem } from \"@effect-uai/core/Items\"\nimport type { Turn } from \"@effect-uai/core/Turn\"\n\n// ---------------------------------------------------------------------------\n// Wire schemas - minimal subset of the Responses API output we consume.\n// Reference: https://www.openresponses.org/specification\n// ---------------------------------------------------------------------------\n\nconst WireUrlCitation = Schema.Struct({\n  type: Schema.Literal(\"url_citation\"),\n  url: Schema.String,\n  start_index: Schema.Number,\n  end_index: Schema.Number,\n  title: Schema.String,\n})\n\nconst WireFileCitation = Schema.Struct({\n  type: Schema.Literal(\"file_citation\"),\n  file_id: Schema.String,\n  index: Schema.Number,\n})\n\nconst WireContainerFileCitation = Schema.Struct({\n  type: Schema.Literal(\"container_file_citation\"),\n  container_id: Schema.String,\n  file_id: Schema.String,\n  start_index: Schema.Number,\n  end_index: Schema.Number,\n})\n\nconst WireFilePath = Schema.Struct({\n  type: Schema.Literal(\"file_path\"),\n  file_id: Schema.String,\n  index: Schema.Number,\n})\n\nexport const WireAnnotation = Schema.Union([\n  WireUrlCitation,\n  WireFileCitation,\n  WireContainerFileCitation,\n  WireFilePath,\n])\n\nconst WireOutputTextContent = Schema.Struct({\n  type: Schema.Literal(\"output_text\"),\n  text: Schema.String,\n  annotations: Schema.optional(Schema.NullOr(Schema.Array(WireAnnotation))),\n})\n\nconst WireRefusalContent = Schema.Struct({\n  type: Schema.Literal(\"refusal\"),\n  refusal: Schema.String,\n})\n\nconst WireMessageContent = Schema.Union([WireOutputTextContent, WireRefusalContent])\n\nconst WireSummaryText = Schema.Struct({\n  type: Schema.Literal(\"summary_text\"),\n  text: Schema.String,\n})\n\nconst WireMessage = Schema.Struct({\n  type: Schema.Literal(\"message\"),\n  id: Schema.optional(Schema.String),\n  role: Schema.Literal(\"assistant\"),\n  content: Schema.Array(WireMessageContent),\n})\n\nconst WireFunctionCall = Schema.Struct({\n  type: Schema.Literal(\"function_call\"),\n  id: Schema.optional(Schema.String),\n  call_id: Schema.String,\n  name: Schema.String,\n  arguments: Schema.String,\n})\n\nconst WireReasoning = Schema.Struct({\n  type: Schema.Literal(\"reasoning\"),\n  id: Schema.optional(Schema.String),\n  summary: Schema.optional(Schema.Array(WireSummaryText)),\n  encrypted_content: Schema.optional(Schema.String),\n})\n\n// Provider-hosted tool call items (web search, code interpreter, file search).\n// The provider executes them, not us — we model them only so a grounded\n// `response.completed` still decodes and assembles a Turn; they are dropped\n// from the turn's items in Phase 1. Surfacing them is a follow-up.\nconst WireWebSearchCall = Schema.Struct({\n  type: Schema.Literal(\"web_search_call\"),\n  id: Schema.optional(Schema.String),\n})\n\nconst WireCodeInterpreterCall = Schema.Struct({\n  type: Schema.Literal(\"code_interpreter_call\"),\n  id: Schema.optional(Schema.String),\n})\n\nconst WireFileSearchCall = Schema.Struct({\n  type: Schema.Literal(\"file_search_call\"),\n  id: Schema.optional(Schema.String),\n})\n\nexport const WireOutputItem = Schema.Union([\n  WireMessage,\n  WireFunctionCall,\n  WireReasoning,\n  WireWebSearchCall,\n  WireCodeInterpreterCall,\n  WireFileSearchCall,\n])\nexport type WireOutputItem = typeof WireOutputItem.Type\n\nconst WireInputTokensDetails = Schema.Struct({\n  cached_tokens: Schema.optional(Schema.NullOr(Schema.Number)),\n})\n\nconst WireOutputTokensDetails = Schema.Struct({\n  reasoning_tokens: Schema.optional(Schema.NullOr(Schema.Number)),\n})\n\nconst WireUsage = Schema.Struct({\n  input_tokens: Schema.optional(Schema.Number),\n  output_tokens: Schema.optional(Schema.Number),\n  total_tokens: Schema.optional(Schema.Number),\n  input_tokens_details: Schema.optional(Schema.NullOr(WireInputTokensDetails)),\n  output_tokens_details: Schema.optional(Schema.NullOr(WireOutputTokensDetails)),\n})\n\nconst WireResponseError = Schema.Struct({\n  code: Schema.optional(Schema.NullOr(Schema.String)),\n  message: Schema.optional(Schema.NullOr(Schema.String)),\n})\n\n// Many Responses-API fields are emitted as explicit `null` rather than\n// missing - `Schema.optional` alone (T | undefined) doesn't cover that, so\n// we lift each through `NullOr` first. Used by `response.completed`,\n// `response.incomplete`, and `response.failed` events; not every field is\n// populated on every event (e.g. `error` only on failed, `incomplete_details`\n// only on incomplete).\nexport const WireResponseCompleted = Schema.Struct({\n  id: Schema.optional(Schema.NullOr(Schema.String)),\n  status: Schema.optional(Schema.NullOr(Schema.String)),\n  output: Schema.optional(Schema.NullOr(Schema.Array(WireOutputItem))),\n  usage: Schema.optional(Schema.NullOr(WireUsage)),\n  incomplete_details: Schema.optional(\n    Schema.NullOr(\n      Schema.Struct({\n        reason: Schema.optional(Schema.NullOr(Schema.String)),\n      }),\n    ),\n  ),\n  error: Schema.optional(Schema.NullOr(WireResponseError)),\n})\nexport type WireResponseCompleted = typeof WireResponseCompleted.Type\n\n// ---------------------------------------------------------------------------\n// History → request body input\n// ---------------------------------------------------------------------------\n\n/**\n * The item shapes we stash for round-tripping. Narrower than\n * `WireOutputItem`: the provider-hosted call variants are dropped from the\n * turn, so they are never stored. Composed from the internal `Wire*` structs,\n * which keeps the wire model out of the package's public surface.\n */\nconst StoredItem = Schema.Union([WireMessage, WireFunctionCall, WireReasoning])\ntype StoredItem = typeof StoredItem.Type\n\nconst ProviderDataResponses = Schema.Struct({ responses: StoredItem })\nconst decodeResponsesData = Schema.decodeUnknownResult(ProviderDataResponses)\n\n/**\n * If an item carries `providerData.responses` from a prior turn on this API,\n * re-emit it verbatim - preserves `encrypted_content` and item ids, which a\n * fresh encode from our `HistoryItem` shape cannot reconstruct.\n *\n * Namespaced because `providerData` is a shared slot: an item routed through\n * another provider first (dynamic fallback) carries that provider's key, and\n * re-emitting the whole object would send that provider's data as the wire\n * item and drop the real content. Anything that fails to decode is not ours,\n * so we fall back to encoding the item normally.\n */\nconst passthrough = (item: HistoryItem): StoredItem | undefined =>\n  pipe(\n    decodeResponsesData(item.providerData),\n    Result.match({\n      onSuccess: (data) => data.responses,\n      onFailure: (): StoredItem | undefined => undefined,\n    }),\n  )\n\n/**\n * OpenAI's `input_image` content block carries a single `image_url` field;\n * inline bytes get encoded as a `data:` URI. Either form (URL or data URI)\n * is fine - the model just dereferences `image_url`.\n */\nconst imageSourceToUrl = Match.type<InputImage[\"source\"]>().pipe(\n  Match.tag(\"url\", (s) => s.url),\n  Match.tag(\"base64\", (s) => `data:${s.mimeType};base64,${s.base64}`),\n  Match.tag(\"bytes\", (s) => `data:${s.mimeType};base64,${Encoding.encodeBase64(s.bytes)}`),\n  Match.exhaustive,\n)\n\nconst contentBlockToInput = Match.type<ContentBlock>().pipe(\n  Match.discriminatorsExhaustive(\"type\")({\n    input_text: (b) => ({ type: \"input_text\", text: b.text }),\n    input_image: (b) => ({\n      type: \"input_image\",\n      image_url: imageSourceToUrl(b.source),\n    }),\n    output_text: (b) => ({ type: \"output_text\", text: b.text }),\n    refusal: (b) => ({ type: \"refusal\", refusal: b.text }),\n  }),\n)\n\nconst itemToInput = (item: HistoryItem): Record<string, unknown> =>\n  passthrough(item) ??\n  Match.value(item).pipe(\n    Match.discriminatorsExhaustive(\"type\")({\n      message: (m) => ({\n        type: \"message\",\n        role: m.role,\n        content: m.content.map(contentBlockToInput),\n      }),\n      function_call: (f) => ({\n        type: \"function_call\",\n        call_id: f.call_id,\n        name: f.name,\n        arguments: f.arguments,\n      }),\n      function_call_output: (o) => ({\n        type: \"function_call_output\",\n        call_id: o.call_id,\n        output: o.output,\n      }),\n      reasoning: (r) => ({\n        type: \"reasoning\",\n        ...(r.id !== undefined && { id: r.id }),\n        ...(r.summary !== undefined && {\n          summary: [{ type: \"summary_text\", text: r.summary }],\n        }),\n        ...(r.signature !== undefined && { encrypted_content: r.signature }),\n      }),\n    }),\n  )\n\n/** Convert our `HistoryItem[]` history into the Responses API `input` array. */\nexport const itemsToInput = (\n  items: ReadonlyArray<HistoryItem>,\n): ReadonlyArray<Record<string, unknown>> => items.map(itemToInput)\n\n// ---------------------------------------------------------------------------\n// Wire output items → our Items\n// ---------------------------------------------------------------------------\n\nconst wireMessageContentToBlock = Match.type<typeof WireMessageContent.Type>().pipe(\n  Match.discriminatorsExhaustive(\"type\")({\n    output_text: (c): ContentBlock => ({\n      type: \"output_text\",\n      text: c.text,\n      ...(c.annotations !== undefined && c.annotations !== null && { annotations: c.annotations }),\n    }),\n    refusal: (c): ContentBlock => ({ type: \"refusal\", text: c.refusal }),\n  }),\n)\n\nexport const wireItemToItem = (wire: WireOutputItem): ReadonlyArray<HistoryItem> =>\n  Match.value(wire).pipe(\n    Match.discriminatorsExhaustive(\"type\")({\n      message: (m): ReadonlyArray<HistoryItem> => [\n        {\n          type: \"message\" as const,\n          role: m.role,\n          content: m.content.map(wireMessageContentToBlock),\n          providerData: { responses: m },\n        },\n      ],\n      function_call: (f): ReadonlyArray<HistoryItem> => [\n        {\n          type: \"function_call\" as const,\n          call_id: f.call_id,\n          name: f.name,\n          arguments: f.arguments,\n          providerData: { responses: f },\n        },\n      ],\n      reasoning: (r): ReadonlyArray<HistoryItem> => [\n        {\n          type: \"reasoning\" as const,\n          ...(r.id !== undefined && { id: r.id }),\n          ...(r.summary !== undefined && {\n            summary: r.summary.map((s) => s.text).join(\"\\n\"),\n          }),\n          ...(r.encrypted_content !== undefined && { signature: r.encrypted_content }),\n          providerData: { responses: r },\n        },\n      ],\n      // Hosted-tool calls are provider-executed; drop from the turn (Phase 1).\n      web_search_call: (): ReadonlyArray<HistoryItem> => [],\n      code_interpreter_call: (): ReadonlyArray<HistoryItem> => [],\n      file_search_call: (): ReadonlyArray<HistoryItem> => [],\n    }),\n  )\n\n// ---------------------------------------------------------------------------\n// response.completed → Turn\n// ---------------------------------------------------------------------------\n\nconst reasonToStop = Match.type<string>().pipe(\n  Match.when(\"max_output_tokens\", () => \"max_tokens\" as const),\n  Match.when(\"refusal\", () => \"refusal\" as const),\n  Match.when(\"content_filter\", () => \"content_filter\" as const),\n  Match.when(\"max_tool_calls\", () => \"max_tool_calls\" as const),\n  Match.option,\n)\n\nconst hasRefusalContent = (payload: WireResponseCompleted): boolean =>\n  (payload.output ?? []).some(\n    (i) => i.type === \"message\" && i.content.some((c) => c.type === \"refusal\"),\n  )\n\nconst stopReasonFromCompleted = (payload: WireResponseCompleted): Turn[\"stop_reason\"] =>\n  Option.match(reasonToStop(payload.incomplete_details?.reason ?? \"\"), {\n    onSome: (s) => s,\n    onNone: () =>\n      hasRefusalContent(payload)\n        ? (\"refusal\" as const)\n        : (payload.output ?? []).some((i) => i.type === \"function_call\")\n          ? (\"tool_calls\" as const)\n          : (\"stop\" as const),\n  })\n\nconst cachedTokens = (payload: WireResponseCompleted): number | undefined =>\n  payload.usage?.input_tokens_details?.cached_tokens ?? undefined\n\nconst reasoningTokens = (payload: WireResponseCompleted): number | undefined =>\n  payload.usage?.output_tokens_details?.reasoning_tokens ?? undefined\n\nexport const turnFromCompleted = (payload: WireResponseCompleted): Turn => {\n  const cached = cachedTokens(payload)\n  const reasoning = reasoningTokens(payload)\n  return {\n    items: (payload.output ?? []).flatMap(wireItemToItem),\n    usage: {\n      ...(payload.usage?.input_tokens !== undefined && {\n        input_tokens: payload.usage.input_tokens,\n      }),\n      ...(payload.usage?.output_tokens !== undefined && {\n        output_tokens: payload.usage.output_tokens,\n      }),\n      ...(payload.usage?.total_tokens !== undefined && {\n        total_tokens: payload.usage.total_tokens,\n      }),\n      ...(cached !== undefined && {\n        input_tokens_details: { cached_tokens: cached },\n      }),\n      ...(reasoning !== undefined && {\n        output_tokens_details: { reasoning_tokens: reasoning },\n      }),\n    },\n    stop_reason: stopReasonFromCompleted(payload),\n  }\n}\n"],"mappings":"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"}

package/dist/codec.test.d.mts

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

package/dist/codec.test.mjs

@@ -0,0 +1,93 @@
+import { itemsToInput, wireItemToItem } from "./codec.mjs";
+import { n as describe, r as it, t as globalExpect } from "./test.DNmyFkvJ-CPKukVWS.mjs";
+//#region src/codec.test.ts
+describe("providerData round-trip", () => {
+	it("re-emits a stashed item verbatim, preserving fields our shape drops", () => {
+		globalExpect(itemsToInput(wireItemToItem({
+			type: "reasoning",
+			id: "rs_1",
+			encrypted_content: "opaque-state"
+		}))).toEqual([{
+			type: "reasoning",
+			id: "rs_1",
+			encrypted_content: "opaque-state"
+		}]);
+	});
+});
+describe("providerData is a shared slot", () => {
+	it("ignores another provider's data and encodes the item normally", () => {
+		globalExpect(itemsToInput([{
+			type: "message",
+			role: "user",
+			content: [{
+				type: "input_text",
+				text: "hello world"
+			}],
+			providerData: { gemini: { thoughtSignature: "sig-abc" } }
+		}])).toEqual([{
+			type: "message",
+			role: "user",
+			content: [{
+				type: "input_text",
+				text: "hello world"
+			}]
+		}]);
+	});
+	it("does not send a foreign function_call as junk", () => {
+		globalExpect(itemsToInput([{
+			type: "function_call",
+			call_id: "c1",
+			name: "get_weather",
+			arguments: "{\"city\":\"Lisbon\"}",
+			providerData: { gemini: {
+				id: "g1",
+				thoughtSignature: "sig-abc"
+			} }
+		}])).toEqual([{
+			type: "function_call",
+			call_id: "c1",
+			name: "get_weather",
+			arguments: "{\"city\":\"Lisbon\"}"
+		}]);
+	});
+	it("re-emits only our key when an item carries several providers' data", () => {
+		globalExpect(itemsToInput([{
+			type: "reasoning",
+			signature: "opaque-state",
+			providerData: {
+				responses: {
+					type: "reasoning",
+					id: "rs_1",
+					encrypted_content: "opaque-state"
+				},
+				gemini: { thoughtSignature: "sig-abc" }
+			}
+		}])).toEqual([{
+			type: "reasoning",
+			id: "rs_1",
+			encrypted_content: "opaque-state"
+		}]);
+	});
+	it("falls back to a normal encode when the stashed value is not one of ours", () => {
+		globalExpect(itemsToInput([{
+			type: "message",
+			role: "user",
+			content: [{
+				type: "input_text",
+				text: "hi"
+			}],
+			providerData: { responses: { type: "not_an_item_we_model" } }
+		}])).toEqual([{
+			type: "message",
+			role: "user",
+			content: [{
+				type: "input_text",
+				text: "hi"
+			}]
+		}]);
+	});
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=codec.test.mjs.map

package/dist/codec.test.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.test.mjs","names":[],"sources":["../src/codec.test.ts"],"sourcesContent":["import type { HistoryItem } from \"@effect-uai/core/Items\"\nimport { describe, expect, it } from \"vitest\"\nimport { itemsToInput, wireItemToItem } from \"./codec.js\"\n\ndescribe(\"providerData round-trip\", () => {\n  it(\"re-emits a stashed item verbatim, preserving fields our shape drops\", () => {\n    // `id` and `encrypted_content` cannot be reconstructed from a Reasoning\n    // item, so the round-trip has to go through the stash.\n    const items = wireItemToItem({\n      type: \"reasoning\",\n      id: \"rs_1\",\n      encrypted_content: \"opaque-state\",\n    })\n    expect(itemsToInput(items)).toEqual([\n      { type: \"reasoning\", id: \"rs_1\", encrypted_content: \"opaque-state\" },\n    ])\n  })\n})\n\ndescribe(\"providerData is a shared slot\", () => {\n  // Regression: the passthrough used to re-emit the whole `providerData`\n  // object as the wire item. An item that had been through another provider\n  // first was sent as that provider's data, losing the real content.\n  it(\"ignores another provider's data and encodes the item normally\", () => {\n    const history: ReadonlyArray<HistoryItem> = [\n      {\n        type: \"message\",\n        role: \"user\",\n        content: [{ type: \"input_text\", text: \"hello world\" }],\n        providerData: { gemini: { thoughtSignature: \"sig-abc\" } },\n      },\n    ]\n    expect(itemsToInput(history)).toEqual([\n      { type: \"message\", role: \"user\", content: [{ type: \"input_text\", text: \"hello world\" }] },\n    ])\n  })\n\n  it(\"does not send a foreign function_call as junk\", () => {\n    const history: ReadonlyArray<HistoryItem> = [\n      {\n        type: \"function_call\",\n        call_id: \"c1\",\n        name: \"get_weather\",\n        arguments: '{\"city\":\"Lisbon\"}',\n        providerData: { gemini: { id: \"g1\", thoughtSignature: \"sig-abc\" } },\n      },\n    ]\n    expect(itemsToInput(history)).toEqual([\n      {\n        type: \"function_call\",\n        call_id: \"c1\",\n        name: \"get_weather\",\n        arguments: '{\"city\":\"Lisbon\"}',\n      },\n    ])\n  })\n\n  it(\"re-emits only our key when an item carries several providers' data\", () => {\n    const history: ReadonlyArray<HistoryItem> = [\n      {\n        type: \"reasoning\",\n        signature: \"opaque-state\",\n        providerData: {\n          responses: { type: \"reasoning\", id: \"rs_1\", encrypted_content: \"opaque-state\" },\n          gemini: { thoughtSignature: \"sig-abc\" },\n        },\n      },\n    ]\n    expect(itemsToInput(history)).toEqual([\n      { type: \"reasoning\", id: \"rs_1\", encrypted_content: \"opaque-state\" },\n    ])\n  })\n\n  it(\"falls back to a normal encode when the stashed value is not one of ours\", () => {\n    const history: ReadonlyArray<HistoryItem> = [\n      {\n        type: \"message\",\n        role: \"user\",\n        content: [{ type: \"input_text\", text: \"hi\" }],\n        providerData: { responses: { type: \"not_an_item_we_model\" } },\n      },\n    ]\n    expect(itemsToInput(history)).toEqual([\n      { type: \"message\", role: \"user\", content: [{ type: \"input_text\", text: \"hi\" }] },\n    ])\n  })\n})\n"],"mappings":";;;AAIA,SAAS,iCAAiC;AACxC,IAAG,6EAA6E;AAQ9E,eAAO,aALO,eAAe;GAC3B,MAAM;GACN,IAAI;GACJ,mBAAmB;GACpB,CACwB,CAAC,CAAC,CAAC,QAAQ,CAClC;GAAE,MAAM;GAAa,IAAI;GAAQ,mBAAmB;GAAgB,CACrE,CAAC;GACF;EACF;AAEF,SAAS,uCAAuC;AAI9C,IAAG,uEAAuE;AASxE,eAAO,aAAa,CAPlB;GACE,MAAM;GACN,MAAM;GACN,SAAS,CAAC;IAAE,MAAM;IAAc,MAAM;IAAe,CAAC;GACtD,cAAc,EAAE,QAAQ,EAAE,kBAAkB,WAAW,EAAE;GAC1D,CAEwB,CAAC,CAAC,CAAC,QAAQ,CACpC;GAAE,MAAM;GAAW,MAAM;GAAQ,SAAS,CAAC;IAAE,MAAM;IAAc,MAAM;IAAe,CAAC;GAAE,CAC1F,CAAC;GACF;AAEF,IAAG,uDAAuD;AAUxD,eAAO,aAAa,CARlB;GACE,MAAM;GACN,SAAS;GACT,MAAM;GACN,WAAW;GACX,cAAc,EAAE,QAAQ;IAAE,IAAI;IAAM,kBAAkB;IAAW,EAAE;GACpE,CAEwB,CAAC,CAAC,CAAC,QAAQ,CACpC;GACE,MAAM;GACN,SAAS;GACT,MAAM;GACN,WAAW;GACZ,CACF,CAAC;GACF;AAEF,IAAG,4EAA4E;AAW7E,eAAO,aAAa,CATlB;GACE,MAAM;GACN,WAAW;GACX,cAAc;IACZ,WAAW;KAAE,MAAM;KAAa,IAAI;KAAQ,mBAAmB;KAAgB;IAC/E,QAAQ,EAAE,kBAAkB,WAAW;IACxC;GACF,CAEwB,CAAC,CAAC,CAAC,QAAQ,CACpC;GAAE,MAAM;GAAa,IAAI;GAAQ,mBAAmB;GAAgB,CACrE,CAAC;GACF;AAEF,IAAG,iFAAiF;AASlF,eAAO,aAAa,CAPlB;GACE,MAAM;GACN,MAAM;GACN,SAAS,CAAC;IAAE,MAAM;IAAc,MAAM;IAAM,CAAC;GAC7C,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,EAAE;GAC9D,CAEwB,CAAC,CAAC,CAAC,QAAQ,CACpC;GAAE,MAAM;GAAW,MAAM;GAAQ,SAAS,CAAC;IAAE,MAAM;IAAc,MAAM;IAAM,CAAC;GAAE,CACjF,CAAC;GACF;EACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@effect-uai/responses",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "OpenAI Responses API provider for @effect-uai/core.",
   "keywords": [
     "ai",
@@ -38,6 +38,10 @@
       "types": "./dist/Responses.d.mts",
       "import": "./dist/Responses.mjs"
     },
+    "./ResponsesTools": {
+      "types": "./dist/ResponsesTools.d.mts",
+      "import": "./dist/ResponsesTools.mjs"
+    },
     "./OpenAIDeepResearch": {
       "types": "./dist/OpenAIDeepResearch.d.mts",
       "import": "./dist/OpenAIDeepResearch.mjs"
@@ -53,7 +57,7 @@
   "devDependencies": {
     "effect": "4.0.0-beta.94",
     "typescript": "^6.0.3",
-    "@effect-uai/core": "0.11.0"
+    "@effect-uai/core": "0.12.0"
   },
   "peerDependencies": {
     "@effect-uai/core": ">=0.2.0 <1",

package/src/Responses.ts

@@ -51,6 +51,20 @@ export 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
@@ -108,6 +122,12 @@ export 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>>
 }
 
 // ---------------------------------------------------------------------------
@@ -136,6 +156,7 @@ const buildText = (request: ResponsesRequest): Record<string, unknown> | undefin
 const buildBody = (
   request: ResponsesRequest,
   providerToolWire: ReadonlyArray<Record<string, unknown>>,
+  cfg: Config,
 ): Record<string, unknown> => {
   const text = buildText(request)
   const functionTools = descriptorsOf(request.tools).map((t) => ({
@@ -176,6 +197,8 @@ const buildBody = (
     }),
     ...(request.truncation !== undefined && { truncation: request.truncation }),
     ...(text !== undefined && { text }),
+    ...cfg.extraBody,
+    ...request.extraBody,
   }
 }
 
@@ -309,7 +332,7 @@ const buildNativeStream = (cfg: Config) => {
         )
         const httpRequest = HttpClientRequest.post(url).pipe(
           HttpClientRequest.bearerToken(cfg.apiKey),
-          HttpClientRequest.bodyJsonUnsafe(buildBody(request, providerToolWire)),
+          HttpClientRequest.bodyJsonUnsafe(buildBody(request, providerToolWire, cfg)),
           HttpClientRequest.accept("text/event-stream"),
         )
         const response = yield* client

package/src/codec.test.ts

@@ -0,0 +1,87 @@
+import type { HistoryItem } from "@effect-uai/core/Items"
+import { describe, expect, it } from "vitest"
+import { itemsToInput, wireItemToItem } from "./codec.js"
+
+describe("providerData round-trip", () => {
+  it("re-emits a stashed item verbatim, preserving fields our shape drops", () => {
+    // `id` and `encrypted_content` cannot be reconstructed from a Reasoning
+    // item, so the round-trip has to go through the stash.
+    const items = wireItemToItem({
+      type: "reasoning",
+      id: "rs_1",
+      encrypted_content: "opaque-state",
+    })
+    expect(itemsToInput(items)).toEqual([
+      { type: "reasoning", id: "rs_1", encrypted_content: "opaque-state" },
+    ])
+  })
+})
+
+describe("providerData is a shared slot", () => {
+  // Regression: the passthrough used to re-emit the whole `providerData`
+  // object as the wire item. An item that had been through another provider
+  // first was sent as that provider's data, losing the real content.
+  it("ignores another provider's data and encodes the item normally", () => {
+    const history: ReadonlyArray<HistoryItem> = [
+      {
+        type: "message",
+        role: "user",
+        content: [{ type: "input_text", text: "hello world" }],
+        providerData: { gemini: { thoughtSignature: "sig-abc" } },
+      },
+    ]
+    expect(itemsToInput(history)).toEqual([
+      { type: "message", role: "user", content: [{ type: "input_text", text: "hello world" }] },
+    ])
+  })
+
+  it("does not send a foreign function_call as junk", () => {
+    const history: ReadonlyArray<HistoryItem> = [
+      {
+        type: "function_call",
+        call_id: "c1",
+        name: "get_weather",
+        arguments: '{"city":"Lisbon"}',
+        providerData: { gemini: { id: "g1", thoughtSignature: "sig-abc" } },
+      },
+    ]
+    expect(itemsToInput(history)).toEqual([
+      {
+        type: "function_call",
+        call_id: "c1",
+        name: "get_weather",
+        arguments: '{"city":"Lisbon"}',
+      },
+    ])
+  })
+
+  it("re-emits only our key when an item carries several providers' data", () => {
+    const history: ReadonlyArray<HistoryItem> = [
+      {
+        type: "reasoning",
+        signature: "opaque-state",
+        providerData: {
+          responses: { type: "reasoning", id: "rs_1", encrypted_content: "opaque-state" },
+          gemini: { thoughtSignature: "sig-abc" },
+        },
+      },
+    ]
+    expect(itemsToInput(history)).toEqual([
+      { type: "reasoning", id: "rs_1", encrypted_content: "opaque-state" },
+    ])
+  })
+
+  it("falls back to a normal encode when the stashed value is not one of ours", () => {
+    const history: ReadonlyArray<HistoryItem> = [
+      {
+        type: "message",
+        role: "user",
+        content: [{ type: "input_text", text: "hi" }],
+        providerData: { responses: { type: "not_an_item_we_model" } },
+      },
+    ]
+    expect(itemsToInput(history)).toEqual([
+      { type: "message", role: "user", content: [{ type: "input_text", text: "hi" }] },
+    ])
+  })
+})

package/src/codec.ts

@@ -1,4 +1,4 @@
-import { Encoding, Match, Option, Schema } from "effect"
+import { Encoding, Match, Option, Result, Schema, pipe } from "effect"
 import type { ContentBlock, InputImage, HistoryItem } from "@effect-uai/core/Items"
 import type { Turn } from "@effect-uai/core/Turn"
 
@@ -159,16 +159,36 @@ export type WireResponseCompleted = typeof WireResponseCompleted.Type
 // ---------------------------------------------------------------------------
 
 /**
- * If an item carries `providerData` from a prior OpenAI turn, re-emit it
- * verbatim - preserves `encrypted_content`, item ids, and any field this
- * codec doesn't model.
+ * The item shapes we stash for round-tripping. Narrower than
+ * `WireOutputItem`: the provider-hosted call variants are dropped from the
+ * turn, so they are never stored. Composed from the internal `Wire*` structs,
+ * which keeps the wire model out of the package's public surface.
  */
-const passthrough = (item: HistoryItem): Record<string, unknown> | undefined =>
-  item.providerData !== undefined &&
-  typeof item.providerData === "object" &&
-  item.providerData !== null
-    ? (item.providerData as Record<string, unknown>)
-    : undefined
+const StoredItem = Schema.Union([WireMessage, WireFunctionCall, WireReasoning])
+type StoredItem = typeof StoredItem.Type
+
+const ProviderDataResponses = Schema.Struct({ responses: StoredItem })
+const decodeResponsesData = Schema.decodeUnknownResult(ProviderDataResponses)
+
+/**
+ * If an item carries `providerData.responses` from a prior turn on this API,
+ * re-emit it verbatim - preserves `encrypted_content` and item ids, which a
+ * fresh encode from our `HistoryItem` shape cannot reconstruct.
+ *
+ * Namespaced because `providerData` is a shared slot: an item routed through
+ * another provider first (dynamic fallback) carries that provider's key, and
+ * re-emitting the whole object would send that provider's data as the wire
+ * item and drop the real content. Anything that fails to decode is not ours,
+ * so we fall back to encoding the item normally.
+ */
+const passthrough = (item: HistoryItem): StoredItem | undefined =>
+  pipe(
+    decodeResponsesData(item.providerData),
+    Result.match({
+      onSuccess: (data) => data.responses,
+      onFailure: (): StoredItem | undefined => undefined,
+    }),
+  )
 
 /**
  * OpenAI's `input_image` content block carries a single `image_url` field;
@@ -253,7 +273,7 @@ export const wireItemToItem = (wire: WireOutputItem): ReadonlyArray<HistoryItem>
           type: "message" as const,
           role: m.role,
           content: m.content.map(wireMessageContentToBlock),
-          providerData: m,
+          providerData: { responses: m },
         },
       ],
       function_call: (f): ReadonlyArray<HistoryItem> => [
@@ -262,7 +282,7 @@ export const wireItemToItem = (wire: WireOutputItem): ReadonlyArray<HistoryItem>
           call_id: f.call_id,
           name: f.name,
           arguments: f.arguments,
-          providerData: f,
+          providerData: { responses: f },
         },
       ],
       reasoning: (r): ReadonlyArray<HistoryItem> => [
@@ -273,7 +293,7 @@ export const wireItemToItem = (wire: WireOutputItem): ReadonlyArray<HistoryItem>
             summary: r.summary.map((s) => s.text).join("\n"),
           }),
           ...(r.encrypted_content !== undefined && { signature: r.encrypted_content }),
-          providerData: r,
+          providerData: { responses: r },
         },
       ],
       // Hosted-tool calls are provider-executed; drop from the turn (Phase 1).