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

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

@@ -0,0 +1,205 @@
+"use strict";
+// =============================================================================
+// Azure OpenAI provider adapter (issue #448, epic #421)
+// =============================================================================
+//
+// OpenAI's models behind an Azure resource (data residency, enterprise
+// agreements). Azure speaks OpenAI's wire protocol, so this adapter is
+// composition, not a new mapping: the OpenAI adapter's shared pieces
+// (`../openai/`) with Azure's differences plugged in.
+//
+//   azure-openai-settings.ts        the slot's apiVersion / apiStyle / deployments
+//   azure-openai-client.factory.ts  `AzureOpenAI` per call: endpoint, api-version,
+//                                   `api-key` header, no redirects
+//   ../openai/openai-responses.engine.ts         apiStyle 'responses' (the default)
+//   ../openai/openai-chat-completions.engine.ts  apiStyle 'chat_completions'
+//
+// DEPLOYMENTS. Azure routes by DEPLOYMENT NAME, not model id. A request's
+// model id is looked up in the slot's `deployments` map (model id ->
+// deployment name) and falls back to the id itself — Azure's common
+// convention of naming a deployment after its model. The deployment name is
+// what goes on the wire (`model` in the body; the SDK builds
+// `/deployments/<name>/...` from it for Chat Completions and embeddings);
+// the model id stays what telemetry, usage and the neutral response use.
+//
+// MODEL LIST. `GET /openai/models` is always called (it is also how a key is
+// verified). When a `deployments` map is configured, ITS KEYS are the model
+// list — Azure's data plane cannot enumerate a resource's deployments, and
+// the listing it does return names every model the region offers, deployed
+// or not. Without a map the listing is returned as-is and the administrator
+// enables what is actually deployed.
+//
+// CLASSIFICATION. Azure models are OpenAI models, so model ids classify with
+// OpenAI's own table (`classifyOpenAiModel`) minus `hosted_tools`, which this
+// adapter does not run; an id the table does not know (`gpt-35-turbo`, a
+// custom map key) is `null` — unclassified — for an administrator to decide.
+//
+// FLAGS (static, conservative — see docs/specs/ai-platform.md §2.24):
+//   - `supportsPreviousResponseId: false`. Azure's Responses API does store
+//     responses, but a flag is per ADAPTER while `apiStyle` is per slot, and
+//     the Chat Completions style cannot chain; declaring `false` means the
+//     tool loop always resends the full history, which works in both styles.
+//   - `supportsHostedTools: false`. Azure's hosted-tool coverage varies by
+//     region and api-version; none is mapped. A hosted tool reaching the port
+//     directly is refused with AI_CAPABILITY_UNSUPPORTED.
+//
+// PORTS. `responses` and `embeddings`. Images and audio are deliberately
+// absent for now (their Azure routing differs per api-version); presence is
+// the declaration, so the registry stays truthful.
+//
+// STORAGE-OBJECT INPUTS (#441). Images by `presigned_url` (Azure fetches the
+// signed URL), files `inline` (base64 `file_data`) — both engines deliver
+// both, and nothing is uploaded to Azure, so nothing needs deleting.
+// =============================================================================
+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 AzureOpenAiProviderAdapter_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AzureOpenAiProviderAdapter = 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_model_catalog_1 = require("../openai/openai-model-catalog");
+const openai_responses_engine_1 = require("../openai/openai-responses.engine");
+const azure_openai_client_factory_1 = require("./azure-openai-client.factory");
+const azure_openai_settings_1 = require("./azure-openai-settings");
+let AzureOpenAiProviderAdapter = AzureOpenAiProviderAdapter_1 = class AzureOpenAiProviderAdapter {
+    registry;
+    clients;
+    id = azure_openai_settings_1.AZURE_OPENAI_PROVIDER_ID;
+    displayName = 'Azure OpenAI';
+    /** Static and conservative — see the file header. */
+    supportsPreviousResponseId = false;
+    /** No hosted tool is mapped for Azure — see the file header. */
+    supportsHostedTools = false;
+    /** Images by presigned URL, files inline — see the file header. */
+    fileInputStrategy = { image: 'presigned_url', 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(AzureOpenAiProviderAdapter_1.name);
+    telemetry = new openai_call_telemetry_1.OpenAiCallTelemetry(azure_openai_settings_1.AZURE_OPENAI_FAMILY, this.logger);
+    responsesEngine;
+    chatEngine;
+    constructor(registry, clients) {
+        this.registry = registry;
+        this.clients = clients;
+        const client = (ctx) => this.clients.create(ctx, (0, azure_openai_settings_1.azureOpenAiSettings)(ctx.providerSettings));
+        this.responsesEngine = new openai_responses_engine_1.OpenAiResponsesEngine({
+            family: azure_openai_settings_1.AZURE_OPENAI_FAMILY,
+            telemetry: this.telemetry,
+            logger: this.logger,
+            client,
+            classify: (modelId) => this.classifyModel(modelId),
+        });
+        this.chatEngine = new openai_chat_completions_engine_1.OpenAiChatCompletionsEngine({
+            family: azure_openai_settings_1.AZURE_OPENAI_FAMILY,
+            telemetry: this.telemetry,
+            client,
+            // Azure's current name for the limit, and the only one its reasoning deployments accept.
+            tokenParameter: 'max_completion_tokens',
+        });
+    }
+    onModuleInit() {
+        this.registry.register(this);
+    }
+    classifyModel(modelId) {
+        const caps = (0, openai_model_catalog_1.classifyOpenAiModel)(modelId);
+        if (!caps)
+            return null;
+        return { ...caps, capabilities: caps.capabilities.filter((capability) => capability !== 'hosted_tools') };
+    }
+    async listModels(ctx) {
+        return this.telemetry.call('models.list', undefined, ctx, async () => {
+            const settings = (0, azure_openai_settings_1.azureOpenAiSettings)(ctx.providerSettings);
+            const client = this.clients.create(ctx, settings);
+            const listed = [];
+            for await (const model of client.models.list({ signal: ctx.signal })) {
+                listed.push({
+                    id: model.id,
+                    ...(model.owned_by ? { ownedBy: model.owned_by } : {}),
+                    ...(typeof model.created === 'number' ? { createdAt: new Date(model.created * 1000) } : {}),
+                });
+            }
+            const configured = Object.keys(settings.deployments);
+            return configured.length > 0 ? configured.map((id) => ({ id })) : listed;
+        });
+    }
+    /**
+     * `GET /openai/models` with the key. A rejected key is an ANSWER, 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 () => {
+                await this.clients.create(ctx, (0, azure_openai_settings_1.azureOpenAiSettings)(ctx.providerSettings)).models.list({ signal: ctx.signal });
+            });
+            return { ok: true };
+        }
+        catch (err) {
+            const mapped = (0, openai_errors_1.mapOpenAiError)(err, azure_openai_settings_1.AZURE_OPENAI_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);
+        const settings = (0, azure_openai_settings_1.azureOpenAiSettings)(ctx.providerSettings);
+        const opts = { wireModel: (0, azure_openai_settings_1.azureDeploymentFor)(settings, req.model) };
+        return settings.apiStyle === 'chat_completions'
+            ? this.chatEngine.create(req, ctx, opts)
+            : this.responsesEngine.create(req, ctx, opts);
+    }
+    stream(req, ctx) {
+        const settings = (0, azure_openai_settings_1.azureOpenAiSettings)(ctx.providerSettings);
+        const opts = { wireModel: (0, azure_openai_settings_1.azureDeploymentFor)(settings, req.model) };
+        const run = () => settings.apiStyle === 'chat_completions'
+            ? this.chatEngine.stream(req, ctx, opts)
+            : this.responsesEngine.stream(req, ctx, opts);
+        return (async function* () {
+            (0, openai_family_guards_1.assertNoHostedTools)(req, azure_openai_settings_1.AZURE_OPENAI_PROVIDER_ID);
+            yield* run();
+        })();
+    }
+    // ---- embeddings port ------------------------------------------------------
+    /** `POST /openai/deployments/<deployment>/embeddings`, floats on the wire. */
+    embed(req, ctx) {
+        return this.telemetry.call('embeddings.create', req.model, ctx, async () => {
+            const settings = (0, azure_openai_settings_1.azureOpenAiSettings)(ctx.providerSettings);
+            const body = { ...(0, openai_embeddings_mapper_1.toOpenAiEmbeddingRequest)(req, azure_openai_settings_1.AZURE_OPENAI_FAMILY), model: (0, azure_openai_settings_1.azureDeploymentFor)(settings, req.model) };
+            const { data, request_id } = await this.clients
+                .create(ctx, settings)
+                .embeddings.create(body, { signal: ctx.signal })
+                .withResponse();
+            return (0, openai_embeddings_mapper_1.fromOpenAiEmbeddingResponse)(data, {
+                request: req,
+                providerRequestId: request_id,
+                family: azure_openai_settings_1.AZURE_OPENAI_FAMILY,
+            });
+        });
+    }
+};
+exports.AzureOpenAiProviderAdapter = AzureOpenAiProviderAdapter;
+exports.AzureOpenAiProviderAdapter = AzureOpenAiProviderAdapter = AzureOpenAiProviderAdapter_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [provider_registry_1.AiProviderRegistry,
+        azure_openai_client_factory_1.AzureOpenAiClientFactory])
+], AzureOpenAiProviderAdapter);
+//# sourceMappingURL=azure-openai.adapter.js.map

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * The Azure OpenAI provider (issue #448, epic #421). Being in the module graph
+ * is the registration: `AzureOpenAiProviderAdapter.onModuleInit()` adds itself
+ * to `AiProviderRegistry`. Whether the provider is ENABLED, where its
+ * resource is and which deployments it serves are runtime configuration
+ * (`ai.providers['azure-openai']`), not wiring.
+ *
+ * @stability experimental
+ */
+export declare class AzureOpenAiProviderModule {
+}
+//# sourceMappingURL=azure-openai.module.d.ts.map

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

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

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

@@ -0,0 +1,33 @@
+"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.AzureOpenAiProviderModule = void 0;
+const common_1 = require("@nestjs/common");
+const ai_core_module_1 = require("../../core/ai-core.module");
+const azure_openai_client_factory_1 = require("./azure-openai-client.factory");
+const azure_openai_adapter_1 = require("./azure-openai.adapter");
+/**
+ * The Azure OpenAI provider (issue #448, epic #421). Being in the module graph
+ * is the registration: `AzureOpenAiProviderAdapter.onModuleInit()` adds itself
+ * to `AiProviderRegistry`. Whether the provider is ENABLED, where its
+ * resource is and which deployments it serves are runtime configuration
+ * (`ai.providers['azure-openai']`), not wiring.
+ *
+ * @stability experimental
+ */
+let AzureOpenAiProviderModule = class AzureOpenAiProviderModule {
+};
+exports.AzureOpenAiProviderModule = AzureOpenAiProviderModule;
+exports.AzureOpenAiProviderModule = AzureOpenAiProviderModule = __decorate([
+    (0, common_1.Module)({
+        imports: [ai_core_module_1.AiCoreModule],
+        providers: [azure_openai_client_factory_1.AzureOpenAiClientFactory, azure_openai_adapter_1.AzureOpenAiProviderAdapter],
+        exports: [azure_openai_adapter_1.AzureOpenAiProviderAdapter],
+    })
+], AzureOpenAiProviderModule);
+//# sourceMappingURL=azure-openai.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"azure-openai.module.js","sourceRoot":"","sources":["../../../../src/ai/providers/azure-openai/azure-openai.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AAExC,8DAAyD;AACzD,+EAAyE;AACzE,iEAAoE;AAEpE;;;;;;;;GAQG;AAMI,IAAM,yBAAyB,GAA/B,MAAM,yBAAyB;CAAG,CAAA;AAA5B,8DAAyB;oCAAzB,yBAAyB;IALrC,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,6BAAY,CAAC;QACvB,SAAS,EAAE,CAAC,sDAAwB,EAAE,iDAA0B,CAAC;QACjE,OAAO,EAAE,CAAC,iDAA0B,CAAC;KACtC,CAAC;GACW,yBAAyB,CAAG"}

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

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

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

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

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

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.azureOpenAiProviderDefinition = void 0;
+const ai_1 = require("@marinoscar/platform-contract/ai");
+const azure_openai_module_1 = require("./azure-openai.module");
+/**
+ * The `azure-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['azure-openai']` and the
+ * admin page are unchanged.
+ *
+ * @stability experimental
+ */
+exports.azureOpenAiProviderDefinition = {
+    id: 'azure-openai',
+    label: 'Azure OpenAI',
+    description: 'OpenAI models served from an Azure OpenAI resource.',
+    module: azure_openai_module_1.AzureOpenAiProviderModule,
+    settingsSchema: ai_1.systemAiAzureProviderSchema.omit({ enabled: true }),
+    defaults: {},
+    requiresKey: true,
+    requiresBaseUrl: true,
+    help: {
+        baseUrl: 'Your Azure OpenAI resource endpoint, e.g. https://my-resource.openai.azure.com. Must use https. Required to enable the provider.',
+    },
+};
+//# sourceMappingURL=azure-openai.provider-definition.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"azure-openai.provider-definition.js","sourceRoot":"","sources":["../../../../src/ai/providers/azure-openai/azure-openai.provider-definition.ts"],"names":[],"mappings":";;;AAAA,yDAA+E;AAG/E,+DAAkE;AAElE;;;;;;;;GAQG;AACU,QAAA,6BAA6B,GAAyB;IACjE,EAAE,EAAE,cAAc;IAClB,KAAK,EAAE,cAAc;IACrB,WAAW,EAAE,qDAAqD;IAClE,MAAM,EAAE,+CAAyB;IACjC,cAAc,EAAE,gCAA2B,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACnE,QAAQ,EAAE,EAAE;IACZ,WAAW,EAAE,IAAI;IACjB,eAAe,EAAE,IAAI;IACrB,IAAI,EAAE;QACJ,OAAO,EACL,kIAAkI;KACrI;CACF,CAAC"}

package/dist/ai/providers/builtin-ai-providers.d.ts

@@ -0,0 +1,8 @@
+import { type AiProviderDefinition } from './ai-provider-definition';
+/**
+ * The built-in providers, in registration (and admin page) order.
+ *
+ * @stability experimental
+ */
+export declare const BUILTIN_AI_PROVIDER_DEFINITIONS: readonly AiProviderDefinition[];
+//# sourceMappingURL=builtin-ai-providers.d.ts.map

package/dist/ai/providers/builtin-ai-providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-ai-providers.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/builtin-ai-providers.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAsC,KAAK,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAMzG;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,EAAE,SAAS,oBAAoB,EAMzE,CAAC"}

package/dist/ai/providers/builtin-ai-providers.js

@@ -0,0 +1,41 @@
+"use strict";
+// =============================================================================
+// The five built-in AI providers, registered (PP-14.6, #924)
+// =============================================================================
+//
+// They register through `registerAiProvider`, the same function an app uses,
+// at import time and in the order the admin page lists them. Anything that
+// reads the registry (`AiModule.forRoot`, the `ai` settings namespace, the
+// config services) imports this file first, so the built-ins are always
+// there regardless of which entry point loaded the slice.
+//
+// IDEMPOTENT ACROSS DUPLICATE MODULE INSTANCES: a provider already registered
+// is skipped, so two copies of this file (a bundler, a test double) cannot
+// make the second registration throw `DUPLICATE_ID`. The registry is frozen
+// once the application bootstraps, and nothing registers after that.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BUILTIN_AI_PROVIDER_DEFINITIONS = void 0;
+const anthropic_provider_definition_1 = require("./anthropic/anthropic.provider-definition");
+const ai_provider_definition_1 = require("./ai-provider-definition");
+const azure_openai_provider_definition_1 = require("./azure-openai/azure-openai.provider-definition");
+const gemini_provider_definition_1 = require("./gemini/gemini.provider-definition");
+const openai_provider_definition_1 = require("./openai/openai.provider-definition");
+const openai_compatible_provider_definition_1 = require("./openai-compatible/openai-compatible.provider-definition");
+/**
+ * The built-in providers, in registration (and admin page) order.
+ *
+ * @stability experimental
+ */
+exports.BUILTIN_AI_PROVIDER_DEFINITIONS = Object.freeze([
+    openai_provider_definition_1.openAiProviderDefinition,
+    anthropic_provider_definition_1.anthropicProviderDefinition,
+    gemini_provider_definition_1.geminiProviderDefinition,
+    azure_openai_provider_definition_1.azureOpenAiProviderDefinition,
+    openai_compatible_provider_definition_1.openAiCompatibleProviderDefinition,
+]);
+for (const definition of exports.BUILTIN_AI_PROVIDER_DEFINITIONS) {
+    if (!ai_provider_definition_1.aiProviderKind.has(definition.id))
+        (0, ai_provider_definition_1.registerAiProvider)(definition);
+}
+//# sourceMappingURL=builtin-ai-providers.js.map

package/dist/ai/providers/builtin-ai-providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-ai-providers.js","sourceRoot":"","sources":["../../../src/ai/providers/builtin-ai-providers.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,6DAA6D;AAC7D,gFAAgF;AAChF,EAAE;AACF,6EAA6E;AAC7E,2EAA2E;AAC3E,2EAA2E;AAC3E,wEAAwE;AACxE,0DAA0D;AAC1D,EAAE;AACF,8EAA8E;AAC9E,2EAA2E;AAC3E,4EAA4E;AAC5E,qEAAqE;AACrE,gFAAgF;;;AAEhF,6FAAwF;AACxF,qEAAyG;AACzG,sGAAgG;AAChG,oFAA+E;AAC/E,oFAA+E;AAC/E,qHAA+G;AAE/G;;;;GAIG;AACU,QAAA,+BAA+B,GAAoC,MAAM,CAAC,MAAM,CAAC;IAC5F,qDAAwB;IACxB,2DAA2B;IAC3B,qDAAwB;IACxB,gEAA6B;IAC7B,0EAAkC;CACnC,CAAC,CAAC;AAEH,KAAK,MAAM,UAAU,IAAI,uCAA+B,EAAE,CAAC;IACzD,IAAI,CAAC,uCAAc,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QAAE,IAAA,2CAAkB,EAAC,UAAU,CAAC,CAAC;AACzE,CAAC"}

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

@@ -0,0 +1,23 @@
+import { GoogleGenAI } from '@google/genai';
+import type { AiCallContext } from '../../core/provider-adapter.interface';
+export declare const GEMINI_DEFAULT_BASE_URL = "https://generativelanguage.googleapis.com";
+export declare const GEMINI_API_VERSION = "v1beta";
+/** A generous ceiling for one request; long thinking turns take minutes. */
+export declare const GEMINI_DEFAULT_TIMEOUT_MS: number;
+/** The `fetch` the SDK uses. Tests inject a mocked one; production uses the global. */
+export type GeminiFetch = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+export interface GeminiClientOptions {
+    fetch?: GeminiFetch;
+    timeoutMs?: number;
+}
+/** DI token for `GeminiClientOptions` (optional; tests and forks provide it). */
+export declare const GEMINI_CLIENT_OPTIONS: unique symbol;
+export declare class GeminiClientFactory {
+    private readonly options;
+    constructor(options?: GeminiClientOptions);
+    /** The timeout every request of a client from this factory carries. */
+    get timeoutMs(): number;
+    /** The SDK client for one call. Throws `AI_KEY_INVALID` for an empty key. */
+    create(ctx: AiCallContext): GoogleGenAI;
+}
+//# sourceMappingURL=gemini-client.factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gemini-client.factory.d.ts","sourceRoot":"","sources":["../../../../src/ai/providers/gemini/gemini-client.factory.ts"],"names":[],"mappings":"AAuCA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAI5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAG3E,eAAO,MAAM,uBAAuB,8CAA8C,CAAC;AAEnF,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAE3C,4EAA4E;AAC5E,eAAO,MAAM,yBAAyB,QAAiB,CAAC;AAExD,uFAAuF;AACvF,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE9F,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,eAAkC,CAAC;AAErE,qBACa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;gBAES,OAAO,CAAC,EAAE,mBAAmB;IAIpF,uEAAuE;IACvE,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,6EAA6E;IAC7E,MAAM,CAAC,GAAG,EAAE,aAAa,GAAG,WAAW;CAmBxC"}

package/dist/ai/providers/gemini/gemini-client.factory.js

@@ -0,0 +1,100 @@
+"use strict";
+// =============================================================================
+// Google Gen AI SDK client factory (issue #447, epic #421)
+// =============================================================================
+//
+// One client PER CALL, built from that call's `AiCallContext` — the same
+// shape as `OpenAiClientFactory` and `AnthropicClientFactory`, for the same
+// reason: the key is resolved per call (org key or the user's own).
+//
+// EVERYTHING THE SDK WOULD DISCOVER ON ITS OWN IS PINNED. `@google/genai`
+// reads a surprising amount of ambient configuration, and none of it may
+// decide which account or endpoint a call uses (there is no Gemini
+// configuration in this application's environment — docs/specs/ai-platform.md
+// §2.1):
+//
+//   GOOGLE_GENAI_USE_VERTEXAI / _ENTERPRISE  -> `vertexai: false`: always the
+//                                               Gemini Developer API, never a
+//                                               Vertex project's ADC
+//   GOOGLE_API_KEY / GEMINI_API_KEY          -> `apiKey` always passed (an
+//                                               empty key is refused first)
+//   GOOGLE_GEMINI_BASE_URL                   -> `httpOptions.baseUrl` always
+//                                               passed
+//   GOOGLE_CLOUD_PROJECT / _LOCATION         -> unused off Vertex
+//
+// NO RETRIES. The SDK retries only when `httpOptions.retryOptions` is set, and
+// it never is: retries are the caller's job (the queue for a job, the user
+// for an interactive call), and an SDK retrying a 429 underneath would
+// multiply every attempt and hide the throttle from `toRateLimitError()`.
+//
+// The API version is pinned to `v1beta`, where every feature this adapter
+// maps (thinking config, `responseJsonSchema`, `thoughtSignature`) lives.
+//
+// TIMEOUT. `httpOptions.timeout` bounds each request, and the SDK aborts it
+// with the same `AbortError` a caller's signal raises — `mapGeminiError`
+// tells the two apart by whether the CALLER's signal fired. Setting it also
+// makes the SDK raise (never lower) the process-wide undici header/body
+// timeouts to match, so a long non-streaming thinking turn is not cut off by
+// undici's five-minute default first.
+// =============================================================================
+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 __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GeminiClientFactory = exports.GEMINI_CLIENT_OPTIONS = exports.GEMINI_DEFAULT_TIMEOUT_MS = exports.GEMINI_API_VERSION = exports.GEMINI_DEFAULT_BASE_URL = void 0;
+const genai_1 = require("@google/genai");
+const common_1 = require("@nestjs/common");
+const ai_error_1 = require("../../core/ai-error");
+const gemini_errors_1 = require("./gemini-errors");
+exports.GEMINI_DEFAULT_BASE_URL = 'https://generativelanguage.googleapis.com';
+exports.GEMINI_API_VERSION = 'v1beta';
+/** A generous ceiling for one request; long thinking turns take minutes. */
+exports.GEMINI_DEFAULT_TIMEOUT_MS = 10 * 60 * 1000;
+/** DI token for `GeminiClientOptions` (optional; tests and forks provide it). */
+exports.GEMINI_CLIENT_OPTIONS = Symbol('GEMINI_CLIENT_OPTIONS');
+let GeminiClientFactory = class GeminiClientFactory {
+    options;
+    constructor(options) {
+        this.options = options ?? {};
+    }
+    /** The timeout every request of a client from this factory carries. */
+    get timeoutMs() {
+        return this.options.timeoutMs ?? exports.GEMINI_DEFAULT_TIMEOUT_MS;
+    }
+    /** The SDK client for one call. Throws `AI_KEY_INVALID` for an empty key. */
+    create(ctx) {
+        if (!ctx.apiKey || ctx.apiKey.trim().length === 0) {
+            throw new ai_error_1.AiError('AI_KEY_INVALID', 'No Google Gemini API key was supplied.', {
+                details: { provider: gemini_errors_1.GEMINI_PROVIDER_ID },
+            });
+        }
+        return new genai_1.GoogleGenAI({
+            vertexai: false,
+            apiKey: ctx.apiKey,
+            apiVersion: exports.GEMINI_API_VERSION,
+            httpOptions: {
+                baseUrl: ctx.baseUrl ?? exports.GEMINI_DEFAULT_BASE_URL,
+                apiVersion: exports.GEMINI_API_VERSION,
+                timeout: this.timeoutMs,
+                ...(this.options.fetch ? { fetch: this.options.fetch } : {}),
+            },
+        });
+    }
+};
+exports.GeminiClientFactory = GeminiClientFactory;
+exports.GeminiClientFactory = GeminiClientFactory = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Optional)()),
+    __param(0, (0, common_1.Inject)(exports.GEMINI_CLIENT_OPTIONS)),
+    __metadata("design:paramtypes", [Object])
+], GeminiClientFactory);
+//# sourceMappingURL=gemini-client.factory.js.map

