@actuate-media/cms-core 0.43.0 → 0.44.0

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

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

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

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

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

@@ -0,0 +1,164 @@
+import { describe, expect, it } from 'vitest';
+import { resolveAllFeatureModels, resolveFeatureModel } from '../../ai/resolve.js';
+const NO_CAPS = {
+    text: false,
+    vision: false,
+    imageGeneration: false,
+    embeddings: false,
+    toolCalling: false,
+    structuredOutput: false,
+    streaming: false,
+    reasoning: false,
+    longContext: false,
+};
+function model(id, caps, over = {}) {
+    const [provider = 'anthropic', providerModelId = id] = id.split(':');
+    return {
+        id,
+        provider: provider,
+        providerModelId,
+        displayName: id,
+        status: 'available',
+        capabilities: { ...NO_CAPS, ...caps },
+        inputModalities: ['text'],
+        outputModalities: ['text'],
+        lastSyncedAt: '2026-01-01T00:00:00.000Z',
+        source: 'provider',
+        metadata: {},
+        ...over,
+    };
+}
+function conn(over = {}) {
+    return {
+        id: 'p-anthropic',
+        provider: 'anthropic',
+        displayName: 'Anthropic',
+        enabled: true,
+        status: 'connected',
+        createdAt: '2026-01-01T00:00:00.000Z',
+        updatedAt: '2026-01-01T00:00:00.000Z',
+        updatedBy: 'u1',
+        ...over,
+    };
+}
+function config(over) {
+    return {
+        providers: over.providers ?? [conn()],
+        settings: {
+            defaultModelId: over.defaultModelId,
+            defaultVisionModelId: over.defaultVisionModelId,
+            features: over.features ?? [],
+            budget: { alertAtPercentages: [], disableWhenExceeded: false },
+            logsRetentionDays: 30,
+        },
+    };
+}
+const textFeature = {
+    key: 'ai.features.contentWriting',
+    label: 'Content writing',
+    description: '',
+    enabled: true,
+    category: 'content',
+    requiredCapabilities: ['text'],
+    approvalRequired: false,
+    allowBulkApply: false,
+    rolesAllowed: ['ADMIN'],
+    permissionsRequired: ['ai.use'],
+};
+describe('resolveFeatureModel', () => {
+    it('uses the global default when the feature has no override', () => {
+        const catalog = [model('anthropic:claude-x', { text: true })];
+        const cfg = config({ defaultModelId: 'anthropic:claude-x', features: [textFeature] });
+        const r = resolveFeatureModel(cfg, textFeature.key, catalog);
+        expect(r.modelId).toBe('anthropic:claude-x');
+        expect(r.source).toBe('global-default');
+        expect(r.providerId).toBe('p-anthropic');
+        expect(r.satisfiesCapabilities).toBe(true);
+    });
+    it('prefers the feature-level model override over the default', () => {
+        const catalog = [
+            model('anthropic:claude-x', { text: true }),
+            model('openai:gpt-y', { text: true }, { provider: 'openai' }),
+        ];
+        const cfg = config({
+            providers: [conn(), conn({ id: 'p-openai', provider: 'openai' })],
+            defaultModelId: 'anthropic:claude-x',
+            features: [{ ...textFeature, modelId: 'openai:gpt-y' }],
+        });
+        const r = resolveFeatureModel(cfg, textFeature.key, catalog);
+        expect(r.modelId).toBe('openai:gpt-y');
+        expect(r.source).toBe('feature-override');
+        expect(r.providerId).toBe('p-openai');
+    });
+    it('falls back to the capability-typed default for a vision feature', () => {
+        const visionFeature = {
+            ...textFeature,
+            key: 'ai.features.mediaAltText',
+            requiredCapabilities: ['vision'],
+        };
+        const catalog = [
+            model('anthropic:claude-text', { text: true }),
+            model('openai:gpt-vision', { text: true, vision: true }, { provider: 'openai' }),
+        ];
+        const cfg = config({
+            providers: [conn(), conn({ id: 'p-openai', provider: 'openai' })],
+            defaultModelId: 'anthropic:claude-text', // text-only, can't satisfy vision
+            defaultVisionModelId: 'openai:gpt-vision',
+            features: [visionFeature],
+        });
+        const r = resolveFeatureModel(cfg, visionFeature.key, catalog);
+        expect(r.modelId).toBe('openai:gpt-vision');
+        expect(r.source).toBe('capability-default');
+        expect(r.satisfiesCapabilities).toBe(true);
+    });
+    it('reports missing capabilities when no candidate satisfies them', () => {
+        const visionFeature = {
+            ...textFeature,
+            key: 'ai.features.mediaAltText',
+            requiredCapabilities: ['vision'],
+        };
+        const catalog = [model('anthropic:claude-text', { text: true })];
+        const cfg = config({ defaultModelId: 'anthropic:claude-text', features: [visionFeature] });
+        const r = resolveFeatureModel(cfg, visionFeature.key, catalog);
+        expect(r.modelId).toBe('anthropic:claude-text');
+        expect(r.satisfiesCapabilities).toBe(false);
+        expect(r.missingCapabilities).toContain('vision');
+    });
+    it('keeps an uncatalogued override and flags it as not satisfying capabilities', () => {
+        const cfg = config({
+            features: [{ ...textFeature, modelId: 'anthropic:ghost-model' }],
+        });
+        const r = resolveFeatureModel(cfg, textFeature.key, []);
+        expect(r.modelId).toBe('anthropic:ghost-model');
+        expect(r.source).toBe('feature-override');
+        expect(r.satisfiesCapabilities).toBe(false);
+    });
+    it('returns source "none" with no model configured', () => {
+        const cfg = config({ features: [textFeature] });
+        const r = resolveFeatureModel(cfg, textFeature.key, []);
+        expect(r.source).toBe('none');
+        expect(r.modelId).toBeUndefined();
+        expect(r.missingCapabilities).toContain('text');
+    });
+    it('does not select an unavailable model when an available one exists', () => {
+        const catalog = [
+            model('anthropic:dead', { text: true }, { status: 'unavailable' }),
+            model('anthropic:live', { text: true }),
+        ];
+        const cfg = config({
+            defaultModelId: 'anthropic:dead',
+            features: [{ ...textFeature, fallbackModelIds: ['anthropic:live'] }],
+        });
+        const r = resolveFeatureModel(cfg, textFeature.key, catalog);
+        expect(r.modelId).toBe('anthropic:live');
+        expect(r.source).toBe('fallback');
+    });
+    it('resolveAllFeatureModels keys by feature', () => {
+        const catalog = [model('anthropic:claude-x', { text: true })];
+        const cfg = config({ defaultModelId: 'anthropic:claude-x', features: [textFeature] });
+        const all = resolveAllFeatureModels(cfg, catalog);
+        expect(Object.keys(all)).toEqual([textFeature.key]);
+        expect(all[textFeature.key]?.modelId).toBe('anthropic:claude-x');
+    });
+});
+//# sourceMappingURL=resolve.test.js.map

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

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

