@ai-setting/roy-agent-cli 1.3.19 → 1.3.22

package/dist/core/src/env/tool/built-in/read-file.js

@@ -1,73 +0,0 @@
-import { z } from "zod";
-import { readFile } from "fs/promises";
-/**
- * 读取文件工具
- */
-export const readFileTool = {
-    name: "read_file",
-    description: "Read the contents of a file. Use this to read source code, configuration files, or any text files.",
-    parameters: z.object({
-        path: z.string().describe("The file path to read"),
-        offset: z.number().int().nonnegative().optional().describe("Line offset to start reading from"),
-        limit: z.number().int().positive().optional().describe("Number of lines to read"),
-        encoding: z.enum(["utf-8", "base64"]).default("utf-8").optional().describe("File encoding"),
-    }),
-    sandbox: {
-        enabled: true,
-        config: {
-            filesystem: {
-                denyRead: ["/etc/shadow", "/etc/sudoers", "/root/.ssh"],
-            },
-        },
-    },
-    permission: {
-        level: "safe",
-    },
-    metadata: {
-        category: "file",
-        tags: ["read", "file", "io"],
-        version: "1.0.0",
-    },
-    execute: async (args, ctx) => {
-        const startTime = Date.now();
-        const { path: filePath, offset, limit, encoding = "utf-8" } = args;
-        try {
-            const content = await readFile(filePath, encoding);
-            // 如果是二进制或指定了 offset/limit，需要特殊处理
-            let output;
-            const contentBuffer = content;
-            const contentStr = typeof contentBuffer === "string"
-                ? contentBuffer
-                : contentBuffer.toString(encoding);
-            if (offset !== undefined || limit !== undefined) {
-                const lines = contentStr.split("\n");
-                const startLine = offset || 0;
-                const endLine = limit ? startLine + limit : lines.length;
-                output = lines.slice(startLine, endLine).join("\n");
-            }
-            else {
-                output = contentStr;
-            }
-            return {
-                success: true,
-                output,
-                metadata: {
-                    execution_time_ms: Date.now() - startTime,
-                    output_size: output.length,
-                    file_path: filePath,
-                },
-            };
-        }
-        catch (error) {
-            return {
-                success: false,
-                output: "",
-                error: error instanceof Error ? error.message : String(error),
-                metadata: {
-                    execution_time_ms: Date.now() - startTime,
-                },
-            };
-        }
-    },
-};
-//# sourceMappingURL=read-file.js.map

package/dist/core/src/env/tool/built-in/read-file.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=read-file.test.d.ts.map

package/dist/core/src/env/tool/built-in/read-file.test.js

@@ -1,63 +0,0 @@
-import { describe, test, expect, beforeEach } from "bun:test";
-import { readFileTool } from "./read-file.js";
-import { writeFile, mkdir } from "fs/promises";
-import { join } from "path";
-describe("readFileTool", () => {
-    const testDir = join("/tmp", `read-test-${Date.now()}`);
-    const testFile = join(testDir, "test.txt");
-    const multiLineFile = join(testDir, "multi.txt");
-    beforeEach(async () => {
-        await mkdir(testDir, { recursive: true });
-        await writeFile(testFile, "Hello, World!");
-        await writeFile(multiLineFile, "Line 1\nLine 2\nLine 3\nLine 4\nLine 5");
-    });
-    describe("parameters", () => {
-        test("should validate path parameter", async () => {
-            const result = await readFileTool.execute({ path: testFile }, {});
-            expect(result.success).toBe(true);
-            expect(result.output).toBe("Hello, World!");
-        });
-        test("should handle missing path gracefully", async () => {
-            // Zod 会使用 undefined 值执行，可能导致文件系统错误而不是验证错误
-            const result = await readFileTool.execute({}, {});
-            expect(result).toBeDefined();
-        });
-    });
-    describe("execution", () => {
-        test("should read file content", async () => {
-            const result = await readFileTool.execute({ path: testFile }, {});
-            expect(result.success).toBe(true);
-            expect(result.output).toBe("Hello, World!");
-        });
-        test("should read with offset and limit", async () => {
-            const result = await readFileTool.execute({ path: multiLineFile, offset: 1, limit: 2 }, {});
-            expect(result.success).toBe(true);
-            expect(result.output).toBe("Line 2\nLine 3");
-        });
-        test("should return error for non-existent file", async () => {
-            const result = await readFileTool.execute({ path: join(testDir, "non-existent.txt") }, {});
-            expect(result.success).toBe(false);
-            expect(result.error).toBeDefined();
-        });
-        test("should include metadata", async () => {
-            const result = await readFileTool.execute({ path: testFile }, {});
-            expect(result.metadata?.execution_time_ms).toBeDefined();
-            expect(result.metadata?.output_size).toBeDefined();
-            expect(result.metadata?.file_path).toBe(testFile);
-        });
-    });
-    describe("metadata", () => {
-        test("should have correct metadata", () => {
-            expect(readFileTool.name).toBe("read_file");
-            expect(readFileTool.metadata?.category).toBe("file");
-            expect(readFileTool.metadata?.tags).toContain("read");
-        });
-        test("should have sandbox config", () => {
-            expect(readFileTool.sandbox?.enabled).toBe(true);
-        });
-        test("should be safe permission", () => {
-            expect(readFileTool.permission?.level).toBe("safe");
-        });
-    });
-});
-//# sourceMappingURL=read-file.test.js.map

