@marinoscar/platform-api 0.1.0-next.3 → 0.1.0-next.5

package/dist/ai/providers/openai/openai-stream.mapper.js

@@ -0,0 +1,139 @@
+"use strict";
+// =============================================================================
+// OpenAI Responses stream events -> AiStreamEvent (issue #426, epic #419)
+// =============================================================================
+//
+// One `OpenAiStreamMapper` per stream: it is stateful because OpenAI's
+// `response.function_call_arguments.delta` names the OUTPUT ITEM (`item_id`)
+// while our event names the CALL (`callId`), and the pairing is only
+// announced once, by that item's `response.output_item.added`.
+//
+// Event mapping (anything else is dropped):
+//
+//   response.created                        -> response.created
+//   response.output_text.delta              -> output_text.delta
+//   response.reasoning_summary_text.delta   -> reasoning_summary.delta
+//   response.function_call_arguments.delta  -> function_call.arguments.delta
+//   response.output_item.done               -> output_item.done
+//   response.completed | response.incomplete-> response.completed
+//   response.failed | error                 -> error
+//
+// HOSTED TOOL PROGRESS (#442). `response.web_search_call.*`,
+// `response.file_search_call.*`, `response.code_interpreter_call.*` (and its
+// `_code.delta`), `response.image_generation_call.*` (partial images
+// included), `response.mcp_call.*` and `response.mcp_list_tools.*` carry only
+// an item id and a phase — no result. They are consumed here on purpose: each
+// hosted call surfaces ONCE, as the `output_item.done` its own
+// `response.output_item.done` produces, carrying the same typed
+// `hosted_tool_call` (status + result) `create` returns. Likewise
+// `response.output_text.annotation.added`: citations arrive on the message's
+// `output_item.done` and on the completed response.
+//
+// `response.incomplete` is terminal too (the turn hit `max_output_tokens` or
+// a content filter): it completes with `finishReason` `length` /
+// `content_filter`, exactly as the same response would from `create`.
+//
+// The completed response is built by `fromOpenAiResponse`, the same function
+// `create` uses, so structured-output validation happens identically; if it
+// fails, the stream ends with an `error` event carrying that code instead.
+//
+// Error events carry OUR generic message for the code, never OpenAI's text.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAiStreamMapper = void 0;
+const ai_error_1 = require("../../core/ai-error");
+const openai_errors_1 = require("./openai-errors");
+const openai_responses_mapper_1 = require("./openai-responses.mapper");
+function errorEvent(err) {
+    return { type: 'error', code: err.code, message: err.message };
+}
+class OpenAiStreamMapper {
+    opts;
+    callIds = new Map();
+    startedFlag = false;
+    terminalFlag = false;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    get family() {
+        return this.opts.family ?? openai_errors_1.OPENAI_FAMILY;
+    }
+    /** Whether `response.created` has been emitted. */
+    get started() {
+        return this.startedFlag;
+    }
+    /** Whether a terminal event (`response.completed` or `error`) has been emitted. */
+    get terminated() {
+        return this.terminalFlag;
+    }
+    /** Maps one SDK event to zero or more of ours. Nothing is emitted after a terminal event. */
+    map(event) {
+        if (this.terminalFlag)
+            return [];
+        switch (event.type) {
+            case 'response.created':
+                if (this.startedFlag)
+                    return [];
+                this.startedFlag = true;
+                return [{ type: 'response.created', id: event.response.id }];
+            case 'response.output_text.delta':
+                return event.delta ? [{ type: 'output_text.delta', delta: event.delta }] : [];
+            case 'response.reasoning_summary_text.delta':
+                return event.delta ? [{ type: 'reasoning_summary.delta', delta: event.delta }] : [];
+            case 'response.output_item.added':
+                if (event.item.type === 'function_call' && event.item.id) {
+                    this.callIds.set(event.item.id, event.item.call_id);
+                }
+                return [];
+            case 'response.function_call_arguments.delta':
+                return event.delta
+                    ? [
+                        {
+                            type: 'function_call.arguments.delta',
+                            callId: this.callIds.get(event.item_id) ?? event.item_id,
+                            delta: event.delta,
+                        },
+                    ]
+                    : [];
+            case 'response.output_item.done': {
+                const item = (0, openai_responses_mapper_1.fromOpenAiOutputItem)(event.item);
+                return item ? [{ type: 'output_item.done', item }] : [];
+            }
+            case 'response.completed':
+            case 'response.incomplete':
+                return this.complete(event.response);
+            case 'response.failed':
+                return this.fail((0, openai_errors_1.mapOpenAiResponseFailure)(event.response.error, this.opts.providerRequestId ?? undefined, this.family));
+            case 'error': {
+                const code = (0, openai_errors_1.classifyOpenAiErrorCode)(event.code);
+                return this.fail(new ai_error_1.AiError(code, (0, openai_errors_1.openAiErrorMessage)(code, this.family), { details: { provider: this.family.providerId } }));
+            }
+            default:
+                return [];
+        }
+    }
+    /** Ends the stream with an `error` event for `err` (idempotent). */
+    fail(err) {
+        if (this.terminalFlag)
+            return [];
+        this.terminalFlag = true;
+        return [errorEvent(err)];
+    }
+    complete(response) {
+        let mapped;
+        try {
+            mapped = (0, openai_responses_mapper_1.fromOpenAiResponse)(response, {
+                request: this.opts.request,
+                providerRequestId: this.opts.providerRequestId,
+                family: this.family,
+            });
+        }
+        catch (err) {
+            return this.fail(ai_error_1.AiError.wrap(err));
+        }
+        this.terminalFlag = true;
+        return [{ type: 'response.completed', response: mapped }];
+    }
+}
+exports.OpenAiStreamMapper = OpenAiStreamMapper;
+//# sourceMappingURL=openai-stream.mapper.js.map

