clodds 1.1.0

package/dist/tools/image.js

@@ -0,0 +1,308 @@
+"use strict";
+/**
+ * Image Tool - Clawdbot-style image analysis with vision models
+ *
+ * Features:
+ * - Analyze images using Claude's vision
+ * - Support for URLs and base64
+ * - Custom prompts
+ * - Multiple image analysis
+ */
+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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createImageTool = createImageTool;
+const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const crypto_1 = require("crypto");
+const logger_1 = require("../utils/logger");
+const DEFAULT_PROMPT = 'Describe this image in detail. Include any text visible in the image.';
+const DEFAULT_MODEL = 'claude-sonnet-4-20250514';
+const DEFAULT_MAX_TOKENS = 1024;
+const DEFAULT_CACHE_TTL_MS = 5 * 60 * 1000;
+const DEFAULT_RATE_LIMIT_WINDOW_MS = 60_000;
+const DEFAULT_RATE_LIMIT_MAX = 20;
+const SUPPORTED_MEDIA_TYPES = new Set([
+    'image/jpeg',
+    'image/png',
+    'image/gif',
+    'image/webp',
+]);
+const rateLimitState = { count: 0, resetAt: 0 };
+const responseCache = new Map();
+function isSupportedMediaType(mediaType) {
+    return SUPPORTED_MEDIA_TYPES.has(mediaType);
+}
+function normalizeMediaType(mediaType) {
+    const normalized = mediaType.toLowerCase().trim();
+    if (!isSupportedMediaType(normalized)) {
+        throw new Error(`Unsupported image media type: ${mediaType}`);
+    }
+    return normalized;
+}
+function detectMediaTypeFromFile(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    const mediaTypeMap = {
+        '.jpg': 'image/jpeg',
+        '.jpeg': 'image/jpeg',
+        '.png': 'image/png',
+        '.gif': 'image/gif',
+        '.webp': 'image/webp',
+    };
+    const mediaType = mediaTypeMap[ext];
+    if (!mediaType) {
+        throw new Error(`Unsupported image file extension: ${ext || '(none)'}`);
+    }
+    return mediaType;
+}
+function enforceVisionRateLimit() {
+    const now = Date.now();
+    const windowMs = parseInt(process.env.CLODDS_VISION_RATE_WINDOW_MS || '', 10) || DEFAULT_RATE_LIMIT_WINDOW_MS;
+    const maxRequests = parseInt(process.env.CLODDS_VISION_RATE_MAX || '', 10) || DEFAULT_RATE_LIMIT_MAX;
+    if (rateLimitState.resetAt <= now) {
+        rateLimitState.count = 0;
+        rateLimitState.resetAt = now + Math.max(1_000, windowMs);
+    }
+    if (rateLimitState.count >= Math.max(1, maxRequests)) {
+        const resetIn = Math.ceil((rateLimitState.resetAt - now) / 1000);
+        throw new Error(`Vision rate limit exceeded. Try again in ${resetIn}s.`);
+    }
+    rateLimitState.count += 1;
+}
+function buildCacheKey(source, options, prompt, model) {
+    // Avoid huge keys by hashing significant inputs.
+    const hash = (0, crypto_1.createHash)('sha256');
+    hash.update(JSON.stringify({ prompt, model, maxTokens: options.maxTokens, ocr: options.ocr }));
+    switch (source.type) {
+        case 'url':
+            hash.update(`url:${source.url}`);
+            break;
+        case 'base64':
+            hash.update(`base64:${source.mediaType}:${source.data.slice(0, 256)}`);
+            break;
+        case 'file':
+            hash.update(`file:${source.path}`);
+            try {
+                const stat = fs.statSync(source.path);
+                hash.update(`:${stat.size}:${stat.mtimeMs}`);
+            }
+            catch {
+                // Ignore stat errors; file read will fail later if needed.
+            }
+            break;
+    }
+    return hash.digest('hex');
+}
+function getCached(cacheKey) {
+    const entry = responseCache.get(cacheKey);
+    if (!entry)
+        return null;
+    const ttl = parseInt(process.env.CLODDS_VISION_CACHE_TTL_MS || '', 10) || DEFAULT_CACHE_TTL_MS;
+    if (Date.now() - entry.timestamp > Math.max(1_000, ttl)) {
+        responseCache.delete(cacheKey);
+        return null;
+    }
+    return entry.value;
+}
+function setCached(cacheKey, value) {
+    responseCache.set(cacheKey, { value, timestamp: Date.now() });
+}
+function buildPrompt(basePrompt, options) {
+    const ocr = options.ocr;
+    if (!ocr?.enabled) {
+        return basePrompt;
+    }
+    const hints = [
+        'Perform OCR and extract all visible text verbatim before summarizing.',
+    ];
+    if (ocr.language) {
+        hints.push(`Primary OCR language hint: ${ocr.language}.`);
+    }
+    if (ocr.documentMode) {
+        hints.push('Treat the image as a document or screenshot; preserve layout cues when relevant.');
+    }
+    return `${hints.join(' ')}\n\n${basePrompt}`;
+}
+/**
+ * Convert image source to Anthropic API format
+ */
+async function sourceToContent(source) {
+    if (source.type === 'url') {
+        // Fetch the URL and convert to base64
+        const response = await fetch(source.url);
+        const buffer = await response.arrayBuffer();
+        const base64 = Buffer.from(buffer).toString('base64');
+        const contentType = response.headers.get('content-type') || 'image/jpeg';
+        const mediaType = normalizeMediaType(contentType.split(';')[0] || contentType);
+        return {
+            type: 'image',
+            source: {
+                type: 'base64',
+                media_type: mediaType,
+                data: base64,
+            },
+        };
+    }
+    if (source.type === 'base64') {
+        const mediaType = normalizeMediaType(source.mediaType);
+        return {
+            type: 'image',
+            source: {
+                type: 'base64',
+                media_type: mediaType,
+                data: source.data,
+            },
+        };
+    }
+    if (source.type === 'file') {
+        const filePath = source.path;
+        const mediaType = detectMediaTypeFromFile(filePath);
+        const data = fs.readFileSync(filePath).toString('base64');
+        return {
+            type: 'image',
+            source: {
+                type: 'base64',
+                media_type: mediaType,
+                data,
+            },
+        };
+    }
+    throw new Error('Invalid image source type');
+}
+function createImageTool(apiKey) {
+    const anthropic = new sdk_1.default({
+        apiKey: apiKey || process.env.ANTHROPIC_API_KEY,
+    });
+    return {
+        async analyze(source, options = {}) {
+            const basePrompt = options.prompt || DEFAULT_PROMPT;
+            const prompt = buildPrompt(basePrompt, options);
+            const model = options.model || DEFAULT_MODEL;
+            const maxTokens = options.maxTokens || DEFAULT_MAX_TOKENS;
+            const cacheKey = buildCacheKey(source, options, prompt, model);
+            logger_1.logger.info({ sourceType: source.type, model }, 'Analyzing image');
+            try {
+                const cached = getCached(cacheKey);
+                if (cached) {
+                    return { ...cached };
+                }
+                enforceVisionRateLimit();
+                const imageContent = await sourceToContent(source);
+                const response = await anthropic.messages.create({
+                    model,
+                    max_tokens: maxTokens,
+                    messages: [
+                        {
+                            role: 'user',
+                            content: [
+                                imageContent,
+                                { type: 'text', text: prompt },
+                            ],
+                        },
+                    ],
+                });
+                const textContent = response.content.find((c) => c.type === 'text');
+                const raw = textContent?.type === 'text' ? textContent.text : '';
+                const result = {
+                    description: raw,
+                    raw,
+                };
+                setCached(cacheKey, result);
+                return result;
+            }
+            catch (error) {
+                logger_1.logger.error({ error }, 'Image analysis failed');
+                throw error;
+            }
+        },
+        async analyzeMultiple(sources, options = {}) {
+            const prompt = options.prompt ||
+                'Describe these images in detail. Note any relationships or differences between them.';
+            const model = options.model || DEFAULT_MODEL;
+            const maxTokens = options.maxTokens || DEFAULT_MAX_TOKENS;
+            const finalPrompt = buildPrompt(prompt, options);
+            logger_1.logger.info({ count: sources.length, model }, 'Analyzing multiple images');
+            try {
+                // Try to serve from cache for single-image multi calls.
+                if (sources.length === 1) {
+                    const cacheKey = buildCacheKey(sources[0], options, finalPrompt, model);
+                    const cached = getCached(cacheKey);
+                    if (cached) {
+                        return { ...cached };
+                    }
+                }
+                const content = [];
+                for (const source of sources) {
+                    content.push(await sourceToContent(source));
+                }
+                content.push({ type: 'text', text: finalPrompt });
+                enforceVisionRateLimit();
+                const response = await anthropic.messages.create({
+                    model,
+                    max_tokens: maxTokens,
+                    messages: [{ role: 'user', content }],
+                });
+                const textContent = response.content.find((c) => c.type === 'text');
+                const raw = textContent?.type === 'text' ? textContent.text : '';
+                const result = {
+                    description: raw,
+                    raw,
+                };
+                if (sources.length === 1) {
+                    const cacheKey = buildCacheKey(sources[0], options, finalPrompt, model);
+                    setCached(cacheKey, result);
+                }
+                return result;
+            }
+            catch (error) {
+                logger_1.logger.error({ error }, 'Multiple image analysis failed');
+                throw error;
+            }
+        },
+        async compare(source1, source2, options = {}) {
+            const prompt = options.prompt ||
+                'Compare these two images. Describe the differences and similarities in detail.';
+            const result = await this.analyzeMultiple([source1, source2], {
+                ...options,
+                prompt,
+            });
+            return result.description;
+        },
+    };
+}
+//# sourceMappingURL=image.js.map

