@skillsmith/core 0.2.0 → 0.4.1

package/dist/src/routing/SONARouter.helpers.js

@@ -0,0 +1,184 @@
+/**
+ * SONARouter Helper Classes and Functions
+ * @module @skillsmith/core/routing/SONARouter.helpers
+ */
+// ============================================================================
+// LRU Cache Implementation
+// ============================================================================
+/**
+ * Simple LRU cache for routing decisions
+ */
+export class LRUCache {
+    cache;
+    maxSize;
+    ttlMs;
+    constructor(maxSize, ttlMs) {
+        this.cache = new Map();
+        this.maxSize = maxSize;
+        this.ttlMs = ttlMs;
+    }
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return null;
+        // Check TTL
+        if (Date.now() - entry.timestamp > this.ttlMs) {
+            this.cache.delete(key);
+            return null;
+        }
+        // Move to end (most recently used)
+        this.cache.delete(key);
+        this.cache.set(key, entry);
+        return entry.value;
+    }
+    set(key, value) {
+        // Remove oldest if at capacity
+        if (this.cache.size >= this.maxSize) {
+            const firstKey = this.cache.keys().next().value;
+            if (firstKey !== undefined) {
+                this.cache.delete(firstKey);
+            }
+        }
+        this.cache.set(key, { value, timestamp: Date.now() });
+    }
+    clear() {
+        this.cache.clear();
+    }
+    get size() {
+        return this.cache.size;
+    }
+}
+// ============================================================================
+// Metrics Collector
+// ============================================================================
+/**
+ * Simple metrics collector for SONA routing
+ */
+export class MetricsCollector {
+    totalRequests = 0;
+    requestsByTool = {};
+    requestsByExpert = {};
+    cacheHits = 0;
+    cacheMisses = 0;
+    totalRoutingTimeMs = 0;
+    totalExecutionTimeMs = 0;
+    errorCount = 0;
+    errorsByType = {};
+    recordRouting(tool, expertId, routingTimeMs, cacheHit) {
+        this.totalRequests++;
+        this.requestsByTool[tool] = (this.requestsByTool[tool] || 0) + 1;
+        this.requestsByExpert[expertId] = (this.requestsByExpert[expertId] || 0) + 1;
+        this.totalRoutingTimeMs += routingTimeMs;
+        if (cacheHit) {
+            this.cacheHits++;
+        }
+        else {
+            this.cacheMisses++;
+        }
+    }
+    recordExecution(executionTimeMs) {
+        this.totalExecutionTimeMs += executionTimeMs;
+    }
+    recordError(errorType) {
+        this.errorCount++;
+        this.errorsByType[errorType] = (this.errorsByType[errorType] || 0) + 1;
+    }
+    getMetrics() {
+        const totalCache = this.cacheHits + this.cacheMisses;
+        const avgRoutingMs = this.totalRequests > 0 ? this.totalRoutingTimeMs / this.totalRequests : 0;
+        const avgExecutionMs = this.totalRequests > 0 ? this.totalExecutionTimeMs / this.totalRequests : 0;
+        return {
+            totalRequests: this.totalRequests,
+            requestsByTool: this.requestsByTool,
+            requestsByExpert: this.requestsByExpert,
+            cache: {
+                hits: this.cacheHits,
+                misses: this.cacheMisses,
+                hitRate: totalCache > 0 ? this.cacheHits / totalCache : 0,
+            },
+            errors: {
+                total: this.errorCount,
+                byType: this.errorsByType,
+                byExpert: {},
+            },
+            speedImprovement: {
+                baselineMs: 100, // Baseline without SONA
+                currentMs: avgRoutingMs + avgExecutionMs,
+                improvementRatio: avgRoutingMs + avgExecutionMs > 0 ? 100 / (avgRoutingMs + avgExecutionMs) : 1,
+            },
+        };
+    }
+    reset() {
+        this.totalRequests = 0;
+        this.requestsByTool = {};
+        this.requestsByExpert = {};
+        this.cacheHits = 0;
+        this.cacheMisses = 0;
+        this.totalRoutingTimeMs = 0;
+        this.totalExecutionTimeMs = 0;
+        this.errorCount = 0;
+        this.errorsByType = {};
+    }
+}
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * Check if SONA routing should be used for a request
+ */
+export function shouldUseSONARouting(tool, featureFlags, userTier) {
+    // Master switch
+    if (!featureFlags['sona.enabled']) {
+        return false;
+    }
+    // Tool-specific flag
+    const toolFlag = `sona.tools.${tool}`;
+    if (!featureFlags[toolFlag]) {
+        return false;
+    }
+    // Tier check
+    if (userTier) {
+        const tierFlag = `sona.tiers.${userTier}`;
+        if (!featureFlags[tierFlag]) {
+            return false;
+        }
+    }
+    return true;
+}
+// ============================================================================
+// Type Guards
+// ============================================================================
+/**
+ * Check if a routing decision indicates high confidence
+ */
+export function isHighConfidenceDecision(decision) {
+    return decision.confidence >= 0.8;
+}
+/**
+ * Check if a routing decision used fallback
+ */
+export function usedFallback(decision) {
+    return decision.expertId === 'direct-fallback';
+}
+// ============================================================================
+// Hash Utility
+// ============================================================================
+/**
+ * Generate a simple hash from an object (for cache keys)
+ */
+export function hashObject(obj) {
+    const str = JSON.stringify(obj, Object.keys(obj).sort());
+    let hash = 0;
+    for (let i = 0; i < str.length; i++) {
+        const char = str.charCodeAt(i);
+        hash = (hash << 5) - hash + char;
+        hash = hash & hash;
+    }
+    return hash.toString(36);
+}
+// ============================================================================
+// Factory Helper (Stub for backwards compat - actual implementation in SONARouter.ts)
+// ============================================================================
+// Note: createSONARouter is now exported directly from SONARouter.ts to avoid
+// circular dependency. This re-export is handled in the main file.
+//# sourceMappingURL=SONARouter.helpers.js.map

