@nexus-ai-nexoralabs/cli 0.1.0

package/dist/desktop/main.js

@@ -0,0 +1,90 @@
+/**
+ * NEXUS AI — Desktop App Main Entry Point (P7-E)
+ *
+ * Electron main process bootstrap.
+ * Owns single-instance enforcement, ApplicationApi core initialization,
+ * local UIServer startup, AppWindow creation, and clean shutdown lifecycle.
+ *
+ * SECURITY INVARIANT:
+ *  - Single Backend Core: Bootstraps ApplicationApi directly. Zero secondary backend.
+ *  - Localhost Binding: UIServer binds strictly to 127.0.0.1.
+ *  - Single Instance Lock: Prevents duplicate database writers or port conflicts.
+ */
+import { app, BrowserWindow } from 'electron';
+import { ConfigService } from '../config/index.js';
+import { ApplicationApi } from '../api/index.js';
+import { UIServer } from '../ui/server.js';
+import { AppWindow } from './appWindow.js';
+import { Logger } from '../common/logger.js';
+let appApi = null;
+let uiServer = null;
+let appWindow = null;
+let isShuttingDown = false;
+// 1. Single Instance Lock
+const gotSingleInstanceLock = app.requestSingleInstanceLock();
+if (!gotSingleInstanceLock) {
+    console.log('[NEXUS Desktop] Secondary instance detected. Focusing existing window and exiting.');
+    app.quit();
+}
+else {
+    app.on('second-instance', () => {
+        // Focus existing window if second instance launched
+        const win = appWindow?.getWindow();
+        if (win) {
+            if (win.isMinimized())
+                win.restore();
+            win.focus();
+        }
+    });
+    // 2. Application Bootstrap
+    app.whenReady().then(async () => {
+        const configService = new ConfigService();
+        const config = configService.getConfig();
+        const logger = new Logger('DesktopMain', config.logLevel);
+        logger.info(`Bootstrapping NEXUS Desktop App shell in [${config.environment}] mode`);
+        appApi = new ApplicationApi(config);
+        await appApi.bootstrap();
+        // Start local UI server
+        uiServer = new UIServer(appApi, config.port, config.logLevel);
+        const listeningPort = await uiServer.start();
+        logger.info(`NEXUS Desktop UI Server listening on port ${listeningPort}`);
+        // Create desktop window
+        appWindow = new AppWindow();
+        appWindow.createWindow(listeningPort);
+        app.on('activate', () => {
+            if (BrowserWindow.getAllWindows().length === 0 && uiServer) {
+                appWindow?.createWindow(uiServer.getPort());
+            }
+        });
+    });
+    // 3. Graceful Shutdown Lifecycle
+    const performCleanShutdown = async () => {
+        if (isShuttingDown)
+            return;
+        isShuttingDown = true;
+        console.log('[NEXUS Desktop] Closing application core cleanly...');
+        try {
+            if (uiServer) {
+                await uiServer.stop();
+                uiServer = null;
+            }
+            if (appApi) {
+                appApi.close();
+                appApi = null;
+            }
+        }
+        catch (err) {
+            console.error('[NEXUS Desktop] Error during shutdown:', err);
+        }
+    };
+    app.on('window-all-closed', async () => {
+        await performCleanShutdown();
+        if (process.platform !== 'darwin') {
+            app.quit();
+        }
+    });
+    app.on('before-quit', async () => {
+        await performCleanShutdown();
+    });
+}
+//# sourceMappingURL=main.js.map

package/dist/desktop/main.js.map

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

package/dist/desktop/preload.d.ts

@@ -0,0 +1,14 @@
+/**
+ * NEXUS AI — Desktop Preload Script (P7-E)
+ *
+ * Context-isolated preload script.
+ * Exposes ONLY safe, read-only application metadata (`version`, `platform`, `isElectron`).
+ *
+ * SECURITY INVARIANT:
+ *  - ZERO direct Node.js execution exposed to renderer.
+ *  - ZERO shell execution APIs.
+ *  - ZERO filesystem read/write APIs exposed.
+ *  - ZERO arbitrary IPC handler execution.
+ */
+export {};
+//# sourceMappingURL=preload.d.ts.map

package/dist/desktop/preload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preload.d.ts","sourceRoot":"","sources":["../../src/desktop/preload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/desktop/preload.js

