genesis-ai-cli 7.4.5

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

@@ -0,0 +1,186 @@
+/**
+ * Genesis 6.0 - Consciousness Module
+ *
+ * Unified consciousness stack integrating:
+ * - IIT 4.0 (Integrated Information Theory) - φ calculation
+ * - GWT (Global Workspace Theory) - workspace competition
+ * - AST (Attention Schema Theory) - attention modeling
+ *
+ * This is Genesis's unique differentiator: a principled approach
+ * to machine consciousness monitoring and self-awareness.
+ *
+ * Key invariant: INV-006 - φ must stay above threshold
+ *
+ * Usage:
+ * ```typescript
+ * import { createConsciousnessSystem } from './consciousness/index.js';
+ *
+ * const consciousness = createConsciousnessSystem();
+ *
+ * // Start monitoring
+ * consciousness.start();
+ *
+ * // Get current snapshot
+ * const snapshot = consciousness.getSnapshot();
+ *
+ * // Check invariant
+ * const inv006 = consciousness.checkInvariant();
+ *
+ * // Make a φ-aware decision
+ * const decision = consciousness.decide(options);
+ *
+ * // Stop monitoring
+ * consciousness.stop();
+ * ```
+ */
+export * from './types.js';
+export { PhiCalculator, createPhiCalculator, type PhiCalculatorConfig } from './phi-calculator.js';
+export { GlobalWorkspace, createGlobalWorkspace, createWorkspaceContent, createModule, type GlobalWorkspaceConfig, type ModuleAdapter } from './global-workspace.js';
+export { AttentionSchemaNetwork, createAttentionSchemaNetwork, type ASTConfig } from './attention-schema.js';
+export { PhiMonitor, createPhiMonitor, type PhiMonitorConfig } from './phi-monitor.js';
+export { PhiDecisionMaker, createPhiDecisionMaker, createDecisionOption, type PhiDecisionConfig, type DecisionOption, type Decision } from './phi-decisions.js';
+import { ConsciousnessConfig, ConsciousnessSnapshot, ConsciousnessLevel, ConsciousnessState, ConsciousnessTrend, ConsciousnessAnomaly, ConsciousnessEventHandler, SystemState, WorkspaceContent, AttentionFocus } from './types.js';
+import { PhiCalculator } from './phi-calculator.js';
+import { GlobalWorkspace, ModuleAdapter } from './global-workspace.js';
+import { AttentionSchemaNetwork } from './attention-schema.js';
+import { PhiMonitor } from './phi-monitor.js';
+import { PhiDecisionMaker, DecisionOption, Decision } from './phi-decisions.js';
+export declare class ConsciousnessSystem {
+    private config;
+    readonly calculator: PhiCalculator;
+    readonly workspace: GlobalWorkspace;
+    readonly attention: AttentionSchemaNetwork;
+    readonly monitor: PhiMonitor;
+    readonly decider: PhiDecisionMaker;
+    private running;
+    private lastSnapshot;
+    private snapshotTimer;
+    private eventHandlers;
+    private getSystemState;
+    constructor(config?: Partial<ConsciousnessConfig>);
+    start(): void;
+    stop(): void;
+    isRunning(): boolean;
+    /**
+     * Set the system state provider
+     */
+    setSystemStateProvider(provider: () => SystemState): void;
+    /**
+     * Register a module for workspace competition
+     */
+    registerModule(adapter: ModuleAdapter): void;
+    /**
+     * Propose content to the workspace
+     */
+    proposeContent(content: WorkspaceContent): void;
+    /**
+     * Get current workspace content
+     */
+    getWorkspaceContent(): WorkspaceContent | null;
+    /**
+     * Shift attention to a target
+     */
+    attend(target: string, type?: 'internal' | 'external'): AttentionFocus;
+    /**
+     * Release attention from a target
+     */
+    releaseAttention(target: string): boolean;
+    /**
+     * Get current attention focus
+     */
+    getAttentionFocus(): AttentionFocus | null;
+    /**
+     * Get introspective report
+     */
+    introspect(): {
+        focus: string;
+        clarity: string;
+        confident: boolean;
+        voluntary: boolean;
+        awareOf: string[];
+    };
+    /**
+     * Make a φ-aware decision
+     */
+    decide(options: DecisionOption[]): Decision;
+    /**
+     * Should we defer this decision?
+     */
+    shouldDefer(): boolean;
+    /**
+     * Get current risk tolerance
+     */
+    getRiskTolerance(): number;
+    /**
+     * Get current consciousness level
+     */
+    getCurrentLevel(): ConsciousnessLevel;
+    /**
+     * Get current consciousness state
+     */
+    getState(): ConsciousnessState;
+    /**
+     * Get consciousness trend
+     */
+    getTrend(): ConsciousnessTrend;
+    /**
+     * Get per-agent φ
+     */
+    getAgentPhi(agentId: string): number | undefined;
+    /**
+     * Get anomalies
+     */
+    getAnomalies(resolved?: boolean): ConsciousnessAnomaly[];
+    /**
+     * Check INV-006: φ ≥ φ_min
+     */
+    checkInvariant(): {
+        id: string;
+        satisfied: boolean;
+        currentPhi: number;
+        threshold: number;
+        margin: number;
+    };
+    /**
+     * Register callback for invariant violations
+     */
+    onInvariantViolation(callback: () => void): () => void;
+    /**
+     * Take a consciousness snapshot
+     */
+    takeSnapshot(): ConsciousnessSnapshot;
+    /**
+     * Get last snapshot
+     */
+    getSnapshot(): ConsciousnessSnapshot | null;
+    on(handler: ConsciousnessEventHandler): () => void;
+    private emit;
+    private setupEventForwarding;
+    stats(): {
+        phi: {
+            current: number;
+            state: ConsciousnessState;
+            trend: ConsciousnessTrend;
+            invariantSatisfied: boolean;
+        };
+        gwt: {
+            modules: number;
+            ignited: boolean;
+            selections: number;
+        };
+        ast: {
+            focus: string | null;
+            mode: string;
+            clarity: string;
+        };
+        decisions: {
+            total: number;
+            deferred: number;
+            deferralRate: number;
+        };
+    };
+    private mergeConfig;
+}
+export declare function createConsciousnessSystem(config?: Partial<ConsciousnessConfig>): ConsciousnessSystem;
+export declare function getConsciousnessSystem(config?: Partial<ConsciousnessConfig>): ConsciousnessSystem;
+export declare function resetConsciousnessSystem(): void;