package/dist/src/routing/SONARouter.helpers.js.map

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

package/dist/src/routing/SONARouter.js

@@ -0,0 +1,377 @@
+/**
+ * @fileoverview SONARouter - Specialized Optimized Network Architecture Router
+ * @module @skillsmith/core/routing/SONARouter
+ * @see SMI-1521: SONA routing for MCP tool optimization
+ *
+ * Routes MCP tool requests through an 8-expert MoE (Mixture of Experts)
+ * network to optimize tool execution based on accuracy requirements,
+ * latency constraints, and load distribution.
+ */
+import { DEFAULT_SONA_CONFIG, TOOL_WEIGHTS } from './types.js';
+import { LRUCache, MetricsCollector, hashObject } from './SONARouter.helpers.js';
+// Re-export helpers for public API
+export { LRUCache, MetricsCollector, shouldUseSONARouting, isHighConfidenceDecision, usedFallback, } from './SONARouter.helpers.js';
+// ============================================================================
+// Main SONARouter Class
+// ============================================================================
+/**
+ * SONARouter routes MCP tool requests through an 8-expert MoE network.
+ */
+export class SONARouter {
+    config;
+    experts;
+    expertStatus;
+    cache;
+    metrics;
+    v3MoE = null;
+    v3SONA = null;
+    initialized = false;
+    healthCheckInterval = null;
+    constructor(config = {}) {
+        this.config = {
+            ...DEFAULT_SONA_CONFIG,
+            ...config,
+            fallback: { ...DEFAULT_SONA_CONFIG.fallback, ...config.fallback },
+        };
+        this.experts = new Map();
+        this.expertStatus = new Map();
+        for (const expert of this.config.experts) {
+            this.experts.set(expert.id, expert);
+            this.expertStatus.set(expert.id, this.createInitialStatus(expert.id));
+        }
+        this.cache = new LRUCache(this.config.cacheMaxSize, this.config.cacheTtlMs);
+        this.metrics = new MetricsCollector();
+    }
+    // ==========================================================================
+    // Initialization
+    // ==========================================================================
+    async initialize() {
+        if (this.initialized)
+            return;
+        if (this.config.useV3MoE !== false) {
+            await this.initializeV3MoE();
+        }
+        if (this.config.healthCheckIntervalMs > 0) {
+            this.startHealthChecks();
+        }
+        this.initialized = true;
+    }
+    isInitialized() {
+        return this.initialized;
+    }
+    isUsingV3MoE() {
+        return this.v3MoE !== null;
+    }
+    async shutdown() {
+        if (this.healthCheckInterval) {
+            clearInterval(this.healthCheckInterval);
+            this.healthCheckInterval = null;
+        }
+        this.cache.clear();
+        this.initialized = false;
+    }
+    // ==========================================================================
+    // Routing
+    // ==========================================================================
+    async route(request) {
+        this.ensureInitialized();
+        const startTime = Date.now();
+        if (this.config.enableCache && request.priority !== 'high') {
+            const cacheKey = this.generateCacheKey(request);
+            const cached = this.cache.get(cacheKey);
+            if (cached) {
+                const decision = { ...cached, cacheHit: true };
+                this.metrics.recordRouting(request.tool, decision.expertId, Date.now() - startTime, true);
+                return decision;
+            }
+        }
+        const eligible = this.getEligibleExperts(request);
+        if (eligible.length === 0) {
+            return this.createFallbackDecision(request, 'NO_ELIGIBLE_EXPERTS', startTime);
+        }
+        const scoredExperts = this.scoreExperts(eligible, request);
+        const decision = this.selectBestExpert(scoredExperts, request, startTime);
+        if (this.config.enableCache) {
+            const cacheKey = this.generateCacheKey(request);
+            this.cache.set(cacheKey, decision);
+        }
+        this.metrics.recordRouting(request.tool, decision.expertId, decision.decisionTimeMs, false);
+        return decision;
+    }
+    async executeWithRouting(request, executor) {
+        const routingStart = Date.now();
+        const decision = await this.route(request);
+        const routingTimeMs = Date.now() - routingStart;
+        const executionStart = Date.now();
+        try {
+            const data = await executor(decision.expertId, request);
+            const executionTimeMs = Date.now() - executionStart;
+            this.recordOutcome(request, decision.expertId, true);
+            this.metrics.recordExecution(executionTimeMs);
+            return {
+                requestId: request.requestId,
+                success: true,
+                data,
+                meta: {
+                    expertId: decision.expertId,
+                    totalTimeMs: routingTimeMs + executionTimeMs,
+                    routingTimeMs,
+                    executionTimeMs,
+                    cacheHit: decision.cacheHit ?? false,
+                    usedFallback: decision.expertId === 'direct-fallback',
+                },
+            };
+        }
+        catch (error) {
+            const executionTimeMs = Date.now() - executionStart;
+            this.recordOutcome(request, decision.expertId, false);
+            this.metrics.recordError(error instanceof Error ? error.name : 'UnknownError');
+            if (this.config.fallback.enabled && decision.expertId !== 'direct-fallback') {
+                try {
+                    const fallbackData = await executor('direct-fallback', request);
+                    return {
+                        requestId: request.requestId,
+                        success: true,
+                        data: fallbackData,
+                        meta: {
+                            expertId: 'direct-fallback',
+                            totalTimeMs: Date.now() - routingStart,
+                            routingTimeMs,
+                            executionTimeMs: Date.now() - executionStart - executionTimeMs,
+                            cacheHit: false,
+                            usedFallback: true,
+                        },
+                    };
+                }
+                catch {
+                    // Fallback also failed
+                }
+            }
+            return {
+                requestId: request.requestId,
+                success: false,
+                error: {
+                    code: error instanceof Error ? error.name : 'EXECUTION_ERROR',
+                    message: error instanceof Error ? error.message : String(error),
+                },
+                meta: {
+                    expertId: decision.expertId,
+                    totalTimeMs: routingTimeMs + executionTimeMs,
+                    routingTimeMs,
+                    executionTimeMs,
+                    cacheHit: decision.cacheHit ?? false,
+                    usedFallback: false,
+                },
+            };
+        }
+    }
+    // ==========================================================================
+    // Expert Management
+    // ==========================================================================
+    getExpertStatus() {
+        return Array.from(this.expertStatus.values());
+    }
+    getExpert(expertId) {
+        return this.experts.get(expertId);
+    }
+    updateExpertHealth(expertId, state, load) {
+        const status = this.expertStatus.get(expertId);
+        if (status) {
+            status.state = state;
+            if (load !== undefined)
+                status.load = load;
+            status.lastHealthCheck = new Date();
+        }
+    }
+    // ==========================================================================
+    // Metrics
+    // ==========================================================================
+    getMetrics() {
+        return this.metrics.getMetrics();
+    }
+    resetMetrics() {
+        this.metrics.reset();
+    }
+    // ==========================================================================
+    // Private Methods
+    // ==========================================================================
+    ensureInitialized() {
+        if (!this.initialized) {
+            throw new Error('SONARouter not initialized. Call initialize() first.');
+        }
+    }
+    createInitialStatus(expertId) {
+        return {
+            id: expertId,
+            state: 'healthy',
+            load: 0,
+            activeRequests: 0,
+            successRate: 1.0,
+            p95LatencyMs: 0,
+            lastHealthCheck: new Date(),
+        };
+    }
+    async initializeV3MoE() {
+        try {
+            const moeModule = await import('claude-flow/v3/@claude-flow/cli/dist/src/ruvector/moe-router.js');
+            this.v3MoE = moeModule.getMoERouter();
+            await this.v3MoE.initialize();
+            const sonaModule = await import('claude-flow/v3/@claude-flow/cli/dist/src/memory/sona-optimizer.js');
+            const sonaOptimizer = await sonaModule.getSONAOptimizer();
+            await sonaOptimizer.initialize();
+            this.v3SONA = sonaOptimizer;
+            console.log('[SONARouter] V3 MoE integration initialized');
+        }
+        catch {
+            console.log('[SONARouter] V3 MoE not available, using local scoring algorithm');
+            this.v3MoE = null;
+            this.v3SONA = null;
+        }
+    }
+    startHealthChecks() {
+        this.healthCheckInterval = setInterval(() => {
+            this.runHealthChecks();
+        }, this.config.healthCheckIntervalMs);
+    }
+    runHealthChecks() {
+        for (const [_expertId, status] of this.expertStatus) {
+            if (status.load > 0.9) {
+                status.state = 'degraded';
+            }
+            else if (status.load > 0.95) {
+                status.state = 'unhealthy';
+            }
+            else {
+                status.state = 'healthy';
+            }
+            status.lastHealthCheck = new Date();
+        }
+    }
+    generateCacheKey(request) {
+        const argsHash = hashObject(request.arguments);
+        return `${request.tool}:${argsHash}`;
+    }
+    getEligibleExperts(request) {
+        const eligible = [];
+        for (const [, expert] of this.experts) {
+            if (!expert.capabilities.supportedTools.includes(request.tool))
+                continue;
+            const status = this.expertStatus.get(expert.id);
+            if (!status || status.state === 'unhealthy')
+                continue;
+            if (status.load >= 0.95)
+                continue;
+            eligible.push(expert);
+        }
+        return eligible;
+    }
+    scoreExperts(experts, request) {
+        const toolWeights = TOOL_WEIGHTS[request.tool];
+        const scoredExperts = [];
+        for (const expert of experts) {
+            const status = this.expertStatus.get(expert.id);
+            const scores = this.calculateScores(expert, status, toolWeights, request);
+            scoredExperts.push({ expert, scores });
+        }
+        scoredExperts.sort((a, b) => b.scores.totalScore - a.scores.totalScore);
+        return scoredExperts;
+    }
+    calculateScores(expert, status, toolWeights, request) {
+        const accuracyScore = expert.capabilities.accuracyScore * (1 - status.load * 0.1);
+        const latencyBaseline = 200;
+        let latencyScore = Math.max(0, 1 - expert.capabilities.avgLatencyMs / latencyBaseline);
+        if (request.maxLatencyMs && expert.capabilities.avgLatencyMs > request.maxLatencyMs) {
+            latencyScore = latencyScore * 0.5;
+        }
+        const reliabilityScore = status.successRate;
+        const efficiencyScore = 1 - status.load;
+        let totalScore = toolWeights.accuracy * accuracyScore +
+            toolWeights.latency * latencyScore +
+            toolWeights.reliability * reliabilityScore +
+            toolWeights.efficiency * efficiencyScore;
+        if (expert.type === 'specialized' && expert.capabilities.supportedTools.length === 1) {
+            totalScore = totalScore * 1.1;
+        }
+        totalScore = totalScore + expert.priority / 10000;
+        return { accuracyScore, latencyScore, reliabilityScore, efficiencyScore, totalScore };
+    }
+    selectBestExpert(scoredExperts, request, startTime) {
+        const selected = scoredExperts[0];
+        const alternatives = scoredExperts.slice(1, 4);
+        let confidence;
+        if (alternatives.length > 0) {
+            const scoreMargin = selected.scores.totalScore - alternatives[0].scores.totalScore;
+            confidence = Math.min(1.0, 0.5 + scoreMargin * 2);
+        }
+        else {
+            confidence = 1.0;
+        }
+        return {
+            requestId: request.requestId,
+            expertId: selected.expert.id,
+            confidence,
+            scores: selected.scores,
+            alternatives: alternatives.map((alt) => ({
+                expertId: alt.expert.id,
+                score: alt.scores.totalScore,
+                reason: `${alt.expert.name}: score ${alt.scores.totalScore.toFixed(3)}`,
+            })),
+            reason: this.generateDecisionReason(selected.expert, selected.scores, request.tool),
+            decidedAt: new Date(),
+            decisionTimeMs: Date.now() - startTime,
+        };
+    }
+    generateDecisionReason(expert, scores, tool) {
+        const toolWeights = TOOL_WEIGHTS[tool];
+        const primaryFactor = toolWeights.accuracy >= toolWeights.latency ? 'accuracy' : 'latency';
+        return (`Selected ${expert.name} (${expert.type}) for ${tool}: ` +
+            `optimized for ${primaryFactor} with score ${scores.totalScore.toFixed(3)}`);
+    }
+    createFallbackDecision(request, reason, startTime) {
+        return {
+            requestId: request.requestId,
+            expertId: 'direct-fallback',
+            confidence: 1.0,
+            scores: {
+                accuracyScore: 0,
+                latencyScore: 0,
+                reliabilityScore: 1.0,
+                efficiencyScore: 0,
+                totalScore: 0,
+            },
+            alternatives: [],
+            reason: `Fallback: ${reason}`,
+            decidedAt: new Date(),
+            decisionTimeMs: Date.now() - startTime,
+        };
+    }
+    recordOutcome(request, expertId, success) {
+        const status = this.expertStatus.get(expertId);
+        if (status) {
+            status.successRate = status.successRate * 0.99 + (success ? 0.01 : 0);
+        }
+        if (this.v3SONA) {
+            this.v3SONA.processTrajectoryOutcome({
+                trajectoryId: request.requestId,
+                task: `${request.tool}:${JSON.stringify(request.arguments)}`,
+                agent: expertId,
+                success,
+            });
+        }
+        if (this.v3MoE) {
+            this.v3MoE.updateExpertWeights(expertId, success ? 1.0 : -0.5);
+        }
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+/**
+ * Create and initialize a SONARouter instance
+ */
+export async function createSONARouter(config) {
+    const router = new SONARouter(config);
+    await router.initialize();
+    return router;
+}
+//# sourceMappingURL=SONARouter.js.map

package/dist/src/routing/SONARouter.js.map

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

package/dist/src/routing/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview SONA Routing Module Exports
+ * @module @skillsmith/core/routing
+ * @see SMI-1521: SONA routing for MCP tool optimization
+ */
+export { SONARouter, createSONARouter, shouldUseSONARouting, isHighConfidenceDecision, usedFallback, } from './SONARouter.js';
+export type { ExpertId, ExpertType, ExpertState, ExpertCapability, ExpertDefinition, ExpertStatus, ToolType, WeightProfile, ToolRequest, RoutingScores, RoutingAlternative, RoutingDecision, ToolResponse, HistogramBuckets, SONAMetrics, LoadBalanceStrategy, SONARouterConfig, SONAFeatureFlag, } from './types.js';
+export { TOOL_WEIGHTS, SONA_EXPERTS, DEFAULT_SONA_CONFIG, SONA_FEATURE_FLAGS } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/routing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/routing/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,EACxB,YAAY,GACb,MAAM,iBAAiB,CAAA;AAGxB,YAAY,EACV,QAAQ,EACR,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,GAChB,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA"}

package/dist/src/routing/index.js

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview SONA Routing Module Exports
+ * @module @skillsmith/core/routing
+ * @see SMI-1521: SONA routing for MCP tool optimization
+ */
+// Main router
+export { SONARouter, createSONARouter, shouldUseSONARouting, isHighConfidenceDecision, usedFallback, } from './SONARouter.js';
+// Constants
+export { TOOL_WEIGHTS, SONA_EXPERTS, DEFAULT_SONA_CONFIG, SONA_FEATURE_FLAGS } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/src/routing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/routing/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc;AACd,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,EACxB,YAAY,GACb,MAAM,iBAAiB,CAAA;AAwBxB,YAAY;AACZ,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA"}