clodds 1.1.0

package/dist/embeddings/index.js

@@ -0,0 +1,399 @@
+"use strict";
+/**
+ * Embeddings Service - Vector embeddings for semantic search
+ *
+ * Features:
+ * - Generate embeddings using OpenAI API (text-embedding-3-small)
+ * - Local neural embeddings using transformers.js (no API key required)
+ * - Store embeddings in SQLite for caching
+ * - Cosine similarity search
+ * - Batch embedding generation
+ */
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTransformersPipeline = getTransformersPipeline;
+exports.createEmbeddingsService = createEmbeddingsService;
+const logger_1 = require("../utils/logger");
+const id_1 = require("../utils/id");
+// Lazy-loaded transformers.js pipeline
+let localPipeline = null;
+let pipelinePromise = null;
+const LOCAL_MODEL = 'Xenova/all-MiniLM-L6-v2'; // 384-dim, fast & good quality
+/**
+ * Initialize transformers.js pipeline (lazy-loaded, singleton)
+ */
+async function getTransformersPipeline() {
+    if (localPipeline)
+        return localPipeline;
+    if (pipelinePromise)
+        return pipelinePromise;
+    pipelinePromise = (async () => {
+        try {
+            // Dynamic import to avoid loading heavy model at startup
+            const { pipeline, env } = await Promise.resolve().then(() => __importStar(require('@xenova/transformers')));
+            // Configure transformers.js
+            env.cacheDir = './.transformers-cache';
+            env.allowLocalModels = true;
+            logger_1.logger.info({ model: LOCAL_MODEL }, 'Loading local embedding model...');
+            // Create feature-extraction pipeline
+            const pipe = await pipeline('feature-extraction', LOCAL_MODEL, {
+                quantized: true, // Use quantized model for faster inference
+            });
+            localPipeline = pipe;
+            logger_1.logger.info({ model: LOCAL_MODEL }, 'Local embedding model loaded');
+            return localPipeline;
+        }
+        catch (error) {
+            logger_1.logger.error({ error }, 'Failed to load transformers.js model');
+            throw error;
+        }
+    })();
+    return pipelinePromise;
+}
+/** Default configuration - local first like Clawdbot */
+const DEFAULT_CONFIG = {
+    provider: 'local', // Default to local, no API key needed
+    model: 'text-embedding-3-small', // Used if provider is 'openai'
+    dimensions: 256, // Local embedding dimensions
+};
+/** Simple hash function for caching */
+function hashContent(content) {
+    let hash = 0;
+    for (let i = 0; i < content.length; i++) {
+        const char = content.charCodeAt(i);
+        hash = ((hash << 5) - hash) + char;
+        hash = hash & hash; // Convert to 32bit integer
+    }
+    return hash.toString(36);
+}
+function createEmbeddingsService(db, configInput) {
+    const config = { ...DEFAULT_CONFIG, ...configInput };
+    // Initialize database table
+    db.run(`
+    CREATE TABLE IF NOT EXISTS embeddings_cache (
+      id TEXT PRIMARY KEY,
+      contentHash TEXT UNIQUE NOT NULL,
+      content TEXT NOT NULL,
+      vector TEXT NOT NULL,
+      createdAt TEXT NOT NULL
+    )
+  `);
+    db.run(`
+    CREATE INDEX IF NOT EXISTS idx_embeddings_hash
+    ON embeddings_cache(contentHash)
+  `);
+    // In-memory cache for frequently accessed embeddings
+    const memoryCache = new Map();
+    /**
+     * Generate embedding using OpenAI API
+     */
+    async function generateOpenAIEmbedding(text) {
+        const apiKey = config.apiKey || process.env.OPENAI_API_KEY;
+        if (!apiKey) {
+            throw new Error('OpenAI API key required for embeddings');
+        }
+        const response = await fetch('https://api.openai.com/v1/embeddings', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${apiKey}`,
+            },
+            body: JSON.stringify({
+                model: config.model || 'text-embedding-3-small',
+                input: text,
+            }),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`OpenAI API error: ${error}`);
+        }
+        const data = (await response.json());
+        return data.data[0].embedding;
+    }
+    /**
+     * Generate embeddings in batch using OpenAI API
+     */
+    async function generateOpenAIEmbeddingBatch(texts) {
+        const apiKey = config.apiKey || process.env.OPENAI_API_KEY;
+        if (!apiKey) {
+            throw new Error('OpenAI API key required for embeddings');
+        }
+        const response = await fetch('https://api.openai.com/v1/embeddings', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${apiKey}`,
+            },
+            body: JSON.stringify({
+                model: config.model || 'text-embedding-3-small',
+                input: texts,
+            }),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`OpenAI API error: ${error}`);
+        }
+        const data = (await response.json());
+        // Sort by index to maintain order
+        return data.data
+            .sort((a, b) => a.index - b.index)
+            .map((d) => d.embedding);
+    }
+    /**
+     * Generate embedding using transformers.js (neural network, runs locally)
+     * Uses all-MiniLM-L6-v2 model - 384 dimensions, good quality
+     */
+    async function generateTransformersEmbedding(text) {
+        const pipe = await getTransformersPipeline();
+        // Generate embedding
+        const output = await pipe(text, {
+            pooling: 'mean',
+            normalize: true,
+        });
+        // Convert Float32Array to regular array
+        return Array.from(output.data);
+    }
+    /**
+     * Generate embeddings in batch using transformers.js
+     */
+    async function generateTransformersEmbeddingBatch(texts) {
+        const pipe = await getTransformersPipeline();
+        // Process texts in batches for efficiency
+        const batchSize = 8;
+        const results = [];
+        for (let i = 0; i < texts.length; i += batchSize) {
+            const batch = texts.slice(i, i + batchSize);
+            const outputs = await pipe(batch, {
+                pooling: 'mean',
+                normalize: true,
+            });
+            // Handle batch output - dims[0] is batch size, dims[1] is embedding size
+            const embeddingSize = outputs.dims[1];
+            for (let j = 0; j < batch.length; j++) {
+                const start = j * embeddingSize;
+                const embedding = Array.from(outputs.data.slice(start, start + embeddingSize));
+                results.push(embedding);
+            }
+        }
+        return results;
+    }
+    /**
+     * Simple fallback embedding (bag-of-words) - used if transformers.js fails
+     */
+    function generateSimpleEmbedding(text) {
+        const words = text.toLowerCase().split(/\W+/).filter((w) => w.length > 2);
+        const wordCounts = new Map();
+        for (const word of words) {
+            wordCounts.set(word, (wordCounts.get(word) || 0) + 1);
+        }
+        const vectorSize = 384; // Match transformers.js dimension
+        const vector = new Array(vectorSize).fill(0);
+        wordCounts.forEach((count, word) => {
+            const hash = Math.abs(hashContent(word).charCodeAt(0)) % vectorSize;
+            vector[hash] += count;
+        });
+        // Normalize
+        const magnitude = Math.sqrt(vector.reduce((sum, v) => sum + v * v, 0));
+        if (magnitude > 0) {
+            for (let i = 0; i < vector.length; i++) {
+                vector[i] /= magnitude;
+            }
+        }
+        return vector;
+    }
+    /**
+     * Generate local embedding with transformers.js (fallback to simple if fails)
+     */
+    async function generateLocalEmbedding(text) {
+        try {
+            return await generateTransformersEmbedding(text);
+        }
+        catch (error) {
+            logger_1.logger.warn({ error }, 'Transformers.js failed, using simple fallback');
+            return generateSimpleEmbedding(text);
+        }
+    }
+    /**
+     * Generate local embeddings in batch
+     */
+    async function generateLocalEmbeddingBatch(texts) {
+        try {
+            return await generateTransformersEmbeddingBatch(texts);
+        }
+        catch (error) {
+            logger_1.logger.warn({ error }, 'Transformers.js batch failed, using simple fallback');
+            return texts.map(generateSimpleEmbedding);
+        }
+    }
+    const service = {
+        async embed(text) {
+            const contentHash = hashContent(text);
+            // Check memory cache
+            if (memoryCache.has(contentHash)) {
+                return memoryCache.get(contentHash);
+            }
+            // Check database cache
+            const cached = this.getCached(contentHash);
+            if (cached) {
+                memoryCache.set(contentHash, cached);
+                return cached;
+            }
+            // Generate new embedding
+            // Auto-select provider like Clawdbot: local → OpenAI (if key) → local fallback
+            let vector;
+            const hasOpenAIKey = !!(config.apiKey || process.env.OPENAI_API_KEY);
+            if (config.provider === 'openai' && hasOpenAIKey) {
+                vector = await generateOpenAIEmbedding(text);
+                logger_1.logger.debug('Generated OpenAI embedding');
+            }
+            else {
+                // Default: local embeddings using transformers.js (no API key needed)
+                vector = await generateLocalEmbedding(text);
+                logger_1.logger.debug('Generated local embedding using transformers.js');
+            }
+            // Cache the result
+            this.cache(contentHash, text, vector);
+            memoryCache.set(contentHash, vector);
+            return vector;
+        },
+        async embedBatch(texts) {
+            // Check which texts need embedding
+            const results = texts.map((text) => {
+                const contentHash = hashContent(text);
+                if (memoryCache.has(contentHash)) {
+                    return memoryCache.get(contentHash);
+                }
+                const cached = this.getCached(contentHash);
+                if (cached) {
+                    memoryCache.set(contentHash, cached);
+                    return cached;
+                }
+                return null;
+            });
+            // Find texts that need embedding
+            const needsEmbedding = [];
+            for (let i = 0; i < texts.length; i++) {
+                if (results[i] === null) {
+                    needsEmbedding.push({ index: i, text: texts[i] });
+                }
+            }
+            if (needsEmbedding.length > 0) {
+                let newEmbeddings;
+                const hasOpenAIKey = !!(config.apiKey || process.env.OPENAI_API_KEY);
+                if (config.provider === 'openai' && hasOpenAIKey) {
+                    newEmbeddings = await generateOpenAIEmbeddingBatch(needsEmbedding.map((item) => item.text));
+                }
+                else {
+                    // Default: local embeddings using transformers.js
+                    newEmbeddings = await generateLocalEmbeddingBatch(needsEmbedding.map((item) => item.text));
+                }
+                // Update results and cache
+                for (let i = 0; i < needsEmbedding.length; i++) {
+                    const { index, text } = needsEmbedding[i];
+                    const vector = newEmbeddings[i];
+                    results[index] = vector;
+                    const contentHash = hashContent(text);
+                    this.cache(contentHash, text, vector);
+                    memoryCache.set(contentHash, vector);
+                }
+            }
+            return results;
+        },
+        cosineSimilarity(a, b) {
+            if (a.length !== b.length) {
+                // Handle dimension mismatch (local vs API embeddings)
+                const minLen = Math.min(a.length, b.length);
+                a = a.slice(0, minLen);
+                b = b.slice(0, minLen);
+            }
+            let dotProduct = 0;
+            let magnitudeA = 0;
+            let magnitudeB = 0;
+            for (let i = 0; i < a.length; i++) {
+                dotProduct += a[i] * b[i];
+                magnitudeA += a[i] * a[i];
+                magnitudeB += b[i] * b[i];
+            }
+            magnitudeA = Math.sqrt(magnitudeA);
+            magnitudeB = Math.sqrt(magnitudeB);
+            if (magnitudeA === 0 || magnitudeB === 0)
+                return 0;
+            return dotProduct / (magnitudeA * magnitudeB);
+        },
+        async search(query, items, getContent, topK = 5) {
+            if (items.length === 0)
+                return [];
+            // Get query embedding
+            const queryEmbedding = await this.embed(query);
+            // Get embeddings for all items
+            const contents = items.map(getContent);
+            const embeddings = await this.embedBatch(contents);
+            // Calculate similarities
+            const results = items.map((item, i) => ({
+                item,
+                score: this.cosineSimilarity(queryEmbedding, embeddings[i]),
+            }));
+            // Sort by score descending and take top K
+            results.sort((a, b) => b.score - a.score);
+            return results.slice(0, topK);
+        },
+        getCached(contentHash) {
+            const rows = db.query('SELECT * FROM embeddings_cache WHERE contentHash = ?', [contentHash]);
+            if (rows.length === 0)
+                return null;
+            try {
+                return JSON.parse(rows[0].vector);
+            }
+            catch {
+                return null;
+            }
+        },
+        clearCache() {
+            memoryCache.clear();
+            db.run('DELETE FROM embeddings_cache');
+            logger_1.logger.info('Embedding cache cleared');
+        },
+        cache(contentHash, content, vector) {
+            const id = (0, id_1.generateId)('emb');
+            const vectorJson = JSON.stringify(vector);
+            db.run(`
+        INSERT OR REPLACE INTO embeddings_cache (id, contentHash, content, vector, createdAt)
+        VALUES (?, ?, ?, ?, ?)
+      `, [id, contentHash, content, vectorJson, new Date().toISOString()]);
+        },
+    };
+    return service;
+}
+//# sourceMappingURL=index.js.map

