devchain-cli 0.17.1 → 0.18.0

package/dist/server/modules/metrics/services/metrics.service.js

@@ -0,0 +1,241 @@
+"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.MetricsService = void 0;
+const common_1 = require("@nestjs/common");
+const node_perf_hooks_1 = require("node:perf_hooks");
+const logger_1 = require("../../../common/logging/logger");
+const byte_accounting_helper_1 = require("../helpers/byte-accounting.helper");
+const logger = (0, logger_1.createLogger)('MetricsService');
+const DEFAULT_LOG_INTERVAL_MS = 60_000;
+const CACHE_SNAPSHOT_TTL_MS = 10_000;
+class TransactionalObjectIdentitySet {
+    constructor(committed) {
+        this.committed = committed;
+        this.pending = new Set();
+    }
+    has(value) {
+        return this.committed.has(value) || this.pending.has(value);
+    }
+    add(value) {
+        this.pending.add(value);
+        return this;
+    }
+    commit() {
+        for (const value of this.pending) {
+            this.committed.add(value);
+        }
+    }
+}
+const ACCOUNTING_INFO = {
+    method: 'transactional unique object-graph snapshot for retained-root providers; additive fallback for providers without roots',
+    sharedGraphRule: 'each provider stages visited identities and commits them only after its complete walk succeeds — failed providers cannot suppress shared objects from later healthy providers; successful cross-cache sharing is counted once and cycles are safe',
+    perCacheViews: 'parsed/chunks per-cache bytes are walk-attribution shares from the shared aggregate walk (additive, order-dependent); DTO per-cache bytes are the independent JSON wire-size view (not additive with the others); callers must not sum all per-cache values — do not sum per-cache views; use aggregate.bytesEstimated for the unique retained-bytes snapshot',
+    approximation: 'aggregate retained-size estimate uses property keys + primitive sizes + object/array overhead, not serialized JSON length; DTO per-cache bytes use the pre-computed JSON.stringify wire length',
+    hotPathSafety: 'byte estimation runs on-demand only (metrics endpoint / periodic log), never on cache read/write paths; entry counts and hit/miss counters are always-on and O(1)',
+    budgeting: 'transcript composite budget uses deterministic cache-write proxies: file source bytes (2x parsed + 1x chunks), session-local token/message estimates for DB sources, and the DTO wire length already computed at DTO cache creation; aggregate.budgetUsedBytes is the enforced value and aggregate.bytesEstimated remains the independent retained-graph snapshot',
+};
+let MetricsService = class MetricsService {
+    constructor() {
+        this.eventLoopMonitor = (0, node_perf_hooks_1.monitorEventLoopDelay)();
+        this.cacheStatsProviders = new Map();
+        this.statsProviders = new Map();
+    }
+    registerCacheStatsProvider(name, provider, retainedRoots) {
+        this.cacheStatsProviders.set(name, { stats: provider, retainedRoots });
+        this.cacheSnapshotCache = undefined;
+    }
+    registerStatsProvider(name, provider) {
+        this.statsProviders.set(name, provider);
+    }
+    onModuleInit() {
+        this.eventLoopMonitor.enable();
+        const intervalMs = this.parseLogInterval();
+        if (intervalMs > 0) {
+            this.periodicLogTimer = setInterval(() => {
+                try {
+                    logger.info(this.getMetrics(), 'metrics.periodic');
+                }
+                catch (err) {
+                    logger.error({ error: String(err) }, 'metrics.periodic.failed');
+                }
+            }, intervalMs);
+            this.periodicLogTimer.unref();
+        }
+    }
+    onModuleDestroy() {
+        this.eventLoopMonitor.disable();
+        if (this.periodicLogTimer) {
+            clearInterval(this.periodicLogTimer);
+            this.periodicLogTimer = undefined;
+        }
+    }
+    getMetrics() {
+        const mem = process.memoryUsage();
+        const cacheSnapshot = this.getCacheSnapshot();
+        const frameBuffers = this.getStat('frameBuffers', {
+            sessions: 0,
+            totalFrames: 0,
+            bytesEstimated: 0,
+            maxBufferCapacity: 0,
+        });
+        const sockets = this.getStat('sockets', { connectedClients: 0 });
+        const pty = this.getStat('pty', { activeSessions: 0 });
+        return {
+            timestamp: new Date().toISOString(),
+            process: {
+                pid: process.pid,
+                memory: {
+                    rss: mem.rss,
+                    heapTotal: mem.heapTotal,
+                    heapUsed: mem.heapUsed,
+                    external: mem.external,
+                    arrayBuffers: mem.arrayBuffers,
+                },
+                eventLoopDelay: this.getEventLoopDelay(),
+                listeners: {
+                    SIGINT: process.listenerCount('SIGINT'),
+                    SIGTERM: process.listenerCount('SIGTERM'),
+                    uncaughtException: process.listenerCount('uncaughtException'),
+                    unhandledRejection: process.listenerCount('unhandledRejection'),
+                },
+            },
+            caches: cacheSnapshot,
+            frameBuffers,
+            pty,
+            sockets,
+            accounting: ACCOUNTING_INFO,
+        };
+    }
+    getCacheSnapshot() {
+        const now = Date.now();
+        if (this.cacheSnapshotCache &&
+            now - this.cacheSnapshotCache.computedAt < CACHE_SNAPSHOT_TTL_MS) {
+            return this.cloneCacheSnapshot(this.cacheSnapshotCache.value);
+        }
+        const value = this.computeCacheSnapshot();
+        this.cacheSnapshotCache = { computedAt: now, value };
+        return this.cloneCacheSnapshot(value);
+    }
+    computeCacheSnapshot() {
+        const aggregateSeen = new WeakSet();
+        const caches = {};
+        let aggregateEntries = 0;
+        let aggregateBytes = 0;
+        let aggregateHits = 0;
+        let aggregateMisses = 0;
+        let providersFailed = 0;
+        let budgetUsedBytes;
+        let budgetBytes;
+        let evictions;
+        for (const [name, provider] of this.cacheStatsProviders) {
+            try {
+                const stats = { ...provider.stats() };
+                let providerBytes = stats.bytesEstimated;
+                if (provider.retainedRoots) {
+                    const providerSeen = new TransactionalObjectIdentitySet(aggregateSeen);
+                    const retainedRoots = Array.from(provider.retainedRoots());
+                    providerBytes = retainedRoots.reduce((total, root) => total + (0, byte_accounting_helper_1.estimateObjectBytes)(root, providerSeen), 0);
+                    if (stats.bytesMethod === 'deferred-to-aggregate') {
+                        stats.bytesEstimated = providerBytes;
+                        stats.bytesMethod = 'object-graph-walk';
+                    }
+                    providerSeen.commit();
+                }
+                caches[name] = stats;
+                aggregateEntries += stats.entries;
+                aggregateBytes += providerBytes;
+                aggregateHits += stats.hits;
+                aggregateMisses += stats.misses;
+                if (stats.budgetUsedBytes !== undefined)
+                    budgetUsedBytes = stats.budgetUsedBytes;
+                if (stats.budgetBytes !== undefined)
+                    budgetBytes = stats.budgetBytes;
+                if (stats.evictions !== undefined)
+                    evictions = stats.evictions;
+            }
+            catch (err) {
+                providersFailed += 1;
+                caches[name] = {
+                    entries: 0,
+                    bytesEstimated: 0,
+                    hits: 0,
+                    misses: 0,
+                    hitRate: 0,
+                };
+                logger.warn({ cache: name, error: String(err) }, 'cache stats provider failed');
+            }
+        }
+        const aggregate = {
+            entries: aggregateEntries,
+            bytesEstimated: aggregateBytes,
+            hits: aggregateHits,
+            misses: aggregateMisses,
+            hitRate: aggregateHits + aggregateMisses > 0 ? aggregateHits / (aggregateHits + aggregateMisses) : 0,
+            providersFailed,
+            ...(budgetUsedBytes !== undefined ? { budgetUsedBytes } : {}),
+            ...(budgetBytes !== undefined ? { budgetBytes } : {}),
+            ...(evictions !== undefined ? { evictions } : {}),
+        };
+        return { ...caches, aggregate };
+    }
+    cloneCacheSnapshot(snapshot) {
+        return Object.fromEntries(Object.entries(snapshot).map(([name, stats]) => [name, { ...stats }]));
+    }
+    getStat(name, fallback) {
+        const provider = this.statsProviders.get(name);
+        if (!provider)
+            return fallback;
+        try {
+            return provider();
+        }
+        catch (err) {
+            logger.warn({ stat: name, error: String(err) }, 'stats provider failed');
+            return fallback;
+        }
+    }
+    getEventLoopDelay() {
+        const h = this.eventLoopMonitor;
+        const nanoseconds = {
+            min: h.min,
+            max: h.max,
+            mean: h.mean,
+            stddev: h.stddev,
+            p99: h.percentile(99),
+            p99_5: h.percentile(99.5),
+        };
+        if (nanoseconds.min > Number.MAX_SAFE_INTEGER ||
+            Object.values(nanoseconds).some((value) => !Number.isFinite(value))) {
+            return null;
+        }
+        const NS_TO_MS = 1e6;
+        const milliseconds = {
+            minMs: nanoseconds.min / NS_TO_MS,
+            maxMs: nanoseconds.max / NS_TO_MS,
+            meanMs: nanoseconds.mean / NS_TO_MS,
+            stddevMs: nanoseconds.stddev / NS_TO_MS,
+            p99Ms: nanoseconds.p99 / NS_TO_MS,
+            p99_5Ms: nanoseconds.p99_5 / NS_TO_MS,
+        };
+        return Object.values(milliseconds).every(Number.isFinite) ? milliseconds : null;
+    }
+    parseLogInterval() {
+        const raw = process.env.METRICS_LOG_INTERVAL_MS;
+        if (!raw)
+            return DEFAULT_LOG_INTERVAL_MS;
+        const parsed = parseInt(raw, 10);
+        if (!Number.isFinite(parsed) || parsed < 0)
+            return DEFAULT_LOG_INTERVAL_MS;
+        return parsed;
+    }
+};
+exports.MetricsService = MetricsService;
+exports.MetricsService = MetricsService = __decorate([
+    (0, common_1.Injectable)()
+], MetricsService);
+//# sourceMappingURL=metrics.service.js.map

