clodds 1.1.0

package/dist/tools/nodes.js

@@ -0,0 +1,357 @@
+"use strict";
+/**
+ * Nodes Tool - Device node control (camera, screen, notifications)
+ *
+ * Features:
+ * - Discover paired device nodes (macOS, iOS, Android)
+ * - Camera capture (snap photos, record video)
+ * - Screen recording
+ * - Location access
+ * - System notifications
+ * - System commands (macOS only)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNodesTool = createNodesTool;
+const logger_1 = require("../utils/logger");
+const id_1 = require("../utils/id");
+const fs_1 = require("fs");
+const os_1 = require("os");
+const path_1 = require("path");
+function createNodesTool() {
+    const nodes = new Map();
+    const pendingRequests = new Map();
+    const stateDir = (0, path_1.join)((0, os_1.homedir)(), '.clodds');
+    const knownNodesPath = (0, path_1.join)(stateDir, 'nodes.json');
+    const knownNodes = new Map();
+    function ensureStateDir() {
+        if (!(0, fs_1.existsSync)(stateDir)) {
+            (0, fs_1.mkdirSync)(stateDir, { recursive: true });
+        }
+    }
+    function loadKnownNodes() {
+        try {
+            if (!(0, fs_1.existsSync)(knownNodesPath))
+                return;
+            const raw = (0, fs_1.readFileSync)(knownNodesPath, 'utf-8');
+            const data = JSON.parse(raw);
+            for (const record of data.nodes || []) {
+                knownNodes.set(record.id, record);
+            }
+        }
+        catch (error) {
+            logger_1.logger.warn({ error }, 'Failed to load known nodes');
+        }
+    }
+    function saveKnownNodes() {
+        try {
+            ensureStateDir();
+            const data = { nodes: Array.from(knownNodes.values()) };
+            (0, fs_1.writeFileSync)(knownNodesPath, JSON.stringify(data, null, 2));
+        }
+        catch (error) {
+            logger_1.logger.warn({ error }, 'Failed to save known nodes');
+        }
+    }
+    function upsertKnownNode(node) {
+        knownNodes.set(node.id, {
+            id: node.id,
+            name: node.name,
+            type: node.type,
+            capabilities: node.capabilities,
+            osVersion: node.osVersion,
+            model: node.model,
+            lastSeen: node.lastSeen.getTime(),
+        });
+        saveKnownNodes();
+    }
+    loadKnownNodes();
+    /** Generate request ID */
+    function generateRequestId() {
+        return (0, id_1.generateId)('req');
+    }
+    /** Send request to node and wait for response */
+    async function sendRequest(nodeId, action, params = {}, timeout = 30000) {
+        const node = nodes.get(nodeId);
+        if (!node) {
+            throw new Error(`Node not found: ${nodeId}`);
+        }
+        if (!node.connected || node.ws.readyState !== 1) {
+            throw new Error(`Node not connected: ${nodeId}`);
+        }
+        const requestId = generateRequestId();
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                pendingRequests.delete(requestId);
+                reject(new Error(`Request timeout: ${action}`));
+            }, timeout);
+            pendingRequests.set(requestId, { resolve: resolve, reject, timeout: timer });
+            node.ws.send(JSON.stringify({
+                type: 'node.invoke',
+                version: 1,
+                requestId,
+                action,
+                params,
+            }));
+        });
+    }
+    /** Handle response from node */
+    function handleResponse(data) {
+        const pending = pendingRequests.get(data.requestId);
+        if (!pending)
+            return;
+        clearTimeout(pending.timeout);
+        pendingRequests.delete(data.requestId);
+        if (data.error) {
+            pending.reject(new Error(data.error));
+        }
+        else {
+            pending.resolve(data.result);
+        }
+    }
+    function handleProtocolMessage(nodeId, msg) {
+        const node = nodes.get(nodeId);
+        if (!node)
+            return;
+        switch (msg.type) {
+            case 'node.response':
+                if (msg.requestId) {
+                    handleResponse({
+                        requestId: msg.requestId,
+                        result: msg.result,
+                        error: msg.error,
+                    });
+                }
+                break;
+            case 'node.heartbeat':
+                node.lastSeen = new Date();
+                node.connected = true;
+                upsertKnownNode(node);
+                break;
+            case 'node.register':
+                if (msg.payload) {
+                    const payload = msg.payload;
+                    node.name = payload.name || node.name;
+                    node.type = payload.type || node.type;
+                    node.capabilities = payload.capabilities || node.capabilities;
+                    node.osVersion = payload.osVersion;
+                    node.model = payload.model;
+                    node.lastSeen = new Date();
+                    upsertKnownNode(node);
+                }
+                break;
+            case 'node.event':
+                node.lastSeen = new Date();
+                upsertKnownNode(node);
+                logger_1.logger.info({ nodeId, event: msg.payload }, 'Node event received');
+                break;
+            default:
+                // Backwards compatibility: treat requestId-only messages as responses.
+                if (msg.requestId) {
+                    handleResponse({
+                        requestId: msg.requestId,
+                        result: msg.result,
+                        error: msg.error,
+                    });
+                }
+                node.lastSeen = new Date();
+                upsertKnownNode(node);
+        }
+    }
+    const tool = {
+        list() {
+            return Array.from(nodes.values()).map(({ ws, ...node }) => node);
+        },
+        discover() {
+            const discovered = new Map();
+            for (const record of knownNodes.values()) {
+                discovered.set(record.id, {
+                    id: record.id,
+                    name: record.name,
+                    type: record.type,
+                    capabilities: record.capabilities,
+                    osVersion: record.osVersion,
+                    model: record.model,
+                    connected: false,
+                    connectedAt: new Date(record.lastSeen),
+                    lastSeen: new Date(record.lastSeen),
+                });
+            }
+            for (const node of nodes.values()) {
+                const { ws, ...rest } = node;
+                discovered.set(rest.id, { ...rest });
+            }
+            return Array.from(discovered.values()).sort((a, b) => b.lastSeen.getTime() - a.lastSeen.getTime());
+        },
+        get(nodeId) {
+            const node = nodes.get(nodeId);
+            if (!node)
+                return undefined;
+            const { ws, ...rest } = node;
+            return rest;
+        },
+        describe(nodeId) {
+            const node = nodes.get(nodeId);
+            if (!node)
+                return null;
+            // Build permissions map based on capabilities
+            const permissions = {};
+            for (const cap of node.capabilities) {
+                permissions[cap] = true;
+            }
+            return {
+                capabilities: node.capabilities,
+                permissions,
+            };
+        },
+        async cameraSnap(nodeId, options = {}) {
+            const node = nodes.get(nodeId);
+            if (!node?.capabilities.includes('camera.snap')) {
+                throw new Error('Node does not support camera.snap');
+            }
+            const result = await sendRequest(nodeId, 'camera.snap', {
+                camera: options.camera || 'back',
+                quality: options.quality || 80,
+            });
+            return {
+                ...result,
+                timestamp: new Date(),
+            };
+        },
+        async cameraRecord(nodeId, options = {}) {
+            const node = nodes.get(nodeId);
+            if (!node?.capabilities.includes('camera.record')) {
+                throw new Error('Node does not support camera.record');
+            }
+            const duration = options.duration || 5;
+            const timeout = (duration + 10) * 1000;
+            const result = await sendRequest(nodeId, 'camera.record', {
+                camera: options.camera || 'back',
+                duration,
+                quality: options.quality || 720,
+            }, timeout);
+            return {
+                ...result,
+                timestamp: new Date(),
+            };
+        },
+        async screenRecord(nodeId, options = {}) {
+            const node = nodes.get(nodeId);
+            if (!node?.capabilities.includes('screen.record')) {
+                throw new Error('Node does not support screen.record');
+            }
+            const duration = options.duration || 5;
+            const timeout = (duration + 10) * 1000;
+            const result = await sendRequest(nodeId, 'screen.record', {
+                duration,
+                quality: options.quality || 720,
+            }, timeout);
+            return {
+                ...result,
+                timestamp: new Date(),
+            };
+        },
+        async locationGet(nodeId) {
+            const node = nodes.get(nodeId);
+            if (!node?.capabilities.includes('location.get')) {
+                throw new Error('Node does not support location.get');
+            }
+            const result = await sendRequest(nodeId, 'location.get', {});
+            return {
+                ...result,
+                timestamp: new Date(),
+            };
+        },
+        async notificationSend(nodeId, options) {
+            const node = nodes.get(nodeId);
+            if (!node?.capabilities.includes('notification.send')) {
+                throw new Error('Node does not support notification.send');
+            }
+            await sendRequest(nodeId, 'notification.send', {
+                title: options.title,
+                body: options.body,
+                sound: options.sound ?? true,
+            });
+        },
+        async systemRun(nodeId, command, options = {}) {
+            const node = nodes.get(nodeId);
+            if (!node?.capabilities.includes('system.run')) {
+                throw new Error('Node does not support system.run');
+            }
+            if (node.type !== 'macos') {
+                throw new Error('system.run is only available on macOS nodes');
+            }
+            return sendRequest(nodeId, 'system.run', {
+                command,
+                needsScreenRecording: options.needsScreenRecording || false,
+            }, options.timeout || 60000);
+        },
+        async systemNotify(nodeId, options) {
+            const node = nodes.get(nodeId);
+            if (!node?.capabilities.includes('system.notify')) {
+                throw new Error('Node does not support system.notify');
+            }
+            await sendRequest(nodeId, 'system.notify', options);
+        },
+        async invoke(nodeId, action, params = {}) {
+            return sendRequest(nodeId, action, params);
+        },
+        registerNode(registration) {
+            const { ws, ...info } = registration;
+            const node = {
+                ...info,
+                ws,
+                connected: true,
+                connectedAt: new Date(),
+                lastSeen: new Date(),
+            };
+            nodes.set(info.id, node);
+            upsertKnownNode(node);
+            // Handle messages from node
+            ws.on('message', (data) => {
+                try {
+                    const msg = JSON.parse(data.toString());
+                    handleProtocolMessage(info.id, msg);
+                }
+                catch {
+                    // Ignore parse errors
+                }
+            });
+            ws.on('close', () => {
+                const n = nodes.get(info.id);
+                if (n) {
+                    n.connected = false;
+                    n.lastSeen = new Date();
+                    upsertKnownNode(n);
+                }
+                logger_1.logger.info({ nodeId: info.id }, 'Device node disconnected');
+            });
+            ws.on('error', (err) => {
+                logger_1.logger.error({ err, nodeId: info.id }, 'Device node error');
+            });
+            logger_1.logger.info({ nodeId: info.id, type: info.type, capabilities: info.capabilities }, 'Device node registered');
+            // Acknowledge registration using protocol message.
+            try {
+                ws.send(JSON.stringify({
+                    type: 'node.registered',
+                    version: 1,
+                    payload: { id: info.id, at: new Date().toISOString() },
+                }));
+            }
+            catch (error) {
+                logger_1.logger.warn({ error, nodeId: info.id }, 'Failed to send node.registered ack');
+            }
+        },
+        unregisterNode(nodeId) {
+            const node = nodes.get(nodeId);
+            if (node) {
+                node.connected = false;
+                node.lastSeen = new Date();
+                upsertKnownNode(node);
+                nodes.delete(nodeId);
+                logger_1.logger.info({ nodeId }, 'Device node unregistered');
+            }
+        },
+    };
+    return tool;
+}
+//# sourceMappingURL=nodes.js.map

