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

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

@@ -1,56 +1,23 @@
 import { OnModuleInit } from '@nestjs/common';
-import type { AiModelCapabilities } from '../../core/capabilities';
-import type { AiCallContext, AiDiscoveredModel, AiKeyVerification, AiProviderAdapter, AiResponsesPort } from '../../core/provider-adapter.interface';
+import { OpenAiProviderAdapter as BaseOpenAiProviderAdapter } from '@marinoscar/platform-ai-providers/openai';
+import '../../core/ai-error';
 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 {
+export { AI_PROVIDER_CALL_SPAN } from '@marinoscar/platform-ai-providers/openai';
+/**
+ * The injectable OpenAiProviderAdapter: registers itself with `AiProviderRegistry` when
+ * its module initialises.
+ *
+ * @stability experimental
+ */
+export declare class OpenAiProviderAdapter extends BaseOpenAiProviderAdapter implements 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`.
+     * @param registry - the provider registry this adapter joins.
+     * @param clients - the injectable SDK client factory.
      */
-    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;
+    constructor(registry: AiProviderRegistry, clients: OpenAiClientFactory);
+    /** Adds this adapter to `AiProviderRegistry`. */
+    onModuleInit(): void;
 }
 //# sourceMappingURL=openai.adapter.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"openai.adapter.d.ts","sourceRoot":"","sources":["../../../../src/ai/providers/openai/openai.adapter.ts"],"names":[],"mappings":"AAcA,OAAO,EAAsB,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,qBAAqB,IAAI,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AAE9G,OAAO,qBAAqB,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AAEjF;;;;;GAKG;AACH,qBACa,qBAAsB,SAAQ,yBAA0B,YAAW,YAAY;IAMxF,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAL3B;;;OAGG;gBAEgB,QAAQ,EAAE,kBAAkB,EAC7C,OAAO,EAAE,mBAAmB;IAK9B,iDAAiD;IACjD,YAAY,IAAI,IAAI;CAGrB"}

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

@@ -1,52 +1,16 @@
 "use strict";
 // =============================================================================
-// OpenAI provider adapter (issue #426, epic #419)
+// OpenAiProviderAdapter: the Nest binding (issue #991)
 // =============================================================================
 //
-// 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.
+// The adapter itself (ports, mappers, error mapping, telemetry) lives in
+// `@marinoscar/platform-ai-providers/openai`, framework-free. This subclass keeps the
+// platform's injectable class and constructor signature
+// (`AiProviderRegistry`, `OpenAiClientFactory`), hands the base a Nest `Logger` named
+// after this class and the platform tracer (`../platform-ai-tracer.ts`), so
+// log lines and `ai.provider.call` spans are unchanged, and registers itself
+// with `AiProviderRegistry` in `onModuleInit` as it always did. It imports no
+// SDK.
 // =============================================================================
 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;
@@ -61,176 +25,33 @@ 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 openai_1 = require("@marinoscar/platform-ai-providers/openai");
+require("../../core/ai-error");
 const provider_registry_1 = require("../../core/provider-registry");
-const openai_audio_mapper_1 = require("./openai-audio.mapper");
+const platform_ai_tracer_1 = require("../platform-ai-tracer");
 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 {
+var openai_2 = require("@marinoscar/platform-ai-providers/openai");
+Object.defineProperty(exports, "AI_PROVIDER_CALL_SPAN", { enumerable: true, get: function () { return openai_2.AI_PROVIDER_CALL_SPAN; } });
+/**
+ * The injectable OpenAiProviderAdapter: registers itself with `AiProviderRegistry` when
+ * its module initialises.
+ *
+ * @stability experimental
+ */
+let OpenAiProviderAdapter = OpenAiProviderAdapter_1 = class OpenAiProviderAdapter extends openai_1.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;
+    /**
+     * @param registry - the provider registry this adapter joins.
+     * @param clients - the injectable SDK client factory.
+     */
     constructor(registry, clients) {
+        super({ clients, logger: new common_1.Logger(OpenAiProviderAdapter_1.name), tracer: platform_ai_tracer_1.PLATFORM_AI_TRACER });
         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),
-        });
     }
+    /** Adds this adapter to `AiProviderRegistry`. */
     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([

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

@@ -1 +1 @@
-{"version":3,"file":"openai.adapter.js","sourceRoot":"","sources":["../../../../src/ai/providers/openai/openai.adapter.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,kDAAkD;AAClD,gFAAgF;AAChF,EAAE;AACF,6EAA6E;AAC7E,0EAA0E;AAC1E,EAAE;AACF,6EAA6E;AAC7E,0EAA0E;AAC1E,yEAAyE;AACzE,qEAAqE;AACrE,gEAAgE;AAChE,sDAAsD;AACtD,8DAA8D;AAC9D,uEAAuE;AACvE,oFAAoF;AACpF,sFAAsF;AACtF,sEAAsE;AACtE,0FAA0F;AAC1F,EAAE;AACF,wEAAwE;AACxE,0EAA0E;AAC1E,4EAA4E;AAC5E,wEAAwE;AACxE,oDAAoD;AACpD,EAAE;AACF,sEAAsE;AACtE,4EAA4E;AAC5E,4EAA4E;AAC5E,2EAA2E;AAC3E,uEAAuE;AACvE,EAAE;AACF,iEAAiE;AACjE,wEAAwE;AACxE,6EAA6E;AAC7E,uEAAuE;AACvE,4EAA4E;AAC5E,wEAAwE;AACxE,6EAA6E;AAC7E,4EAA4E;AAC5E,YAAY;AACZ,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,8EAA8E;AAC9E,yEAAyE;AACzE,uEAAuE;AACvE,cAAc;AACd,gFAAgF;;;;;;;;;;;;;AAEhF,2CAAkE;AAUlE,oEAAkE;AAmBlE,+DAM+B;AAC/B,mEAAuF;AACvF,yEAAmG;AACnG,mEAA8D;AAC9D,mDAAoF;AACpF,iEAIgC;AAChC,iEAA2G;AAC3G,qEAAuG;AACvG,uEAAkE;AAElE,iEAAgE;AAAvD,8HAAA,qBAAqB,OAAA;AAGvB,IAAM,qBAAqB,6BAA3B,MAAM,qBAAqB;IAyCb;IACA;IAzCV,EAAE,GAAG,kCAAkB,CAAC;IACxB,WAAW,GAAG,QAAQ,CAAC;IAEhC,uGAAuG;IAC9F,cAAc,GAAG,+CAAuB,CAAC;IAElD,kFAAkF;IACzE,iBAAiB,GAA0B,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAEtF,SAAS,GAAoB;QACpC,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC;QAC3D,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC;KAC5D,CAAC;IAEO,UAAU,GAAqB;QACtC,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC;KAC1C,CAAC;IAEO,MAAM,GAAiB;QAC9B,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC;QACrD,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC;KAC9C,CAAC;IAEO,KAAK,GAAgB;QAC5B,UAAU,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC;QACnD,qBAAqB,EAAE,oDAA8B;QACrD,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC;QAC1C,MAAM,EAAE,2CAAoB;KAC7B,CAAC;IAEO,QAAQ,GAAmB;QAClC,aAAa,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,qBAAqB,CAAC,GAAG,EAAE,GAAG,CAAC;QACjE,MAAM,EAAE,6CAAsB;KAC/B,CAAC;IAEe,MAAM,GAAG,IAAI,eAAM,CAAC,uBAAqB,CAAC,IAAI,CAAC,CAAC;IAChD,SAAS,GAAG,IAAI,2CAAmB,CAAC,6BAAa,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAChE,eAAe,CAAwB;IAExD,YACmB,QAA4B,EAC5B,OAA4B;QAD5B,aAAQ,GAAR,QAAQ,CAAoB;QAC5B,YAAO,GAAP,OAAO,CAAqB;QAE7C,IAAI,CAAC,eAAe,GAAG,IAAI,+CAAqB,CAAC;YAC/C,MAAM,EAAE,6BAAa;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;YACzC,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;SACnD,CAAC,CAAC;IACL,CAAC;IAED,YAAY;QACV,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,aAAa,CAAC,OAAe;QAC3B,OAAO,IAAA,0CAAmB,EAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,GAAkB;QACjC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,IAAI,EAAE;YACnE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACxC,MAAM,MAAM,GAAwB,EAAE,CAAC;YAEvC,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;gBACrE,MAAM,CAAC,IAAI,CAAC;oBACV,EAAE,EAAE,KAAK,CAAC,EAAE;oBACZ,OAAO,EAAE,KAAK,CAAC,QAAQ;oBACvB,GAAG,CAAC,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC5F,CAAC,CAAC;YACL,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,SAAS,CAAC,GAAkB;QAChC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,IAAI,EAAE;gBACjE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAExC,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YACnD,CAAC,CAAC,CAAC;YAEH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;QACtB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,IAAA,8BAAc,EAAC,GAAG,CAAC,CAAC;YAEnC,OAAO,MAAM,CAAC,IAAI,KAAK,gBAAgB;gBACrC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE;gBACvC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,8EAA8E;IAE9E,qFAAqF;IAC7E,KAAK,CAAC,GAAuB,EAAE,GAAkB;QACvD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,mBAAmB,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,IAAI,EAAE;YACzE,MAAM,IAAI,GAAG,IAAA,mDAAwB,EAAC,GAAG,CAAC,CAAC;YAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAExC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC;YAEzG,OAAO,IAAA,sDAA2B,EAAC,IAAI,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,iBAAiB,EAAE,UAAU,EAAE,CAAC,CAAC;QAC5F,CAAC,CAAC,CAAC;IACL,CAAC;IAED,gFAAgF;IAEhF,sGAAsG;IAC9F,cAAc,CAAC,GAA6B,EAAE,GAAkB;QACtE,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,iBAAiB,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,IAAI,EAAE;YACvE,MAAM,IAAI,GAAG,IAAA,mDAA4B,EAAC,GAAG,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAExC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC;YAEvG,OAAO,IAAA,+CAAwB,EAAC,IAAI,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,iBAAiB,EAAE,UAAU,EAAE,CAAC,CAAC;QACzF,CAAC,CAAC,CAAC;IACL,CAAC;IAED,oFAAoF;IAC5E,UAAU,CAAC,GAAuB,EAAE,GAAkB;QAC5D,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,IAAI,EAAE;YACnE,MAAM,IAAI,GAAG,MAAM,IAAA,+CAAwB,EAAC,GAAG,CAAC,CAAC;YACjD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAExC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC;YAEnG,OAAO,IAAA,+CAAwB,EAAC,IAAI,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,iBAAiB,EAAE,UAAU,EAAE,CAAC,CAAC;QACzF,CAAC,CAAC,CAAC;IACL,CAAC;IAED,gFAAgF;IAEhF;;;OAGG;IACK,UAAU,CAAC,GAA2B,EAAE,GAAkB;QAChE,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,IAAI,EAAE;YACxE,MAAM,IAAI,GAAG,MAAM,IAAA,kDAA4B,EAAC,GAAG,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAExC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,cAAc;iBAC3D,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;iBACpC,YAAY,EAAE,CAAC;YAElB,OAAO,IAAA,qDAA+B,EAAC,IAAI,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,iBAAiB,EAAE,UAAU,EAAE,CAAC,CAAC;QAChG,CAAC,CAAC,CAAC;IACL,CAAC;IAED,qEAAqE;IAC7D,KAAK,CAAC,GAAoB,EAAE,GAAkB;QACpD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,cAAc,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,IAAI,EAAE;YACpE,MAAM,IAAI,GAAG,IAAA,2CAAqB,EAAC,GAAG,CAAC,CAAC;YACxC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAExC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC;YAC3G,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;YAEvD,OAAO,IAAA,8CAAwB,EAAC,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,iBAAiB,EAAE,UAAU,EAAE,CAAC,CAAC;QAC1F,CAAC,CAAC,CAAC;IACL,CAAC;IAED,iFAAiF;IAEjF;;;;OAIG;IACK,qBAAqB,CAAC,GAA6B,EAAE,GAAkB;QAC7E,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,wBAAwB,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,IAAI,EAAE;YAC9E,MAAM,IAAI,GAAG,IAAA,oDAA2B,EAAC,GAAG,CAAC,CAAC;YAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAExC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,aAAa;iBAC7D,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;iBACpC,YAAY,EAAE,CAAC;YAElB,OAAO,IAAA,uDAA8B,EAAC,IAAI,EAAE;gBAC1C,OAAO,EAAE,GAAG;gBACZ,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,iBAAiB,EAAE,UAAU;aAC9B,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AApMY,sDAAqB;gCAArB,qBAAqB;IADjC,IAAA,mBAAU,GAAE;qCA0CkB,sCAAkB;QACnB,2CAAmB;GA1CpC,qBAAqB,CAoMjC"}
+{"version":3,"file":"openai.adapter.js","sourceRoot":"","sources":["../../../../src/ai/providers/openai/openai.adapter.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,uDAAuD;AACvD,gFAAgF;AAChF,EAAE;AACF,yEAAyE;AACzE,sFAAsF;AACtF,wDAAwD;AACxD,sFAAsF;AACtF,4EAA4E;AAC5E,6EAA6E;AAC7E,8EAA8E;AAC9E,OAAO;AACP,gFAAgF;;;;;;;;;;;;;AAEhF,2CAAkE;AAClE,qEAA8G;AAE9G,+BAA6B;AAC7B,oEAAkE;AAClE,8DAA2D;AAC3D,mEAA8D;AAE9D,mEAAiF;AAAxE,+GAAA,qBAAqB,OAAA;AAE9B;;;;;GAKG;AAEI,IAAM,qBAAqB,6BAA3B,MAAM,qBAAsB,SAAQ,8BAAyB;IAM/C;IALnB;;;OAGG;IACH,YACmB,QAA4B,EAC7C,OAA4B;QAE5B,KAAK,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,eAAM,CAAC,uBAAqB,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,uCAAkB,EAAE,CAAC,CAAC;QAH9E,aAAQ,GAAR,QAAQ,CAAoB;IAI/C,CAAC;IAED,iDAAiD;IACjD,YAAY;QACV,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;CACF,CAAA;AAhBY,sDAAqB;gCAArB,qBAAqB;IADjC,IAAA,mBAAU,GAAE;qCAOkB,sCAAkB;QACpC,2CAAmB;GAPnB,qBAAqB,CAgBjC"}

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

@@ -1,16 +1,16 @@
-import { OpenAI } from 'openai';
-import { type AiCallContext } from '../../core/provider-adapter.interface';
-import { type OpenAiClientOptions } from '../openai/openai-client.factory';
-/** DI token for the client's options (tests inject a mocked `fetch`). */
+import { OpenAiCompatibleClientFactory as BaseOpenAiCompatibleClientFactory, type OpenAiClientOptions } from '@marinoscar/platform-ai-providers/openai';
+/** DI token for `OpenAiClientOptions` (optional; tests and forks provide it). */
 export declare const OPENAI_COMPATIBLE_CLIENT_OPTIONS: unique symbol;
-export declare class OpenAiCompatibleClientFactory {
-    private readonly options;
-    constructor(options?: OpenAiClientOptions);
+/**
+ * The injectable OpenAiCompatibleClientFactory: the framework-free factory of
+ * `@marinoscar/platform-ai-providers/openai` with its options injected.
+ *
+ * @stability experimental
+ */
+export declare class OpenAiCompatibleClientFactory extends BaseOpenAiCompatibleClientFactory {
     /**
-     * The client for one call. Throws `AI_KEY_INVALID` for an empty key and
-     * `AI_PROVIDER_UNAVAILABLE` when no base URL is configured — there is no
-     * default host for a self-hosted server.
+     * @param options - the client options (a mocked `fetch` in tests); none in production.
      */
-    create(ctx: AiCallContext): OpenAI;
+    constructor(options?: OpenAiClientOptions);
 }
 //# sourceMappingURL=openai-compatible-client.factory.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"openai-compatible-client.factory.d.ts","sourceRoot":"","sources":["../../../../src/ai/providers/openai-compatible/openai-compatible-client.factory.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC/F,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,iCAAiC,CAAC;AAIzC,yEAAyE;AACzE,eAAO,MAAM,gCAAgC,eAA6C,CAAC;AAE3F,qBACa,6BAA6B;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;gBAEoB,OAAO,CAAC,EAAE,mBAAmB;IAI/F;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM;CAkBnC"}
+{"version":3,"file":"openai-compatible-client.factory.d.ts","sourceRoot":"","sources":["../../../../src/ai/providers/openai-compatible/openai-compatible-client.factory.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,6BAA6B,IAAI,iCAAiC,EAClE,KAAK,mBAAmB,EACzB,MAAM,0CAA0C,CAAC;AAElD,iFAAiF;AACjF,eAAO,MAAM,gCAAgC,eAA6C,CAAC;AAE3F;;;;;GAKG;AACH,qBACa,6BAA8B,SAAQ,iCAAiC;IAClF;;OAEG;gBAC+D,OAAO,CAAC,EAAE,mBAAmB;CAGhG"}

package/dist/ai/providers/openai-compatible/openai-compatible-client.factory.js

@@ -1,19 +1,13 @@
 "use strict";
 // =============================================================================
-// OpenAI-compatible SDK client factory (issue #448, epic #421)
+// OpenAiCompatibleClientFactory: the Nest binding (issue #991)
 // =============================================================================
 //
-// One OpenAI SDK client PER CALL, pointed at the administrator's `baseUrl`
-// (the server's API root, `/v1` included), with the options every
-// OpenAI-family client pins (no environment reads, no retries, no SDK
-// logging) and a `fetch` that follows no redirect (`openai-redirect-guard.ts`).
-//
-// KEYLESS (`keySource: 'none'`). A call whose key is `AI_KEYLESS_API_KEY` —
-// the marker the key resolver hands out for a `requiresKey: false` server —
-// carries NO credential: the SDK's `Authorization` header is explicitly
-// removed (`defaultHeaders: { Authorization: null }`), so the marker never
-// reaches the wire. Any other key is sent as a bearer token, as OpenAI does;
-// that is what vLLM's `--api-key`, LM Studio and most gateways check.
+// The factory itself (one SDK client per call, every SDK option pinned) lives
+// in `@marinoscar/platform-ai-providers/openai`. This subclass keeps the
+// platform's injectable class, its constructor signature and its optional
+// `OPENAI_COMPATIBLE_CLIENT_OPTIONS` injection token, so the provider module and any test
+// that provides the token wire it exactly as before. It imports no SDK.
 // =============================================================================
 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;
@@ -30,38 +24,21 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OpenAiCompatibleClientFactory = exports.OPENAI_COMPATIBLE_CLIENT_OPTIONS = void 0;
 const common_1 = require("@nestjs/common");
-const openai_1 = require("openai");
-const ai_error_1 = require("../../core/ai-error");
-const provider_adapter_interface_1 = require("../../core/provider-adapter.interface");
-const openai_client_factory_1 = require("../openai/openai-client.factory");
-const openai_redirect_guard_1 = require("../openai/openai-redirect-guard");
-const openai_compatible_settings_1 = require("./openai-compatible-settings");
-/** DI token for the client's options (tests inject a mocked `fetch`). */
+const openai_1 = require("@marinoscar/platform-ai-providers/openai");
+/** DI token for `OpenAiClientOptions` (optional; tests and forks provide it). */
 exports.OPENAI_COMPATIBLE_CLIENT_OPTIONS = Symbol('OPENAI_COMPATIBLE_CLIENT_OPTIONS');
-let OpenAiCompatibleClientFactory = class OpenAiCompatibleClientFactory {
-    options;
-    constructor(options) {
-        this.options = options ?? {};
-    }
+/**
+ * The injectable OpenAiCompatibleClientFactory: the framework-free factory of
+ * `@marinoscar/platform-ai-providers/openai` with its options injected.
+ *
+ * @stability experimental
+ */
+let OpenAiCompatibleClientFactory = class OpenAiCompatibleClientFactory extends openai_1.OpenAiCompatibleClientFactory {
     /**
-     * The client for one call. Throws `AI_KEY_INVALID` for an empty key and
-     * `AI_PROVIDER_UNAVAILABLE` when no base URL is configured — there is no
-     * default host for a self-hosted server.
+     * @param options - the client options (a mocked `fetch` in tests); none in production.
      */
-    create(ctx) {
-        (0, openai_client_factory_1.assertOpenAiApiKey)(ctx, openai_compatible_settings_1.OPENAI_COMPATIBLE_FAMILY);
-        if (!ctx.baseUrl) {
-            throw new ai_error_1.AiError('AI_PROVIDER_UNAVAILABLE', 'No OpenAI-compatible base URL is configured.', {
-                details: { provider: openai_compatible_settings_1.OPENAI_COMPATIBLE_FAMILY.providerId, missing: 'baseUrl' },
-            });
-        }
-        const keyless = ctx.apiKey === provider_adapter_interface_1.AI_KEYLESS_API_KEY;
-        return new openai_1.OpenAI({
-            apiKey: ctx.apiKey,
-            baseURL: ctx.baseUrl,
-            ...(keyless ? { defaultHeaders: { Authorization: null } } : {}),
-            ...(0, openai_client_factory_1.pinnedOpenAiClientOptions)(this.options, (0, openai_redirect_guard_1.noRedirectFetch)(this.options.fetch)),
-        });
+    constructor(options) {
+        super(options);
     }
 };
 exports.OpenAiCompatibleClientFactory = OpenAiCompatibleClientFactory;

package/dist/ai/providers/openai-compatible/openai-compatible-client.factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"openai-compatible-client.factory.js","sourceRoot":"","sources":["../../../../src/ai/providers/openai-compatible/openai-compatible-client.factory.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,+DAA+D;AAC/D,gFAAgF;AAChF,EAAE;AACF,2EAA2E;AAC3E,kEAAkE;AAClE,sEAAsE;AACtE,gFAAgF;AAChF,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,wEAAwE;AACxE,2EAA2E;AAC3E,6EAA6E;AAC7E,sEAAsE;AACtE,gFAAgF;;;;;;;;;;;;;;;AAEhF,2CAA8D;AAC9D,mCAAgC;AAEhC,kDAA8C;AAC9C,sFAA+F;AAC/F,2EAIyC;AACzC,2EAAkE;AAClE,6EAAwE;AAExE,yEAAyE;AAC5D,QAAA,gCAAgC,GAAG,MAAM,CAAC,kCAAkC,CAAC,CAAC;AAGpF,IAAM,6BAA6B,GAAnC,MAAM,6BAA6B;IACvB,OAAO,CAAsB;IAE9C,YAAkE,OAA6B;QAC7F,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,GAAkB;QACvB,IAAA,0CAAkB,EAAC,GAAG,EAAE,qDAAwB,CAAC,CAAC;QAElD,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,kBAAO,CAAC,yBAAyB,EAAE,8CAA8C,EAAE;gBAC3F,OAAO,EAAE,EAAE,QAAQ,EAAE,qDAAwB,CAAC,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE;aAC/E,CAAC,CAAC;QACL,CAAC;QAED,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,KAAK,+CAAkB,CAAC;QAElD,OAAO,IAAI,eAAM,CAAC;YAChB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,GAAG,IAAA,iDAAyB,EAAC,IAAI,CAAC,OAAO,EAAE,IAAA,uCAAe,EAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;SAChF,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AA9BY,sEAA6B;wCAA7B,6BAA6B;IADzC,IAAA,mBAAU,GAAE;IAIE,WAAA,IAAA,iBAAQ,GAAE,CAAA;IAAE,WAAA,IAAA,eAAM,EAAC,wCAAgC,CAAC,CAAA;;GAHtD,6BAA6B,CA8BzC"}
+{"version":3,"file":"openai-compatible-client.factory.js","sourceRoot":"","sources":["../../../../src/ai/providers/openai-compatible/openai-compatible-client.factory.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,+DAA+D;AAC/D,gFAAgF;AAChF,EAAE;AACF,8EAA8E;AAC9E,yEAAyE;AACzE,0EAA0E;AAC1E,0FAA0F;AAC1F,wEAAwE;AACxE,gFAAgF;;;;;;;;;;;;;;;AAEhF,2CAA8D;AAC9D,qEAGkD;AAElD,iFAAiF;AACpE,QAAA,gCAAgC,GAAG,MAAM,CAAC,kCAAkC,CAAC,CAAC;AAE3F;;;;;GAKG;AAEI,IAAM,6BAA6B,GAAnC,MAAM,6BAA8B,SAAQ,sCAAiC;IAClF;;OAEG;IACH,YAAkE,OAA6B;QAC7F,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;CACF,CAAA;AAPY,sEAA6B;wCAA7B,6BAA6B;IADzC,IAAA,mBAAU,GAAE;IAKE,WAAA,IAAA,iBAAQ,GAAE,CAAA;IAAE,WAAA,IAAA,eAAM,EAAC,wCAAgC,CAAC,CAAA;;GAJtD,6BAA6B,CAOzC"}

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

@@ -1,40 +1,22 @@
 import { OnModuleInit } from '@nestjs/common';
-import type { AiModelCapabilities } from '../../core/capabilities';
-import type { AiCallContext, AiDiscoveredModel, AiKeyVerification, AiProviderAdapter, AiResponsesPort } from '../../core/provider-adapter.interface';
+import { OpenAiCompatibleProviderAdapter as BaseOpenAiCompatibleProviderAdapter } from '@marinoscar/platform-ai-providers/openai';
+import '../../core/ai-error';
 import { AiProviderRegistry } from '../../core/provider-registry';
-import type { AiFileInputStrategies } from '../../core/types/file-inputs.types';
-import type { AiEmbeddingsPort } from '../../core/types/media.types';
 import { OpenAiCompatibleClientFactory } from './openai-compatible-client.factory';
-export declare class OpenAiCompatibleProviderAdapter implements AiProviderAdapter, OnModuleInit {
+/**
+ * The injectable OpenAiCompatibleProviderAdapter: registers itself with `AiProviderRegistry` when
+ * its module initialises.
+ *
+ * @stability experimental
+ */
+export declare class OpenAiCompatibleProviderAdapter extends BaseOpenAiCompatibleProviderAdapter implements OnModuleInit {
     private readonly registry;
-    private readonly clients;
-    readonly id = "openai-compatible";
-    readonly displayName = "OpenAI-compatible";
-    /** Chat Completions stores nothing; declared for both styles — see the file header. */
-    readonly supportsPreviousResponseId = false;
-    /** No compatible server is assumed to run hosted tools. */
-    readonly supportsHostedTools = false;
-    /** Inline for both modalities — see the file header. */
-    readonly fileInputStrategy: AiFileInputStrategies;
-    readonly responses: AiResponsesPort;
-    readonly embeddings: AiEmbeddingsPort;
-    private readonly logger;
-    private readonly telemetry;
-    private readonly responsesEngine;
-    private readonly chatEngine;
-    constructor(registry: AiProviderRegistry, clients: OpenAiCompatibleClientFactory);
-    onModuleInit(): void;
-    /** Always unclassified — see the file header. */
-    classifyModel(): AiModelCapabilities | null;
-    listModels(ctx: AiCallContext): Promise<AiDiscoveredModel[]>;
     /**
-     * `GET {baseUrl}/models`. For a keyless server this proves the server is
-     * reachable; for any other it also proves the key. Failures are answers.
+     * @param registry - the provider registry this adapter joins.
+     * @param clients - the injectable SDK client factory.
      */
-    verifyKey(ctx: AiCallContext): Promise<AiKeyVerification>;
-    private create;
-    private stream;
-    /** `POST {baseUrl}/embeddings`, floats on the wire. */
-    private embed;
+    constructor(registry: AiProviderRegistry, clients: OpenAiCompatibleClientFactory);
+    /** Adds this adapter to `AiProviderRegistry`. */
+    onModuleInit(): void;
 }
 //# sourceMappingURL=openai-compatible.adapter.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"openai-compatible.adapter.d.ts","sourceRoot":"","sources":["../../../../src/ai/providers/openai-compatible/openai-compatible.adapter.ts"],"names":[],"mappings":"AA0CA,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,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,KAAK,EAAyC,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAQ5G,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AAOnF,qBACa,+BAAgC,YAAW,iBAAiB,EAAE,YAAY;IA4BnF,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IA5B1B,QAAQ,CAAC,EAAE,uBAAiC;IAC5C,QAAQ,CAAC,WAAW,uBAAuB;IAE3C,uFAAuF;IACvF,QAAQ,CAAC,0BAA0B,SAAS;IAE5C,2DAA2D;IAC3D,QAAQ,CAAC,mBAAmB,SAAS;IAErC,wDAAwD;IACxD,QAAQ,CAAC,iBAAiB,EAAE,qBAAqB,CAAuC;IAExF,QAAQ,CAAC,SAAS,EAAE,eAAe,CAGjC;IAEF,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAEnC;IAEF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoD;IAC3E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkE;IAC5F,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAwB;IACxD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B;gBAGtC,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,EAAE,6BAA6B;IAoBzD,YAAY,IAAI,IAAI;IAIpB,iDAAiD;IACjD,aAAa,IAAI,mBAAmB,GAAG,IAAI;IAIrC,UAAU,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAkBlE;;;OAGG;IACG,SAAS,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAkB/D,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,MAAM;IAed,uDAAuD;IACvD,OAAO,CAAC,KAAK;CAcd"}
+{"version":3,"file":"openai-compatible.adapter.d.ts","sourceRoot":"","sources":["../../../../src/ai/providers/openai-compatible/openai-compatible.adapter.ts"],"names":[],"mappings":"AAcA,OAAO,EAAsB,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,+BAA+B,IAAI,mCAAmC,EAAE,MAAM,0CAA0C,CAAC;AAElI,OAAO,qBAAqB,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AAEnF;;;;;GAKG;AACH,qBACa,+BAAgC,SAAQ,mCAAoC,YAAW,YAAY;IAM5G,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAL3B;;;OAGG;gBAEgB,QAAQ,EAAE,kBAAkB,EAC7C,OAAO,EAAE,6BAA6B;IAKxC,iDAAiD;IACjD,YAAY,IAAI,IAAI;CAGrB"}