@skillsmith/core 0.4.1 → 0.4.3

package/dist/src/routing/expert-types.js

@@ -0,0 +1,162 @@
+/**
+ * @fileoverview Expert Type Definitions for SONARouter
+ * @module @skillsmith/core/routing/expert-types
+ * @see SMI-1521: SONA routing for MCP tool optimization
+ *
+ * Type definitions for experts in the SONA MoE network.
+ */
+/**
+ * Tool-specific weight configurations
+ * Based on SMI-1521 requirements:
+ * - search: accuracy-weighted
+ * - recommend: accuracy + personalization
+ * - install: balanced (reliability important)
+ * - validate: balanced
+ * - compare: accuracy-weighted
+ * - get_skill: low latency
+ */
+export const TOOL_WEIGHTS = {
+    search: { accuracy: 0.7, latency: 0.2, reliability: 0.05, efficiency: 0.05 },
+    recommend: { accuracy: 0.6, latency: 0.2, reliability: 0.1, efficiency: 0.1 },
+    install: { accuracy: 0.3, latency: 0.2, reliability: 0.4, efficiency: 0.1 },
+    validate: { accuracy: 0.4, latency: 0.3, reliability: 0.2, efficiency: 0.1 },
+    compare: { accuracy: 0.65, latency: 0.2, reliability: 0.1, efficiency: 0.05 },
+    get_skill: { accuracy: 0.2, latency: 0.6, reliability: 0.15, efficiency: 0.05 },
+    uninstall: { accuracy: 0.2, latency: 0.3, reliability: 0.4, efficiency: 0.1 },
+    analyze: { accuracy: 0.5, latency: 0.25, reliability: 0.15, efficiency: 0.1 },
+};
+// ============================================================================
+// 8-Expert MoE Network Configuration
+// ============================================================================
+/**
+ * 8-Expert MoE Network Configuration
+ * Designed for Skillsmith MCP tools
+ */
+export const SONA_EXPERTS = [
+    // Accuracy-focused experts
+    {
+        id: 'accuracy-semantic',
+        type: 'accuracy',
+        name: 'Semantic Search Expert',
+        description: 'Optimizes semantic similarity matching for search and recommend',
+        capabilities: {
+            supportedTools: ['search', 'recommend', 'compare'],
+            maxConcurrency: 50,
+            avgLatencyMs: 150,
+            accuracyScore: 0.95,
+        },
+        weights: { accuracy: 0.9, latency: 0.05, reliability: 0.03, efficiency: 0.02 },
+        priority: 100,
+    },
+    {
+        id: 'accuracy-validation',
+        type: 'accuracy',
+        name: 'Validation Expert',
+        description: 'Thorough validation with complete error reporting',
+        capabilities: {
+            supportedTools: ['validate', 'analyze'],
+            maxConcurrency: 30,
+            avgLatencyMs: 200,
+            accuracyScore: 0.98,
+        },
+        weights: { accuracy: 0.85, latency: 0.05, reliability: 0.08, efficiency: 0.02 },
+        priority: 90,
+    },
+    // Latency-focused experts
+    {
+        id: 'latency-cache',
+        type: 'latency',
+        name: 'Cache-First Expert',
+        description: 'Serves from cache with fallback to computation',
+        capabilities: {
+            supportedTools: ['search', 'get_skill', 'recommend'],
+            maxConcurrency: 200,
+            avgLatencyMs: 15,
+            accuracyScore: 0.85,
+        },
+        weights: { accuracy: 0.2, latency: 0.7, reliability: 0.05, efficiency: 0.05 },
+        priority: 80,
+    },
+    {
+        id: 'latency-index',
+        type: 'latency',
+        name: 'Index Lookup Expert',
+        description: 'Direct index lookups for known entities',
+        capabilities: {
+            supportedTools: ['get_skill', 'search'],
+            maxConcurrency: 500,
+            avgLatencyMs: 5,
+            accuracyScore: 0.99,
+        },
+        weights: { accuracy: 0.3, latency: 0.6, reliability: 0.08, efficiency: 0.02 },
+        priority: 85,
+    },
+    // Balanced experts
+    {
+        id: 'balanced-default',
+        type: 'balanced',
+        name: 'Default Balanced Expert',
+        description: 'General-purpose balanced execution',
+        capabilities: {
+            supportedTools: [
+                'search',
+                'recommend',
+                'install',
+                'validate',
+                'compare',
+                'get_skill',
+                'uninstall',
+                'analyze',
+            ],
+            maxConcurrency: 100,
+            avgLatencyMs: 75,
+            accuracyScore: 0.9,
+        },
+        weights: { accuracy: 0.4, latency: 0.4, reliability: 0.15, efficiency: 0.05 },
+        priority: 50,
+    },
+    {
+        id: 'balanced-reliability',
+        type: 'balanced',
+        name: 'Reliability Expert',
+        description: 'Prioritizes successful completion over speed',
+        capabilities: {
+            supportedTools: ['install', 'uninstall', 'validate'],
+            maxConcurrency: 25,
+            avgLatencyMs: 120,
+            accuracyScore: 0.92,
+        },
+        weights: { accuracy: 0.3, latency: 0.2, reliability: 0.45, efficiency: 0.05 },
+        priority: 70,
+    },
+    // Specialized experts
+    {
+        id: 'specialized-recommend',
+        type: 'specialized',
+        name: 'Recommendation Expert',
+        description: 'ML-powered personalized recommendations',
+        capabilities: {
+            supportedTools: ['recommend'],
+            maxConcurrency: 40,
+            avgLatencyMs: 180,
+            accuracyScore: 0.93,
+        },
+        weights: { accuracy: 0.65, latency: 0.15, reliability: 0.1, efficiency: 0.1 },
+        priority: 95,
+    },
+    {
+        id: 'specialized-compare',
+        type: 'specialized',
+        name: 'Comparison Expert',
+        description: 'Deep feature comparison with scoring',
+        capabilities: {
+            supportedTools: ['compare', 'analyze'],
+            maxConcurrency: 35,
+            avgLatencyMs: 160,
+            accuracyScore: 0.94,
+        },
+        weights: { accuracy: 0.7, latency: 0.1, reliability: 0.15, efficiency: 0.05 },
+        priority: 88,
+    },
+];
+//# sourceMappingURL=expert-types.js.map