package/dist/server/modules/metrics/services/metrics.service.js.map

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

package/dist/server/modules/metrics/types/metrics.types.d.ts

@@ -0,0 +1,100 @@
+export interface CacheStats {
+    entries: number;
+    bytesEstimated: number;
+    hits: number;
+    misses: number;
+    hitRate: number;
+    bytesMethod?: 'object-graph-walk' | 'json-stringify-length' | 'deferred-to-aggregate';
+    budgetUsedBytes?: number;
+    budgetBytes?: number;
+    evictions?: number;
+}
+export interface FrameBufferStats {
+    sessions: number;
+    totalFrames: number;
+    bytesEstimated: number;
+    maxBufferCapacity: number;
+}
+export interface SocketStats {
+    connectedClients: number;
+    terminalSeedCaptures?: number;
+    terminalQueuedBytes?: number;
+    terminalInFlightBytes?: number;
+    terminalDesynchronizedClients?: number;
+    terminalDesynchronizedLanes?: number;
+    terminalDroppedFrames?: number;
+    terminalDroppedBytes?: number;
+    terminalQueues?: Record<string, {
+        queuedBytes: number;
+        inFlightBytes: number;
+        desynchronized: boolean;
+        droppedFrames: number;
+        droppedBytes: number;
+        engineBufferedPackets: number;
+        lanes: Record<string, {
+            queuedBytes: number;
+            desynchronized: boolean;
+            recoveryActive: boolean;
+            recoveryEpoch?: number;
+            droppedFrames: number;
+            droppedBytes: number;
+        }>;
+    }>;
+}
+export interface PtyStats {
+    activeSessions: number;
+}
+export interface EventLoopDelayStats {
+    minMs: number;
+    maxMs: number;
+    meanMs: number;
+    stddevMs: number;
+    p99Ms: number;
+    p99_5Ms: number;
+}
+export interface ProcessListenerStats {
+    SIGINT: number;
+    SIGTERM: number;
+    uncaughtException: number;
+    unhandledRejection: number;
+}
+export interface ProcessMemoryStats {
+    rss: number;
+    heapTotal: number;
+    heapUsed: number;
+    external: number;
+    arrayBuffers: number;
+}
+export interface ProcessStats {
+    pid: number;
+    memory: ProcessMemoryStats;
+    eventLoopDelay: EventLoopDelayStats | null;
+    listeners: ProcessListenerStats;
+}
+export interface CacheAggregateStats extends CacheStats {
+    providersFailed: number;
+}
+export interface CacheStatsCollection {
+    [name: string]: CacheStats | CacheAggregateStats;
+    aggregate: CacheAggregateStats;
+}
+export interface AccountingInfo {
+    method: string;
+    sharedGraphRule: string;
+    perCacheViews: string;
+    approximation: string;
+    hotPathSafety: string;
+    budgeting: string;
+}
+export interface MetricsSnapshot {
+    timestamp: string;
+    process: ProcessStats;
+    caches: CacheStatsCollection;
+    frameBuffers: FrameBufferStats;
+    pty: PtyStats;
+    sockets: SocketStats;
+    accounting: AccountingInfo;
+}
+export type CacheStatsProvider = () => CacheStats;
+export type RetainedRootsProvider = () => Iterable<unknown>;
+export type StatsProvider<T = unknown> = () => T;

