@actuate-media/cms-core 0.42.0 → 0.43.0

package/dist/__tests__/ai/ai.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ai.test.d.ts.map

package/dist/__tests__/ai/ai.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/ai/ai.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/ai/ai.test.js

@@ -0,0 +1,261 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { defaultAISettings, encryptProviderKey, getAIConfig, getEnvApiKey, last4, resolveProviderKey, toPublicProvider, } from '../../ai/config-store.js';
+import { mergeFeatures } from '../../ai/feature-defaults.js';
+import { curatedFallbackCatalog, normalizeModel } from '../../ai/catalog.js';
+import { resolveModelOrUnavailable } from '../../ai/models.js';
+import { getUsageSummary } from '../../ai/usage.js';
+import * as openai from '../../ai/providers/openai.js';
+import * as anthropic from '../../ai/providers/anthropic.js';
+import * as custom from '../../ai/providers/custom.js';
+function makeConn(overrides = {}) {
+    return {
+        id: 'c1',
+        provider: 'anthropic',
+        displayName: 'Anthropic',
+        enabled: true,
+        status: 'unknown',
+        createdAt: '2026-01-01T00:00:00.000Z',
+        updatedAt: '2026-01-01T00:00:00.000Z',
+        updatedBy: 'u1',
+        ...overrides,
+    };
+}
+function mockResponse(status, body) {
+    return {
+        ok: status >= 200 && status < 300,
+        status,
+        json: async () => body,
+    };
+}
+describe('ai/config-store', () => {
+    const origEnv = { ...process.env };
+    afterEach(() => {
+        process.env = { ...origEnv };
+        vi.restoreAllMocks();
+    });
+    it('encrypts a key and masks to last4 without leaking the key', async () => {
+        const { apiKeyEncrypted, apiKeyLast4 } = await encryptProviderKey('sk-ant-secret-7788');
+        expect(apiKeyLast4).toBe('7788');
+        const conn = makeConn({ apiKeyEncrypted, apiKeyLast4 });
+        const pub = toPublicProvider(conn);
+        expect(pub.apiKeyEncrypted).toBeUndefined();
+        expect(pub.apiKeyLast4).toBe('7788');
+        expect(pub.hasKey).toBe(true);
+        expect(pub.apiKeySource).toBe('database');
+        expect(pub.keyManagedExternally).toBe(false);
+    });
+    it('treats an env-managed provider as read-only and reflects the env key suffix', () => {
+        process.env.OPENAI_API_KEY = 'sk-env-key-9090';
+        const conn = makeConn({ provider: 'openai' });
+        const pub = toPublicProvider(conn);
+        expect(pub.apiKeySource).toBe('environment');
+        expect(pub.keyManagedExternally).toBe(true);
+        expect(pub.apiKeyLast4).toBe('9090');
+        expect(getEnvApiKey('openai')).toBe('sk-env-key-9090');
+    });
+    it('resolves the env key over a stored key, else decrypts the stored key', async () => {
+        const { apiKeyEncrypted } = await encryptProviderKey('stored-key-1111');
+        const conn = makeConn({ provider: 'xai', apiKeyEncrypted });
+        expect(await resolveProviderKey(conn)).toBe('stored-key-1111');
+        process.env.XAI_API_KEY = 'env-key-2222';
+        expect(await resolveProviderKey(conn)).toBe('env-key-2222');
+    });
+    it('last4 handles short and empty values', () => {
+        expect(last4('abcdef')).toBe('cdef');
+        expect(last4('ab')).toBe('ab');
+        expect(last4('')).toBeUndefined();
+        expect(last4(undefined)).toBeUndefined();
+    });
+    it('getAIConfig returns populated defaults when no document exists', async () => {
+        const db = { document: { findFirst: async () => null } };
+        const config = await getAIConfig(db);
+        expect(config.providers).toEqual([]);
+        expect(config.settings.features.length).toBeGreaterThan(0);
+        expect(config.settings.budget.alertAtPercentages).toEqual([50, 80, 100]);
+    });
+    it('getAIConfig merges stored feature toggles over current defaults', async () => {
+        const db = {
+            document: {
+                findFirst: async () => ({
+                    data: {
+                        providers: [],
+                        settings: {
+                            features: [{ key: 'ai.features.contentWriting', enabled: false }],
+                        },
+                    },
+                }),
+            },
+        };
+        const config = await getAIConfig(db);
+        const cw = config.settings.features.find((f) => f.key === 'ai.features.contentWriting');
+        expect(cw?.enabled).toBe(false);
+        // Other defaults still present.
+        expect(config.settings.features.length).toBe(defaultAISettings().features.length);
+    });
+});
+describe('ai/feature-defaults mergeFeatures', () => {
+    it('preserves enabled state and drops unknown keys', () => {
+        const merged = mergeFeatures([
+            { key: 'ai.features.mediaAltText', enabled: false },
+            { key: 'ai.features.removed', enabled: true },
+        ]);
+        expect(merged.find((f) => f.key === 'ai.features.mediaAltText')?.enabled).toBe(false);
+        expect(merged.find((f) => f.key === 'ai.features.removed')).toBeUndefined();
+    });
+});
+describe('ai/catalog normalizeModel', () => {
+    const now = '2026-01-01T00:00:00.000Z';
+    it('merges curated capabilities + display name for a dated provider id', () => {
+        const m = normalizeModel({
+            provider: 'openai',
+            providerModelId: 'gpt-4o-2024-08-06',
+            source: 'provider',
+            lastSyncedAt: now,
+        });
+        expect(m.displayName).toBe('GPT-4o (balanced)');
+        expect(m.capabilities.vision).toBe(true);
+        expect(m.capabilities.text).toBe(true);
+        expect(m.pricing?.inputPerMillion).toBe(2.5);
+    });
+    it('prefers the longest match (gpt-4o-mini over gpt-4o)', () => {
+        const m = normalizeModel({
+            provider: 'openai',
+            providerModelId: 'gpt-4o-mini-2024-07-18',
+            source: 'provider',
+            lastSyncedAt: now,
+        });
+        expect(m.displayName).toBe('GPT-4o mini (fast)');
+    });
+    it('infers conservative capabilities for an unknown model', () => {
+        const m = normalizeModel({
+            provider: 'custom',
+            providerModelId: 'mystery-llm-v9',
+            source: 'manual',
+            lastSyncedAt: now,
+        });
+        expect(m.capabilities.text).toBe(true);
+        expect(m.capabilities.vision).toBe(false);
+        expect(m.metadata).toEqual({});
+    });
+    it('detects embedding models by id', () => {
+        const m = normalizeModel({
+            provider: 'custom',
+            providerModelId: 'my-embedding-model',
+            source: 'manual',
+            lastSyncedAt: now,
+        });
+        expect(m.capabilities.embeddings).toBe(true);
+        expect(m.capabilities.text).toBe(false);
+        expect(m.outputModalities).toEqual(['embedding']);
+    });
+    it('curatedFallbackCatalog returns normalized models for a provider', () => {
+        const models = curatedFallbackCatalog('anthropic', now);
+        expect(models.length).toBeGreaterThan(0);
+        expect(models.every((m) => m.provider === 'anthropic')).toBe(true);
+        expect(models.some((m) => m.displayName === 'Claude Sonnet (balanced)')).toBe(true);
+    });
+});
+describe('ai/models resolveModelOrUnavailable', () => {
+    it('returns the catalog model when present', () => {
+        const catalog = curatedFallbackCatalog('anthropic', '2026-01-01T00:00:00.000Z');
+        const target = catalog[0];
+        expect(resolveModelOrUnavailable(target.id, catalog)?.status).not.toBe('unavailable');
+    });
+    it('synthesizes an unavailable model when the id is gone', () => {
+        const catalog = curatedFallbackCatalog('anthropic', '2026-01-01T00:00:00.000Z');
+        const m = resolveModelOrUnavailable('openai:ghost-model', catalog);
+        expect(m?.status).toBe('unavailable');
+        expect(m?.provider).toBe('openai');
+        expect(m?.providerModelId).toBe('ghost-model');
+    });
+    it('returns null for an empty id', () => {
+        expect(resolveModelOrUnavailable(undefined, [])).toBeNull();
+    });
+});
+describe('ai/providers adapters (mocked fetch)', () => {
+    it('openai testConnection maps 200 -> connected and lists model ids', async () => {
+        const fetchImpl = vi
+            .fn()
+            .mockResolvedValue(mockResponse(200, { data: [{ id: 'gpt-4o' }, { id: 'gpt-4o-mini' }] }));
+        const res = await openai.testConnection({ apiKey: 'k', fetchImpl });
+        expect(res.status).toBe('connected');
+        expect(res.ok).toBe(true);
+        const ids = await openai.listModels({ apiKey: 'k', fetchImpl });
+        expect(ids).toEqual(['gpt-4o', 'gpt-4o-mini']);
+    });
+    it('openai testConnection maps 401 -> invalid_key', async () => {
+        const fetchImpl = vi.fn().mockResolvedValue(mockResponse(401, {}));
+        const res = await openai.testConnection({ apiKey: 'bad', fetchImpl });
+        expect(res.status).toBe('invalid_key');
+        expect(res.ok).toBe(false);
+    });
+    it('openai testConnection reports needs_setup with no key', async () => {
+        const res = await openai.testConnection({ apiKey: '' });
+        expect(res.status).toBe('needs_setup');
+    });
+    it('anthropic sends x-api-key + version headers', async () => {
+        const fetchImpl = vi
+            .fn()
+            .mockResolvedValue(mockResponse(200, { data: [] }));
+        await anthropic.testConnection({ apiKey: 'k', fetchImpl });
+        const call = fetchImpl.mock.calls[0];
+        const headers = call[1].headers;
+        expect(headers['x-api-key']).toBe('k');
+        expect(headers['anthropic-version']).toBeTruthy();
+    });
+    it('custom provider rejects an SSRF base URL before fetching', async () => {
+        const fetchImpl = vi.fn();
+        const res = await custom.testConnection({
+            apiKey: 'k',
+            baseUrl: 'http://127.0.0.1/v1',
+            fetchImpl,
+        });
+        expect(res.ok).toBe(false);
+        expect(res.message.toLowerCase()).toContain('unsafe');
+        expect(fetchImpl.mock.calls.length).toBe(0);
+    });
+    it('custom provider treats 404 /models as connected (manual model entry)', async () => {
+        const fetchImpl = vi.fn().mockResolvedValue(mockResponse(404, {}));
+        // Public IP literal so the SSRF guard's DNS resolution is skipped (offline test).
+        const res = await custom.testConnection({
+            apiKey: 'k',
+            baseUrl: 'https://93.184.216.34/v1',
+            fetchImpl,
+        });
+        expect(res.ok).toBe(true);
+        expect(res.status).toBe('connected');
+    });
+});
+describe('ai/usage getUsageSummary', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+        vi.setSystemTime(new Date('2026-06-15T12:00:00.000Z'));
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it('aggregates token totals from audit rows within the month', async () => {
+        const db = {
+            document: { findFirst: async () => null },
+            auditLog: {
+                findMany: async () => [
+                    { details: { totalTokensUsed: 100 } },
+                    { details: { tokensUsed: 50 } },
+                    { details: { promptTokens: 10, completionTokens: 5 } },
+                    { details: { action: 'noop' } },
+                ],
+            },
+        };
+        const summary = await getUsageSummary(db);
+        expect(summary.totalTokens).toBe(165);
+        expect(summary.runCount).toBe(3);
+        expect(summary.periodStart).toBe('2026-06-01T00:00:00.000Z');
+    });
+    it('returns zero usage when there are no rows', async () => {
+        const db = { document: { findFirst: async () => null }, auditLog: { findMany: async () => [] } };
+        const summary = await getUsageSummary(db);
+        expect(summary.totalTokens).toBe(0);
+        expect(summary.runCount).toBe(0);
+    });
+});
+//# sourceMappingURL=ai.test.js.map

