clodds 1.1.0

package/dist/tools/browser.js

@@ -0,0 +1,459 @@
+"use strict";
+/**
+ * Browser Tool - Clawdbot-style browser automation via CDP
+ *
+ * Features:
+ * - Launch and control Chrome/Chromium
+ * - Navigate, click, type, screenshot
+ * - Multiple browser profiles
+ * - Page content extraction
+ */
+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.createBrowserTool = createBrowserTool;
+const child_process_1 = require("child_process");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const logger_1 = require("../utils/logger");
+const DEFAULT_CONFIG = {
+    enabled: true,
+    executablePath: '',
+    userDataDir: path.join(os.homedir(), '.clodds', 'browser'),
+    profile: 'default',
+    viewportWidth: 1280,
+    viewportHeight: 720,
+    headless: true,
+    cdpPort: 9222,
+    cdpWaitMs: 1000,
+    cdpMaxWaitMs: 15_000,
+    cdpPollMs: 200,
+};
+/**
+ * Find Chrome/Chromium executable
+ */
+function findChrome() {
+    const platform = process.platform;
+    const paths = [];
+    if (platform === 'darwin') {
+        paths.push('/Applications/Google Chrome.app/Contents/MacOS/Google Chrome', '/Applications/Chromium.app/Contents/MacOS/Chromium', '/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary');
+    }
+    else if (platform === 'linux') {
+        paths.push('/usr/bin/google-chrome', '/usr/bin/chromium', '/usr/bin/chromium-browser', '/snap/bin/chromium');
+    }
+    else if (platform === 'win32') {
+        paths.push('C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe', 'C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe');
+    }
+    for (const p of paths) {
+        if (fs.existsSync(p)) {
+            return p;
+        }
+    }
+    return null;
+}
+/**
+ * Simple CDP client using WebSocket
+ */
+async function connectCDP(port, onDisconnect) {
+    const WebSocket = (await Promise.resolve().then(() => __importStar(require('ws')))).default;
+    // Get WebSocket URL from CDP
+    const response = await fetch(`http://127.0.0.1:${port}/json/version`);
+    const data = await response.json();
+    const wsUrl = data.webSocketDebuggerUrl;
+    return new Promise((resolve, reject) => {
+        const ws = new WebSocket(wsUrl);
+        let messageId = 0;
+        let connected = false;
+        let resolved = false;
+        const pending = new Map();
+        ws.on('open', () => {
+            connected = true;
+            resolved = true;
+            resolve({
+                send(method, params = {}) {
+                    return new Promise((res, rej) => {
+                        const id = ++messageId;
+                        pending.set(id, { resolve: res, reject: rej });
+                        ws.send(JSON.stringify({ id, method, params }));
+                    });
+                },
+                close() {
+                    ws.close();
+                },
+                isConnected() {
+                    return connected && ws.readyState === ws.OPEN;
+                },
+            });
+        });
+        ws.on('message', (data) => {
+            const msg = JSON.parse(data.toString());
+            if (msg.id && pending.has(msg.id)) {
+                const { resolve, reject } = pending.get(msg.id);
+                pending.delete(msg.id);
+                if (msg.error) {
+                    reject(new Error(msg.error.message));
+                }
+                else {
+                    resolve(msg.result);
+                }
+            }
+        });
+        ws.on('close', () => {
+            connected = false;
+            for (const { reject } of pending.values()) {
+                reject(new Error('CDP connection closed'));
+            }
+            pending.clear();
+            onDisconnect?.('close');
+        });
+        ws.on('error', (err) => {
+            connected = false;
+            onDisconnect?.(err.message || 'error');
+            // If not yet connected, surface the error to the caller.
+            if (!resolved) {
+                reject(err);
+            }
+        });
+    });
+}
+async function waitForCdpReady(port, initialWaitMs, maxWaitMs, pollMs) {
+    const start = Date.now();
+    if (initialWaitMs > 0) {
+        await new Promise((resolve) => setTimeout(resolve, initialWaitMs));
+    }
+    let lastError = null;
+    while (Date.now() - start < maxWaitMs) {
+        try {
+            const res = await fetch(`http://127.0.0.1:${port}/json/version`);
+            if (res.ok)
+                return;
+            lastError = new Error(`CDP not ready: ${res.status}`);
+        }
+        catch (error) {
+            lastError = error;
+        }
+        await new Promise((resolve) => setTimeout(resolve, pollMs));
+    }
+    throw lastError instanceof Error
+        ? lastError
+        : new Error(`Timed out waiting for CDP on port ${port}`);
+}
+function createBrowserTool(configInput) {
+    const config = { ...DEFAULT_CONFIG, ...configInput };
+    const profileRoot = path.join(config.userDataDir, 'profiles', config.profile);
+    let browserProcess = null;
+    let cdp = null;
+    let reconnectPromise = null;
+    const handleDisconnect = (reason) => {
+        logger_1.logger.warn({ reason }, 'CDP disconnected');
+        cdp = null;
+        // Best-effort background reconnect if the browser is still running.
+        if (browserProcess && !reconnectPromise) {
+            void ensureCdp();
+        }
+    };
+    async function establishCdpConnection() {
+        const conn = await connectCDP(config.cdpPort, handleDisconnect);
+        await conn.send('Page.enable');
+        await conn.send('Runtime.enable');
+        await conn.send('Network.enable');
+        return conn;
+    }
+    async function ensureCdp() {
+        if (cdp && cdp.isConnected()) {
+            return cdp;
+        }
+        if (!browserProcess) {
+            throw new Error('Browser not running');
+        }
+        if (reconnectPromise) {
+            return reconnectPromise;
+        }
+        reconnectPromise = (async () => {
+            let lastError = null;
+            for (let attempt = 1; attempt <= 5; attempt++) {
+                try {
+                    const conn = await establishCdpConnection();
+                    cdp = conn;
+                    logger_1.logger.info({ attempt }, 'CDP reconnected');
+                    return conn;
+                }
+                catch (error) {
+                    lastError = error;
+                    const backoff = Math.min(2000, 200 * attempt);
+                    await new Promise((r) => setTimeout(r, backoff));
+                }
+            }
+            throw lastError instanceof Error ? lastError : new Error('Failed to reconnect CDP');
+        })().finally(() => {
+            reconnectPromise = null;
+        });
+        return reconnectPromise;
+    }
+    // Find Chrome if not specified
+    if (!config.executablePath) {
+        const found = findChrome();
+        if (found) {
+            config.executablePath = found;
+        }
+    }
+    // Ensure profile directory exists (persistent cookies/localStorage per profile)
+    if (!fs.existsSync(profileRoot)) {
+        fs.mkdirSync(profileRoot, { recursive: true });
+    }
+    const tool = {
+        async launch() {
+            if (browserProcess) {
+                logger_1.logger.warn('Browser already running');
+                return;
+            }
+            if (!config.executablePath) {
+                throw new Error('Chrome/Chromium not found. Set executablePath in config.');
+            }
+            logger_1.logger.info({ executable: config.executablePath }, 'Launching browser');
+            const args = [
+                `--remote-debugging-port=${config.cdpPort}`,
+                `--user-data-dir=${profileRoot}`,
+                `--window-size=${config.viewportWidth},${config.viewportHeight}`,
+                '--no-first-run',
+                '--no-default-browser-check',
+            ];
+            if (config.headless) {
+                args.push('--headless=new');
+            }
+            browserProcess = (0, child_process_1.spawn)(config.executablePath, args, {
+                stdio: 'ignore',
+                detached: false,
+            });
+            browserProcess.on('exit', (code) => {
+                logger_1.logger.info({ code }, 'Browser exited');
+                browserProcess = null;
+                cdp = null;
+            });
+            // Wait for CDP to be ready
+            await waitForCdpReady(config.cdpPort, config.cdpWaitMs, config.cdpMaxWaitMs, config.cdpPollMs);
+            // Connect to CDP
+            cdp = await establishCdpConnection();
+            logger_1.logger.info('Browser launched and CDP connected');
+        },
+        async close() {
+            if (cdp) {
+                cdp.close();
+                cdp = null;
+            }
+            if (browserProcess) {
+                browserProcess.kill();
+                browserProcess = null;
+            }
+            logger_1.logger.info('Browser closed');
+        },
+        isRunning() {
+            return browserProcess !== null && cdp !== null;
+        },
+        async goto(url, options = {}) {
+            const c = await ensureCdp();
+            logger_1.logger.debug({ url }, 'Navigating to URL');
+            await c.send('Page.navigate', { url });
+            // Wait for load/DOM readiness (polling readyState).
+            const timeoutMs = 30_000;
+            const start = Date.now();
+            const targetState = options.waitUntil === 'load' ? 'complete' : 'interactive';
+            while (Date.now() - start < timeoutMs) {
+                const state = await this.evaluate('document.readyState');
+                if (state === targetState || state === 'complete')
+                    break;
+                await new Promise((r) => setTimeout(r, 100));
+            }
+            return this.getPageInfo();
+        },
+        async getPageInfo() {
+            const c = await ensureCdp();
+            const result = await c.send('Runtime.evaluate', {
+                expression: 'JSON.stringify({ url: location.href, title: document.title })',
+                returnByValue: true,
+            });
+            return JSON.parse(result.result.value);
+        },
+        async screenshot(options = {}) {
+            const c = await ensureCdp();
+            const params = {
+                format: options.format || 'png',
+            };
+            if (options.quality) {
+                params.quality = options.quality;
+            }
+            if (options.fullPage) {
+                // Get full page dimensions
+                const metrics = await c.send('Page.getLayoutMetrics');
+                params.clip = {
+                    x: 0,
+                    y: 0,
+                    width: metrics.contentSize.width,
+                    height: metrics.contentSize.height,
+                    scale: 1,
+                };
+            }
+            else if (options.clip) {
+                params.clip = { ...options.clip, scale: 1 };
+            }
+            const result = await c.send('Page.captureScreenshot', params);
+            return Buffer.from(result.data, 'base64');
+        },
+        async click(selector, options = {}) {
+            const c = await ensureCdp();
+            // Find element and get coordinates
+            const result = await c.send('Runtime.evaluate', {
+                expression: `
+          (function() {
+            const el = document.querySelector(${JSON.stringify(selector)});
+            if (!el) return null;
+            const rect = el.getBoundingClientRect();
+            return { x: rect.x + rect.width/2, y: rect.y + rect.height/2 };
+          })()
+        `,
+                returnByValue: true,
+            });
+            if (!result.result.value) {
+                throw new Error(`Element not found: ${selector}`);
+            }
+            const { x, y } = result.result.value;
+            await c.send('Input.dispatchMouseEvent', {
+                type: 'mousePressed',
+                x,
+                y,
+                button: options.button || 'left',
+                clickCount: options.clickCount || 1,
+            });
+            await c.send('Input.dispatchMouseEvent', {
+                type: 'mouseReleased',
+                x,
+                y,
+                button: options.button || 'left',
+            });
+        },
+        async type(selector, text, options = {}) {
+            const c = await ensureCdp();
+            // Focus element
+            await c.send('Runtime.evaluate', {
+                expression: `document.querySelector(${JSON.stringify(selector)})?.focus()`,
+            });
+            // Type text
+            for (const char of text) {
+                await c.send('Input.dispatchKeyEvent', {
+                    type: 'keyDown',
+                    text: char,
+                });
+                await c.send('Input.dispatchKeyEvent', {
+                    type: 'keyUp',
+                    text: char,
+                });
+                if (options.delay) {
+                    await new Promise((r) => setTimeout(r, options.delay));
+                }
+            }
+        },
+        async evaluate(script) {
+            const c = await ensureCdp();
+            const result = await c.send('Runtime.evaluate', {
+                expression: script,
+                returnByValue: true,
+            });
+            return result.result.value;
+        },
+        async waitForSelector(selector, options = {}) {
+            await ensureCdp();
+            const timeout = options.timeout || 30000;
+            const start = Date.now();
+            while (Date.now() - start < timeout) {
+                const found = await this.evaluate(`!!document.querySelector(${JSON.stringify(selector)})`);
+                if (found)
+                    return;
+                await new Promise((r) => setTimeout(r, 100));
+            }
+            throw new Error(`Timeout waiting for selector: ${selector}`);
+        },
+        async getContent() {
+            await ensureCdp();
+            return this.evaluate('document.body.innerText');
+        },
+        async getHTML() {
+            await ensureCdp();
+            return this.evaluate('document.documentElement.outerHTML');
+        },
+        async scroll(options) {
+            await ensureCdp();
+            if (options === 'top') {
+                await this.evaluate('window.scrollTo(0, 0)');
+            }
+            else if (options === 'bottom') {
+                await this.evaluate('window.scrollTo(0, document.body.scrollHeight)');
+            }
+            else {
+                await this.evaluate(`window.scrollTo(${options.x || 0}, ${options.y || 0})`);
+            }
+        },
+        async goBack() {
+            await ensureCdp();
+            await this.evaluate('history.back()');
+        },
+        async goForward() {
+            await ensureCdp();
+            await this.evaluate('history.forward()');
+        },
+        async reload() {
+            const c = await ensureCdp();
+            await c.send('Page.reload');
+        },
+        async getCookies(urls) {
+            const c = await ensureCdp();
+            const pageUrl = await this.evaluate('location.href');
+            const params = urls && urls.length > 0 ? { urls } : { urls: [pageUrl] };
+            const result = (await c.send('Network.getCookies', params));
+            return result.cookies || [];
+        },
+        async setCookies(cookies) {
+            const c = await ensureCdp();
+            if (cookies.length === 0)
+                return;
+            await c.send('Network.setCookies', { cookies });
+        },
+        async clearCookies() {
+            const c = await ensureCdp();
+            await c.send('Network.clearBrowserCookies');
+        },
+    };
+    return tool;
+}
+//# sourceMappingURL=browser.js.map

