@marinoscar/platform-api 0.0.0-stage → 0.1.0-next.4

package/dist/ai/providers/openai/openai-chat-completions.engine.d.ts

@@ -0,0 +1,33 @@
+import type { OpenAI } from 'openai';
+import type { AiCallContext } from '../../core/provider-adapter.interface';
+import type { AiResponse, AiResponseRequest, AiStreamEvent } from '../../core/types/responses.types';
+import type { OpenAiCallTelemetry } from './openai-call-telemetry';
+import { type ChatCompletionsTokenParameter } from './openai-chat-completions.mapper';
+import { type OpenAiFamily } from './openai-errors';
+export interface OpenAiChatCompletionsEngineDeps {
+    family: OpenAiFamily;
+    telemetry: OpenAiCallTelemetry;
+    /** The SDK client for one call. */
+    client(ctx: AiCallContext): OpenAI;
+    /** Which body field carries the output-token limit. */
+    tokenParameter: ChatCompletionsTokenParameter;
+}
+export interface OpenAiChatCompletionsCallOptions {
+    /** The `model` to send when it differs from `req.model` (an Azure deployment). */
+    wireModel?: string;
+}
+export declare class OpenAiChatCompletionsEngine {
+    private readonly deps;
+    constructor(deps: OpenAiChatCompletionsEngineDeps);
+    private get providerId();
+    private body;
+    create(req: AiResponseRequest, ctx: AiCallContext, opts?: OpenAiChatCompletionsCallOptions): Promise<AiResponse>;
+    /** Streams one response — see the file header for the contract. */
+    stream(req: AiResponseRequest, ctx: AiCallContext, opts?: OpenAiChatCompletionsCallOptions): AsyncGenerator<AiStreamEvent>;
+    /**
+     * What each storage-object part becomes on the wire: its presigned URL, or
+     * its bytes as a `data:` URL. `undefined` when the request names none.
+     */
+    private deliverStorageInputs;
+}
+//# sourceMappingURL=openai-chat-completions.engine.d.ts.map

package/dist/ai/providers/openai/openai-chat-completions.engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-chat-completions.engine.d.ts","sourceRoot":"","sources":["../../../../src/ai/providers/openai/openai-chat-completions.engine.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIrC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACrG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,OAAO,EACL,KAAK,6BAA6B,EAGnC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAOpE,MAAM,WAAW,+BAA+B;IAC9C,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,mBAAmB,CAAC;IAC/B,mCAAmC;IACnC,MAAM,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC;IACnC,uDAAuD;IACvD,cAAc,EAAE,6BAA6B,CAAC;CAC/C;AAED,MAAM,WAAW,gCAAgC;IAC/C,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,2BAA2B;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,+BAA+B;IAElE,OAAO,KAAK,UAAU,GAErB;YAEa,IAAI;IAUlB,MAAM,CAAC,GAAG,EAAE,iBAAiB,EAAE,GAAG,EAAE,aAAa,EAAE,IAAI,GAAE,gCAAqC,GAAG,OAAO,CAAC,UAAU,CAAC;IAapH,mEAAmE;IAC5D,MAAM,CACX,GAAG,EAAE,iBAAiB,EACtB,GAAG,EAAE,aAAa,EAClB,IAAI,GAAE,gCAAqC,GAC1C,cAAc,CAAC,aAAa,CAAC;IAsFhC;;;OAGG;YACW,oBAAoB;CAqCnC"}

package/dist/ai/providers/openai/openai-chat-completions.engine.js