package/dist/ai/providers/openai/openai-stream.mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-stream.mapper.js","sourceRoot":"","sources":["../../../../src/ai/providers/openai/openai-stream.mapper.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,0EAA0E;AAC1E,gFAAgF;AAChF,EAAE;AACF,uEAAuE;AACvE,6EAA6E;AAC7E,qEAAqE;AACrE,+DAA+D;AAC/D,EAAE;AACF,4CAA4C;AAC5C,EAAE;AACF,gEAAgE;AAChE,iEAAiE;AACjE,uEAAuE;AACvE,6EAA6E;AAC7E,gEAAgE;AAChE,kEAAkE;AAClE,qDAAqD;AACrD,EAAE;AACF,6DAA6D;AAC7D,6EAA6E;AAC7E,qEAAqE;AACrE,8EAA8E;AAC9E,8EAA8E;AAC9E,+DAA+D;AAC/D,gEAAgE;AAChE,kEAAkE;AAClE,6EAA6E;AAC7E,oDAAoD;AACpD,EAAE;AACF,6EAA6E;AAC7E,iEAAiE;AACjE,sEAAsE;AACtE,EAAE;AACF,6EAA6E;AAC7E,4EAA4E;AAC5E,2EAA2E;AAC3E,EAAE;AACF,4EAA4E;AAC5E,gFAAgF;;;AAIhF,kDAA8C;AAE9C,mDAMyB;AACzB,uEAAqF;AASrF,SAAS,UAAU,CAAC,GAAY;IAC9B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;AACjE,CAAC;AAED,MAAa,kBAAkB;IAKA;IAJZ,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,WAAW,GAAG,KAAK,CAAC;IACpB,YAAY,GAAG,KAAK,CAAC;IAE7B,YAA6B,IAA+B;QAA/B,SAAI,GAAJ,IAAI,CAA2B;IAAG,CAAC;IAEhE,IAAY,MAAM;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,6BAAa,CAAC;IAC3C,CAAC;IAED,mDAAmD;IACnD,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,mFAAmF;IACnF,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,6FAA6F;IAC7F,GAAG,CAAC,KAA0B;QAC5B,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO,EAAE,CAAC;QAEjC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,kBAAkB;gBACrB,IAAI,IAAI,CAAC,WAAW;oBAAE,OAAO,EAAE,CAAC;gBAChC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;gBAExB,OAAO,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,EAAE,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;YAE/D,KAAK,4BAA4B;gBAC/B,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAEhF,KAAK,uCAAuC;gBAC1C,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,yBAAyB,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAEtF,KAAK,4BAA4B;gBAC/B,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,eAAe,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;oBACzD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACtD,CAAC;gBAED,OAAO,EAAE,CAAC;YAEZ,KAAK,wCAAwC;gBAC3C,OAAO,KAAK,CAAC,KAAK;oBAChB,CAAC,CAAC;wBACE;4BACE,IAAI,EAAE,+BAA+B;4BACrC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,OAAO;4BACxD,KAAK,EAAE,KAAK,CAAC,KAAK;yBACnB;qBACF;oBACH,CAAC,CAAC,EAAE,CAAC;YAET,KAAK,2BAA2B,CAAC,CAAC,CAAC;gBACjC,MAAM,IAAI,GAAG,IAAA,8CAAoB,EAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAE9C,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,CAAC;YAED,KAAK,oBAAoB,CAAC;YAC1B,KAAK,qBAAqB;gBACxB,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAEvC,KAAK,iBAAiB;gBACpB,OAAO,IAAI,CAAC,IAAI,CACd,IAAA,wCAAwB,EAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,iBAAiB,IAAI,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,CACtG,CAAC;YAEJ,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,MAAM,IAAI,GAAG,IAAA,uCAAuB,EAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAEjD,OAAO,IAAI,CAAC,IAAI,CACd,IAAI,kBAAO,CAAC,IAAI,EAAE,IAAA,kCAAkB,EAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC,CAC5G,CAAC;YACJ,CAAC;YAED;gBACE,OAAO,EAAE,CAAC;QACd,CAAC;IACH,CAAC;IAED,oEAAoE;IACpE,IAAI,CAAC,GAAY;QACf,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO,EAAE,CAAC;QACjC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAEzB,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,CAAC;IAEO,QAAQ,CAAC,QAAkD;QACjE,IAAI,MAAM,CAAC;QAEX,IAAI,CAAC;YACH,MAAM,GAAG,IAAA,4CAAkB,EAAC,QAAQ,EAAE;gBACpC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO;gBAC1B,iBAAiB,EAAE,IAAI,CAAC,IAAI,CAAC,iBAAiB;gBAC9C,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAEzB,OAAO,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5D,CAAC;CACF;AA7GD,gDA6GC"}