package/dist/ai/providers/gemini/gemini-client.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini-client.factory.js","sourceRoot":"","sources":["../../../../src/ai/providers/gemini/gemini-client.factory.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,2DAA2D;AAC3D,gFAAgF;AAChF,EAAE;AACF,yEAAyE;AACzE,4EAA4E;AAC5E,oEAAoE;AACpE,EAAE;AACF,0EAA0E;AAC1E,yEAAyE;AACzE,mEAAmE;AACnE,8EAA8E;AAC9E,SAAS;AACT,EAAE;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,qEAAqE;AACrE,2EAA2E;AAC3E,4EAA4E;AAC5E,6EAA6E;AAC7E,uDAAuD;AACvD,kEAAkE;AAClE,EAAE;AACF,+EAA+E;AAC/E,2EAA2E;AAC3E,uEAAuE;AACvE,0EAA0E;AAC1E,EAAE;AACF,0EAA0E;AAC1E,0EAA0E;AAC1E,EAAE;AACF,4EAA4E;AAC5E,yEAAyE;AACzE,4EAA4E;AAC5E,wEAAwE;AACxE,6EAA6E;AAC7E,sCAAsC;AACtC,gFAAgF;;;;;;;;;;;;;;;AAEhF,yCAA4C;AAC5C,2CAA8D;AAE9D,kDAA8C;AAE9C,mDAAqD;AAExC,QAAA,uBAAuB,GAAG,2CAA2C,CAAC;AAEtE,QAAA,kBAAkB,GAAG,QAAQ,CAAC;AAE3C,4EAA4E;AAC/D,QAAA,yBAAyB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAUxD,iFAAiF;AACpE,QAAA,qBAAqB,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAC;AAG9D,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IACb,OAAO,CAAsB;IAE9C,YAAuD,OAA6B;QAClF,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED,uEAAuE;IACvE,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,iCAAyB,CAAC;IAC7D,CAAC;IAED,6EAA6E;IAC7E,MAAM,CAAC,GAAkB;QACvB,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,kBAAO,CAAC,gBAAgB,EAAE,wCAAwC,EAAE;gBAC5E,OAAO,EAAE,EAAE,QAAQ,EAAE,kCAAkB,EAAE;aAC1C,CAAC,CAAC;QACL,CAAC;QAED,OAAO,IAAI,mBAAW,CAAC;YACrB,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,UAAU,EAAE,0BAAkB;YAC9B,WAAW,EAAE;gBACX,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,+BAAuB;gBAC/C,UAAU,EAAE,0BAAkB;gBAC9B,OAAO,EAAE,IAAI,CAAC,SAAS;gBACvB,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC7D;SACF,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AAhCY,kDAAmB;8BAAnB,mBAAmB;IAD/B,IAAA,mBAAU,GAAE;IAIE,WAAA,IAAA,iBAAQ,GAAE,CAAA;IAAE,WAAA,IAAA,eAAM,EAAC,6BAAqB,CAAC,CAAA;;GAH3C,mBAAmB,CAgC/B"}

