@onesclawkolor/onesclaw 0.1.0

package/dist/tools/shell.js

@@ -0,0 +1,174 @@
+import { spawn } from 'node:child_process';
+import { appendFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { getLogsDir } from '../config/manager.js';
+import { getSessionId, nextCommandId, nextTraceId } from '../audit/ids.js';
+import { isHighRiskCommand, requireConfirmationError } from './safety.js';
+import { consumeForHighRisk, requireConfirmationProofError, } from './confirmation.js';
+const MAX_OUTPUT_LENGTH = 10000;
+const KEEP_LENGTH = 5000;
+const DEFAULT_TIMEOUT_SECONDS = 60;
+/**
+ * 写入 Shell 执行日志到 ~/.onesclaw/logs/shell.log
+ */
+function logShellExecution(command, exitCode, durationMs, confirmed, proofStatus, traceId, commandId) {
+    try {
+        const logsDir = getLogsDir();
+        mkdirSync(logsDir, { recursive: true });
+        const logPath = join(logsDir, 'shell.log');
+        const entry = {
+            time: new Date().toISOString(),
+            source: 'shell',
+            session_id: getSessionId(),
+            trace_id: traceId,
+            command_id: commandId,
+            command,
+            exit_code: exitCode,
+            duration_ms: durationMs,
+            confirmed,
+            proof_status: proofStatus,
+        };
+        const line = JSON.stringify(entry) + '\n';
+        appendFileSync(logPath, line, 'utf-8');
+    }
+    catch {
+        // 日志写入失败不影响命令执行
+    }
+}
+/**
+ * 截断过长的输出
+ * 超过 MAX_OUTPUT_LENGTH 时保留前后各 KEEP_LENGTH 字符
+ */
+export function truncateOutput(output) {
+    if (output.length <= MAX_OUTPUT_LENGTH) {
+        return output;
+    }
+    const head = output.slice(0, KEEP_LENGTH);
+    const tail = output.slice(-KEEP_LENGTH);
+    return `${head}\n\n[... 输出已截断，共 ${output.length} 字符 ...]\n\n${tail}`;
+}
+export function shouldBlockCommand(command, confirmed = false) {
+    return isHighRiskCommand(command) && !confirmed;
+}
+/**
+ * 执行 Shell 命令
+ */
+function executeCommand(command, timeoutSeconds, confirmed, proofStatus, traceId, commandId) {
+    return new Promise((resolve) => {
+        const startTime = Date.now();
+        let output = '';
+        let finished = false;
+        let timedOut = false;
+        const child = spawn(command, {
+            shell: true,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        // 合并 stdout 和 stderr
+        child.stdout?.on('data', (data) => {
+            output += data.toString();
+        });
+        child.stderr?.on('data', (data) => {
+            output += data.toString();
+        });
+        // 超时处理
+        const timer = setTimeout(() => {
+            if (!finished) {
+                timedOut = true;
+                child.kill('SIGTERM');
+            }
+        }, timeoutSeconds * 1000);
+        child.on('close', (exitCode) => {
+            finished = true;
+            clearTimeout(timer);
+            const durationMs = Date.now() - startTime;
+            logShellExecution(command, exitCode, durationMs, confirmed, proofStatus, traceId, commandId);
+            if (timedOut) {
+                const partialOutput = truncateOutput(output);
+                resolve({
+                    content: `命令执行超时（${timeoutSeconds}秒）\n\n已收集的部分输出：\n${partialOutput}`,
+                    isError: true,
+                });
+                return;
+            }
+            const truncated = truncateOutput(output);
+            if (exitCode === 0) {
+                resolve({
+                    content: truncated || '(命令执行成功，无输出)',
+                });
+            }
+            else {
+                resolve({
+                    content: `命令退出码: ${exitCode}\n\n${truncated}`,
+                    isError: true,
+                });
+            }
+        });
+        child.on('error', (error) => {
+            finished = true;
+            clearTimeout(timer);
+            const durationMs = Date.now() - startTime;
+            logShellExecution(command, null, durationMs, confirmed, proofStatus, traceId, commandId);
+            resolve({
+                content: `命令执行失败: ${error.message}`,
+                isError: true,
+            });
+        });
+    });
+}
+/**
+ * 创建 Shell 命令执行工具
+ */
+export function createShellTool() {
+    const tool = {
+        name: 'execute_command',
+        description: '在本地执行 Shell 命令。用于文件操作、环境检测、脚本执行等本地任务。检测到高危命令时必须先 ask_user 确认，并传入 confirmed=true。',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                command: {
+                    type: 'string',
+                    description: '要执行的完整 Shell 命令',
+                },
+                timeout: {
+                    type: 'number',
+                    description: '超时时间（秒），默认 60 秒',
+                },
+                confirmed: {
+                    type: 'boolean',
+                    description: '高危命令是否已获得用户明确确认（默认 false）',
+                },
+            },
+            required: ['command'],
+        },
+        execute: async (args) => {
+            const command = String(args.command || '');
+            const confirmed = args.confirmed === true;
+            const highRisk = isHighRiskCommand(command);
+            const traceId = nextTraceId();
+            const commandId = nextCommandId('shell');
+            if (highRisk && !confirmed) {
+                logShellExecution(command, null, 0, confirmed, 'blocked_unconfirmed', traceId, commandId);
+                return {
+                    content: requireConfirmationError(command),
+                    isError: true,
+                };
+            }
+            if (highRisk && confirmed) {
+                const proof = consumeForHighRisk(command);
+                if (!proof.ok) {
+                    logShellExecution(command, null, 0, confirmed, `blocked_${proof.status}`, traceId, commandId);
+                    return {
+                        content: requireConfirmationProofError(command, proof.status),
+                        isError: true,
+                    };
+                }
+            }
+            const timeout = typeof args.timeout === 'number'
+                ? args.timeout
+                : DEFAULT_TIMEOUT_SECONDS;
+            return executeCommand(command, timeout, confirmed, highRisk ? 'validated' : 'not_required', traceId, commandId);
+        },
+    };
+    return tool;
+}
+//# sourceMappingURL=shell.js.map

package/dist/tools/shell.js.map

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

package/dist/tools/skills-sync.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 创建 skills_sync 工具
+ * 使 LLM 能够通过自然语言触发 Skills 远程同步
+ */
+export declare function createSkillsSyncTool(): {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {};
+    };
+    execute: () => Promise<{
+        content: string;
+        isError: boolean;
+    } | {
+        content: string;
+        isError?: undefined;
+    }>;
+};