@@ -0,0 +1,165 @@
+"use strict";
+// =============================================================================
+// The Chat Completions call path of the OpenAI family (issue #448, epic #421)
+// =============================================================================
+//
+// `create` and `stream` against `POST /chat/completions`, the counterpart of
+// `openai-responses.engine.ts` for servers (and Azure deployments) that do not
+// serve the Responses API. Same contracts, same telemetry:
+//
+//   - every call runs in one `ai.provider.call` span (operations
+//     `chat.completions.create` / `chat.completions.stream`);
+//   - a failure BEFORE the first chunk is thrown as an `AiError`; once the
+//     stream has started, a failure ends it with exactly one `error` event;
+//   - `ctx.signal` aborts the request, and a consumer that stops iterating
+//     aborts it too.
+//
+// Streaming asks for `stream_options: { include_usage: true }` so the final
+// (choice-less) chunk carries token usage — without it every streamed call
+// would record zero tokens.
+//
+// STORAGE-OBJECT INPUTS (#441). Chat Completions has no file store worth
+// uploading to for a call, so only the `presigned_url` and `inline`
+// strategies are delivered (an image as its URL or a `data:` URL, a file as
+// inline `file_data`); an `upload` strategy is refused. The adapters using
+// this engine declare their `fileInputStrategy` accordingly.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAiChatCompletionsEngine = void 0;
+const ai_error_1 = require("../../core/ai-error");
+const openai_chat_completions_stream_mapper_1 = require("./openai-chat-completions-stream.mapper");
+const openai_chat_completions_mapper_1 = require("./openai-chat-completions.mapper");
+const openai_errors_1 = require("./openai-errors");
+const openai_responses_mapper_1 = require("./openai-responses.mapper");
+class OpenAiChatCompletionsEngine {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    get providerId() {
+        return this.deps.family.providerId;
+    }
+    async body(req, ctx, opts) {
+        const body = (0, openai_chat_completions_mapper_1.toChatCompletionsRequest)(req, {
+            family: this.deps.family,
+            storage: await this.deliverStorageInputs(req, ctx),
+            tokenParameter: this.deps.tokenParameter,
+        });
+        return opts.wireModel ? { ...body, model: opts.wireModel } : body;
+    }
+    create(req, ctx, opts = {}) {
+        return this.deps.telemetry.call('chat.completions.create', req.model, ctx, async () => {
+            const body = await this.body(req, ctx, opts);
+            const { data, request_id } = await this.deps
+                .client(ctx)
+                .chat.completions.create({ ...body, stream: false }, { signal: ctx.signal })
+                .withResponse();
+            return (0, openai_chat_completions_mapper_1.fromChatCompletion)(data, { request: req, providerRequestId: request_id, family: this.deps.family });
+        });
+    }
+    /** Streams one response — see the file header for the contract. */
+    async *stream(req, ctx, opts = {}) {
+        const { telemetry, family } = this.deps;
+        const operation = 'chat.completions.stream';
+        const started = Date.now();
+        const span = telemetry.startSpan(operation, req.model);
+        let status = 'ok';
+        let providerRequestId = null;
+        let sdkStream;
+        let terminated = false;
+        try {
+            const body = await this.body(req, ctx, opts);
+            try {
+                const { data, request_id } = await this.deps
+                    .client(ctx)
+                    .chat.completions.create({ ...body, stream: true, stream_options: { include_usage: true } }, { signal: ctx.signal })
+                    .withResponse();
+                sdkStream = data;
+                providerRequestId = request_id;
+            }
+            catch (err) {
+                throw (0, openai_errors_1.mapOpenAiError)(err, family);
+            }
+            const mapper = new openai_chat_completions_stream_mapper_1.ChatCompletionsStreamMapper({ request: req, providerRequestId, family });
+            try {
+                for await (const chunk of sdkStream) {
+                    for (const out of mapper.map(chunk))
+                        yield out;
+                }
+                for (const out of mapper.finish()) {
+                    if (out.type === 'error')
+                        status = out.code;
+                    yield out;
+                }
+            }
+            catch (err) {
+                const mapped = (0, openai_errors_1.mapOpenAiError)(err, family);
+                if (!mapper.started)
+                    throw mapped;
+                status = mapped.code;
+                yield* mapper.fail(mapped);
+            }
+            terminated = mapper.terminated;
+            if (!terminated) {
+                if (ctx.signal?.aborted) {
+                    throw new ai_error_1.AiError('AI_PROVIDER_UNAVAILABLE', 'The AI request was cancelled.', {
+                        details: { provider: this.providerId, aborted: true },
+                    });
+                }
+                const truncated = new ai_error_1.AiError('AI_PROVIDER_UNAVAILABLE', `The ${family.label} stream ended before the response completed.`, { details: { provider: this.providerId } });
+                if (!mapper.started)
+                    throw truncated;
+                status = truncated.code;
+                terminated = true;
+                yield* mapper.fail(truncated);
+            }
+        }
+        catch (err) {
+            const mapped = (0, openai_errors_1.mapOpenAiError)(err, family);
+            status = mapped.code;
+            throw mapped;
+        }
+        finally {
+            // A consumer that stopped early leaves the HTTP stream open: close it.
+            if (!terminated)
+                sdkStream?.controller.abort();
+            telemetry.endSpan(span, status);
+            telemetry.logCall(operation, req.model, ctx, status, started, providerRequestId);
+        }
+    }
+    /**
+     * What each storage-object part becomes on the wire: its presigned URL, or
+     * its bytes as a `data:` URL. `undefined` when the request names none.
+     */
+    async deliverStorageInputs(req, ctx) {
+        const ids = (0, openai_responses_mapper_1.storageObjectIdsOf)(req);
+        if (ids.length === 0)
+            return undefined;
+        const deliveries = new Map();
+        for (const id of ids) {
+            const input = ctx.storageInputs?.get(id);
+            if (!input) {
+                throw new ai_error_1.AiError('AI_INVALID_REQUEST', 'A storage-object input was not resolved by the runtime.', {
+                    details: { provider: this.providerId },
+                });
+            }
+            const base = { modality: input.modality, filename: input.filename };
+            if (input.strategy === 'presigned_url' && input.url) {
+                deliveries.set(id, { ...base, url: input.url });
+            }
+            else if (input.strategy === 'inline' && input.read) {
+                const payload = await input.read();
+                const data = Buffer.from(payload.data).toString('base64');
+                deliveries.set(id, { ...base, url: `data:${input.mimeType};base64,${data}` });
+            }
+            else {
+                throw new ai_error_1.AiError('AI_INVALID_REQUEST', 'A storage-object input was not prepared for delivery.', {
+                    details: { provider: this.providerId, strategy: input.strategy },
+                });
+            }
+        }
+        return deliveries;
+    }
+}
+exports.OpenAiChatCompletionsEngine = OpenAiChatCompletionsEngine;
+//# sourceMappingURL=openai-chat-completions.engine.js.map

