clodds 1.1.0

package/dist/routing/index.js

@@ -0,0 +1,371 @@
+"use strict";
+/**
+ * Routing Service - Clawdbot-style multi-agent routing with bindings
+ *
+ * Features:
+ * - Multiple specialized agents (main, trading, research, etc.)
+ * - Pattern-based routing (regex, keywords, commands)
+ * - Channel-specific agent bindings
+ * - Fallback to default agent
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_GROUPS = void 0;
+exports.createRoutingService = createRoutingService;
+const logger_1 = require("../utils/logger");
+/** Tool groups for easy policy configuration */
+exports.TOOL_GROUPS = {
+    fs: ['read', 'write', 'edit', 'glob', 'find'],
+    web: ['web-search', 'web-fetch', 'browser'],
+    runtime: ['exec', 'bash', 'shell'],
+    comms: ['message', 'email', 'sms'],
+    media: ['image', 'transcription', 'canvas'],
+    data: ['sql', 'git', 'docker'],
+    sessions: ['sessions', 'checkpoint', 'restore'],
+};
+/** Default agents */
+const DEFAULT_AGENTS = [
+    {
+        id: 'main',
+        name: 'Main Agent',
+        description: 'General purpose prediction market assistant',
+        enabled: true,
+    },
+    {
+        id: 'trading',
+        name: 'Trading Agent',
+        description: 'Specialized in trade execution and portfolio management',
+        systemPrompt: `You are a trading specialist for prediction markets.
+Focus on:
+- Trade execution (buy/sell)
+- Portfolio analysis
+- Position management
+- Risk assessment
+Be concise and action-oriented.`,
+        enabled: true,
+    },
+    {
+        id: 'research',
+        name: 'Research Agent',
+        description: 'Specialized in market research and analysis',
+        systemPrompt: `You are a research specialist for prediction markets.
+Focus on:
+- Market analysis and trends
+- Event research
+- Probability estimation
+- Information synthesis
+Be thorough and data-driven.`,
+        enabled: true,
+    },
+    {
+        id: 'alerts',
+        name: 'Alerts Agent',
+        description: 'Specialized in price alerts and notifications',
+        systemPrompt: `You are an alerts specialist for prediction markets.
+Focus on:
+- Setting up price alerts
+- Monitoring conditions
+- Notification management
+Be precise about thresholds and conditions.`,
+        enabled: true,
+    },
+];
+/** Default bindings */
+const DEFAULT_BINDINGS = [
+    // Command bindings
+    {
+        id: 'cmd-buy',
+        type: 'command',
+        pattern: '/buy',
+        agentId: 'trading',
+        priority: 100,
+        enabled: true,
+    },
+    {
+        id: 'cmd-sell',
+        type: 'command',
+        pattern: '/sell',
+        agentId: 'trading',
+        priority: 100,
+        enabled: true,
+    },
+    {
+        id: 'cmd-portfolio',
+        type: 'command',
+        pattern: '/portfolio',
+        agentId: 'trading',
+        priority: 100,
+        enabled: true,
+    },
+    {
+        id: 'cmd-alert',
+        type: 'command',
+        pattern: '/alert',
+        agentId: 'alerts',
+        priority: 100,
+        enabled: true,
+    },
+    {
+        id: 'cmd-research',
+        type: 'command',
+        pattern: '/research',
+        agentId: 'research',
+        priority: 100,
+        enabled: true,
+    },
+    // Keyword bindings
+    {
+        id: 'kw-buy',
+        type: 'keyword',
+        pattern: 'buy|purchase|long',
+        agentId: 'trading',
+        priority: 50,
+        enabled: true,
+    },
+    {
+        id: 'kw-sell',
+        type: 'keyword',
+        pattern: 'sell|exit|close',
+        agentId: 'trading',
+        priority: 50,
+        enabled: true,
+    },
+    {
+        id: 'kw-analyze',
+        type: 'keyword',
+        pattern: 'analyze|research|what do you think',
+        agentId: 'research',
+        priority: 40,
+        enabled: true,
+    },
+    // Default fallback
+    {
+        id: 'default',
+        type: 'default',
+        pattern: '*',
+        agentId: 'main',
+        priority: 0,
+        enabled: true,
+    },
+];
+function createRoutingService(config) {
+    // Initialize with defaults + config overrides
+    const agents = new Map();
+    const bindings = new Map();
+    // Load default agents
+    for (const agent of DEFAULT_AGENTS) {
+        agents.set(agent.id, agent);
+    }
+    // Override with config agents
+    if (config?.agents) {
+        for (const agent of config.agents) {
+            agents.set(agent.id, agent);
+        }
+    }
+    // Load default bindings
+    for (const binding of DEFAULT_BINDINGS) {
+        bindings.set(binding.id, binding);
+    }
+    // Override with config bindings
+    if (config?.bindings) {
+        for (const binding of config.bindings) {
+            bindings.set(binding.id, binding);
+        }
+    }
+    const defaultAgentId = config?.defaultAgentId || 'main';
+    /**
+     * Check if a binding matches a message
+     */
+    function matchesBinding(binding, message) {
+        if (!binding.enabled)
+            return false;
+        // Check channel filter
+        if (binding.channel && binding.channel !== message.platform) {
+            return false;
+        }
+        const text = message.text.trim();
+        switch (binding.type) {
+            case 'command':
+                // Command must start with the pattern
+                return text.toLowerCase().startsWith(binding.pattern.toLowerCase());
+            case 'keyword':
+                // Any keyword in the pattern must be present
+                const keywords = binding.pattern.split('|').map((k) => k.trim().toLowerCase());
+                const textLower = text.toLowerCase();
+                return keywords.some((keyword) => textLower.includes(keyword));
+            case 'regex':
+                // Match regex pattern
+                try {
+                    const regex = new RegExp(binding.pattern, 'i');
+                    return regex.test(text);
+                }
+                catch {
+                    logger_1.logger.warn({ pattern: binding.pattern }, 'Invalid regex pattern');
+                    return false;
+                }
+            case 'channel':
+                // Match specific channel
+                return message.platform === binding.pattern;
+            case 'default':
+                // Always matches
+                return true;
+            default:
+                return false;
+        }
+    }
+    const service = {
+        route(message, session) {
+            // Get enabled bindings sorted by priority (highest first)
+            const sortedBindings = Array.from(bindings.values())
+                .filter((b) => b.enabled)
+                .sort((a, b) => b.priority - a.priority);
+            // Find first matching binding
+            for (const binding of sortedBindings) {
+                if (matchesBinding(binding, message)) {
+                    const agent = agents.get(binding.agentId);
+                    if (agent && agent.enabled) {
+                        logger_1.logger.debug({ messageId: message.id, agentId: agent.id, bindingId: binding.id }, 'Message routed');
+                        return {
+                            agentId: agent.id,
+                            agent,
+                            binding,
+                            reason: `Matched ${binding.type} binding: ${binding.pattern}`,
+                        };
+                    }
+                }
+            }
+            // Fallback to default agent
+            const defaultAgent = agents.get(defaultAgentId) || DEFAULT_AGENTS[0];
+            return {
+                agentId: defaultAgent.id,
+                agent: defaultAgent,
+                reason: 'Default agent (no binding matched)',
+            };
+        },
+        getAgents() {
+            return Array.from(agents.values());
+        },
+        getAgent(agentId) {
+            return agents.get(agentId) || null;
+        },
+        getBindings() {
+            return Array.from(bindings.values());
+        },
+        addAgent(agent) {
+            agents.set(agent.id, agent);
+            logger_1.logger.info({ agentId: agent.id }, 'Agent added');
+        },
+        updateAgent(agentId, updates) {
+            const existing = agents.get(agentId);
+            if (!existing)
+                return false;
+            agents.set(agentId, { ...existing, ...updates });
+            logger_1.logger.info({ agentId }, 'Agent updated');
+            return true;
+        },
+        removeAgent(agentId) {
+            if (agentId === defaultAgentId) {
+                logger_1.logger.warn({ agentId }, 'Cannot remove default agent');
+                return false;
+            }
+            const existed = agents.delete(agentId);
+            if (existed) {
+                logger_1.logger.info({ agentId }, 'Agent removed');
+            }
+            return existed;
+        },
+        addBinding(binding) {
+            bindings.set(binding.id, binding);
+            logger_1.logger.info({ bindingId: binding.id }, 'Binding added');
+        },
+        updateBinding(bindingId, updates) {
+            const existing = bindings.get(bindingId);
+            if (!existing)
+                return false;
+            bindings.set(bindingId, { ...existing, ...updates });
+            logger_1.logger.info({ bindingId }, 'Binding updated');
+            return true;
+        },
+        removeBinding(bindingId) {
+            const existed = bindings.delete(bindingId);
+            if (existed) {
+                logger_1.logger.info({ bindingId }, 'Binding removed');
+            }
+            return existed;
+        },
+        getDefaultAgent() {
+            return agents.get(defaultAgentId) || DEFAULT_AGENTS[0];
+        },
+        isToolAllowed(agentId, toolName) {
+            const agent = agents.get(agentId);
+            if (!agent)
+                return true; // Default to allow if agent not found
+            const policy = agent.toolPolicy;
+            if (!policy)
+                return true; // No policy = all tools allowed
+            // Check explicit deny first
+            if (policy.deny?.includes(toolName))
+                return false;
+            // Check deny groups
+            if (policy.denyGroups) {
+                for (const groupName of policy.denyGroups) {
+                    const group = exports.TOOL_GROUPS[groupName];
+                    if (group?.includes(toolName))
+                        return false;
+                }
+            }
+            // Check explicit allow
+            if (policy.allow?.includes(toolName))
+                return true;
+            // Check allow groups
+            if (policy.allowGroups) {
+                for (const groupName of policy.allowGroups) {
+                    const group = exports.TOOL_GROUPS[groupName];
+                    if (group?.includes(toolName))
+                        return true;
+                }
+                // If allowGroups is specified, only those are allowed
+                return false;
+            }
+            // Default to allow
+            return true;
+        },
+        getWorkspacePath(agentId) {
+            const agent = agents.get(agentId);
+            return agent?.workspace?.rootDir || null;
+        },
+        getAllowedTools(agentId) {
+            const agent = agents.get(agentId);
+            if (!agent?.toolPolicy)
+                return null; // All tools allowed
+            const policy = agent.toolPolicy;
+            const allowed = [];
+            // Start with explicit allows
+            if (policy.allow) {
+                allowed.push(...policy.allow);
+            }
+            // Add tools from allowed groups
+            if (policy.allowGroups) {
+                for (const groupName of policy.allowGroups) {
+                    const group = exports.TOOL_GROUPS[groupName];
+                    if (group)
+                        allowed.push(...group);
+                }
+            }
+            // Remove denied tools
+            const denied = new Set();
+            if (policy.deny) {
+                policy.deny.forEach(t => denied.add(t));
+            }
+            if (policy.denyGroups) {
+                for (const groupName of policy.denyGroups) {
+                    const group = exports.TOOL_GROUPS[groupName];
+                    if (group)
+                        group.forEach(t => denied.add(t));
+                }
+            }
+            return allowed.filter(t => !denied.has(t));
+        },
+    };
+    return service;
+}
+//# sourceMappingURL=index.js.map