package/dist/tools/nodes.js.map

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

package/dist/tools/sessions.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Session Tools - Clawdbot-style cross-session communication
+ *
+ * Tools:
+ * - sessions_list: List active sessions
+ * - sessions_history: Get session transcript
+ * - sessions_send: Send message to another session
+ * - sessions_spawn: Spawn a sub-agent session
+ */
+import type { SessionManager } from '../sessions/index';
+/** Session info for listing */
+export interface SessionInfo {
+    id: string;
+    key: string;
+    userId: string;
+    channel: string;
+    chatId: string;
+    chatType: 'dm' | 'group';
+    messageCount: number;
+    createdAt: Date;
+    lastActivity: Date;
+}
+/** History entry */
+export interface HistoryEntry {
+    role: 'user' | 'assistant';
+    content: string;
+    timestamp: number;
+}
+/** Send options */
+export interface SendOptions {
+    /** Wait for reply */
+    waitForReply?: boolean;
+    /** Timeout for reply in ms */
+    replyTimeout?: number;
+    /** Skip announcing the message source */
+    announceSkip?: boolean;
+    /** Skip waiting for reply */
+    replySkip?: boolean;
+}
+/** Send result */
+export interface SendResult {
+    success: boolean;
+    error?: string;
+    reply?: string;
+}
+export interface SessionTools {
+    /** List all active sessions */
+    list(): SessionInfo[];
+    /** Get history for a session */
+    history(sessionId: string, limit?: number): HistoryEntry[];
+    /** Send a message to another session */
+    send(targetSessionId: string, message: string, options?: SendOptions): Promise<SendResult>;
+    /** Get status of current session */
+    status(sessionId: string): SessionInfo | null;
+}
+export declare function createSessionTools(sessionManager: SessionManager, sendMessage: (sessionId: string, message: string, fromSessionId?: string) => Promise<string | null>): SessionTools;
+/**
+ * Format session list for display
+ */
+export declare function formatSessionList(sessions: SessionInfo[]): string;