package/dist/ai/providers/openai/openai-chat-completions.engine.js.map

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

package/dist/ai/providers/openai/openai-chat-completions.mapper.d.ts

@@ -0,0 +1,42 @@
+import type { ChatCompletion, ChatCompletionCreateParamsBase } from 'openai/resources/chat/completions/completions';
+import type { AiResponse, AiResponseRequest } from '../../core/types/responses.types';
+import { type OpenAiFamily } from './openai-errors';
+import type { OpenAiStorageDeliveries } from './openai-responses.mapper';
+/** The request body minus `stream`/`stream_options`, which the engine sets. */
+export type ChatCompletionsRequestBody = Omit<ChatCompletionCreateParamsBase, 'stream' | 'stream_options'>;
+/**
+ * Which body field carries the output-token limit. `max_completion_tokens` is
+ * OpenAI's (and Azure's) current name and the only one reasoning models
+ * accept; `max_tokens` is the one every OpenAI-compatible server understands.
+ */
+export type ChatCompletionsTokenParameter = 'max_tokens' | 'max_completion_tokens';
+export interface ToChatCompletionsOptions {
+    family?: OpenAiFamily;
+    storage?: OpenAiStorageDeliveries;
+    tokenParameter?: ChatCompletionsTokenParameter;
+}
+/**
+ * Builds the Chat Completions body for `req`. `providerOptions[<provider id>]`
+ * is shallow-merged LAST — the escape hatch for server-specific fields
+ * (`top_p`, `seed`, Ollama's `keep_alive`, ...) — except `stream` and
+ * `stream_options`, which belong to the engine.
+ *
+ * Throws `AiError` (never an SDK error): see the file header.
+ */
+export declare function toChatCompletionsRequest(req: AiResponseRequest, opts?: ToChatCompletionsOptions): ChatCompletionsRequestBody;
+export interface FromChatCompletionOptions {
+    /** The originating request; its `structuredOutput` drives `parsed`. */
+    request: AiResponseRequest;
+    providerRequestId?: string | null;
+    family?: OpenAiFamily;
+}
+/**
+ * Maps a finished `ChatCompletion` to an `AiResponse`. Only the first choice
+ * is read (the request never asks for more). A completion with no choice at
+ * all is a provider fault. When structured output was requested and the turn
+ * finished (no pending tool call), the text is validated with
+ * `parseStructured` — invalid JSON or a schema mismatch throws
+ * `AI_STRUCTURED_OUTPUT_INVALID`.
+ */
+export declare function fromChatCompletion(completion: ChatCompletion, opts: FromChatCompletionOptions): AiResponse;
+//# sourceMappingURL=openai-chat-completions.mapper.d.ts.map

