@ninebix/nmt-system 1.0.0

package/dist/src/core/probabilistic-neuron.d.ts

@@ -0,0 +1,251 @@
+/**
+ * Probabilistic Neuron System - Direct Probability Distribution
+ *
+ * Clean implementation without quantum simulation overhead:
+ * - Direct probability distributions over interpretations
+ * - Shannon entropy for uncertainty
+ * - Bayesian updates for evidence
+ * - Simple, fast, interpretable
+ *
+ * @module core/probabilistic-neuron
+ */
+import type { UUID, NeuronNode, Embedding384, INeuronStore } from '../types/index.js';
+/**
+ * A single possible interpretation/state
+ */
+export interface NeuronState {
+    id: UUID;
+    embedding: Embedding384;
+    probability: number;
+    label?: string;
+    metadata: Record<string, any>;
+    createdAt: string;
+}
+/**
+ * Probability distribution over multiple states
+ */
+export interface StateSuperposition {
+    states: NeuronState[];
+    entropy: number;
+    dominantState: UUID | null;
+    lastObserved?: string;
+}
+/**
+ * Observation result after selection
+ */
+export interface ObservationResult {
+    neuronId: UUID;
+    collapsedState: NeuronState;
+    probability: number;
+    previousEntropy: number;
+    newEntropy: number;
+    observedAt: string;
+    observer?: string;
+}
+/**
+ * State evolution record
+ */
+export interface StateEvolution {
+    neuronId: UUID;
+    fromState: UUID;
+    toState: UUID;
+    probability: number;
+    trigger: string;
+    timestamp: string;
+}
+/**
+ * Probabilistic Neuron
+ */
+export interface ProbabilisticNeuron extends NeuronNode {
+    superposition: StateSuperposition;
+    observationHistory: ObservationResult[];
+    decayRate: number;
+}
+/**
+ * Probabilistic Neuron Manager Options
+ */
+export interface ProbabilisticNeuronOptions {
+    neuronStore: INeuronStore;
+    maxStatesPerNeuron?: number;
+    defaultDecayRate?: number;
+    enableInterference?: boolean;
+}
+/**
+ * State distribution info for external access
+ */
+export interface StateDistributionInfo {
+    neuronId: UUID;
+    dimension: number;
+    amplitudes: Array<{
+        re: number;
+        im: number;
+        magnitude: number;
+        phase: number;
+    }>;
+    probabilities: number[];
+    entropy: number;
+    purity: number;
+    isEntangled: boolean;
+    entangledWith?: UUID[];
+}
+/** @deprecated Use StateDistributionInfo instead */
+export type QuantumStateInfo = StateDistributionInfo;
+/**
+ * Entanglement info (correlation between neurons)
+ */
+export interface EntanglementInfo {
+    concurrence: number;
+    vonNeumannEntropy: number;
+    bellState: 'Φ+' | 'Φ-' | 'Ψ+' | 'Ψ-' | 'mixed' | null;
+}
+/**
+ * Probabilistic Neuron Manager - Direct Probability Distribution
+ *
+ * Manages neurons with probability distributions over interpretations.
+ * No quantum overhead - just clean Bayesian probability.
+ *
+ * Key Concepts:
+ * - **Distribution**: Each neuron has multiple possible interpretations with probabilities
+ * - **Observation**: Samples from distribution, can update based on context
+ * - **Entropy**: Shannon entropy measures uncertainty
+ * - **Correlation**: Similar embeddings can have correlated updates
+ *
+ * @example
+ * ```typescript
+ * const manager = new ProbabilisticNeuronManager({ neuronStore: store });
+ *
+ * // Create a probabilistic neuron
+ * const probNeuron = await manager.createProbabilisticNeuron(classicalNeuron);
+ *
+ * // Add alternative interpretation
+ * manager.addState(probNeuron.id, alternativeEmbedding, 0.3, 'alternative');
+ *
+ * // Check uncertainty (entropy)
+ * const uncertainty = manager.getUncertainty(probNeuron.id);
+ * console.log(`Uncertainty: ${uncertainty.toFixed(2)} bits`);
+ *
+ * // Observe to sample from distribution
+ * const result = manager.observe(probNeuron.id, 'user-query');
+ * console.log(`Selected: ${result?.collapsedState.label}`);
+ * ```
+ */
+export declare class ProbabilisticNeuronManager {
+    private store;
+    private maxStates;
+    private defaultDecayRate;
+    private interferenceEnabled;
+    private probabilisticNeurons;
+    private evolutionHistory;
+    private correlationPairs;
+    constructor(options: ProbabilisticNeuronOptions);
+    /**
+     * Create a probabilistic neuron from a classical neuron.
+     */
+    createProbabilisticNeuron(baseNeuron: NeuronNode, initialStates?: NeuronState[]): Promise<ProbabilisticNeuron>;
+    /**
+     * Add a new state to neuron's distribution.
+     */
+    addState(neuronId: UUID, embedding: Embedding384, probability: number, label?: string, metadata?: Record<string, any>): NeuronState | null;
+    /**
+     * Observe the neuron - sample from probability distribution.
+     *
+     * Uses direct probability sampling:
+     * P(state_i) = probability_i / Σ probabilities
+     */
+    observe(neuronId: UUID, observer?: string, biasEmbedding?: Embedding384): ObservationResult | null;
+    /**
+     * Handle correlated update on partner neuron
+     */
+    private handleCorrelatedUpdate;
+    /**
+     * Get the most probable state without modifying distribution
+     */
+    peekMostProbable(neuronId: UUID, biasEmbedding?: Embedding384): NeuronState | null;
+    /**
+     * Evolve distribution over time (entropy increase / decay)
+     */
+    evolve(neuronId: UUID, deltaTime: number): void;
+    /**
+     * Create correlation between two neurons (replacement for "entangle")
+     */
+    entangle(neuronIdA: UUID, neuronIdB: UUID, _bellType?: 'Φ+' | 'Φ-' | 'Ψ+' | 'Ψ-'): boolean;
+    /**
+     * Check if neurons are correlated
+     */
+    isEntangled(neuronIdA: UUID, neuronIdB?: UUID): boolean;
+    /**
+     * Get correlation info between neurons
+     */
+    getEntanglementInfo(neuronIdA: UUID, neuronIdB: UUID): EntanglementInfo | null;
+    /**
+     * Get state distribution info
+     */
+    getStateDistributionInfo(neuronId: UUID): StateDistributionInfo | null;
+    /**
+     * Apply a "gate" - transform probabilities
+     */
+    applyGate(neuronId: UUID, gate: 'X' | 'Y' | 'Z' | 'H' | 'S' | 'T'): void;
+    /**
+     * Calculate expected embedding (weighted average)
+     */
+    getExpectedEmbedding(neuronId: UUID): Embedding384 | null;
+    /**
+     * Get uncertainty (Shannon entropy)
+     */
+    getUncertainty(neuronId: UUID): number;
+    /**
+     * Split a state into multiple possibilities
+     */
+    splitState(neuronId: UUID, stateId: UUID, splitEmbeddings: Embedding384[], splitRatios?: number[]): NeuronState[];
+    /**
+     * Get probabilistic neuron
+     */
+    getNeuron(neuronId: UUID): ProbabilisticNeuron | undefined;
+    /**
+     * Get statistics
+     */
+    getStats(): {
+        totalNeurons: number;
+        totalStates: number;
+        averageEntropy: number;
+        totalObservations: number;
+        averageStatesPerNeuron: number;
+    };
+    /**
+     * Serialize state for persistence
+     */
+    serialize(): object;
+    /**
+     * Load state from serialized data
+     */
+    load(data: {
+        neurons: Array<{
+            id: string;
+            baseNeuron: any;
+            superposition: any;
+            observationHistory: any[];
+            decayRate: number;
+        }>;
+        evolutionHistory?: any[];
+        correlations?: Record<string, string[]>;
+    }): void;
+    /**
+     * Get all neuron IDs
+     */
+    getAllNeuronIds(): string[];
+    private createStateFromNeuron;
+    private calculateEntropy;
+    private calculatePurity;
+    private normalizeProbabilities;
+    private updateMetrics;
+    private pruneWeakestState;
+    private calculateBiasedProbabilities;
+    private sampleFromDistribution;
+    private updateAfterObservation;
+    private applyInterference;
+}
+/**
+ * Create a ProbabilisticNeuronManager instance
+ */
+export declare function createProbabilisticNeuronManager(options: ProbabilisticNeuronOptions): ProbabilisticNeuronManager;
+//# sourceMappingURL=probabilistic-neuron.d.ts.map

package/dist/src/core/probabilistic-neuron.d.ts.map

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