@ninebix/nmt-system 1.0.2 → 1.0.4

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

@@ -1,251 +0,0 @@
-/**
- * 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/core/probabilistic-neuron.d.ts.map

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