package/dist/ai/providers/openai/openai-chat-completions.mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-chat-completions.mapper.d.ts","sourceRoot":"","sources":["../../../../src/ai/providers/openai/openai-chat-completions.mapper.ts"],"names":[],"mappings":"AA4CA,OAAO,KAAK,EACV,cAAc,EAGd,8BAA8B,EAK/B,MAAM,+CAA+C,CAAC;AAIvD,OAAO,KAAK,EAKV,UAAU,EACV,iBAAiB,EAIlB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEzE,+EAA+E;AAC/E,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAAC,8BAA8B,EAAE,QAAQ,GAAG,gBAAgB,CAAC,CAAC;AAE3G;;;;GAIG;AACH,MAAM,MAAM,6BAA6B,GAAG,YAAY,GAAG,uBAAuB,CAAC;AAEnF,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAClC,cAAc,CAAC,EAAE,6BAA6B,CAAC;CAChD;AA6LD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,iBAAiB,EACtB,IAAI,GAAE,wBAA6B,GAClC,0BAA0B,CAgD5B;AAyBD,MAAM,WAAW,yBAAyB;IACxC,uEAAuE;IACvE,OAAO,EAAE,iBAAiB,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,cAAc,EAAE,IAAI,EAAE,yBAAyB,GAAG,UAAU,CAgD1G"}

package/dist/ai/providers/openai/openai-chat-completions.mapper.js

