clodds 1.1.0

package/dist/tools/canvas.js

@@ -0,0 +1,349 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CanvasTemplates = void 0;
+exports.createCanvasTool = createCanvasTool;
+const logger_1 = require("../utils/logger");
+function createCanvasTool() {
+    const nodes = new Map();
+    let currentState = null;
+    const nodeQueues = new Map();
+    const broadcastQueue = [];
+    const DEFAULT_SEND_RETRIES = 3;
+    const DEFAULT_SEND_RETRY_DELAY_MS = 200;
+    const DEFAULT_RESPONSE_TIMEOUT_MS = 30_000;
+    function isWsOpen(ws) {
+        // 1 === WebSocket.OPEN
+        return ws.readyState === 1;
+    }
+    function enqueueForNode(nodeId, message, attempts = 0) {
+        if (!nodeQueues.has(nodeId)) {
+            nodeQueues.set(nodeId, []);
+        }
+        nodeQueues.get(nodeId).push({ message, attempts });
+    }
+    function enqueueBroadcast(message, attempts = 0) {
+        broadcastQueue.push({ message, attempts });
+    }
+    async function sendWithRetry(node, payload, message, attempts = 0) {
+        if (!isWsOpen(node.ws)) {
+            enqueueForNode(node.id, message, attempts);
+            return;
+        }
+        try {
+            node.ws.send(payload);
+        }
+        catch (error) {
+            if (attempts + 1 >= DEFAULT_SEND_RETRIES) {
+                logger_1.logger.error({ error, nodeId: node.id }, 'Canvas send failed after retries');
+                enqueueForNode(node.id, message, attempts + 1);
+                return;
+            }
+            await new Promise((r) => setTimeout(r, DEFAULT_SEND_RETRY_DELAY_MS));
+            await sendWithRetry(node, payload, message, attempts + 1);
+        }
+    }
+    async function flushNodeQueue(node) {
+        const queued = nodeQueues.get(node.id);
+        if (!queued || queued.length === 0)
+            return;
+        nodeQueues.delete(node.id);
+        for (const entry of queued) {
+            const payload = JSON.stringify(entry.message);
+            await sendWithRetry(node, payload, entry.message, entry.attempts);
+        }
+    }
+    async function flushBroadcastQueue(node) {
+        if (broadcastQueue.length === 0)
+            return;
+        for (const entry of broadcastQueue) {
+            const payload = JSON.stringify(entry.message);
+            await sendWithRetry(node, payload, entry.message, entry.attempts);
+        }
+    }
+    /** Send message to node(s) */
+    async function sendToNodes(message, nodeId) {
+        const targets = nodeId
+            ? [nodes.get(nodeId)].filter(Boolean)
+            : Array.from(nodes.values());
+        if (targets.length === 0) {
+            logger_1.logger.warn('No canvas nodes connected');
+            if (nodeId) {
+                enqueueForNode(nodeId, message);
+            }
+            else {
+                enqueueBroadcast(message);
+            }
+            return;
+        }
+        const payload = JSON.stringify(message);
+        for (const node of targets) {
+            if (!node)
+                continue;
+            if (!isWsOpen(node.ws)) {
+                enqueueForNode(node.id, message);
+                continue;
+            }
+            await sendWithRetry(node, payload, message);
+        }
+    }
+    /** Wait for response from node */
+    async function waitForResponse(node, requestId, timeout = DEFAULT_RESPONSE_TIMEOUT_MS) {
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                cleanup();
+                reject(new Error('Canvas response timeout'));
+            }, timeout);
+            const handler = (data) => {
+                try {
+                    const msg = JSON.parse(data.toString());
+                    if (msg.requestId === requestId) {
+                        cleanup();
+                        if (msg.error) {
+                            reject(new Error(msg.error));
+                        }
+                        else {
+                            resolve(msg.result);
+                        }
+                    }
+                }
+                catch {
+                    // Ignore parse errors
+                }
+            };
+            const cleanup = () => {
+                clearTimeout(timer);
+                node.ws.off('message', handler);
+            };
+            node.ws.on('message', handler);
+        });
+    }
+    const tool = {
+        async present(content, options = {}) {
+            const type = options.type || 'html';
+            const requestId = Date.now().toString(36);
+            currentState = {
+                id: requestId,
+                type,
+                content,
+                styles: options.styles,
+                scripts: options.scripts,
+                updatedAt: new Date(),
+            };
+            await sendToNodes({
+                type: 'canvas.present',
+                requestId,
+                payload: {
+                    contentType: type,
+                    content,
+                    styles: options.styles,
+                    scripts: options.scripts,
+                },
+            }, options.nodeId);
+            logger_1.logger.info({ type, contentLength: content.length }, 'Canvas content presented');
+        },
+        async evaluate(script, nodeId) {
+            const targetNodes = nodeId
+                ? [nodes.get(nodeId)].filter((n) => !!n)
+                : Array.from(nodes.values());
+            if (targetNodes.length === 0) {
+                throw new Error('No canvas nodes connected');
+            }
+            const node = targetNodes[0];
+            const requestId = Date.now().toString(36);
+            const message = {
+                type: 'canvas.eval',
+                requestId,
+                payload: { script },
+            };
+            await sendToNodes(message, node.id);
+            return waitForResponse(node, requestId, DEFAULT_RESPONSE_TIMEOUT_MS);
+        },
+        async snapshot(nodeId) {
+            const targetNodes = nodeId
+                ? [nodes.get(nodeId)].filter((n) => !!n)
+                : Array.from(nodes.values());
+            if (targetNodes.length === 0) {
+                throw new Error('No canvas nodes connected');
+            }
+            const node = targetNodes[0];
+            const requestId = Date.now().toString(36);
+            const message = {
+                type: 'canvas.snapshot',
+                requestId,
+            };
+            await sendToNodes(message, node.id);
+            const result = await waitForResponse(node, requestId, DEFAULT_RESPONSE_TIMEOUT_MS);
+            return {
+                ...result,
+                timestamp: new Date(),
+            };
+        },
+        async reset(nodeId) {
+            currentState = null;
+            await sendToNodes({
+                type: 'canvas.reset',
+                requestId: Date.now().toString(36),
+            }, nodeId);
+            logger_1.logger.info('Canvas reset');
+        },
+        getState() {
+            return currentState;
+        },
+        listNodes() {
+            return Array.from(nodes.values()).map((n) => ({
+                id: n.id,
+                name: n.name,
+                type: n.type,
+                ws: n.ws,
+                capabilities: n.capabilities,
+                connectedAt: n.connectedAt,
+            }));
+        },
+        registerNode(ws, info) {
+            const node = {
+                ...info,
+                ws,
+                connectedAt: new Date(),
+            };
+            nodes.set(info.id, node);
+            ws.on('close', () => {
+                nodes.delete(info.id);
+                logger_1.logger.info({ nodeId: info.id }, 'Canvas node disconnected');
+            });
+            logger_1.logger.info({ nodeId: info.id, type: info.type }, 'Canvas node registered');
+            // Flush any queued messages first.
+            void flushBroadcastQueue(node);
+            void flushNodeQueue(node);
+            // Send current state if any
+            if (currentState) {
+                void sendToNodes({
+                    type: 'canvas.present',
+                    requestId: 'sync',
+                    payload: {
+                        contentType: currentState.type,
+                        content: currentState.content,
+                        styles: currentState.styles,
+                        scripts: currentState.scripts,
+                    },
+                }, node.id);
+            }
+        },
+        unregisterNode(id) {
+            nodes.delete(id);
+            logger_1.logger.info({ nodeId: id }, 'Canvas node unregistered');
+        },
+    };
+    return tool;
+}
+/**
+ * Create HTML for common canvas displays
+ */
+exports.CanvasTemplates = {
+    /** Simple text display */
+    text(text, options) {
+        const fontSize = options?.fontSize || '24px';
+        const color = options?.color || '#fff';
+        return `
+      <div style="
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        height: 100vh;
+        font-size: ${fontSize};
+        color: ${color};
+        font-family: -apple-system, system-ui, sans-serif;
+        padding: 20px;
+        text-align: center;
+      ">
+        ${text}
+      </div>
+    `;
+    },
+    /** Markdown display */
+    markdown(content) {
+        return `
+      <div id="markdown-content" style="
+        max-width: 800px;
+        margin: 0 auto;
+        padding: 40px 20px;
+        font-family: -apple-system, system-ui, sans-serif;
+        color: #e2e8f0;
+        line-height: 1.6;
+      "></div>
+      <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
+      <script>
+        document.getElementById('markdown-content').innerHTML =
+          marked.parse(${JSON.stringify(content)});
+      </script>
+    `;
+    },
+    /** Chart display (using Chart.js) */
+    chart(config) {
+        return `
+      <canvas id="chart" style="max-width: 100%; max-height: 100vh;"></canvas>
+      <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
+      <script>
+        new Chart(document.getElementById('chart'), ${JSON.stringify(config)});
+      </script>
+    `;
+    },
+    /** Image display */
+    image(src, options) {
+        const fit = options?.fit || 'contain';
+        return `
+      <div style="
+        width: 100vw;
+        height: 100vh;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        background: #000;
+      ">
+        <img src="${src}" style="
+          max-width: 100%;
+          max-height: 100%;
+          object-fit: ${fit};
+        " />
+      </div>
+    `;
+    },
+    /** Loading spinner */
+    loading(message) {
+        return `
+      <div style="
+        display: flex;
+        flex-direction: column;
+        align-items: center;
+        justify-content: center;
+        height: 100vh;
+        color: #94a3b8;
+        font-family: -apple-system, system-ui, sans-serif;
+      ">
+        <div style="
+          width: 40px;
+          height: 40px;
+          border: 3px solid #334155;
+          border-top-color: #3b82f6;
+          border-radius: 50%;
+          animation: spin 1s linear infinite;
+        "></div>
+        ${message ? `<p style="margin-top: 16px">${message}</p>` : ''}
+      </div>
+      <style>
+        @keyframes spin {
+          to { transform: rotate(360deg); }
+        }
+      </style>
+    `;
+    },
+};
+//# sourceMappingURL=canvas.js.map

