@aeye/openai 0.3.10 → 0.7.0

package/aeye-openai.md

@@ -1,10 +1,10 @@
 # @aeye/openai
 
-One-line purpose: OpenAI provider for the `@aeye/ai` framework — chat, vision, reasoning, tools, structured output, image generation/edit, transcription, speech, and embeddings via the official `openai` SDK. Also the base class for any OpenAI-compatible provider.
+One-line purpose: OpenAI provider for the `@aeye/ai` framework — chat (Chat Completions or the Responses API), vision, reasoning, tools, hosted tools, structured output, audio output, image generation/edit, transcription, speech, and embeddings via the official `openai` SDK. Also the base class for any OpenAI-compatible provider.
 
 ## When to use
 
-- You want to call OpenAI (GPT-4o, GPT-4, o-series, DALL-E, gpt-image, Whisper, TTS, text-embedding-3-*) through `@aeye/ai`.
+- You want to call OpenAI (GPT-5.x, GPT-6, GPT-4.1, gpt-audio, GPT Image, gpt-transcribe, TTS, text-embedding-3-*) through `@aeye/ai`.
 - You need a base class to build an OpenAI-compatible provider (Azure OpenAI, OpenRouter, local OpenAI-shaped endpoints). `@aeye/openrouter` is built this way.
 
 ## Install / import
@@ -28,7 +28,7 @@ import {
 } from '@aeye/openai';
 ```
 
-`@aeye/ai` and `@aeye/core` are peer/runtime dependencies (they ship as `dependencies`). The `openai` SDK and `zod` are also dependencies.
+`@aeye/ai` and `@aeye/core` are peer/runtime dependencies (they ship as `dependencies`). The `openai` SDK (v7) and `zod` are also dependencies. Requires Node >= 22.
 
 ## Register with an `@aeye/ai` instance
 
@@ -55,7 +55,7 @@ console.log(response.content);
 // Explicit model selection is done via metadata, not the provider
 const r2 = await ai.chat.get(
   { messages: [{ role: 'user', content: 'Hi' }] },
-  { metadata: { model: 'openai/gpt-4o' } }
+  { metadata: { model: 'openai/gpt-5.4-mini' } }
 );
 ```
 