@@ -0,0 +1,304 @@
+"use strict";
+// =============================================================================
+// Our Responses types <-> OpenAI Chat Completions (issue #448, epic #421)
+// =============================================================================
+//
+// The graceful-degradation path of the OpenAI wire family. Most
+// OpenAI-compatible servers (Ollama, vLLM, LM Studio) and every Azure OpenAI
+// api-version serve `POST /chat/completions`, while only some serve the
+// Responses API. Pure functions, no I/O — `toChatCompletionsRequest` builds
+// the body, `fromChatCompletion` reads the answer, and the stream mapper
+// (`openai-chat-completions-stream.mapper.ts`) ends by building a synthetic
+// `ChatCompletion` and handing it to `fromChatCompletion`, so a streamed and
+// a non-streamed call cannot disagree about what a response means.
+//
+// MAPPING
+//   instructions               -> a leading `system` message
+//   message user/system/developer -> `user` / `system` (developer is sent as
+//                                  system: compatible servers rarely know it)
+//   message assistant          -> `assistant` (text only)
+//   function_call (replayed)   -> `tool_calls` on the preceding assistant turn
+//   function_call_output       -> a `tool` message
+//   reasoning (replayed)       -> dropped: Chat Completions has nowhere to put it
+//   image part                 -> `image_url` (URL, presigned URL or data: URL)
+//   file part                  -> `file` with `file_data` (inline data: URL) or
+//                                 `file_id`; a remote file URL is refused
+//   function tools             -> `tools[].function` (JSON Schema from Zod)
+//   structuredOutput           -> `response_format: { type: 'json_schema' }`,
+//                                 then `parseStructured` on the text
+//   maxOutputTokens            -> `max_tokens` or `max_completion_tokens`, as
+//                                 the adapter declares (`tokenParameter`)
+//
+// REFUSED (AI_CAPABILITY_UNSUPPORTED):
+//   - a reasoning EFFORT: Chat Completions has no reasoning summaries, and the
+//     compatible servers this path exists for have no effort knob (a summary
+//     request alone is a harmless no-op, as for a non-reasoning OpenAI model);
+//   - `previousResponseId`: the API is stateless — send the history instead;
+//   - any hosted tool (#442): Chat Completions runs function tools only;
+//   - a remote file URL: only inline bytes or an uploaded file id are accepted.
+//
+// `metadata` is not forwarded: OpenAI only accepts it on stored completions,
+// and compatible servers reject unknown fields inconsistently.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toChatCompletionsRequest = toChatCompletionsRequest;
+exports.fromChatCompletion = fromChatCompletion;
+const node_crypto_1 = require("node:crypto");
+const ai_error_1 = require("../../core/ai-error");
+const structured_output_1 = require("../../core/structured-output");
+const openai_errors_1 = require("./openai-errors");
+function unsupported(family, message, details) {
+    return new ai_error_1.AiError('AI_CAPABILITY_UNSUPPORTED', message, { details: { provider: family.providerId, ...details } });
+}
+function invalid(family, message, details = {}) {
+    return new ai_error_1.AiError('AI_INVALID_REQUEST', message, { details: { provider: family.providerId, ...details } });
+}
+// ---- request ----------------------------------------------------------------
+function toImagePart(url, detail) {
+    return { type: 'image_url', image_url: { url, detail: detail ?? 'auto' } };
+}
+function toFilePart(family, source, filename) {
+    if (source.fileId) {
+        return { type: 'file', file: { file_id: source.fileId } };
+    }
+    if (source.url?.startsWith('data:')) {
+        return { type: 'file', file: { file_data: source.url, filename: filename ?? 'file' } };
+    }
+    throw unsupported(family, 'Chat Completions accepts file inputs only as inline data or an uploaded file id.', {
+        part: 'file',
+    });
+}
+function toContentPart(part, family, storage) {
+    if (part.type === 'text') {
+        return { type: 'text', text: part.text };
+    }
+    if (part.url) {
+        return part.type === 'image' ? toImagePart(part.url, part.detail) : toFilePart(family, { url: part.url }, part.filename);
+    }
+    if (!part.storageObjectId) {
+        throw invalid(family, `An ${part.type} part needs a url or a storageObjectId.`, { part: part.type });
+    }
+    const delivered = storage?.get(part.storageObjectId);
+    if (!delivered || (!delivered.url && !delivered.fileId)) {
+        throw invalid(family, 'A storage-object input was not resolved by the runtime.', { part: part.type });
+    }
+    // By the stored object's modality, not the part's type (#441).
+    if (delivered.modality === 'image') {
+        if (!delivered.url) {
+            throw unsupported(family, 'Chat Completions accepts images only by URL.', { part: part.type });
+        }
+        return toImagePart(delivered.url, part.type === 'image' ? part.detail : undefined);
+    }
+    return toFilePart(family, delivered, (part.type === 'file' ? part.filename : undefined) ?? delivered.filename);
+}
+function textOnly(family, content, role) {
+    if (content.some((part) => part.type !== 'text')) {
+        throw invalid(family, `A ${role} message may contain only text parts.`, { role });
+    }
+    return content.map((part) => (part.type === 'text' ? part.text : '')).join('');
+}
+function toMessages(req, family, storage) {
+    const messages = [];
+    if (req.instructions !== undefined) {
+        messages.push({ role: 'system', content: req.instructions });
+    }
+    if (typeof req.input === 'string') {
+        messages.push({ role: 'user', content: req.input });
+        return messages;
+    }
+    for (const item of req.input) {
+        appendItem(messages, item, family, storage);
+    }
+    return messages;
+}
+function appendItem(messages, item, family, storage) {
+    switch (item.type) {
+        case 'reasoning':
+            // Chat Completions has no reasoning items to replay.
+            return;
+        case 'function_call_output':
+            messages.push({ role: 'tool', tool_call_id: item.callId, content: item.output });
+            return;
+        case 'function_call': {
+            // A replayed call belongs to the assistant turn that made it: the one
+            // just before it when that turn is an assistant message, else a new one.
+            const call = {
+                id: item.callId,
+                type: 'function',
+                function: { name: item.name, arguments: item.arguments },
+            };
+            const last = messages[messages.length - 1];
+            if (last?.role === 'assistant') {
+                last.tool_calls = [...(last.tool_calls ?? []), call];
+            }
+            else {
+                const assistant = { role: 'assistant', content: null, tool_calls: [call] };
+                messages.push(assistant);
+            }
+            return;
+        }
+        case 'message':
+            break;
+    }
+    switch (item.role) {
+        case 'assistant':
+            messages.push({ role: 'assistant', content: textOnly(family, item.content, 'assistant') });
+            return;
+        case 'system':
+        case 'developer':
+            messages.push({ role: 'system', content: textOnly(family, item.content, item.role) });
+            return;
+        case 'user': {
+            // Text-only turns travel as a plain string — the one shape every
+            // compatible server accepts.
+            const plain = item.content.every((part) => part.type === 'text');
+            messages.push({
+                role: 'user',
+                content: plain
+                    ? item.content.map((part) => (part.type === 'text' ? part.text : '')).join('')
+                    : item.content.map((part) => toContentPart(part, family, storage)),
+            });
+            return;
+        }
+    }
+}
+function toTool(tool, family) {
+    if (tool.type !== 'function') {
+        throw unsupported(family, `Hosted tool "${tool.type}" is not supported over Chat Completions.`, {
+            tool: tool.type,
+            capability: 'hosted_tools',
+        });
+    }
+    return {
+        type: 'function',
+        function: {
+            name: tool.name,
+            description: tool.description,
+            parameters: (0, structured_output_1.toJsonSchema)(tool.parameters),
+            strict: tool.strict ?? true,
+        },
+    };
+}
+function toToolChoice(choice) {
+    return typeof choice === 'string' ? choice : { type: 'function', function: { name: choice.name } };
+}
+/**
+ * Builds the Chat Completions body for `req`. `providerOptions[<provider id>]`
+ * is shallow-merged LAST — the escape hatch for server-specific fields
+ * (`top_p`, `seed`, Ollama's `keep_alive`, ...) — except `stream` and
+ * `stream_options`, which belong to the engine.
+ *
+ * Throws `AiError` (never an SDK error): see the file header.
+ */
+function toChatCompletionsRequest(req, opts = {}) {
+    const family = opts.family ?? openai_errors_1.OPENAI_FAMILY;
+    if (req.previousResponseId !== undefined) {
+        throw unsupported(family, 'Chat Completions stores no responses; send the conversation as input instead.', {
+            capability: 'previous_response_id',
+        });
+    }
+    if (req.reasoning?.effort !== undefined) {
+        throw unsupported(family, `Model "${req.model}" does not support reasoning effort over Chat Completions.`, {
+            model: req.model,
+            capability: 'reasoning',
+        });
+    }
+    const body = {
+        model: req.model,
+        messages: toMessages(req, family, opts.storage),
+    };
+    if (req.tools && req.tools.length > 0)
+        body.tools = req.tools.map((tool) => toTool(tool, family));
+    if (req.toolChoice !== undefined)
+        body.tool_choice = toToolChoice(req.toolChoice);
+    if (req.structuredOutput) {
+        body.response_format = {
+            type: 'json_schema',
+            json_schema: {
+                name: req.structuredOutput.name,
+                schema: (0, structured_output_1.toJsonSchema)(req.structuredOutput.schema),
+                strict: req.structuredOutput.strict ?? true,
+            },
+        };
+    }
+    if (req.maxOutputTokens !== undefined) {
+        body[opts.tokenParameter ?? 'max_completion_tokens'] = req.maxOutputTokens;
+    }
+    if (req.temperature !== undefined)
+        body.temperature = req.temperature;
+    const { stream: _stream, stream_options: _streamOptions, ...escapeHatch } = (req.providerOptions?.[family.providerId] ?? {});
+    return { ...body, ...escapeHatch };
+}
+// ---- response ---------------------------------------------------------------
+function finishReasonOf(raw, output, refused) {
+    if (refused || raw === 'content_filter')
+        return 'content_filter';
+    if (output.some((item) => item.type === 'function_call'))
+        return 'tool_calls';
+    if (raw === 'length')
+        return 'length';
+    return 'stop';
+}
+function usageOf(usage) {
+    if (!usage)
+        return {};
+    const out = { inputTokens: usage.prompt_tokens, outputTokens: usage.completion_tokens };
+    const reasoning = usage.completion_tokens_details?.reasoning_tokens;
+    const cached = usage.prompt_tokens_details?.cached_tokens;
+    if (typeof reasoning === 'number')
+        out.reasoningTokens = reasoning;
+    if (typeof cached === 'number')
+        out.cachedInputTokens = cached;
+    return out;
+}
+/**
+ * Maps a finished `ChatCompletion` to an `AiResponse`. Only the first choice
+ * is read (the request never asks for more). A completion with no choice at
+ * all is a provider fault. When structured output was requested and the turn
+ * finished (no pending tool call), the text is validated with
+ * `parseStructured` — invalid JSON or a schema mismatch throws
+ * `AI_STRUCTURED_OUTPUT_INVALID`.
+ */
+function fromChatCompletion(completion, opts) {
+    const family = opts.family ?? openai_errors_1.OPENAI_FAMILY;
+    const providerRequestId = opts.providerRequestId ?? undefined;
+    const choice = completion.choices?.[0];
+    if (!choice) {
+        throw new ai_error_1.AiError('AI_PROVIDER_UNAVAILABLE', `${family.label} returned a completion with no choices.`, {
+            details: { provider: family.providerId, ...(providerRequestId ? { providerRequestId } : {}) },
+        });
+    }
+    const output = [];
+    const text = typeof choice.message?.content === 'string' ? choice.message.content : '';
+    if (text.length > 0)
+        output.push({ type: 'message', text });
+    for (const call of choice.message?.tool_calls ?? []) {
+        if (call.type !== 'function')
+            continue;
+        output.push({
+            type: 'function_call',
+            callId: call.id,
+            name: call.function.name,
+            arguments: call.function.arguments ?? '',
+        });
+    }
+    const refused = typeof choice.message?.refusal === 'string' && choice.message.refusal.length > 0;
+    const finishReason = finishReasonOf(choice.finish_reason, output, refused);
+    const result = {
+        // Some compatible servers omit the id; the neutral contract needs one.
+        id: completion.id || `chatcmpl-${(0, node_crypto_1.randomUUID)()}`,
+        provider: family.providerId,
+        model: completion.model || opts.request.model,
+        output,
+        outputText: text,
+        usage: usageOf(completion.usage),
+        finishReason,
+    };
+    if (providerRequestId)
+        result.providerRequestId = providerRequestId;
+    if (opts.request.structuredOutput && finishReason !== 'tool_calls') {
+        result.parsed = (0, structured_output_1.parseStructured)(opts.request.structuredOutput.schema, text);
+    }
+    return result;
+}
+//# sourceMappingURL=openai-chat-completions.mapper.js.map