@@ -0,0 +1,20 @@
+/**
+ * NEXUS AI — Desktop Preload Script (P7-E)
+ *
+ * Context-isolated preload script.
+ * Exposes ONLY safe, read-only application metadata (`version`, `platform`, `isElectron`).
+ *
+ * SECURITY INVARIANT:
+ *  - ZERO direct Node.js execution exposed to renderer.
+ *  - ZERO shell execution APIs.
+ *  - ZERO filesystem read/write APIs exposed.
+ *  - ZERO arbitrary IPC handler execution.
+ */
+import { contextBridge } from 'electron';
+// Expose safe, non-sensitive desktop app metadata API to renderer
+contextBridge.exposeInMainWorld('nexusDesktop', {
+    isElectron: true,
+    platform: process.platform,
+    version: '0.1.0',
+});
+//# sourceMappingURL=preload.js.map

package/dist/desktop/preload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preload.js","sourceRoot":"","sources":["../../src/desktop/preload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,kEAAkE;AAClE,aAAa,CAAC,iBAAiB,CAAC,cAAc,EAAE;IAC9C,UAAU,EAAE,IAAI;IAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ;IAC1B,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC"}

package/dist/intelligence/index.d.ts

@@ -0,0 +1,33 @@
+import type { SubsystemStatus } from '../storage/index.js';
+import type { ModelsRepository } from '../storage/repositories/modelsRepository.js';
+import { OllamaAdapter } from './ollamaAdapter.js';
+import { ModelRegistry } from './modelRegistry.js';
+import { ModelRouter } from './modelRouter.js';
+import { ModelGateway } from './modelGateway.js';
+import { LogLevel } from '../common/logger.js';
+import { AIRuntimeManager, type InferenceProviderConfigMode } from './runtime/runtimeManager.js';
+import { OllamaRuntimeAdapter } from './runtime/ollamaRuntimeAdapter.js';
+import { EmbeddedRuntimeAdapter } from './runtime/embeddedRuntimeAdapter.js';
+export interface IIntelligenceService {
+    initialize(modelsRepo?: ModelsRepository): Promise<SubsystemStatus>;
+    getStatus(): SubsystemStatus;
+}
+export declare class IntelligenceService implements IIntelligenceService {
+    private ollamaHost;
+    private initialized;
+    private logger;
+    adapter: OllamaAdapter;
+    ollamaRuntimeAdapter: OllamaRuntimeAdapter;
+    embeddedRuntimeAdapter: EmbeddedRuntimeAdapter;
+    runtimeManager: AIRuntimeManager;
+    registry: ModelRegistry;
+    router: ModelRouter;
+    gateway: ModelGateway;
+    private runtimeHealth;
+    private modelsCount;
+    private installedModels;
+    constructor(ollamaHost?: string, logLevel?: LogLevel, providerMode?: InferenceProviderConfigMode);
+    initialize(modelsRepo?: ModelsRepository): Promise<SubsystemStatus>;
+    getStatus(): SubsystemStatus;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/intelligence/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAU,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,KAAK,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AACjG,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAG7E,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,UAAU,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACpE,SAAS,IAAI,eAAe,CAAC;CAC9B;AAED,qBAAa,mBAAoB,YAAW,oBAAoB;IAgB5D,OAAO,CAAC,UAAU;IAfpB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAS;IAChB,OAAO,EAAE,aAAa,CAAC;IACvB,oBAAoB,EAAE,oBAAoB,CAAC;IAC3C,sBAAsB,EAAE,sBAAsB,CAAC;IAC/C,cAAc,EAAE,gBAAgB,CAAC;IACjC,QAAQ,EAAG,aAAa,CAAC;IACzB,MAAM,EAAG,WAAW,CAAC;IACrB,OAAO,EAAG,YAAY,CAAC;IAE9B,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,eAAe,CAAgB;gBAG7B,UAAU,GAAE,MAAiC,EACrD,QAAQ,GAAE,QAAiB,EAC3B,YAAY,CAAC,EAAE,2BAA2B;IAWtC,UAAU,CAAC,UAAU,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAyBzE,SAAS,IAAI,eAAe;CA8B7B"}

package/dist/intelligence/index.js

@@ -0,0 +1,82 @@
+import { OllamaAdapter } from './ollamaAdapter.js';
+import { ModelRegistry } from './modelRegistry.js';
+import { ModelRouter } from './modelRouter.js';
+import { ModelGateway } from './modelGateway.js';
+import { Logger } from '../common/logger.js';
+import { AIRuntimeManager } from './runtime/runtimeManager.js';
+import { OllamaRuntimeAdapter } from './runtime/ollamaRuntimeAdapter.js';
+import { EmbeddedRuntimeAdapter } from './runtime/embeddedRuntimeAdapter.js';
+export class IntelligenceService {
+    ollamaHost;
+    initialized = false;
+    logger;
+    adapter;
+    ollamaRuntimeAdapter;
+    embeddedRuntimeAdapter;
+    runtimeManager;
+    registry;
+    router;
+    gateway;
+    runtimeHealth = null;
+    modelsCount = 0;
+    installedModels = [];
+    constructor(ollamaHost = 'http://127.0.0.1:11434', logLevel = 'info', providerMode) {
+        this.ollamaHost = ollamaHost;
+        this.logger = new Logger('IntelligenceService', logLevel);
+        this.adapter = new OllamaAdapter(this.ollamaHost, logLevel);
+        this.ollamaRuntimeAdapter = new OllamaRuntimeAdapter(this.ollamaHost, logLevel, this.adapter);
+        this.embeddedRuntimeAdapter = new EmbeddedRuntimeAdapter({ logLevel });
+        const providerEnv = providerMode || process.env.NEXUS_INFERENCE_PROVIDER || 'auto';
+        this.runtimeManager = new AIRuntimeManager(this.ollamaRuntimeAdapter, logLevel, providerEnv);
+    }
+    async initialize(modelsRepo) {
+        const providerMode = this.runtimeManager.getConfigMode();
+        this.logger.info(`Initializing IntelligenceService [Provider Mode: ${providerMode.toUpperCase()}]`);
+        this.runtimeHealth = await this.runtimeManager.getHealth(true);
+        if (modelsRepo) {
+            this.registry = new ModelRegistry(this.runtimeManager, modelsRepo, 'info');
+            this.router = new ModelRouter(this.registry, 'info');
+            this.gateway = new ModelGateway(this.runtimeManager, this.registry, this.router, modelsRepo, 'info');
+            if (this.runtimeHealth.status === 'READY') {
+                const models = await this.registry.syncDiscoveredModels();
+                this.modelsCount = models.length;
+                this.installedModels = models.map((m) => m.id);
+            }
+            else {
+                this.installedModels = this.registry.getAvailableModels().map((m) => m.id);
+                this.modelsCount = this.installedModels.length;
+            }
+        }
+        this.initialized = true;
+        return this.getStatus();
+    }
+    getStatus() {
+        const latestHealth = this.runtimeManager?.getCachedHealth() ?? this.runtimeHealth;
+        const activeProvider = this.runtimeManager?.getActiveProviderId() || 'embedded';
+        const isReady = latestHealth?.status === 'READY';
+        const providerLabel = activeProvider === 'embedded' ? 'Embedded (Local)' : `Ollama (${this.ollamaHost})`;
+        const message = isReady
+            ? `AI Runtime Active [Provider: ${providerLabel}] (v${latestHealth?.version || '0.1.0'}), ${this.modelsCount} model(s) ready`
+            : `AI Runtime Degraded [Provider: ${providerLabel}] (${latestHealth?.reason || 'Offline mode ready'})`;
+        return {
+            name: 'IntelligenceService',
+            initialized: this.initialized,
+            status: this.initialized ? (isReady ? 'ok' : 'degraded') : 'error',
+            message,
+            details: {
+                activeProvider,
+                providerMode: this.runtimeManager?.getConfigMode() || 'auto',
+                ollamaHost: this.ollamaHost,
+                runtimeStatus: latestHealth?.status || 'UNAVAILABLE',
+                aiAvailable: isReady,
+                ollamaAvailable: activeProvider === 'ollama' ? isReady : false,
+                runtimeVersion: latestHealth?.version || null,
+                reason: latestHealth?.reason,
+                suggestedAction: latestHealth?.suggestedAction,
+                modelsCount: this.modelsCount,
+                installedModels: this.installedModels,
+            },
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/intelligence/index.js.map

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

package/dist/intelligence/modelGateway.d.ts

@@ -0,0 +1,35 @@
+import type { OllamaAdapter, StreamChunk } from './ollamaAdapter.js';
+import type { ModelRegistry, ModelRoleCapability } from './modelRegistry.js';
+import type { ModelRouter } from './modelRouter.js';
+import type { ModelsRepository } from '../storage/repositories/modelsRepository.js';
+import { LogLevel } from '../common/logger.js';
+export interface InferenceRequestOptions {
+    prompt: string;
+    system?: string;
+    modelId?: string;
+    taskCapability?: ModelRoleCapability;
+    temperature?: number;
+    timeoutMs?: number;
+    allowFallback?: boolean;
+}
+export interface InferenceResponse {
+    modelId: string;
+    text: string;
+    done: boolean;
+    latencyMs: number;
+    usedFallback: boolean;
+    routingReason: string;
+}
+import type { AIRuntimeManager } from './runtime/runtimeManager.js';
+export declare class ModelGateway {
+    private adapterOrManager;
+    private registry;
+    private router;
+    private modelsRepo;
+    private logger;
+    constructor(adapterOrManager: OllamaAdapter | AIRuntimeManager, registry: ModelRegistry, router: ModelRouter, modelsRepo: ModelsRepository, logLevel?: LogLevel);
+    generate(options: InferenceRequestOptions, externalSignal?: AbortSignal): Promise<InferenceResponse>;
+    generateStream(options: InferenceRequestOptions, onChunk: (chunk: StreamChunk) => void, externalSignal?: AbortSignal): Promise<InferenceResponse>;
+    private recordTelemetry;
+}
+//# sourceMappingURL=modelGateway.d.ts.map

package/dist/intelligence/modelGateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelGateway.d.ts","sourceRoot":"","sources":["../../src/intelligence/modelGateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAkB,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AACpF,OAAO,EAAU,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,qBAAa,YAAY;IAIrB,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,UAAU;IANpB,OAAO,CAAC,MAAM,CAAS;gBAGb,gBAAgB,EAAE,aAAa,GAAG,gBAAgB,EAClD,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,gBAAgB,EACpC,QAAQ,GAAE,QAAiB;IAKvB,QAAQ,CAAC,OAAO,EAAE,uBAAuB,EAAE,cAAc,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA4EpG,cAAc,CAClB,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,EACrC,cAAc,CAAC,EAAE,WAAW,GAC3B,OAAO,CAAC,iBAAiB,CAAC;IAqC7B,OAAO,CAAC,eAAe;CAkBxB"}

package/dist/intelligence/modelGateway.js

@@ -0,0 +1,123 @@
+import { Logger } from '../common/logger.js';
+export class ModelGateway {
+    adapterOrManager;
+    registry;
+    router;
+    modelsRepo;
+    logger;
+    constructor(adapterOrManager, registry, router, modelsRepo, logLevel = 'info') {
+        this.adapterOrManager = adapterOrManager;
+        this.registry = registry;
+        this.router = router;
+        this.modelsRepo = modelsRepo;
+        this.logger = new Logger('ModelGateway', logLevel);
+    }
+    async generate(options, externalSignal) {
+        const route = this.router.selectRoute(options.modelId, options.taskCapability);
+        const startTime = Date.now();
+        let targetModel = route.primaryModel;
+        let usedFallback = false;
+        try {
+            const res = await this.adapterOrManager.generate({
+                model: targetModel.id,
+                prompt: options.prompt,
+                system: options.system,
+                temperature: options.temperature,
+                timeoutMs: options.timeoutMs,
+            }, externalSignal);
+            const latencyMs = Date.now() - startTime;
+            this.recordTelemetry(targetModel.id, 'success', latencyMs);
+            return {
+                modelId: targetModel.id,
+                text: res.response,
+                done: res.done,
+                latencyMs,
+                usedFallback,
+                routingReason: route.routingReason,
+            };
+        }
+        catch (primaryErr) {
+            const primaryModelId = targetModel.id;
+            const primaryMsg = primaryErr instanceof Error ? primaryErr.message : String(primaryErr);
+            const latencyMs = Date.now() - startTime;
+            this.recordTelemetry(primaryModelId, 'error', latencyMs, 'PRIMARY_MODEL_FAILED');
+            this.logger.warn(`Primary model '${primaryModelId}' failed: ${primaryMsg}`);
+            if (options.allowFallback && route.fallbackModel) {
+                this.logger.info(`Attempting fallback to model '${route.fallbackModel.id}'`);
+                targetModel = route.fallbackModel;
+                usedFallback = true;
+                const fbStartTime = Date.now();
+                try {
+                    const fbRes = await this.adapterOrManager.generate({
+                        model: targetModel.id,
+                        prompt: options.prompt,
+                        system: options.system,
+                        temperature: options.temperature,
+                        timeoutMs: options.timeoutMs,
+                    }, externalSignal);
+                    const fbLatencyMs = Date.now() - fbStartTime;
+                    this.recordTelemetry(targetModel.id, 'success', fbLatencyMs);
+                    return {
+                        modelId: targetModel.id,
+                        text: fbRes.response,
+                        done: fbRes.done,
+                        latencyMs: Date.now() - startTime,
+                        usedFallback: true,
+                        routingReason: `${route.routingReason} -> Fallback to ${targetModel.id}`,
+                    };
+                }
+                catch (fbErr) {
+                    const fbMsg = fbErr instanceof Error ? fbErr.message : String(fbErr);
+                    this.recordTelemetry(targetModel.id, 'error', Date.now() - fbStartTime, 'FALLBACK_MODEL_FAILED');
+                    throw new Error(`Inference failed on both primary (${primaryModelId}) and fallback (${targetModel.id}): ${fbMsg}`);
+                }
+            }
+            throw new Error(`Inference execution failed on model '${primaryModelId}': ${primaryMsg}`);
+        }
+    }
+    async generateStream(options, onChunk, externalSignal) {
+        const route = this.router.selectRoute(options.modelId, options.taskCapability);
+        const startTime = Date.now();
+        const targetModel = route.primaryModel;
+        try {
+            const res = await this.adapterOrManager.generateStream({
+                model: targetModel.id,
+                prompt: options.prompt,
+                system: options.system,
+                temperature: options.temperature,
+                timeoutMs: options.timeoutMs,
+            }, onChunk, externalSignal);
+            const latencyMs = Date.now() - startTime;
+            this.recordTelemetry(targetModel.id, 'success', latencyMs);
+            return {
+                modelId: targetModel.id,
+                text: res.response,
+                done: res.done,
+                latencyMs,
+                usedFallback: false,
+                routingReason: route.routingReason,
+            };
+        }
+        catch (err) {
+            const latencyMs = Date.now() - startTime;
+            const msg = err instanceof Error ? err.message : String(err);
+            this.recordTelemetry(targetModel.id, 'error', latencyMs, 'STREAM_FAILED');
+            throw new Error(`Streaming inference execution failed on model '${targetModel.id}': ${msg}`);
+        }
+    }
+    recordTelemetry(modelId, status, latencyMs, errorCategory) {
+        try {
+            this.modelsRepo.recordTelemetry({
+                id: `tel-${Date.now()}-${Math.random().toString(36).substring(2, 7)}`,
+                modelId,
+                status,
+                latencyMs,
+                errorCategory: errorCategory || null,
+            });
+        }
+        catch (err) {
+            this.logger.warn(`Failed writing model telemetry: ${String(err)}`);
+        }
+    }
+}
+//# sourceMappingURL=modelGateway.js.map

package/dist/intelligence/modelGateway.js.map

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

package/dist/intelligence/modelRegistry.d.ts

@@ -0,0 +1,17 @@
+import type { ModelsRepository, ModelRecord } from '../storage/repositories/modelsRepository.js';
+import type { OllamaAdapter } from './ollamaAdapter.js';
+import { LogLevel } from '../common/logger.js';
+import type { AIRuntimeManager } from './runtime/runtimeManager.js';
+export type ModelRoleCapability = 'coding' | 'reasoning' | 'planning' | 'lightweight' | 'summarization' | 'general';
+export declare class ModelRegistry {
+    private adapterOrManager;
+    private modelsRepo;
+    private logger;
+    constructor(adapterOrManager: OllamaAdapter | AIRuntimeManager, modelsRepo: ModelsRepository, logLevel?: LogLevel);
+    private inferCapabilities;
+    syncDiscoveredModels(): Promise<ModelRecord[]>;
+    getAvailableModels(): ModelRecord[];
+    getModel(id: string): ModelRecord | null;
+    findModelsByCapability(capability: ModelRoleCapability): ModelRecord[];
+}
+//# sourceMappingURL=modelRegistry.d.ts.map

package/dist/intelligence/modelRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelRegistry.d.ts","sourceRoot":"","sources":["../../src/intelligence/modelRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AACjG,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAU,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAGpE,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,aAAa,GAAG,eAAe,GAAG,SAAS,CAAC;AAEpH,qBAAa,aAAa;IAItB,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,UAAU;IAJpB,OAAO,CAAC,MAAM,CAAS;gBAGb,gBAAgB,EAAE,aAAa,GAAG,gBAAgB,EAClD,UAAU,EAAE,gBAAgB,EACpC,QAAQ,GAAE,QAAiB;IAK7B,OAAO,CAAC,iBAAiB;IAyBnB,oBAAoB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAiDpD,kBAAkB,IAAI,WAAW,EAAE;IAInC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAIxC,sBAAsB,CAAC,UAAU,EAAE,mBAAmB,GAAG,WAAW,EAAE;CAIvE"}

package/dist/intelligence/modelRegistry.js

@@ -0,0 +1,87 @@
+import { Logger } from '../common/logger.js';
+export class ModelRegistry {
+    adapterOrManager;
+    modelsRepo;
+    logger;
+    constructor(adapterOrManager, modelsRepo, logLevel = 'info') {
+        this.adapterOrManager = adapterOrManager;
+        this.modelsRepo = modelsRepo;
+        this.logger = new Logger('ModelRegistry', logLevel);
+    }
+    inferCapabilities(modelName) {
+        const lower = modelName.toLowerCase();
+        const caps = new Set(['general']);
+        if (lower.includes('coder') || lower.includes('code') || lower.includes('heretic')) {
+            caps.add('coding');
+        }
+        if (lower.includes('deepseek') || lower.includes('r1') || lower.includes('reasoning')) {
+            caps.add('reasoning');
+            caps.add('planning');
+        }
+        if (lower.includes('3b') || lower.includes('mini') || lower.includes('small') || lower.includes('fast')) {
+            caps.add('lightweight');
+            caps.add('planning');
+        }
+        if (lower.includes('llama') || lower.includes('qwen')) {
+            caps.add('summarization');
+            if (!lower.includes('coder')) {
+                caps.add('planning');
+            }
+        }
+        return Array.from(caps);
+    }
+    async syncDiscoveredModels() {
+        this.logger.info('Discovering local models for ModelRegistry');
+        try {
+            let items = [];
+            if ('listModels' in this.adapterOrManager) {
+                items = await this.adapterOrManager.listModels(true);
+            }
+            else {
+                items = await this.adapterOrManager.discoverModels();
+            }
+            const discoveredIds = [];
+            const updatedRecords = [];
+            for (const item of items) {
+                const id = 'id' in item ? item.id : item.name;
+                discoveredIds.push(id);
+                const capabilities = this.inferCapabilities(id);
+                const versionTag = ('parameterSize' in item && item.parameterSize)
+                    ? item.parameterSize
+                    : ('details' in item && item.details?.parameter_size)
+                        ? item.details.parameter_size
+                        : item.digest?.substring(0, 12) || 'latest';
+                const record = this.modelsRepo.upsert({
+                    id,
+                    name: id,
+                    provider: 'ollama',
+                    versionTag,
+                    capabilities,
+                    contextLimit: 4096,
+                    isAvailable: true,
+                });
+                updatedRecords.push(record);
+            }
+            // Mark models no longer detected by Ollama as unavailable
+            this.modelsRepo.markAllUnavailableExcept(discoveredIds);
+            this.logger.info(`ModelRegistry sync complete. Discovered ${updatedRecords.length} model(s).`);
+            return updatedRecords;
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            this.logger.warn(`ModelRegistry sync failed: ${message}`);
+            return this.modelsRepo.listAvailable();
+        }
+    }
+    getAvailableModels() {
+        return this.modelsRepo.listAvailable();
+    }
+    getModel(id) {
+        return this.modelsRepo.findById(id);
+    }
+    findModelsByCapability(capability) {
+        const available = this.getAvailableModels();
+        return available.filter((m) => m.capabilities.includes(capability));
+    }
+}
+//# sourceMappingURL=modelRegistry.js.map

package/dist/intelligence/modelRegistry.js.map

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

package/dist/intelligence/modelRouter.d.ts

@@ -0,0 +1,76 @@
+import type { ModelRegistry, ModelRoleCapability } from './modelRegistry.js';
+import type { ModelRecord } from '../storage/repositories/modelsRepository.js';
+import { LogLevel } from '../common/logger.js';
+export type ModelRole = 'planner' | 'coder' | 'reasoning' | 'chat';
+export interface ModelOverrides {
+    global?: string;
+    roles: {
+        planner?: string;
+        coder?: string;
+        reasoning?: string;
+        chat?: string;
+    };
+}
+export interface ModelOverrideResult {
+    success: boolean;
+    model?: ModelRecord;
+    role?: ModelRole;
+    message?: string;
+}
+export interface RouteSelection {
+    primaryModel: ModelRecord;
+    fallbackModel: ModelRecord | null;
+    routingReason: string;
+}
+/**
+ * Map a ModelRoleCapability to its primary ModelRole.
+ */
+export declare function capabilityToRole(capability?: ModelRoleCapability): ModelRole;
+export declare class ModelRouter {
+    private registry;
+    private logger;
+    private overrides;
+    constructor(registry: ModelRegistry, logLevel?: LogLevel);
+    /**
+     * Resolve a model reference (1-based index number or string ID) to a ModelRecord.
+     */
+    resolveModel(input: string | number): ModelRecord | null;
+    /**
+     * Set a global model override by 1-based index or model ID string.
+     */
+    setGlobalOverride(input: string | number): ModelOverrideResult;
+    /**
+     * Set a role-specific model override (planner, coder, reasoning, chat).
+     */
+    setRoleOverride(role: ModelRole, input: string | number): ModelOverrideResult;
+    /**
+     * Reset overrides back to automatic capability-based routing.
+     * If role is omitted, clears all overrides.
+     */
+    resetOverrides(role?: ModelRole): {
+        success: boolean;
+        resetRoles: ModelRole[];
+        message: string;
+    };
+    /**
+     * Get current model overrides state.
+     */
+    getOverrides(): ModelOverrides;
+    /**
+     * Get effective active model for each role.
+     */
+    getRoleStatus(): Record<ModelRole, {
+        modelId: string;
+        source: 'USER' | 'AUTO';
+    }>;
+    /**
+     * Select a route for inference based on precedence hierarchy:
+     * 1. Explicit modelId parameter passed directly to call
+     * 2. Role-specific explicit override
+     * 3. Global explicit override
+     * 4. Automatic capability-based routing
+     */
+    selectRoute(explicitModelId?: string, taskCapability?: ModelRoleCapability, role?: ModelRole): RouteSelection;
+    private selectRouteInternal;
+}
+//# sourceMappingURL=modelRouter.d.ts.map

package/dist/intelligence/modelRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelRouter.d.ts","sourceRoot":"","sources":["../../src/intelligence/modelRouter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAC/E,OAAO,EAAU,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,MAAM,CAAC;AAEnE,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE;QACL,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,WAAW,CAAC;IAC1B,aAAa,EAAE,WAAW,GAAG,IAAI,CAAC;IAClC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAY5E;AAED,qBAAa,WAAW;IAOpB,OAAO,CAAC,QAAQ;IANlB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAEf;gBAGQ,QAAQ,EAAE,aAAa,EAC/B,QAAQ,GAAE,QAAiB;IAK7B;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,IAAI;IAoBxD;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,mBAAmB;IAqB9D;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,mBAAmB;IA+B7E;;;OAGG;IACH,cAAc,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,SAAS,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IA6BhG;;OAEG;IACH,YAAY,IAAI,cAAc;IAO9B;;OAEG;IACH,aAAa,IAAI,MAAM,CAAC,SAAS,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAwBhF;;;;;;OAMG;IACH,WAAW,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,mBAAmB,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,cAAc;IAI7G,OAAO,CAAC,mBAAmB;CA2F5B"}