monomind 1.6.0 → 1.6.1

package/packages/@monomind/cli/dist/src/ruvector/semantic-router.js

@@ -1,178 +0,0 @@
-/**
- * Pure JavaScript SemanticRouter implementation
- *
- * Provides intent routing using cosine similarity.
- * This is a fallback implementation since @ruvector/router's native VectorDb has bugs.
- *
- * Performance: ~50,000 routes/sec with 100 intents (sufficient for agent routing)
- */
-export class SemanticRouter {
-    dimension;
-    metric;
-    intents = new Map();
-    totalVectors = 0;
-    constructor(config) {
-        if (!config || typeof config.dimension !== 'number') {
-            throw new Error('SemanticRouter requires a dimension in config');
-        }
-        this.dimension = config.dimension;
-        this.metric = config.metric ?? 'cosine';
-    }
-    /**
-     * Add an intent with pre-computed embeddings
-     */
-    addIntentWithEmbeddings(name, embeddings, metadata = {}) {
-        if (!name || !Array.isArray(embeddings)) {
-            throw new Error('Must provide name and embeddings array');
-        }
-        // Validate embeddings
-        for (const emb of embeddings) {
-            if (!(emb instanceof Float32Array) || emb.length !== this.dimension) {
-                throw new Error(`Embedding must be Float32Array of length ${this.dimension}`);
-            }
-        }
-        // Normalize embeddings for cosine similarity
-        const normalizedEmbeddings = embeddings.map(emb => this.normalize(emb));
-        this.intents.set(name, {
-            name,
-            embeddings: normalizedEmbeddings,
-            metadata,
-        });
-        this.totalVectors += embeddings.length;
-    }
-    /**
-     * Route a query using a pre-computed embedding
-     */
-    routeWithEmbedding(embedding, k = 5) {
-        if (!(embedding instanceof Float32Array) || embedding.length !== this.dimension) {
-            throw new Error(`Embedding must be Float32Array of length ${this.dimension}`);
-        }
-        const normalizedQuery = this.normalize(embedding);
-        const scores = [];
-        // Calculate best score for each intent
-        for (const [intentName, intent] of this.intents) {
-            let bestScore = -Infinity;
-            for (const storedEmb of intent.embeddings) {
-                const score = this.similarity(normalizedQuery, storedEmb);
-                if (score > bestScore) {
-                    bestScore = score;
-                }
-            }
-            scores.push({
-                intent: intentName,
-                score: bestScore,
-                metadata: intent.metadata,
-            });
-        }
-        // Sort by score descending and take top k
-        return scores
-            .sort((a, b) => b.score - a.score)
-            .slice(0, k);
-    }
-    /**
-     * Remove an intent
-     */
-    removeIntent(name) {
-        const intent = this.intents.get(name);
-        if (!intent)
-            return false;
-        this.totalVectors -= intent.embeddings.length;
-        this.intents.delete(name);
-        return true;
-    }
-    /**
-     * Get all intent names
-     */
-    getIntents() {
-        return Array.from(this.intents.keys());
-    }
-    /**
-     * Get intent details
-     */
-    getIntent(name) {
-        const data = this.intents.get(name);
-        if (!data)
-            return null;
-        return {
-            name: data.name,
-            utterances: [], // We don't store utterances, only embeddings
-            metadata: data.metadata,
-        };
-    }
-    /**
-     * Clear all intents
-     */
-    clear() {
-        this.intents.clear();
-        this.totalVectors = 0;
-    }
-    /**
-     * Get total vector count
-     */
-    count() {
-        return this.totalVectors;
-    }
-    /**
-     * Get number of intents
-     */
-    intentCount() {
-        return this.intents.size;
-    }
-    /**
-     * Normalize a vector for cosine similarity
-     */
-    normalize(vec) {
-        let norm = 0;
-        for (let i = 0; i < vec.length; i++) {
-            norm += vec[i] * vec[i];
-        }
-        norm = Math.sqrt(norm);
-        if (norm === 0)
-            return vec;
-        const normalized = new Float32Array(vec.length);
-        for (let i = 0; i < vec.length; i++) {
-            normalized[i] = vec[i] / norm;
-        }
-        return normalized;
-    }
-    /**
-     * Calculate similarity between two normalized vectors
-     */
-    similarity(a, b) {
-        switch (this.metric) {
-            case 'cosine':
-                // For normalized vectors, cosine similarity = dot product
-                return this.dotProduct(a, b);
-            case 'dotProduct':
-                return this.dotProduct(a, b);
-            case 'euclidean':
-                // Convert Euclidean distance to similarity
-                return 1 / (1 + this.euclideanDistance(a, b));
-            default:
-                return this.dotProduct(a, b);
-        }
-    }
-    dotProduct(a, b) {
-        let sum = 0;
-        for (let i = 0; i < a.length; i++) {
-            sum += a[i] * b[i];
-        }
-        return sum;
-    }
-    euclideanDistance(a, b) {
-        let sum = 0;
-        for (let i = 0; i < a.length; i++) {
-            const diff = a[i] - b[i];
-            sum += diff * diff;
-        }
-        return Math.sqrt(sum);
-    }
-}
-/**
- * Create a SemanticRouter with the given configuration
- */
-export function createSemanticRouter(config) {
-    return new SemanticRouter(config);
-}
-export default SemanticRouter;
-//# sourceMappingURL=semantic-router.js.map