package/dist/tools/skills-sync.js

@@ -0,0 +1,29 @@
+// @ts-nocheck
+import { loadConfig } from '../config/manager.js';
+import { syncSkills } from '../skills/sync.js';
+/**
+ * 创建 skills_sync 工具
+ * 使 LLM 能够通过自然语言触发 Skills 远程同步
+ */
+export function createSkillsSyncTool() {
+    return {
+        name: 'skills_sync',
+        description: '同步远程 Skills 仓库到本地。从 Git 仓库拉取最新的技能定义和执行步骤。',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+        execute: async () => {
+            const config = await loadConfig();
+            if (!config) {
+                return { content: '配置文件加载失败，请先运行 onesclaw init 初始化', isError: true };
+            }
+            const result = await syncSkills(config);
+            if (result.success) {
+                return { content: `Skills 同步成功，共 ${result.skillCount ?? 0} 个技能。注意：当前会话的技能列表将在下次启动时更新。` };
+            }
+            return { content: `Skills 同步失败: ${result.error}`, isError: true };
+        },
+    };
+}
+//# sourceMappingURL=skills-sync.js.map

package/dist/tools/skills-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-sync.js","sourceRoot":"","sources":["../../src/tools/skills-sync.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAChC,OAAO;QACH,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,2CAA2C;QACxD,WAAW,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACjB;QACD,OAAO,EAAE,KAAK,IAAI,EAAE;YAChB,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;YAClC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACV,OAAO,EAAE,OAAO,EAAE,iCAAiC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACzE,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;YACxC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACjB,OAAO,EAAE,OAAO,EAAE,iBAAiB,MAAM,CAAC,UAAU,IAAI,CAAC,6BAA6B,EAAE,CAAC;YAC7F,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,gBAAgB,MAAM,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACtE,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/tools/ssh.d.ts

