@nexus-ai-nexoralabs/cli 0.1.0

package/dist/intelligence/runtime/ollamaRuntimeAdapter.js

@@ -0,0 +1,131 @@
+/**
+ * NEXUS AI — Ollama Runtime Adapter (P7-B)
+ *
+ * Infrastructure layer connecting AIRuntimeAdapter abstraction to local Ollama daemon.
+ * Provides deterministic health states, model readiness, bounded warm-up, and diagnostics.
+ */
+import { Logger } from '../../common/logger.js';
+import { OllamaAdapter } from '../ollamaAdapter.js';
+export class OllamaRuntimeAdapter {
+    providerId = 'ollama';
+    logger;
+    adapter;
+    constructor(host = 'http://127.0.0.1:11434', logLevel = 'info', existingAdapter) {
+        this.logger = new Logger('OllamaRuntimeAdapter', logLevel);
+        this.adapter = existingAdapter ?? new OllamaAdapter(host, logLevel);
+    }
+    getHost() {
+        return this.adapter.getHost();
+    }
+    getUnderlyingAdapter() {
+        return this.adapter;
+    }
+    async checkHealth(timeoutMs = 3000) {
+        const host = this.getHost();
+        const nowIso = new Date().toISOString();
+        if (!host || !host.startsWith('http')) {
+            return {
+                providerId: 'ollama',
+                status: 'NOT_CONFIGURED',
+                endpoint: host || 'invalid',
+                reason: 'OLLAMA_HOST endpoint is missing or malformed',
+                suggestedAction: 'Configure OLLAMA_HOST environment variable with a valid http:// or https:// URL.',
+                timestamp: nowIso,
+            };
+        }
+        const health = await this.adapter.checkHealth(timeoutMs);
+        if (!health.available) {
+            const isConnRefused = health.error?.includes('ECONNREFUSED') ||
+                health.error?.includes('fetch failed') ||
+                health.error?.includes('connect ECONNREFUSED');
+            return {
+                providerId: 'ollama',
+                status: isConnRefused ? 'UNREACHABLE' : 'UNAVAILABLE',
+                endpoint: host,
+                reason: health.error || 'Connection refused or daemon offline',
+                suggestedAction: isConnRefused
+                    ? 'Start the local Ollama runtime process (run "ollama serve" or launch Ollama application).'
+                    : 'Check Ollama server logs and verify host endpoint.',
+                timestamp: nowIso,
+            };
+        }
+        return {
+            providerId: 'ollama',
+            status: 'READY',
+            endpoint: host,
+            version: health.version || 'unknown',
+            timestamp: nowIso,
+        };
+    }
+    async discoverModels(timeoutMs = 5000) {
+        try {
+            const items = await this.adapter.discoverModels(timeoutMs);
+            return items.map((item) => ({
+                id: item.name,
+                name: item.name,
+                sizeBytes: item.size,
+                modifiedAt: item.modified_at,
+                digest: item.digest,
+                format: item.details?.format,
+                family: item.details?.family,
+                parameterSize: item.details?.parameter_size,
+                quantizationLevel: item.details?.quantization_level,
+                readiness: 'MODEL_READY',
+            }));
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            this.logger.warn(`Model discovery failed on Ollama runtime (${this.getHost()}): ${msg}`);
+            return [];
+        }
+    }
+    async checkModelReadiness(modelId, timeoutMs = 5000) {
+        try {
+            const models = await this.discoverModels(timeoutMs);
+            const exists = models.some((m) => m.id === modelId || m.name === modelId);
+            if (exists) {
+                return { readiness: 'MODEL_READY' };
+            }
+            return {
+                readiness: 'MODEL_NOT_INSTALLED',
+                details: `Model '${modelId}' is not installed in local Ollama runtime.`,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                readiness: 'MODEL_ERROR',
+                details: `Failed checking model readiness for '${modelId}': ${msg}`,
+            };
+        }
+    }
+    async warmupModel(modelId, timeoutMs = 5000, externalSignal) {
+        const startTime = Date.now();
+        this.logger.info(`Warming up model '${modelId}' on Ollama runtime...`);
+        try {
+            // Execute 1-token prompt for bounded warm-up
+            await this.adapter.generate({
+                model: modelId,
+                prompt: 'hi',
+                temperature: 0.1,
+                timeoutMs,
+            }, externalSignal);
+            const latencyMs = Date.now() - startTime;
+            this.logger.info(`Model '${modelId}' warm-up successful (${latencyMs}ms)`);
+            return { success: true, modelId, latencyMs };
+        }
+        catch (err) {
+            const latencyMs = Date.now() - startTime;
+            const msg = err instanceof Error ? err.message : String(err);
+            this.logger.warn(`Model '${modelId}' warm-up failed (${latencyMs}ms): ${msg}`);
+            return { success: false, modelId, latencyMs, error: msg };
+        }
+    }
+    async generate(options, externalSignal) {
+        return this.adapter.generate(options, externalSignal);
+    }
+    async generateStream(options, onChunk, externalSignal) {
+        return this.adapter.generateStream(options, onChunk, externalSignal);
+    }
+}
+//# sourceMappingURL=ollamaRuntimeAdapter.js.map