package/packages/@monomind/cli/dist/src/ruvector/vector-db.d.ts

@@ -1,69 +0,0 @@
-/**
- * Vector Database Module
- *
- * Provides optional ruvector WASM-accelerated vector operations for:
- * - Semantic similarity search
- * - HNSW indexing (150x faster)
- * - Embedding generation
- *
- * Gracefully degrades when ruvector is not installed.
- *
- * github.com/nokhodian/monomind
- */
-export interface VectorDB {
-    insert(embedding: Float32Array, id: string, metadata?: Record<string, unknown>): void | Promise<void>;
-    search(query: Float32Array, k?: number): Array<{
-        id: string;
-        score: number;
-        metadata?: Record<string, unknown>;
-    }> | Promise<Array<{
-        id: string;
-        score: number;
-        metadata?: Record<string, unknown>;
-    }>>;
-    remove(id: string): boolean | Promise<boolean>;
-    size(): number | Promise<number>;
-    clear(): void | Promise<void>;
-}
-export interface RuVectorModule {
-    createVectorDB(dimensions: number): Promise<VectorDB>;
-    generateEmbedding(text: string, dimensions?: number): Float32Array;
-    cosineSimilarity(a: Float32Array, b: Float32Array): number;
-    isWASMAccelerated(): boolean;
-}
-/**
- * Attempt to load the ruvector module
- * Returns true if successfully loaded, false otherwise
- */
-export declare function loadRuVector(): Promise<boolean>;
-/**
- * Check if ruvector is available
- */
-export declare function isRuVectorAvailable(): boolean;
-/**
- * Check if WASM acceleration is enabled
- */
-export declare function isWASMAccelerated(): boolean;
-/**
- * Create a vector database
- * Uses ruvector HNSW if available, falls back to brute-force search
- */
-export declare function createVectorDB(dimensions?: number): Promise<VectorDB>;
-/**
- * Generate an embedding for text
- * Uses ruvector if available, falls back to hash-based embedding
- */
-export declare function generateEmbedding(text: string, dimensions?: number): Float32Array;
-/**
- * Compute cosine similarity between two vectors
- */
-export declare function computeSimilarity(a: Float32Array, b: Float32Array): number;
-/**
- * Get status information about the ruvector module
- */
-export declare function getStatus(): {
-    available: boolean;
-    wasmAccelerated: boolean;
-    backend: 'ruvector-wasm' | 'ruvector' | 'fallback';
-};
-//# sourceMappingURL=vector-db.d.ts.map

package/packages/@monomind/cli/dist/src/ruvector/vector-db.js