package/dist/tools/image.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Tools Module - Clawdbot-style agent tools
+ */
+export { createExecTool } from './exec';
+export type { ExecTool, ExecOptions, ExecResult } from './exec';
+export { createWebSearchTool, formatSearchResults } from './web-search';
+export type { WebSearchTool, SearchOptions, SearchResult, SearchResponse } from './web-search';
+export { createWebFetchTool } from './web-fetch';
+export type { WebFetchTool, FetchOptions, FetchResult } from './web-fetch';
+export { createSessionTools, formatSessionList } from './sessions';
+export type { SessionTools, SessionInfo, HistoryEntry, SendOptions, SendResult } from './sessions';
+export { createImageTool } from './image';
+export type { ImageTool, ImageSource, AnalyzeOptions, AnalysisResult } from './image';
+export { createMessageTool } from './message';
+export type { MessageTool, MessageAction, ReactionAction, ThreadAction, PollAction, PinAction, EditAction, DeleteAction, } from './message';
+export { createBrowserTool } from './browser';
+export type { BrowserTool, BrowserConfig, ScreenshotOptions, ClickOptions, PageInfo } from './browser';
+export { createCanvasTool, CanvasTemplates } from './canvas';
+export type { CanvasTool, CanvasState, CanvasSnapshot, CanvasContentType } from './canvas';
+export { createNodesTool } from './nodes';
+export type { NodesTool, DeviceNode, NodeType, NodeCapability, CameraSnapResult, ScreenRecordResult, LocationResult, SystemRunResult, } from './nodes';
+export { createFileTool } from './files';
+export type { FileTool, FileReadOptions, FileWriteOptions, FileEdit, FileEditOptions, FileListOptions, FileSearchOptions, } from './files';
+export { createShellHistoryTool } from './shell-history';
+export type { ShellHistoryTool, ShellHistoryEntry, ShellHistoryOptions } from './shell-history';
+export { createGitTool } from './git';
+export type { GitTool, GitStatusResult, GitLogEntry } from './git';
+export { createEmailTool } from './email';
+export type { EmailTool, SendEmailOptions, EmailAddress } from './email';
+export { createSmsTool } from './sms';
+export type { SmsTool, SmsSendOptions } from './sms';
+export { createTranscriptionTool } from './transcription';
+export type { TranscriptionTool, TranscribeOptions } from './transcription';
+export { createSqlTool } from './sql';
+export type { SqlTool, SqlQueryOptions, SqlQueryResult } from './sql';
+export { createWebhookTool } from './webhooks';
+export type { WebhookTool, RegisterWebhookOptions, WebhookInfo, WebhookTarget } from './webhooks';
+export { createDockerTool } from './docker';
+export type { DockerTool, DockerRunOptions, DockerContainerInfo, DockerImageInfo } from './docker';