package/dist/core/src/env/tool/built-in/write-file.d.ts

@@ -1,6 +0,0 @@
-import type { Tool } from "../types";
-/**
- * 写入文件工具
- */
-export declare const writeFileTool: Tool;
-//# sourceMappingURL=write-file.d.ts.map

package/dist/core/src/env/tool/built-in/write-file.js

@@ -1,65 +0,0 @@
-import { z } from "zod";
-import { writeFile, mkdir } from "fs/promises";
-import { dirname } from "path";
-/**
- * 写入文件工具
- */
-export const writeFileTool = {
-    name: "write_file",
-    description: "Write content to a file. Use this to create new files or overwrite existing ones.",
-    parameters: z.object({
-        path: z.string().describe("The file path to write to"),
-        content: z.string().describe("The content to write"),
-        createDirs: z.boolean().default(false).optional().describe("Create parent directories if they don't exist"),
-        append: z.boolean().default(false).optional().describe("Append to file instead of overwrite"),
-    }),
-    sandbox: {
-        enabled: true,
-        config: {
-            filesystem: {
-                denyWrite: ["/etc", "/usr", "/bin", "/sbin", "/boot", "/sys"],
-            },
-        },
-    },
-    permission: {
-        requireConfirmation: true,
-        level: "dangerous",
-    },
-    metadata: {
-        category: "file",
-        tags: ["write", "file", "io", "create"],
-        version: "1.0.0",
-    },
-    execute: async (args, ctx) => {
-        const startTime = Date.now();
-        const { path: filePath, content, createDirs = false, append = false } = args;
-        try {
-            // 如果需要创建目录
-            if (createDirs) {
-                await mkdir(dirname(filePath), { recursive: true });
-            }
-            const flags = append ? "a" : "w";
-            await writeFile(filePath, content, { flag: flags });
-            return {
-                success: true,
-                output: append ? `Content appended to: ${filePath}` : `File written: ${filePath}`,
-                metadata: {
-                    execution_time_ms: Date.now() - startTime,
-                    output_size: content.length,
-                    file_path: filePath,
-                },
-            };
-        }
-        catch (error) {
-            return {
-                success: false,
-                output: "",
-                error: error instanceof Error ? error.message : String(error),
-                metadata: {
-                    execution_time_ms: Date.now() - startTime,
-                },
-            };
-        }
-    },
-};
-//# sourceMappingURL=write-file.js.map

package/dist/core/src/env/tool/built-in/write-file.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=write-file.test.d.ts.map

package/dist/core/src/env/tool/built-in/write-file.test.js