@@ -1,243 +0,0 @@
-/**
- * Vector Database Module
- *
- * Provides optional ruvector WASM-accelerated vector operations for:
- * - Semantic similarity search
- * - HNSW indexing (150x faster)
- * - Embedding generation
- *
- * Gracefully degrades when ruvector is not installed.
- *
- * github.com/nokhodian/monomind
- */
-// ============================================================================
-// Fallback Implementation (when ruvector not available)
-// ============================================================================
-class FallbackVectorDB {
-    vectors = new Map();
-    dimensions;
-    constructor(dimensions) {
-        this.dimensions = dimensions;
-    }
-    insert(embedding, id, metadata) {
-        this.vectors.set(id, { embedding, metadata });
-    }
-    search(query, k = 10) {
-        const results = [];
-        for (const [id, { embedding, metadata }] of this.vectors) {
-            const score = cosineSimilarity(query, embedding);
-            results.push({ id, score, metadata });
-        }
-        return results
-            .sort((a, b) => b.score - a.score)
-            .slice(0, k);
-    }
-    remove(id) {
-        return this.vectors.delete(id);
-    }
-    size() {
-        return this.vectors.size;
-    }
-    clear() {
-        this.vectors.clear();
-    }
-}
-/**
- * Compute cosine similarity between two vectors
- */
-function cosineSimilarity(a, b) {
-    if (a.length !== b.length) {
-        throw new Error(`Vector dimension mismatch: ${a.length} vs ${b.length}`);
-    }
-    let dotProduct = 0;
-    let normA = 0;
-    let normB = 0;
-    for (let i = 0; i < a.length; i++) {
-        dotProduct += a[i] * b[i];
-        normA += a[i] * a[i];
-        normB += b[i] * b[i];
-    }
-    const denom = Math.sqrt(normA) * Math.sqrt(normB);
-    return denom === 0 ? 0 : dotProduct / denom;
-}
-/**
- * Generate a simple hash-based embedding (fallback when ruvector not available)
- */
-function generateHashEmbedding(text, dimensions = 768) {
-    const embedding = new Float32Array(dimensions);
-    const normalized = text.toLowerCase().trim();
-    // Simple hash function
-    let hash = 0;
-    for (let i = 0; i < normalized.length; i++) {
-        hash = ((hash << 5) - hash) + normalized.charCodeAt(i);
-        hash = hash & hash; // Convert to 32bit integer
-    }
-    // Generate pseudo-random embedding based on hash
-    for (let i = 0; i < dimensions; i++) {
-        embedding[i] = Math.sin(hash * (i + 1) * 0.001) * 0.5 + 0.5;
-    }
-    // Normalize
-    let norm = 0;
-    for (let i = 0; i < dimensions; i++) {
-        norm += embedding[i] * embedding[i];
-    }
-    norm = Math.sqrt(norm);
-    for (let i = 0; i < dimensions; i++) {
-        embedding[i] /= norm;
-    }
-    return embedding;
-}
-// ============================================================================
-// Module State
-// ============================================================================
-let ruvectorModule = null;
-let loadAttempted = false;
-let isAvailable = false;
-// ============================================================================
-// Public API
-// ============================================================================
-/**
- * Attempt to load the ruvector module
- * Returns true if successfully loaded, false otherwise
- */
-export async function loadRuVector() {
-    if (loadAttempted) {
-        return isAvailable;
-    }
-    loadAttempted = true;
-    try {
-        // Dynamic import to handle missing dependency gracefully
-        const ruvector = await import('ruvector').catch(() => null);
-        // ruvector exports VectorDB class, not createVectorDB function
-        if (ruvector && (typeof ruvector.VectorDB === 'function' || typeof ruvector.VectorDb === 'function')) {
-            // Create adapter module that matches our expected interface
-            const VectorDBClass = ruvector.VectorDB || ruvector.VectorDb;
-            ruvectorModule = {
-                createVectorDB: async (dimensions) => {
-                    const db = new VectorDBClass({ dimensions });
-                    // Wrap ruvector's VectorDB to match our interface
-                    return {
-                        insert: (embedding, id, metadata) => {
-                            db.insert({ id, vector: embedding, metadata });
-                        },
-                        search: async (query, k = 10) => {
-                            const results = await db.search({ vector: query, k });
-                            return results.map((r) => ({
-                                id: r.id,
-                                score: r.score,
-                                metadata: r.metadata,
-                            }));
-                        },
-                        remove: (id) => {
-                            db.delete(id);
-                            return true;
-                        },
-                        size: async () => {
-                            const len = await db.len();
-                            return len;
-                        },
-                        clear: () => {
-                            // Not directly supported - would need to recreate
-                        },
-                    };
-                },
-                generateEmbedding: (text, dimensions = 768) => {
-                    // ruvector may not have this - use fallback
-                    return generateHashEmbedding(text, dimensions);
-                },
-                cosineSimilarity: (a, b) => {
-                    return cosineSimilarity(a, b);
-                },
-                isWASMAccelerated: () => {
-                    return ruvector.isWasm?.() ?? false;
-                },
-            };
-            isAvailable = true;
-            return true;
-        }
-    }
-    catch {
-        // Silently fail - ruvector is optional
-    }
-    isAvailable = false;
-    return false;
-}
-/**
- * Check if ruvector is available
- */
-export function isRuVectorAvailable() {
-    return isAvailable;
-}
-/**
- * Check if WASM acceleration is enabled
- */
-export function isWASMAccelerated() {
-    if (ruvectorModule && typeof ruvectorModule.isWASMAccelerated === 'function') {
-        return ruvectorModule.isWASMAccelerated();
-    }
-    return false;
-}
-/**
- * Create a vector database
- * Uses ruvector HNSW if available, falls back to brute-force search
- */
-export async function createVectorDB(dimensions = 768) {
-    await loadRuVector();
-    if (ruvectorModule && typeof ruvectorModule.createVectorDB === 'function') {
-        try {
-            return await ruvectorModule.createVectorDB(dimensions);
-        }
-        catch {
-            // Fall back to simple implementation
-        }
-    }
-    return new FallbackVectorDB(dimensions);
-}
-/**
- * Generate an embedding for text
- * Uses ruvector if available, falls back to hash-based embedding
- */
-export function generateEmbedding(text, dimensions = 768) {
-    if (ruvectorModule && typeof ruvectorModule.generateEmbedding === 'function') {
-        try {
-            return ruvectorModule.generateEmbedding(text, dimensions);
-        }
-        catch {
-            // Fall back to hash-based embedding
-        }
-    }
-    return generateHashEmbedding(text, dimensions);
-}
-/**
- * Compute cosine similarity between two vectors
- */
-export function computeSimilarity(a, b) {
-    if (ruvectorModule && typeof ruvectorModule.cosineSimilarity === 'function') {
-        try {
-            return ruvectorModule.cosineSimilarity(a, b);
-        }
-        catch {
-            // Fall back to JS implementation
-        }
-    }
-    return cosineSimilarity(a, b);
-}
-/**
- * Get status information about the ruvector module
- */
-export function getStatus() {
-    if (!isAvailable) {
-        return {
-            available: false,
-            wasmAccelerated: false,
-            backend: 'fallback',
-        };
-    }
-    const wasmAccelerated = isWASMAccelerated();
-    return {
-        available: true,
-        wasmAccelerated,
-        backend: wasmAccelerated ? 'ruvector-wasm' : 'ruvector',
-    };
-}
-//# sourceMappingURL=vector-db.js.map