package/dist/src/routing/expert-types.js.map

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

package/dist/src/routing/request-types.d.ts

@@ -0,0 +1,113 @@
+/**
+ * @fileoverview Request/Response Type Definitions for SONARouter
+ * @module @skillsmith/core/routing/request-types
+ * @see SMI-1521: SONA routing for MCP tool optimization
+ *
+ * Type definitions for routing requests, decisions, and responses.
+ */
+import type { ExpertId, ToolType } from './expert-types.js';
+/**
+ * Request context for routing decisions
+ */
+export interface ToolRequest {
+    /** Request identifier for tracing */
+    requestId: string;
+    /** Tool being invoked */
+    tool: ToolType;
+    /** Tool arguments */
+    arguments: Record<string, unknown>;
+    /** Request timestamp */
+    timestamp: Date;
+    /** Optional priority override */
+    priority?: 'high' | 'normal' | 'low';
+    /** Optional latency constraint (ms) */
+    maxLatencyMs?: number;
+    /** Request metadata */
+    metadata?: {
+        /** User/session identifier */
+        userId?: string;
+        /** Source context (mcp, cli, api) */
+        source?: string;
+        /** Feature flags for this request */
+        featureFlags?: Record<string, boolean>;
+    };
+}
+/**
+ * Score breakdown for routing decision
+ */
+export interface RoutingScores {
+    /** Accuracy contribution */
+    accuracyScore: number;
+    /** Latency contribution */
+    latencyScore: number;
+    /** Reliability contribution */
+    reliabilityScore: number;
+    /** Efficiency contribution */
+    efficiencyScore: number;
+    /** Final weighted score */
+    totalScore: number;
+}
+/**
+ * Alternative expert considered in routing
+ */
+export interface RoutingAlternative {
+    expertId: ExpertId;
+    score: number;
+    reason: string;
+}
+/**
+ * Routing decision made by SONARouter
+ */
+export interface RoutingDecision {
+    /** Request this decision applies to */
+    requestId: string;
+    /** Selected expert */
+    expertId: ExpertId;
+    /** Confidence in this routing (0-1) */
+    confidence: number;
+    /** Score breakdown */
+    scores: RoutingScores;
+    /** Alternative experts considered (top 3) */
+    alternatives: RoutingAlternative[];
+    /** Routing reasoning for debugging */
+    reason: string;
+    /** Decision timestamp */
+    decidedAt: Date;
+    /** Time to make decision (ms) */
+    decisionTimeMs: number;
+    /** Whether from cache */
+    cacheHit?: boolean;
+}
+/**
+ * Tool execution response
+ */
+export interface ToolResponse<T = unknown> {
+    /** Request identifier */
+    requestId: string;
+    /** Whether execution succeeded */
+    success: boolean;
+    /** Response data (if successful) */
+    data?: T;
+    /** Error information (if failed) */
+    error?: {
+        code: string;
+        message: string;
+        details?: Record<string, unknown>;
+    };
+    /** Execution metadata */
+    meta: {
+        /** Expert that handled the request */
+        expertId: ExpertId;
+        /** Total execution time (ms) */
+        totalTimeMs: number;
+        /** Routing decision time (ms) */
+        routingTimeMs: number;
+        /** Expert execution time (ms) */
+        executionTimeMs: number;
+        /** Whether cache was used */
+        cacheHit: boolean;
+        /** Whether fallback was triggered */
+        usedFallback: boolean;
+    };
+}
+//# sourceMappingURL=request-types.d.ts.map