package/dist/ai/providers/openai/openai.adapter.d.ts

@@ -0,0 +1,56 @@
+import { OnModuleInit } from '@nestjs/common';
+import type { AiModelCapabilities } from '../../core/capabilities';
+import type { AiCallContext, AiDiscoveredModel, AiKeyVerification, AiProviderAdapter, AiResponsesPort } from '../../core/provider-adapter.interface';
+import { AiProviderRegistry } from '../../core/provider-registry';
+import type { AiAudioPort, AiEmbeddingsPort, AiImagesPort, AiRealtimePort } from '../../core/types/media.types';
+import type { AiFileInputStrategies } from '../../core/types/file-inputs.types';
+import { OpenAiClientFactory } from './openai-client.factory';
+export { AI_PROVIDER_CALL_SPAN } from './openai-call-telemetry';
+export declare class OpenAiProviderAdapter implements AiProviderAdapter, OnModuleInit {
+    private readonly registry;
+    private readonly clients;
+    readonly id = "openai";
+    readonly displayName = "OpenAI";
+    /** The endpoint used when the settings slot has no `baseUrl` (#773: the egress inventory reads it). */
+    readonly defaultBaseUrl = "https://api.openai.com/v1";
+    /** Images by presigned URL, files through the Files API — see the file header. */
+    readonly fileInputStrategy: AiFileInputStrategies;
+    readonly responses: AiResponsesPort;
+    readonly embeddings: AiEmbeddingsPort;
+    readonly images: AiImagesPort;
+    readonly audio: AiAudioPort;
+    readonly realtime: AiRealtimePort;
+    private readonly logger;
+    private readonly telemetry;
+    private readonly responsesEngine;
+    constructor(registry: AiProviderRegistry, clients: OpenAiClientFactory);
+    onModuleInit(): void;
+    classifyModel(modelId: string): AiModelCapabilities | null;
+    listModels(ctx: AiCallContext): Promise<AiDiscoveredModel[]>;
+    /**
+     * `GET /v1/models` with the key. A rejected key is an ANSWER
+     * (`{ ok: false, code: 'AI_KEY_INVALID' }`), as is any other failure —
+     * mapped to its code — so the admin UI never has to catch.
+     */
+    verifyKey(ctx: AiCallContext): Promise<AiKeyVerification>;
+    /** `POST /v1/embeddings`, floats on the wire — see `openai-embeddings.mapper.ts`. */
+    private embed;
+    /** `POST /v1/images/generations`, always answered as base64 bytes — see `openai-images.mapper.ts`. */
+    private generateImages;
+    /** `POST /v1/images/edits` (multipart: the source images and the optional mask). */
+    private editImages;
+    /**
+     * `POST /v1/audio/transcriptions` (multipart). A streamed input is sent as
+     * it is read — see `openai-audio.mapper.ts`.
+     */
+    private transcribe;
+    /** `POST /v1/audio/speech` — the answer is the audio file itself. */
+    private speak;
+    /**
+     * `POST /v1/realtime/client_secrets` — mints the ephemeral secret a browser
+     * opens one WebRTC session with (`openai-realtime.mapper.ts`). The call's
+     * key is the request's `Authorization` header and goes nowhere else.
+     */
+    private createRealtimeSession;
+}
+//# sourceMappingURL=openai.adapter.d.ts.map