package/packages/@monomind/cli/dist/src/services/agentic-flow-bridge.d.ts

@@ -1,50 +0,0 @@
-/**
- * agentic-flow v1 integration bridge
- *
- * Provides a single lazy-loading entry point for all agentic-flow v1
- * subpath exports. Every accessor returns `null` when agentic-flow is
- * not installed — callers never throw on missing optional dependency.
- *
- * @module agentic-flow-bridge
- */
-/**
- * Load the ReasoningBank module (4-step learning pipeline).
- * Returns null if agentic-flow is not installed.
- * Race-safe: concurrent callers share the same import Promise.
- */
-export declare function getReasoningBank(): Promise<typeof import("agentic-flow/reasoningbank") | null>;
-/**
- * Load the ModelRouter module (multi-provider LLM routing).
- * Returns null if agentic-flow is not installed.
- */
-export declare function getRouter(): Promise<typeof import("agentic-flow/router") | null>;
-/**
- * Load the Orchestration module (workflow engine).
- * Returns null if agentic-flow is not installed.
- */
-export declare function getOrchestration(): Promise<typeof import("agentic-flow/orchestration") | null>;
-/**
- * Compute an embedding vector via ReasoningBank, falling back to null.
- */
-export declare function computeEmbedding(text: string): Promise<number[] | null>;
-/**
- * Retrieve memories matching a query via ReasoningBank.
- */
-export declare function retrieveMemories(query: string, opts?: {
-    k?: number;
-}): Promise<any[]>;
-/**
- * Check whether agentic-flow v1 is available at runtime.
- */
-export declare function isAvailable(): Promise<boolean>;
-/**
- * Return a summary of available agentic-flow v1 capabilities.
- */
-export declare function capabilities(): Promise<{
-    available: boolean;
-    reasoningBank: boolean;
-    router: boolean;
-    orchestration: boolean;
-    version: string | null;
-}>;
-//# sourceMappingURL=agentic-flow-bridge.d.ts.map