package/dist/__tests__/ai/ai.test.js.map

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

package/dist/ai/catalog.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Curated model metadata + normalization.
+ *
+ * Live provider listing endpoints return model IDs and little else (rarely
+ * capabilities or pricing). We merge those IDs with a curated capability/pricing
+ * map so the catalog always knows what a model can do, what it costs, and
+ * whether it is current. When no key/live listing is available, the curated
+ * entries also serve as the fallback catalog.
+ *
+ * Matching is prefix-based (longest match wins) so dated provider IDs like
+ * `gpt-4o-2024-08-06` resolve to the `gpt-4o` entry, while `gpt-4o-mini-*`
+ * resolves to its own entry.
+ */
+import type { AIModel, AIProviderKey } from './types.js';
+export interface NormalizeInput {
+    provider: AIProviderKey;
+    providerModelId: string;
+    source: AIModel['source'];
+    lastSyncedAt: string;
+    /** Override status (e.g. 'available' from a live listing). */
+    status?: AIModel['status'];
+    /** Provider-supplied display name, if any. */
+    displayName?: string;
+}
+/** Merge a (live or fallback) model id with curated metadata into an AIModel. */
+export declare function normalizeModel(input: NormalizeInput): AIModel;
+/** Curated fallback catalog for a provider (used when no live listing). */
+export declare function curatedFallbackCatalog(provider: AIProviderKey, lastSyncedAt: string): AIModel[];
+//# sourceMappingURL=catalog.d.ts.map

