genesis-ai-cli 7.4.5

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

@@ -0,0 +1,185 @@
+/**
+ * Genesis Phase 10 - Brain Module
+ *
+ * The Neural Integration Layer - connects all 17 modules.
+ *
+ * Based on:
+ * - arXiv:2508.13171 (Cognitive Workspace) - 54-60% memory reuse
+ * - LangGraph Supervisor Pattern - Command({ goto, update })
+ * - IWMT (Integrated World Modeling Theory) - GWT + IIT + Active Inference
+ *
+ * Architecture:
+ * ```
+ * ┌─────────────────────────────────────────────────────────────────────┐
+ * │                           BRAIN                                     │
+ * │                                                                     │
+ * │  ┌──────────────────────────────────────────────────────────────┐  │
+ * │  │                  COGNITIVE WORKSPACE                          │  │
+ * │  │  Immediate (8K) → Task (64K) → Episodic (256K) → Semantic    │  │
+ * │  │  recall() / anticipate() / consolidate()                      │  │
+ * │  └──────────────────────────────────────────────────────────────┘  │
+ * │                              │                                      │
+ * │  ┌──────────────────────────────────────────────────────────────┐  │
+ * │  │                    SUPERVISOR                                 │  │
+ * │  │  memory → llm → grounding → tools → done                      │  │
+ * │  │  Command({ goto, update })                                    │  │
+ * │  └──────────────────────────────────────────────────────────────┘  │
+ * │                              │                                      │
+ * │  ┌──────────────────────────────────────────────────────────────┐  │
+ * │  │               GLOBAL WORKSPACE (φ Monitor)                    │  │
+ * │  │  broadcast() → all modules receive                            │  │
+ * │  └──────────────────────────────────────────────────────────────┘  │
+ * │                              │                                      │
+ * │  ┌──────────────────────────────────────────────────────────────┐  │
+ * │  │                   HEALING LOOP                                │  │
+ * │  │  detect() → diagnose() → fix() → verify() → retry()          │  │
+ * │  └──────────────────────────────────────────────────────────────┘  │
+ * └─────────────────────────────────────────────────────────────────────┘
+ * ```
+ */
+import { BrainState, BrainConfig, BrainMetrics, BrainEventHandler } from './types.js';
+export declare class Brain {
+    private config;
+    private workspace;
+    private globalWorkspace;
+    private phiMonitor;
+    private llm;
+    private dispatcher;
+    private grounding;
+    private running;
+    private currentState;
+    private systemPrompt;
+    private metrics;
+    private eventHandlers;
+    constructor(config?: Partial<BrainConfig>);
+    /**
+     * Start the brain (initializes consciousness monitoring)
+     */
+    start(): Promise<void>;
+    /**
+     * v7.2: Build system prompt with all available tools
+     */
+    private initializeSystemPrompt;
+    /**
+     * Stop the brain
+     */
+    stop(): void;
+    /**
+     * Check if brain is running
+     */
+    isRunning(): boolean;
+    /**
+     * Process an input through the brain
+     *
+     * This is the main entry point. It follows the supervisor pattern:
+     * memory → llm → grounding → tools → done
+     *
+     * Each module can route to another via Command({ goto, update })
+     */
+    process(input: string): Promise<string>;
+    /**
+     * Execute a single module step
+     */
+    private step;
+    /**
+     * Memory module: recall context and anticipate needs
+     */
+    private stepMemory;
+    /**
+     * LLM module: generate response
+     */
+    private stepLLM;
+    /**
+     * Grounding module: verify claims in response
+     */
+    private stepGrounding;
+    /**
+     * Tools module: execute tool calls
+     */
+    private stepTools;
+    /**
+     * Healing module: recover from errors
+     */
+    private stepHealing;
+    /**
+     * Consciousness module: check φ level
+     */
+    private stepConsciousness;
+    /**
+     * Kernel module: delegate to agent orchestration
+     * (Placeholder for future kernel integration)
+     */
+    private stepKernel;
+    /**
+     * Attempt to heal from an error
+     */
+    private heal;
+    /**
+     * Broadcast to global workspace
+     */
+    private broadcast;
+    /**
+     * Build context from cognitive workspace
+     */
+    private buildContext;
+    /**
+     * Create empty context
+     */
+    private createEmptyContext;
+    /**
+     * Parse tool calls from LLM response
+     */
+    private parseToolCalls;
+    /**
+     * Get current φ level
+     */
+    private getCurrentPhi;
+    /**
+     * Create initial metrics
+     */
+    private createInitialMetrics;
+    /**
+     * Update metrics after a cycle
+     */
+    private updateMetrics;
+    /**
+     * Get current metrics
+     */
+    getMetrics(): BrainMetrics;
+    /**
+     * Reset metrics
+     */
+    resetMetrics(): void;
+    /**
+     * Subscribe to brain events
+     */
+    on(handler: BrainEventHandler): () => void;
+    /**
+     * Emit brain event
+     */
+    private emit;
+    /**
+     * Get brain status
+     */
+    getStatus(): {
+        running: boolean;
+        phi: number;
+        memoryReuseRate: number;
+        lastState: BrainState | null;
+        metrics: BrainMetrics;
+        moduleStates: Record<string, boolean>;
+    };
+    /**
+     * Get configuration
+     */
+    getConfig(): BrainConfig;
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<BrainConfig>): void;
+}
+export declare function createBrain(config?: Partial<BrainConfig>): Brain;
+export declare function getBrain(config?: Partial<BrainConfig>): Brain;
+export declare function resetBrain(): void;
+export * from './types.js';
+export * from './trace.js';