package/dist/tools/index.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * Tools Module - Clawdbot-style agent tools
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDockerTool = exports.createWebhookTool = exports.createSqlTool = exports.createTranscriptionTool = exports.createSmsTool = exports.createEmailTool = exports.createGitTool = exports.createShellHistoryTool = exports.createFileTool = exports.createNodesTool = exports.CanvasTemplates = exports.createCanvasTool = exports.createBrowserTool = exports.createMessageTool = exports.createImageTool = exports.formatSessionList = exports.createSessionTools = exports.createWebFetchTool = exports.formatSearchResults = exports.createWebSearchTool = exports.createExecTool = void 0;
+var exec_1 = require("./exec");
+Object.defineProperty(exports, "createExecTool", { enumerable: true, get: function () { return exec_1.createExecTool; } });
+var web_search_1 = require("./web-search");
+Object.defineProperty(exports, "createWebSearchTool", { enumerable: true, get: function () { return web_search_1.createWebSearchTool; } });
+Object.defineProperty(exports, "formatSearchResults", { enumerable: true, get: function () { return web_search_1.formatSearchResults; } });
+var web_fetch_1 = require("./web-fetch");
+Object.defineProperty(exports, "createWebFetchTool", { enumerable: true, get: function () { return web_fetch_1.createWebFetchTool; } });
+var sessions_1 = require("./sessions");
+Object.defineProperty(exports, "createSessionTools", { enumerable: true, get: function () { return sessions_1.createSessionTools; } });
+Object.defineProperty(exports, "formatSessionList", { enumerable: true, get: function () { return sessions_1.formatSessionList; } });
+var image_1 = require("./image");
+Object.defineProperty(exports, "createImageTool", { enumerable: true, get: function () { return image_1.createImageTool; } });
+var message_1 = require("./message");
+Object.defineProperty(exports, "createMessageTool", { enumerable: true, get: function () { return message_1.createMessageTool; } });
+var browser_1 = require("./browser");
+Object.defineProperty(exports, "createBrowserTool", { enumerable: true, get: function () { return browser_1.createBrowserTool; } });
+var canvas_1 = require("./canvas");
+Object.defineProperty(exports, "createCanvasTool", { enumerable: true, get: function () { return canvas_1.createCanvasTool; } });
+Object.defineProperty(exports, "CanvasTemplates", { enumerable: true, get: function () { return canvas_1.CanvasTemplates; } });
+var nodes_1 = require("./nodes");
+Object.defineProperty(exports, "createNodesTool", { enumerable: true, get: function () { return nodes_1.createNodesTool; } });
+var files_1 = require("./files");
+Object.defineProperty(exports, "createFileTool", { enumerable: true, get: function () { return files_1.createFileTool; } });
+var shell_history_1 = require("./shell-history");
+Object.defineProperty(exports, "createShellHistoryTool", { enumerable: true, get: function () { return shell_history_1.createShellHistoryTool; } });
+var git_1 = require("./git");
+Object.defineProperty(exports, "createGitTool", { enumerable: true, get: function () { return git_1.createGitTool; } });
+var email_1 = require("./email");
+Object.defineProperty(exports, "createEmailTool", { enumerable: true, get: function () { return email_1.createEmailTool; } });
+var sms_1 = require("./sms");
+Object.defineProperty(exports, "createSmsTool", { enumerable: true, get: function () { return sms_1.createSmsTool; } });
+var transcription_1 = require("./transcription");
+Object.defineProperty(exports, "createTranscriptionTool", { enumerable: true, get: function () { return transcription_1.createTranscriptionTool; } });
+var sql_1 = require("./sql");
+Object.defineProperty(exports, "createSqlTool", { enumerable: true, get: function () { return sql_1.createSqlTool; } });
+var webhooks_1 = require("./webhooks");
+Object.defineProperty(exports, "createWebhookTool", { enumerable: true, get: function () { return webhooks_1.createWebhookTool; } });
+var docker_1 = require("./docker");
+Object.defineProperty(exports, "createDockerTool", { enumerable: true, get: function () { return docker_1.createDockerTool; } });
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,+BAAwC;AAA/B,sGAAA,cAAc,OAAA;AAGvB,2CAAwE;AAA/D,iHAAA,mBAAmB,OAAA;AAAE,iHAAA,mBAAmB,OAAA;AAGjD,yCAAiD;AAAxC,+GAAA,kBAAkB,OAAA;AAG3B,uCAAmE;AAA1D,8GAAA,kBAAkB,OAAA;AAAE,6GAAA,iBAAiB,OAAA;AAG9C,iCAA0C;AAAjC,wGAAA,eAAe,OAAA;AAGxB,qCAA8C;AAArC,4GAAA,iBAAiB,OAAA;AAY1B,qCAA8C;AAArC,4GAAA,iBAAiB,OAAA;AAG1B,mCAA6D;AAApD,0GAAA,gBAAgB,OAAA;AAAE,yGAAA,eAAe,OAAA;AAG1C,iCAA0C;AAAjC,wGAAA,eAAe,OAAA;AAYxB,iCAAyC;AAAhC,uGAAA,cAAc,OAAA;AAWvB,iDAAyD;AAAhD,uHAAA,sBAAsB,OAAA;AAG/B,6BAAsC;AAA7B,oGAAA,aAAa,OAAA;AAGtB,iCAA0C;AAAjC,wGAAA,eAAe,OAAA;AAGxB,6BAAsC;AAA7B,oGAAA,aAAa,OAAA;AAGtB,iDAA0D;AAAjD,wHAAA,uBAAuB,OAAA;AAGhC,6BAAsC;AAA7B,oGAAA,aAAa,OAAA;AAGtB,uCAA+C;AAAtC,6GAAA,iBAAiB,OAAA;AAG1B,mCAA4C;AAAnC,0GAAA,gBAAgB,OAAA"}