package/dist/ai/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/ai/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAuC,aAAa,EAAE,MAAM,YAAY,CAAA;AAmT7F,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,aAAa,CAAA;IACvB,eAAe,EAAE,MAAM,CAAA;IACvB,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;IACzB,YAAY,EAAE,MAAM,CAAA;IACpB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC1B,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CA4B7D;AAED,2EAA2E;AAC3E,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,EAAE,CAc/F"}

package/dist/ai/catalog.js

@@ -0,0 +1,340 @@
+/**
+ * Curated model metadata + normalization.
+ *
+ * Live provider listing endpoints return model IDs and little else (rarely
+ * capabilities or pricing). We merge those IDs with a curated capability/pricing
+ * map so the catalog always knows what a model can do, what it costs, and
+ * whether it is current. When no key/live listing is available, the curated
+ * entries also serve as the fallback catalog.
+ *
+ * Matching is prefix-based (longest match wins) so dated provider IDs like
+ * `gpt-4o-2024-08-06` resolve to the `gpt-4o` entry, while `gpt-4o-mini-*`
+ * resolves to its own entry.
+ */
+const NO_CAPABILITIES = {
+    text: false,
+    vision: false,
+    imageGeneration: false,
+    embeddings: false,
+    toolCalling: false,
+    structuredOutput: false,
+    streaming: false,
+    reasoning: false,
+    longContext: false,
+};
+const CURATED = {
+    openai: [
+        {
+            match: ['gpt-4o-mini'],
+            canonicalId: 'gpt-4o-mini',
+            displayName: 'GPT-4o mini (fast)',
+            description: 'Low-cost multimodal model for high-volume tasks.',
+            capabilities: {
+                text: true,
+                vision: true,
+                toolCalling: true,
+                structuredOutput: true,
+                streaming: true,
+                longContext: true,
+            },
+            contextWindow: 128000,
+            maxOutputTokens: 16384,
+            inputModalities: ['text', 'image'],
+            outputModalities: ['text'],
+            pricing: { inputPerMillion: 0.15, outputPerMillion: 0.6 },
+        },
+        {
+            match: ['gpt-4o', 'chatgpt-4o'],
+            canonicalId: 'gpt-4o',
+            displayName: 'GPT-4o (balanced)',
+            description: 'Flagship multimodal model balancing quality, speed, and cost.',
+            capabilities: {
+                text: true,
+                vision: true,
+                toolCalling: true,
+                structuredOutput: true,
+                streaming: true,
+                longContext: true,
+            },
+            contextWindow: 128000,
+            maxOutputTokens: 16384,
+            inputModalities: ['text', 'image'],
+            outputModalities: ['text'],
+            pricing: { inputPerMillion: 2.5, outputPerMillion: 10 },
+        },
+        {
+            match: ['o3-mini', 'o1-mini'],
+            canonicalId: 'o3-mini',
+            displayName: 'o3-mini (reasoning)',
+            description: 'Fast reasoning model for structured problem solving.',
+            capabilities: {
+                text: true,
+                toolCalling: true,
+                structuredOutput: true,
+                reasoning: true,
+                longContext: true,
+            },
+            contextWindow: 200000,
+            maxOutputTokens: 100000,
+            inputModalities: ['text'],
+            outputModalities: ['text'],
+            pricing: { inputPerMillion: 1.1, outputPerMillion: 4.4 },
+        },
+        {
+            match: ['o3', 'o1'],
+            canonicalId: 'o3',
+            displayName: 'o3 (reasoning)',
+            description: 'High-capability reasoning model.',
+            capabilities: {
+                text: true,
+                vision: true,
+                toolCalling: true,
+                structuredOutput: true,
+                reasoning: true,
+                longContext: true,
+            },
+            contextWindow: 200000,
+            maxOutputTokens: 100000,
+            inputModalities: ['text', 'image'],
+            outputModalities: ['text'],
+            pricing: { inputPerMillion: 10, outputPerMillion: 40 },
+        },
+        {
+            match: ['text-embedding-3-large'],
+            canonicalId: 'text-embedding-3-large',
+            displayName: 'Embedding 3 (large)',
+            capabilities: { embeddings: true },
+            inputModalities: ['text'],
+            outputModalities: ['embedding'],
+            pricing: { inputPerMillion: 0.13 },
+        },
+        {
+            match: ['text-embedding-3-small', 'text-embedding'],
+            canonicalId: 'text-embedding-3-small',
+            displayName: 'Embedding 3 (small)',
+            capabilities: { embeddings: true },
+            inputModalities: ['text'],
+            outputModalities: ['embedding'],
+            pricing: { inputPerMillion: 0.02 },
+        },
+        {
+            match: ['gpt-image-1', 'dall-e-3', 'dall-e'],
+            canonicalId: 'gpt-image-1',
+            displayName: 'GPT Image',
+            capabilities: { imageGeneration: true },
+            inputModalities: ['text'],
+            outputModalities: ['image'],
+            pricing: { image: 0.04 },
+        },
+    ],
+    anthropic: [
+        {
+            match: ['claude-3-5-haiku', 'claude-haiku', 'claude-3-haiku'],
+            canonicalId: 'claude-3-5-haiku-latest',
+            displayName: 'Claude Haiku (fast)',
+            description: 'Fast, low-cost model for high-throughput tasks.',
+            capabilities: {
+                text: true,
+                vision: true,
+                toolCalling: true,
+                structuredOutput: true,
+                streaming: true,
+                longContext: true,
+            },
+            contextWindow: 200000,
+            maxOutputTokens: 8192,
+            inputModalities: ['text', 'image'],
+            outputModalities: ['text'],
+            pricing: { inputPerMillion: 0.8, outputPerMillion: 4 },
+        },
+        {
+            match: ['claude-opus', 'claude-3-opus'],
+            canonicalId: 'claude-opus-4-latest',
+            displayName: 'Claude Opus (most capable)',
+            description: 'Highest-capability Claude model for complex reasoning.',
+            capabilities: {
+                text: true,
+                vision: true,
+                toolCalling: true,
+                structuredOutput: true,
+                streaming: true,
+                reasoning: true,
+                longContext: true,
+            },
+            contextWindow: 200000,
+            maxOutputTokens: 32000,
+            inputModalities: ['text', 'image'],
+            outputModalities: ['text'],
+            pricing: { inputPerMillion: 15, outputPerMillion: 75 },
+        },
+        {
+            match: ['claude-sonnet', 'claude-3-5-sonnet', 'claude-3-sonnet', 'claude-'],
+            canonicalId: 'claude-sonnet-4-latest',
+            displayName: 'Claude Sonnet (balanced)',
+            description: 'Balanced Claude model for everyday content and reasoning.',
+            capabilities: {
+                text: true,
+                vision: true,
+                toolCalling: true,
+                structuredOutput: true,
+                streaming: true,
+                longContext: true,
+            },
+            contextWindow: 200000,
+            maxOutputTokens: 16384,
+            inputModalities: ['text', 'image'],
+            outputModalities: ['text'],
+            pricing: { inputPerMillion: 3, outputPerMillion: 15 },
+        },
+    ],
+    xai: [
+        {
+            match: ['grok-4-fast', 'grok-3-mini', 'grok-mini'],
+            canonicalId: 'grok-4-fast',
+            displayName: 'Grok (fast)',
+            description: 'Low-latency Grok model for high-volume tasks.',
+            capabilities: {
+                text: true,
+                toolCalling: true,
+                structuredOutput: true,
+                streaming: true,
+                longContext: true,
+            },
+            contextWindow: 131072,
+            maxOutputTokens: 16384,
+            inputModalities: ['text'],
+            outputModalities: ['text'],
+            pricing: { inputPerMillion: 0.2, outputPerMillion: 0.5 },
+        },
+        {
+            match: ['grok-vision', 'grok-2-vision'],
+            canonicalId: 'grok-vision',
+            displayName: 'Grok Vision',
+            description: 'Multimodal Grok model with image understanding.',
+            capabilities: {
+                text: true,
+                vision: true,
+                toolCalling: true,
+                structuredOutput: true,
+                streaming: true,
+                longContext: true,
+            },
+            contextWindow: 131072,
+            maxOutputTokens: 16384,
+            inputModalities: ['text', 'image'],
+            outputModalities: ['text'],
+            pricing: { inputPerMillion: 2, outputPerMillion: 10 },
+        },
+        {
+            match: ['grok'],
+            canonicalId: 'grok-4',
+            displayName: 'Grok (balanced)',
+            description: 'Flagship Grok model.',
+            capabilities: {
+                text: true,
+                toolCalling: true,
+                structuredOutput: true,
+                streaming: true,
+                reasoning: true,
+                longContext: true,
+            },
+            contextWindow: 131072,
+            maxOutputTokens: 16384,
+            inputModalities: ['text'],
+            outputModalities: ['text'],
+            pricing: { inputPerMillion: 3, outputPerMillion: 15 },
+        },
+    ],
+};
+/** Find the curated entry whose longest `match` prefix applies to the id. */
+function findCurated(provider, providerModelId) {
+    if (provider === 'custom')
+        return null;
+    const list = CURATED[provider];
+    if (!list)
+        return null;
+    const id = providerModelId.toLowerCase();
+    let best = null;
+    for (const meta of list) {
+        for (const m of meta.match) {
+            if (id.startsWith(m) && (!best || m.length > best.len)) {
+                best = { meta, len: m.length };
+            }
+        }
+    }
+    return best?.meta ?? null;
+}
+/**
+ * Heuristic capability inference for models with no curated entry (e.g. an
+ * unknown custom-provider model). Conservative: assumes text unless the id
+ * clearly indicates embeddings/image-only.
+ */
+function inferCapabilities(providerModelId) {
+    const id = providerModelId.toLowerCase();
+    const caps = { ...NO_CAPABILITIES };
+    if (id.includes('embed')) {
+        caps.embeddings = true;
+        return caps;
+    }
+    if (id.includes('image') || id.includes('dall-e') || id.includes('imagen')) {
+        caps.imageGeneration = true;
+        return caps;
+    }
+    caps.text = true;
+    caps.streaming = true;
+    if (id.includes('vision') ||
+        id.includes('-o') ||
+        id.includes('4o') ||
+        id.includes('multimodal')) {
+        caps.vision = true;
+    }
+    if (id.includes('reason') || id.includes('think') || /\bo[13]\b/.test(id)) {
+        caps.reasoning = true;
+    }
+    return caps;
+}
+/** Merge a (live or fallback) model id with curated metadata into an AIModel. */
+export function normalizeModel(input) {
+    const curated = findCurated(input.provider, input.providerModelId);
+    const capabilities = curated
+        ? { ...NO_CAPABILITIES, ...curated.capabilities }
+        : inferCapabilities(input.providerModelId);
+    return {
+        id: `${input.provider}:${input.providerModelId}`,
+        provider: input.provider,
+        providerModelId: input.providerModelId,
+        displayName: curated?.displayName ?? input.displayName ?? input.providerModelId,
+        description: curated?.description,
+        status: input.status ?? (curated?.deprecated ? 'deprecated' : 'available'),
+        capabilities,
+        contextWindow: curated?.contextWindow,
+        maxOutputTokens: curated?.maxOutputTokens,
+        inputModalities: curated?.inputModalities ?? (capabilities.embeddings ? ['text'] : ['text']),
+        outputModalities: curated?.outputModalities ??
+            (capabilities.embeddings
+                ? ['embedding']
+                : capabilities.imageGeneration
+                    ? ['image']
+                    : ['text']),
+        pricing: curated?.pricing,
+        lastSyncedAt: input.lastSyncedAt,
+        source: input.source,
+        metadata: curated ? { curated: true } : {},
+    };
+}
+/** Curated fallback catalog for a provider (used when no live listing). */
+export function curatedFallbackCatalog(provider, lastSyncedAt) {
+    if (provider === 'custom')
+        return [];
+    const list = CURATED[provider] ?? [];
+    return list
+        .filter((m) => m.fallback !== false)
+        .map((m) => normalizeModel({
+        provider,
+        providerModelId: m.canonicalId,
+        source: 'config',
+        status: m.deprecated ? 'deprecated' : 'available',
+        lastSyncedAt,
+    }));
+}
+//# sourceMappingURL=catalog.js.map