package/dist/src/routing/request-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-types.d.ts","sourceRoot":"","sources":["../../../src/routing/request-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAM3D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAA;IACjB,yBAAyB;IACzB,IAAI,EAAE,QAAQ,CAAA;IACd,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,wBAAwB;IACxB,SAAS,EAAE,IAAI,CAAA;IACf,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAA;IACpC,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,uBAAuB;IACvB,QAAQ,CAAC,EAAE;QACT,8BAA8B;QAC9B,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,qCAAqC;QACrC,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,qCAAqC;QACrC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACvC,CAAA;CACF;AAMD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,4BAA4B;IAC5B,aAAa,EAAE,MAAM,CAAA;IACrB,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAA;IACpB,+BAA+B;IAC/B,gBAAgB,EAAE,MAAM,CAAA;IACxB,8BAA8B;IAC9B,eAAe,EAAE,MAAM,CAAA;IACvB,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,QAAQ,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAA;IACjB,sBAAsB;IACtB,QAAQ,EAAE,QAAQ,CAAA;IAClB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAA;IAClB,sBAAsB;IACtB,MAAM,EAAE,aAAa,CAAA;IACrB,6CAA6C;IAC7C,YAAY,EAAE,kBAAkB,EAAE,CAAA;IAClC,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,yBAAyB;IACzB,SAAS,EAAE,IAAI,CAAA;IACf,iCAAiC;IACjC,cAAc,EAAE,MAAM,CAAA;IACtB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAMD;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,oCAAoC;IACpC,IAAI,CAAC,EAAE,CAAC,CAAA;IACR,oCAAoC;IACpC,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,CAAA;QACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAClC,CAAA;IACD,yBAAyB;IACzB,IAAI,EAAE;QACJ,sCAAsC;QACtC,QAAQ,EAAE,QAAQ,CAAA;QAClB,gCAAgC;QAChC,WAAW,EAAE,MAAM,CAAA;QACnB,iCAAiC;QACjC,aAAa,EAAE,MAAM,CAAA;QACrB,iCAAiC;QACjC,eAAe,EAAE,MAAM,CAAA;QACvB,6BAA6B;QAC7B,QAAQ,EAAE,OAAO,CAAA;QACjB,qCAAqC;QACrC,YAAY,EAAE,OAAO,CAAA;KACtB,CAAA;CACF"}