package/dist/ai/providers/openai/openai.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.adapter.d.ts","sourceRoot":"","sources":["../../../../src/ai/providers/openai/openai.adapter.ts"],"names":[],"mappings":"AAkDA,OAAO,EAAsB,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAElE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EAChB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EACV,WAAW,EAGX,gBAAgB,EAIhB,YAAY,EACZ,cAAc,EAOf,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAQhF,OAAO,EAAE,mBAAmB,EAA2B,MAAM,yBAAyB,CAAC;AAavF,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,qBACa,qBAAsB,YAAW,iBAAiB,EAAE,YAAY;IAyCzE,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAzC1B,QAAQ,CAAC,EAAE,YAAsB;IACjC,QAAQ,CAAC,WAAW,YAAY;IAEhC,uGAAuG;IACvG,QAAQ,CAAC,cAAc,+BAA2B;IAElD,kFAAkF;IAClF,QAAQ,CAAC,iBAAiB,EAAE,qBAAqB,CAA8C;IAE/F,QAAQ,CAAC,SAAS,EAAE,eAAe,CAGjC;IAEF,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAEnC;IAEF,QAAQ,CAAC,MAAM,EAAE,YAAY,CAG3B;IAEF,QAAQ,CAAC,KAAK,EAAE,WAAW,CAKzB;IAEF,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAG/B;IAEF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IACjE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuD;IACjF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAwB;gBAGrC,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,EAAE,mBAAmB;IAW/C,YAAY,IAAI,IAAI;IAIpB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI;IAIpD,UAAU,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAiBlE;;;;OAIG;IACG,SAAS,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAoB/D,qFAAqF;IACrF,OAAO,CAAC,KAAK;IAab,sGAAsG;IACtG,OAAO,CAAC,cAAc;IAWtB,oFAAoF;IACpF,OAAO,CAAC,UAAU;IAalB;;;OAGG;IACH,OAAO,CAAC,UAAU;IAalB,qEAAqE;IACrE,OAAO,CAAC,KAAK;IAcb;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;CAgB9B"}

package/dist/ai/providers/openai/openai.adapter.js