package/dist/intelligence/runtime/ollamaRuntimeAdapter.js.map

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

package/dist/intelligence/runtime/runtimeManager.d.ts

@@ -0,0 +1,37 @@
+/**
+ * NEXUS AI — AI Runtime Manager (P7-B / Phase 3)
+ *
+ * Orchestrates runtime adapters (Embedded & Ollama), caches health checks & model discovery,
+ * provides unified model readiness checking, auto-fallback provider selection, and inference dispatch.
+ */
+import { LogLevel } from '../../common/logger.js';
+import type { GenerateOptions, GenerateResult, StreamChunk } from '../ollamaAdapter.js';
+import type { AIRuntimeAdapter, RuntimeHealth, RuntimeModelInfo, ModelReadinessState, WarmupResult, RuntimeProviderId } from './types.js';
+export type InferenceProviderConfigMode = 'embedded' | 'ollama' | 'auto';
+export declare class AIRuntimeManager {
+    private logger;
+    private adapters;
+    private activeProviderId;
+    private configMode;
+    private healthCache;
+    private modelCache;
+    private cacheTtlMs;
+    constructor(defaultAdapter?: AIRuntimeAdapter, logLevel?: LogLevel, configMode?: InferenceProviderConfigMode);
+    registerAdapter(adapter: AIRuntimeAdapter): void;
+    getConfigMode(): InferenceProviderConfigMode;
+    setConfigMode(mode: InferenceProviderConfigMode): void;
+    getActiveProviderId(): RuntimeProviderId;
+    setActiveProviderId(providerId: RuntimeProviderId): void;
+    getActiveAdapter(): AIRuntimeAdapter;
+    getHealth(forceRefresh?: boolean): Promise<RuntimeHealth>;
+    getCachedHealth(): RuntimeHealth | null;
+    listModels(forceRefresh?: boolean): Promise<RuntimeModelInfo[]>;
+    checkModelReadiness(modelId: string): Promise<{
+        readiness: ModelReadinessState;
+        details?: string;
+    }>;
+    warmupModel(modelId: string, timeoutMs?: number): Promise<WarmupResult>;
+    generate(options: GenerateOptions, externalSignal?: AbortSignal): Promise<GenerateResult>;
+    generateStream(options: GenerateOptions, onChunk: (chunk: StreamChunk) => void, externalSignal?: AbortSignal): Promise<GenerateResult>;
+}
+//# sourceMappingURL=runtimeManager.d.ts.map