package/dist/server/modules/{providers/adapters/capabilities/context-window.capability.js → metrics/types/metrics.types.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=context-window.capability.js.map
+//# sourceMappingURL=metrics.types.js.map

package/dist/server/modules/metrics/types/metrics.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.types.js","sourceRoot":"","sources":["../../../../src/modules/metrics/types/metrics.types.ts"],"names":[],"mappings":""}

package/dist/server/modules/profiles/dto.d.ts

@@ -121,7 +121,7 @@ export declare const CreateProviderConfigSchema: z.ZodObject<{
     name: z.ZodString;
     description: z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodString>>, string | null, string | null | undefined>;
     options: z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodString>>, string | null, string | null | undefined>;
-    env: z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodString>, Record<string, string>, Record<string, string>>, Record<string, string>, Record<string, string>>>>, Record<string, string> | null, Record<string, string> | null | undefined>;
+    env: z.ZodEffects<z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodString>, Record<string, string>, Record<string, string>>, Record<string, string>, Record<string, string>>>>, Record<string, string> | null | undefined, Record<string, string> | null | undefined>, Record<string, string> | null, Record<string, string> | null | undefined>;
     model: z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodString>>, string | null, string | null | undefined>;
     effort: z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodString>>, string | null, string | null | undefined>;
     position: z.ZodOptional<z.ZodNumber>;
@@ -150,7 +150,7 @@ export declare const UpdateProviderConfigSchema: z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     options: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    env: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodString>, Record<string, string>, Record<string, string>>, Record<string, string>, Record<string, string>>>>;
+    env: z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodString>, Record<string, string>, Record<string, string>>, Record<string, string>, Record<string, string>>>>, Record<string, string> | null | undefined, Record<string, string> | null | undefined>;
     model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     effort: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     position: z.ZodOptional<z.ZodNumber>;

package/dist/server/modules/profiles/dto.js

@@ -4,6 +4,18 @@ exports.ReorderProviderConfigsSchema = exports.UpdateProviderConfigSchema = expo
 const zod_1 = require("zod");
 const shared_1 = require("@devchain/shared");
 Object.defineProperty(exports, "EnvVarsSchema", { enumerable: true, get: function () { return shared_1.EnvVarsSchema; } });
+const context_window_policy_1 = require("../runtime-context-capture/context-window-policy");
+const runtime_context_capture_types_1 = require("../runtime-context-capture/runtime-context-capture.types");
+const ProviderConfigEnvSchema = shared_1.EnvVarsSchema.superRefine((env, ctx) => {
+    const result = (0, context_window_policy_1.parseContextWindowEnv)(env?.[context_window_policy_1.CONTEXT_WINDOW_ENV_KEY]);
+    if (result.kind === 'invalid') {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            path: [context_window_policy_1.CONTEXT_WINDOW_ENV_KEY],
+            message: `${context_window_policy_1.CONTEXT_WINDOW_ENV_KEY} must be a positive integer no greater than ${runtime_context_capture_types_1.MAX_RUNTIME_CONTEXT_WINDOW_TOKENS}.`,
+        });
+    }
+});
 exports.PromptSummarySchema = zod_1.z.object({
     promptId: zod_1.z.string(),
     title: zod_1.z.string(),
@@ -50,7 +62,7 @@ exports.CreateProviderConfigSchema = zod_1.z.object({
         .nullable()
         .optional()
         .transform((v) => (v === undefined ? null : v)),
-    env: shared_1.EnvVarsSchema.transform((v) => (v === undefined ? null : v)),
+    env: ProviderConfigEnvSchema.transform((v) => (v === undefined ? null : v)),
     model: zod_1.z
         .string()
         .nullable()
@@ -68,7 +80,7 @@ exports.UpdateProviderConfigSchema = zod_1.z.object({
     name: zod_1.z.string().min(1).optional(),
     description: zod_1.z.string().nullable().optional(),
     options: zod_1.z.string().nullable().optional(),
-    env: shared_1.EnvVarsSchema,
+    env: ProviderConfigEnvSchema,
     model: zod_1.z.string().nullable().optional(),
     effort: zod_1.z.string().nullable().optional(),
     position: zod_1.z.number().int().nonnegative().optional(),

package/dist/server/modules/profiles/dto.js.map

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

package/dist/server/modules/projects/controllers/projects.controller.d.ts

@@ -80,7 +80,7 @@ export declare class ProjectsController {
         order?: number | undefined;
     } | null>;
     setupPreview(body: unknown): Promise<import("../dtos/setup-preview.dto").SetupPreviewResponse>;
-    createProjectFromTemplate(body: unknown): Promise<{
+    createProjectFromTemplate(body: unknown): Promise<import("../../../common/prompt-references").PromptReferenceValidationFailure | {
         success: false;
         providerMappingRequired: {
             missingProviders: string[];
@@ -105,6 +105,7 @@ export declare class ProjectsController {
             subscribers: number;
             scheduledEpics: number;
         };
+        promptTransfer: import("../../../common/prompt-transfer").PromptTransferCounts;
         mappings: {
             promptIdMap: Record<string, string>;
             profileIdMap: Record<string, string>;
@@ -212,8 +213,6 @@ export declare class ProjectsController {
         providerSettings?: {
             name: string;
             autoCompactThreshold: number | null;
-            autoCompactThreshold1m?: number | null;
-            oneMillionContextEnabled?: boolean;
             env?: Record<string, string> | null;
         }[] | undefined;
         projectSettings?: import("../template-codec/codecs/project-settings.codec").ProjectSettingsExport | undefined;
@@ -374,8 +373,6 @@ export declare class ProjectsController {
         providerSettings?: {
             name: string;
             autoCompactThreshold: number | null;
-            autoCompactThreshold1m?: number | null;
-            oneMillionContextEnabled?: boolean;
             env?: Record<string, string> | null;
         }[] | undefined;
         projectSettings?: import("../template-codec/codecs/project-settings.codec").ProjectSettingsExport | undefined;
@@ -451,7 +448,7 @@ export declare class ProjectsController {
         agentOverrides?: unknown;
         selectedProviderNames?: unknown;
         [key: string]: unknown;
-    }): Promise<{
+    }): Promise<import("../../../common/prompt-references").PromptReferenceValidationFailure | {
         dryRun: true;
         missingProviders: string[];
         unmatchedStatuses: {
@@ -489,6 +486,7 @@ export declare class ProjectsController {
                 scheduledEpics: number;
             };
         };
+        promptTransfer: import("../../../common/prompt-transfer").PromptTransferCounts;
     } | {
         success: boolean;
         mode: string;
@@ -520,6 +518,7 @@ export declare class ProjectsController {
                 agentCleared: number;
             };
         };
+        promptTransfer: import("../../../common/prompt-transfer").PromptTransferCounts;
         mappings: {
             promptIdMap: Record<string, string>;
             profileIdMap: Record<string, string>;

package/dist/server/modules/projects/helpers/profile-mapping.helpers.d.ts

@@ -48,12 +48,14 @@ type NamedEntity = {
     id?: string;
     name: string;
 };
-export declare function resolveProvidersFromStorage(storage: Pick<StorageService, 'listProviders'>, providerNames: Set<string>, selectedProviderNames?: string[]): Promise<{
-    available: Map<string, string>;
+export declare function collectReferencedProviderNames(profiles: Array<Pick<FamilyTemplateProfile, 'provider' | 'providerConfigs'>>): Set<string>;
+export declare function resolveProvidersFromStorage(storage: Pick<StorageService, 'listProviders'>, referencedProviderNames: Set<string>, selectedProviderNames?: string[]): Promise<{
+    installed: Map<string, string>;
+    selected: Map<string, string>;
     missing: string[];
 }>;
 export declare function computeFamilyAlternativesFromStorage(storage: Pick<StorageService, 'listProviders'>, templateProfiles: FamilyTemplateProfile[], templateAgents: FamilyTemplateAgent[], logger?: LoggerLike, selectedProviderNames?: string[]): Promise<FamilyAlternativesResult>;
-export declare function computeFamilyAlternatives(templateProfiles: FamilyTemplateProfile[], templateAgents: FamilyTemplateAgent[], availableProviderNames: Set<string>, logger?: LoggerLike): FamilyAlternativesResult;
+export declare function computeFamilyAlternatives(templateProfiles: FamilyTemplateProfile[], templateAgents: FamilyTemplateAgent[], availableProviderNames: Set<string>, logger?: LoggerLike, installedProviderNames?: Set<string>): FamilyAlternativesResult;
 export interface PresetProviderCoverage {
     presetName: string;
     agentResolvedProviders: Map<string, string>;

package/dist/server/modules/projects/helpers/profile-mapping.helpers.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectReferencedProviderNames = collectReferencedProviderNames;
 exports.resolveProvidersFromStorage = resolveProvidersFromStorage;
 exports.computeFamilyAlternativesFromStorage = computeFamilyAlternativesFromStorage;
 exports.computeFamilyAlternatives = computeFamilyAlternatives;
@@ -21,28 +22,38 @@ function toProviderAllowlist(selectedProviderNames) {
         return undefined;
     return new Set(selectedProviderNames.map((name) => name.trim().toLowerCase()));
 }
-async function resolveProvidersFromStorage(storage, providerNames, selectedProviderNames) {
+function collectReferencedProviderNames(profiles) {
+    const referenced = new Set();
+    for (const profile of profiles) {
+        referenced.add(profile.provider.name.trim().toLowerCase());
+        for (const config of profile.providerConfigs ?? []) {
+            referenced.add(config.providerName.trim().toLowerCase());
+        }
+    }
+    return referenced;
+}
+async function resolveProvidersFromStorage(storage, referencedProviderNames, selectedProviderNames) {
     const providers = await storage.listProviders();
     const allow = toProviderAllowlist(selectedProviderNames);
-    const available = new Map();
+    const installed = new Map();
+    const selected = new Map();
     for (const prov of providers.items) {
         const key = prov.name.trim().toLowerCase();
-        if (allow && !allow.has(key))
-            continue;
-        available.set(key, prov.id);
+        installed.set(key, prov.id);
+        if (!allow || allow.has(key))
+            selected.set(key, prov.id);
     }
-    const missing = Array.from(providerNames).filter((name) => !available.has(name));
-    return { available, missing };
+    const missing = Array.from(referencedProviderNames).filter((name) => !installed.has(name));
+    return { installed, selected, missing };
 }
 async function computeFamilyAlternativesFromStorage(storage, templateProfiles, templateAgents, logger, selectedProviderNames) {
     const localProviders = await storage.listProviders();
     const allow = toProviderAllowlist(selectedProviderNames);
-    const availableProviderNames = new Set(localProviders.items
-        .map((provider) => provider.name.trim().toLowerCase())
-        .filter((name) => !allow || allow.has(name)));
-    return computeFamilyAlternatives(templateProfiles, templateAgents, availableProviderNames, logger);
+    const installedProviderNames = new Set(localProviders.items.map((provider) => provider.name.trim().toLowerCase()));
+    const availableProviderNames = new Set(Array.from(installedProviderNames).filter((name) => !allow || allow.has(name)));
+    return computeFamilyAlternatives(templateProfiles, templateAgents, availableProviderNames, logger, installedProviderNames);
 }
-function computeFamilyAlternatives(templateProfiles, templateAgents, availableProviderNames, logger) {
+function computeFamilyAlternatives(templateProfiles, templateAgents, availableProviderNames, logger, installedProviderNames) {
     const profileById = new Map();
     for (const prof of templateProfiles) {
         if (prof.id) {
@@ -85,6 +96,7 @@ function computeFamilyAlternatives(templateProfiles, templateAgents, availablePr
     }
     const alternatives = [];
     const missingProviders = new Set();
+    const installed = installedProviderNames ?? availableProviderNames;
     let canImport = true;
     for (const familySlug of usedFamilySlugs) {
         const providersForFamily = familyProviders.get(familySlug);
@@ -97,7 +109,7 @@ function computeFamilyAlternatives(templateProfiles, templateAgents, availablePr
         const defaultProviderAvailable = availableProviderNames.has(defaultProvider);
         const availableForFamily = providerNamesForFamily.filter((name) => availableProviderNames.has(name));
         for (const providerName of providerNamesForFamily) {
-            if (!availableProviderNames.has(providerName)) {
+            if (!installed.has(providerName)) {
                 missingProviders.add(providerName);
             }
         }