@@ -0,0 +1,241 @@
+"use strict";
+// =============================================================================
+// OpenAI provider adapter (issue #426, epic #419)
+// =============================================================================
+//
+// The first real `AiProviderAdapter`: OpenAI through its Responses API, with
+// the official SDK hidden completely behind the neutral contract. Pieces:
+//
+//   openai-client.factory.ts     one SDK client per call (key, maxRetries 0)
+//   openai-call-telemetry.ts     the `ai.provider.call` span + debug line
+//   openai-responses.engine.ts   create/stream + storage delivery (#441)
+//   openai-responses.mapper.ts   AiResponseRequest <-> Responses API
+//   openai-stream.mapper.ts      stream events -> AiStreamEvent
+//   openai-errors.ts             SDK error -> AiError
+//   openai-model-catalog.ts      classifyModel()'s rule table
+//   openai-embeddings.mapper.ts  AiEmbeddingRequest <-> /v1/embeddings
+//   openai-images.mapper.ts      AiImage*Request <-> /v1/images/{generations,edits}
+//   openai-audio.mapper.ts       AiTranscriptionRequest <-> /v1/audio/transcriptions,
+//                                AiSpeechRequest <-> /v1/audio/speech
+//   openai-realtime.mapper.ts    AiRealtimeSessionRequest <-> /v1/realtime/client_secrets
+//
+// PORTS. `responses`, `embeddings` (#440), `images` (#437, generate AND
+// edit), `audio` (#438 `transcribe`, #439 `speech` + its static `voices`)
+// and `realtime` (#449 `createSession` + its static `voices`) are carried —
+// presence is the declaration, so `AiProviderRegistry.supports()` stays
+// truthful about what this adapter can actually do.
+//
+// REALTIME (#449). `createSession` spends the call's key ONCE, as the
+// `Authorization` header of `POST /v1/realtime/client_secrets`, and returns
+// the EPHEMERAL secret OpenAI mints — the one value this adapter hands back
+// that a browser may hold. It is never logged and never put on a span; the
+// debug line carries the same ids and outcome every other call's does.
+//
+// STORAGE-OBJECT INPUTS (#441). `fileInputStrategy` is images by
+// `presigned_url` (a 10-minute signed GET the runtime minted, passed as
+// `image_url` — OpenAI fetches it, the bytes never pass through the API) and
+// files by `upload`: the runtime's capped stream goes to the Files API
+// (`purpose: 'user_data'`) under the caller's own resolved key, the request
+// names it by `file_id`, and the provider-side copy is DELETED once the
+// response completes, fails or its stream ends — best effort, logged by file
+// id only. Nothing is cached across calls (or users): each call uploads its
+// own copy.
+//
+// OBSERVABILITY. Every provider call runs inside an `ai.provider.call` span
+// carrying `ai.provider`, `ai.model`, `ai.operation` and `ai.status` (`ok` or
+// the AiErrorCode) — never prompt text, output text or the key. The debug log
+// line carries the same four facts plus the request ids and duration. No
+// exception is recorded on the span: an SDK error's message can echo a
+// masked key.
+// =============================================================================
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var OpenAiProviderAdapter_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAiProviderAdapter = exports.AI_PROVIDER_CALL_SPAN = void 0;
+const common_1 = require("@nestjs/common");
+const provider_registry_1 = require("../../core/provider-registry");
+const openai_audio_mapper_1 = require("./openai-audio.mapper");
+const openai_client_factory_1 = require("./openai-client.factory");
+const openai_embeddings_mapper_1 = require("./openai-embeddings.mapper");
+const openai_call_telemetry_1 = require("./openai-call-telemetry");
+const openai_errors_1 = require("./openai-errors");
+const openai_images_mapper_1 = require("./openai-images.mapper");
+const openai_model_catalog_1 = require("./openai-model-catalog");
+const openai_realtime_mapper_1 = require("./openai-realtime.mapper");
+const openai_responses_engine_1 = require("./openai-responses.engine");
+var openai_call_telemetry_2 = require("./openai-call-telemetry");
+Object.defineProperty(exports, "AI_PROVIDER_CALL_SPAN", { enumerable: true, get: function () { return openai_call_telemetry_2.AI_PROVIDER_CALL_SPAN; } });
+let OpenAiProviderAdapter = OpenAiProviderAdapter_1 = class OpenAiProviderAdapter {
+    registry;
+    clients;
+    id = openai_errors_1.OPENAI_PROVIDER_ID;
+    displayName = 'OpenAI';
+    /** The endpoint used when the settings slot has no `baseUrl` (#773: the egress inventory reads it). */
+    defaultBaseUrl = openai_client_factory_1.OPENAI_DEFAULT_BASE_URL;
+    /** Images by presigned URL, files through the Files API — see the file header. */
+    fileInputStrategy = { image: 'presigned_url', file: 'upload' };
+    responses = {
+        create: (req, ctx) => this.responsesEngine.create(req, ctx),
+        stream: (req, ctx) => this.responsesEngine.stream(req, ctx),
+    };
+    embeddings = {
+        embed: (req, ctx) => this.embed(req, ctx),
+    };
+    images = {
+        generate: (req, ctx) => this.generateImages(req, ctx),
+        edit: (req, ctx) => this.editImages(req, ctx),
+    };
+    audio = {
+        transcribe: (req, ctx) => this.transcribe(req, ctx),
+        transcriptionMaxBytes: openai_audio_mapper_1.OPENAI_TRANSCRIPTION_MAX_BYTES,
+        speech: (req, ctx) => this.speak(req, ctx),
+        voices: openai_model_catalog_1.OPENAI_SPEECH_VOICES,
+    };
+    realtime = {
+        createSession: (req, ctx) => this.createRealtimeSession(req, ctx),
+        voices: openai_model_catalog_1.OPENAI_REALTIME_VOICES,
+    };
+    logger = new common_1.Logger(OpenAiProviderAdapter_1.name);
+    telemetry = new openai_call_telemetry_1.OpenAiCallTelemetry(openai_errors_1.OPENAI_FAMILY, this.logger);
+    responsesEngine;
+    constructor(registry, clients) {
+        this.registry = registry;
+        this.clients = clients;
+        this.responsesEngine = new openai_responses_engine_1.OpenAiResponsesEngine({
+            family: openai_errors_1.OPENAI_FAMILY,
+            telemetry: this.telemetry,
+            logger: this.logger,
+            client: (ctx) => this.clients.create(ctx),
+            classify: (modelId) => this.classifyModel(modelId),
+        });
+    }
+    onModuleInit() {
+        this.registry.register(this);
+    }
+    classifyModel(modelId) {
+        return (0, openai_model_catalog_1.classifyOpenAiModel)(modelId);
+    }
+    async listModels(ctx) {
+        return this.telemetry.call('models.list', undefined, ctx, async () => {
+            const client = this.clients.create(ctx);
+            const models = [];
+            for await (const model of client.models.list({ signal: ctx.signal })) {
+                models.push({
+                    id: model.id,
+                    ownedBy: model.owned_by,
+                    ...(typeof model.created === 'number' ? { createdAt: new Date(model.created * 1000) } : {}),
+                });
+            }
+            return models;
+        });
+    }
+    /**
+     * `GET /v1/models` with the key. A rejected key is an ANSWER
+     * (`{ ok: false, code: 'AI_KEY_INVALID' }`), as is any other failure —
+     * mapped to its code — so the admin UI never has to catch.
+     */
+    async verifyKey(ctx) {
+        try {
+            await this.telemetry.call('verify_key', undefined, ctx, async () => {
+                const client = this.clients.create(ctx);
+                await client.models.list({ signal: ctx.signal });
+            });
+            return { ok: true };
+        }
+        catch (err) {
+            const mapped = (0, openai_errors_1.mapOpenAiError)(err);
+            return mapped.code === 'AI_KEY_INVALID'
+                ? { ok: false, code: 'AI_KEY_INVALID' }
+                : { ok: false, code: mapped.code, detail: mapped.message };
+        }
+    }
+    // ---- embeddings port ------------------------------------------------------
+    /** `POST /v1/embeddings`, floats on the wire — see `openai-embeddings.mapper.ts`. */
+    embed(req, ctx) {
+        return this.telemetry.call('embeddings.create', req.model, ctx, async () => {
+            const body = (0, openai_embeddings_mapper_1.toOpenAiEmbeddingRequest)(req);
+            const client = this.clients.create(ctx);
+            const { data, request_id } = await client.embeddings.create(body, { signal: ctx.signal }).withResponse();
+            return (0, openai_embeddings_mapper_1.fromOpenAiEmbeddingResponse)(data, { request: req, providerRequestId: request_id });
+        });
+    }
+    // ---- images port ------------------------------------------------------------
+    /** `POST /v1/images/generations`, always answered as base64 bytes — see `openai-images.mapper.ts`. */
+    generateImages(req, ctx) {
+        return this.telemetry.call('images.generate', req.model, ctx, async () => {
+            const body = (0, openai_images_mapper_1.toOpenAiImageGenerateRequest)(req);
+            const client = this.clients.create(ctx);
+            const { data, request_id } = await client.images.generate(body, { signal: ctx.signal }).withResponse();
+            return (0, openai_images_mapper_1.fromOpenAiImagesResponse)(data, { request: req, providerRequestId: request_id });
+        });
+    }
+    /** `POST /v1/images/edits` (multipart: the source images and the optional mask). */
+    editImages(req, ctx) {
+        return this.telemetry.call('images.edit', req.model, ctx, async () => {
+            const body = await (0, openai_images_mapper_1.toOpenAiImageEditRequest)(req);
+            const client = this.clients.create(ctx);
+            const { data, request_id } = await client.images.edit(body, { signal: ctx.signal }).withResponse();
+            return (0, openai_images_mapper_1.fromOpenAiImagesResponse)(data, { request: req, providerRequestId: request_id });
+        });
+    }
+    // ---- audio port -------------------------------------------------------------
+    /**
+     * `POST /v1/audio/transcriptions` (multipart). A streamed input is sent as
+     * it is read — see `openai-audio.mapper.ts`.
+     */
+    transcribe(req, ctx) {
+        return this.telemetry.call('audio.transcribe', req.model, ctx, async () => {
+            const body = await (0, openai_audio_mapper_1.toOpenAiTranscriptionRequest)(req);
+            const client = this.clients.create(ctx);
+            const { data, request_id } = await client.audio.transcriptions
+                .create(body, { signal: ctx.signal })
+                .withResponse();
+            return (0, openai_audio_mapper_1.fromOpenAiTranscriptionResponse)(data, { request: req, providerRequestId: request_id });
+        });
+    }
+    /** `POST /v1/audio/speech` — the answer is the audio file itself. */
+    speak(req, ctx) {
+        return this.telemetry.call('audio.speech', req.model, ctx, async () => {
+            const body = (0, openai_audio_mapper_1.toOpenAiSpeechRequest)(req);
+            const client = this.clients.create(ctx);
+            const { data, request_id } = await client.audio.speech.create(body, { signal: ctx.signal }).withResponse();
+            const bytes = new Uint8Array(await data.arrayBuffer());
+            return (0, openai_audio_mapper_1.fromOpenAiSpeechResponse)(bytes, { request: req, providerRequestId: request_id });
+        });
+    }
+    // ---- realtime port -----------------------------------------------------------
+    /**
+     * `POST /v1/realtime/client_secrets` — mints the ephemeral secret a browser
+     * opens one WebRTC session with (`openai-realtime.mapper.ts`). The call's
+     * key is the request's `Authorization` header and goes nowhere else.
+     */
+    createRealtimeSession(req, ctx) {
+        return this.telemetry.call('realtime.client_secret', req.model, ctx, async () => {
+            const body = (0, openai_realtime_mapper_1.toOpenAiClientSecretRequest)(req);
+            const client = this.clients.create(ctx);
+            const { data, request_id } = await client.realtime.clientSecrets
+                .create(body, { signal: ctx.signal })
+                .withResponse();
+            return (0, openai_realtime_mapper_1.fromOpenAiClientSecretResponse)(data, {
+                request: req,
+                baseUrl: ctx.baseUrl,
+                providerRequestId: request_id,
+            });
+        });
+    }
+};
+exports.OpenAiProviderAdapter = OpenAiProviderAdapter;
+exports.OpenAiProviderAdapter = OpenAiProviderAdapter = OpenAiProviderAdapter_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [provider_registry_1.AiProviderRegistry,
+        openai_client_factory_1.OpenAiClientFactory])
+], OpenAiProviderAdapter);
+//# sourceMappingURL=openai.adapter.js.map