package/dist/intelligence/runtime/runtimeManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeManager.d.ts","sourceRoot":"","sources":["../../../src/intelligence/runtime/runtimeManager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAU,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACxF,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAIpB,MAAM,MAAM,2BAA2B,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEzE,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAkD;IAClE,OAAO,CAAC,gBAAgB,CAAiC;IACzD,OAAO,CAAC,UAAU,CAAuC;IAGzD,OAAO,CAAC,WAAW,CAA4D;IAC/E,OAAO,CAAC,UAAU,CAAiE;IACnF,OAAO,CAAC,UAAU,CAAQ;gBAGxB,cAAc,CAAC,EAAE,gBAAgB,EACjC,QAAQ,GAAE,QAAiB,EAC3B,UAAU,CAAC,EAAE,2BAA2B;IA8B1C,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAKhD,aAAa,IAAI,2BAA2B;IAI5C,aAAa,CAAC,IAAI,EAAE,2BAA2B,GAAG,IAAI;IAKtD,mBAAmB,IAAI,iBAAiB;IAIxC,mBAAmB,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI;IAQxD,gBAAgB,IAAI,gBAAgB;IAQ9B,SAAS,CAAC,YAAY,UAAQ,GAAG,OAAO,CAAC,aAAa,CAAC;IAmE7D,eAAe,IAAI,aAAa,GAAG,IAAI;IAIjC,UAAU,CAAC,YAAY,UAAQ,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAY7D,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,mBAAmB,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAKnG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAK7E,QAAQ,CAAC,OAAO,EAAE,eAAe,EAAE,cAAc,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAKzF,cAAc,CAClB,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,EACrC,cAAc,CAAC,EAAE,WAAW,GAC3B,OAAO,CAAC,cAAc,CAAC;CAI3B"}

package/dist/intelligence/runtime/runtimeManager.js