package/dist/tools/sessions.js

@@ -0,0 +1,119 @@
+"use strict";
+/**
+ * Session Tools - Clawdbot-style cross-session communication
+ *
+ * Tools:
+ * - sessions_list: List active sessions
+ * - sessions_history: Get session transcript
+ * - sessions_send: Send message to another session
+ * - sessions_spawn: Spawn a sub-agent session
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSessionTools = createSessionTools;
+exports.formatSessionList = formatSessionList;
+const logger_1 = require("../utils/logger");
+function createSessionTools(sessionManager, sendMessage) {
+    // Track all sessions (sessionManager may not expose this directly)
+    const knownSessions = new Map();
+    return {
+        list() {
+            // In real implementation, would get from sessionManager
+            // For now, return known sessions
+            const sessions = [];
+            for (const session of knownSessions.values()) {
+                sessions.push({
+                    id: session.id,
+                    key: session.key,
+                    userId: session.userId,
+                    channel: session.channel,
+                    chatId: session.chatId,
+                    chatType: session.chatType,
+                    messageCount: session.context.messageCount,
+                    createdAt: session.createdAt,
+                    lastActivity: session.lastActivity,
+                });
+            }
+            return sessions;
+        },
+        history(sessionId, limit = 50) {
+            const session = knownSessions.get(sessionId);
+            if (!session) {
+                logger_1.logger.warn({ sessionId }, 'Session not found for history');
+                return [];
+            }
+            const history = session.history || session.context.conversationHistory || [];
+            const entries = history.slice(-limit).map((msg) => ({
+                role: msg.role,
+                content: msg.content,
+                timestamp: msg.timestamp,
+            }));
+            return entries;
+        },
+        async send(targetSessionId, message, options = {}) {
+            const session = knownSessions.get(targetSessionId);
+            if (!session) {
+                return {
+                    success: false,
+                    error: `Session not found: ${targetSessionId}`,
+                };
+            }
+            logger_1.logger.info({ targetSessionId, messageLength: message.length }, 'Sending cross-session message');
+            try {
+                // Format message with source info unless skipped
+                let formattedMessage = message;
+                if (!options.announceSkip) {
+                    formattedMessage = `[Cross-session message]\n\n${message}`;
+                }
+                // Send the message
+                const reply = await sendMessage(targetSessionId, formattedMessage);
+                // Wait for reply if requested
+                if (options.waitForReply && !options.replySkip) {
+                    return {
+                        success: true,
+                        reply: reply || undefined,
+                    };
+                }
+                return { success: true };
+            }
+            catch (error) {
+                logger_1.logger.error({ error, targetSessionId }, 'Cross-session send failed');
+                return {
+                    success: false,
+                    error: error instanceof Error ? error.message : 'Send failed',
+                };
+            }
+        },
+        status(sessionId) {
+            const session = knownSessions.get(sessionId);
+            if (!session)
+                return null;
+            return {
+                id: session.id,
+                key: session.key,
+                userId: session.userId,
+                channel: session.channel,
+                chatId: session.chatId,
+                chatType: session.chatType,
+                messageCount: session.context.messageCount,
+                createdAt: session.createdAt,
+                lastActivity: session.lastActivity,
+            };
+        },
+    };
+}
+/**
+ * Format session list for display
+ */
+function formatSessionList(sessions) {
+    if (sessions.length === 0) {
+        return 'No active sessions.';
+    }
+    const lines = ['**Active Sessions:**\n'];
+    for (const s of sessions) {
+        const ago = Math.floor((Date.now() - s.lastActivity.getTime()) / 60000);
+        lines.push(`• **${s.id.slice(0, 8)}** (${s.channel}/${s.chatType})`);
+        lines.push(`  User: ${s.userId.slice(0, 20)}, Messages: ${s.messageCount}, Last: ${ago}m ago`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=sessions.js.map

package/dist/tools/sessions.js.map

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

package/dist/tools/shell-history.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Shell History Tool - read/search shell history safely
+ */
+export interface ShellHistoryEntry {
+    line: number;
+    command: string;
+}
+export interface ShellHistoryOptions {
+    shell?: 'zsh' | 'bash' | 'fish' | 'auto';
+    limit?: number;
+    query?: string | RegExp;
+}
+export interface ShellHistoryTool {
+    list(options?: ShellHistoryOptions): ShellHistoryEntry[];
+    search(query: string | RegExp, options?: Omit<ShellHistoryOptions, 'query'>): ShellHistoryEntry[];
+}
+export declare function createShellHistoryTool(): ShellHistoryTool;