package/dist/src/routing/request-types.js

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Request/Response Type Definitions for SONARouter
+ * @module @skillsmith/core/routing/request-types
+ * @see SMI-1521: SONA routing for MCP tool optimization
+ *
+ * Type definitions for routing requests, decisions, and responses.
+ */
+export {};
+//# sourceMappingURL=request-types.js.map

package/dist/src/routing/request-types.js.map

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

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

@@ -3,214 +3,12 @@
  * @module @skillsmith/core/routing/types
  * @see SMI-1521: SONA routing for MCP tool optimization
  *
- * Type definitions for the SONA (Specialized Optimized Network Architecture)
- * routing system that routes MCP tool requests through an 8-expert MoE network.
+ * Main barrel file for SONA routing types. Re-exports from modular type files.
  */
-/**
- * Expert identification
- */
-export type ExpertId = string;
-/**
- * Types of experts in the MoE network
- * - accuracy: Prioritizes result correctness over speed
- * - latency: Prioritizes response time
- * - balanced: Balances accuracy and latency
- * - specialized: Tool-specific optimization
- */
-export type ExpertType = 'accuracy' | 'latency' | 'balanced' | 'specialized';
-/**
- * Expert state for health monitoring
- */
-export type ExpertState = 'healthy' | 'degraded' | 'unhealthy' | 'warming_up';
-/**
- * MCP tool types supported by SONARouter
- */
-export type ToolType = 'search' | 'recommend' | 'install' | 'validate' | 'compare' | 'get_skill' | 'uninstall' | 'analyze';
-/**
- * Weight profile for routing decisions
- * Values range from 0.0 to 1.0
- */
-export interface WeightProfile {
-    /** Weight for accuracy optimization */
-    accuracy: number;
-    /** Weight for latency optimization */
-    latency: number;
-    /** Weight for reliability/availability */
-    reliability: number;
-    /** Weight for resource efficiency */
-    efficiency: number;
-}
-/**
- * Tool-specific weight configurations
- * Based on SMI-1521 requirements:
- * - search: accuracy-weighted
- * - recommend: accuracy + personalization
- * - install: balanced (reliability important)
- * - validate: balanced
- * - compare: accuracy-weighted
- * - get_skill: low latency
- */
-export declare const TOOL_WEIGHTS: Record<ToolType, WeightProfile>;
-/**
- * Expert capability declaration
- */
-export interface ExpertCapability {
-    /** Tools this expert can handle */
-    supportedTools: ToolType[];
-    /** Maximum concurrent requests */
-    maxConcurrency: number;
-    /** Average latency in milliseconds */
-    avgLatencyMs: number;
-    /** Accuracy score (0-1) based on historical performance */
-    accuracyScore: number;
-}
-/**
- * Expert definition in the MoE network
- */
-export interface ExpertDefinition {
-    /** Unique expert identifier */
-    id: ExpertId;
-    /** Expert type classification */
-    type: ExpertType;
-    /** Name for logging/display */
-    name: string;
-    /** Detailed description */
-    description: string;
-    /** Declared capabilities */
-    capabilities: ExpertCapability;
-    /** Weight profile for routing decisions */
-    weights: WeightProfile;
-    /** Priority (higher = preferred when tied) */
-    priority: number;
-}
-/**
- * Runtime expert status
- */
-export interface ExpertStatus {
-    /** Expert identifier */
-    id: ExpertId;
-    /** Current health state */
-    state: ExpertState;
-    /** Current load (0-1) */
-    load: number;
-    /** Active request count */
-    activeRequests: number;
-    /** Success rate (last 100 requests) */
-    successRate: number;
-    /** P95 latency in milliseconds */
-    p95LatencyMs: number;
-    /** Last health check timestamp */
-    lastHealthCheck: Date;
-}
-/**
- * 8-Expert MoE Network Configuration
- * Designed for Skillsmith MCP tools
- */
-export declare const SONA_EXPERTS: ExpertDefinition[];
-/**
- * Request context for routing decisions
- */
-export interface ToolRequest {
-    /** Request identifier for tracing */
-    requestId: string;
-    /** Tool being invoked */
-    tool: ToolType;
-    /** Tool arguments */
-    arguments: Record<string, unknown>;
-    /** Request timestamp */
-    timestamp: Date;
-    /** Optional priority override */
-    priority?: 'high' | 'normal' | 'low';
-    /** Optional latency constraint (ms) */
-    maxLatencyMs?: number;
-    /** Request metadata */
-    metadata?: {
-        /** User/session identifier */
-        userId?: string;
-        /** Source context (mcp, cli, api) */
-        source?: string;
-        /** Feature flags for this request */
-        featureFlags?: Record<string, boolean>;
-    };
-}
-/**
- * Score breakdown for routing decision
- */
-export interface RoutingScores {
-    /** Accuracy contribution */
-    accuracyScore: number;
-    /** Latency contribution */
-    latencyScore: number;
-    /** Reliability contribution */
-    reliabilityScore: number;
-    /** Efficiency contribution */
-    efficiencyScore: number;
-    /** Final weighted score */
-    totalScore: number;
-}
-/**
- * Alternative expert considered in routing
- */
-export interface RoutingAlternative {
-    expertId: ExpertId;
-    score: number;
-    reason: string;
-}
-/**
- * Routing decision made by SONARouter
- */
-export interface RoutingDecision {
-    /** Request this decision applies to */
-    requestId: string;
-    /** Selected expert */
-    expertId: ExpertId;
-    /** Confidence in this routing (0-1) */
-    confidence: number;
-    /** Score breakdown */
-    scores: RoutingScores;
-    /** Alternative experts considered (top 3) */
-    alternatives: RoutingAlternative[];
-    /** Routing reasoning for debugging */
-    reason: string;
-    /** Decision timestamp */
-    decidedAt: Date;
-    /** Time to make decision (ms) */
-    decisionTimeMs: number;
-    /** Whether from cache */
-    cacheHit?: boolean;
-}
-/**
- * Tool execution response
- */
-export interface ToolResponse<T = unknown> {
-    /** Request identifier */
-    requestId: string;
-    /** Whether execution succeeded */
-    success: boolean;
-    /** Response data (if successful) */
-    data?: T;
-    /** Error information (if failed) */
-    error?: {
-        code: string;
-        message: string;
-        details?: Record<string, unknown>;
-    };
-    /** Execution metadata */
-    meta: {
-        /** Expert that handled the request */
-        expertId: ExpertId;
-        /** Total execution time (ms) */
-        totalTimeMs: number;
-        /** Routing decision time (ms) */
-        routingTimeMs: number;
-        /** Expert execution time (ms) */
-        executionTimeMs: number;
-        /** Whether cache was used */
-        cacheHit: boolean;
-        /** Whether fallback was triggered */
-        usedFallback: boolean;
-    };
-}
+export type { ExpertId, ExpertType, ExpertState, ToolType, WeightProfile, ExpertCapability, ExpertDefinition, ExpertStatus, } from './expert-types.js';
+export { TOOL_WEIGHTS, SONA_EXPERTS } from './expert-types.js';
+export type { ToolRequest, RoutingScores, RoutingAlternative, RoutingDecision, ToolResponse, } from './request-types.js';
+import type { ExpertId, ExpertState, ToolType, ExpertDefinition } from './expert-types.js';
 /**
  * Histogram bucket configuration
  */

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

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