@@ -0,0 +1,168 @@
+/**
+ * NEXUS AI — AI Runtime Manager (P7-B / Phase 3)
+ *
+ * Orchestrates runtime adapters (Embedded & Ollama), caches health checks & model discovery,
+ * provides unified model readiness checking, auto-fallback provider selection, and inference dispatch.
+ */
+import { Logger } from '../../common/logger.js';
+import { OllamaRuntimeAdapter } from './ollamaRuntimeAdapter.js';
+import { EmbeddedRuntimeAdapter } from './embeddedRuntimeAdapter.js';
+export class AIRuntimeManager {
+    logger;
+    adapters = new Map();
+    activeProviderId = 'embedded';
+    configMode = 'auto';
+    // Cache settings (TTL: 5000ms)
+    healthCache = null;
+    modelCache = null;
+    cacheTtlMs = 5000;
+    constructor(defaultAdapter, logLevel = 'info', configMode) {
+        this.logger = new Logger('AIRuntimeManager', logLevel);
+        const envMode = process.env.NEXUS_INFERENCE_PROVIDER || undefined;
+        if (configMode) {
+            this.configMode = configMode;
+        }
+        else if (envMode) {
+            this.configMode = envMode;
+        }
+        else if (defaultAdapter && defaultAdapter.providerId !== 'embedded') {
+            this.configMode = defaultAdapter.providerId;
+        }
+        else {
+            this.configMode = 'auto';
+        }
+        const embeddedAdapter = new EmbeddedRuntimeAdapter({ logLevel });
+        const ollamaAdapter = (defaultAdapter && defaultAdapter.providerId === 'ollama')
+            ? defaultAdapter
+            : new OllamaRuntimeAdapter('http://127.0.0.1:11434', logLevel);
+        this.registerAdapter(embeddedAdapter);
+        this.registerAdapter(ollamaAdapter);
+        if (this.configMode === 'ollama') {
+            this.activeProviderId = 'ollama';
+        }
+        else {
+            this.activeProviderId = 'embedded';
+        }
+    }
+    registerAdapter(adapter) {
+        this.adapters.set(adapter.providerId, adapter);
+        this.logger.info(`Registered AI runtime provider '${adapter.providerId}' (Endpoint: ${adapter.getHost()})`);
+    }
+    getConfigMode() {
+        return this.configMode;
+    }
+    setConfigMode(mode) {
+        this.configMode = mode;
+        this.healthCache = null;
+    }
+    getActiveProviderId() {
+        return this.activeProviderId;
+    }
+    setActiveProviderId(providerId) {
+        if (!this.adapters.has(providerId)) {
+            throw new Error(`Cannot set active provider '${providerId}': not registered.`);
+        }
+        this.activeProviderId = providerId;
+        this.healthCache = null;
+    }
+    getActiveAdapter() {
+        const adapter = this.adapters.get(this.activeProviderId);
+        if (!adapter) {
+            throw new Error(`Active AI runtime provider '${this.activeProviderId}' is not registered.`);
+        }
+        return adapter;
+    }
+    async getHealth(forceRefresh = false) {
+        const now = Date.now();
+        if (!forceRefresh && this.healthCache && now - this.healthCache.cachedAt < this.cacheTtlMs) {
+            return this.healthCache.health;
+        }
+        const envMode = process.env.NEXUS_INFERENCE_PROVIDER || this.configMode || 'auto';
+        if (envMode === 'embedded') {
+            const embeddedAdapter = this.adapters.get('embedded');
+            if (embeddedAdapter) {
+                this.activeProviderId = 'embedded';
+                const health = await embeddedAdapter.checkHealth(3000);
+                this.healthCache = { health, cachedAt: now };
+                return health;
+            }
+        }
+        else if (envMode === 'ollama') {
+            const ollamaAdapter = this.adapters.get('ollama');
+            if (ollamaAdapter) {
+                this.activeProviderId = 'ollama';
+                const health = await ollamaAdapter.checkHealth(3000);
+                this.healthCache = { health, cachedAt: now };
+                return health;
+            }
+        }
+        else {
+            // AUTO mode: Try Embedded first, fall back to Ollama if Embedded is unavailable
+            const embeddedAdapter = this.adapters.get('embedded');
+            if (embeddedAdapter) {
+                const embeddedHealth = await embeddedAdapter.checkHealth(3000);
+                if (embeddedHealth.status === 'READY') {
+                    this.activeProviderId = 'embedded';
+                    this.healthCache = { health: embeddedHealth, cachedAt: now };
+                    return embeddedHealth;
+                }
+            }
+            // Embedded unavailable -> Fallback to Ollama probe
+            const ollamaAdapter = this.adapters.get('ollama');
+            if (ollamaAdapter) {
+                const ollamaHealth = await ollamaAdapter.checkHealth(3000);
+                if (ollamaHealth.status === 'READY') {
+                    this.logger.warn('[RuntimeManager] Embedded runtime unavailable. Auto-falling back to Ollama runtime.');
+                    this.activeProviderId = 'ollama';
+                    this.healthCache = { health: ollamaHealth, cachedAt: now };
+                    return ollamaHealth;
+                }
+            }
+            // Both unavailable
+            const fallbackHealth = {
+                providerId: this.activeProviderId,
+                status: 'UNAVAILABLE',
+                endpoint: this.getActiveAdapter().getHost(),
+                reason: 'Both Embedded runtime and Ollama service are unavailable',
+                suggestedAction: 'Start embedded runtime or run Ollama service on http://127.0.0.1:11434',
+                timestamp: new Date().toISOString(),
+            };
+            this.healthCache = { health: fallbackHealth, cachedAt: now };
+            return fallbackHealth;
+        }
+        const adapter = this.getActiveAdapter();
+        const health = await adapter.checkHealth(3000);
+        this.healthCache = { health, cachedAt: now };
+        return health;
+    }
+    getCachedHealth() {
+        return this.healthCache?.health ?? null;
+    }
+    async listModels(forceRefresh = false) {
+        const now = Date.now();
+        if (!forceRefresh && this.modelCache && now - this.modelCache.cachedAt < this.cacheTtlMs) {
+            return this.modelCache.models;
+        }
+        const adapter = this.getActiveAdapter();
+        const models = await adapter.discoverModels(5000);
+        this.modelCache = { models, cachedAt: now };
+        return models;
+    }
+    async checkModelReadiness(modelId) {
+        const adapter = this.getActiveAdapter();
+        return adapter.checkModelReadiness(modelId);
+    }
+    async warmupModel(modelId, timeoutMs = 5000) {
+        const adapter = this.getActiveAdapter();
+        return adapter.warmupModel(modelId, timeoutMs);
+    }
+    async generate(options, externalSignal) {
+        const adapter = this.getActiveAdapter();
+        return adapter.generate(options, externalSignal);
+    }
+    async generateStream(options, onChunk, externalSignal) {
+        const adapter = this.getActiveAdapter();
+        return adapter.generateStream(options, onChunk, externalSignal);
+    }
+}
+//# sourceMappingURL=runtimeManager.js.map