@@ -1,74 +0,0 @@
-import { describe, test, expect, beforeEach } from "bun:test";
-import { writeFileTool } from "./write-file.js";
-import { readFile, mkdir } from "fs/promises";
-import { join } from "path";
-describe("writeFileTool", () => {
-    const testDir = join("/tmp", `write-test-${Date.now()}`);
-    const testFile = join(testDir, "output.txt");
-    const nestedFile = join(testDir, "nested", "dir", "output.txt");
-    beforeEach(async () => {
-        await mkdir(testDir, { recursive: true });
-    });
-    describe("parameters", () => {
-        test("should validate path and content", async () => {
-            const result = await writeFileTool.execute({ path: testFile, content: "test content" }, {});
-            expect(result.success).toBe(true);
-        });
-        test("should handle missing path gracefully", async () => {
-            const result = await writeFileTool.execute({ content: "test" }, {});
-            // 会因为文件系统错误而失败
-            expect(result.success).toBe(false);
-        });
-        test("should handle empty content gracefully", async () => {
-            const result = await writeFileTool.execute({ path: testFile, content: "" }, {});
-            // 空内容应该能成功写入
-            expect(result.success).toBe(true);
-        });
-    });
-    describe("execution", () => {
-        test("should write file content", async () => {
-            const content = "Hello, World!";
-            const result = await writeFileTool.execute({ path: testFile, content }, {});
-            expect(result.success).toBe(true);
-            // 验证文件内容
-            const written = await readFile(testFile, "utf-8");
-            expect(written).toBe(content);
-        });
-        test("should create parent directories with createDirs", async () => {
-            const result = await writeFileTool.execute({ path: nestedFile, content: "nested content", createDirs: true }, {});
-            expect(result.success).toBe(true);
-            const written = await readFile(nestedFile, "utf-8");
-            expect(written).toBe("nested content");
-        });
-        test("should append with append flag", async () => {
-            await writeFileTool.execute({ path: testFile, content: "Line 1" }, {});
-            await writeFileTool.execute({ path: testFile, content: "Line 2", append: true }, {});
-            const content = await readFile(testFile, "utf-8");
-            expect(content).toBe("Line 1Line 2");
-        });
-        test("should overwrite without append flag", async () => {
-            await writeFileTool.execute({ path: testFile, content: "Original" }, {});
-            await writeFileTool.execute({ path: testFile, content: "Overwritten" }, {});
-            const content = await readFile(testFile, "utf-8");
-            expect(content).toBe("Overwritten");
-        });
-        test("should include metadata", async () => {
-            const result = await writeFileTool.execute({ path: testFile, content: "test" }, {});
-            expect(result.metadata?.execution_time_ms).toBeDefined();
-            expect(result.metadata?.output_size).toBe(4);
-            expect(result.metadata?.file_path).toBe(testFile);
-        });
-    });
-    describe("metadata", () => {
-        test("should have correct metadata", () => {
-            expect(writeFileTool.name).toBe("write_file");
-            expect(writeFileTool.metadata?.category).toBe("file");
-            expect(writeFileTool.metadata?.tags).toContain("write");
-        });
-        test("should require confirmation", () => {
-            expect(writeFileTool.permission?.requireConfirmation).toBe(true);
-            expect(writeFileTool.permission?.level).toBe("dangerous");
-        });
-    });
-});
-//# sourceMappingURL=write-file.test.js.map

package/dist/core/src/env/tool/index.d.ts

@@ -1,14 +0,0 @@
-export * from "./types";
-export { ToolComponent } from "./tool-component";
-export type { ToolComponentConfig } from "./tool-component";
-export { ToolRegistry } from "./registry";
-export { ToolValidator } from "./validator";
-export { getAllBuiltInTools, getBuiltInTool } from "./built-in";
-export { bashTool } from "./built-in/bash";
-export { echoTool } from "./built-in/echo";
-export { globTool } from "./built-in/glob";
-export { readFileTool } from "./built-in/read-file";
-export { writeFileTool } from "./built-in/write-file";
-export { editFileTool } from "./built-in/edit-file";
-export { grepTool } from "./built-in/grep";
-//# sourceMappingURL=index.d.ts.map

package/dist/core/src/env/tool/index.js

@@ -1,19 +0,0 @@
-// Tool 组件导出
-// 类型
-export * from "./types.js";
-// 组件
-export { ToolComponent } from "./tool-component.js";
-// 注册中心
-export { ToolRegistry } from "./registry.js";
-// 验证器
-export { ToolValidator } from "./validator.js";
-// 内置工具
-export { getAllBuiltInTools, getBuiltInTool } from "./built-in/index.js";
-export { bashTool } from "./built-in/bash.js";
-export { echoTool } from "./built-in/echo.js";
-export { globTool } from "./built-in/glob.js";
-export { readFileTool } from "./built-in/read-file.js";
-export { writeFileTool } from "./built-in/write-file.js";
-export { editFileTool } from "./built-in/edit-file.js";
-export { grepTool } from "./built-in/grep.js";
-//# sourceMappingURL=index.js.map

package/dist/core/src/env/tool/registry.d.ts