package/dist/routing/index.js.map

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

package/dist/search/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Hybrid Search - Clawdbot-style Vector + BM25 retrieval
+ *
+ * Features:
+ * - BM25 keyword search (catches exact matches vectors miss)
+ * - Vector semantic search (catches meaning vectors excel at)
+ * - Reciprocal Rank Fusion to combine results
+ * - Configurable weights for each method
+ */
+import type { EmbeddingsService, SearchResult } from '../embeddings/index';
+/** Search configuration */
+export interface HybridSearchConfig {
+    /** Weight for vector search results (0-1) */
+    vectorWeight?: number;
+    /** Weight for BM25 keyword results (0-1) */
+    bm25Weight?: number;
+    /** Minimum score threshold */
+    minScore?: number;
+}
+/** BM25 search implementation */
+export declare function bm25Search<T>(query: string, items: T[], getContent: (item: T) => string, topK?: number): SearchResult<T>[];
+export interface HybridSearchService {
+    /** Hybrid search combining vector and BM25 */
+    search<T>(query: string, items: T[], getContent: (item: T) => string, topK?: number): Promise<SearchResult<T>[]>;
+    /** BM25-only search (fast, keyword-based) */
+    keywordSearch<T>(query: string, items: T[], getContent: (item: T) => string, topK?: number): SearchResult<T>[];
+    /** Vector-only search (semantic) */
+    vectorSearch<T>(query: string, items: T[], getContent: (item: T) => string, topK?: number): Promise<SearchResult<T>[]>;
+}
+export declare function createHybridSearchService(embeddings: EmbeddingsService, configInput?: Partial<HybridSearchConfig>): HybridSearchService;