package/dist/tools/canvas.js.map

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

package/dist/tools/docker.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Docker Tool - safe wrappers around the Docker CLI
+ */
+export interface DockerContainerInfo {
+    id: string;
+    image: string;
+    names: string;
+    status: string;
+    state: string;
+    ports?: string;
+}
+export interface DockerImageInfo {
+    repository: string;
+    tag: string;
+    id: string;
+    size: string;
+    createdSince?: string;
+}
+export interface DockerRunOptions {
+    image: string;
+    name?: string;
+    command?: string[];
+    env?: Record<string, string>;
+    ports?: Array<{
+        host: number;
+        container: number;
+    }>;
+    volumes?: Array<{
+        hostPath: string;
+        containerPath: string;
+        readOnly?: boolean;
+    }>;
+    detach?: boolean;
+    workdir?: string;
+    network?: string;
+}
+export interface DockerTool {
+    isAvailable(): boolean;
+    listContainers(all?: boolean): Promise<DockerContainerInfo[]>;
+    listImages(): Promise<DockerImageInfo[]>;
+    run(options: DockerRunOptions): Promise<{
+        ok: boolean;
+        idOrName?: string;
+        output?: string;
+    }>;
+    stop(container: string, timeoutSeconds?: number): Promise<{
+        ok: boolean;
+        output?: string;
+    }>;
+    remove(container: string, force?: boolean): Promise<{
+        ok: boolean;
+        output?: string;
+    }>;
+    logs(container: string, tail?: number): Promise<{
+        ok: boolean;
+        output: string;
+    }>;
+}
+export declare function createDockerTool(workspaceRoot: string): DockerTool;