package/dist/ai/providers/openai/openai-chat-completions.mapper.js.map

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

package/dist/ai/providers/openai/openai-client.factory.d.ts

@@ -0,0 +1,40 @@
+import { OpenAI } from 'openai';
+import type { AiCallContext } from '../../core/provider-adapter.interface';
+import { type OpenAiFamily } from './openai-errors';
+export declare const OPENAI_DEFAULT_BASE_URL = "https://api.openai.com/v1";
+/** A generous ceiling for one request; long reasoning turns take minutes. */
+export declare const OPENAI_DEFAULT_TIMEOUT_MS: number;
+/** The `fetch` the SDK uses. Tests inject a mocked one; production uses the global. */
+export type OpenAiFetch = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+export interface OpenAiClientOptions {
+    fetch?: OpenAiFetch;
+    timeoutMs?: number;
+}
+/**
+ * Every SDK option this application pins, whatever member of the OpenAI
+ * family the client talks to (#448): nothing may be read from the
+ * environment (`OPENAI_ORG_ID`, `OPENAI_PROJECT_ID`, `OPENAI_LOG`, ...), the
+ * SDK never retries, and it never logs. The Azure and OpenAI-compatible
+ * factories spread this into their own clients.
+ */
+export declare function pinnedOpenAiClientOptions(options: OpenAiClientOptions, fetch?: OpenAiFetch): {
+    fetch?: OpenAiFetch | undefined;
+    organization: null;
+    project: null;
+    adminAPIKey: null;
+    webhookSecret: null;
+    maxRetries: number;
+    timeout: number;
+    logLevel: "off";
+};
+/** Throws `AI_KEY_INVALID` for an empty key — before any client is built. */
+export declare function assertOpenAiApiKey(ctx: AiCallContext, family?: OpenAiFamily): void;
+/** DI token for `OpenAiClientOptions` (optional; tests and forks provide it). */
+export declare const OPENAI_CLIENT_OPTIONS: unique symbol;
+export declare class OpenAiClientFactory {
+    private readonly options;
+    constructor(options?: OpenAiClientOptions);
+    /** The SDK client for one call. Throws `AI_KEY_INVALID` for an empty key. */
+    create(ctx: AiCallContext): OpenAI;
+}
+//# sourceMappingURL=openai-client.factory.d.ts.map

package/dist/ai/providers/openai/openai-client.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-client.factory.d.ts","sourceRoot":"","sources":["../../../../src/ai/providers/openai/openai-client.factory.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEnE,eAAO,MAAM,uBAAuB,8BAA8B,CAAC;AAEnE,6EAA6E;AAC7E,eAAO,MAAM,yBAAyB,QAAiB,CAAC;AAExD,uFAAuF;AACvF,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEnG,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,mBAAmB,EAAE,KAAK,CAAC,EAAE,WAAW;;;;;;;;;EAe1F;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,GAAE,YAA4B,GAAG,IAAI,CAMjG;AAED,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,eAAkC,CAAC;AAErE,qBACa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;gBAES,OAAO,CAAC,EAAE,mBAAmB;IAIpF,6EAA6E;IAC7E,MAAM,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM;CASnC"}