@@ -0,0 +1,62 @@
+/**
+ * SSH 连接池，复用同一 host 的连接
+ */
+export declare class SSHConnectionPool {
+    connections: Map<any, any>;
+    /**
+     * 生成连接缓存 key
+     */
+    getKey(server: any): string;
+    /**
+     * 获取连接（存在且可用则复用，否则创建新连接）
+     */
+    getConnection(server: any): Promise<any>;
+    /**
+     * 创建新 SSH 连接
+     */
+    createConnection(server: any): Promise<unknown>;
+    /**
+     * 关闭所有连接
+     */
+    closeAll(): Promise<void>;
+}
+/**
+ * 创建 SSH 远程执行工具
+ */
+export declare function createSSHTool(pool: any): {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            host: {
+                type: string;
+                description: string;
+            };
+            command: {
+                type: string;
+                description: string;
+            };
+            user: {
+                type: string;
+                description: string;
+            };
+            tty: {
+                type: string;
+                description: string;
+            };
+            confirmed: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute: (args: any) => Promise<{
+        content: string;
+        isError: boolean;
+    } | {
+        content: string;
+        isError?: undefined;
+    }>;
+};

package/dist/tools/ssh.js

@@ -0,0 +1,343 @@
+// @ts-nocheck
+import { Client } from 'ssh2';
+import { readFileSync, existsSync, appendFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { loadServers, getLogsDir } from '../config/manager.js';
+import { truncateOutput } from './shell.js';
+import { getSessionId, nextCommandId, nextTraceId } from '../audit/ids.js';
+import { isHighRiskCommand, requireConfirmationError } from './safety.js';
+import { consumeForHighRisk, requireConfirmationProofError, } from './confirmation.js';
+const DEFAULT_TIMEOUT_SECONDS = 60;
+const DEFAULT_SSH_PORT = 22;
+const DEFAULT_SSH_USER = 'root';
+const DEFAULT_KEY_PATH = '~/.ssh/id_rsa';
+/**
+ * 展开路径中的 ~ 为 home 目录
+ */
+function expandPath(p) {
+    if (p.startsWith('~/') || p === '~') {
+        return join(homedir(), p.slice(1));
+    }
+    return p;
+}
+/**
+ * 写入 SSH 执行日志到 ~/.onesclaw/logs/ssh.log
+ */
+function logSSHExecution(host, user, port, command, exitCode, durationMs, confirmed, proofStatus, traceId, commandId) {
+    try {
+        const logsDir = getLogsDir();
+        mkdirSync(logsDir, { recursive: true });
+        const logPath = join(logsDir, 'ssh.log');
+        const line = JSON.stringify({
+            time: new Date().toISOString(),
+            source: 'ssh',
+            session_id: getSessionId(),
+            trace_id: traceId,
+            command_id: commandId,
+            command,
+            user,
+            host,
+            port,
+            exit_code: exitCode,
+            duration_ms: durationMs,
+            confirmed,
+            proof_status: proofStatus,
+        }) + '\n';
+        appendFileSync(logPath, line, 'utf-8');
+    }
+    catch {
+        // 日志写入失败不影响命令执行
+    }
+}
+/**
+ * 解析主机名或 IP，从 servers.json 查找匹配的服务器配置
+ */
+async function resolveHost(hostOrName, userOverride) {
+    const config = await loadServers();
+    // 查找匹配的服务器名称
+    const server = config.servers.find((s) => s.name === hostOrName);
+    if (server) {
+        return {
+            host: server.host,
+            port: server.port || DEFAULT_SSH_PORT,
+            user: userOverride || server.user || DEFAULT_SSH_USER,
+            authType: server.auth_type || 'ssh-key',
+            identityFile: server.identity_file || DEFAULT_KEY_PATH,
+            password: server.password,
+        };
+    }
+    // 未找到则视为 IP 地址，使用默认配置
+    return {
+        host: hostOrName,
+        port: DEFAULT_SSH_PORT,
+        user: userOverride || DEFAULT_SSH_USER,
+        authType: 'ssh-key',
+        identityFile: DEFAULT_KEY_PATH,
+    };
+}
+/**
+ * SSH 连接池，复用同一 host 的连接
+ */
+export class SSHConnectionPool {
+    connections = new Map();
+    /**
+     * 生成连接缓存 key
+     */
+    getKey(server) {
+        return `${server.user}@${server.host}:${server.port}`;
+    }
+    /**
+     * 获取连接（存在且可用则复用，否则创建新连接）
+     */
+    async getConnection(server) {
+        const key = this.getKey(server);
+        const existing = this.connections.get(key);
+        // 检查缓存的连接是否仍然可用
+        if (existing) {
+            // ssh2 Client 没有显式 isConnected 属性，
+            // 如果连接断开会在 close 事件中被移除
+            return existing;
+        }
+        // 创建新连接
+        const client = await this.createConnection(server);
+        // 连接断开时自动从缓存移除
+        client.on('close', () => {
+            this.connections.delete(key);
+        });
+        client.on('error', () => {
+            this.connections.delete(key);
+        });
+        this.connections.set(key, client);
+        return client;
+    }
+    /**
+     * 创建新 SSH 连接
+     */
+    createConnection(server) {
+        return new Promise((resolve, reject) => {
+            const client = new Client();
+            // 构建认证选项
+            const connectOptions = {
+                host: server.host,
+                port: server.port,
+                username: server.user,
+            };
+            if (server.authType === 'password' && server.password) {
+                // 密码认证
+                connectOptions.password = server.password;
+            }
+            else {
+                // SSH Key 认证：密钥文件 → SSH Agent
+                const keyPath = expandPath(server.identityFile);
+                if (existsSync(keyPath)) {
+                    try {
+                        connectOptions.privateKey = readFileSync(keyPath);
+                    }
+                    catch {
+                        // 密钥读取失败，尝试 Agent
+                    }
+                }
+                // SSH Agent 作为回退
+                if (!connectOptions.privateKey && process.env.SSH_AUTH_SOCK) {
+                    connectOptions.agent = process.env.SSH_AUTH_SOCK;
+                }
+                // 如果既无密钥也无 Agent，报错
+                if (!connectOptions.privateKey && !connectOptions.agent) {
+                    reject(new Error(`SSH 认证失败：密钥文件 ${keyPath} 不存在，且未检测到 SSH Agent`));
+                    return;
+                }
+            }
+            client.on('ready', () => resolve(client));
+            client.on('error', (err) => {
+                reject(new Error(`SSH 连接失败 (${server.host}): ${err.message}`));
+            });
+            client.connect(connectOptions);
+        });
+    }
+    /**
+     * 关闭所有连接
+     */
+    async closeAll() {
+        for (const [key, client] of this.connections) {
+            try {
+                client.end();
+            }
+            catch {
+                // 忽略关闭错误
+            }
+            this.connections.delete(key);
+        }
+    }
+}
+/**
+ * 在远程服务器执行命令
+ */
+function sshExecute(client, command, options) {
+    const timeoutSeconds = options.timeout || DEFAULT_TIMEOUT_SECONDS;
+    return new Promise((resolve, reject) => {
+        let output = '';
+        let finished = false;
+        let timedOut = false;
+        const execOptions = options.tty ? { pty: true } : {};
+        client.exec(command, execOptions, (err, stream) => {
+            if (err) {
+                reject(new Error(`SSH 命令执行失败: ${err.message}`));
+                return;
+            }
+            // 超时处理
+            const timer = setTimeout(() => {
+                if (!finished) {
+                    timedOut = true;
+                    stream.close();
+                }
+            }, timeoutSeconds * 1000);
+            // 收集输出
+            stream.on('data', (data) => {
+                output += data.toString();
+            });
+            stream.stderr?.on('data', (data) => {
+                output += data.toString();
+            });
+            stream.on('close', (code) => {
+                finished = true;
+                clearTimeout(timer);
+                if (timedOut) {
+                    resolve({ output, exitCode: null });
+                }
+                else {
+                    resolve({ output, exitCode: code });
+                }
+            });
+            stream.on('error', (streamErr) => {
+                finished = true;
+                clearTimeout(timer);
+                reject(new Error(`SSH 命令流错误: ${streamErr.message}`));
+            });
+        });
+    });
+}
+/**
+ * 创建 SSH 远程执行工具
+ */
+export function createSSHTool(pool) {
+    return {
+        name: 'ssh_execute',
+        description: '通过 SSH 在远程服务器上执行命令。支持通过 IP 地址或预配置的服务器名称连接。检测到高危命令时必须先 ask_user 确认，并传入 confirmed=true。',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                host: {
+                    type: 'string',
+                    description: '目标服务器地址（IP 或在 servers.json 中配置的服务器名称）',
+                },
+                command: {
+                    type: 'string',
+                    description: '要在远程服务器上执行的命令',
+                },
+                user: {
+                    type: 'string',
+                    description: '登录用户名，默认 root',
+                },
+                tty: {
+                    type: 'boolean',
+                    description: '是否分配 TTY（某些交互式命令需要），默认 false',
+                },
+                confirmed: {
+                    type: 'boolean',
+                    description: '高危命令是否已获得用户明确确认（默认 false）',
+                },
+            },
+            required: ['host', 'command'],
+        },
+        execute: async (args) => {
+            const hostOrName = args.host;
+            const command = args.command;
+            const confirmed = args.confirmed === true;
+            const userOverride = args.user;
+            const tty = args.tty || false;
+            const traceId = nextTraceId();
+            const commandId = nextCommandId('ssh');
+            const startTime = Date.now();
+            const highRisk = isHighRiskCommand(command);
+            if (highRisk && !confirmed) {
+                logSSHExecution(hostOrName, userOverride || '-', DEFAULT_SSH_PORT, command, null, 0, confirmed, 'blocked_unconfirmed', traceId, commandId);
+                return {
+                    content: requireConfirmationError(command),
+                    isError: true,
+                };
+            }
+            if (highRisk && confirmed) {
+                const proof = consumeForHighRisk(command);
+                if (!proof.ok) {
+                    logSSHExecution(hostOrName, userOverride || '-', DEFAULT_SSH_PORT, command, null, 0, confirmed, `blocked_${proof.status}`, traceId, commandId);
+                    return {
+                        content: requireConfirmationProofError(command, proof.status),
+                        isError: true,
+                    };
+                }
+            }
+            const proofStatus = highRisk ? 'validated' : 'not_required';
+            // 1. 解析服务器信息
+            let server;
+            try {
+                server = await resolveHost(hostOrName, userOverride);
+            }
+            catch (error) {
+                return {
+                    content: `服务器解析失败: ${error instanceof Error ? error.message : String(error)}`,
+                    isError: true,
+                };
+            }
+            // 2. 获取连接
+            let client;
+            try {
+                client = await pool.getConnection(server);
+            }
+            catch (error) {
+                const durationMs = Date.now() - startTime;
+                logSSHExecution(server.host, server.user, server.port, command, null, durationMs, confirmed, proofStatus, traceId, commandId);
+                const msg = error instanceof Error ? error.message : String(error);
+                return {
+                    content: `[致命错误] ${msg}\n无法连接到目标服务器，请立即停止当前任务。`,
+                    isError: true,
+                };
+            }
+            // 3. 执行命令
+            try {
+                const result = await sshExecute(client, command, { tty });
+                const durationMs = Date.now() - startTime;
+                logSSHExecution(server.host, server.user, server.port, command, result.exitCode, durationMs, confirmed, proofStatus, traceId, commandId);
+                // 超时情况
+                if (result.exitCode === null && result.output !== undefined) {
+                    const partialOutput = truncateOutput(result.output);
+                    return {
+                        content: `命令执行超时（${DEFAULT_TIMEOUT_SECONDS}秒）\n\n已收集的部分输出：\n${partialOutput}`,
+                        isError: true,
+                    };
+                }
+                const truncated = truncateOutput(result.output);
+                if (result.exitCode === 0) {
+                    return {
+                        content: truncated || '(命令执行成功，无输出)',
+                    };
+                }
+                return {
+                    content: `命令退出码: ${result.exitCode}\n\n${truncated}`,
+                    isError: true,
+                };
+            }
+            catch (error) {
+                const durationMs = Date.now() - startTime;
+                logSSHExecution(server.host, server.user, server.port, command, null, durationMs, confirmed, proofStatus, traceId, commandId);
+                // 连接可能已断开，从池中移除以便下次重连
+                pool['connections'].delete(`${server.user}@${server.host}:${server.port}`);
+                return {
+                    content: error instanceof Error ? error.message : String(error),
+                    isError: true,
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=ssh.js.map

package/dist/tools/ssh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh.js","sourceRoot":"","sources":["../../src/tools/ssh.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC9E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EACL,kBAAkB,EAClB,6BAA6B,GAC9B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,uBAAuB,GAAG,EAAE,CAAC;AACnC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAC5B,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAChC,MAAM,gBAAgB,GAAG,eAAe,CAAC;AAEzC;;GAEG;AACH,SAAS,UAAU,CAAC,CAAC;IACnB,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS;IAClH,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;QAC7B,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;YAC1B,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC9B,MAAM,EAAE,KAAK;YACb,UAAU,EAAE,YAAY,EAAE;YAC1B,QAAQ,EAAE,OAAO;YACjB,UAAU,EAAE,SAAS;YACrB,OAAO;YACP,IAAI;YACJ,IAAI;YACJ,IAAI;YACJ,SAAS,EAAE,QAAQ;YACnB,WAAW,EAAE,UAAU;YACvB,SAAS;YACT,YAAY,EAAE,WAAW;SAC1B,CAAC,GAAG,IAAI,CAAC;QACV,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,gBAAgB;IAClB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,WAAW,CAAC,UAAU,EAAE,YAAY;IACjD,MAAM,MAAM,GAAG,MAAM,WAAW,EAAE,CAAC;IACnC,aAAa;IACb,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;IACjE,IAAI,MAAM,EAAE,CAAC;QACX,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,gBAAgB;YACrC,IAAI,EAAE,YAAY,IAAI,MAAM,CAAC,IAAI,IAAI,gBAAgB;YACrD,QAAQ,EAAE,MAAM,CAAC,SAAS,IAAI,SAAS;YACvC,YAAY,EAAE,MAAM,CAAC,aAAa,IAAI,gBAAgB;YACtD,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC;IACJ,CAAC;IAED,sBAAsB;IACtB,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,YAAY,IAAI,gBAAgB;QACtC,QAAQ,EAAE,SAAS;QACnB,YAAY,EAAE,gBAAgB;KAC/B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,iBAAiB;IAC5B,WAAW,GAAG,IAAI,GAAG,EAAE,CAAC;IAExB;;OAEG;IACH,MAAM,CAAC,MAAM;QACX,OAAO,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,MAAM;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAE3C,gBAAgB;QAChB,IAAI,QAAQ,EAAE,CAAC;YACb,mCAAmC;YACnC,wBAAwB;YACxB,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,QAAQ;QACR,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAEnD,eAAe;QACf,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAClC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,MAAM;QACrB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YAE5B,SAAS;YACT,MAAM,cAAc,GAAG;gBACrB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,QAAQ,EAAE,MAAM,CAAC,IAAI;aACtB,CAAC;YAEF,IAAI,MAAM,CAAC,QAAQ,KAAK,UAAU,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACtD,OAAO;gBACP,cAAc,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;YAC5C,CAAC;iBAAM,CAAC;gBACN,8BAA8B;gBAC9B,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;gBAChD,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;oBACxB,IAAI,CAAC;wBACH,cAAc,CAAC,UAAU,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;oBACpD,CAAC;oBAAC,MAAM,CAAC;wBACP,kBAAkB;oBACpB,CAAC;gBACH,CAAC;gBAED,iBAAiB;gBACjB,IAAI,CAAC,cAAc,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;oBAC5D,cAAc,CAAC,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;gBACnD,CAAC;gBAED,oBAAoB;gBACpB,IAAI,CAAC,cAAc,CAAC,UAAU,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;oBACxD,MAAM,CAAC,IAAI,KAAK,CAAC,iBAAiB,OAAO,sBAAsB,CAAC,CAAC,CAAC;oBAClE,OAAO;gBACT,CAAC;YACH,CAAC;YAED,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;YAC1C,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACzB,MAAM,CAAC,IAAI,KAAK,CAAC,aAAa,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACjE,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC7C,IAAI,CAAC;gBACH,MAAM,CAAC,GAAG,EAAE,CAAC;YACf,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YACD,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,SAAS,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO;IAC1C,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,IAAI,uBAAuB,CAAC;IAElE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,QAAQ,GAAG,KAAK,CAAC;QAErB,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAErD,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;YAChD,IAAI,GAAG,EAAE,CAAC;gBACR,MAAM,CAAC,IAAI,KAAK,CAAC,eAAe,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBAChD,OAAO;YACT,CAAC;YAED,OAAO;YACP,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,QAAQ,GAAG,IAAI,CAAC;oBAChB,MAAM,CAAC,KAAK,EAAE,CAAC;gBACjB,CAAC;YACH,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC,CAAC;YAE1B,OAAO;YACP,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;gBACzB,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC5B,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;gBACjC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC5B,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBAC1B,QAAQ,GAAG,IAAI,CAAC;gBAChB,YAAY,CAAC,KAAK,CAAC,CAAC;gBAEpB,IAAI,QAAQ,EAAE,CAAC;oBACb,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;gBACtC,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;gBACtC,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,EAAE;gBAC/B,QAAQ,GAAG,IAAI,CAAC;gBAChB,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,MAAM,CAAC,IAAI,KAAK,CAAC,cAAc,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACvD,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAI;IAChC,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,uFAAuF;QACpG,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,uCAAuC;iBACrD;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,eAAe;iBAC7B;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,eAAe;iBAC7B;gBACD,GAAG,EAAE;oBACH,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,8BAA8B;iBAC5C;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,2BAA2B;iBACzC;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;SAC9B;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC;YAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC;YAC1C,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC;YAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC;YAC9B,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;YAC9B,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;YACvC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAE7B,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;YAC5C,IAAI,QAAQ,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC3B,eAAe,CACb,UAAU,EACV,YAAY,IAAI,GAAG,EACnB,gBAAgB,EAChB,OAAO,EACP,IAAI,EACJ,CAAC,EACD,SAAS,EACT,qBAAqB,EACrB,OAAO,EACP,SAAS,CACV,CAAC;gBACF,OAAO;oBACL,OAAO,EAAE,wBAAwB,CAAC,OAAO,CAAC;oBAC1C,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,IAAI,QAAQ,IAAI,SAAS,EAAE,CAAC;gBAC1B,MAAM,KAAK,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;gBAC1C,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;oBACd,eAAe,CACb,UAAU,EACV,YAAY,IAAI,GAAG,EACnB,gBAAgB,EAChB,OAAO,EACP,IAAI,EACJ,CAAC,EACD,SAAS,EACT,WAAW,KAAK,CAAC,MAAM,EAAE,EACzB,OAAO,EACP,SAAS,CACV,CAAC;oBACF,OAAO;wBACL,OAAO,EAAE,6BAA6B,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC;wBAC7D,OAAO,EAAE,IAAI;qBACd,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,MAAM,WAAW,GAAG,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC;YAE5D,aAAa;YACb,IAAI,MAAM,CAAC;YACX,IAAI,CAAC;gBACH,MAAM,GAAG,MAAM,WAAW,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;YACvD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO;oBACL,OAAO,EAAE,YAAY,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;oBAC7E,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,UAAU;YACV,IAAI,MAAM,CAAC;YACX,IAAI,CAAC;gBACH,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YAC5C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;gBAC1C,eAAe,CACb,MAAM,CAAC,IAAI,EACX,MAAM,CAAC,IAAI,EACX,MAAM,CAAC,IAAI,EACX,OAAO,EACP,IAAI,EACJ,UAAU,EACV,SAAS,EACT,WAAW,EACX,OAAO,EACP,SAAS,CACV,CAAC;gBACF,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACnE,OAAO;oBACL,OAAO,EAAE,UAAU,GAAG,yBAAyB;oBAC/C,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,UAAU;YACV,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;gBAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;gBAC1C,eAAe,CACb,MAAM,CAAC,IAAI,EACX,MAAM,CAAC,IAAI,EACX,MAAM,CAAC,IAAI,EACX,OAAO,EACP,MAAM,CAAC,QAAQ,EACf,UAAU,EACV,SAAS,EACT,WAAW,EACX,OAAO,EACP,SAAS,CACV,CAAC;gBAEF,OAAO;gBACP,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;oBAC5D,MAAM,aAAa,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;oBACpD,OAAO;wBACL,OAAO,EAAE,UAAU,uBAAuB,oBAAoB,aAAa,EAAE;wBAC7E,OAAO,EAAE,IAAI;qBACd,CAAC;gBACJ,CAAC;gBAED,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAChD,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;oBAC1B,OAAO;wBACL,OAAO,EAAE,SAAS,IAAI,cAAc;qBACrC,CAAC;gBACJ,CAAC;gBAED,OAAO;oBACL,OAAO,EAAE,UAAU,MAAM,CAAC,QAAQ,OAAO,SAAS,EAAE;oBACpD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;gBAC1C,eAAe,CACb,MAAM,CAAC,IAAI,EACX,MAAM,CAAC,IAAI,EACX,MAAM,CAAC,IAAI,EACX,OAAO,EACP,IAAI,EACJ,UAAU,EACV,SAAS,EACT,WAAW,EACX,OAAO,EACP,SAAS,CACV,CAAC;gBAEF,sBAAsB;gBACtB,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;gBAE3E,OAAO;oBACL,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;oBAC/D,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/types.d.ts

@@ -0,0 +1,10 @@
+export interface ToolResult {
+    content: string;
+    isError?: boolean;
+}
+export interface Tool {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    execute(args: Record<string, unknown>): Promise<ToolResult>;
+}