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

package/dist/ai/config/ai-admin.controller.d.ts

@@ -0,0 +1,524 @@
+import { AiConfigAdminService } from './ai-config-admin.service';
+import { AiModelsAdminService } from './ai-models-admin.service';
+import { AiProviderTestService } from './ai-provider-test.service';
+import { AiCapabilitiesResponseDto } from './dto/ai-capabilities.dto';
+import { AiModelListQueryDto, RefreshAiCatalogDto, UpdateAiModelDto } from './dto/ai-model.dto';
+import { RemoveAiProviderKeyDto, SetAiProviderKeyDto } from './dto/ai-provider-key.dto';
+import { TestAiProviderDto } from './dto/ai-provider-test.dto';
+import { UpdateAiConfigDto } from './dto/update-ai-config.dto';
+/**
+ * Exported for the reference app's wiring and tests (route discovery, contract
+ * and egress suites); not part of the slice's documented surface.
+ *
+ * @internal
+ */
+export declare class AiAdminController {
+    private readonly admin;
+    private readonly providerTest;
+    private readonly models;
+    constructor(admin: AiConfigAdminService, providerTest: AiProviderTestService, models: AiModelsAdminService);
+    getConfig(): Promise<{
+        enabled: boolean;
+        keyPolicy: "byok" | "byok_with_org_fallback";
+        logPromptContent: boolean;
+        defaults: {
+            maxOutputTokensCap: number | null;
+            allowBackgroundRuns: boolean;
+            allowRealtime: boolean;
+        };
+        usageRetentionDays: number;
+        hostedTools: {
+            web_search: boolean;
+            file_search: boolean;
+            code_interpreter: boolean;
+            image_generation: boolean;
+            mcp: boolean;
+            mcpAllowedHosts: string[];
+        };
+        limits: {
+            perUser?: {
+                requestsPerMinute?: number | undefined;
+                requestsPerDay?: number | undefined;
+            } | undefined;
+            orgKey?: {
+                requestsPerDayPerUser?: number | undefined;
+                tokensPerDayPerUser?: number | undefined;
+            } | undefined;
+            perOrg?: {
+                requestsPerDay?: number | undefined;
+                outputTokensPerDay?: number | undefined;
+            } | undefined;
+            perModel?: Record<string, {
+                maxOutputTokens?: number | undefined;
+                requestsPerMinutePerUser?: number | undefined;
+            }> | undefined;
+        };
+        deploymentKeyServesOrgs: boolean;
+        providers: {
+            id: string;
+            displayName: string;
+            registered: boolean;
+            enabled: boolean;
+            baseUrl: string | null;
+            settingsFields: string[];
+            settings: Record<string, unknown>;
+            requiresBaseUrl: boolean;
+            apiVersion: string | null;
+            apiStyle: "responses" | "chat_completions" | null;
+            deployments: Record<string, string> | null;
+            requiresKey: boolean | null;
+            keyStatus: {
+                configured: boolean;
+                hint: string | null;
+                updatedAt: string | null;
+                updatedByUserId: string | null;
+            };
+            supportedCapabilities: string[];
+            configurable?: boolean | undefined;
+            help?: {
+                key?: string | undefined;
+                baseUrl?: string | undefined;
+            } | undefined;
+        }[];
+        descriptors: {
+            kind: string;
+            id: string;
+            label: string;
+            fields: ({
+                kind: "boolean";
+                name: string;
+                label: string;
+                help?: string | undefined;
+            } | {
+                kind: "enum";
+                options: string[];
+                name: string;
+                label: string;
+                help?: string | undefined;
+            } | {
+                kind: "number";
+                name: string;
+                label: string;
+                min?: number | undefined;
+                max?: number | undefined;
+                integer?: boolean | undefined;
+                help?: string | undefined;
+            } | {
+                kind: "string";
+                name: string;
+                label: string;
+                maxLength?: number | undefined;
+                help?: string | undefined;
+            } | {
+                kind: "other";
+                name: string;
+                label: string;
+                help?: string | undefined;
+            } | {
+                kind: "secret";
+                hasValue: boolean;
+                required: boolean;
+                name: string;
+                label: string;
+                help?: string | undefined;
+            })[];
+            description?: string | undefined;
+        }[];
+        version: number;
+        updatedAt: string | null;
+        updatedBy: {
+            id: string;
+            email: string;
+        } | null;
+    }>;
+    replaceConfig(dto: UpdateAiConfigDto, userId: string, ifMatch?: string): Promise<{
+        enabled: boolean;
+        keyPolicy: "byok" | "byok_with_org_fallback";
+        logPromptContent: boolean;
+        defaults: {
+            maxOutputTokensCap: number | null;
+            allowBackgroundRuns: boolean;
+            allowRealtime: boolean;
+        };
+        usageRetentionDays: number;
+        hostedTools: {
+            web_search: boolean;
+            file_search: boolean;
+            code_interpreter: boolean;
+            image_generation: boolean;
+            mcp: boolean;
+            mcpAllowedHosts: string[];
+        };
+        limits: {
+            perUser?: {
+                requestsPerMinute?: number | undefined;
+                requestsPerDay?: number | undefined;
+            } | undefined;
+            orgKey?: {
+                requestsPerDayPerUser?: number | undefined;
+                tokensPerDayPerUser?: number | undefined;
+            } | undefined;
+            perOrg?: {
+                requestsPerDay?: number | undefined;
+                outputTokensPerDay?: number | undefined;
+            } | undefined;
+            perModel?: Record<string, {
+                maxOutputTokens?: number | undefined;
+                requestsPerMinutePerUser?: number | undefined;
+            }> | undefined;
+        };
+        deploymentKeyServesOrgs: boolean;
+        providers: {
+            id: string;
+            displayName: string;
+            registered: boolean;
+            enabled: boolean;
+            baseUrl: string | null;
+            settingsFields: string[];
+            settings: Record<string, unknown>;
+            requiresBaseUrl: boolean;
+            apiVersion: string | null;
+            apiStyle: "responses" | "chat_completions" | null;
+            deployments: Record<string, string> | null;
+            requiresKey: boolean | null;
+            keyStatus: {
+                configured: boolean;
+                hint: string | null;
+                updatedAt: string | null;
+                updatedByUserId: string | null;
+            };
+            supportedCapabilities: string[];
+            configurable?: boolean | undefined;
+            help?: {
+                key?: string | undefined;
+                baseUrl?: string | undefined;
+            } | undefined;
+        }[];
+        descriptors: {
+            kind: string;
+            id: string;
+            label: string;
+            fields: ({
+                kind: "boolean";
+                name: string;
+                label: string;
+                help?: string | undefined;
+            } | {
+                kind: "enum";
+                options: string[];
+                name: string;
+                label: string;
+                help?: string | undefined;
+            } | {
+                kind: "number";
+                name: string;
+                label: string;
+                min?: number | undefined;
+                max?: number | undefined;
+                integer?: boolean | undefined;
+                help?: string | undefined;
+            } | {
+                kind: "string";
+                name: string;
+                label: string;
+                maxLength?: number | undefined;
+                help?: string | undefined;
+            } | {
+                kind: "other";
+                name: string;
+                label: string;
+                help?: string | undefined;
+            } | {
+                kind: "secret";
+                hasValue: boolean;
+                required: boolean;
+                name: string;
+                label: string;
+                help?: string | undefined;
+            })[];
+            description?: string | undefined;
+        }[];
+        version: number;
+        updatedAt: string | null;
+        updatedBy: {
+            id: string;
+            email: string;
+        } | null;
+    }>;
+    setKey(provider: string, dto: SetAiProviderKeyDto, userId: string): Promise<{
+        enabled: boolean;
+        keyPolicy: "byok" | "byok_with_org_fallback";
+        logPromptContent: boolean;
+        defaults: {
+            maxOutputTokensCap: number | null;
+            allowBackgroundRuns: boolean;
+            allowRealtime: boolean;
+        };
+        usageRetentionDays: number;
+        hostedTools: {
+            web_search: boolean;
+            file_search: boolean;
+            code_interpreter: boolean;
+            image_generation: boolean;
+            mcp: boolean;
+            mcpAllowedHosts: string[];
+        };
+        limits: {
+            perUser?: {
+                requestsPerMinute?: number | undefined;
+                requestsPerDay?: number | undefined;
+            } | undefined;
+            orgKey?: {
+                requestsPerDayPerUser?: number | undefined;
+                tokensPerDayPerUser?: number | undefined;
+            } | undefined;
+            perOrg?: {
+                requestsPerDay?: number | undefined;
+                outputTokensPerDay?: number | undefined;
+            } | undefined;
+            perModel?: Record<string, {
+                maxOutputTokens?: number | undefined;
+                requestsPerMinutePerUser?: number | undefined;
+            }> | undefined;
+        };
+        deploymentKeyServesOrgs: boolean;
+        providers: {
+            id: string;
+            displayName: string;
+            registered: boolean;
+            enabled: boolean;
+            baseUrl: string | null;
+            settingsFields: string[];
+            settings: Record<string, unknown>;
+            requiresBaseUrl: boolean;
+            apiVersion: string | null;
+            apiStyle: "responses" | "chat_completions" | null;
+            deployments: Record<string, string> | null;
+            requiresKey: boolean | null;
+            keyStatus: {
+                configured: boolean;
+                hint: string | null;
+                updatedAt: string | null;
+                updatedByUserId: string | null;
+            };
+            supportedCapabilities: string[];
+            configurable?: boolean | undefined;
+            help?: {
+                key?: string | undefined;
+                baseUrl?: string | undefined;
+            } | undefined;
+        }[];
+        descriptors: {
+            kind: string;
+            id: string;
+            label: string;
+            fields: ({
+                kind: "boolean";
+                name: string;
+                label: string;
+                help?: string | undefined;
+            } | {
+                kind: "enum";
+                options: string[];
+                name: string;
+                label: string;
+                help?: string | undefined;
+            } | {
+                kind: "number";
+                name: string;
+                label: string;
+                min?: number | undefined;
+                max?: number | undefined;
+                integer?: boolean | undefined;
+                help?: string | undefined;
+            } | {
+                kind: "string";
+                name: string;
+                label: string;
+                maxLength?: number | undefined;
+                help?: string | undefined;
+            } | {
+                kind: "other";
+                name: string;
+                label: string;
+                help?: string | undefined;
+            } | {
+                kind: "secret";
+                hasValue: boolean;
+                required: boolean;
+                name: string;
+                label: string;
+                help?: string | undefined;
+            })[];
+            description?: string | undefined;
+        }[];
+        version: number;
+        updatedAt: string | null;
+        updatedBy: {
+            id: string;
+            email: string;
+        } | null;
+    }>;
+    deleteKey(provider: string, _dto: RemoveAiProviderKeyDto, userId: string): Promise<{
+        enabled: boolean;
+        keyPolicy: "byok" | "byok_with_org_fallback";
+        logPromptContent: boolean;
+        defaults: {
+            maxOutputTokensCap: number | null;
+            allowBackgroundRuns: boolean;
+            allowRealtime: boolean;
+        };
+        usageRetentionDays: number;
+        hostedTools: {
+            web_search: boolean;
+            file_search: boolean;
+            code_interpreter: boolean;
+            image_generation: boolean;
+            mcp: boolean;
+            mcpAllowedHosts: string[];
+        };
+        limits: {
+            perUser?: {
+                requestsPerMinute?: number | undefined;
+                requestsPerDay?: number | undefined;
+            } | undefined;
+            orgKey?: {
+                requestsPerDayPerUser?: number | undefined;
+                tokensPerDayPerUser?: number | undefined;
+            } | undefined;
+            perOrg?: {
+                requestsPerDay?: number | undefined;
+                outputTokensPerDay?: number | undefined;
+            } | undefined;
+            perModel?: Record<string, {
+                maxOutputTokens?: number | undefined;
+                requestsPerMinutePerUser?: number | undefined;
+            }> | undefined;
+        };
+        deploymentKeyServesOrgs: boolean;
+        providers: {
+            id: string;
+            displayName: string;
+            registered: boolean;
+            enabled: boolean;
+            baseUrl: string | null;
+            settingsFields: string[];
+            settings: Record<string, unknown>;
+            requiresBaseUrl: boolean;
+            apiVersion: string | null;
+            apiStyle: "responses" | "chat_completions" | null;
+            deployments: Record<string, string> | null;
+            requiresKey: boolean | null;
+            keyStatus: {
+                configured: boolean;
+                hint: string | null;
+                updatedAt: string | null;
+                updatedByUserId: string | null;
+            };
+            supportedCapabilities: string[];
+            configurable?: boolean | undefined;
+            help?: {
+                key?: string | undefined;
+                baseUrl?: string | undefined;
+            } | undefined;
+        }[];
+        descriptors: {
+            kind: string;
+            id: string;
+            label: string;
+            fields: ({
+                kind: "boolean";
+                name: string;
+                label: string;
+                help?: string | undefined;
+            } | {
+                kind: "enum";
+                options: string[];
+                name: string;
+                label: string;
+                help?: string | undefined;
+            } | {
+                kind: "number";
+                name: string;
+                label: string;
+                min?: number | undefined;
+                max?: number | undefined;
+                integer?: boolean | undefined;
+                help?: string | undefined;
+            } | {
+                kind: "string";
+                name: string;
+                label: string;
+                maxLength?: number | undefined;
+                help?: string | undefined;
+            } | {
+                kind: "other";
+                name: string;
+                label: string;
+                help?: string | undefined;
+            } | {
+                kind: "secret";
+                hasValue: boolean;
+                required: boolean;
+                name: string;
+                label: string;
+                help?: string | undefined;
+            })[];
+            description?: string | undefined;
+        }[];
+        version: number;
+        updatedAt: string | null;
+        updatedBy: {
+            id: string;
+            email: string;
+        } | null;
+        warnings: "ORG_FALLBACK_WITHOUT_KEY"[];
+    }>;
+    testProvider(provider: string, dto: TestAiProviderDto, userId: string): Promise<{
+        success: boolean;
+        provider: string;
+        usedStoredKey: boolean;
+        modelCount: number | null;
+        smokeModelId: string | null;
+        checks: {
+            id: "credentials" | "list_models" | "responses_smoke";
+            label: string;
+            status: "failed" | "skipped" | "passed";
+            code: "ok" | "AI_DISABLED" | "AI_PROVIDER_DISABLED" | "AI_KEY_REQUIRED" | "AI_KEY_INVALID" | "AI_MODEL_NOT_ENABLED" | "AI_MODEL_NOT_REACHABLE" | "AI_CAPABILITY_UNSUPPORTED" | "AI_TOOL_DISABLED" | "AI_REALTIME_DISABLED" | "AI_RATE_LIMITED" | "AI_PROVIDER_UNAVAILABLE" | "AI_CONTENT_FILTERED" | "AI_INVALID_REQUEST" | "AI_STRUCTURED_OUTPUT_INVALID" | "AI_STORAGE_UNAVAILABLE" | "not_configured" | "not_attempted" | "no_eligible_model" | "not_supported";
+            detail: string;
+            error: string | null;
+        }[];
+        attemptedAt: string;
+    }>;
+    listModels(query: AiModelListQueryDto): Promise<unknown>;
+    refreshModels(dto: RefreshAiCatalogDto, userId: string): Promise<{
+        jobId: string;
+        status: string;
+    }>;
+    updateModel(id: string, dto: UpdateAiModelDto, userId: string): Promise<{
+        id: string;
+        provider: string;
+        modelId: string;
+        displayName: string | null;
+        capabilities: {
+            capabilities: string[];
+            inputModalities: ("file" | "text" | "image" | "audio")[];
+            outputModalities: ("text" | "image" | "audio" | "embedding")[];
+            reasoningEfforts?: ("minimal" | "low" | "medium" | "high")[] | undefined;
+            contextWindow?: number | undefined;
+            maxOutputTokens?: number | undefined;
+            voices?: string[] | undefined;
+        } | null;
+        capabilitySource: "catalog" | "admin_override" | "unclassified";
+        enabled: boolean;
+        contextWindow: number | null;
+        maxOutputTokens: number | null;
+        discoveredAt: string;
+        lastSeenAt: string;
+        deprecatedAt: string | null;
+        updatedAt: string;
+        updatedByUserId: string | null;
+    }>;
+    getCapabilities(): AiCapabilitiesResponseDto;
+}
+//# sourceMappingURL=ai-admin.controller.d.ts.map

