@sparkleideas/neural 3.5.2-patch.1

package/src/index.d.ts

@@ -0,0 +1,118 @@
+/**
+ * V3 Neural/Learning System
+ *
+ * Complete neural learning module with SONA learning modes,
+ * ReasoningBank integration, pattern learning, and RL algorithms.
+ *
+ * Performance Targets:
+ * - SONA adaptation: <0.05ms
+ * - Pattern matching: <1ms
+ * - Learning step: <10ms
+ *
+ * @module @sparkleideas/neural
+ */
+export type { SONAMode, SONAModeConfig, ModeOptimizations, Trajectory, TrajectoryStep, TrajectoryVerdict, DistilledMemory, Pattern, PatternMatch, PatternEvolution, RLAlgorithm, RLConfig, PPOConfig, DQNConfig, DecisionTransformerConfig, CuriosityConfig, LoRAConfig, LoRAWeights, EWCConfig, EWCState, NeuralStats, NeuralEvent, NeuralEventListener, } from './types.js';
+export { SONAManager, createSONAManager, getModeConfig, getModeOptimizations, } from './sona-manager.js';
+export type { ModeImplementation } from './modes/index.js';
+export { BaseModeImplementation, RealTimeMode, BalancedMode, ResearchMode, EdgeMode, BatchMode, } from './modes/index.js';
+export { SONALearningEngine, createSONALearningEngine, } from './sona-integration.js';
+export type { Context, AdaptedBehavior, SONAStats, JsLearnedPattern, JsSonaConfig, } from './sona-integration.js';
+export { ReasoningBank, createReasoningBank, createInitializedReasoningBank, } from './reasoning-bank.js';
+export type { ReasoningBankConfig, RetrievalResult, ConsolidationResult, } from './reasoning-bank.js';
+export { PatternLearner, createPatternLearner, } from './pattern-learner.js';
+export type { PatternLearnerConfig } from './pattern-learner.js';
+export { PPOAlgorithm, createPPO, DEFAULT_PPO_CONFIG, DQNAlgorithm, createDQN, DEFAULT_DQN_CONFIG, A2CAlgorithm, createA2C, DEFAULT_A2C_CONFIG, DecisionTransformer, createDecisionTransformer, DEFAULT_DT_CONFIG, QLearning, createQLearning, DEFAULT_QLEARNING_CONFIG, SARSAAlgorithm, createSARSA, DEFAULT_SARSA_CONFIG, CuriosityModule, createCuriosity, DEFAULT_CURIOSITY_CONFIG, createAlgorithm, getDefaultConfig, } from './algorithms/index.js';
+export type { A2CConfig, QLearningConfig, SARSAConfig, } from './algorithms/index.js';
+import { SONAManager, createSONAManager } from './sona-manager.js';
+import { ReasoningBank, createReasoningBank } from './reasoning-bank.js';
+import { PatternLearner, createPatternLearner } from './pattern-learner.js';
+import { SONALearningEngine, createSONALearningEngine } from './sona-integration.js';
+import type { SONAMode, NeuralEventListener } from './types.js';
+/**
+ * Neural Learning System - Complete integrated learning module
+ */
+export declare class NeuralLearningSystem {
+    private sona;
+    private reasoningBank;
+    private patternLearner;
+    private initialized;
+    constructor(mode?: SONAMode);
+    /**
+     * Initialize the learning system
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get SONA manager
+     */
+    getSONAManager(): SONAManager;
+    /**
+     * Get ReasoningBank
+     */
+    getReasoningBank(): ReasoningBank;
+    /**
+     * Get Pattern Learner
+     */
+    getPatternLearner(): PatternLearner;
+    /**
+     * Change learning mode
+     */
+    setMode(mode: SONAMode): Promise<void>;
+    /**
+     * Begin tracking a task
+     */
+    beginTask(context: string, domain?: 'code' | 'creative' | 'reasoning' | 'chat' | 'math' | 'general'): string;
+    /**
+     * Record a step in the current task
+     */
+    recordStep(trajectoryId: string, action: string, reward: number, stateEmbedding: Float32Array): void;
+    /**
+     * Complete a task and trigger learning
+     */
+    completeTask(trajectoryId: string, quality?: number): Promise<void>;
+    /**
+     * Find similar patterns for a task
+     */
+    findPatterns(queryEmbedding: Float32Array, k?: number): Promise<import('./types.js').PatternMatch[]>;
+    /**
+     * Retrieve relevant memories
+     */
+    retrieveMemories(queryEmbedding: Float32Array, k?: number): Promise<import('./reasoning-bank.js').RetrievalResult[]>;
+    /**
+     * Trigger learning cycle
+     */
+    triggerLearning(): Promise<void>;
+    /**
+     * Get comprehensive statistics
+     */
+    getStats(): {
+        sona: import('./types.js').NeuralStats;
+        reasoningBank: Record<string, number>;
+        patternLearner: Record<string, number>;
+    };
+    /**
+     * Add event listener
+     */
+    addEventListener(listener: NeuralEventListener): void;
+    /**
+     * Cleanup resources
+     */
+    cleanup(): Promise<void>;
+}
+/**
+ * Create a complete neural learning system
+ */
+export declare function createNeuralLearningSystem(mode?: SONAMode): NeuralLearningSystem;
+declare const _default: {
+    createSONAManager: typeof createSONAManager;
+    createReasoningBank: typeof createReasoningBank;
+    createPatternLearner: typeof createPatternLearner;
+    createNeuralLearningSystem: typeof createNeuralLearningSystem;
+    createSONALearningEngine: typeof createSONALearningEngine;
+    SONAManager: typeof SONAManager;
+    ReasoningBank: typeof ReasoningBank;
+    PatternLearner: typeof PatternLearner;
+    NeuralLearningSystem: typeof NeuralLearningSystem;
+    SONALearningEngine: typeof SONALearningEngine;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

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

package/src/index.js

@@ -0,0 +1,201 @@
+/**
+ * V3 Neural/Learning System
+ *
+ * Complete neural learning module with SONA learning modes,
+ * ReasoningBank integration, pattern learning, and RL algorithms.
+ *
+ * Performance Targets:
+ * - SONA adaptation: <0.05ms
+ * - Pattern matching: <1ms
+ * - Learning step: <10ms
+ *
+ * @module @sparkleideas/neural
+ */
+// =============================================================================
+// SONA Manager
+// =============================================================================
+export { SONAManager, createSONAManager, getModeConfig, getModeOptimizations, } from './sona-manager.js';
+export { BaseModeImplementation, RealTimeMode, BalancedMode, ResearchMode, EdgeMode, BatchMode, } from './modes/index.js';
+// =============================================================================
+// SONA Integration (@ruvector/sona)
+// =============================================================================
+export { SONALearningEngine, createSONALearningEngine, } from './sona-integration.js';
+// =============================================================================
+// ReasoningBank
+// =============================================================================
+export { ReasoningBank, createReasoningBank, createInitializedReasoningBank, } from './reasoning-bank.js';
+// =============================================================================
+// Pattern Learner
+// =============================================================================
+export { PatternLearner, createPatternLearner, } from './pattern-learner.js';
+// =============================================================================
+// RL Algorithms
+// =============================================================================
+export { 
+// PPO
+PPOAlgorithm, createPPO, DEFAULT_PPO_CONFIG, 
+// DQN
+DQNAlgorithm, createDQN, DEFAULT_DQN_CONFIG, 
+// A2C
+A2CAlgorithm, createA2C, DEFAULT_A2C_CONFIG, 
+// Decision Transformer
+DecisionTransformer, createDecisionTransformer, DEFAULT_DT_CONFIG, 
+// Q-Learning
+QLearning, createQLearning, DEFAULT_QLEARNING_CONFIG, 
+// SARSA
+SARSAAlgorithm, createSARSA, DEFAULT_SARSA_CONFIG, 
+// Curiosity
+CuriosityModule, createCuriosity, DEFAULT_CURIOSITY_CONFIG, 
+// Factory functions
+createAlgorithm, getDefaultConfig, } from './algorithms/index.js';
+// =============================================================================
+// Convenience Factory
+// =============================================================================
+import { SONAManager, createSONAManager } from './sona-manager.js';
+import { ReasoningBank, createReasoningBank } from './reasoning-bank.js';
+import { PatternLearner, createPatternLearner } from './pattern-learner.js';
+import { SONALearningEngine, createSONALearningEngine } from './sona-integration.js';
+/**
+ * Neural Learning System - Complete integrated learning module
+ */
+export class NeuralLearningSystem {
+    sona;
+    reasoningBank;
+    patternLearner;
+    initialized = false;
+    constructor(mode = 'balanced') {
+        this.sona = createSONAManager(mode);
+        this.reasoningBank = createReasoningBank();
+        this.patternLearner = createPatternLearner();
+    }
+    /**
+     * Initialize the learning system
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        await this.sona.initialize();
+        this.initialized = true;
+    }
+    /**
+     * Get SONA manager
+     */
+    getSONAManager() {
+        return this.sona;
+    }
+    /**
+     * Get ReasoningBank
+     */
+    getReasoningBank() {
+        return this.reasoningBank;
+    }
+    /**
+     * Get Pattern Learner
+     */
+    getPatternLearner() {
+        return this.patternLearner;
+    }
+    /**
+     * Change learning mode
+     */
+    async setMode(mode) {
+        await this.sona.setMode(mode);
+    }
+    /**
+     * Begin tracking a task
+     */
+    beginTask(context, domain = 'general') {
+        return this.sona.beginTrajectory(context, domain);
+    }
+    /**
+     * Record a step in the current task
+     */
+    recordStep(trajectoryId, action, reward, stateEmbedding) {
+        this.sona.recordStep(trajectoryId, action, reward, stateEmbedding);
+    }
+    /**
+     * Complete a task and trigger learning
+     */
+    async completeTask(trajectoryId, quality) {
+        const trajectory = this.sona.completeTrajectory(trajectoryId, quality);
+        if (trajectory) {
+            // Store in reasoning bank
+            this.reasoningBank.storeTrajectory(trajectory);
+            // Judge and potentially distill
+            await this.reasoningBank.judge(trajectory);
+            const memory = await this.reasoningBank.distill(trajectory);
+            // Extract pattern if successful
+            if (memory) {
+                this.patternLearner.extractPattern(trajectory, memory);
+            }
+        }
+    }
+    /**
+     * Find similar patterns for a task
+     */
+    async findPatterns(queryEmbedding, k = 3) {
+        return this.patternLearner.findMatches(queryEmbedding, k);
+    }
+    /**
+     * Retrieve relevant memories
+     */
+    async retrieveMemories(queryEmbedding, k = 3) {
+        return this.reasoningBank.retrieve(queryEmbedding, k);
+    }
+    /**
+     * Trigger learning cycle
+     */
+    async triggerLearning() {
+        await this.sona.triggerLearning('manual');
+        await this.reasoningBank.consolidate();
+    }
+    /**
+     * Get comprehensive statistics
+     */
+    getStats() {
+        return {
+            sona: this.sona.getStats(),
+            reasoningBank: this.reasoningBank.getStats(),
+            patternLearner: this.patternLearner.getStats(),
+        };
+    }
+    /**
+     * Add event listener
+     */
+    addEventListener(listener) {
+        this.sona.addEventListener(listener);
+        this.reasoningBank.addEventListener(listener);
+        this.patternLearner.addEventListener(listener);
+    }
+    /**
+     * Cleanup resources
+     */
+    async cleanup() {
+        await this.sona.cleanup();
+        this.initialized = false;
+    }
+}
+/**
+ * Create a complete neural learning system
+ */
+export function createNeuralLearningSystem(mode = 'balanced') {
+    return new NeuralLearningSystem(mode);
+}
+// =============================================================================
+// Default Export
+// =============================================================================
+export default {
+    // Factories
+    createSONAManager,
+    createReasoningBank,
+    createPatternLearner,
+    createNeuralLearningSystem,
+    createSONALearningEngine,
+    // Classes
+    SONAManager,
+    ReasoningBank,
+    PatternLearner,
+    NeuralLearningSystem,
+    SONALearningEngine,
+};
+//# sourceMappingURL=index.js.map

package/src/index.js.map

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

package/src/index.ts

@@ -0,0 +1,363 @@
+/**
+ * V3 Neural/Learning System
+ *
+ * Complete neural learning module with SONA learning modes,
+ * ReasoningBank integration, pattern learning, and RL algorithms.
+ *
+ * Performance Targets:
+ * - SONA adaptation: <0.05ms
+ * - Pattern matching: <1ms
+ * - Learning step: <10ms
+ *
+ * @module @sparkleideas/neural
+ */
+
+// =============================================================================
+// Core Types
+// =============================================================================
+
+export type {
+  // SONA Mode Types
+  SONAMode,
+  SONAModeConfig,
+  ModeOptimizations,
+
+  // Trajectory Types
+  Trajectory,
+  TrajectoryStep,
+  TrajectoryVerdict,
+  DistilledMemory,
+
+  // Pattern Types
+  Pattern,
+  PatternMatch,
+  PatternEvolution,
+
+  // RL Algorithm Types
+  RLAlgorithm,
+  RLConfig,
+  PPOConfig,
+  DQNConfig,
+  DecisionTransformerConfig,
+  CuriosityConfig,
+
+  // LoRA Types
+  LoRAConfig,
+  LoRAWeights,
+
+  // EWC Types
+  EWCConfig,
+  EWCState,
+
+  // Statistics
+  NeuralStats,
+
+  // Events
+  NeuralEvent,
+  NeuralEventListener,
+} from './types.js';
+
+// =============================================================================
+// SONA Manager
+// =============================================================================
+
+export {
+  SONAManager,
+  createSONAManager,
+  getModeConfig,
+  getModeOptimizations,
+} from './sona-manager.js';
+
+// =============================================================================
+// Learning Modes
+// =============================================================================
+
+export type { ModeImplementation } from './modes/index.js';
+
+export {
+  BaseModeImplementation,
+  RealTimeMode,
+  BalancedMode,
+  ResearchMode,
+  EdgeMode,
+  BatchMode,
+} from './modes/index.js';
+
+// =============================================================================
+// SONA Integration (@ruvector/sona)
+// =============================================================================
+
+export {
+  SONALearningEngine,
+  createSONALearningEngine,
+} from './sona-integration.js';
+
+export type {
+  Context,
+  AdaptedBehavior,
+  SONAStats,
+  JsLearnedPattern,
+  JsSonaConfig,
+} from './sona-integration.js';
+
+// =============================================================================
+// ReasoningBank
+// =============================================================================
+
+export {
+  ReasoningBank,
+  createReasoningBank,
+  createInitializedReasoningBank,
+} from './reasoning-bank.js';
+
+export type {
+  ReasoningBankConfig,
+  RetrievalResult,
+  ConsolidationResult,
+} from './reasoning-bank.js';
+
+// =============================================================================
+// Pattern Learner
+// =============================================================================
+
+export {
+  PatternLearner,
+  createPatternLearner,
+} from './pattern-learner.js';
+
+export type { PatternLearnerConfig } from './pattern-learner.js';
+
+// =============================================================================
+// RL Algorithms
+// =============================================================================
+
+export {
+  // PPO
+  PPOAlgorithm,
+  createPPO,
+  DEFAULT_PPO_CONFIG,
+
+  // DQN
+  DQNAlgorithm,
+  createDQN,
+  DEFAULT_DQN_CONFIG,
+
+  // A2C
+  A2CAlgorithm,
+  createA2C,
+  DEFAULT_A2C_CONFIG,
+
+  // Decision Transformer
+  DecisionTransformer,
+  createDecisionTransformer,
+  DEFAULT_DT_CONFIG,
+
+  // Q-Learning
+  QLearning,
+  createQLearning,
+  DEFAULT_QLEARNING_CONFIG,
+
+  // SARSA
+  SARSAAlgorithm,
+  createSARSA,
+  DEFAULT_SARSA_CONFIG,
+
+  // Curiosity
+  CuriosityModule,
+  createCuriosity,
+  DEFAULT_CURIOSITY_CONFIG,
+
+  // Factory functions
+  createAlgorithm,
+  getDefaultConfig,
+} from './algorithms/index.js';
+
+export type {
+  A2CConfig,
+  QLearningConfig,
+  SARSAConfig,
+} from './algorithms/index.js';
+
+// =============================================================================
+// Convenience Factory
+// =============================================================================
+
+import { SONAManager, createSONAManager } from './sona-manager.js';
+import { ReasoningBank, createReasoningBank } from './reasoning-bank.js';
+import { PatternLearner, createPatternLearner } from './pattern-learner.js';
+import { SONALearningEngine, createSONALearningEngine } from './sona-integration.js';
+import type { SONAMode, NeuralEventListener } from './types.js';
+
+/**
+ * Neural Learning System - Complete integrated learning module
+ */
+export class NeuralLearningSystem {
+  private sona: SONAManager;
+  private reasoningBank: ReasoningBank;
+  private patternLearner: PatternLearner;
+  private initialized = false;
+
+  constructor(mode: SONAMode = 'balanced') {
+    this.sona = createSONAManager(mode);
+    this.reasoningBank = createReasoningBank();
+    this.patternLearner = createPatternLearner();
+  }
+
+  /**
+   * Initialize the learning system
+   */
+  async initialize(): Promise<void> {
+    if (this.initialized) return;
+    await this.sona.initialize();
+    this.initialized = true;
+  }
+
+  /**
+   * Get SONA manager
+   */
+  getSONAManager(): SONAManager {
+    return this.sona;
+  }
+
+  /**
+   * Get ReasoningBank
+   */
+  getReasoningBank(): ReasoningBank {
+    return this.reasoningBank;
+  }
+
+  /**
+   * Get Pattern Learner
+   */
+  getPatternLearner(): PatternLearner {
+    return this.patternLearner;
+  }
+
+  /**
+   * Change learning mode
+   */
+  async setMode(mode: SONAMode): Promise<void> {
+    await this.sona.setMode(mode);
+  }
+
+  /**
+   * Begin tracking a task
+   */
+  beginTask(context: string, domain: 'code' | 'creative' | 'reasoning' | 'chat' | 'math' | 'general' = 'general'): string {
+    return this.sona.beginTrajectory(context, domain);
+  }
+
+  /**
+   * Record a step in the current task
+   */
+  recordStep(
+    trajectoryId: string,
+    action: string,
+    reward: number,
+    stateEmbedding: Float32Array
+  ): void {
+    this.sona.recordStep(trajectoryId, action, reward, stateEmbedding);
+  }
+
+  /**
+   * Complete a task and trigger learning
+   */
+  async completeTask(trajectoryId: string, quality?: number): Promise<void> {
+    const trajectory = this.sona.completeTrajectory(trajectoryId, quality);
+
+    if (trajectory) {
+      // Store in reasoning bank
+      this.reasoningBank.storeTrajectory(trajectory);
+
+      // Judge and potentially distill
+      await this.reasoningBank.judge(trajectory);
+      const memory = await this.reasoningBank.distill(trajectory);
+
+      // Extract pattern if successful
+      if (memory) {
+        this.patternLearner.extractPattern(trajectory, memory);
+      }
+    }
+  }
+
+  /**
+   * Find similar patterns for a task
+   */
+  async findPatterns(queryEmbedding: Float32Array, k: number = 3): Promise<import('./types.js').PatternMatch[]> {
+    return this.patternLearner.findMatches(queryEmbedding, k);
+  }
+
+  /**
+   * Retrieve relevant memories
+   */
+  async retrieveMemories(queryEmbedding: Float32Array, k: number = 3): Promise<import('./reasoning-bank.js').RetrievalResult[]> {
+    return this.reasoningBank.retrieve(queryEmbedding, k);
+  }
+
+  /**
+   * Trigger learning cycle
+   */
+  async triggerLearning(): Promise<void> {
+    await this.sona.triggerLearning('manual');
+    await this.reasoningBank.consolidate();
+  }
+
+  /**
+   * Get comprehensive statistics
+   */
+  getStats(): {
+    sona: import('./types.js').NeuralStats;
+    reasoningBank: Record<string, number>;
+    patternLearner: Record<string, number>;
+  } {
+    return {
+      sona: this.sona.getStats(),
+      reasoningBank: this.reasoningBank.getStats(),
+      patternLearner: this.patternLearner.getStats(),
+    };
+  }
+
+  /**
+   * Add event listener
+   */
+  addEventListener(listener: NeuralEventListener): void {
+    this.sona.addEventListener(listener);
+    this.reasoningBank.addEventListener(listener);
+    this.patternLearner.addEventListener(listener);
+  }
+
+  /**
+   * Cleanup resources
+   */
+  async cleanup(): Promise<void> {
+    await this.sona.cleanup();
+    this.initialized = false;
+  }
+}
+
+/**
+ * Create a complete neural learning system
+ */
+export function createNeuralLearningSystem(mode: SONAMode = 'balanced'): NeuralLearningSystem {
+  return new NeuralLearningSystem(mode);
+}
+
+// =============================================================================
+// Default Export
+// =============================================================================
+
+export default {
+  // Factories
+  createSONAManager,
+  createReasoningBank,
+  createPatternLearner,
+  createNeuralLearningSystem,
+  createSONALearningEngine,
+
+  // Classes
+  SONAManager,
+  ReasoningBank,
+  PatternLearner,
+  NeuralLearningSystem,
+  SONALearningEngine,
+};