package/dist/ai/providers/openai/openai.adapter.js.map

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

package/dist/ai/providers/openai/openai.module.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The OpenAI provider (issue #426, epic #419). Being in the module graph is
+ * the registration: `OpenAiProviderAdapter.onModuleInit()` adds itself to
+ * `AiProviderRegistry`. Whether the provider is ENABLED, and with which key,
+ * is runtime configuration (#423/#428), not wiring.
+ *
+ * @stability experimental
+ */
+export declare class OpenAiProviderModule {
+}
+//# sourceMappingURL=openai.module.d.ts.map

package/dist/ai/providers/openai/openai.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.module.d.ts","sourceRoot":"","sources":["../../../../src/ai/providers/openai/openai.module.ts"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,qBAKa,oBAAoB;CAAG"}

package/dist/ai/providers/openai/openai.module.js

@@ -0,0 +1,32 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAiProviderModule = void 0;
+const common_1 = require("@nestjs/common");
+const ai_core_module_1 = require("../../core/ai-core.module");
+const openai_client_factory_1 = require("./openai-client.factory");
+const openai_adapter_1 = require("./openai.adapter");
+/**
+ * The OpenAI provider (issue #426, epic #419). Being in the module graph is
+ * the registration: `OpenAiProviderAdapter.onModuleInit()` adds itself to
+ * `AiProviderRegistry`. Whether the provider is ENABLED, and with which key,
+ * is runtime configuration (#423/#428), not wiring.
+ *
+ * @stability experimental
+ */
+let OpenAiProviderModule = class OpenAiProviderModule {
+};
+exports.OpenAiProviderModule = OpenAiProviderModule;
+exports.OpenAiProviderModule = OpenAiProviderModule = __decorate([
+    (0, common_1.Module)({
+        imports: [ai_core_module_1.AiCoreModule],
+        providers: [openai_client_factory_1.OpenAiClientFactory, openai_adapter_1.OpenAiProviderAdapter],
+        exports: [openai_adapter_1.OpenAiProviderAdapter],
+    })
+], OpenAiProviderModule);
+//# sourceMappingURL=openai.module.js.map

package/dist/ai/providers/openai/openai.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.module.js","sourceRoot":"","sources":["../../../../src/ai/providers/openai/openai.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AAExC,8DAAyD;AACzD,mEAA8D;AAC9D,qDAAyD;AAEzD;;;;;;;GAOG;AAMI,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;CAAG,CAAA;AAAvB,oDAAoB;+BAApB,oBAAoB;IALhC,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,6BAAY,CAAC;QACvB,SAAS,EAAE,CAAC,2CAAmB,EAAE,sCAAqB,CAAC;QACvD,OAAO,EAAE,CAAC,sCAAqB,CAAC;KACjC,CAAC;GACW,oBAAoB,CAAG"}

package/dist/ai/providers/openai/openai.provider-definition.d.ts

@@ -0,0 +1,12 @@
+import type { AiProviderDefinition } from '../ai-provider-definition';
+/**
+ * The `openai` provider's definition (PP-14.6, #924): what the AI slice knows
+ * about it before its adapter runs. Registered by `../builtin-ai-providers.ts`
+ * through `registerAiProvider`, like an app's provider. Its settings are the
+ * fields its slot always had, so the stored `ai.providers['openai']` and the
+ * admin page are unchanged.
+ *
+ * @stability experimental
+ */
+export declare const openAiProviderDefinition: AiProviderDefinition;
+//# sourceMappingURL=openai.provider-definition.d.ts.map

package/dist/ai/providers/openai/openai.provider-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.provider-definition.d.ts","sourceRoot":"","sources":["../../../../src/ai/providers/openai/openai.provider-definition.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGtE;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,EAAE,oBAQtC,CAAC"}

package/dist/ai/providers/openai/openai.provider-definition.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openAiProviderDefinition = void 0;
+const ai_1 = require("@marinoscar/platform-contract/ai");
+const openai_module_1 = require("./openai.module");
+/**
+ * The `openai` provider's definition (PP-14.6, #924): what the AI slice knows
+ * about it before its adapter runs. Registered by `../builtin-ai-providers.ts`
+ * through `registerAiProvider`, like an app's provider. Its settings are the
+ * fields its slot always had, so the stored `ai.providers['openai']` and the
+ * admin page are unchanged.
+ *
+ * @stability experimental
+ */
+exports.openAiProviderDefinition = {
+    id: 'openai',
+    label: 'OpenAI',
+    description: "OpenAI's Responses API, embeddings, images, audio and realtime.",
+    module: openai_module_1.OpenAiProviderModule,
+    settingsSchema: ai_1.systemAiProviderSchema.omit({ enabled: true }),
+    defaults: {},
+    requiresKey: true,
+};
+//# sourceMappingURL=openai.provider-definition.js.map

package/dist/ai/providers/openai/openai.provider-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.provider-definition.js","sourceRoot":"","sources":["../../../../src/ai/providers/openai/openai.provider-definition.ts"],"names":[],"mappings":";;;AAAA,yDAA0E;AAG1E,mDAAuD;AAEvD;;;;;;;;GAQG;AACU,QAAA,wBAAwB,GAAyB;IAC5D,EAAE,EAAE,QAAQ;IACZ,KAAK,EAAE,QAAQ;IACf,WAAW,EAAE,iEAAiE;IAC9E,MAAM,EAAE,oCAAoB;IAC5B,cAAc,EAAE,2BAAsB,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC9D,QAAQ,EAAE,EAAE;IACZ,WAAW,EAAE,IAAI;CAClB,CAAC"}

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

@@ -0,0 +1,24 @@
+import type { ChatCompletion, ChatCompletionChunk } from 'openai/resources/chat/completions/completions';
+export interface ChatToolCallFixture {
+    id?: string;
+    name: string;
+    arguments: string;
+}
+export interface ChatCompletionFixtureOptions {
+    model?: string;
+    content?: string | null;
+    refusal?: string | null;
+    toolCalls?: ChatToolCallFixture[];
+    finishReason?: ChatCompletion.Choice['finish_reason'];
+    usage?: ChatCompletion['usage'] | null;
+    id?: string;
+}
+export declare function chatCompletionFixture(opts?: ChatCompletionFixtureOptions): ChatCompletion;
+/**
+ * The chunks `completion` streams as: the content in `chunkSize`-character
+ * deltas, each tool call's arguments likewise (its id and name in the first
+ * fragment), the finish reason on the last choice chunk, and — when
+ * `includeUsage` — a final choice-less usage chunk.
+ */
+export declare function chatChunksFor(completion: ChatCompletion, chunkSize?: number, includeUsage?: boolean): ChatCompletionChunk[];
+//# sourceMappingURL=chat-completions-fixtures.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat-completions-fixtures.d.ts","sourceRoot":"","sources":["../../../../../src/ai/providers/openai/testing/chat-completions-fixtures.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,+CAA+C,CAAC;AAUzG,MAAM,WAAW,mBAAmB;IAClC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,4BAA4B;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAClC,YAAY,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IACtD,KAAK,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IACvC,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,qBAAqB,CAAC,IAAI,GAAE,4BAAiC,GAAG,cAAc,CA6B7F;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,cAAc,EAAE,SAAS,SAAI,EAAE,YAAY,UAAO,GAAG,mBAAmB,EAAE,CA4BnH"}