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

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

@@ -0,0 +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"}

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

@@ -0,0 +1,13 @@
+import { type AiOpenAiApiStyle } from '@marinoscar/platform-contract/ai';
+import type { OpenAiFamily } from '../openai/openai-errors';
+export declare const OPENAI_COMPATIBLE_PROVIDER_ID = "openai-compatible";
+export declare const OPENAI_COMPATIBLE_FAMILY: OpenAiFamily;
+/** The wire API used when the slot names none: what every compatible server serves. */
+export declare const OPENAI_COMPATIBLE_DEFAULT_API_STYLE: AiOpenAiApiStyle;
+export interface OpenAiCompatibleSettings {
+    apiStyle: AiOpenAiApiStyle;
+    /** False only when the administrator opted in to a keyless server. */
+    requiresKey: boolean;
+}
+export declare function openAiCompatibleSettings(raw: Readonly<Record<string, unknown>> | undefined): OpenAiCompatibleSettings;
+//# sourceMappingURL=openai-compatible-settings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openai-compatible-settings.d.ts","sourceRoot":"","sources":["../../../../src/ai/providers/openai-compatible/openai-compatible-settings.ts"],"names":[],"mappings":"AAWA,OAAO,EAAwB,KAAK,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAC/F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,eAAO,MAAM,6BAA6B,sBAAsB,CAAC;AAEjE,eAAO,MAAM,wBAAwB,EAAE,YAGrC,CAAC;AAEH,uFAAuF;AACvF,eAAO,MAAM,mCAAmC,EAAE,gBAAqC,CAAC;AAExF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,sEAAsE;IACtE,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,GAAG,wBAAwB,CAOrH"}

package/dist/ai/providers/openai-compatible/openai-compatible-settings.js

@@ -0,0 +1,29 @@
+"use strict";
+// =============================================================================
+// OpenAI-compatible per-call settings (issue #448, epic #421)
+// =============================================================================
+//
+// What `AiCallContext.providerSettings` carries for `openai-compatible` (the
+// slot minus `enabled`/`baseUrl`), read with defaults. Never throws: a
+// malformed field falls back to its default.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OPENAI_COMPATIBLE_DEFAULT_API_STYLE = exports.OPENAI_COMPATIBLE_FAMILY = exports.OPENAI_COMPATIBLE_PROVIDER_ID = void 0;
+exports.openAiCompatibleSettings = openAiCompatibleSettings;
+const zod_1 = require("zod");
+const ai_1 = require("@marinoscar/platform-contract/ai");
+exports.OPENAI_COMPATIBLE_PROVIDER_ID = 'openai-compatible';
+exports.OPENAI_COMPATIBLE_FAMILY = Object.freeze({
+    providerId: exports.OPENAI_COMPATIBLE_PROVIDER_ID,
+    label: 'The OpenAI-compatible server',
+});
+/** The wire API used when the slot names none: what every compatible server serves. */
+exports.OPENAI_COMPATIBLE_DEFAULT_API_STYLE = 'chat_completions';
+function openAiCompatibleSettings(raw) {
+    const apiStyle = zod_1.z.enum(ai_1.AI_OPENAI_API_STYLES).safeParse(raw?.apiStyle);
+    return {
+        apiStyle: apiStyle.success ? apiStyle.data : exports.OPENAI_COMPATIBLE_DEFAULT_API_STYLE,
+        requiresKey: raw?.requiresKey !== false,
+    };
+}
+//# sourceMappingURL=openai-compatible-settings.js.map

