@sparkleideas/embeddings 3.0.0-alpha.12-patch.26 → 3.0.0-alpha.12-patch.28

package/dist/neural-integration.d.ts

@@ -0,0 +1,203 @@
+/**
+ * Neural Substrate Integration
+ *
+ * Integrates agentic-flow's neural embedding features:
+ * - Semantic drift detection
+ * - Memory physics (hippocampal dynamics)
+ * - Embedding state machine
+ * - Swarm coordination
+ * - Coherence monitoring
+ *
+ * These features treat embeddings as a synthetic nervous system.
+ */
+export interface DriftResult {
+    distance: number;
+    velocity: number;
+    acceleration: number;
+    trend: 'stable' | 'drifting' | 'accelerating' | 'recovering';
+    shouldEscalate: boolean;
+    shouldTriggerReasoning: boolean;
+}
+export interface MemoryEntry {
+    id: string;
+    embedding: Float32Array;
+    content: string;
+    strength: number;
+    timestamp: number;
+    accessCount: number;
+    associations: string[];
+}
+export interface AgentState {
+    id: string;
+    position: Float32Array;
+    velocity: Float32Array;
+    attention: Float32Array;
+    energy: number;
+    lastUpdate: number;
+}
+export interface CoherenceResult {
+    isCoherent: boolean;
+    anomalyScore: number;
+    stabilityScore: number;
+    driftDirection: Float32Array | null;
+    warnings: string[];
+}
+export interface SubstrateHealth {
+    memoryCount: number;
+    activeAgents: number;
+    avgDrift: number;
+    avgCoherence: number;
+    lastConsolidation: number;
+    uptime: number;
+}
+export interface NeuralSubstrateConfig {
+    dimension?: number;
+    driftThreshold?: number;
+    decayRate?: number;
+}
+/**
+ * Lazy-loaded Neural Substrate wrapper
+ *
+ * Wraps agentic-flow's NeuralSubstrate with graceful fallback
+ */
+export declare class NeuralEmbeddingService {
+    private config;
+    private substrate;
+    private initialized;
+    private available;
+    constructor(config?: NeuralSubstrateConfig);
+    /**
+     * Initialize neural substrate
+     */
+    init(): Promise<boolean>;
+    /**
+     * Check if neural features are available
+     */
+    isAvailable(): boolean;
+    /**
+     * Detect semantic drift from baseline
+     */
+    detectDrift(input: string): Promise<DriftResult | null>;
+    /**
+     * Set baseline for drift detection
+     */
+    setDriftBaseline(context: string): Promise<void>;
+    /**
+     * Store memory with interference detection
+     */
+    storeMemory(id: string, content: string): Promise<{
+        stored: boolean;
+        interference: string[];
+    } | null>;
+    /**
+     * Recall memories by similarity
+     */
+    recallMemories(query: string, topK?: number): Promise<Array<MemoryEntry & {
+        relevance: number;
+    }> | null>;
+    /**
+     * Consolidate memories (merge similar, forget weak)
+     */
+    consolidateMemories(): {
+        merged: number;
+        forgotten: number;
+        remaining: number;
+    } | null;
+    /**
+     * Register agent for state tracking
+     */
+    registerAgent(id: string, role: string): Promise<AgentState | null>;
+    /**
+     * Update agent state based on observation
+     */
+    updateAgentState(agentId: string, observation: string): Promise<{
+        newState: AgentState;
+        nearestRegion: string;
+        regionProximity: number;
+    } | null>;
+    /**
+     * Get agent state
+     */
+    getAgentState(agentId: string): AgentState | null;
+    /**
+     * Coordinate swarm for task
+     */
+    coordinateSwarm(task: string): Promise<Array<{
+        agentId: string;
+        taskAlignment: number;
+        bestCollaborator: string | null;
+        collaborationScore: number;
+    }> | null>;
+    /**
+     * Add agent to swarm
+     */
+    addSwarmAgent(id: string, role: string): Promise<AgentState | null>;
+    /**
+     * Calibrate coherence monitor
+     */
+    calibrateCoherence(goodOutputs: string[]): Promise<{
+        calibrated: boolean;
+        sampleCount: number;
+    } | null>;
+    /**
+     * Check output coherence
+     */
+    checkCoherence(output: string): Promise<CoherenceResult | null>;
+    /**
+     * Process input through full neural substrate
+     */
+    process(input: string, context?: {
+        agentId?: string;
+        memoryId?: string;
+        checkCoherence?: boolean;
+    }): Promise<{
+        drift: DriftResult;
+        state?: {
+            nearestRegion: string;
+            regionProximity: number;
+        };
+        coherence?: CoherenceResult;
+        stored?: boolean;
+    } | null>;
+    /**
+     * Get substrate health
+     */
+    health(): SubstrateHealth | null;
+    /**
+     * Full consolidation pass
+     */
+    consolidate(): {
+        memory: {
+            merged: number;
+            forgotten: number;
+            remaining: number;
+        };
+    } | null;
+}
+/**
+ * Create neural embedding service
+ */
+export declare function createNeuralService(config?: NeuralSubstrateConfig): NeuralEmbeddingService;
+/**
+ * Check if neural features are available
+ */
+export declare function isNeuralAvailable(): Promise<boolean>;
+/**
+ * List available ONNX embedding models
+ */
+export declare function listEmbeddingModels(): Promise<Array<{
+    id: string;
+    dimension: number;
+    size: string;
+    quantized: boolean;
+    downloaded: boolean;
+}>>;
+/**
+ * Download embedding model
+ */
+export declare function downloadEmbeddingModel(modelId: string, targetDir?: string, onProgress?: (progress: {
+    percent: number;
+    bytesDownloaded: number;
+    totalBytes: number;
+}) => void): Promise<string>;
+//# sourceMappingURL=neural-integration.d.ts.map