@@ -66,7 +66,7 @@ const executor = openai.createExecutor();
 const res = await executor(
   { messages: [{ role: 'user', content: 'Hello!' }] },
   {},                 // AIContext
-  { model: 'gpt-4o' } // AIMetadata
+  { model: 'gpt-5.4-mini' } // AIMetadata
 );
 ```
 
@@ -85,37 +85,46 @@ const res = await executor(
 | `organization` | `string` | Org ID |
 | `project` | `string` | Project ID |
 | `store` | `boolean` | Allow OpenAI to store call contents. Defaults to `false` |
+| `api` | `'auto' \| 'chat' \| 'responses'` | Which API chat uses. `auto` (default) picks Responses for Responses-only models (registry `metadata.responsesOnly`, else by id: codex, pre-5.6 pro, deep-research, computer-use), `hostedTools`, a tool with `format`/`defer`/`async`, `reason.mode`/`summary`/`context`, or tools with a reasoning `effort` other than `none` |
 | `retry` | `RetryConfig` | Per-provider retry (maxRetries, initialDelay, retryableStatuses, etc.) |
 | `retryEvents` | `RetryEvents` | Retry lifecycle callbacks (e.g. `onRetry`) |
 | `hooks` | `OpenAIHooks` | Per-operation `beforeRequest` / `afterRequest` / `onError` |
-| `defaultModels` | object | Fallback model per capability: `chat`, `imageGenerate`, `imageEdit`, `imageAnalyze`, `transcription`, `speech`, `embedding` |
+| `defaultModels` | object | Fallback model per capability: `chat`, `imageGenerate`, `imageEdit`, `imageAnalyze`, `transcription`, `speech`, `embedding`. Built-in defaults (the protected `defaults` property, overridable by subclasses): `gpt-image-2`, `gpt-5.4-mini` (image analysis), `gpt-transcribe`, `gpt-4o-mini-tts`, `text-embedding-3-small`; no chat default |
 
 Retry config can also be overridden per request via `request.extra.retry` / `request.extra.retryEvents`.
 
 ### Hooks
 
-`OpenAIHooks` has a block per operation: `chat`, `imageGenerate`, `imageEdit`, `imageAnalyze`, `transcribe`, `speech`, `embed`. Each block may define `beforeRequest(request, params, ctx, metadata)`, `afterRequest(request, params, response, ctx, metadata)`, and `onError(request, params, error, ctx, metadata)`. The `params` argument is the raw OpenAI SDK params, so you can inspect/mutate the exact wire payload.
+`OpenAIHooks` has a block per operation in `OpenAIOperations`: `chat`, `responses`, `imageGenerate`, `imageEdit`, `transcribe`, `speech`, `embed`, `rerank` (used by subclasses such as OpenRouter), `decide`. Image analysis runs as chat and reports through the `chat` (or `responses`) hooks. Each block may define `beforeRequest(request, params, ctx, metadata)`, `afterRequest(request, params, response, ctx, metadata)`, and `onError(request, params, error, ctx, metadata)`. The `params` argument is the raw OpenAI SDK params, so you can inspect/mutate the exact wire payload.
 
 ## Supported capabilities
 
 | Capability | API surface | Models |
 |-----------|-------------|--------|
-| Chat (+ streaming) | `ai.chat.get` / `ai.chat.stream` | GPT-4o, GPT-4, GPT-3.5, o-series |
-| Vision | `ai.chat` with `image` content | GPT-4o / GPT-4V |
-| Reasoning | `ai.chat` with `request.reason.effort` → `reasoning_effort` | o1, o3-mini, etc. |
-| Tools / function calling | `ai.chat` with `tools` | GPT-4o, GPT-4 |
-| Structured output | `ai.chat` with a schema `responseFormat` | GPT-4o (strict json_schema) |
-| Image generation | `ai.image.generate` | `dall-e-2`, `dall-e-3`, `gpt-image-*` |
-| Image edit | `ai.image.edit` | `dall-e-2`, `gpt-image-*` |
-| Transcription (+ stream) | `ai.transcribe` | `whisper-1`, gpt-4o transcribe |
-| Speech / TTS | `ai.speech` | `tts-1`, `tts-1-hd`, gpt-4o-mini-tts |
+| Chat (+ streaming) | `ai.chat.get` / `ai.chat.stream` | GPT-5.x, GPT-6, GPT-4.1, o3 |
+| Vision / files | `ai.chat` with `image` / `file` content (`detail`, `name`) | GPT-5.x, GPT-6, GPT-4.1 |
+| Reasoning | `ai.chat` with `request.reason` — `effort` (`none`..`max`, clamped to the model's `reasoningEfforts`) → `reasoning_effort`; `summary`/`mode`/`context` use Responses | GPT-5.x, GPT-6, o3 |
+| Tools / function calling | `ai.chat` with `tools` | GPT-5.x, GPT-6, GPT-4.1 |
+| Hosted tools | `ai.chat` with `hostedTools` (Responses): `web_search` (allowedDomains only), `file_search`, `code_interpreter`, `image_generation`, `mcp`; `web_fetch` rejected | Responses models |
+| Structured output | `ai.chat` with a schema `responseFormat` | GPT-5.x, GPT-6, GPT-4.1 (strict json_schema) |
+| Audio output | `ai.chat` with `modalities: ['text', 'audio']` + `audio: { voice, format }` | `gpt-audio-1.5` |
+| Image generation (+ stream) | `ai.image.generate` | GPT Image (`gpt-image-2`) |
+| Image edit (+ stream) | `ai.image.edit` (`image` + `references`, `mask`, `inputFidelity`) | GPT Image (`gpt-image-2`) |
+| Transcription (+ stream) | `ai.transcribe` (incl. `diarized_json` + `knownSpeakers`) | `gpt-transcribe`, `gpt-4o-transcribe-diarize`, `whisper-1` |
+| Speech / TTS | `ai.speech` (any voice, incl. custom voice ids) | `gpt-4o-mini-tts`, `tts-1`, `tts-1-hd` |
 | Embeddings | `ai.embed` | `text-embedding-3-small` / `-large` |
 
+Other request fields passed through: `seed`, `verbosity`, `serviceTier`, `metadata` (Chat Completions sends it only when `store` is on), `moderate` (inline `omni-moderation-latest`), `cacheBreakpoint` on content. Responses carry `citations`, `images`, `audio`, `moderation`, `serviceTier`; `usage` counts cache writes, audio, reasoning, and hosted tool calls once each.
+
+Through Responses, reasoning comes back encrypted (`include: reasoning.encrypted_content`, unless `store` is on) as `openai-responses-v1` reasoning details and is replayed from the assistant message's `reasoning` on later turns — only when that reasoning's `provider` is this provider's `name` or unset, so reasoning from OpenRouter or Bedrock is never sent to OpenAI.
+
+Other wire details: `toolsOneAtATime` sends `parallel_tool_calls: false`, and Chat Completions otherwise omits the parameter (o3 rejects it); an assistant turn of only tool calls is sent with no content, not an empty text part.
+
 ### Strict / structured output
 
-The provider only emits OpenAI-shaped strict schemas (`supportedStrictFamilies = {'openai'}`). Strict mode for a tool or structured output engages only when the resolved model's strict format is `openai` **and** the model declares the `toolsStrict` / `structured` capability; otherwise it silently falls back to a lenient (non-strict) schema. A shared `SchemaBudget` is used so tools and the response format cooperate on per-request limits.
+The provider only emits OpenAI-shaped strict schemas (`supportedStrictFamilies = {'openai'}`). Strict mode for a tool or structured output engages only when the resolved model's strict format is `openai` **and** the model declares the `toolsStrict` / `structured` capability; otherwise it silently falls back to the family's non-strict descriptor. When selection supplies only a model id (no `ModelInfo`), the family is still resolved from the id, so the family's non-strict dialect is kept; strict needs the `ModelInfo` capabilities. A shared `SchemaBudget` is used so tools and the response format cooperate on per-request limits. A non-strict `json_schema` response format is sent to the Responses API with an explicit `strict: false`, because Responses treats an unflagged one as strict.
 
-That default is correct for api.openai.com, which speaks exactly one dialect. **A subclass that fronts other providers' models must widen it** — `supportedStrictFamilies` is the gate on the whole family resolution, so leaving it at `{'openai'}` sends every other family's tool schemas out as LENIENT no matter what the model declares. `OpenRouterProvider` sets `{'openai', 'anthropic', 'google'}` for this reason; `AWSProvider` does the same.
+That default is correct for api.openai.com, which speaks exactly one dialect. **A subclass that fronts other providers' models must widen it** — `supportedStrictFamilies` is the gate on the whole family resolution, so leaving it at `{'openai'}` sends every other family's tool schemas out as LENIENT no matter what the model declares. `OpenRouterProvider` sets `{'openai', 'anthropic', 'google', 'xai'}` for this reason; `AWSProvider` sets `{'openai', 'anthropic', 'google'}`.
 
 ## Usage examples
 
@@ -158,8 +167,12 @@ await ai.embed.get({ texts: ['Hello world'] });
 - `convertModel(model)` — enrich `ModelInfo`.
 - `listModels(config)` — custom model discovery.
 - `augmentChatRequest` / `augmentChatMessage` / `augmentChatContent` / `augmentChatChunk` / `augmentChatResponse` — inject provider-specific params and parse extra response fields.
+- `chatHeaders(params)` — extra HTTP headers per Chat Completions request (none by default).
+- `send` / `finish` — run a custom operation through the provider's hooks and retries.
 - `augmentImageGenerateRequest`, `augmentImageEditRequest`, `augmentTranscriptionRequest`, `augmentSpeechRequest`, `augmentEmbeddingRequest`.
 - `supportedStrictFamilies` — widen accepted strict descriptor families.
+- `usesResponses(request, modelId, config, model?)` — decide when chat goes to the Responses API.
+- `defaults` — the built-in default model id per operation.
 
 ```typescript
 class AzureProvider extends OpenAIProvider {

package/dist/convert.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Conversions from OpenAI wire shapes to @aeye shapes, shared by the Chat
+ * Completions, Responses, and media endpoints.
+ */
+import type { AudioFormat, Citation, Moderation, ServiceTier, Usage } from '@aeye/core';
+import OpenAI from 'openai';
+/**
+ * Token totals as an endpoint reports them, before splitting into Usage
+ * categories. Detail counts are subsets of their total.
+ */
+export interface TokenCounts {
+    input?: number;
+    output?: number;
+    cached?: number;
+    cacheWrite?: number;
+    audioInput?: number;
+    reasoning?: number;
+    audioOutput?: number;
+}
+/**
+ * Splits token totals into Usage categories so each token is counted once:
+ * cache reads and writes and audio come out of the input total; reasoning
+ * and audio output come out of the output total.
+ */
+export declare function toUsage(counts: TokenCounts): Usage;
+/**
+ * Usage reported by Chat Completions (and OpenAI-compatible endpoints).
+ */
+export declare function chatUsage(usage: OpenAI.CompletionUsage): Usage;
+/**
+ * Usage reported by the Responses API.
+ */
+export declare function responsesUsage(usage: OpenAI.Responses.ResponseUsage): Usage;
+/**
+ * Usage reported by transcription: tokens for token-billed models, seconds
+ * for duration-billed ones (OpenAI-compatible routers may omit `type`).
+ */
+export declare function transcriptionUsage(usage: OpenAI.Audio.Transcription.Tokens | OpenAI.Audio.Transcription.Duration): Usage;
+/**
+ * The tier a response reports it ran on.
+ */
+export declare function toServiceTier(tier: string | null | undefined): ServiceTier | undefined;
+/**
+ * A URL citation, as both Chat Completions and Responses report them.
+ */
+export declare function toCitation(citation: {
+    url: string;
+    title?: string;
+    start_index?: number;
+    end_index?: number;
+}): Citation;
+/**
+ * One side of a moderation verdict, as both Chat Completions and Responses
+ * report it: results, or an error when moderation itself failed.
+ */
+interface WireModerationSide {
+    type: string;
+    results?: Array<{
+        flagged: boolean;
+        categories: {
+            [category: string]: boolean;
+        };
+    }>;
+}
+/**
+ * Moderation verdicts for the input and the output.
+ */
+export declare function toModeration(moderation: {
+    input: WireModerationSide;
+    output: WireModerationSide;
+}): Moderation;
+/**
+ * The model OpenAI runs moderation with when a request asks for it.
+ */
+export declare const MODERATION_MODEL = "omni-moderation-latest";
+/**
+ * Chat Completions names 16-bit PCM `pcm16`.
+ */
+export declare function toChatAudioFormat(format: AudioFormat): OpenAI.Chat.ChatCompletionAudioParam['format'];
+export {};
+//# sourceMappingURL=convert.d.ts.map

package/dist/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../src/convert.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAoB,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAC1G,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CAoBlD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,eAAe,GAAG,KAAK,CAU9D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC,aAAa,GAAG,KAAK,CAQ3E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,QAAQ,GAAG,KAAK,CAIxH;AAcD;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAEtF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,QAAQ,CAExH;AAED;;;GAGG;AACH,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE;YAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;CACpF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE;IAAE,KAAK,EAAE,kBAAkB,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,GAAG,UAAU,CAM9G;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,2BAA2B,CAAC;AAEzD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,QAAQ,CAAC,CAErG"}

package/dist/convert.js

@@ -0,0 +1,108 @@
+/**
+ * Conversions from OpenAI wire shapes to @aeye shapes, shared by the Chat
+ * Completions, Responses, and media endpoints.
+ */
+/**
+ * Splits token totals into Usage categories so each token is counted once:
+ * cache reads and writes and audio come out of the input total; reasoning
+ * and audio output come out of the output total.
+ */
+export function toUsage(counts) {
+    const nonZero = (n = 0) => n > 0 ? n : undefined;
+    const usage = {};
+    const text = {
+        input: nonZero((counts.input ?? 0) - (counts.cached ?? 0) - (counts.cacheWrite ?? 0) - (counts.audioInput ?? 0)),
+        output: nonZero((counts.output ?? 0) - (counts.reasoning ?? 0) - (counts.audioOutput ?? 0)),
+        cached: nonZero(counts.cached),
+        cacheWrite: nonZero(counts.cacheWrite),
+    };
+    if (text.input || text.output || text.cached || text.cacheWrite) {
+        usage.text = text;
+    }
+    if (counts.reasoning) {
+        usage.reasoning = { output: counts.reasoning };
+    }
+    if (counts.audioInput || counts.audioOutput) {
+        usage.audio = { input: nonZero(counts.audioInput), output: nonZero(counts.audioOutput) };
+    }
+    return usage;
+}
+/**
+ * Usage reported by Chat Completions (and OpenAI-compatible endpoints).
+ */
+export function chatUsage(usage) {
+    return toUsage({
+        input: usage.prompt_tokens,
+        output: usage.completion_tokens,
+        cached: usage.prompt_tokens_details?.cached_tokens,
+        cacheWrite: usage.prompt_tokens_details?.cache_write_tokens,
+        audioInput: usage.prompt_tokens_details?.audio_tokens,
+        reasoning: usage.completion_tokens_details?.reasoning_tokens,
+        audioOutput: usage.completion_tokens_details?.audio_tokens,
+    });
+}
+/**
+ * Usage reported by the Responses API.
+ */
+export function responsesUsage(usage) {
+    return toUsage({
+        input: usage.input_tokens,
+        output: usage.output_tokens,
+        cached: usage.input_tokens_details.cached_tokens,
+        cacheWrite: usage.input_tokens_details.cache_write_tokens,
+        reasoning: usage.output_tokens_details.reasoning_tokens,
+    });
+}
+/**
+ * Usage reported by transcription: tokens for token-billed models, seconds
+ * for duration-billed ones (OpenAI-compatible routers may omit `type`).
+ */
+export function transcriptionUsage(usage) {
+    return 'seconds' in usage
+        ? { audio: { seconds: usage.seconds } }
+        : toUsage({ input: usage.input_tokens, output: usage.output_tokens, audioInput: usage.input_token_details?.audio_tokens });
+}
+/**
+ * Wire tiers to @aeye tiers. `priority` is the older name for `fast`.
+ */
+const SERVICE_TIERS = {
+    auto: 'auto',
+    default: 'default',
+    flex: 'flex',
+    fast: 'fast',
+    priority: 'fast',
+    scale: 'scale',
+};
+/**
+ * The tier a response reports it ran on.
+ */
+export function toServiceTier(tier) {
+    return tier ? SERVICE_TIERS[tier] : undefined;
+}
+/**
+ * A URL citation, as both Chat Completions and Responses report them.
+ */
+export function toCitation(citation) {
+    return { url: citation.url, title: citation.title, start: citation.start_index, end: citation.end_index };
+}
+/**
+ * Moderation verdicts for the input and the output.
+ */
+export function toModeration(moderation) {
+    const side = ({ results }) => results && {
+        flagged: results.some(result => result.flagged),
+        categories: [...new Set(results.flatMap(result => Object.keys(result.categories).filter(category => result.categories[category])))],
+    };
+    return { input: side(moderation.input), output: side(moderation.output) };
+}
+/**
+ * The model OpenAI runs moderation with when a request asks for it.
+ */
+export const MODERATION_MODEL = 'omni-moderation-latest';
+/**
+ * Chat Completions names 16-bit PCM `pcm16`.
+ */
+export function toChatAudioFormat(format) {
+    return format === 'pcm' ? 'pcm16' : format;
+}
+//# sourceMappingURL=convert.js.map

package/dist/convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../src/convert.ts"],"names":[],"mappings":"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"}

package/dist/decisions.d.ts

@@ -0,0 +1,110 @@
+/**
+ * The Decisions API's wire shapes, which the SDK does not type yet, and
+ * their conversion to and from @aeye decisions.
+ */
+import type { DecisionAnswer, DecisionQuestion } from '@aeye/ai';
+import OpenAI from 'openai';
+/**
+ * A question as the Decisions API takes it.
+ */
+export type OpenAIDecisionQuestion = {
+    name: string;
+    instructions: string;
+} & ({
+    type: 'predicate';
+} | {
+    type: 'choice';
+    choices: Array<{
+        value: string;
+        description?: string;
+    }>;
+} | {
+    type: 'score';
+    levels: Array<{
+        label: string;
+        description?: string;
+    }>;
+});
+/**
+ * Parameters of a decision request.
+ */
+export interface OpenAIDecisionParams {
+    model: string;
+    input: string | OpenAI.Responses.ResponseInputItem[];
+    questions: OpenAIDecisionQuestion[];
+}
+/**
+ * An answer as the Decisions API returns it.
+ */
+export type OpenAIDecisionAnswer = {
+    name: string;
+} & ({
+    type: 'predicate';
+    probability: number;
+} | {
+    type: 'choice';
+    choice: string;
+    probabilities: Array<{
+        value: string;
+        probability: number;
+    }>;
+    confidence: number;
+} | {
+    type: 'score';
+    score: number;
+    probabilities: Array<{
+        value: number;
+        label: string;
+        probability: number;
+    }>;
+    confidence: number;
+} | {
+    type: 'refusal';
+});
+/**
+ * A decision as the Decisions API returns it.
+ */
+export interface OpenAIDecision {
+    model: string;
+    answers: OpenAIDecisionAnswer[];
+    usage: OpenAI.Responses.ResponseUsage;
+}
+/**
+ * A question in the System One decision protocol (TypeSafe's), which
+ * OpenRouter's decisions endpoint speaks: a predicate is a `noul`
+ * question, and choices and levels are its criteria.
+ */
+export type SystemOneQuestion = {
+    type: 'noul';
+    instructions: string;
+} | {
+    type: 'choice';
+    instructions: string;
+    criteria: Record<string, string>;
+} | {
+    type: 'score';
+    instructions: string;
+    criteria: string[];
+};
+/**
+ * Parameters of a System One decision request: the evidence as `state`,
+ * and questions by name.
+ */
+export interface SystemOneDecisionParams {
+    model: string;
+    state: string | OpenAI.Chat.ChatCompletionMessageParam[];
+    questions: Record<string, SystemOneQuestion>;
+}
+/**
+ * A question in System One's shape.
+ */
+export declare function toSystemOneQuestion(question: DecisionQuestion): SystemOneQuestion;
+/**
+ * A named question in the Decisions API's shape.
+ */
+export declare function toDecisionQuestion(name: string, question: DecisionQuestion): OpenAIDecisionQuestion;
+/**
+ * An answer in @aeye's shape. Score probabilities come back in level order.
+ */
+export declare function toDecisionAnswer(answer: OpenAIDecisionAnswer): DecisionAnswer;
+//# sourceMappingURL=decisions.d.ts.map

package/dist/decisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions.d.ts","sourceRoot":"","sources":["../src/decisions.ts"],"names":[],"mappings":"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"}

package/dist/decisions.js

@@ -0,0 +1,48 @@
+/**
+ * The Decisions API's wire shapes, which the SDK does not type yet, and
+ * their conversion to and from @aeye decisions.
+ */
+/**
+ * A question in System One's shape.
+ */
+export function toSystemOneQuestion(question) {
+    const { instructions } = question;
+    switch (question.type) {
+        case 'predicate':
+            return { type: 'noul', instructions };
+        case 'choice':
+            return { type: 'choice', instructions, criteria: question.choices };
+        case 'score':
+            return { type: 'score', instructions, criteria: question.levels };
+    }
+}
+/**
+ * A named question in the Decisions API's shape.
+ */
+export function toDecisionQuestion(name, question) {
+    const { instructions } = question;
+    switch (question.type) {
+        case 'predicate':
+            return { name, type: 'predicate', instructions };
+        case 'choice':
+            return { name, type: 'choice', instructions, choices: Object.entries(question.choices).map(([value, description]) => ({ value, description: description || undefined })) };
+        case 'score':
+            return { name, type: 'score', instructions, levels: question.levels.map(label => ({ label })) };
+    }
+}
+/**
+ * An answer in @aeye's shape. Score probabilities come back in level order.
+ */
+export function toDecisionAnswer(answer) {
+    switch (answer.type) {
+        case 'predicate':
+            return { type: 'predicate', probability: answer.probability };
+        case 'choice':
+            return { type: 'choice', choice: answer.choice, probabilities: Object.fromEntries(answer.probabilities.map(p => [p.value, p.probability])), confidence: answer.confidence };
+        case 'score':
+            return { type: 'score', score: answer.score, probabilities: answer.probabilities.map(p => p.probability), confidence: answer.confidence };
+        case 'refusal':
+            return { type: 'refusal' };
+    }
+}
+//# sourceMappingURL=decisions.js.map

package/dist/decisions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions.js","sourceRoot":"","sources":["../src/decisions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA8DH;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAA0B;IAC5D,MAAM,EAAE,YAAY,EAAE,GAAG,QAAQ,CAAC;IAClC,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,WAAW;YACd,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;QACxC,KAAK,QAAQ;YACX,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtE,KAAK,OAAO;YACV,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IACtE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,QAA0B;IACzE,MAAM,EAAE,YAAY,EAAE,GAAG,QAAQ,CAAC;IAClC,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,WAAW;YACd,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC;QACnD,KAAK,QAAQ;YACX,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,IAAI,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC;QAC7K,KAAK,OAAO;YACV,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC;IACpG,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA4B;IAC3D,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,WAAW;YACd,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;QAChE,KAAK,QAAQ;YACX,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;QAC9K,KAAK,OAAO;YACV,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;QAC5I,KAAK,SAAS;YACZ,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC/B,CAAC;AACH,CAAC"}

package/dist/images.d.ts

@@ -0,0 +1,47 @@
+/**
+ * GPT Image request parameters and usage, shared by generation and editing.
+ * DALL·E models were retired, so every image model takes the GPT Image shape.
+ */
+import type { ImageOutputOptions, ModelInfo } from '@aeye/ai';
+import type { Usage } from '@aeye/core';
+/**
+ * Parameters shared by image generation and editing. `auto` and exact
+ * sizes pass through; other sizes snap to the nearest one the model takes.
+ */
+export declare function imageParams(request: ImageOutputOptions, modelId: string, model: ModelInfo | undefined): {
+    model: string;
+    prompt: string;
+    n: number | undefined;
+    size: string | undefined;
+    quality: import("@aeye/ai").ImageQuality | undefined;
+    background: "auto" | "transparent" | "opaque" | undefined;
+    output_format: "png" | "jpeg" | "webp" | undefined;
+    output_compression: number | undefined;
+    user: string | undefined;
+};
+/**
+ * How many partial images a streaming request asks for.
+ */
+export declare function partialImages(request: ImageOutputOptions): number;
+/**
+ * What image responses and completed stream events report about the image.
+ */
+interface ImageResult {
+    usage?: {
+        output_tokens: number;
+        input_tokens_details: {
+            image_tokens: number;
+            text_tokens: number;
+        };
+    };
+    quality?: string;
+    size?: string;
+}
+/**
+ * Usage of an image response: tokens as reported, plus one output entry per
+ * image with the quality and size actually produced, for models priced per
+ * image.
+ */
+export declare function imageUsage(response: ImageResult, count: number): Usage;
+export {};
+//# sourceMappingURL=images.d.ts.map

package/dist/images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../src/images.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AA8CxC;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,SAAS;;;;;;;;;;EAarG;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAEjE;AAED;;GAEG;AACH,UAAU,WAAW;IACnB,KAAK,CAAC,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,oBAAoB,EAAE;YAAE,YAAY,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IACvG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAatE"}

package/dist/images.js

@@ -0,0 +1,80 @@
+/**
+ * GPT Image request parameters and usage, shared by generation and editing.
+ * DALL·E models were retired, so every image model takes the GPT Image shape.
+ */
+/**
+ * Sizes every GPT Image model accepts, for models the registry has no sizes for.
+ */
+const DEFAULT_SIZES = [
+    { width: 1024, height: 1024 },
+    { width: 1536, height: 1024 },
+    { width: 1024, height: 1536 },
+];
+/**
+ * Most images one request may produce.
+ */
+const MAX_IMAGES = 10;
+/**
+ * Most partial images a streaming request may produce.
+ */
+const MAX_PARTIAL_IMAGES = 3;
+/**
+ * The size closest in aspect ratio to the requested one, then the largest.
+ */
+function nearestSize(requested, sizes) {
+    const [width, height] = requested.split('x').map(Number);
+    const ratio = width / height;
+    const [closest] = [...sizes].sort((a, b) => Math.abs(a.width / a.height - ratio) - Math.abs(b.width / b.height - ratio) ||
+        b.width * b.height - a.width * a.height);
+    return `${closest.width}x${closest.height}`;
+}
+/**
+ * The sizes the registry prices for a model.
+ */
+function pricedSizes(model) {
+    return model?.pricing.image?.output?.flatMap(quality => quality.sizes) ?? [];
+}
+/**
+ * Parameters shared by image generation and editing. `auto` and exact
+ * sizes pass through; other sizes snap to the nearest one the model takes.
+ */
+export function imageParams(request, modelId, model) {
+    const sizes = pricedSizes(model);
+    return {
+        model: modelId,
+        prompt: request.prompt,
+        n: request.n === undefined ? undefined : Math.min(Math.max(request.n, 1), MAX_IMAGES),
+        size: !request.size || request.size === 'auto' ? request.size : nearestSize(request.size, sizes.length ? sizes : DEFAULT_SIZES),
+        quality: request.quality,
+        background: request.background,
+        output_format: request.outputFormat,
+        output_compression: request.outputCompression,
+        user: request.userIdentifier,
+    };
+}
+/**
+ * How many partial images a streaming request asks for.
+ */
+export function partialImages(request) {
+    return Math.max(1, Math.min(MAX_PARTIAL_IMAGES, request.streamCount ?? 2));
+}
+/**
+ * Usage of an image response: tokens as reported, plus one output entry per
+ * image with the quality and size actually produced, for models priced per
+ * image.
+ */
+export function imageUsage(response, count) {
+    const [width, height] = (response.size ?? '').split('x').map(Number);
+    const details = response.usage?.input_tokens_details;
+    return {
+        text: details && { input: details.text_tokens },
+        image: {
+            input: details?.image_tokens,
+            tokens: response.usage?.output_tokens,
+            output: response.quality && width && height
+                ? [{ quality: response.quality, size: { width, height }, count }]
+                : undefined,
+        },
+    };
+}
+//# sourceMappingURL=images.js.map

package/dist/images.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.js","sourceRoot":"","sources":["../src/images.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export * from './openai';
+export { type SystemOneDecisionParams, type SystemOneQuestion, toSystemOneQuestion } from './decisions';
 export * from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,KAAK,uBAAuB,EAAE,KAAK,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACxG,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -1,3 +1,4 @@
 export * from './openai';
+export { toSystemOneQuestion } from './decisions';
 export * from './types';
 //# sourceMappingURL=index.js.map