package/dist/intelligence/runtime/runtimeManager.js.map

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

package/dist/intelligence/runtime/types.d.ts

@@ -0,0 +1,56 @@
+/**
+ * NEXUS AI — P7-B AI Runtime & Model Management Abstraction Types
+ *
+ * Defines runtime-agnostic abstractions for AI inference runtimes (Ollama, Embedded, Cloud).
+ */
+import type { GenerateOptions, GenerateResult, StreamChunk } from '../ollamaAdapter.js';
+export type RuntimeProviderId = 'ollama' | 'embedded' | 'cloud';
+export type RuntimeStatusState = 'NOT_CONFIGURED' | 'UNAVAILABLE' | 'UNREACHABLE' | 'READY' | 'DEGRADED' | 'ERROR';
+export type ModelReadinessState = 'MODEL_NOT_INSTALLED' | 'MODEL_AVAILABLE' | 'MODEL_UNAVAILABLE' | 'MODEL_LOADING' | 'MODEL_READY' | 'MODEL_ERROR';
+export interface RuntimeHealth {
+    providerId: RuntimeProviderId;
+    status: RuntimeStatusState;
+    endpoint: string;
+    version?: string;
+    reason?: string;
+    suggestedAction?: string;
+    timestamp: string;
+}
+export interface RuntimeCapabilities {
+    supportsStreaming: boolean;
+    supportsSystemPrompt: boolean;
+    supportsEmbeddings: boolean;
+    maxContextLength?: number;
+}
+export interface RuntimeModelInfo {
+    id: string;
+    name: string;
+    sizeBytes?: number;
+    modifiedAt?: string;
+    digest?: string;
+    format?: string;
+    family?: string;
+    parameterSize?: string;
+    quantizationLevel?: string;
+    readiness: ModelReadinessState;
+}
+export interface WarmupResult {
+    success: boolean;
+    modelId: string;
+    latencyMs: number;
+    error?: string;
+}
+export interface AIRuntimeAdapter {
+    readonly providerId: RuntimeProviderId;
+    getHost(): string;
+    checkHealth(timeoutMs?: number): Promise<RuntimeHealth>;
+    discoverModels(timeoutMs?: number): Promise<RuntimeModelInfo[]>;
+    checkModelReadiness(modelId: string, timeoutMs?: number): Promise<{
+        readiness: ModelReadinessState;
+        details?: string;
+    }>;
+    warmupModel(modelId: string, timeoutMs?: number, externalSignal?: AbortSignal): Promise<WarmupResult>;
+    generate(options: GenerateOptions, externalSignal?: AbortSignal): Promise<GenerateResult>;
+    generateStream(options: GenerateOptions, onChunk: (chunk: StreamChunk) => void, externalSignal?: AbortSignal): Promise<GenerateResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/intelligence/runtime/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/intelligence/runtime/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAExF,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;AAEhE,MAAM,MAAM,kBAAkB,GAC1B,gBAAgB,GAChB,aAAa,GACb,aAAa,GACb,OAAO,GACP,UAAU,GACV,OAAO,CAAC;AAEZ,MAAM,MAAM,mBAAmB,GAC3B,qBAAqB,GACrB,iBAAiB,GACjB,mBAAmB,GACnB,eAAe,GACf,aAAa,GACb,aAAa,CAAC;AAElB,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,mBAAmB,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,OAAO,IAAI,MAAM,CAAC;IAClB,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACxD,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAChE,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,mBAAmB,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACtG,QAAQ,CAAC,OAAO,EAAE,eAAe,EAAE,cAAc,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC1F,cAAc,CACZ,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,EACrC,cAAc,CAAC,EAAE,WAAW,GAC3B,OAAO,CAAC,cAAc,CAAC,CAAC;CAC5B"}

package/dist/intelligence/runtime/types.js

@@ -0,0 +1,7 @@
+/**
+ * NEXUS AI — P7-B AI Runtime & Model Management Abstraction Types
+ *
+ * Defines runtime-agnostic abstractions for AI inference runtimes (Ollama, Embedded, Cloud).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/intelligence/runtime/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/intelligence/runtime/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/knowledge/chunker.d.ts

@@ -0,0 +1,18 @@
+import type { ParsedDocument } from './parsers.js';
+export interface ChunkOptions {
+    targetChunkSize?: number;
+    overlapSize?: number;
+}
+export interface DocumentChunkSpec {
+    chunkIndex: number;
+    content: string;
+    section: string | null;
+    pageNumber: number | null;
+    tokenCount: number;
+}
+export declare class Chunker {
+    private defaultOptions;
+    constructor(defaultOptions?: ChunkOptions);
+    chunkDocument(doc: ParsedDocument, options?: ChunkOptions): DocumentChunkSpec[];
+}
+//# sourceMappingURL=chunker.d.ts.map

package/dist/knowledge/chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.d.ts","sourceRoot":"","sources":["../../src/knowledge/chunker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,WAAW,YAAY;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,OAAO;IACN,OAAO,CAAC,cAAc;gBAAd,cAAc,GAAE,YAAiB;IAE9C,aAAa,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,iBAAiB,EAAE;CAoDvF"}

package/dist/knowledge/chunker.js

@@ -0,0 +1,55 @@
+export class Chunker {
+    defaultOptions;
+    constructor(defaultOptions = {}) {
+        this.defaultOptions = defaultOptions;
+    }
+    chunkDocument(doc, options) {
+        const targetSize = options?.targetChunkSize || this.defaultOptions.targetChunkSize || 400;
+        const overlap = options?.overlapSize || this.defaultOptions.overlapSize || 50;
+        const chunks = [];
+        let globalIndex = 0;
+        for (const sec of doc.sections) {
+            const text = sec.content;
+            if (!text || text.trim().length === 0)
+                continue;
+            if (text.length <= targetSize) {
+                chunks.push({
+                    chunkIndex: globalIndex++,
+                    content: text,
+                    section: sec.title,
+                    pageNumber: sec.pageNumber,
+                    tokenCount: Math.ceil(text.length / 4),
+                });
+            }
+            else {
+                // Split section text into sliding chunks with overlap
+                let start = 0;
+                while (start < text.length) {
+                    let end = Math.min(start + targetSize, text.length);
+                    // If not at text end, try to snap to nearest space or newline
+                    if (end < text.length) {
+                        const lastSpace = text.lastIndexOf(' ', end);
+                        if (lastSpace > start + Math.floor(targetSize / 2)) {
+                            end = lastSpace + 1;
+                        }
+                    }
+                    const chunkText = text.substring(start, end).trim();
+                    if (chunkText.length > 0) {
+                        chunks.push({
+                            chunkIndex: globalIndex++,
+                            content: chunkText,
+                            section: sec.title,
+                            pageNumber: sec.pageNumber,
+                            tokenCount: Math.ceil(chunkText.length / 4),
+                        });
+                    }
+                    if (end >= text.length)
+                        break;
+                    start = Math.max(start + 1, end - overlap);
+                }
+            }
+        }
+        return chunks;
+    }
+}
+//# sourceMappingURL=chunker.js.map

package/dist/knowledge/chunker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.js","sourceRoot":"","sources":["../../src/knowledge/chunker.ts"],"names":[],"mappings":"AAeA,MAAM,OAAO,OAAO;IACE;IAApB,YAAoB,iBAA+B,EAAE;QAAjC,mBAAc,GAAd,cAAc,CAAmB;IAAG,CAAC;IAElD,aAAa,CAAC,GAAmB,EAAE,OAAsB;QAC9D,MAAM,UAAU,GAAG,OAAO,EAAE,eAAe,IAAI,IAAI,CAAC,cAAc,CAAC,eAAe,IAAI,GAAG,CAAC;QAC1F,MAAM,OAAO,GAAG,OAAO,EAAE,WAAW,IAAI,IAAI,CAAC,cAAc,CAAC,WAAW,IAAI,EAAE,CAAC;QAE9E,MAAM,MAAM,GAAwB,EAAE,CAAC;QACvC,IAAI,WAAW,GAAG,CAAC,CAAC;QAEpB,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC;YACzB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAEhD,IAAI,IAAI,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;gBAC9B,MAAM,CAAC,IAAI,CAAC;oBACV,UAAU,EAAE,WAAW,EAAE;oBACzB,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,GAAG,CAAC,KAAK;oBAClB,UAAU,EAAE,GAAG,CAAC,UAAU;oBAC1B,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;iBACvC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,sDAAsD;gBACtD,IAAI,KAAK,GAAG,CAAC,CAAC;gBACd,OAAO,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;oBAC3B,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;oBAEpD,8DAA8D;oBAC9D,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;wBACtB,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;wBAC7C,IAAI,SAAS,GAAG,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,EAAE,CAAC;4BACnD,GAAG,GAAG,SAAS,GAAG,CAAC,CAAC;wBACtB,CAAC;oBACH,CAAC;oBAED,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;oBACpD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACzB,MAAM,CAAC,IAAI,CAAC;4BACV,UAAU,EAAE,WAAW,EAAE;4BACzB,OAAO,EAAE,SAAS;4BAClB,OAAO,EAAE,GAAG,CAAC,KAAK;4BAClB,UAAU,EAAE,GAAG,CAAC,UAAU;4BAC1B,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;yBAC5C,CAAC,CAAC;oBACL,CAAC;oBAED,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM;wBAAE,MAAM;oBAC9B,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC;gBAC7C,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/knowledge/citationService.d.ts

@@ -0,0 +1,26 @@
+import type { SearchCandidate } from './vectorStore.js';
+export interface SourceCitation {
+    documentId: string;
+    filename: string;
+    sourcePath: string;
+    section: string | null;
+    pageNumber: number | null;
+    chunkId: string;
+    snippet: string;
+    score: number;
+}
+export type GroundingStatus = 'GROUNDED' | 'PARTIALLY_GROUNDED' | 'UNGROUNDED';
+export interface RetrievalResultPackage {
+    query: string;
+    citations: SourceCitation[];
+    groundingStatus: GroundingStatus;
+    evidenceText: string;
+    totalCandidatesFound: number;
+}
+export declare class CitationService {
+    formatCitations(candidates: SearchCandidate[]): SourceCitation[];
+    evaluateGrounding(citations: SourceCitation[]): GroundingStatus;
+    assembleEvidenceBlock(citations: SourceCitation[]): string;
+    formatCitationFooter(citations: SourceCitation[]): string;
+}
+//# sourceMappingURL=citationService.d.ts.map

package/dist/knowledge/citationService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"citationService.d.ts","sourceRoot":"","sources":["../../src/knowledge/citationService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,oBAAoB,GAAG,YAAY,CAAC;AAE/E,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,eAAe,EAAE,eAAe,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,qBAAa,eAAe;IACnB,eAAe,CAAC,UAAU,EAAE,eAAe,EAAE,GAAG,cAAc,EAAE;IAahE,iBAAiB,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,eAAe;IAe/D,qBAAqB,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,MAAM;IAa1D,oBAAoB,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,MAAM;CAOjE"}

package/dist/knowledge/citationService.js

@@ -0,0 +1,47 @@
+export class CitationService {
+    formatCitations(candidates) {
+        return candidates.map((c) => ({
+            documentId: c.documentId,
+            filename: c.filename,
+            sourcePath: c.sourcePath,
+            section: c.section,
+            pageNumber: c.pageNumber,
+            chunkId: c.chunkId,
+            snippet: c.content,
+            score: c.combinedScore,
+        }));
+    }
+    evaluateGrounding(citations) {
+        if (citations.length === 0) {
+            return 'UNGROUNDED';
+        }
+        const topScore = citations[0].score;
+        if (topScore >= 0.15) {
+            return 'GROUNDED';
+        }
+        else if (topScore > 0.01) {
+            return 'PARTIALLY_GROUNDED';
+        }
+        else {
+            return 'UNGROUNDED';
+        }
+    }
+    assembleEvidenceBlock(citations) {
+        if (citations.length === 0) {
+            return 'No relevant source evidence found in knowledge base.';
+        }
+        return citations
+            .map((c, i) => {
+            const secInfo = c.section ? ` (Section: ${c.section})` : '';
+            return `[Source ${i + 1}: ${c.filename}${secInfo}]\n${c.snippet}`;
+        })
+            .join('\n\n');
+    }
+    formatCitationFooter(citations) {
+        if (citations.length === 0)
+            return '';
+        const items = citations.map((c, i) => `[${i + 1}] ${c.filename}${c.section ? ` - ${c.section}` : ''}`);
+        return `\n\n**Sources:**\n` + items.join('\n');
+    }
+}
+//# sourceMappingURL=citationService.js.map

package/dist/knowledge/citationService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"citationService.js","sourceRoot":"","sources":["../../src/knowledge/citationService.ts"],"names":[],"mappings":"AAuBA,MAAM,OAAO,eAAe;IACnB,eAAe,CAAC,UAA6B;QAClD,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5B,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,KAAK,EAAE,CAAC,CAAC,aAAa;SACvB,CAAC,CAAC,CAAC;IACN,CAAC;IAEM,iBAAiB,CAAC,SAA2B;QAClD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACpC,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;YACrB,OAAO,UAAU,CAAC;QACpB,CAAC;aAAM,IAAI,QAAQ,GAAG,IAAI,EAAE,CAAC;YAC3B,OAAO,oBAAoB,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,OAAO,YAAY,CAAC;QACtB,CAAC;IACH,CAAC;IAEM,qBAAqB,CAAC,SAA2B;QACtD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,sDAAsD,CAAC;QAChE,CAAC;QAED,OAAO,SAAS;aACb,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACZ,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,OAAO,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,GAAG,OAAO,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;QACpE,CAAC,CAAC;aACD,IAAI,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC;IAEM,oBAAoB,CAAC,SAA2B;QACrD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CACzB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC1E,CAAC;QACF,OAAO,oBAAoB,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/knowledge/embeddings.d.ts

@@ -0,0 +1,11 @@
+export interface IEmbeddingProvider {
+    dimension: number;
+    modelName: string;
+    embedText(text: string): Promise<number[]>;
+}
+export declare class LocalFeatureEmbeddingProvider implements IEmbeddingProvider {
+    readonly dimension: number;
+    readonly modelName: string;
+    embedText(text: string): Promise<number[]>;
+}
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/knowledge/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../src/knowledge/embeddings.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC5C;AAED,qBAAa,6BAA8B,YAAW,kBAAkB;IACtE,SAAgB,SAAS,EAAE,MAAM,CAAM;IACvC,SAAgB,SAAS,EAAE,MAAM,CAA2B;IAEtD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CA0BjD"}