package/dist/ai/providers/openai-compatible/openai-compatible-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-compatible-settings.js","sourceRoot":"","sources":["../../../../src/ai/providers/openai-compatible/openai-compatible-settings.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,8DAA8D;AAC9D,gFAAgF;AAChF,EAAE;AACF,6EAA6E;AAC7E,uEAAuE;AACvE,6CAA6C;AAC7C,gFAAgF;;;AAuBhF,4DAOC;AA5BD,6BAAwB;AAExB,yDAA+F;AAGlF,QAAA,6BAA6B,GAAG,mBAAmB,CAAC;AAEpD,QAAA,wBAAwB,GAAiB,MAAM,CAAC,MAAM,CAAC;IAClE,UAAU,EAAE,qCAA6B;IACzC,KAAK,EAAE,8BAA8B;CACtC,CAAC,CAAC;AAEH,uFAAuF;AAC1E,QAAA,mCAAmC,GAAqB,kBAAkB,CAAC;AAQxF,SAAgB,wBAAwB,CAAC,GAAkD;IACzF,MAAM,QAAQ,GAAG,OAAC,CAAC,IAAI,CAAC,yBAAoB,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAEvE,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,2CAAmC;QAChF,WAAW,EAAE,GAAG,EAAE,WAAW,KAAK,KAAK;KACxC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,40 @@
+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 { 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 {
+    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.
+     */
+    verifyKey(ctx: AiCallContext): Promise<AiKeyVerification>;
+    private create;
+    private stream;
+    /** `POST {baseUrl}/embeddings`, floats on the wire. */
+    private embed;
+}
+//# sourceMappingURL=openai-compatible.adapter.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,184 @@
+"use strict";
+// =============================================================================
+// OpenAI-compatible provider adapter (issue #448, epic #421)
+// =============================================================================
+//
+// Any server speaking OpenAI's wire protocol at an administrator-chosen base
+// URL — Ollama, vLLM, LM Studio, llama.cpp's server, a LiteLLM gateway. Like
+// the Azure adapter this is composition over the OpenAI adapter's shared
+// pieces (`../openai/`), not a new mapping:
+//
+//   openai-compatible-settings.ts        the slot's apiStyle / requiresKey
+//   openai-compatible-client.factory.ts  OpenAI SDK per call at `baseUrl`, no
+//                                        redirects, no credential when keyless
+//   ../openai/openai-chat-completions.engine.ts  apiStyle 'chat_completions' (default)
+//   ../openai/openai-responses.engine.ts         apiStyle 'responses'
+//
+// GRACEFUL DEGRADATION. Compatible servers almost always serve Chat
+// Completions and rarely the Responses API, so `chat_completions` is the
+// default and `responses` an opt-in. Chat Completions has no reasoning
+// summaries or effort (an effort is refused), no stored responses and no
+// hosted tools; the adapter's static flags say so for both styles.
+//
+// CLASSIFICATION. `GET {baseUrl}/models` returns ids and nothing about what a
+// model can do, and the ids are whatever the server was loaded with
+// (`llama3.1:8b`, `Qwen/Qwen2.5-7B-Instruct`). `classifyModel` therefore
+// answers `null` for EVERY id: each discovered model is stored
+// `unclassified`, and an administrator declares its capabilities in the
+// Models UI (an `admin_override`) before enabling it. Guessing would be worse.
+//
+// KEYLESS (`requiresKey: false`). The key resolver answers `keySource:
+// 'none'` with the `AI_KEYLESS_API_KEY` marker, and the client factory then
+// sends no credential at all. See docs/specs/ai-platform.md §2.24.
+//
+// PORTS. `responses` and `embeddings` (`POST {baseUrl}/embeddings` — Ollama,
+// vLLM and LM Studio all serve it, through the same mapper OpenAI uses).
+// Images and audio are absent: compatible servers rarely serve them, and
+// presence is the declaration.
+//
+// STORAGE-OBJECT INPUTS (#441). Both modalities `inline` (a base64 `data:`
+// URL): a self-hosted server usually cannot reach this deployment's object
+// storage, and `data:` images are what Ollama and vLLM accept.
+// =============================================================================
+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 OpenAiCompatibleProviderAdapter_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAiCompatibleProviderAdapter = void 0;
+const common_1 = require("@nestjs/common");
+const provider_registry_1 = require("../../core/provider-registry");
+const openai_call_telemetry_1 = require("../openai/openai-call-telemetry");
+const openai_chat_completions_engine_1 = require("../openai/openai-chat-completions.engine");
+const openai_embeddings_mapper_1 = require("../openai/openai-embeddings.mapper");
+const openai_errors_1 = require("../openai/openai-errors");
+const openai_family_guards_1 = require("../openai/openai-family-guards");
+const openai_responses_engine_1 = require("../openai/openai-responses.engine");
+const openai_compatible_client_factory_1 = require("./openai-compatible-client.factory");
+const openai_compatible_settings_1 = require("./openai-compatible-settings");
+let OpenAiCompatibleProviderAdapter = OpenAiCompatibleProviderAdapter_1 = class OpenAiCompatibleProviderAdapter {
+    registry;
+    clients;
+    id = openai_compatible_settings_1.OPENAI_COMPATIBLE_PROVIDER_ID;
+    displayName = 'OpenAI-compatible';
+    /** Chat Completions stores nothing; declared for both styles — see the file header. */
+    supportsPreviousResponseId = false;
+    /** No compatible server is assumed to run hosted tools. */
+    supportsHostedTools = false;
+    /** Inline for both modalities — see the file header. */
+    fileInputStrategy = { image: 'inline', file: 'inline' };
+    responses = {
+        create: (req, ctx) => this.create(req, ctx),
+        stream: (req, ctx) => this.stream(req, ctx),
+    };
+    embeddings = {
+        embed: (req, ctx) => this.embed(req, ctx),
+    };
+    logger = new common_1.Logger(OpenAiCompatibleProviderAdapter_1.name);
+    telemetry = new openai_call_telemetry_1.OpenAiCallTelemetry(openai_compatible_settings_1.OPENAI_COMPATIBLE_FAMILY, this.logger);
+    responsesEngine;
+    chatEngine;
+    constructor(registry, clients) {
+        this.registry = registry;
+        this.clients = clients;
+        const client = (ctx) => this.clients.create(ctx);
+        this.responsesEngine = new openai_responses_engine_1.OpenAiResponsesEngine({
+            family: openai_compatible_settings_1.OPENAI_COMPATIBLE_FAMILY,
+            telemetry: this.telemetry,
+            logger: this.logger,
+            client,
+            classify: () => null,
+        });
+        this.chatEngine = new openai_chat_completions_engine_1.OpenAiChatCompletionsEngine({
+            family: openai_compatible_settings_1.OPENAI_COMPATIBLE_FAMILY,
+            telemetry: this.telemetry,
+            client,
+            // The name every compatible server understands.
+            tokenParameter: 'max_tokens',
+        });
+    }
+    onModuleInit() {
+        this.registry.register(this);
+    }
+    /** Always unclassified — see the file header. */
+    classifyModel() {
+        return null;
+    }
+    async listModels(ctx) {
+        return this.telemetry.call('models.list', undefined, ctx, async () => {
+            const models = [];
+            for await (const model of this.clients.create(ctx).models.list({ signal: ctx.signal })) {
+                models.push({
+                    id: model.id,
+                    ...(model.owned_by ? { ownedBy: model.owned_by } : {}),
+                    ...(typeof model.created === 'number' && model.created > 0
+                        ? { createdAt: new Date(model.created * 1000) }
+                        : {}),
+                });
+            }
+            return models;
+        });
+    }
+    /**
+     * `GET {baseUrl}/models`. For a keyless server this proves the server is
+     * reachable; for any other it also proves the key. Failures are answers.
+     */
+    async verifyKey(ctx) {
+        try {
+            await this.telemetry.call('verify_key', undefined, ctx, async () => {
+                await this.clients.create(ctx).models.list({ signal: ctx.signal });
+            });
+            return { ok: true };
+        }
+        catch (err) {
+            const mapped = (0, openai_errors_1.mapOpenAiError)(err, openai_compatible_settings_1.OPENAI_COMPATIBLE_FAMILY);
+            return mapped.code === 'AI_KEY_INVALID'
+                ? { ok: false, code: 'AI_KEY_INVALID' }
+                : { ok: false, code: mapped.code, detail: mapped.message };
+        }
+    }
+    // ---- responses port -------------------------------------------------------
+    create(req, ctx) {
+        (0, openai_family_guards_1.assertNoHostedTools)(req, this.id);
+        return (0, openai_compatible_settings_1.openAiCompatibleSettings)(ctx.providerSettings).apiStyle === 'responses'
+            ? this.responsesEngine.create(req, ctx)
+            : this.chatEngine.create(req, ctx);
+    }
+    stream(req, ctx) {
+        const run = () => (0, openai_compatible_settings_1.openAiCompatibleSettings)(ctx.providerSettings).apiStyle === 'responses'
+            ? this.responsesEngine.stream(req, ctx)
+            : this.chatEngine.stream(req, ctx);
+        return (async function* () {
+            (0, openai_family_guards_1.assertNoHostedTools)(req, openai_compatible_settings_1.OPENAI_COMPATIBLE_PROVIDER_ID);
+            yield* run();
+        })();
+    }
+    // ---- embeddings port ------------------------------------------------------
+    /** `POST {baseUrl}/embeddings`, floats on the wire. */
+    embed(req, ctx) {
+        return this.telemetry.call('embeddings.create', req.model, ctx, async () => {
+            const { data, request_id } = await this.clients
+                .create(ctx)
+                .embeddings.create((0, openai_embeddings_mapper_1.toOpenAiEmbeddingRequest)(req, openai_compatible_settings_1.OPENAI_COMPATIBLE_FAMILY), { signal: ctx.signal })
+                .withResponse();
+            return (0, openai_embeddings_mapper_1.fromOpenAiEmbeddingResponse)(data, {
+                request: req,
+                providerRequestId: request_id,
+                family: openai_compatible_settings_1.OPENAI_COMPATIBLE_FAMILY,
+            });
+        });
+    }
+};
+exports.OpenAiCompatibleProviderAdapter = OpenAiCompatibleProviderAdapter;
+exports.OpenAiCompatibleProviderAdapter = OpenAiCompatibleProviderAdapter = OpenAiCompatibleProviderAdapter_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [provider_registry_1.AiProviderRegistry,
+        openai_compatible_client_factory_1.OpenAiCompatibleClientFactory])
+], OpenAiCompatibleProviderAdapter);
+//# sourceMappingURL=openai-compatible.adapter.js.map

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * The generic OpenAI-compatible provider (issue #448, epic #421) — Ollama,
+ * vLLM, LM Studio and friends. Being in the module graph is the registration:
+ * `OpenAiCompatibleProviderAdapter.onModuleInit()` adds itself to
+ * `AiProviderRegistry`. Whether it is ENABLED, where the server is and
+ * whether it needs a key are runtime configuration
+ * (`ai.providers['openai-compatible']`), not wiring.
+ *
+ * @stability experimental
+ */
+export declare class OpenAiCompatibleProviderModule {
+}
+//# sourceMappingURL=openai-compatible.module.d.ts.map

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

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

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

@@ -0,0 +1,34 @@
+"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.OpenAiCompatibleProviderModule = void 0;
+const common_1 = require("@nestjs/common");
+const ai_core_module_1 = require("../../core/ai-core.module");
+const openai_compatible_client_factory_1 = require("./openai-compatible-client.factory");
+const openai_compatible_adapter_1 = require("./openai-compatible.adapter");
+/**
+ * The generic OpenAI-compatible provider (issue #448, epic #421) — Ollama,
+ * vLLM, LM Studio and friends. Being in the module graph is the registration:
+ * `OpenAiCompatibleProviderAdapter.onModuleInit()` adds itself to
+ * `AiProviderRegistry`. Whether it is ENABLED, where the server is and
+ * whether it needs a key are runtime configuration
+ * (`ai.providers['openai-compatible']`), not wiring.
+ *
+ * @stability experimental
+ */
+let OpenAiCompatibleProviderModule = class OpenAiCompatibleProviderModule {
+};
+exports.OpenAiCompatibleProviderModule = OpenAiCompatibleProviderModule;
+exports.OpenAiCompatibleProviderModule = OpenAiCompatibleProviderModule = __decorate([
+    (0, common_1.Module)({
+        imports: [ai_core_module_1.AiCoreModule],
+        providers: [openai_compatible_client_factory_1.OpenAiCompatibleClientFactory, openai_compatible_adapter_1.OpenAiCompatibleProviderAdapter],
+        exports: [openai_compatible_adapter_1.OpenAiCompatibleProviderAdapter],
+    })
+], OpenAiCompatibleProviderModule);
+//# sourceMappingURL=openai-compatible.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openai-compatible.module.js","sourceRoot":"","sources":["../../../../src/ai/providers/openai-compatible/openai-compatible.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AAExC,8DAAyD;AACzD,yFAAmF;AACnF,2EAA8E;AAE9E;;;;;;;;;GASG;AAMI,IAAM,8BAA8B,GAApC,MAAM,8BAA8B;CAAG,CAAA;AAAjC,wEAA8B;yCAA9B,8BAA8B;IAL1C,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,6BAAY,CAAC;QACvB,SAAS,EAAE,CAAC,gEAA6B,EAAE,2DAA+B,CAAC;QAC3E,OAAO,EAAE,CAAC,2DAA+B,CAAC;KAC3C,CAAC;GACW,8BAA8B,CAAG"}

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

@@ -0,0 +1,12 @@
+import type { AiProviderDefinition } from '../ai-provider-definition';
+/**
+ * The `openai-compatible` 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-compatible']` and the
+ * admin page are unchanged.
+ *
+ * @stability experimental
+ */
+export declare const openAiCompatibleProviderDefinition: AiProviderDefinition;
+//# sourceMappingURL=openai-compatible.provider-definition.d.ts.map

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

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

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

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openAiCompatibleProviderDefinition = void 0;
+const ai_1 = require("@marinoscar/platform-contract/ai");
+const openai_compatible_module_1 = require("./openai-compatible.module");
+/**
+ * The `openai-compatible` 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-compatible']` and the
+ * admin page are unchanged.
+ *
+ * @stability experimental
+ */
+exports.openAiCompatibleProviderDefinition = {
+    id: 'openai-compatible',
+    label: 'OpenAI-compatible',
+    description: 'Ollama, vLLM, LM Studio or any server speaking the OpenAI wire protocol.',
+    module: openai_compatible_module_1.OpenAiCompatibleProviderModule,
+    settingsSchema: ai_1.systemAiCompatibleProviderSchema.omit({ enabled: true }),
+    defaults: {},
+    requiresKey: true,
+    requiresBaseUrl: true,
+    help: {
+        baseUrl: "The server's API root, including /v1 — e.g. http://ollama:11434/v1 or https://vllm.internal.example.com/v1. Required to enable the provider.",
+    },
+};
+//# sourceMappingURL=openai-compatible.provider-definition.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openai-compatible.provider-definition.js","sourceRoot":"","sources":["../../../../src/ai/providers/openai-compatible/openai-compatible.provider-definition.ts"],"names":[],"mappings":";;;AAAA,yDAAoF;AAGpF,yEAA4E;AAE5E;;;;;;;;GAQG;AACU,QAAA,kCAAkC,GAAyB;IACtE,EAAE,EAAE,mBAAmB;IACvB,KAAK,EAAE,mBAAmB;IAC1B,WAAW,EAAE,0EAA0E;IACvF,MAAM,EAAE,yDAA8B;IACtC,cAAc,EAAE,qCAAgC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACxE,QAAQ,EAAE,EAAE;IACZ,WAAW,EAAE,IAAI;IACjB,eAAe,EAAE,IAAI;IACrB,IAAI,EAAE;QACJ,OAAO,EACL,8IAA8I;KACjJ;CACF,CAAC"}

package/dist/ai/runtime/ai-audio-run-request.d.ts

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+/** The transcription operation. Permanent string (stored in `ai_runs.request`). */
+export declare const AI_TRANSCRIBE_OPERATION = "audio.transcribe";
+/** An ISO-639-1 (or -3) language code, lower case: `en`, `pt`, `yue`. */
+export declare const AI_LANGUAGE_CODE: RegExp;
+export declare const storedAiTranscriptionRunRequestSchema: z.ZodObject<{
+    operation: z.ZodLiteral<"audio.transcribe">;
+    provider: z.ZodString;
+    model: z.ZodString;
+    storageObjectId: z.ZodString;
+    language: z.ZodOptional<z.ZodString>;
+    prompt: z.ZodOptional<z.ZodString>;
+    timestampGranularities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        segment: "segment";
+        word: "word";
+    }>>>;
+    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, z.core.$strip>;
+export type StoredAiTranscriptionRunRequest = z.infer<typeof storedAiTranscriptionRunRequestSchema>;
+/** The stored request, validated on the way back in (a JSONB column is a trust boundary). */
+export declare function parseStoredTranscriptionRunRequest(value: unknown): StoredAiTranscriptionRunRequest;
+/** The speech operation. Permanent string (stored in `ai_runs.request`). */
+export declare const AI_SPEECH_OPERATION = "audio.speech";
+export declare const storedAiSpeechRunRequestSchema: z.ZodObject<{
+    operation: z.ZodLiteral<"audio.speech">;
+    provider: z.ZodString;
+    model: z.ZodString;
+    input: z.ZodString;
+    voice: z.ZodString;
+    format: z.ZodEnum<{
+        mp3: "mp3";
+        wav: "wav";
+        opus: "opus";
+        aac: "aac";
+        flac: "flac";
+        pcm: "pcm";
+    }>;
+    instructions: z.ZodOptional<z.ZodString>;
+    speed: z.ZodOptional<z.ZodNumber>;
+    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, z.core.$strip>;
+export type StoredAiSpeechRunRequest = z.infer<typeof storedAiSpeechRunRequestSchema>;
+/** The stored request, validated on the way back in (a JSONB column is a trust boundary). */
+export declare function parseStoredSpeechRunRequest(value: unknown): StoredAiSpeechRunRequest;
+//# sourceMappingURL=ai-audio-run-request.d.ts.map

package/dist/ai/runtime/ai-audio-run-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-audio-run-request.d.ts","sourceRoot":"","sources":["../../../src/ai/runtime/ai-audio-run-request.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,mFAAmF;AACnF,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAE1D,yEAAyE;AACzE,eAAO,MAAM,gBAAgB,QAAiB,CAAC;AAE/C,eAAO,MAAM,qCAAqC;;;;;;;;;;;;iBAUhD,CAAC;AAEH,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AAEpG,6FAA6F;AAC7F,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,OAAO,GAAG,+BAA+B,CAQlG;AAED,4EAA4E;AAC5E,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAElD,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;iBAazC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,6FAA6F;AAC7F,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,wBAAwB,CAQpF"}

package/dist/ai/runtime/ai-audio-run-request.js

@@ -0,0 +1,76 @@
+"use strict";
+// =============================================================================
+// An audio run's request, as stored in `ai_runs.request` (issues #438, #439)
+// =============================================================================
+//
+// Transcription and speech are ALWAYS background runs (`ai.audio.transcribe`
+// / `ai.audio.speech` jobs): the same `ai_runs` table and `AiRunsService`
+// state machine as every other run, told apart by `request.operation` (see
+// `ai-run-operation.ts`):
+//
+//   'audio.transcribe'   `AiUserClient.transcribe` (#438)
+//   'audio.speech'       `AiUserClient.speak` (#439)
+//
+// INPUT BY REFERENCE. A recording is stored as its storage object id, never
+// as bytes: the job re-resolves it (ownership included — see
+// `AiStorageInputResolver`) and streams it to the provider when it runs.
+// Speech stores the text to speak, the resolved voice and the format, so
+// the job re-issues exactly the call that was gated.
+//
+// ⚠ NEVER KEY MATERIAL — named fields only, exactly as `toStoredRunRequest`.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.storedAiSpeechRunRequestSchema = exports.AI_SPEECH_OPERATION = exports.storedAiTranscriptionRunRequestSchema = exports.AI_LANGUAGE_CODE = exports.AI_TRANSCRIBE_OPERATION = void 0;
+exports.parseStoredTranscriptionRunRequest = parseStoredTranscriptionRunRequest;
+exports.parseStoredSpeechRunRequest = parseStoredSpeechRunRequest;
+const zod_1 = require("zod");
+const ai_error_1 = require("../core/ai-error");
+const media_types_1 = require("../core/types/media.types");
+/** The transcription operation. Permanent string (stored in `ai_runs.request`). */
+exports.AI_TRANSCRIBE_OPERATION = 'audio.transcribe';
+/** An ISO-639-1 (or -3) language code, lower case: `en`, `pt`, `yue`. */
+exports.AI_LANGUAGE_CODE = /^[a-z]{2,3}$/;
+exports.storedAiTranscriptionRunRequestSchema = zod_1.z.object({
+    operation: zod_1.z.literal(exports.AI_TRANSCRIBE_OPERATION),
+    provider: zod_1.z.string().min(1),
+    model: zod_1.z.string().min(1),
+    /** The recording, as a storage object id. */
+    storageObjectId: zod_1.z.string().min(1),
+    language: zod_1.z.string().regex(exports.AI_LANGUAGE_CODE).optional(),
+    prompt: zod_1.z.string().min(1).max(media_types_1.AI_TRANSCRIPTION_PROMPT_MAX_CHARS).optional(),
+    timestampGranularities: zod_1.z.array(zod_1.z.enum(media_types_1.AI_TRANSCRIPTION_TIMESTAMP_GRANULARITIES)).min(1).max(2).optional(),
+    providerOptions: zod_1.z.record(zod_1.z.string(), zod_1.z.record(zod_1.z.string(), zod_1.z.unknown())).optional(),
+});
+/** The stored request, validated on the way back in (a JSONB column is a trust boundary). */
+function parseStoredTranscriptionRunRequest(value) {
+    const parsed = exports.storedAiTranscriptionRunRequestSchema.safeParse(value);
+    if (!parsed.success) {
+        throw new ai_error_1.AiError('AI_INVALID_REQUEST', 'The stored transcription run request is invalid.');
+    }
+    return parsed.data;
+}
+/** The speech operation. Permanent string (stored in `ai_runs.request`). */
+exports.AI_SPEECH_OPERATION = 'audio.speech';
+exports.storedAiSpeechRunRequestSchema = zod_1.z.object({
+    operation: zod_1.z.literal(exports.AI_SPEECH_OPERATION),
+    provider: zod_1.z.string().min(1),
+    model: zod_1.z.string().min(1),
+    /** The text to speak. */
+    input: zod_1.z.string().min(1).max(media_types_1.AI_SPEECH_INPUT_MAX_CHARS),
+    /** The voice, resolved at queue time. */
+    voice: zod_1.z.string().min(1).max(64),
+    /** The audio format, resolved at queue time (default `mp3`). */
+    format: zod_1.z.enum(media_types_1.AI_SPEECH_FORMATS),
+    instructions: zod_1.z.string().min(1).max(media_types_1.AI_SPEECH_INSTRUCTIONS_MAX_CHARS).optional(),
+    speed: zod_1.z.number().min(media_types_1.AI_SPEECH_SPEED_MIN).max(media_types_1.AI_SPEECH_SPEED_MAX).optional(),
+    providerOptions: zod_1.z.record(zod_1.z.string(), zod_1.z.record(zod_1.z.string(), zod_1.z.unknown())).optional(),
+});
+/** The stored request, validated on the way back in (a JSONB column is a trust boundary). */
+function parseStoredSpeechRunRequest(value) {
+    const parsed = exports.storedAiSpeechRunRequestSchema.safeParse(value);
+    if (!parsed.success) {
+        throw new ai_error_1.AiError('AI_INVALID_REQUEST', 'The stored speech run request is invalid.');
+    }
+    return parsed.data;
+}
+//# sourceMappingURL=ai-audio-run-request.js.map

package/dist/ai/runtime/ai-audio-run-request.js.map

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

package/dist/ai/runtime/ai-audio-speech.handler.d.ts

@@ -0,0 +1,22 @@
+import { JobSettledEvent } from '../../jobs/index';
+import { JobExecutionProfile } from '../../jobs/index';
+import { JobHandlerRegistry } from '../../jobs/index';
+import { AiOutputWriter } from '../storage/ai-output-writer';
+import { AiService } from './ai.service';
+import { AiMediaRunHandler, type AiMediaRunContext, type AiMediaRunResult } from './ai-media-run.handler';
+import { AiRunsService } from './ai-runs.service';
+export declare class AiAudioSpeechHandler extends AiMediaRunHandler {
+    private readonly ai;
+    private readonly outputs;
+    readonly type = "ai.audio.speech";
+    readonly label = "AI speech synthesis";
+    readonly profile: JobExecutionProfile;
+    protected readonly operations: readonly ["audio.speech"];
+    protected readonly noun = "speech";
+    constructor(registry: JobHandlerRegistry, ai: AiService, runs: AiRunsService, outputs: AiOutputWriter);
+    onJobSettled(event: JobSettledEvent): Promise<void>;
+    protected execute(ctx: AiMediaRunContext): Promise<AiMediaRunResult | null>;
+    /** The audio as one storage object the user owns. Any failure here is a storage outcome. */
+    private store;
+}
+//# sourceMappingURL=ai-audio-speech.handler.d.ts.map

package/dist/ai/runtime/ai-audio-speech.handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-audio-speech.handler.d.ts","sourceRoot":"","sources":["../../../src/ai/runtime/ai-audio-speech.handler.ts"],"names":[],"mappings":"AAoCA,OAAO,EAAqB,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGtD,OAAO,EAAE,cAAc,EAAyC,MAAM,6BAA6B,CAAC;AAEpG,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1G,OAAO,EAAwB,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGxE,qBACa,oBAAqB,SAAQ,iBAAiB;IAYvD,OAAO,CAAC,QAAQ,CAAC,EAAE;IAEnB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAb1B,QAAQ,CAAC,IAAI,qBAAwB;IACrC,QAAQ,CAAC,KAAK,yBAAyB;IAEvC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAgD;IAErF,SAAS,CAAC,QAAQ,CAAC,UAAU,4BAAkC;IAE/D,SAAS,CAAC,QAAQ,CAAC,IAAI,YAAY;gBAGjC,QAAQ,EAAE,kBAAkB,EACX,EAAE,EAAE,SAAS,EAC9B,IAAI,EAAE,aAAa,EACF,OAAO,EAAE,cAAc;IAMpC,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;cAIzC,OAAO,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAkBjF,4FAA4F;YAC9E,KAAK;CAiCpB"}