package/dist/tools/docker.js

@@ -0,0 +1,191 @@
+"use strict";
+/**
+ * Docker Tool - safe wrappers around the Docker CLI
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDockerTool = createDockerTool;
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const permissions_1 = require("../permissions");
+const logger_1 = require("../utils/logger");
+const DEFAULT_LOG_TAIL = 200;
+function runDocker(args, cwd) {
+    try {
+        const res = (0, child_process_1.spawnSync)('docker', args, {
+            cwd,
+            encoding: 'utf-8',
+            maxBuffer: 10 * 1024 * 1024,
+        });
+        return {
+            ok: res.status === 0,
+            stdout: res.stdout || '',
+            stderr: res.stderr || '',
+            code: res.status ?? 1,
+        };
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === 'ENOENT') {
+            return {
+                ok: false,
+                stdout: '',
+                stderr: 'docker CLI not found. Install Docker Desktop or the docker CLI.',
+                code: 127,
+            };
+        }
+        return {
+            ok: false,
+            stdout: '',
+            stderr: err.message,
+            code: 1,
+        };
+    }
+}
+function parseJsonLines(text) {
+    return text
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0)
+        .map((line) => JSON.parse(line));
+}
+function ensureVolumePath(workspaceRoot, hostPath) {
+    const resolved = (0, permissions_1.resolveSandboxPath)(hostPath, { root: workspaceRoot, allowSymlinks: false });
+    (0, permissions_1.assertSandboxPath)(resolved, { root: workspaceRoot, allowSymlinks: false });
+    if (!(0, fs_1.existsSync)(resolved)) {
+        throw new Error(`Volume host path does not exist: ${hostPath}`);
+    }
+    return resolved;
+}
+function clampTail(value) {
+    if (!value || Number.isNaN(value))
+        return DEFAULT_LOG_TAIL;
+    return Math.max(1, Math.min(5000, Math.floor(value)));
+}
+function createDockerTool(workspaceRoot) {
+    const root = workspaceRoot;
+    return {
+        isAvailable() {
+            const res = runDocker(['version', '--format', '{{json .Client}}']);
+            return res.ok;
+        },
+        async listContainers(all = true) {
+            const args = ['ps', '--format', '{{json .}}'];
+            if (all)
+                args.splice(1, 0, '-a');
+            const res = runDocker(args);
+            if (!res.ok) {
+                throw new Error(res.stderr || `docker ps failed (exit ${res.code})`);
+            }
+            const rows = parseJsonLines(res.stdout);
+            return rows.map((r) => ({
+                id: r.ID,
+                image: r.Image,
+                names: r.Names,
+                status: r.Status,
+                state: r.State,
+                ports: r.Ports,
+            }));
+        },
+        async listImages() {
+            const res = runDocker(['images', '--format', '{{json .}}']);
+            if (!res.ok) {
+                throw new Error(res.stderr || `docker images failed (exit ${res.code})`);
+            }
+            const rows = parseJsonLines(res.stdout);
+            return rows.map((r) => ({
+                repository: r.Repository,
+                tag: r.Tag,
+                id: r.ID,
+                size: r.Size,
+                createdSince: r.CreatedSince,
+            }));
+        },
+        async run(options) {
+            if (!options?.image?.trim()) {
+                throw new Error('Docker run requires an image');
+            }
+            const args = ['run'];
+            const detach = options.detach !== false;
+            if (detach)
+                args.push('-d');
+            args.push('--cap-drop=ALL', '--security-opt', 'no-new-privileges');
+            if (options.name?.trim()) {
+                args.push('--name', options.name.trim());
+            }
+            if (options.workdir?.trim()) {
+                args.push('-w', options.workdir.trim());
+            }
+            if (options.network?.trim()) {
+                args.push('--network', options.network.trim());
+            }
+            if (options.env) {
+                for (const [key, value] of Object.entries(options.env)) {
+                    args.push('-e', `${key}=${value}`);
+                }
+            }
+            if (options.ports) {
+                for (const p of options.ports) {
+                    args.push('-p', `${p.host}:${p.container}`);
+                }
+            }
+            // Always mount the workspace read-write at /workspace.
+            args.push('-v', `${root}:/workspace`);
+            if (options.volumes) {
+                for (const v of options.volumes) {
+                    const host = ensureVolumePath(root, v.hostPath);
+                    const mode = v.readOnly ? ':ro' : '';
+                    args.push('-v', `${host}:${v.containerPath}${mode}`);
+                }
+            }
+            args.push(options.image.trim());
+            if (options.command?.length) {
+                args.push(...options.command);
+            }
+            logger_1.logger.info({ image: options.image, detach }, 'Running docker container');
+            const res = runDocker(args, root);
+            if (!res.ok) {
+                throw new Error(res.stderr || `docker run failed (exit ${res.code})`);
+            }
+            return {
+                ok: true,
+                idOrName: res.stdout.trim() || options.name,
+                output: res.stderr.trim() || undefined,
+            };
+        },
+        async stop(container, timeoutSeconds = 10) {
+            if (!container?.trim())
+                throw new Error('Container name or id is required');
+            const res = runDocker(['stop', '-t', String(timeoutSeconds), container.trim()]);
+            if (!res.ok) {
+                throw new Error(res.stderr || `docker stop failed (exit ${res.code})`);
+            }
+            return { ok: true, output: res.stdout.trim() };
+        },
+        async remove(container, force = false) {
+            if (!container?.trim())
+                throw new Error('Container name or id is required');
+            const args = ['rm'];
+            if (force)
+                args.push('-f');
+            args.push(container.trim());
+            const res = runDocker(args);
+            if (!res.ok) {
+                throw new Error(res.stderr || `docker rm failed (exit ${res.code})`);
+            }
+            return { ok: true, output: res.stdout.trim() };
+        },
+        async logs(container, tail) {
+            if (!container?.trim())
+                throw new Error('Container name or id is required');
+            const t = clampTail(tail);
+            const res = runDocker(['logs', '--tail', String(t), container.trim()]);
+            if (!res.ok) {
+                throw new Error(res.stderr || `docker logs failed (exit ${res.code})`);
+            }
+            // docker logs writes to stderr in many cases; include both.
+            const output = [res.stdout, res.stderr].filter(Boolean).join('\n').trim();
+            return { ok: true, output };
+        },
+    };
+}
+//# sourceMappingURL=docker.js.map

package/dist/tools/docker.js.map

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

package/dist/tools/email.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Email Tool - send email via SMTP (nodemailer) with sendmail fallback
+ */
+export interface EmailAddress {
+    name?: string;
+    email: string;
+}
+export interface SendEmailOptions {
+    from: EmailAddress;
+    to: Array<EmailAddress | string>;
+    cc?: Array<EmailAddress | string>;
+    bcc?: Array<EmailAddress | string>;
+    subject: string;
+    text: string;
+    replyTo?: EmailAddress | string;
+    dryRun?: boolean;
+}
+export interface EmailTool {
+    isAvailable(): boolean;
+    send(options: SendEmailOptions): Promise<{
+        ok: boolean;
+        message: string;
+    }>;
+}
+export declare function createEmailTool(): EmailTool;