import fs from "node:fs/promises"; import os from "node:os"; import path from "node:path"; import type { AgentTool } from "@mariozechner/pi-agent-core"; import { describe, expect, it, vi } from "vitest"; import { __testing, createClawdbotCodingTools } from "./pi-tools.js"; describe("createClawdbotCodingTools", () => { describe("Claude/Gemini alias support", () => { it("adds Claude-style aliases to schemas without dropping metadata", () => { const base: AgentTool = { name: "write", description: "test", parameters: { type: "object", required: ["path", "content"], properties: { path: { type: "string", description: "Path" }, content: { type: "string", description: "Body" }, }, }, execute: vi.fn(), }; const patched = __testing.patchToolSchemaForClaudeCompatibility(base); const params = patched.parameters as { properties?: Record; required?: string[]; }; const props = params.properties ?? {}; expect(props.file_path).toEqual(props.path); expect(params.required ?? []).not.toContain("path"); expect(params.required ?? []).not.toContain("file_path"); }); it("normalizes file_path to path and enforces required groups at runtime", async () => { const execute = vi.fn(async (_id, args) => args); const tool: AgentTool = { name: "write", description: "test", parameters: { type: "object", required: ["path", "content"], properties: { path: { type: "string" }, content: { type: "string" }, }, }, execute, }; const wrapped = __testing.wrapToolParamNormalization(tool, [{ keys: ["path", "file_path"] }]); await wrapped.execute("tool-1", { file_path: "foo.txt", content: "x" }); expect(execute).toHaveBeenCalledWith( "tool-1", { path: "foo.txt", content: "x" }, undefined, undefined, ); await expect(wrapped.execute("tool-2", { content: "x" })).rejects.toThrow( /Missing required parameter/, ); await expect(wrapped.execute("tool-3", { file_path: " ", content: "x" })).rejects.toThrow( /Missing required parameter/, ); }); }); it("uses workspaceDir for Read tool path resolution", async () => { const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "clawdbot-ws-")); try { // Create a test file in the "workspace" const testFile = "test-workspace-file.txt"; const testContent = "workspace path resolution test"; await fs.writeFile(path.join(tmpDir, testFile), testContent, "utf8"); // Create tools with explicit workspaceDir const tools = createClawdbotCodingTools({ workspaceDir: tmpDir }); const readTool = tools.find((tool) => tool.name === "read"); expect(readTool).toBeDefined(); // Read using relative path - should resolve against workspaceDir const result = await readTool?.execute("tool-ws-1", { path: testFile, }); const textBlocks = result?.content?.filter((block) => block.type === "text") as | Array<{ text?: string }> | undefined; const combinedText = textBlocks?.map((block) => block.text ?? "").join("\n"); expect(combinedText).toContain(testContent); } finally { await fs.rm(tmpDir, { recursive: true, force: true }); } }); it("uses workspaceDir for Write tool path resolution", async () => { const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "clawdbot-ws-")); try { const testFile = "test-write-file.txt"; const testContent = "written via workspace path"; // Create tools with explicit workspaceDir const tools = createClawdbotCodingTools({ workspaceDir: tmpDir }); const writeTool = tools.find((tool) => tool.name === "write"); expect(writeTool).toBeDefined(); // Write using relative path - should resolve against workspaceDir await writeTool?.execute("tool-ws-2", { path: testFile, content: testContent, }); // Verify file was written to workspaceDir const written = await fs.readFile(path.join(tmpDir, testFile), "utf8"); expect(written).toBe(testContent); } finally { await fs.rm(tmpDir, { recursive: true, force: true }); } }); it("uses workspaceDir for Edit tool path resolution", async () => { const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "clawdbot-ws-")); try { const testFile = "test-edit-file.txt"; const originalContent = "hello world"; const expectedContent = "hello universe"; await fs.writeFile(path.join(tmpDir, testFile), originalContent, "utf8"); // Create tools with explicit workspaceDir const tools = createClawdbotCodingTools({ workspaceDir: tmpDir }); const editTool = tools.find((tool) => tool.name === "edit"); expect(editTool).toBeDefined(); // Edit using relative path - should resolve against workspaceDir await editTool?.execute("tool-ws-3", { path: testFile, oldText: "world", newText: "universe", }); // Verify file was edited in workspaceDir const edited = await fs.readFile(path.join(tmpDir, testFile), "utf8"); expect(edited).toBe(expectedContent); } finally { await fs.rm(tmpDir, { recursive: true, force: true }); } }); it("accepts Claude Code parameter aliases for read/write/edit", async () => { const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "clawdbot-alias-")); try { const tools = createClawdbotCodingTools({ workspaceDir: tmpDir }); const readTool = tools.find((tool) => tool.name === "read"); const writeTool = tools.find((tool) => tool.name === "write"); const editTool = tools.find((tool) => tool.name === "edit"); expect(readTool).toBeDefined(); expect(writeTool).toBeDefined(); expect(editTool).toBeDefined(); const filePath = "alias-test.txt"; await writeTool?.execute("tool-alias-1", { file_path: filePath, content: "hello world", }); await editTool?.execute("tool-alias-2", { file_path: filePath, old_string: "world", new_string: "universe", }); const result = await readTool?.execute("tool-alias-3", { file_path: filePath, }); const textBlocks = result?.content?.filter((block) => block.type === "text") as | Array<{ text?: string }> | undefined; const combinedText = textBlocks?.map((block) => block.text ?? "").join("\n"); expect(combinedText).toContain("hello universe"); } finally { await fs.rm(tmpDir, { recursive: true, force: true }); } }); });