@@ -1,62 +0,0 @@
-import type { Tool, ToolRegistration, ToolListFilter } from "./types";
-/**
- * 工具注册中心
- * 管理所有已注册的工具
- */
-export declare class ToolRegistry {
-    private tools;
-    /**
-     * 注册工具
-     */
-    register(tool: Tool, registration: ToolRegistration): void;
-    /**
-     * 注销工具
-     */
-    unregister(name: string): boolean;
-    /**
-     * 获取工具
-     */
-    getTool(name: string): ToolRegistration | undefined;
-    /**
-     * 获取所有工具注册信息
-     */
-    getAllTools(): ToolRegistration[];
-    /**
-     * 列出工具（带过滤）
-     */
-    listTools(filter?: ToolListFilter): Tool[];
-    /**
-     * 检查工具是否存在
-     */
-    has(name: string): boolean;
-    /**
-     * 获取工具数量
-     */
-    getCount(): number;
-    /**
-     * 启用工具
-     */
-    enable(name: string): boolean;
-    /**
-     * 禁用工具
-     */
-    disable(name: string): boolean;
-    /**
-     * 清除所有工具
-     */
-    clear(): void;
-    /**
-     * 导出工具注册表快照
-     */
-    snapshot(): ToolRegistration[];
-    /**
-     * 从快照恢复
-     */
-    restore(snapshot: ToolRegistration[]): void;
-    /**
-     * 简单的 glob 模式匹配
-     * 支持 * 匹配任意字符
-     */
-    private matchGlob;
-}
-//# sourceMappingURL=registry.d.ts.map

package/dist/core/src/env/tool/registry.js

@@ -1,137 +0,0 @@
-/**
- * 工具注册中心
- * 管理所有已注册的工具
- */
-export class ToolRegistry {
-    tools = new Map();
-    /**
-     * 注册工具
-     */
-    register(tool, registration) {
-        this.tools.set(tool.name, registration);
-    }
-    /**
-     * 注销工具
-     */
-    unregister(name) {
-        return this.tools.delete(name);
-    }
-    /**
-     * 获取工具
-     */
-    getTool(name) {
-        return this.tools.get(name);
-    }
-    /**
-     * 获取所有工具注册信息
-     */
-    getAllTools() {
-        return Array.from(this.tools.values());
-    }
-    /**
-     * 列出工具（带过滤）
-     */
-    listTools(filter) {
-        let tools = this.getAllTools();
-        if (!filter) {
-            return tools.map((r) => r.tool);
-        }
-        // 按名称过滤
-        if (filter.name) {
-            const names = Array.isArray(filter.name) ? filter.name : [filter.name];
-            tools = tools.filter((r) => names.some((pattern) => this.matchGlob(r.tool.name, pattern)));
-        }
-        // 按分类过滤
-        if (filter.category) {
-            tools = tools.filter((r) => r.tool.metadata?.category === filter.category);
-        }
-        // 按标签过滤
-        if (filter.tags && filter.tags.length > 0) {
-            tools = tools.filter((r) => filter.tags.some((tag) => r.tool.metadata?.tags?.includes(tag)));
-        }
-        // 按来源过滤
-        if (filter.source) {
-            tools = tools.filter((r) => r.source === filter.source);
-        }
-        // 只返回启用的工具
-        if (filter.enabledOnly) {
-            tools = tools.filter((r) => r.enabled);
-        }
-        // 排除工具
-        if (filter.exclude && filter.exclude.length > 0) {
-            tools = tools.filter((r) => !filter.exclude.includes(r.tool.name));
-        }
-        return tools.map((r) => r.tool);
-    }
-    /**
-     * 检查工具是否存在
-     */
-    has(name) {
-        return this.tools.has(name);
-    }
-    /**
-     * 获取工具数量
-     */
-    getCount() {
-        return this.tools.size;
-    }
-    /**
-     * 启用工具
-     */
-    enable(name) {
-        const reg = this.tools.get(name);
-        if (reg) {
-            reg.enabled = true;
-            return true;
-        }
-        return false;
-    }
-    /**
-     * 禁用工具
-     */
-    disable(name) {
-        const reg = this.tools.get(name);
-        if (reg) {
-            reg.enabled = false;
-            return true;
-        }
-        return false;
-    }
-    /**
-     * 清除所有工具
-     */
-    clear() {
-        this.tools.clear();
-    }
-    /**
-     * 导出工具注册表快照
-     */
-    snapshot() {
-        return this.getAllTools();
-    }
-    /**
-     * 从快照恢复
-     */
-    restore(snapshot) {
-        this.clear();
-        for (const reg of snapshot) {
-            this.tools.set(reg.tool.name, reg);
-        }
-    }
-    /**
-     * 简单的 glob 模式匹配
-     * 支持 * 匹配任意字符
-     */
-    matchGlob(str, pattern) {
-        if (pattern === "*")
-            return true;
-        if (!pattern.includes("*"))
-            return str === pattern;
-        // Convert glob pattern to regex
-        const regexPattern = pattern
-            .replace(/[.+?^${}()|[\]\\]/g, "\\$&") // Escape special regex chars
-            .replace(/\*/g, ".*"); // Convert * to .*
-        return new RegExp(`^${regexPattern}$`).test(str);
-    }
-}
-//# sourceMappingURL=registry.js.map

package/dist/core/src/env/tool/registry.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=registry.test.d.ts.map