package/dist/ai/providers/gemini/gemini-content.mapper.d.ts

@@ -0,0 +1,98 @@
+import type { Content, FinishReason, GenerateContentConfig, GenerateContentResponse, GenerateContentResponseUsageMetadata, Part } from '@google/genai';
+import type { AiStorageInputModality } from '../../core/types/file-inputs.types';
+import { type AiFinishReason, type AiOutputItem, type AiReasoningItem, type AiResponse, type AiResponseRequest, type AiStreamEvent, type AiUsage } from '../../core/types/responses.types';
+import { type GeminiModelProfile } from './gemini-model-catalog';
+/** The parameters of one `generateContent` / `generateContentStream` call, minus the signal. */
+export interface GeminiRequest {
+    model: string;
+    contents: Content[];
+    config: GenerateContentConfig;
+}
+/** Which part a replayed `thoughtSignature` belongs on (see REPLAY above). */
+export type GeminiSignatureTarget = 'thought' | 'text' | 'function_call';
+/** What `AI_PROVIDER_STATE.data` holds for a Gemini reasoning item. */
+export interface GeminiReasoningState {
+    signature: string;
+    target: GeminiSignatureTarget;
+    /** `target: 'function_call'` only: the call the signature belongs to. */
+    callId?: string;
+}
+/** The prefix of a call id this adapter made up for an id-less Gemini call. */
+export declare const GEMINI_SYNTHETIC_CALL_ID_PREFIX = "gemini_call_";
+/**
+ * How one storage-object input reached Gemini (#441): its bytes, read under
+ * the runtime's cap, sent inline. Nothing is uploaded, so nothing is deleted.
+ */
+export interface GeminiStorageDelivery {
+    modality: AiStorageInputModality;
+    mimeType: string;
+    filename: string;
+    data: Uint8Array;
+}
+/** Deliveries keyed by storage object id. */
+export type GeminiStorageDeliveries = ReadonlyMap<string, GeminiStorageDelivery>;
+/** The MIME type a URL's path extension names, or `undefined` (Gemini then decides). */
+export declare function geminiMimeTypeFromUrl(url: string): string | undefined;
+/** Every storage object id `req` names, in order, each once. */
+export declare function geminiStorageObjectIds(req: AiResponseRequest): string[];
+/** The Gemini state an item carries, or `undefined` for another provider's / none. */
+export declare function geminiReasoningState(item: AiReasoningItem): GeminiReasoningState | undefined;
+/**
+ * A function's output as Gemini's `functionResponse.response` (a JSON object):
+ * a JSON object output is sent as-is; anything else — JSON or plain text — is
+ * wrapped as `{ output }`, the key Gemini documents for a function's output.
+ */
+export declare function geminiFunctionResponse(output: string): Record<string, unknown>;
+/**
+ * Builds the Gemini request for `req`.
+ *
+ * `profile` is the model's classifier profile (or `null` when unclassified);
+ * `storage` is what the adapter delivered for each storage-object part.
+ * Throws `AiError` (never an SDK error): see the file header.
+ */
+export declare function toGeminiRequest(req: AiResponseRequest, profile: GeminiModelProfile | null, storage?: GeminiStorageDeliveries): GeminiRequest;
+/**
+ * Turns response parts into our output items, in order — incrementally, so
+ * the stream mapper can emit deltas as parts arrive, and `create` feeds it a
+ * whole response at once. Consecutive text parts are ONE message item and
+ * consecutive thought parts ONE reasoning item (a stream splits one logical
+ * part across many chunks); a function call closes whatever is open.
+ */
+export declare class GeminiOutputAssembler {
+    readonly items: AiOutputItem[];
+    private open;
+    private pendingSignature;
+    /** Consumes one part; returns the deltas and completed items it produced. */
+    push(part: Part): AiStreamEvent[];
+    /** Closes whatever is open; call once, after the last part. */
+    finish(): AiStreamEvent[];
+    private attachSignature;
+    private done;
+    private close;
+    private functionCall;
+}
+/** Usage, normalised: output includes thinking tokens, as OpenAI's and Anthropic's do. */
+export declare function geminiUsage(usage: GenerateContentResponseUsageMetadata | null | undefined): AiUsage;
+/** Our finish reason for Gemini's (a candidate's `finishReason`, or a blocked prompt). */
+export declare function geminiFinishReason(finishReason: FinishReason | string | null | undefined, output: AiOutputItem[], promptBlocked?: boolean): AiFinishReason;
+export interface GeminiResponseParts {
+    id: string;
+    model: string;
+    output: AiOutputItem[];
+    finishReason: FinishReason | string | null | undefined;
+    promptBlocked: boolean;
+    usage: AiUsage;
+}
+/**
+ * The `AiResponse` for mapped parts — shared by `create` and the stream. When
+ * the request asked for structured output and the model finished its turn,
+ * the text is validated with `parseStructured` (a mismatch throws
+ * `AI_STRUCTURED_OUTPUT_INVALID`); a filtered answer to a structured request
+ * throws `AI_CONTENT_FILTERED`, since there is nothing to parse.
+ */
+export declare function finishGeminiResponse(parts: GeminiResponseParts, request: AiResponseRequest): AiResponse;
+/** An id for a response Gemini did not name. */
+export declare function geminiFallbackResponseId(): string;
+/** Maps a finished `GenerateContentResponse` to an `AiResponse`. */
+export declare function fromGeminiResponse(response: GenerateContentResponse, request: AiResponseRequest): AiResponse;
+//# sourceMappingURL=gemini-content.mapper.d.ts.map

package/dist/ai/providers/gemini/gemini-content.mapper.d.ts.map

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