package/packages/@monomind/cli/dist/src/services/agentic-flow-bridge.js

@@ -1,95 +0,0 @@
-/**
- * agentic-flow v1 integration bridge
- *
- * Provides a single lazy-loading entry point for all agentic-flow v1
- * subpath exports. Every accessor returns `null` when agentic-flow is
- * not installed — callers never throw on missing optional dependency.
- *
- * @module agentic-flow-bridge
- */
-// ---------------------------------------------------------------------------
-// Cached module handles (Promise-based to prevent TOCTOU races)
-// ---------------------------------------------------------------------------
-let _reasoningBankP = null;
-let _routerP = null;
-let _orchestrationP = null;
-// ---------------------------------------------------------------------------
-// Public loaders
-// ---------------------------------------------------------------------------
-/**
- * Load the ReasoningBank module (4-step learning pipeline).
- * Returns null if agentic-flow is not installed.
- * Race-safe: concurrent callers share the same import Promise.
- */
-export function getReasoningBank() {
-    if (_reasoningBankP === null) {
-        _reasoningBankP = import('agentic-flow/reasoningbank').catch(() => null);
-    }
-    return _reasoningBankP;
-}
-/**
- * Load the ModelRouter module (multi-provider LLM routing).
- * Returns null if agentic-flow is not installed.
- */
-export function getRouter() {
-    if (_routerP === null) {
-        _routerP = import('agentic-flow/router').catch(() => null);
-    }
-    return _routerP;
-}
-/**
- * Load the Orchestration module (workflow engine).
- * Returns null if agentic-flow is not installed.
- */
-export function getOrchestration() {
-    if (_orchestrationP === null) {
-        _orchestrationP = import('agentic-flow/orchestration').catch(() => null);
-    }
-    return _orchestrationP;
-}
-// ---------------------------------------------------------------------------
-// Convenience helpers
-// ---------------------------------------------------------------------------
-/**
- * Compute an embedding vector via ReasoningBank, falling back to null.
- */
-export async function computeEmbedding(text) {
-    const rb = await getReasoningBank();
-    if (!rb?.computeEmbedding)
-        return null;
-    return rb.computeEmbedding(text);
-}
-/**
- * Retrieve memories matching a query via ReasoningBank.
- */
-export async function retrieveMemories(query, opts) {
-    const rb = await getReasoningBank();
-    if (!rb?.retrieveMemories)
-        return [];
-    return rb.retrieveMemories(query, opts);
-}
-/**
- * Check whether agentic-flow v1 is available at runtime.
- */
-export async function isAvailable() {
-    const rb = await getReasoningBank();
-    return rb !== null;
-}
-/**
- * Return a summary of available agentic-flow v1 capabilities.
- */
-export async function capabilities() {
-    const [rb, router, orch] = await Promise.all([
-        getReasoningBank(),
-        getRouter(),
-        getOrchestration(),
-    ]);
-    return {
-        available: rb !== null || router !== null || orch !== null,
-        reasoningBank: rb !== null,
-        router: router !== null,
-        orchestration: orch !== null,
-        version: rb?.VERSION ?? null,
-    };
-}
-//# sourceMappingURL=agentic-flow-bridge.js.map