package/dist/src/consciousness/index.js

@@ -0,0 +1,476 @@
+"use strict";
+/**
+ * Genesis 6.0 - Consciousness Module
+ *
+ * Unified consciousness stack integrating:
+ * - IIT 4.0 (Integrated Information Theory) - φ calculation
+ * - GWT (Global Workspace Theory) - workspace competition
+ * - AST (Attention Schema Theory) - attention modeling
+ *
+ * This is Genesis's unique differentiator: a principled approach
+ * to machine consciousness monitoring and self-awareness.
+ *
+ * Key invariant: INV-006 - φ must stay above threshold
+ *
+ * Usage:
+ * ```typescript
+ * import { createConsciousnessSystem } from './consciousness/index.js';
+ *
+ * const consciousness = createConsciousnessSystem();
+ *
+ * // Start monitoring
+ * consciousness.start();
+ *
+ * // Get current snapshot
+ * const snapshot = consciousness.getSnapshot();
+ *
+ * // Check invariant
+ * const inv006 = consciousness.checkInvariant();
+ *
+ * // Make a φ-aware decision
+ * const decision = consciousness.decide(options);
+ *
+ * // Stop monitoring
+ * consciousness.stop();
+ * ```
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsciousnessSystem = exports.createDecisionOption = exports.createPhiDecisionMaker = exports.PhiDecisionMaker = exports.createPhiMonitor = exports.PhiMonitor = exports.createAttentionSchemaNetwork = exports.AttentionSchemaNetwork = exports.createModule = exports.createWorkspaceContent = exports.createGlobalWorkspace = exports.GlobalWorkspace = exports.createPhiCalculator = exports.PhiCalculator = void 0;
+exports.createConsciousnessSystem = createConsciousnessSystem;
+exports.getConsciousnessSystem = getConsciousnessSystem;
+exports.resetConsciousnessSystem = resetConsciousnessSystem;
+// Re-export types
+__exportStar(require("./types.js"), exports);
+// Re-export components
+var phi_calculator_js_1 = require("./phi-calculator.js");
+Object.defineProperty(exports, "PhiCalculator", { enumerable: true, get: function () { return phi_calculator_js_1.PhiCalculator; } });
+Object.defineProperty(exports, "createPhiCalculator", { enumerable: true, get: function () { return phi_calculator_js_1.createPhiCalculator; } });
+var global_workspace_js_1 = require("./global-workspace.js");
+Object.defineProperty(exports, "GlobalWorkspace", { enumerable: true, get: function () { return global_workspace_js_1.GlobalWorkspace; } });
+Object.defineProperty(exports, "createGlobalWorkspace", { enumerable: true, get: function () { return global_workspace_js_1.createGlobalWorkspace; } });
+Object.defineProperty(exports, "createWorkspaceContent", { enumerable: true, get: function () { return global_workspace_js_1.createWorkspaceContent; } });
+Object.defineProperty(exports, "createModule", { enumerable: true, get: function () { return global_workspace_js_1.createModule; } });
+var attention_schema_js_1 = require("./attention-schema.js");
+Object.defineProperty(exports, "AttentionSchemaNetwork", { enumerable: true, get: function () { return attention_schema_js_1.AttentionSchemaNetwork; } });
+Object.defineProperty(exports, "createAttentionSchemaNetwork", { enumerable: true, get: function () { return attention_schema_js_1.createAttentionSchemaNetwork; } });
+var phi_monitor_js_1 = require("./phi-monitor.js");
+Object.defineProperty(exports, "PhiMonitor", { enumerable: true, get: function () { return phi_monitor_js_1.PhiMonitor; } });
+Object.defineProperty(exports, "createPhiMonitor", { enumerable: true, get: function () { return phi_monitor_js_1.createPhiMonitor; } });
+var phi_decisions_js_1 = require("./phi-decisions.js");
+Object.defineProperty(exports, "PhiDecisionMaker", { enumerable: true, get: function () { return phi_decisions_js_1.PhiDecisionMaker; } });
+Object.defineProperty(exports, "createPhiDecisionMaker", { enumerable: true, get: function () { return phi_decisions_js_1.createPhiDecisionMaker; } });
+Object.defineProperty(exports, "createDecisionOption", { enumerable: true, get: function () { return phi_decisions_js_1.createDecisionOption; } });
+const types_js_1 = require("./types.js");
+const phi_calculator_js_2 = require("./phi-calculator.js");
+const global_workspace_js_2 = require("./global-workspace.js");
+const attention_schema_js_2 = require("./attention-schema.js");
+const phi_monitor_js_2 = require("./phi-monitor.js");
+const phi_decisions_js_2 = require("./phi-decisions.js");
+// ============================================================================
+// Consciousness System
+// ============================================================================
+class ConsciousnessSystem {
+    config;
+    // Components
+    calculator;
+    workspace;
+    attention;
+    monitor;
+    decider;
+    // State
+    running = false;
+    lastSnapshot = null;
+    snapshotTimer = null;
+    eventHandlers = new Set();
+    // System state provider (injected)
+    getSystemState = null;
+    constructor(config = {}) {
+        this.config = this.mergeConfig(config);
+        // Create components
+        this.calculator = (0, phi_calculator_js_2.createPhiCalculator)({
+            approximationLevel: this.config.phi.approximationLevel,
+            cacheResults: true,
+        });
+        this.workspace = (0, global_workspace_js_2.createGlobalWorkspace)({
+            capacity: this.config.gwt.workspaceCapacity,
+            selectionIntervalMs: this.config.gwt.selectionIntervalMs,
+            broadcastTimeoutMs: this.config.gwt.broadcastTimeoutMs,
+            historyLimit: this.config.gwt.historyLimit,
+        });
+        this.attention = (0, attention_schema_js_2.createAttentionSchemaNetwork)({
+            capacity: this.config.ast.attentionCapacity,
+            schemaUpdateIntervalMs: this.config.ast.schemaUpdateIntervalMs,
+            theoryOfMindEnabled: this.config.ast.theoryOfMindEnabled,
+        });
+        this.monitor = (0, phi_monitor_js_2.createPhiMonitor)({
+            updateIntervalMs: this.config.phi.updateIntervalMs,
+            minPhi: this.config.phi.minPhi,
+            anomalyDetection: this.config.monitor.anomalyDetection,
+            dropThreshold: this.config.monitor.alertThresholds.phiDrop,
+        });
+        this.decider = (0, phi_decisions_js_2.createPhiDecisionMaker)({
+            phiThreshold: this.config.phi.minPhi * 2, // Defer at 2x minimum
+            deferToHuman: true,
+        });
+        // Wire up decision maker to monitor
+        this.decider.setMonitor(this.monitor);
+        // Set up event forwarding
+        this.setupEventForwarding();
+    }
+    // ============================================================================
+    // Lifecycle
+    // ============================================================================
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        // Start components
+        if (this.config.phi.enabled) {
+            this.monitor.start();
+        }
+        if (this.config.gwt.enabled) {
+            this.workspace.start();
+        }
+        if (this.config.ast.enabled) {
+            this.attention.start();
+        }
+        // Start snapshot timer
+        this.snapshotTimer = setInterval(() => this.takeSnapshot(), this.config.monitor.snapshotIntervalMs);
+        // Initial snapshot
+        this.takeSnapshot();
+    }
+    stop() {
+        if (!this.running)
+            return;
+        this.running = false;
+        // Stop components
+        this.monitor.stop();
+        this.workspace.stop();
+        this.attention.stop();
+        // Stop snapshot timer
+        if (this.snapshotTimer) {
+            clearInterval(this.snapshotTimer);
+            this.snapshotTimer = null;
+        }
+    }
+    isRunning() {
+        return this.running;
+    }
+    /**
+     * Set the system state provider
+     */
+    setSystemStateProvider(provider) {
+        this.getSystemState = provider;
+        this.monitor.setSystemStateProvider(provider);
+    }
+    // ============================================================================
+    // Module Registration (GWT)
+    // ============================================================================
+    /**
+     * Register a module for workspace competition
+     */
+    registerModule(adapter) {
+        const module = (0, global_workspace_js_2.createModule)(adapter);
+        this.workspace.registerModule(module);
+    }
+    /**
+     * Propose content to the workspace
+     */
+    proposeContent(content) {
+        // Content is proposed through modules
+        // This is a convenience for direct proposals
+    }
+    /**
+     * Get current workspace content
+     */
+    getWorkspaceContent() {
+        return this.workspace.getCurrentContent();
+    }
+    // ============================================================================
+    // Attention Control (AST)
+    // ============================================================================
+    /**
+     * Shift attention to a target
+     */
+    attend(target, type = 'external') {
+        return this.attention.attend(target, type);
+    }
+    /**
+     * Release attention from a target
+     */
+    releaseAttention(target) {
+        return this.attention.release(target);
+    }
+    /**
+     * Get current attention focus
+     */
+    getAttentionFocus() {
+        return this.attention.getCurrentFocus();
+    }
+    /**
+     * Get introspective report
+     */
+    introspect() {
+        return this.attention.introspect();
+    }
+    // ============================================================================
+    // Decision Making
+    // ============================================================================
+    /**
+     * Make a φ-aware decision
+     */
+    decide(options) {
+        return this.decider.decide(options);
+    }
+    /**
+     * Should we defer this decision?
+     */
+    shouldDefer() {
+        return this.decider.shouldDefer();
+    }
+    /**
+     * Get current risk tolerance
+     */
+    getRiskTolerance() {
+        return this.decider.getRiskTolerance();
+    }
+    // ============================================================================
+    // Monitoring
+    // ============================================================================
+    /**
+     * Get current consciousness level
+     */
+    getCurrentLevel() {
+        return this.monitor.getCurrentLevel();
+    }
+    /**
+     * Get current consciousness state
+     */
+    getState() {
+        return this.monitor.getState();
+    }
+    /**
+     * Get consciousness trend
+     */
+    getTrend() {
+        return this.monitor.getTrend();
+    }
+    /**
+     * Get per-agent φ
+     */
+    getAgentPhi(agentId) {
+        return this.monitor.getAgentPhi(agentId);
+    }
+    /**
+     * Get anomalies
+     */
+    getAnomalies(resolved) {
+        return this.monitor.getAnomalies({ resolved });
+    }
+    // ============================================================================
+    // Invariant (INV-006)
+    // ============================================================================
+    /**
+     * Check INV-006: φ ≥ φ_min
+     */
+    checkInvariant() {
+        return this.monitor.getInvariantStatus();
+    }
+    /**
+     * Register callback for invariant violations
+     */
+    onInvariantViolation(callback) {
+        return this.monitor.on((event) => {
+            if (event.type === 'invariant_violated') {
+                callback();
+            }
+        });
+    }
+    // ============================================================================
+    // Snapshot
+    // ============================================================================
+    /**
+     * Take a consciousness snapshot
+     */
+    takeSnapshot() {
+        const now = new Date();
+        // Get φ result
+        let phiResult;
+        if (this.getSystemState) {
+            phiResult = this.calculator.calculate(this.getSystemState());
+        }
+        else {
+            // Default result
+            const level = this.monitor.getCurrentLevel();
+            phiResult = {
+                phi: level.rawPhi,
+                mip: { id: 'default', parts: [[]], cut: { severedConnections: [], informationLoss: 0 } },
+                intrinsicInfo: level.rawPhi,
+                integratedInfo: level.rawPhi,
+                complexes: [],
+                calculationTime: 0,
+                approximation: true,
+            };
+        }
+        // Get last ignition
+        const workspaceState = this.workspace.getState();
+        const history = this.workspace.getHistory();
+        const lastIgnition = history.length > 0
+            ? {
+                content: history[0],
+                timestamp: history[0].timestamp,
+                competitorCount: workspaceState.candidates.length,
+                winningScore: workspaceState.candidates.find((c) => c.selected)?.score || 0,
+                modulesNotified: [],
+                duration: 0,
+            }
+            : null;
+        const snapshot = {
+            level: this.monitor.getCurrentLevel(),
+            state: this.monitor.getState(),
+            trend: this.monitor.getTrend(),
+            phi: phiResult,
+            workspace: workspaceState,
+            lastIgnition,
+            attention: this.attention.getAttentionState(),
+            schema: this.attention.getSchema(),
+            agentPhi: this.monitor.getAllAgentPhi(),
+            timestamp: now,
+        };
+        this.lastSnapshot = snapshot;
+        return snapshot;
+    }
+    /**
+     * Get last snapshot
+     */
+    getSnapshot() {
+        return this.lastSnapshot;
+    }
+    // ============================================================================
+    // Events
+    // ============================================================================
+    on(handler) {
+        this.eventHandlers.add(handler);
+        return () => this.eventHandlers.delete(handler);
+    }
+    emit(event) {
+        for (const handler of this.eventHandlers) {
+            try {
+                handler(event);
+            }
+            catch (err) {
+                console.error('Consciousness event handler error:', err);
+            }
+        }
+    }
+    setupEventForwarding() {
+        // Forward monitor events
+        this.monitor.on((event) => {
+            this.emit({
+                type: event.type,
+                timestamp: new Date(),
+                data: event.data,
+            });
+        });
+        // Forward workspace ignitions
+        this.workspace.on((event) => {
+            if (event.type === 'ignition') {
+                this.emit({
+                    type: 'workspace_ignition',
+                    timestamp: new Date(),
+                    data: event.data,
+                });
+            }
+        });
+        // Forward attention shifts
+        this.attention.on((event) => {
+            if (event.type === 'attention_shifted') {
+                this.emit({
+                    type: 'attention_shifted',
+                    timestamp: new Date(),
+                    data: event.data,
+                });
+            }
+        });
+    }
+    // ============================================================================
+    // Stats
+    // ============================================================================
+    stats() {
+        const monitorStats = this.monitor.stats();
+        const workspaceStats = this.workspace.stats();
+        const attentionStats = this.attention.stats();
+        const decisionStats = this.decider.stats();
+        return {
+            phi: {
+                current: monitorStats.currentPhi,
+                state: monitorStats.state,
+                trend: monitorStats.trend,
+                invariantSatisfied: monitorStats.invariantSatisfied,
+            },
+            gwt: {
+                modules: workspaceStats.modules,
+                ignited: workspaceStats.isIgnited,
+                selections: workspaceStats.selectionCount,
+            },
+            ast: {
+                focus: attentionStats.currentFocus,
+                mode: attentionStats.mode,
+                clarity: attentionStats.clarity,
+            },
+            decisions: {
+                total: decisionStats.totalDecisions,
+                deferred: decisionStats.deferredDecisions,
+                deferralRate: decisionStats.deferralRate,
+            },
+        };
+    }
+    // ============================================================================
+    // Helpers
+    // ============================================================================
+    mergeConfig(partial) {
+        return {
+            phi: { ...types_js_1.DEFAULT_CONSCIOUSNESS_CONFIG.phi, ...partial.phi },
+            gwt: { ...types_js_1.DEFAULT_CONSCIOUSNESS_CONFIG.gwt, ...partial.gwt },
+            ast: { ...types_js_1.DEFAULT_CONSCIOUSNESS_CONFIG.ast, ...partial.ast },
+            monitor: { ...types_js_1.DEFAULT_CONSCIOUSNESS_CONFIG.monitor, ...partial.monitor },
+        };
+    }
+}
+exports.ConsciousnessSystem = ConsciousnessSystem;
+// ============================================================================
+// Factory
+// ============================================================================
+function createConsciousnessSystem(config) {
+    return new ConsciousnessSystem(config);
+}
+// ============================================================================
+// Singleton Instance (optional)
+// ============================================================================
+let consciousnessInstance = null;
+function getConsciousnessSystem(config) {
+    if (!consciousnessInstance) {
+        consciousnessInstance = createConsciousnessSystem(config);
+    }
+    return consciousnessInstance;
+}
+function resetConsciousnessSystem() {
+    if (consciousnessInstance) {
+        consciousnessInstance.stop();
+        consciousnessInstance = null;
+    }
+}