package/dist/tools/message.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Message Tool - Clawdbot-style rich messaging actions
+ *
+ * Features:
+ * - Reactions (emoji)
+ * - Threads (reply in thread)
+ * - Polls
+ * - Pins
+ * - Edit/Delete messages
+ */
+/** Base action */
+interface BaseAction {
+    platform: string;
+    chatId: string;
+    messageId: string;
+}
+/** Add reaction */
+export interface ReactionAction extends BaseAction {
+    type: 'reaction';
+    emoji: string;
+    /** Remove instead of add */
+    remove?: boolean;
+}
+/** Reply in thread */
+export interface ThreadAction extends BaseAction {
+    type: 'thread';
+    text: string;
+}
+/** Create poll */
+export interface PollAction {
+    type: 'poll';
+    platform: string;
+    chatId: string;
+    question: string;
+    options: string[];
+    /** Allow multiple selections */
+    multiSelect?: boolean;
+    /** Anonymous voting */
+    anonymous?: boolean;
+}
+/** Pin message */
+export interface PinAction extends BaseAction {
+    type: 'pin';
+    /** Unpin instead of pin */
+    unpin?: boolean;
+}
+/** Edit message */
+export interface EditAction extends BaseAction {
+    type: 'edit';
+    newText: string;
+}
+/** Delete message */
+export interface DeleteAction extends BaseAction {
+    type: 'delete';
+}
+export type MessageAction = ReactionAction | ThreadAction | PollAction | PinAction | EditAction | DeleteAction;
+/** Action result */
+export interface ActionResult {
+    success: boolean;
+    error?: string;
+    /** New message ID if applicable */
+    messageId?: string;
+}
+/** Platform-specific handlers */
+export type PlatformHandler = (action: MessageAction) => Promise<ActionResult>;
+export interface MessageTool {
+    /** Execute a message action */
+    execute(action: MessageAction): Promise<ActionResult>;
+    /** Register a platform handler */
+    registerPlatform(platform: string, handler: PlatformHandler): void;
+    /** Add reaction to a message */
+    react(platform: string, chatId: string, messageId: string, emoji: string): Promise<ActionResult>;
+    /** Reply in thread */
+    replyInThread(platform: string, chatId: string, messageId: string, text: string): Promise<ActionResult>;
+    /** Create a poll */
+    createPoll(platform: string, chatId: string, question: string, options: string[], multiSelect?: boolean): Promise<ActionResult>;
+    /** Pin a message */
+    pin(platform: string, chatId: string, messageId: string): Promise<ActionResult>;
+    /** Unpin a message */
+    unpin(platform: string, chatId: string, messageId: string): Promise<ActionResult>;
+    /** Edit a message */
+    edit(platform: string, chatId: string, messageId: string, newText: string): Promise<ActionResult>;
+    /** Delete a message */
+    delete(platform: string, chatId: string, messageId: string): Promise<ActionResult>;
+}
+export declare function createMessageTool(): MessageTool;
+/**
+ * Default Telegram handler
+ */
+export declare function createTelegramMessageHandler(bot: {
+    api: any;
+}): PlatformHandler;
+/**
+ * Default Discord handler
+ */
+export declare function createDiscordMessageHandler(client: {
+    channels: any;
+}): PlatformHandler;
+export {};