package/dist/search/index.js

@@ -0,0 +1,129 @@
+"use strict";
+/**
+ * Hybrid Search - Clawdbot-style Vector + BM25 retrieval
+ *
+ * Features:
+ * - BM25 keyword search (catches exact matches vectors miss)
+ * - Vector semantic search (catches meaning vectors excel at)
+ * - Reciprocal Rank Fusion to combine results
+ * - Configurable weights for each method
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bm25Search = bm25Search;
+exports.createHybridSearchService = createHybridSearchService;
+/** BM25 parameters */
+const BM25_K1 = 1.5; // Term frequency saturation
+const BM25_B = 0.75; // Length normalization
+const DEFAULT_CONFIG = {
+    vectorWeight: 0.5,
+    bm25Weight: 0.5,
+    minScore: 0.1,
+};
+/** Tokenize text for BM25 */
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^\w\s]/g, ' ')
+        .split(/\s+/)
+        .filter((w) => w.length > 2);
+}
+/** Calculate IDF for a term */
+function calculateIDF(term, documents) {
+    const docsWithTerm = documents.filter((doc) => doc.includes(term)).length;
+    if (docsWithTerm === 0)
+        return 0;
+    return Math.log((documents.length - docsWithTerm + 0.5) / (docsWithTerm + 0.5) + 1);
+}
+/** Calculate BM25 score for a document */
+function bm25Score(queryTerms, docTerms, avgDocLen, idfScores) {
+    let score = 0;
+    const docLen = docTerms.length;
+    for (const term of queryTerms) {
+        const tf = docTerms.filter((t) => t === term).length;
+        if (tf === 0)
+            continue;
+        const idf = idfScores.get(term) || 0;
+        const tfNormalized = (tf * (BM25_K1 + 1)) /
+            (tf + BM25_K1 * (1 - BM25_B + BM25_B * (docLen / avgDocLen)));
+        score += idf * tfNormalized;
+    }
+    return score;
+}
+/** BM25 search implementation */
+function bm25Search(query, items, getContent, topK = 5) {
+    if (items.length === 0)
+        return [];
+    const queryTerms = tokenize(query);
+    if (queryTerms.length === 0)
+        return [];
+    // Tokenize all documents
+    const tokenizedDocs = items.map((item) => tokenize(getContent(item)));
+    const avgDocLen = tokenizedDocs.reduce((sum, doc) => sum + doc.length, 0) / tokenizedDocs.length;
+    // Calculate IDF for query terms
+    const idfScores = new Map();
+    for (const term of queryTerms) {
+        idfScores.set(term, calculateIDF(term, tokenizedDocs));
+    }
+    // Score all documents
+    const results = items.map((item, i) => ({
+        item,
+        score: bm25Score(queryTerms, tokenizedDocs[i], avgDocLen, idfScores),
+    }));
+    // Normalize scores to 0-1 range
+    const maxScore = Math.max(...results.map((r) => r.score));
+    if (maxScore > 0) {
+        for (const result of results) {
+            result.score /= maxScore;
+        }
+    }
+    // Sort and return top K
+    results.sort((a, b) => b.score - a.score);
+    return results.slice(0, topK);
+}
+/**
+ * Reciprocal Rank Fusion - combines multiple ranked lists
+ * RRF(d) = Σ 1/(k + rank(d)) where k=60 is standard
+ */
+function reciprocalRankFusion(rankedLists, weights, k = 60) {
+    const scoreMap = new Map();
+    for (let listIdx = 0; listIdx < rankedLists.length; listIdx++) {
+        const list = rankedLists[listIdx];
+        const weight = weights[listIdx] || 1;
+        for (let rank = 0; rank < list.length; rank++) {
+            const item = list[rank].item;
+            const rrfScore = weight / (k + rank + 1);
+            scoreMap.set(item, (scoreMap.get(item) || 0) + rrfScore);
+        }
+    }
+    // Convert to array and sort
+    const results = Array.from(scoreMap.entries()).map(([item, score]) => ({ item, score }));
+    results.sort((a, b) => b.score - a.score);
+    return results;
+}
+function createHybridSearchService(embeddings, configInput) {
+    const config = { ...DEFAULT_CONFIG, ...configInput };
+    return {
+        async search(query, items, getContent, topK = 5) {
+            if (items.length === 0)
+                return [];
+            // Run both searches in parallel
+            const [vectorResults, bm25Results] = await Promise.all([
+                embeddings.search(query, items, getContent, topK * 2),
+                Promise.resolve(bm25Search(query, items, getContent, topK * 2)),
+            ]);
+            // Combine with RRF
+            const combined = reciprocalRankFusion([vectorResults, bm25Results], [config.vectorWeight, config.bm25Weight]);
+            // Filter by minimum score and return top K
+            return combined
+                .filter((r) => r.score >= config.minScore)
+                .slice(0, topK);
+        },
+        keywordSearch(query, items, getContent, topK = 5) {
+            return bm25Search(query, items, getContent, topK);
+        },
+        async vectorSearch(query, items, getContent, topK = 5) {
+            return embeddings.search(query, items, getContent, topK);
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/search/index.js.map

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

package/dist/security/address-checker.d.ts

@@ -0,0 +1,6 @@
+import type { AddressCheckResult, ChainType } from './types.js';
+export declare function detectChain(address: string): ChainType;
+export declare function checkAddress(address: string, chain?: ChainType | string, config?: {
+    solanaRpcUrl?: string;
+    evmRpcUrl?: string;
+}): Promise<AddressCheckResult>;