@llmist/cli 16.0.4 → 16.2.0

package/dist/index.d.ts

@@ -19,6 +19,12 @@ declare class PathSandboxException extends Error {
  */
 declare function validatePathIsWithinCwd(inputPath: string): string;
 
+/**
+ * DeleteFile gadget - Deletes a file or directory.
+ * All paths are validated to be within the current working directory.
+ */
+declare const deleteFile: llmist.AbstractGadget;
+
 declare const editFile: llmist.AbstractGadget;
 
 /**
@@ -53,4 +59,4 @@ declare const writeFile: llmist.AbstractGadget;
  */
 declare const runCommand: llmist.AbstractGadget;
 
-export { editFile as EditFile, listDirectory as ListDirectory, PathSandboxException, readFile as ReadFile, runCommand as RunCommand, writeFile as WriteFile, editFile, listDirectory, readFile, runCommand, validatePathIsWithinCwd, writeFile };
+export { deleteFile as DeleteFile, listDirectory as ListDirectory, PathSandboxException, readFile as ReadFile, runCommand as RunCommand, writeFile as WriteFile, deleteFile, editFile, listDirectory, readFile, runCommand, validatePathIsWithinCwd, writeFile };

package/dist/index.js

@@ -10,6 +10,12 @@ var PathSandboxException = class extends Error {
 function validatePathIsWithinCwd(inputPath) {
   const cwd = process.cwd();
   const resolvedPath = path.resolve(cwd, inputPath);
+  let realCwd;
+  try {
+    realCwd = fs.realpathSync(cwd);
+  } catch {
+    realCwd = cwd;
+  }
   let finalPath;
   try {
     finalPath = fs.realpathSync(resolvedPath);
@@ -21,17 +27,60 @@ function validatePathIsWithinCwd(inputPath) {
       throw error;
     }
   }
-  const cwdWithSep = cwd + path.sep;
-  if (!finalPath.startsWith(cwdWithSep) && finalPath !== cwd) {
+  const cwdWithSep = realCwd + path.sep;
+  if (!finalPath.startsWith(cwdWithSep) && finalPath !== realCwd) {
     throw new PathSandboxException(inputPath, "Path is outside the current working directory");
   }
   return finalPath;
 }
 
-// src/builtins/filesystem/edit-file.ts
-import { readFileSync, writeFileSync } from "fs";
+// src/builtins/filesystem/delete-file.ts
+import fs2 from "fs";
 import { createGadget } from "llmist";
 import { z } from "zod";
+var deleteFile = createGadget({
+  name: "DeleteFile",
+  description: "Delete a file or directory from the local filesystem. The path must be within the current working directory or its subdirectories.",
+  maxConcurrent: 1,
+  // Sequential execution to prevent race conditions
+  schema: z.object({
+    filePath: z.string().describe("Path to the file or directory to delete (relative or absolute)"),
+    recursive: z.boolean().optional().default(false).describe("If true, perform a recursive deletion (required for directories)")
+  }),
+  examples: [
+    {
+      params: { filePath: "temp.txt", recursive: false },
+      output: "path=temp.txt\n\nDeleted file successfully",
+      comment: "Delete a single file"
+    },
+    {
+      params: { filePath: "tmp-dir", recursive: true },
+      output: "path=tmp-dir\n\nDeleted directory successfully",
+      comment: "Delete a directory and its contents"
+    }
+  ],
+  execute: ({ filePath, recursive }) => {
+    const validatedPath = validatePathIsWithinCwd(filePath);
+    if (!fs2.existsSync(validatedPath)) {
+      return `Error: Path does not exist: ${filePath}`;
+    }
+    const stats = fs2.statSync(validatedPath);
+    const isDirectory = stats.isDirectory();
+    if (isDirectory && !recursive) {
+      return `Error: ${filePath} is a directory. Set recursive=true to delete it.`;
+    }
+    fs2.rmSync(validatedPath, { recursive, force: true });
+    const type = isDirectory ? "directory" : "file";
+    return `path=${filePath}
+
+Deleted ${type} successfully`;
+  }
+});
+
+// src/builtins/filesystem/edit-file.ts
+import { readFileSync, writeFileSync } from "fs";
+import { createGadget as createGadget2 } from "llmist";
+import { z as z2 } from "zod";
 
 // src/builtins/filesystem/editfile/matcher.ts
 import DiffMatchPatch from "diff-match-patch";
@@ -481,7 +530,7 @@ function formatFailure(filePath, search, failure, fileContent) {
   lines.push("", "CURRENT FILE CONTENT:", "```", fileContent, "```");
   return lines.join("\n");
 }
-var editFile = createGadget({
+var editFile = createGadget2({
   name: "EditFile",
   description: `Edit a file by searching for content and replacing it.
 
@@ -500,12 +549,12 @@ Options:
 - expectedCount: Validate exact number of matches before applying`,
   maxConcurrent: 1,
   // Sequential execution to prevent race conditions
-  schema: z.object({
-    filePath: z.string().describe("Path to the file to edit (relative or absolute)"),
-    search: z.string().describe("The content to search for in the file"),
-    replace: z.string().describe("The content to replace it with (empty string to delete)"),
-    replaceAll: z.boolean().optional().default(false).describe("Replace all occurrences instead of just the first match"),
-    expectedCount: z.number().int().positive().optional().describe("Expected number of matches. Edit fails if actual count differs")
+  schema: z2.object({
+    filePath: z2.string().describe("Path to the file to edit (relative or absolute)"),
+    search: z2.string().describe("The content to search for in the file"),
+    replace: z2.string().describe("The content to replace it with (empty string to delete)"),
+    replaceAll: z2.boolean().optional().default(false).describe("Replace all occurrences instead of just the first match"),
+    expectedCount: z2.number().int().positive().optional().describe("Expected number of matches. Edit fails if actual count differs")
   }),
   examples: [
     {
@@ -657,19 +706,19 @@ function executeReplaceAll(content, matches, replace) {
 }
 
 // src/builtins/filesystem/list-directory.ts
-import fs2 from "fs";
+import fs3 from "fs";
 import path2 from "path";
-import { createGadget as createGadget2 } from "llmist";
-import { z as z2 } from "zod";
+import { createGadget as createGadget3 } from "llmist";
+import { z as z3 } from "zod";
 function listFiles(dirPath, basePath = dirPath, maxDepth = 1, currentDepth = 1) {
   const entries = [];
   try {
-    const items = fs2.readdirSync(dirPath);
+    const items = fs3.readdirSync(dirPath);
     for (const item of items) {
       const fullPath = path2.join(dirPath, item);
       const relativePath = path2.relative(basePath, fullPath);
       try {
-        const stats = fs2.lstatSync(fullPath);
+        const stats = fs3.lstatSync(fullPath);
         let type;
         let size;
         if (stats.isSymbolicLink()) {
@@ -744,12 +793,12 @@ function formatEntriesAsString(entries) {
   );
   return [header, ...rows].join("\n");
 }
-var listDirectory = createGadget2({
+var listDirectory = createGadget3({
   name: "ListDirectory",
   description: "List files and directories in a directory with full details (names, types, sizes, modification dates). Use maxDepth to explore subdirectories recursively. The directory path must be within the current working directory or its subdirectories.",
-  schema: z2.object({
-    directoryPath: z2.string().default(".").describe("Path to the directory to list"),
-    maxDepth: z2.number().int().min(1).max(10).default(3).describe(
+  schema: z3.object({
+    directoryPath: z3.string().default(".").describe("Path to the directory to list"),
+    maxDepth: z3.number().int().min(1).max(10).default(3).describe(
       "Maximum depth to recurse (1 = immediate children only, 2 = include grandchildren, etc.)"
     )
   }),
@@ -767,7 +816,7 @@ var listDirectory = createGadget2({
   ],
   execute: ({ directoryPath, maxDepth }) => {
     const validatedPath = validatePathIsWithinCwd(directoryPath);
-    const stats = fs2.statSync(validatedPath);
+    const stats = fs3.statSync(validatedPath);
     if (!stats.isDirectory()) {
       throw new Error(`Path is not a directory: ${directoryPath}`);
     }
@@ -780,14 +829,14 @@ ${formattedList}`;
 });
 
 // src/builtins/filesystem/read-file.ts
-import fs3 from "fs";
-import { createGadget as createGadget3 } from "llmist";
-import { z as z3 } from "zod";
-var readFile = createGadget3({
+import fs4 from "fs";
+import { createGadget as createGadget4 } from "llmist";
+import { z as z4 } from "zod";
+var readFile = createGadget4({
   name: "ReadFile",
   description: "Read the entire content of a file and return it as text. The file path must be within the current working directory or its subdirectories.",
-  schema: z3.object({
-    filePath: z3.string().describe("Path to the file to read (relative or absolute)")
+  schema: z4.object({
+    filePath: z4.string().describe("Path to the file to read (relative or absolute)")
   }),
   examples: [
     {
@@ -803,7 +852,7 @@ var readFile = createGadget3({
   ],
   execute: ({ filePath }) => {
     const validatedPath = validatePathIsWithinCwd(filePath);
-    const content = fs3.readFileSync(validatedPath, "utf-8");
+    const content = fs4.readFileSync(validatedPath, "utf-8");
     return `path=${filePath}
 
 ${content}`;
@@ -811,18 +860,18 @@ ${content}`;
 });
 
 // src/builtins/filesystem/write-file.ts
-import fs4 from "fs";
+import fs5 from "fs";
 import path3 from "path";
-import { createGadget as createGadget4 } from "llmist";
-import { z as z4 } from "zod";
-var writeFile = createGadget4({
+import { createGadget as createGadget5 } from "llmist";
+import { z as z5 } from "zod";
+var writeFile = createGadget5({
   name: "WriteFile",
   description: "Write content to a file. Creates parent directories if needed. Overwrites existing files. The file path must be within the current working directory or its subdirectories.",
   maxConcurrent: 1,
   // Sequential execution to prevent race conditions
-  schema: z4.object({
-    filePath: z4.string().describe("Path to the file to write (relative or absolute)"),
-    content: z4.string().describe("Content to write to the file")
+  schema: z5.object({
+    filePath: z5.string().describe("Path to the file to write (relative or absolute)"),
+    content: z5.string().describe("Content to write to the file")
   }),
   examples: [
     {
@@ -852,12 +901,12 @@ console.log(\`Server running on http://localhost:\${port}\`);`
     const validatedPath = validatePathIsWithinCwd(filePath);
     const parentDir = path3.dirname(validatedPath);
     let createdDir = false;
-    if (!fs4.existsSync(parentDir)) {
+    if (!fs5.existsSync(parentDir)) {
       validatePathIsWithinCwd(parentDir);
-      fs4.mkdirSync(parentDir, { recursive: true });
+      fs5.mkdirSync(parentDir, { recursive: true });
       createdDir = true;
     }
-    fs4.writeFileSync(validatedPath, content, "utf-8");
+    fs5.writeFileSync(validatedPath, content, "utf-8");
     const bytesWritten = Buffer.byteLength(content, "utf-8");
     const dirNote = createdDir ? ` (created directory: ${path3.dirname(filePath)})` : "";
     return `path=${filePath}
@@ -867,8 +916,8 @@ Wrote ${bytesWritten} bytes${dirNote}`;
 });
 
 // src/builtins/run-command.ts
-import { createGadget as createGadget5 } from "llmist";
-import { z as z5 } from "zod";
+import { createGadget as createGadget6 } from "llmist";
+import { z as z6 } from "zod";
 
 // src/spawn.ts
 import { spawn as nodeSpawn } from "child_process";
@@ -929,13 +978,13 @@ function spawn(argv, options = {}) {
 }
 
 // src/builtins/run-command.ts
-var runCommand = createGadget5({
+var runCommand = createGadget6({
   name: "RunCommand",
   description: "Execute a command with arguments and return its output. Uses argv array to bypass shell - arguments are passed directly without interpretation. Returns stdout/stderr combined with exit status.",
-  schema: z5.object({
-    argv: z5.array(z5.string()).describe("Command and arguments as array (e.g., ['git', 'commit', '-m', 'message'])"),
-    cwd: z5.string().optional().describe("Working directory for the command (default: current directory)"),
-    timeout: z5.number().default(3e4).describe("Timeout in milliseconds (default: 30000)")
+  schema: z6.object({
+    argv: z6.array(z6.string()).describe("Command and arguments as array (e.g., ['git', 'commit', '-m', 'message'])"),
+    cwd: z6.string().optional().describe("Working directory for the command (default: current directory)"),
+    timeout: z6.number().default(3e4).describe("Timeout in milliseconds (default: 30000)")
   }),
   examples: [
     {
@@ -1036,12 +1085,13 @@ error: ${message}`;
   }
 });
 export {
-  editFile as EditFile,
+  deleteFile as DeleteFile,
   listDirectory as ListDirectory,
   PathSandboxException,
   readFile as ReadFile,
   runCommand as RunCommand,
   writeFile as WriteFile,
+  deleteFile,
   editFile,
   listDirectory,
   readFile,