package/dist/ai/index.d.ts

@@ -9,5 +9,6 @@ export { AI_FEATURE_DEFAULTS, cloneFeatureDefaults, mergeFeatures } from './feat
 export { curatedFallbackCatalog, normalizeModel } from './catalog.js';
 export { getModels, resolveModelOrUnavailable, syncModels, type SyncModelsResult, } from './models.js';
 export { getUsageSummary } from './usage.js';
+export { resolveFeatureModel, resolveAllFeatureModels, type FeatureModelSource, type ResolvedFeatureModel, } from './resolve.js';
 export { getAdapter, listModels as adapterListModels, testConnection as adapterTestConnection, type AdapterContext, } from './providers/index.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAA;AAC1B,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,KAAK,EACL,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,gBAAgB,GACjB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAChG,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AACrE,OAAO,EACL,SAAS,EACT,yBAAyB,EACzB,UAAU,EACV,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,EACL,UAAU,EACV,UAAU,IAAI,iBAAiB,EAC/B,cAAc,IAAI,qBAAqB,EACvC,KAAK,cAAc,GACpB,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAA;AAC1B,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,KAAK,EACL,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,gBAAgB,GACjB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAChG,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AACrE,OAAO,EACL,SAAS,EACT,yBAAyB,EACzB,UAAU,EACV,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,GAC1B,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,UAAU,EACV,UAAU,IAAI,iBAAiB,EAC/B,cAAc,IAAI,qBAAqB,EACvC,KAAK,cAAc,GACpB,MAAM,sBAAsB,CAAA"}

package/dist/ai/index.js

@@ -9,5 +9,6 @@ export { AI_FEATURE_DEFAULTS, cloneFeatureDefaults, mergeFeatures } from './feat
 export { curatedFallbackCatalog, normalizeModel } from './catalog.js';
 export { getModels, resolveModelOrUnavailable, syncModels, } from './models.js';
 export { getUsageSummary } from './usage.js';
+export { resolveFeatureModel, resolveAllFeatureModels, } from './resolve.js';
 export { getAdapter, listModels as adapterListModels, testConnection as adapterTestConnection, } from './providers/index.js';
 //# sourceMappingURL=index.js.map