package/dist/embeddings/index.js.map

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

package/dist/evm/contracts.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Generic Smart Contract Interactions
+ *
+ * Read and write to any smart contract with ABI.
+ */
+import { InterfaceAbi, TransactionReceipt } from 'ethers';
+import { ChainName } from './multichain';
+export interface ContractCallRequest {
+    chain: ChainName;
+    contractAddress: string;
+    abi: InterfaceAbi;
+    method: string;
+    args?: unknown[];
+}
+export interface ContractWriteRequest extends ContractCallRequest {
+    privateKey: string;
+    value?: string;
+    gasLimit?: bigint;
+}
+export interface ContractCallResult {
+    success: boolean;
+    result?: unknown;
+    error?: string;
+}
+export interface ContractWriteResult {
+    success: boolean;
+    txHash?: string;
+    receipt?: TransactionReceipt;
+    result?: unknown;
+    gasUsed?: bigint;
+    error?: string;
+}
+export interface ContractInfo {
+    address: string;
+    chain: ChainName;
+    isContract: boolean;
+    bytecodeSize?: number;
+}
+export declare const COMMON_ABIS: {
+    erc20: string[];
+    erc721: string[];
+    erc1155: string[];
+    multicall: string[];
+    uniswapV2Pair: string[];
+    uniswapV2Router: string[];
+};
+/**
+ * Check if address is a contract
+ */
+export declare function isContract(chain: ChainName, address: string): Promise<boolean>;
+/**
+ * Get contract info
+ */
+export declare function getContractInfo(chain: ChainName, address: string): Promise<ContractInfo>;
+/**
+ * Call a read-only contract method
+ */
+export declare function callContract(request: ContractCallRequest): Promise<ContractCallResult>;
+/**
+ * Call multiple read-only methods in batch
+ */
+export declare function callContractBatch(requests: ContractCallRequest[]): Promise<ContractCallResult[]>;
+/**
+ * Execute a state-changing contract method
+ */
+export declare function writeContract(request: ContractWriteRequest): Promise<ContractWriteResult>;
+/**
+ * Encode function call data
+ */
+export declare function encodeFunctionData(abi: InterfaceAbi, method: string, args?: unknown[]): string;
+/**
+ * Decode function call data
+ */
+export declare function decodeFunctionData(abi: InterfaceAbi, method: string, data: string): unknown[];
+/**
+ * Decode function call input
+ */
+export declare function decodeFunctionInput(abi: InterfaceAbi, data: string): {
+    name: string;
+    args: unknown[];
+} | null;
+export interface EventLogQuery {
+    chain: ChainName;
+    contractAddress: string;
+    abi: InterfaceAbi;
+    eventName: string;
+    fromBlock?: number | 'latest';
+    toBlock?: number | 'latest';
+    filter?: Record<string, unknown>;
+}
+export interface ParsedEventLog {
+    blockNumber: number;
+    txHash: string;
+    logIndex: number;
+    args: Record<string, unknown>;
+}
+/**
+ * Query event logs from contract
+ */
+export declare function getEventLogs(query: EventLogQuery): Promise<ParsedEventLog[]>;
+/**
+ * Estimate gas for contract call
+ */
+export declare function estimateContractGas(request: ContractWriteRequest): Promise<bigint>;
+/**
+ * Simulate contract call without sending transaction
+ */
+export declare function simulateContractCall(request: ContractWriteRequest): Promise<ContractCallResult>;
+/**
+ * Get contract storage at slot
+ */
+export declare function getStorageAt(chain: ChainName, address: string, slot: string | number): Promise<string>;