package/dist/ai/config/ai-admin.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-admin.controller.d.ts","sourceRoot":"","sources":["../../../src/ai/config/ai-admin.controller.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAwB,MAAM,2BAA2B,CAAC;AAE5F,OAAO,EAEL,mBAAmB,EACnB,mBAAmB,EAEnB,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACxF,OAAO,EAA2B,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAgC/D;;;;;GAKG;AACH,qBAEa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFN,KAAK,EAAE,oBAAoB,EAC3B,YAAY,EAAE,qBAAqB,EACnC,MAAM,EAAE,oBAAoB;IAiBzC,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAiCT,aAAa,CACT,GAAG,EAAE,iBAAiB,EACX,MAAM,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA8BjC,MAAM,CACS,QAAQ,EAAE,MAAM,EAC3B,GAAG,EAAE,mBAAmB,EACb,MAAM,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA0B7B,SAAS,CACM,QAAQ,EAAE,MAAM,EAC3B,IAAI,EAAE,sBAAsB,EACjB,MAAM,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA6B7B,YAAY,CACG,QAAQ,EAAE,MAAM,EAC3B,GAAG,EAAE,iBAAiB,EACX,MAAM,EAAE,MAAM;;;;;;;;;;;;;;;;IAiC7B,UAAU,CAAU,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAwBjE,aAAa,CAAS,GAAG,EAAE,mBAAmB,EAAqB,MAAM,EAAE,MAAM;;;;IAoBjF,WAAW,CACa,EAAE,EAAE,MAAM,EAC9B,GAAG,EAAE,gBAAgB,EACV,MAAM,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;IAkBnC,eAAe,IAAI,yBAAyB;CAG7C"}