clodds 1.1.0

package/dist/tools/web-fetch.js

@@ -0,0 +1,251 @@
+"use strict";
+/**
+ * Web Fetch Tool - Clawdbot-style URL content fetching
+ *
+ * Features:
+ * - Fetch URLs and convert to markdown
+ * - HTML to markdown conversion
+ * - Content truncation
+ * - Caching
+ * - Auto-rewrite to LLM-friendly .md URLs for supported doc sites
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLM_DOC_URLS = exports.LLM_DOC_SITES = void 0;
+exports.toLlmFriendlyUrl = toLlmFriendlyUrl;
+exports.createWebFetchTool = createWebFetchTool;
+const logger_1 = require("../utils/logger");
+exports.LLM_DOC_SITES = {
+    'solana.com': [
+        { pathPrefix: '/docs', transform: 'append-md', name: 'Solana Docs' },
+    ],
+    'docs.anthropic.com': [
+        { pathPrefix: '/', transform: 'append-md', name: 'Anthropic Docs' },
+    ],
+    'docs.stripe.com': [
+        { pathPrefix: '/', transform: 'append-md', name: 'Stripe Docs' },
+    ],
+    'docs.gitbook.com': [
+        { pathPrefix: '/', transform: 'append-md', name: 'GitBook Docs' },
+    ],
+};
+/**
+ * Curated LLM-friendly documentation links for blockchain/trading dev.
+ * Agents and devs can reference these for research.
+ */
+exports.LLM_DOC_URLS = {
+    'solana-core': { url: 'https://solana.com/docs/core', llmUrl: 'https://solana.com/docs/core.md', description: 'Solana core concepts (accounts, txs, programs)' },
+    'solana-rpc': { url: 'https://solana.com/docs/rpc', llmUrl: 'https://solana.com/docs/rpc.md', description: 'Solana JSON-RPC API reference' },
+    'solana-tokens': { url: 'https://solana.com/docs/core/tokens', llmUrl: 'https://solana.com/docs/core/tokens.md', description: 'SPL tokens, token extensions, metadata' },
+    'solana-programs': { url: 'https://solana.com/docs/programs', llmUrl: 'https://solana.com/docs/programs.md', description: 'On-chain program development' },
+    'solana-web3js': { url: 'https://solana.com/docs/clients/javascript', llmUrl: 'https://solana.com/docs/clients/javascript.md', description: '@solana/web3.js client SDK' },
+    'anthropic-api': { url: 'https://docs.anthropic.com/en/api', llmUrl: 'https://docs.anthropic.com/en/api.md', description: 'Anthropic Claude API reference' },
+    'stripe-api': { url: 'https://docs.stripe.com/api', llmUrl: 'https://docs.stripe.com/api.md', description: 'Stripe payments API' },
+};
+/**
+ * Rewrite a URL to its LLM-friendly .md variant if the site supports it.
+ * Returns the original URL unchanged if no rule matches.
+ */
+function toLlmFriendlyUrl(url) {
+    try {
+        const parsed = new URL(url);
+        const rules = exports.LLM_DOC_SITES[parsed.hostname];
+        if (!rules)
+            return url;
+        // Already ends with .md
+        if (parsed.pathname.endsWith('.md'))
+            return url;
+        for (const rule of rules) {
+            if (parsed.pathname.startsWith(rule.pathPrefix)) {
+                // Strip trailing slash before appending .md
+                const cleanPath = parsed.pathname.endsWith('/')
+                    ? parsed.pathname.slice(0, -1)
+                    : parsed.pathname;
+                parsed.pathname = cleanPath + '.md';
+                return parsed.toString();
+            }
+        }
+        return url;
+    }
+    catch {
+        return url;
+    }
+}
+const CACHE_TTL = 15 * 60 * 1000; // 15 minutes
+const cache = new Map();
+const DEFAULT_MAX_LENGTH = 50000;
+const DEFAULT_TIMEOUT = 30000;
+/**
+ * Simple HTML to text conversion
+ */
+function htmlToText(html) {
+    return html
+        // Remove scripts and styles
+        .replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, '')
+        .replace(/<style\b[^<]*(?:(?!<\/style>)<[^<]*)*<\/style>/gi, '')
+        // Convert common elements
+        .replace(/<br\s*\/?>/gi, '\n')
+        .replace(/<\/p>/gi, '\n\n')
+        .replace(/<\/div>/gi, '\n')
+        .replace(/<\/li>/gi, '\n')
+        .replace(/<\/h[1-6]>/gi, '\n\n')
+        // Remove remaining tags
+        .replace(/<[^>]+>/g, '')
+        // Decode entities
+        .replace(/&nbsp;/g, ' ')
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        // Clean up whitespace
+        .replace(/\n\s*\n\s*\n/g, '\n\n')
+        .trim();
+}
+/**
+ * Simple HTML to markdown conversion
+ */
+function htmlToMarkdown(html) {
+    return html
+        // Remove scripts and styles
+        .replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, '')
+        .replace(/<style\b[^<]*(?:(?!<\/style>)<[^<]*)*<\/style>/gi, '')
+        // Headers
+        .replace(/<h1[^>]*>(.*?)<\/h1>/gi, '\n# $1\n')
+        .replace(/<h2[^>]*>(.*?)<\/h2>/gi, '\n## $1\n')
+        .replace(/<h3[^>]*>(.*?)<\/h3>/gi, '\n### $1\n')
+        .replace(/<h4[^>]*>(.*?)<\/h4>/gi, '\n#### $1\n')
+        .replace(/<h5[^>]*>(.*?)<\/h5>/gi, '\n##### $1\n')
+        .replace(/<h6[^>]*>(.*?)<\/h6>/gi, '\n###### $1\n')
+        // Bold and italic
+        .replace(/<strong[^>]*>(.*?)<\/strong>/gi, '**$1**')
+        .replace(/<b[^>]*>(.*?)<\/b>/gi, '**$1**')
+        .replace(/<em[^>]*>(.*?)<\/em>/gi, '*$1*')
+        .replace(/<i[^>]*>(.*?)<\/i>/gi, '*$1*')
+        // Links
+        .replace(/<a[^>]*href="([^"]*)"[^>]*>(.*?)<\/a>/gi, '[$2]($1)')
+        // Code
+        .replace(/<code[^>]*>(.*?)<\/code>/gi, '`$1`')
+        .replace(/<pre[^>]*>(.*?)<\/pre>/gis, '\n```\n$1\n```\n')
+        // Lists
+        .replace(/<li[^>]*>(.*?)<\/li>/gi, '- $1\n')
+        // Paragraphs and breaks
+        .replace(/<br\s*\/?>/gi, '\n')
+        .replace(/<\/p>/gi, '\n\n')
+        .replace(/<p[^>]*>/gi, '')
+        // Remove remaining tags
+        .replace(/<[^>]+>/g, '')
+        // Decode entities
+        .replace(/&nbsp;/g, ' ')
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        // Clean up whitespace
+        .replace(/\n\s*\n\s*\n/g, '\n\n')
+        .trim();
+}
+/**
+ * Extract metadata from HTML
+ */
+function extractMetadata(html) {
+    const titleMatch = html.match(/<title[^>]*>(.*?)<\/title>/i);
+    const descMatch = html.match(/<meta[^>]*name=["']description["'][^>]*content=["']([^"']*)["']/i);
+    return {
+        title: titleMatch ? titleMatch[1].trim() : undefined,
+        description: descMatch ? descMatch[1].trim() : undefined,
+    };
+}
+function createWebFetchTool() {
+    return {
+        async fetch(url, options = {}) {
+            const maxLength = options.maxLength || DEFAULT_MAX_LENGTH;
+            const format = options.format || 'markdown';
+            const timeout = options.timeout || DEFAULT_TIMEOUT;
+            // Auto-rewrite to LLM-friendly .md URL if supported
+            const fetchUrl = toLlmFriendlyUrl(url);
+            if (fetchUrl !== url) {
+                logger_1.logger.debug({ original: url, rewritten: fetchUrl }, 'Rewritten to LLM-friendly URL');
+            }
+            const cacheKey = `${fetchUrl}:${format}:${maxLength}`;
+            // Check cache
+            const cached = cache.get(cacheKey);
+            if (cached && Date.now() - cached.timestamp < CACHE_TTL) {
+                logger_1.logger.debug({ url: fetchUrl }, 'Returning cached fetch result');
+                return { ...cached.result, cached: true };
+            }
+            logger_1.logger.info({ url: fetchUrl, format }, 'Fetching URL');
+            try {
+                const controller = new AbortController();
+                const timeoutId = setTimeout(() => controller.abort(), timeout);
+                const response = await fetch(fetchUrl, {
+                    signal: controller.signal,
+                    headers: {
+                        'User-Agent': 'Clodds/1.0 (Web Fetch Tool)',
+                        Accept: 'text/markdown,text/html,application/xhtml+xml,text/plain,*/*',
+                    },
+                });
+                clearTimeout(timeoutId);
+                if (!response.ok) {
+                    throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+                }
+                const contentType = response.headers.get('content-type') || 'text/plain';
+                let rawContent = await response.text();
+                // Extract metadata
+                let title;
+                let description;
+                if (options.includeMetadata && contentType.includes('html')) {
+                    const meta = extractMetadata(rawContent);
+                    title = meta.title;
+                    description = meta.description;
+                }
+                // Convert content
+                let content;
+                if (contentType.includes('html')) {
+                    if (format === 'markdown') {
+                        content = htmlToMarkdown(rawContent);
+                    }
+                    else if (format === 'text') {
+                        content = htmlToText(rawContent);
+                    }
+                    else {
+                        content = rawContent;
+                    }
+                }
+                else {
+                    content = rawContent;
+                }
+                // Truncate if needed
+                let truncated = false;
+                if (content.length > maxLength) {
+                    content = content.slice(0, maxLength) + '\n\n... (content truncated)';
+                    truncated = true;
+                }
+                const result = {
+                    url: fetchUrl,
+                    title,
+                    description,
+                    content,
+                    contentType,
+                    truncated,
+                    cached: false,
+                };
+                // Cache result
+                cache.set(cacheKey, {
+                    result,
+                    timestamp: Date.now(),
+                });
+                return result;
+            }
+            catch (error) {
+                logger_1.logger.error({ error, url: fetchUrl }, 'Web fetch failed');
+                throw error;
+            }
+        },
+        clearCache() {
+            cache.clear();
+            logger_1.logger.info('Web fetch cache cleared');
+        },
+    };
+}
+//# sourceMappingURL=web-fetch.js.map

package/dist/tools/web-fetch.js.map

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

package/dist/tools/web-search.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Web Search Tool - Clawdbot-style web search via Brave Search API
+ *
+ * Features:
+ * - Search the web using Brave Search API
+ * - Configurable result count
+ * - Response caching
+ * - Rate limiting
+ */
+/** Search result */
+export interface SearchResult {
+    title: string;
+    url: string;
+    description: string;
+    /** Publication date if available */
+    date?: string;
+}
+/** Search options */
+export interface SearchOptions {
+    /** Number of results (default: 5, max: 20) */
+    count?: number;
+    /** Page number (1-based) */
+    page?: number;
+    /** Explicit offset (overrides page) */
+    offset?: number;
+    /** Country code for localization */
+    country?: string;
+    /** Search freshness: day, week, month, year */
+    freshness?: 'day' | 'week' | 'month' | 'year';
+    /** Safe search: off, moderate, strict */
+    safesearch?: 'off' | 'moderate' | 'strict';
+}
+/** Search response */
+export interface SearchResponse {
+    query: string;
+    results: SearchResult[];
+    totalResults?: number;
+    /** Page number (1-based) */
+    page: number;
+    /** Offset used for this request */
+    offset: number;
+    /** Requested count per page */
+    count: number;
+    /** Whether another page is likely available */
+    hasMore: boolean;
+    cached: boolean;
+}
+export interface WebSearchTool {
+    /** Search the web */
+    search(query: string, options?: SearchOptions): Promise<SearchResponse>;
+    /** Clear the cache */
+    clearCache(): void;
+}
+export declare function createWebSearchTool(apiKey?: string): WebSearchTool;
+/**
+ * Format search results for display
+ */
+export declare function formatSearchResults(response: SearchResponse): string;

package/dist/tools/web-search.js

@@ -0,0 +1,204 @@
+"use strict";
+/**
+ * Web Search Tool - Clawdbot-style web search via Brave Search API
+ *
+ * Features:
+ * - Search the web using Brave Search API
+ * - Configurable result count
+ * - Response caching
+ * - Rate limiting
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWebSearchTool = createWebSearchTool;
+exports.formatSearchResults = formatSearchResults;
+const logger_1 = require("../utils/logger");
+const CACHE_TTL = 5 * 60 * 1000; // 5 minutes
+const cache = new Map();
+const ALLOWED_FRESHNESS = new Set(['day', 'week', 'month', 'year']);
+const ALLOWED_SAFESEARCH = new Set(['off', 'moderate', 'strict']);
+const ENGINE_NAME = 'brave';
+const DEFAULT_RATE_LIMIT_WINDOW_MS = 60_000;
+const DEFAULT_RATE_LIMIT_MAX = 30;
+const engineRateLimits = new Map();
+function checkEngineRateLimit(engine) {
+    const now = Date.now();
+    const windowMs = Math.max(1_000, parseInt(process.env.CLODDS_SEARCH_RATE_WINDOW_MS || '', 10) || DEFAULT_RATE_LIMIT_WINDOW_MS);
+    const maxRequests = Math.max(1, parseInt(process.env.CLODDS_SEARCH_RATE_MAX || '', 10) || DEFAULT_RATE_LIMIT_MAX);
+    let entry = engineRateLimits.get(engine);
+    if (!entry || entry.resetAt <= now) {
+        entry = { count: 0, resetAt: now + windowMs };
+        engineRateLimits.set(engine, entry);
+    }
+    if (entry.count >= maxRequests) {
+        return { allowed: false, resetInMs: Math.max(0, entry.resetAt - now) };
+    }
+    entry.count += 1;
+    return { allowed: true, resetInMs: Math.max(0, entry.resetAt - now) };
+}
+function normalizeCountry(country) {
+    if (!country)
+        return undefined;
+    const trimmed = country.trim();
+    if (!trimmed)
+        return undefined;
+    // Brave expects ISO country codes; normalize to uppercase 2-3 letter token.
+    const code = trimmed.toUpperCase();
+    if (!/^[A-Z]{2,3}$/.test(code)) {
+        throw new Error(`Invalid country code: ${country}`);
+    }
+    return code;
+}
+function normalizeFreshness(freshness) {
+    if (!freshness)
+        return undefined;
+    if (!ALLOWED_FRESHNESS.has(freshness)) {
+        throw new Error(`Invalid freshness: ${freshness}`);
+    }
+    return freshness;
+}
+function normalizeSafeSearch(safesearch) {
+    if (!safesearch)
+        return undefined;
+    if (!ALLOWED_SAFESEARCH.has(safesearch)) {
+        throw new Error(`Invalid safesearch: ${safesearch}`);
+    }
+    return safesearch;
+}
+function createWebSearchTool(apiKey) {
+    const braveApiKey = apiKey || process.env.BRAVE_SEARCH_API_KEY;
+    if (!braveApiKey) {
+        logger_1.logger.warn('Brave Search API key not configured, web search will be unavailable');
+    }
+    function getCacheKey(query, options) {
+        return JSON.stringify({ query, ...options });
+    }
+    return {
+        async search(query, options = {}) {
+            const count = Math.min(options.count || 5, 20);
+            const page = Math.max(1, Math.floor(options.page || 1));
+            const offset = options.offset !== undefined
+                ? Math.max(0, Math.floor(options.offset))
+                : (page - 1) * count;
+            const country = normalizeCountry(options.country);
+            const freshness = normalizeFreshness(options.freshness);
+            const safesearch = normalizeSafeSearch(options.safesearch);
+            const cacheKey = getCacheKey(query, {
+                ...options,
+                count,
+                page,
+                offset,
+                country,
+                freshness,
+                safesearch,
+            });
+            // Check cache
+            const cached = cache.get(cacheKey);
+            if (cached && Date.now() - cached.timestamp < CACHE_TTL) {
+                logger_1.logger.debug({ query }, 'Returning cached search results');
+                return { ...cached.response, cached: true };
+            }
+            if (!braveApiKey) {
+                throw new Error('Brave Search API key not configured');
+            }
+            const rateLimit = checkEngineRateLimit(ENGINE_NAME);
+            if (!rateLimit.allowed) {
+                const resetSeconds = Math.ceil(rateLimit.resetInMs / 1000);
+                throw new Error(`Search rate limit exceeded for ${ENGINE_NAME}. Try again in ${resetSeconds}s.`);
+            }
+            logger_1.logger.info({ query, count, page, offset, country, freshness, safesearch }, 'Performing web search');
+            try {
+                // Build URL
+                const params = new URLSearchParams({
+                    q: query,
+                    count: count.toString(),
+                    offset: offset.toString(),
+                });
+                if (country) {
+                    params.set('country', country);
+                }
+                if (freshness) {
+                    params.set('freshness', freshness);
+                }
+                if (safesearch) {
+                    params.set('safesearch', safesearch);
+                }
+                const response = await fetch(`https://api.search.brave.com/res/v1/web/search?${params}`, {
+                    headers: {
+                        Accept: 'application/json',
+                        'X-Subscription-Token': braveApiKey,
+                    },
+                });
+                if (!response.ok) {
+                    const error = await response.text();
+                    throw new Error(`Brave Search API error: ${response.status} ${error}`);
+                }
+                const data = await response.json();
+                // Parse results
+                const results = (data.web?.results || []).map((r) => ({
+                    title: r.title,
+                    url: r.url,
+                    description: r.description,
+                    date: r.age,
+                }));
+                const totalResults = data.web?.total;
+                const hasMore = typeof totalResults === 'number'
+                    ? offset + results.length < totalResults
+                    : results.length === count;
+                const searchResponse = {
+                    query,
+                    results,
+                    totalResults,
+                    page,
+                    offset,
+                    count,
+                    hasMore,
+                    cached: false,
+                };
+                // Cache results
+                cache.set(cacheKey, {
+                    response: searchResponse,
+                    timestamp: Date.now(),
+                });
+                return searchResponse;
+            }
+            catch (error) {
+                logger_1.logger.error({ error, query }, 'Web search failed');
+                throw error;
+            }
+        },
+        clearCache() {
+            cache.clear();
+            logger_1.logger.info('Web search cache cleared');
+        },
+    };
+}
+/**
+ * Format search results for display
+ */
+function formatSearchResults(response) {
+    if (response.results.length === 0) {
+        return `No results found for "${response.query}"`;
+    }
+    const headerParts = [`**Search results for "${response.query}":**`];
+    headerParts.push(`Page ${response.page}`);
+    if (typeof response.totalResults === 'number') {
+        headerParts.push(`${response.totalResults.toLocaleString()} total`);
+    }
+    const lines = [`${headerParts.join(' ')}\n`];
+    for (let i = 0; i < response.results.length; i++) {
+        const r = response.results[i];
+        const index = response.offset + i + 1;
+        lines.push(`${index}. **${r.title}**`);
+        lines.push(`   ${r.url}`);
+        lines.push(`   ${r.description}`);
+        if (r.date) {
+            lines.push(`   _${r.date}_`);
+        }
+        lines.push('');
+    }
+    if (response.hasMore) {
+        lines.push(`More results available. Try page ${response.page + 1}.`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=web-search.js.map

package/dist/tools/web-search.js.map

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

package/dist/tools/webhooks.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Webhook Management Tool
+ */
+import type { IncomingMessage, OutgoingMessage, Session } from '../types';
+import type { WebhookManager } from '../automation/webhooks';
+import type { SessionManager } from '../sessions';
+import type { CommandRegistry } from '../commands/registry';
+import type { FeedManager } from '../feeds';
+import type { Database } from '../db';
+import type { MemoryService } from '../memory';
+export interface WebhookTarget {
+    platform: string;
+    chatId: string;
+    userId: string;
+    username?: string;
+}
+export interface RegisterWebhookOptions {
+    id?: string;
+    path: string;
+    description?: string;
+    rateLimit?: number;
+    enabled?: boolean;
+    secret?: string;
+    target: WebhookTarget;
+    template?: string;
+}
+export interface WebhookInfo {
+    id: string;
+    path: string;
+    url: string;
+    description?: string;
+    rateLimit?: number;
+    enabled: boolean;
+    triggerCount: number;
+    lastTriggered?: string;
+    target: WebhookTarget;
+    secret?: string;
+}
+export interface WebhookTool {
+    register(options: RegisterWebhookOptions): Promise<WebhookInfo>;
+    list(includeSecrets?: boolean): Promise<WebhookInfo[]>;
+    remove(id: string): Promise<{
+        ok: boolean;
+    }>;
+    setEnabled(id: string, enabled: boolean): Promise<{
+        ok: boolean;
+        enabled: boolean;
+    }>;
+    rotateSecret(id: string): Promise<{
+        ok: boolean;
+        secret?: string;
+    }>;
+    sign(id: string, payload: unknown): Promise<{
+        signature: string;
+    }>;
+    trigger(id: string, payload: unknown, signature?: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+}
+interface WebhookToolDeps {
+    manager: WebhookManager;
+    gatewayPort: number;
+    sessions: SessionManager;
+    commands: CommandRegistry;
+    feeds: FeedManager;
+    db: Database;
+    memory?: MemoryService;
+    sendMessage: (msg: OutgoingMessage) => Promise<string | null>;
+    handleAgentMessage: (message: IncomingMessage, session: Session) => Promise<string | null>;
+}
+export declare function signPayload(secret: string, payload: unknown): string;
+export declare function createWebhookTool(deps: WebhookToolDeps): WebhookTool;
+export {};