package/dist/ai/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAA;AAC1B,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,KAAK,EACL,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,gBAAgB,GACjB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAChG,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AACrE,OAAO,EACL,SAAS,EACT,yBAAyB,EACzB,UAAU,GAEX,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,EACL,UAAU,EACV,UAAU,IAAI,iBAAiB,EAC/B,cAAc,IAAI,qBAAqB,GAExC,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAA;AAC1B,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,KAAK,EACL,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,gBAAgB,GACjB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAChG,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AACrE,OAAO,EACL,SAAS,EACT,yBAAyB,EACzB,UAAU,GAEX,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GAGxB,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,UAAU,EACV,UAAU,IAAI,iBAAiB,EAC/B,cAAc,IAAI,qBAAqB,GAExC,MAAM,sBAAsB,CAAA"}

package/dist/ai/resolve.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Feature → model routing resolution.
+ *
+ * This is the authoritative runtime resolver: given the stored AI config and the
+ * current model catalog, it decides which provider connection + model a feature
+ * should use. Resolution order for each feature:
+ *
+ *   1. The feature's explicit `modelId` override (if it exists in the catalog).
+ *   2. A capability-typed default that matches the feature's dominant required
+ *      capability (e.g. a vision feature falls back to `defaultVisionModelId`).
+ *   3. The global `defaultModelId`.
+ *   4. Any `fallbackModelIds` listed on the feature.
+ *
+ * The first candidate that is present in the catalog, available, AND satisfies
+ * every required capability wins. If none fully satisfy, we still return the
+ * best candidate we found and report the missing capabilities so callers (UI +
+ * enforcement) can warn rather than silently misroute. The admin UI mirrors a
+ * simplified version of this for live preview, but THIS function is the source
+ * of truth consumed by the AI runtime.
+ */
+import type { AIConfigDocument, AIModel } from './types.js';
+/** Where the resolved model came from in the precedence chain above. */
+export type FeatureModelSource = 'feature-override' | 'capability-default' | 'global-default' | 'fallback' | 'none';
+export interface ResolvedFeatureModel {
+    featureKey: string;
+    /** Catalog model id (`provider:modelId`), or the raw override when uncatalogued. */
+    modelId?: string;
+    /** Provider connection id that owns the resolved model. */
+    providerId?: string;
+    model?: AIModel;
+    source: FeatureModelSource;
+    /** True when a usable model was found that satisfies every required capability. */
+    satisfiesCapabilities: boolean;
+    /** Required capabilities the resolved model is missing (empty when satisfied). */
+    missingCapabilities: string[];
+}
+/** Resolve the provider + model a single feature should use. */
+export declare function resolveFeatureModel(config: AIConfigDocument, featureKey: string, catalog: AIModel[]): ResolvedFeatureModel;
+/** Resolve routing for every configured feature, keyed by feature key. */
+export declare function resolveAllFeatureModels(config: AIConfigDocument, catalog: AIModel[]): Record<string, ResolvedFeatureModel>;
+//# sourceMappingURL=resolve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/ai/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,OAAO,EAIR,MAAM,YAAY,CAAA;AAEnB,wEAAwE;AACxE,MAAM,MAAM,kBAAkB,GAC1B,kBAAkB,GAClB,oBAAoB,GACpB,gBAAgB,GAChB,UAAU,GACV,MAAM,CAAA;AAEV,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAA;IAClB,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,kBAAkB,CAAA;IAC1B,mFAAmF;IACnF,qBAAqB,EAAE,OAAO,CAAA;IAC9B,kFAAkF;IAClF,mBAAmB,EAAE,MAAM,EAAE,CAAA;CAC9B;AAiFD,gEAAgE;AAChE,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,EAAE,GACjB,oBAAoB,CA2DtB;AAED,0EAA0E;AAC1E,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,OAAO,EAAE,GACjB,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAMtC"}

package/dist/ai/resolve.js