package/dist/tools/browser.js.map

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

package/dist/tools/canvas.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Canvas Tool - A2UI (Agent-to-UI) visual workspace
+ *
+ * Features:
+ * - Present HTML/React content on connected nodes
+ * - Evaluate JavaScript in canvas context
+ * - Capture screenshots of canvas
+ * - Push/reset canvas state
+ */
+import type { WebSocket } from 'ws';
+/** Canvas content types */
+export type CanvasContentType = 'html' | 'react' | 'markdown' | 'image';
+/** Canvas state */
+export interface CanvasState {
+    id: string;
+    type: CanvasContentType;
+    content: string;
+    /** CSS styles to inject */
+    styles?: string;
+    /** JavaScript to execute */
+    scripts?: string;
+    /** Metadata */
+    meta?: Record<string, unknown>;
+    updatedAt: Date;
+}
+/** Canvas snapshot */
+export interface CanvasSnapshot {
+    /** Base64 PNG image */
+    image: string;
+    /** Viewport dimensions */
+    width: number;
+    height: number;
+    timestamp: Date;
+}
+/** Connected canvas node */
+interface CanvasNode {
+    id: string;
+    name: string;
+    type: 'macos' | 'ios' | 'android' | 'web';
+    ws: WebSocket;
+    capabilities: string[];
+    connectedAt: Date;
+}
+export interface CanvasTool {
+    /** Present content on canvas */
+    present(content: string, options?: {
+        type?: CanvasContentType;
+        styles?: string;
+        scripts?: string;
+        nodeId?: string;
+    }): Promise<void>;
+    /** Evaluate JavaScript in canvas context */
+    evaluate<T = unknown>(script: string, nodeId?: string): Promise<T>;
+    /** Take snapshot of canvas */
+    snapshot(nodeId?: string): Promise<CanvasSnapshot>;
+    /** Reset canvas to empty state */
+    reset(nodeId?: string): Promise<void>;
+    /** Get current canvas state */
+    getState(): CanvasState | null;
+    /** List connected canvas nodes */
+    listNodes(): CanvasNode[];
+    /** Register a canvas node */
+    registerNode(ws: WebSocket, info: {
+        id: string;
+        name: string;
+        type: CanvasNode['type'];
+        capabilities: string[];
+    }): void;
+    /** Unregister a canvas node */
+    unregisterNode(id: string): void;
+}
+export declare function createCanvasTool(): CanvasTool;
+/**
+ * Create HTML for common canvas displays
+ */
+export declare const CanvasTemplates: {
+    /** Simple text display */
+    text(text: string, options?: {
+        fontSize?: string;
+        color?: string;
+    }): string;
+    /** Markdown display */
+    markdown(content: string): string;
+    /** Chart display (using Chart.js) */
+    chart(config: Record<string, unknown>): string;
+    /** Image display */
+    image(src: string, options?: {
+        fit?: "contain" | "cover" | "fill";
+    }): string;
+    /** Loading spinner */
+    loading(message?: string): string;
+};
+export {};