package/dist/neural-integration.d.ts.map

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

package/dist/neural-integration.js

@@ -0,0 +1,213 @@
+/**
+ * Neural Substrate Integration
+ *
+ * Integrates agentic-flow's neural embedding features:
+ * - Semantic drift detection
+ * - Memory physics (hippocampal dynamics)
+ * - Embedding state machine
+ * - Swarm coordination
+ * - Coherence monitoring
+ *
+ * These features treat embeddings as a synthetic nervous system.
+ */
+/**
+ * Lazy-loaded Neural Substrate wrapper
+ *
+ * Wraps agentic-flow's NeuralSubstrate with graceful fallback
+ */
+export class NeuralEmbeddingService {
+    config;
+    substrate = null;
+    initialized = false;
+    available = false;
+    constructor(config = {}) {
+        this.config = config;
+    }
+    /**
+     * Initialize neural substrate
+     */
+    async init() {
+        if (this.initialized)
+            return this.available;
+        try {
+            const { getNeuralSubstrate } = await import('agentic-flow/embeddings');
+            this.substrate = await getNeuralSubstrate(this.config);
+            await this.substrate.init();
+            this.available = true;
+        }
+        catch (error) {
+            console.warn('[neural] Neural substrate not available:', error instanceof Error ? error.message : error);
+            this.available = false;
+        }
+        this.initialized = true;
+        return this.available;
+    }
+    /**
+     * Check if neural features are available
+     */
+    isAvailable() {
+        return this.available;
+    }
+    /**
+     * Detect semantic drift from baseline
+     */
+    async detectDrift(input) {
+        if (!this.available || !this.substrate)
+            return null;
+        return this.substrate.drift.detect(input);
+    }
+    /**
+     * Set baseline for drift detection
+     */
+    async setDriftBaseline(context) {
+        if (!this.available || !this.substrate)
+            return;
+        await this.substrate.drift.setBaseline(context);
+    }
+    /**
+     * Store memory with interference detection
+     */
+    async storeMemory(id, content) {
+        if (!this.available || !this.substrate)
+            return null;
+        return this.substrate.memory.store(id, content);
+    }
+    /**
+     * Recall memories by similarity
+     */
+    async recallMemories(query, topK = 5) {
+        if (!this.available || !this.substrate)
+            return null;
+        return this.substrate.memory.recall(query, topK);
+    }
+    /**
+     * Consolidate memories (merge similar, forget weak)
+     */
+    consolidateMemories() {
+        if (!this.available || !this.substrate)
+            return null;
+        return this.substrate.memory.consolidate();
+    }
+    /**
+     * Register agent for state tracking
+     */
+    async registerAgent(id, role) {
+        if (!this.available || !this.substrate)
+            return null;
+        return this.substrate.states.registerAgent(id, role);
+    }
+    /**
+     * Update agent state based on observation
+     */
+    async updateAgentState(agentId, observation) {
+        if (!this.available || !this.substrate)
+            return null;
+        return this.substrate.states.updateState(agentId, observation);
+    }
+    /**
+     * Get agent state
+     */
+    getAgentState(agentId) {
+        if (!this.available || !this.substrate)
+            return null;
+        return this.substrate.states.getAgent(agentId);
+    }
+    /**
+     * Coordinate swarm for task
+     */
+    async coordinateSwarm(task) {
+        if (!this.available || !this.substrate)
+            return null;
+        return this.substrate.swarm.coordinate(task);
+    }
+    /**
+     * Add agent to swarm
+     */
+    async addSwarmAgent(id, role) {
+        if (!this.available || !this.substrate)
+            return null;
+        return this.substrate.swarm.addAgent(id, role);
+    }
+    /**
+     * Calibrate coherence monitor
+     */
+    async calibrateCoherence(goodOutputs) {
+        if (!this.available || !this.substrate)
+            return null;
+        return this.substrate.coherence.calibrate(goodOutputs);
+    }
+    /**
+     * Check output coherence
+     */
+    async checkCoherence(output) {
+        if (!this.available || !this.substrate)
+            return null;
+        return this.substrate.coherence.check(output);
+    }
+    /**
+     * Process input through full neural substrate
+     */
+    async process(input, context) {
+        if (!this.available || !this.substrate)
+            return null;
+        return this.substrate.process(input, context);
+    }
+    /**
+     * Get substrate health
+     */
+    health() {
+        if (!this.available || !this.substrate)
+            return null;
+        return this.substrate.health();
+    }
+    /**
+     * Full consolidation pass
+     */
+    consolidate() {
+        if (!this.available || !this.substrate)
+            return null;
+        return this.substrate.consolidate();
+    }
+}
+/**
+ * Create neural embedding service
+ */
+export function createNeuralService(config = {}) {
+    return new NeuralEmbeddingService(config);
+}
+/**
+ * Check if neural features are available
+ */
+export async function isNeuralAvailable() {
+    try {
+        await import('agentic-flow/embeddings');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * List available ONNX embedding models
+ */
+export async function listEmbeddingModels() {
+    try {
+        const { listAvailableModels } = await import('agentic-flow/embeddings');
+        return listAvailableModels();
+    }
+    catch {
+        // Return default models if agentic-flow not available
+        return [
+            { id: 'all-MiniLM-L6-v2', dimension: 384, size: '23MB', quantized: false, downloaded: false },
+            { id: 'all-mpnet-base-v2', dimension: 768, size: '110MB', quantized: false, downloaded: false },
+        ];
+    }
+}
+/**
+ * Download embedding model
+ */
+export async function downloadEmbeddingModel(modelId, targetDir, onProgress) {
+    const { downloadModel } = await import('agentic-flow/embeddings');
+    return downloadModel(modelId, targetDir ?? '.models', onProgress);
+}
+//# sourceMappingURL=neural-integration.js.map

package/dist/neural-integration.js.map

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

package/dist/normalization.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Embedding Normalization Utilities
+ *
+ * Features:
+ * - L2 (Euclidean) normalization
+ * - L1 (Manhattan) normalization
+ * - Min-max normalization
+ * - Z-score standardization
+ * - Batch normalization
+ */
+/**
+ * Normalization type
+ */
+export type NormalizationType = 'l2' | 'l1' | 'minmax' | 'zscore' | 'none';
+/**
+ * Normalization options
+ */
+export interface NormalizationOptions {
+    /** Normalization type (default: 'l2') */
+    type?: NormalizationType;
+    /** Epsilon for numerical stability (default: 1e-12) */
+    epsilon?: number;
+    /** In-place modification (default: false) */
+    inPlace?: boolean;
+}
+/**
+ * L2 (Euclidean) normalize embedding to unit length
+ * Most common for cosine similarity
+ *
+ * @param embedding - Input embedding vector
+ * @param epsilon - Small value to prevent division by zero
+ * @returns Normalized embedding with ||v|| = 1
+ */
+export declare function l2Normalize(embedding: Float32Array | number[], epsilon?: number): Float32Array;
+/**
+ * L2 normalize embedding in-place (modifies original array)
+ */
+export declare function l2NormalizeInPlace(embedding: Float32Array, epsilon?: number): Float32Array;
+/**
+ * L1 (Manhattan) normalize embedding
+ * Sum of absolute values = 1
+ */
+export declare function l1Normalize(embedding: Float32Array | number[], epsilon?: number): Float32Array;
+/**
+ * Min-max normalize embedding to [0, 1] range
+ */
+export declare function minMaxNormalize(embedding: Float32Array | number[], epsilon?: number): Float32Array;
+/**
+ * Z-score standardize embedding (mean=0, std=1)
+ */
+export declare function zScoreNormalize(embedding: Float32Array | number[], epsilon?: number): Float32Array;
+/**
+ * Normalize embedding using specified method
+ */
+export declare function normalize(embedding: Float32Array | number[], options?: NormalizationOptions): Float32Array;
+/**
+ * Batch normalize multiple embeddings
+ */
+export declare function normalizeBatch(embeddings: Array<Float32Array | number[]>, options?: NormalizationOptions): Float32Array[];
+/**
+ * Calculate L2 norm of embedding
+ */
+export declare function l2Norm(embedding: Float32Array | number[]): number;
+/**
+ * Check if embedding is already normalized (L2 norm ≈ 1)
+ */
+export declare function isNormalized(embedding: Float32Array | number[], tolerance?: number): boolean;
+/**
+ * Center embeddings by subtracting mean across batch
+ * Useful for improving similarity metrics
+ */
+export declare function centerEmbeddings(embeddings: Array<Float32Array | number[]>): Float32Array[];
+//# sourceMappingURL=normalization.d.ts.map

package/dist/normalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalization.d.ts","sourceRoot":"","sources":["../src/normalization.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,IAAI,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,YAAY,GAAG,MAAM,EAAE,EAClC,OAAO,SAAQ,GACd,YAAY,CAoBd;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,YAAY,EACvB,OAAO,SAAQ,GACd,YAAY,CAcd;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,YAAY,GAAG,MAAM,EAAE,EAClC,OAAO,SAAQ,GACd,YAAY,CAgBd;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,YAAY,GAAG,MAAM,EAAE,EAClC,OAAO,SAAQ,GACd,YAAY,CAoBd;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,YAAY,GAAG,MAAM,EAAE,EAClC,OAAO,SAAQ,GACd,YAAY,CA0Bd;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,SAAS,EAAE,YAAY,GAAG,MAAM,EAAE,EAClC,OAAO,GAAE,oBAAyB,GACjC,YAAY,CAyBd;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,KAAK,CAAC,YAAY,GAAG,MAAM,EAAE,CAAC,EAC1C,OAAO,GAAE,oBAAyB,GACjC,YAAY,EAAE,CAEhB;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,SAAS,EAAE,YAAY,GAAG,MAAM,EAAE,GAAG,MAAM,CAMjE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,YAAY,GAAG,MAAM,EAAE,EAClC,SAAS,SAAO,GACf,OAAO,CAGT;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,KAAK,CAAC,YAAY,GAAG,MAAM,EAAE,CAAC,GACzC,YAAY,EAAE,CAyBhB"}