@@ -0,0 +1,142 @@
+/**
+ * Feature → model routing resolution.
+ *
+ * This is the authoritative runtime resolver: given the stored AI config and the
+ * current model catalog, it decides which provider connection + model a feature
+ * should use. Resolution order for each feature:
+ *
+ *   1. The feature's explicit `modelId` override (if it exists in the catalog).
+ *   2. A capability-typed default that matches the feature's dominant required
+ *      capability (e.g. a vision feature falls back to `defaultVisionModelId`).
+ *   3. The global `defaultModelId`.
+ *   4. Any `fallbackModelIds` listed on the feature.
+ *
+ * The first candidate that is present in the catalog, available, AND satisfies
+ * every required capability wins. If none fully satisfy, we still return the
+ * best candidate we found and report the missing capabilities so callers (UI +
+ * enforcement) can warn rather than silently misroute. The admin UI mirrors a
+ * simplified version of this for live preview, but THIS function is the source
+ * of truth consumed by the AI runtime.
+ */
+/** Capability flags recognized on {@link AIModel.capabilities}. */
+const CAPABILITY_KEYS = new Set([
+    'text',
+    'vision',
+    'imageGeneration',
+    'embeddings',
+    'toolCalling',
+    'structuredOutput',
+    'streaming',
+    'reasoning',
+    'longContext',
+]);
+function findModel(catalog, id) {
+    if (!id)
+        return undefined;
+    return catalog.find((m) => m.id === id || m.providerModelId === id);
+}
+/** Required capabilities a model is missing. Unknown capability strings are ignored. */
+function missingCaps(model, required) {
+    const wanted = required.filter((c) => CAPABILITY_KEYS.has(c));
+    if (!model)
+        return wanted;
+    const caps = model.capabilities;
+    return wanted.filter((c) => !caps[c]);
+}
+/** Map a feature's dominant required capability to its typed default model id. */
+function capabilityDefault(settings, required) {
+    if (required.includes('imageGeneration'))
+        return settings.defaultImageGenerationModelId;
+    if (required.includes('embeddings'))
+        return settings.defaultEmbeddingModelId;
+    if (required.includes('vision'))
+        return settings.defaultVisionModelId;
+    if (required.includes('reasoning'))
+        return settings.defaultReasoningModelId;
+    if (required.includes('text'))
+        return settings.defaultTextModelId;
+    return undefined;
+}
+/**
+ * Resolve a provider connection id for a model's provider key. Prefers an
+ * explicit feature override, then the global default provider when it matches,
+ * then the first enabled connection, then any connection of that provider.
+ */
+function providerConnId(providers, providerKey, preferredId) {
+    if (preferredId) {
+        const pref = providers.find((p) => p.id === preferredId && p.provider === providerKey);
+        if (pref)
+            return pref.id;
+    }
+    const enabled = providers.find((p) => p.provider === providerKey && p.enabled);
+    if (enabled)
+        return enabled.id;
+    return providers.find((p) => p.provider === providerKey)?.id;
+}
+function build(featureKey, model, source, config, required, preferredProviderId) {
+    const missing = missingCaps(model, required);
+    return {
+        featureKey,
+        modelId: model.id,
+        providerId: providerConnId(config.providers, model.provider, preferredProviderId ?? config.settings.defaultProviderId),
+        model,
+        source,
+        satisfiesCapabilities: missing.length === 0 && model.status !== 'unavailable',
+        missingCapabilities: missing,
+    };
+}
+/** Resolve the provider + model a single feature should use. */
+export function resolveFeatureModel(config, featureKey, catalog) {
+    const { settings } = config;
+    const feature = settings.features.find((f) => f.key === featureKey);
+    const required = feature?.requiredCapabilities ?? [];
+    const candidates = [
+        { id: feature?.modelId, source: 'feature-override' },
+        { id: capabilityDefault(settings, required), source: 'capability-default' },
+        { id: settings.defaultModelId, source: 'global-default' },
+        ...(feature?.fallbackModelIds ?? []).map((id) => ({ id, source: 'fallback' })),
+    ];
+    // Best case: first candidate that is catalogued, available, and capable.
+    let firstFound;
+    for (const candidate of candidates) {
+        const model = findModel(catalog, candidate.id);
+        if (!model)
+            continue;
+        if (!firstFound)
+            firstFound = { model, source: candidate.source };
+        if (model.status !== 'unavailable' && missingCaps(model, required).length === 0) {
+            return build(featureKey, model, candidate.source, config, required, feature?.providerId);
+        }
+    }
+    // A model was found but it's unavailable or capability-short — return it with a warning.
+    if (firstFound) {
+        return build(featureKey, firstFound.model, firstFound.source, config, required, feature?.providerId);
+    }
+    // An explicit override that isn't in the catalog yet (provider not synced).
+    if (feature?.modelId) {
+        return {
+            featureKey,
+            modelId: feature.modelId,
+            providerId: feature.providerId ??
+                providerConnId(config.providers, feature.modelId.split(':')[0] ?? 'custom', config.settings.defaultProviderId),
+            source: 'feature-override',
+            satisfiesCapabilities: false,
+            missingCapabilities: required.filter((c) => CAPABILITY_KEYS.has(c)),
+        };
+    }
+    return {
+        featureKey,
+        source: 'none',
+        satisfiesCapabilities: required.filter((c) => CAPABILITY_KEYS.has(c)).length === 0,
+        missingCapabilities: missingCaps(undefined, required),
+    };
+}
+/** Resolve routing for every configured feature, keyed by feature key. */
+export function resolveAllFeatureModels(config, catalog) {
+    const out = {};
+    for (const feature of config.settings.features) {
+        out[feature.key] = resolveFeatureModel(config, feature.key, catalog);
+    }
+    return out;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/ai/resolve.js.map

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

package/dist/ai/usage.js

@@ -42,7 +42,7 @@ export async function getUsageSummary(db, period) {
     let rows = [];
     try {
         rows = await d.auditLog.findMany({
-            where: { createdAt: { gte: start, lt: end } },
+            where: { timestamp: { gte: start, lt: end } },
             select: { details: true },
         });
     }

package/dist/api/handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/api/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAwhC5C,iFAAiF;AACjF,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AA8JD,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAS9E;AAiVD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqiYzD"}
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/api/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAwhC5C,iFAAiF;AACjF,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AA8JD,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAS9E;AAiVD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqlYzD"}

package/dist/api/handlers.js

@@ -10161,12 +10161,58 @@ export function registerCMSRoutes(router) {
                 else
                     return errorResponse('monthlyTokenLimit must be a non-negative number or null', 400);
             }
-            // Apply feature toggles by key (ignore unknown keys).
-            const toggles = new Map((body.features ?? []).map((f) => [f.key, Boolean(f.enabled)]));
-            const nextFeatures = config.settings.features.map((f) => toggles.has(f.key) ? { ...f, enabled: toggles.get(f.key) } : f);
+            // Validate per-feature model/provider routing overrides. Empty string and
+            // null both clear the override (revert to the default model).
+            const featurePatches = body.features ?? [];
+            for (const patch of featurePatches) {
+                if (patch.modelId != null && patch.modelId !== '') {
+                    const m = catalog.find((x) => x.id === patch.modelId || x.providerModelId === patch.modelId);
+                    if (!m)
+                        return errorResponse(`Model "${patch.modelId}" is not in the catalog`, 400);
+                    if (m.status === 'unavailable') {
+                        return errorResponse(`Model "${patch.modelId}" is currently unavailable`, 400);
+                    }
+                }
+                if (patch.providerId != null &&
+                    patch.providerId !== '' &&
+                    !config.providers.some((p) => p.id === patch.providerId)) {
+                    return errorResponse(`Provider "${patch.providerId}" is not connected`, 400);
+                }
+            }
+            // Apply feature patches by key (ignore unknown keys). Each patch may toggle
+            // `enabled` and/or set the per-feature model/provider routing override.
+            const patchByKey = new Map(featurePatches.map((f) => [f.key, f]));
+            const clearOverride = (v) => v == null || v === '' ? undefined : v;
+            const nextFeatures = config.settings.features.map((f) => {
+                const patch = patchByKey.get(f.key);
+                if (!patch)
+                    return f;
+                const next = { ...f };
+                if (typeof patch.enabled === 'boolean')
+                    next.enabled = patch.enabled;
+                if ('modelId' in patch)
+                    next.modelId = clearOverride(patch.modelId);
+                if ('providerId' in patch)
+                    next.providerId = clearOverride(patch.providerId);
+                return next;
+            });
             const changedFeatures = config.settings.features
-                .filter((f) => toggles.has(f.key) && toggles.get(f.key) !== f.enabled)
-                .map((f) => ({ key: f.key, from: f.enabled, to: toggles.get(f.key) }));
+                .map((f) => {
+                const patch = patchByKey.get(f.key);
+                if (!patch)
+                    return null;
+                const enabledChanged = typeof patch.enabled === 'boolean' && patch.enabled !== f.enabled;
+                const nextModelId = 'modelId' in patch ? clearOverride(patch.modelId) : f.modelId;
+                const modelChanged = 'modelId' in patch && (nextModelId ?? null) !== (f.modelId ?? null);
+                if (!enabledChanged && !modelChanged)
+                    return null;
+                return {
+                    key: f.key,
+                    ...(enabledChanged ? { enabledFrom: f.enabled, enabledTo: patch.enabled } : {}),
+                    ...(modelChanged ? { modelFrom: f.modelId ?? null, modelTo: nextModelId ?? null } : {}),
+                };
+            })
+                .filter((x) => x !== null);
             const nextSettings = {
                 ...config.settings,
                 defaultProviderId: body.defaultProviderId === null