@yolo-labs/core-tools 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,127 @@
+import { ToolRegistry, Tool, ToolDefinition, SandboxProvider } from '@yolo-labs/core-types';
+
+/**
+ * Default {@link ToolRegistry} implementation with JSON Schema input validation.
+ *
+ * @remarks
+ * Tools are stored in a Map keyed by name. Duplicate registration throws.
+ * Use `executeWithValidation` for schema-checked execution, or `get` a
+ * tool and call its `execute` method directly.
+ *
+ * @example
+ * ```ts
+ * const registry = new ToolRegistryImpl();
+ * registry.register(readFileTool);
+ * registry.register(writeFileTool);
+ * const defs = registry.toAIToolDefinitions();
+ * ```
+ */
+declare class ToolRegistryImpl implements ToolRegistry {
+    private tools;
+    /**
+     * Registers a tool in the registry.
+     *
+     * @param tool - The tool to register.
+     * @throws Error if a tool with the same name is already registered.
+     */
+    register(tool: Tool): void;
+    /**
+     * Removes a tool from the registry by name.
+     *
+     * @param name - The name of the tool to remove.
+     * @throws Error if the tool is not registered.
+     */
+    unregister(name: string): void;
+    /**
+     * Retrieves a registered tool by name.
+     *
+     * @param name - The tool name to look up.
+     * @returns The tool instance, or `undefined` if not found.
+     */
+    get(name: string): Tool | undefined;
+    /** Returns all registered tools. */
+    list(): Tool[];
+    /**
+     * Serializes all registered tools to the canonical AI tool definition format.
+     *
+     * @returns An array of {@link ToolDefinition} objects suitable for passing to an AI provider.
+     */
+    toAIToolDefinitions(): ToolDefinition[];
+    /**
+     * Validates tool input against its JSON Schema and executes the tool.
+     *
+     * @param name - The name of the tool to execute.
+     * @param input - The input object to validate and pass to the tool.
+     * @param args - Remaining arguments forwarded to the tool's execute method.
+     * @returns The tool result, or a failure result if validation fails.
+     * @throws Error if the tool is not found in the registry.
+     */
+    executeWithValidation(name: string, input: Record<string, unknown>, ...args: Parameters<Tool['execute']> extends [unknown, ...infer Rest] ? Rest : never): Promise<ReturnType<Tool['execute']>>;
+}
+
+/** Result of validating tool input against a JSON Schema. */
+interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+/**
+ * Validates a tool input object against a JSON Schema.
+ *
+ * @param input - The input object to validate.
+ * @param schema - A JSON Schema object to validate against.
+ * @returns A {@link ValidationResult} indicating validity and any errors.
+ *
+ * @remarks
+ * Performs lightweight validation: checks required fields and basic type
+ * matching (string, number, integer, boolean, array, object). Does not
+ * support advanced JSON Schema features like `$ref`, `allOf`, or `pattern`.
+ */
+declare function validateInput(input: Record<string, unknown>, schema: Record<string, unknown>): ValidationResult;
+
+/** Reference tool: creates or overwrites a file in the sandbox. */
+declare const writeFileTool: Tool;
+
+/** Reference tool: reads the contents of a file from the sandbox. */
+declare const readFileTool: Tool;
+
+/** Reference tool: lists files and directories in a sandbox directory. */
+declare const listFilesTool: Tool;
+
+/** Reference tool: deletes a file from the sandbox file system. */
+declare const deleteFileTool: Tool;
+
+/** Reference tool: runs a shell command in the sandbox environment. */
+declare const executeCommandTool: Tool;
+
+/** Reference tool: targeted find/replace edit on a file in the sandbox. */
+declare const editFileTool: Tool;
+
+/** Reference tool: searches file contents for a pattern across the project. */
+declare const searchFilesTool: Tool;
+
+interface WalkOptions {
+    /** Directories to skip (basename match). Defaults to node_modules, .git, dist, .next. */
+    exclude?: string[];
+    /** Maximum directory depth (0 = only top-level). Defaults to Infinity. */
+    maxDepth?: number;
+}
+/**
+ * Recursively walk a directory tree using the SandboxProvider interface.
+ *
+ * Uses `sandbox.listFiles()` to enumerate entries and probes each entry
+ * with another `listFiles()` call to determine if it is a directory.
+ * Returns a flat list of file paths (not directories).
+ */
+declare function walkDir(sandbox: SandboxProvider, dir: string, opts?: WalkOptions): Promise<string[]>;
+
+/**
+ * Returns all 7 reference tools: read_file, write_file, list_files, delete_file,
+ * execute_command, edit_file, search_files.
+ *
+ * @remarks
+ * Convenience function for registering the standard tool set. Used by
+ * {@link createHeadlessAgent} when `tools: 'default'` is specified in config.
+ */
+declare function getDefaultTools(): Tool[];
+
+export { ToolRegistryImpl, type ValidationResult, type WalkOptions, deleteFileTool, editFileTool, executeCommandTool, getDefaultTools, listFilesTool, readFileTool, searchFilesTool, validateInput, walkDir, writeFileTool };

package/dist/index.js

@@ -0,0 +1,502 @@
+// src/validation.ts
+function validateInput(input, schema) {
+  const errors = [];
+  if (schema.type !== "object") {
+    return { valid: true, errors: [] };
+  }
+  const required = schema.required ?? [];
+  for (const field of required) {
+    if (!(field in input) || input[field] === void 0 || input[field] === null) {
+      errors.push(`Missing required field: '${field}'`);
+    }
+  }
+  const properties = schema.properties ?? {};
+  for (const [key, value] of Object.entries(input)) {
+    const propSchema = properties[key];
+    if (!propSchema) continue;
+    const expectedType = propSchema.type;
+    if (!expectedType) continue;
+    const actualType = Array.isArray(value) ? "array" : typeof value;
+    if (expectedType === "integer") {
+      if (typeof value !== "number" || !Number.isInteger(value)) {
+        errors.push(`Field '${key}': expected integer, got ${actualType}`);
+      }
+    } else if (expectedType !== actualType) {
+      errors.push(`Field '${key}': expected ${expectedType}, got ${actualType}`);
+    }
+  }
+  return { valid: errors.length === 0, errors };
+}
+
+// src/registry.ts
+var ToolRegistryImpl = class {
+  tools = /* @__PURE__ */ new Map();
+  /**
+   * Registers a tool in the registry.
+   *
+   * @param tool - The tool to register.
+   * @throws Error if a tool with the same name is already registered.
+   */
+  register(tool) {
+    if (this.tools.has(tool.name)) {
+      throw new Error(`Tool '${tool.name}' is already registered`);
+    }
+    this.tools.set(tool.name, tool);
+  }
+  /**
+   * Removes a tool from the registry by name.
+   *
+   * @param name - The name of the tool to remove.
+   * @throws Error if the tool is not registered.
+   */
+  unregister(name) {
+    if (!this.tools.has(name)) {
+      throw new Error(`Tool '${name}' is not registered`);
+    }
+    this.tools.delete(name);
+  }
+  /**
+   * Retrieves a registered tool by name.
+   *
+   * @param name - The tool name to look up.
+   * @returns The tool instance, or `undefined` if not found.
+   */
+  get(name) {
+    return this.tools.get(name);
+  }
+  /** Returns all registered tools. */
+  list() {
+    return Array.from(this.tools.values());
+  }
+  /**
+   * Serializes all registered tools to the canonical AI tool definition format.
+   *
+   * @returns An array of {@link ToolDefinition} objects suitable for passing to an AI provider.
+   */
+  toAIToolDefinitions() {
+    return Array.from(this.tools.values()).map((tool) => ({
+      name: tool.name,
+      description: tool.description,
+      inputSchema: tool.inputSchema
+    }));
+  }
+  /**
+   * Validates tool input against its JSON Schema and executes the tool.
+   *
+   * @param name - The name of the tool to execute.
+   * @param input - The input object to validate and pass to the tool.
+   * @param args - Remaining arguments forwarded to the tool's execute method.
+   * @returns The tool result, or a failure result if validation fails.
+   * @throws Error if the tool is not found in the registry.
+   */
+  async executeWithValidation(name, input, ...args) {
+    const tool = this.tools.get(name);
+    if (!tool) {
+      throw new Error(`Tool '${name}' not found in registry`);
+    }
+    const validation = validateInput(input, tool.inputSchema);
+    if (!validation.valid) {
+      return {
+        success: false,
+        output: null,
+        error: `Validation failed: ${validation.errors.join(", ")}`
+      };
+    }
+    return tool.execute(input, ...args);
+  }
+};
+
+// src/reference/write-file.ts
+var writeFileTool = {
+  name: "write_file",
+  description: "Create or overwrite a file in the sandbox file system",
+  inputSchema: {
+    type: "object",
+    properties: {
+      path: { type: "string", description: "File path to write to" },
+      content: { type: "string", description: "Content to write to the file" }
+    },
+    required: ["path", "content"]
+  },
+  async execute(input, context) {
+    const path = input.path;
+    const content = input.content;
+    try {
+      await context.sandbox.writeFile(path, content);
+      return {
+        success: true,
+        output: `Successfully wrote ${content.length} characters to ${path}`,
+        preview: content.length > 200 ? content.slice(0, 200) + "..." : content
+      };
+    } catch (err) {
+      return {
+        success: false,
+        output: null,
+        error: err instanceof Error ? err.message : String(err)
+      };
+    }
+  }
+};
+
+// src/reference/read-file.ts
+var readFileTool = {
+  name: "read_file",
+  description: "Read the contents of a file from the sandbox file system",
+  inputSchema: {
+    type: "object",
+    properties: {
+      path: { type: "string", description: "File path to read from" }
+    },
+    required: ["path"]
+  },
+  async execute(input, context) {
+    const path = input.path;
+    try {
+      const content = await context.sandbox.readFile(path);
+      return {
+        success: true,
+        output: content,
+        preview: content.length > 200 ? content.slice(0, 200) + "..." : content
+      };
+    } catch (err) {
+      return {
+        success: false,
+        output: null,
+        error: err instanceof Error ? err.message : String(err)
+      };
+    }
+  }
+};
+
+// src/reference/walk.ts
+var DEFAULT_EXCLUDE = ["node_modules", ".git", "dist", ".next"];
+async function walkDir(sandbox, dir, opts) {
+  const exclude = opts?.exclude ?? DEFAULT_EXCLUDE;
+  const maxDepth = opts?.maxDepth ?? Infinity;
+  const results = [];
+  await walkRecursive(sandbox, dir, exclude, maxDepth, 0, results);
+  return results;
+}
+async function walkRecursive(sandbox, dir, exclude, maxDepth, depth, results) {
+  let entries;
+  try {
+    entries = await sandbox.listFiles(dir);
+  } catch {
+    return;
+  }
+  for (const entry of entries) {
+    const fullPath = dir === "." ? entry : `${dir}/${entry}`;
+    const basename = entry.split("/").pop() ?? entry;
+    if (exclude.includes(basename)) {
+      continue;
+    }
+    let isDir = false;
+    try {
+      await sandbox.listFiles(fullPath);
+      isDir = true;
+    } catch {
+    }
+    if (isDir) {
+      if (depth < maxDepth) {
+        await walkRecursive(sandbox, fullPath, exclude, maxDepth, depth + 1, results);
+      }
+    } else {
+      results.push(fullPath);
+    }
+  }
+}
+
+// src/reference/list-files.ts
+var MAX_RECURSIVE_ENTRIES = 500;
+var listFilesTool = {
+  name: "list_files",
+  description: "List files and directories in a sandbox directory. Use recursive mode to explore the full project structure.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      path: {
+        type: "string",
+        description: "Directory path to list (defaults to root)"
+      },
+      recursive: {
+        type: "boolean",
+        description: "If true, recursively list all files (excludes node_modules, .git, dist). Defaults to false."
+      }
+    },
+    required: []
+  },
+  async execute(input, context) {
+    const path = input.path ?? ".";
+    const recursive = input.recursive ?? false;
+    try {
+      if (!recursive) {
+        const files = await context.sandbox.listFiles(path);
+        return {
+          success: true,
+          output: files,
+          preview: files.join("\n")
+        };
+      }
+      const allFiles = await walkDir(context.sandbox, path);
+      const capped = allFiles.slice(0, MAX_RECURSIVE_ENTRIES);
+      const suffix = allFiles.length > MAX_RECURSIVE_ENTRIES ? `
+(${allFiles.length - MAX_RECURSIVE_ENTRIES} more files not shown)` : "";
+      const listing = capped.join("\n") + suffix;
+      return {
+        success: true,
+        output: capped,
+        preview: listing.length > 200 ? listing.slice(0, 200) + "..." : listing,
+        metadata: { total: allFiles.length, shown: capped.length }
+      };
+    } catch (err) {
+      return {
+        success: false,
+        output: null,
+        error: err instanceof Error ? err.message : String(err)
+      };
+    }
+  }
+};
+
+// src/reference/delete-file.ts
+var deleteFileTool = {
+  name: "delete_file",
+  description: "Delete a file from the sandbox file system",
+  inputSchema: {
+    type: "object",
+    properties: {
+      path: { type: "string", description: "File path to delete" }
+    },
+    required: ["path"]
+  },
+  async execute(input, context) {
+    const path = input.path;
+    try {
+      await context.sandbox.deleteFile(path);
+      return {
+        success: true,
+        output: `Successfully deleted ${path}`
+      };
+    } catch (err) {
+      return {
+        success: false,
+        output: null,
+        error: err instanceof Error ? err.message : String(err)
+      };
+    }
+  }
+};
+
+// src/reference/execute-command.ts
+var executeCommandTool = {
+  name: "execute_command",
+  description: "Run a shell command in the sandbox environment",
+  inputSchema: {
+    type: "object",
+    properties: {
+      command: { type: "string", description: "Shell command to execute" },
+      cwd: { type: "string", description: "Working directory (optional)" },
+      timeout: {
+        type: "number",
+        description: "Timeout in milliseconds (optional)"
+      }
+    },
+    required: ["command"]
+  },
+  async execute(input, context, onProgress) {
+    const command = input.command;
+    const cwd = input.cwd;
+    const timeout = input.timeout;
+    try {
+      const result = await context.sandbox.executeCommand(command, {
+        cwd,
+        timeout,
+        env: context.env,
+        onStdout: (data) => {
+          onProgress?.({ message: data });
+        },
+        onStderr: (data) => {
+          onProgress?.({ message: `stderr: ${data}` });
+        }
+      });
+      const output = [result.stdout, result.stderr].filter(Boolean).join("\n");
+      return {
+        success: result.exitCode === 0,
+        output,
+        error: result.exitCode !== 0 ? `Command exited with code ${result.exitCode}` : void 0,
+        metadata: { exitCode: result.exitCode }
+      };
+    } catch (err) {
+      return {
+        success: false,
+        output: null,
+        error: err instanceof Error ? err.message : String(err)
+      };
+    }
+  }
+};
+
+// src/reference/edit-file.ts
+var editFileTool = {
+  name: "edit_file",
+  description: "Edit a file by replacing an exact string match. The old_string must appear exactly once in the file to ensure a precise, unambiguous edit.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      path: { type: "string", description: "File path to edit" },
+      old_string: {
+        type: "string",
+        description: "Exact string to find (must appear exactly once)"
+      },
+      new_string: {
+        type: "string",
+        description: "Replacement string"
+      }
+    },
+    required: ["path", "old_string", "new_string"]
+  },
+  async execute(input, context) {
+    const path = input.path;
+    const oldStr = input.old_string;
+    const newStr = input.new_string;
+    try {
+      const content = await context.sandbox.readFile(path);
+      let count = 0;
+      let idx = 0;
+      while ((idx = content.indexOf(oldStr, idx)) !== -1) {
+        count++;
+        idx += oldStr.length;
+      }
+      if (count === 0) {
+        return {
+          success: false,
+          output: null,
+          error: `old_string not found in ${path}. Make sure the string matches exactly, including whitespace and indentation.`
+        };
+      }
+      if (count > 1) {
+        return {
+          success: false,
+          output: null,
+          error: `old_string appears ${count} times in ${path}. Provide more surrounding context to make the match unique.`
+        };
+      }
+      const updated = content.replace(oldStr, newStr);
+      await context.sandbox.writeFile(path, updated);
+      return {
+        success: true,
+        output: `Successfully edited ${path}`,
+        preview: `Replaced ${oldStr.length} chars with ${newStr.length} chars`
+      };
+    } catch (err) {
+      return {
+        success: false,
+        output: null,
+        error: err instanceof Error ? err.message : String(err)
+      };
+    }
+  }
+};
+
+// src/reference/search-files.ts
+var MAX_MATCHES = 50;
+var searchFilesTool = {
+  name: "search_files",
+  description: "Search file contents for a text pattern. Returns matching lines in file:line_number:content format. Searches recursively from the given path.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      pattern: {
+        type: "string",
+        description: "Text pattern to search for (substring match)"
+      },
+      path: {
+        type: "string",
+        description: "Directory to search in (defaults to project root)"
+      },
+      include: {
+        type: "string",
+        description: 'File extension filter, e.g. "*.ts" (optional)'
+      }
+    },
+    required: ["pattern"]
+  },
+  async execute(input, context) {
+    const pattern = input.pattern;
+    const searchPath = input.path ?? ".";
+    const include = input.include;
+    try {
+      const files = await walkDir(context.sandbox, searchPath);
+      let filtered = files;
+      if (include) {
+        const ext = include.startsWith("*.") ? include.slice(1) : include;
+        filtered = files.filter((f) => f.endsWith(ext));
+      }
+      const matches = [];
+      for (const file of filtered) {
+        if (matches.length >= MAX_MATCHES) break;
+        let content;
+        try {
+          content = await context.sandbox.readFile(file);
+        } catch {
+          continue;
+        }
+        const lines = content.split("\n");
+        for (let i = 0; i < lines.length; i++) {
+          if (lines[i].includes(pattern)) {
+            matches.push(`${file}:${i + 1}:${lines[i]}`);
+            if (matches.length >= MAX_MATCHES) break;
+          }
+        }
+      }
+      if (matches.length === 0) {
+        return {
+          success: true,
+          output: "No matches found.",
+          preview: "No matches found."
+        };
+      }
+      const output = matches.join("\n");
+      const suffix = matches.length >= MAX_MATCHES ? `
+(results capped at ${MAX_MATCHES})` : "";
+      return {
+        success: true,
+        output: output + suffix,
+        preview: output.length > 200 ? output.slice(0, 200) + "..." : output
+      };
+    } catch (err) {
+      return {
+        success: false,
+        output: null,
+        error: err instanceof Error ? err.message : String(err)
+      };
+    }
+  }
+};
+
+// src/index.ts
+function getDefaultTools() {
+  return [
+    readFileTool,
+    writeFileTool,
+    listFilesTool,
+    deleteFileTool,
+    executeCommandTool,
+    editFileTool,
+    searchFilesTool
+  ];
+}
+export {
+  ToolRegistryImpl,
+  deleteFileTool,
+  editFileTool,
+  executeCommandTool,
+  getDefaultTools,
+  listFilesTool,
+  readFileTool,
+  searchFilesTool,
+  validateInput,
+  walkDir,
+  writeFileTool
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/validation.ts","../src/registry.ts","../src/reference/write-file.ts","../src/reference/read-file.ts","../src/reference/walk.ts","../src/reference/list-files.ts","../src/reference/delete-file.ts","../src/reference/execute-command.ts","../src/reference/edit-file.ts","../src/reference/search-files.ts","../src/index.ts"],"sourcesContent":["// Task 26d: JSON Schema validation for tool inputs\n\n/** Result of validating tool input against a JSON Schema. */\nexport interface ValidationResult {\n  valid: boolean;\n  errors: string[];\n}\n\n/**\n * Validates a tool input object against a JSON Schema.\n *\n * @param input - The input object to validate.\n * @param schema - A JSON Schema object to validate against.\n * @returns A {@link ValidationResult} indicating validity and any errors.\n *\n * @remarks\n * Performs lightweight validation: checks required fields and basic type\n * matching (string, number, integer, boolean, array, object). Does not\n * support advanced JSON Schema features like `$ref`, `allOf`, or `pattern`.\n */\nexport function validateInput(\n  input: Record<string, unknown>,\n  schema: Record<string, unknown>,\n): ValidationResult {\n  const errors: string[] = [];\n\n  if (schema.type !== 'object') {\n    return { valid: true, errors: [] };\n  }\n\n  // Check required fields\n  const required = (schema.required as string[]) ?? [];\n  for (const field of required) {\n    if (!(field in input) || input[field] === undefined || input[field] === null) {\n      errors.push(`Missing required field: '${field}'`);\n    }\n  }\n\n  // Check property types\n  const properties = (schema.properties as Record<string, Record<string, unknown>>) ?? {};\n  for (const [key, value] of Object.entries(input)) {\n    const propSchema = properties[key];\n    if (!propSchema) continue;\n\n    const expectedType = propSchema.type as string;\n    if (!expectedType) continue;\n\n    const actualType = Array.isArray(value) ? 'array' : typeof value;\n\n    if (expectedType === 'integer') {\n      if (typeof value !== 'number' || !Number.isInteger(value)) {\n        errors.push(`Field '${key}': expected integer, got ${actualType}`);\n      }\n    } else if (expectedType !== actualType) {\n      errors.push(`Field '${key}': expected ${expectedType}, got ${actualType}`);\n    }\n  }\n\n  return { valid: errors.length === 0, errors };\n}\n","// Task 26: ToolRegistryImpl\n\nimport type { Tool, ToolDefinition, ToolRegistry } from '@yolo-labs/core-types';\nimport { validateInput } from './validation.js';\n\n/**\n * Default {@link ToolRegistry} implementation with JSON Schema input validation.\n *\n * @remarks\n * Tools are stored in a Map keyed by name. Duplicate registration throws.\n * Use `executeWithValidation` for schema-checked execution, or `get` a\n * tool and call its `execute` method directly.\n *\n * @example\n * ```ts\n * const registry = new ToolRegistryImpl();\n * registry.register(readFileTool);\n * registry.register(writeFileTool);\n * const defs = registry.toAIToolDefinitions();\n * ```\n */\nexport class ToolRegistryImpl implements ToolRegistry {\n  private tools = new Map<string, Tool>();\n\n  /**\n   * Registers a tool in the registry.\n   *\n   * @param tool - The tool to register.\n   * @throws Error if a tool with the same name is already registered.\n   */\n  register(tool: Tool): void {\n    if (this.tools.has(tool.name)) {\n      throw new Error(`Tool '${tool.name}' is already registered`);\n    }\n    this.tools.set(tool.name, tool);\n  }\n\n  /**\n   * Removes a tool from the registry by name.\n   *\n   * @param name - The name of the tool to remove.\n   * @throws Error if the tool is not registered.\n   */\n  unregister(name: string): void {\n    if (!this.tools.has(name)) {\n      throw new Error(`Tool '${name}' is not registered`);\n    }\n    this.tools.delete(name);\n  }\n\n  /**\n   * Retrieves a registered tool by name.\n   *\n   * @param name - The tool name to look up.\n   * @returns The tool instance, or `undefined` if not found.\n   */\n  get(name: string): Tool | undefined {\n    return this.tools.get(name);\n  }\n\n  /** Returns all registered tools. */\n  list(): Tool[] {\n    return Array.from(this.tools.values());\n  }\n\n  /**\n   * Serializes all registered tools to the canonical AI tool definition format.\n   *\n   * @returns An array of {@link ToolDefinition} objects suitable for passing to an AI provider.\n   */\n  toAIToolDefinitions(): ToolDefinition[] {\n    return Array.from(this.tools.values()).map((tool) => ({\n      name: tool.name,\n      description: tool.description,\n      inputSchema: tool.inputSchema,\n    }));\n  }\n\n  /**\n   * Validates tool input against its JSON Schema and executes the tool.\n   *\n   * @param name - The name of the tool to execute.\n   * @param input - The input object to validate and pass to the tool.\n   * @param args - Remaining arguments forwarded to the tool's execute method.\n   * @returns The tool result, or a failure result if validation fails.\n   * @throws Error if the tool is not found in the registry.\n   */\n  async executeWithValidation(\n    name: string,\n    input: Record<string, unknown>,\n    ...args: Parameters<Tool['execute']> extends [unknown, ...infer Rest] ? Rest : never\n  ): Promise<ReturnType<Tool['execute']>> {\n    const tool = this.tools.get(name);\n    if (!tool) {\n      throw new Error(`Tool '${name}' not found in registry`);\n    }\n\n    const validation = validateInput(input, tool.inputSchema);\n    if (!validation.valid) {\n      return {\n        success: false,\n        output: null,\n        error: `Validation failed: ${validation.errors.join(', ')}`,\n      };\n    }\n\n    return tool.execute(input, ...args);\n  }\n}\n","// Task 27: write_file reference tool\n\nimport type { Tool, SandboxContext, ToolResult } from '@yolo-labs/core-types';\n\n/** Reference tool: creates or overwrites a file in the sandbox. */\nexport const writeFileTool: Tool = {\n  name: 'write_file',\n  description: 'Create or overwrite a file in the sandbox file system',\n  inputSchema: {\n    type: 'object',\n    properties: {\n      path: { type: 'string', description: 'File path to write to' },\n      content: { type: 'string', description: 'Content to write to the file' },\n    },\n    required: ['path', 'content'],\n  },\n  async execute(\n    input: Record<string, unknown>,\n    context: SandboxContext,\n  ): Promise<ToolResult> {\n    const path = input.path as string;\n    const content = input.content as string;\n\n    try {\n      await context.sandbox.writeFile(path, content);\n      return {\n        success: true,\n        output: `Successfully wrote ${content.length} characters to ${path}`,\n        preview: content.length > 200 ? content.slice(0, 200) + '...' : content,\n      };\n    } catch (err) {\n      return {\n        success: false,\n        output: null,\n        error: err instanceof Error ? err.message : String(err),\n      };\n    }\n  },\n};\n","// Task 28: read_file reference tool\n\nimport type { Tool, SandboxContext, ToolResult } from '@yolo-labs/core-types';\n\n/** Reference tool: reads the contents of a file from the sandbox. */\nexport const readFileTool: Tool = {\n  name: 'read_file',\n  description: 'Read the contents of a file from the sandbox file system',\n  inputSchema: {\n    type: 'object',\n    properties: {\n      path: { type: 'string', description: 'File path to read from' },\n    },\n    required: ['path'],\n  },\n  async execute(\n    input: Record<string, unknown>,\n    context: SandboxContext,\n  ): Promise<ToolResult> {\n    const path = input.path as string;\n\n    try {\n      const content = await context.sandbox.readFile(path);\n      return {\n        success: true,\n        output: content,\n        preview: content.length > 200 ? content.slice(0, 200) + '...' : content,\n      };\n    } catch (err) {\n      return {\n        success: false,\n        output: null,\n        error: err instanceof Error ? err.message : String(err),\n      };\n    }\n  },\n};\n","// Task 123: Shared recursive directory walker\n\nimport type { SandboxProvider } from '@yolo-labs/core-types';\n\n/** Default directories to exclude from recursive walks. */\nconst DEFAULT_EXCLUDE = ['node_modules', '.git', 'dist', '.next'];\n\nexport interface WalkOptions {\n  /** Directories to skip (basename match). Defaults to node_modules, .git, dist, .next. */\n  exclude?: string[];\n  /** Maximum directory depth (0 = only top-level). Defaults to Infinity. */\n  maxDepth?: number;\n}\n\n/**\n * Recursively walk a directory tree using the SandboxProvider interface.\n *\n * Uses `sandbox.listFiles()` to enumerate entries and probes each entry\n * with another `listFiles()` call to determine if it is a directory.\n * Returns a flat list of file paths (not directories).\n */\nexport async function walkDir(\n  sandbox: SandboxProvider,\n  dir: string,\n  opts?: WalkOptions,\n): Promise<string[]> {\n  const exclude = opts?.exclude ?? DEFAULT_EXCLUDE;\n  const maxDepth = opts?.maxDepth ?? Infinity;\n\n  const results: string[] = [];\n  await walkRecursive(sandbox, dir, exclude, maxDepth, 0, results);\n  return results;\n}\n\nasync function walkRecursive(\n  sandbox: SandboxProvider,\n  dir: string,\n  exclude: string[],\n  maxDepth: number,\n  depth: number,\n  results: string[],\n): Promise<void> {\n  let entries: string[];\n  try {\n    entries = await sandbox.listFiles(dir);\n  } catch {\n    return; // dir doesn't exist or can't be listed — skip\n  }\n\n  for (const entry of entries) {\n    const fullPath = dir === '.' ? entry : `${dir}/${entry}`;\n    const basename = entry.split('/').pop() ?? entry;\n\n    // Skip excluded directories\n    if (exclude.includes(basename)) {\n      continue;\n    }\n\n    // Probe: if listFiles succeeds, it's a directory\n    let isDir = false;\n    try {\n      await sandbox.listFiles(fullPath);\n      isDir = true;\n    } catch {\n      // Not a directory — it's a file\n    }\n\n    if (isDir) {\n      if (depth < maxDepth) {\n        await walkRecursive(sandbox, fullPath, exclude, maxDepth, depth + 1, results);\n      }\n      // At maxDepth, skip directories (only return files)\n    } else {\n      results.push(fullPath);\n    }\n  }\n}\n","// Task 29: list_files reference tool\n// Task 126: Enhanced with recursive option\n\nimport type { Tool, SandboxContext, ToolResult } from '@yolo-labs/core-types';\nimport { walkDir } from './walk.js';\n\n/** Maximum entries returned in recursive mode. */\nconst MAX_RECURSIVE_ENTRIES = 500;\n\n/** Reference tool: lists files and directories in a sandbox directory. */\nexport const listFilesTool: Tool = {\n  name: 'list_files',\n  description:\n    'List files and directories in a sandbox directory. Use recursive mode to explore the full project structure.',\n  inputSchema: {\n    type: 'object',\n    properties: {\n      path: {\n        type: 'string',\n        description: 'Directory path to list (defaults to root)',\n      },\n      recursive: {\n        type: 'boolean',\n        description:\n          'If true, recursively list all files (excludes node_modules, .git, dist). Defaults to false.',\n      },\n    },\n    required: [],\n  },\n  async execute(\n    input: Record<string, unknown>,\n    context: SandboxContext,\n  ): Promise<ToolResult> {\n    const path = (input.path as string) ?? '.';\n    const recursive = (input.recursive as boolean) ?? false;\n\n    try {\n      if (!recursive) {\n        const files = await context.sandbox.listFiles(path);\n        return {\n          success: true,\n          output: files,\n          preview: files.join('\\n'),\n        };\n      }\n\n      // Recursive mode: use walkDir helper\n      const allFiles = await walkDir(context.sandbox, path);\n      const capped = allFiles.slice(0, MAX_RECURSIVE_ENTRIES);\n      const suffix =\n        allFiles.length > MAX_RECURSIVE_ENTRIES\n          ? `\\n(${allFiles.length - MAX_RECURSIVE_ENTRIES} more files not shown)`\n          : '';\n\n      const listing = capped.join('\\n') + suffix;\n      return {\n        success: true,\n        output: capped,\n        preview:\n          listing.length > 200 ? listing.slice(0, 200) + '...' : listing,\n        metadata: { total: allFiles.length, shown: capped.length },\n      };\n    } catch (err) {\n      return {\n        success: false,\n        output: null,\n        error: err instanceof Error ? err.message : String(err),\n      };\n    }\n  },\n};\n","// Task 30: delete_file reference tool\n\nimport type { Tool, SandboxContext, ToolResult } from '@yolo-labs/core-types';\n\n/** Reference tool: deletes a file from the sandbox file system. */\nexport const deleteFileTool: Tool = {\n  name: 'delete_file',\n  description: 'Delete a file from the sandbox file system',\n  inputSchema: {\n    type: 'object',\n    properties: {\n      path: { type: 'string', description: 'File path to delete' },\n    },\n    required: ['path'],\n  },\n  async execute(\n    input: Record<string, unknown>,\n    context: SandboxContext,\n  ): Promise<ToolResult> {\n    const path = input.path as string;\n\n    try {\n      await context.sandbox.deleteFile(path);\n      return {\n        success: true,\n        output: `Successfully deleted ${path}`,\n      };\n    } catch (err) {\n      return {\n        success: false,\n        output: null,\n        error: err instanceof Error ? err.message : String(err),\n      };\n    }\n  },\n};\n","// Task 31: execute_command reference tool\n\nimport type { Tool, SandboxContext, ToolResult } from '@yolo-labs/core-types';\n\n/** Reference tool: runs a shell command in the sandbox environment. */\nexport const executeCommandTool: Tool = {\n  name: 'execute_command',\n  description: 'Run a shell command in the sandbox environment',\n  inputSchema: {\n    type: 'object',\n    properties: {\n      command: { type: 'string', description: 'Shell command to execute' },\n      cwd: { type: 'string', description: 'Working directory (optional)' },\n      timeout: {\n        type: 'number',\n        description: 'Timeout in milliseconds (optional)',\n      },\n    },\n    required: ['command'],\n  },\n  async execute(\n    input: Record<string, unknown>,\n    context: SandboxContext,\n    onProgress?: (progress: { message: string }) => void,\n  ): Promise<ToolResult> {\n    const command = input.command as string;\n    const cwd = input.cwd as string | undefined;\n    const timeout = input.timeout as number | undefined;\n\n    try {\n      const result = await context.sandbox.executeCommand(command, {\n        cwd,\n        timeout,\n        env: context.env,\n        onStdout: (data) => {\n          onProgress?.({ message: data });\n        },\n        onStderr: (data) => {\n          onProgress?.({ message: `stderr: ${data}` });\n        },\n      });\n\n      const output = [result.stdout, result.stderr].filter(Boolean).join('\\n');\n\n      return {\n        success: result.exitCode === 0,\n        output,\n        error:\n          result.exitCode !== 0\n            ? `Command exited with code ${result.exitCode}`\n            : undefined,\n        metadata: { exitCode: result.exitCode },\n      };\n    } catch (err) {\n      return {\n        success: false,\n        output: null,\n        error: err instanceof Error ? err.message : String(err),\n      };\n    }\n  },\n};\n","// Task 124: edit_file reference tool — find/replace editing\n\nimport type { Tool, SandboxContext, ToolResult } from '@yolo-labs/core-types';\n\n/** Reference tool: targeted find/replace edit on a file in the sandbox. */\nexport const editFileTool: Tool = {\n  name: 'edit_file',\n  description:\n    'Edit a file by replacing an exact string match. The old_string must appear exactly once in the file to ensure a precise, unambiguous edit.',\n  inputSchema: {\n    type: 'object',\n    properties: {\n      path: { type: 'string', description: 'File path to edit' },\n      old_string: {\n        type: 'string',\n        description: 'Exact string to find (must appear exactly once)',\n      },\n      new_string: {\n        type: 'string',\n        description: 'Replacement string',\n      },\n    },\n    required: ['path', 'old_string', 'new_string'],\n  },\n  async execute(\n    input: Record<string, unknown>,\n    context: SandboxContext,\n  ): Promise<ToolResult> {\n    const path = input.path as string;\n    const oldStr = input.old_string as string;\n    const newStr = input.new_string as string;\n\n    try {\n      const content = await context.sandbox.readFile(path);\n\n      // Count occurrences\n      let count = 0;\n      let idx = 0;\n      while ((idx = content.indexOf(oldStr, idx)) !== -1) {\n        count++;\n        idx += oldStr.length;\n      }\n\n      if (count === 0) {\n        return {\n          success: false,\n          output: null,\n          error: `old_string not found in ${path}. Make sure the string matches exactly, including whitespace and indentation.`,\n        };\n      }\n\n      if (count > 1) {\n        return {\n          success: false,\n          output: null,\n          error: `old_string appears ${count} times in ${path}. Provide more surrounding context to make the match unique.`,\n        };\n      }\n\n      // Exactly one match — replace\n      const updated = content.replace(oldStr, newStr);\n      await context.sandbox.writeFile(path, updated);\n\n      return {\n        success: true,\n        output: `Successfully edited ${path}`,\n        preview: `Replaced ${oldStr.length} chars with ${newStr.length} chars`,\n      };\n    } catch (err) {\n      return {\n        success: false,\n        output: null,\n        error: err instanceof Error ? err.message : String(err),\n      };\n    }\n  },\n};\n","// Task 125: search_files reference tool — content search across files\n\nimport type { Tool, SandboxContext, ToolResult } from '@yolo-labs/core-types';\nimport { walkDir } from './walk.js';\n\n/** Maximum number of matching lines returned. */\nconst MAX_MATCHES = 50;\n\n/** Reference tool: searches file contents for a pattern across the project. */\nexport const searchFilesTool: Tool = {\n  name: 'search_files',\n  description:\n    'Search file contents for a text pattern. Returns matching lines in file:line_number:content format. Searches recursively from the given path.',\n  inputSchema: {\n    type: 'object',\n    properties: {\n      pattern: {\n        type: 'string',\n        description: 'Text pattern to search for (substring match)',\n      },\n      path: {\n        type: 'string',\n        description: 'Directory to search in (defaults to project root)',\n      },\n      include: {\n        type: 'string',\n        description: 'File extension filter, e.g. \"*.ts\" (optional)',\n      },\n    },\n    required: ['pattern'],\n  },\n  async execute(\n    input: Record<string, unknown>,\n    context: SandboxContext,\n  ): Promise<ToolResult> {\n    const pattern = input.pattern as string;\n    const searchPath = (input.path as string) ?? '.';\n    const include = input.include as string | undefined;\n\n    try {\n      const files = await walkDir(context.sandbox, searchPath);\n\n      // Filter by extension if include is specified (e.g. \"*.ts\" → \".ts\")\n      let filtered = files;\n      if (include) {\n        const ext = include.startsWith('*.') ? include.slice(1) : include;\n        filtered = files.filter((f) => f.endsWith(ext));\n      }\n\n      const matches: string[] = [];\n\n      for (const file of filtered) {\n        if (matches.length >= MAX_MATCHES) break;\n\n        let content: string;\n        try {\n          content = await context.sandbox.readFile(file);\n        } catch {\n          continue; // Skip unreadable files\n        }\n\n        const lines = content.split('\\n');\n        for (let i = 0; i < lines.length; i++) {\n          if (lines[i].includes(pattern)) {\n            matches.push(`${file}:${i + 1}:${lines[i]}`);\n            if (matches.length >= MAX_MATCHES) break;\n          }\n        }\n      }\n\n      if (matches.length === 0) {\n        return {\n          success: true,\n          output: 'No matches found.',\n          preview: 'No matches found.',\n        };\n      }\n\n      const output = matches.join('\\n');\n      const suffix = matches.length >= MAX_MATCHES ? `\\n(results capped at ${MAX_MATCHES})` : '';\n      return {\n        success: true,\n        output: output + suffix,\n        preview:\n          output.length > 200 ? output.slice(0, 200) + '...' : output,\n      };\n    } catch (err) {\n      return {\n        success: false,\n        output: null,\n        error: err instanceof Error ? err.message : String(err),\n      };\n    }\n  },\n};\n","// @yolo-labs/core-tools — Tool registry, tool execution, tool result types\n\nimport type { Tool } from '@yolo-labs/core-types';\n\nexport { ToolRegistryImpl } from './registry.js';\nexport { validateInput } from './validation.js';\nexport type { ValidationResult } from './validation.js';\n\n// Reference tools (opt-in)\nexport {\n  writeFileTool,\n  readFileTool,\n  listFilesTool,\n  deleteFileTool,\n  executeCommandTool,\n  editFileTool,\n  searchFilesTool,\n  walkDir,\n} from './reference/index.js';\nexport type { WalkOptions } from './reference/index.js';\n\nimport {\n  writeFileTool,\n  readFileTool,\n  listFilesTool,\n  deleteFileTool,\n  executeCommandTool,\n  editFileTool,\n  searchFilesTool,\n} from './reference/index.js';\n\n/**\n * Returns all 7 reference tools: read_file, write_file, list_files, delete_file,\n * execute_command, edit_file, search_files.\n *\n * @remarks\n * Convenience function for registering the standard tool set. Used by\n * {@link createHeadlessAgent} when `tools: 'default'` is specified in config.\n */\nexport function getDefaultTools(): Tool[] {\n  return [\n    readFileTool,\n    writeFileTool,\n    listFilesTool,\n    deleteFileTool,\n    executeCommandTool,\n    editFileTool,\n    searchFilesTool,\n  ];\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@yolo-labs/core-tools",
+  "version": "1.0.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@yolo-labs/core-types": "1.0.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0"
+  },
+  "description": "Tool registry, input validation, and reference tools for AI agents",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yolo-labs-hq/monorepo.git",
+    "directory": "yolo-core/packages/tools"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "homepage": "https://github.com/yolo-labs-hq/monorepo/tree/main/yolo-core#readme",
+  "bugs": {
+    "url": "https://github.com/yolo-labs-hq/monorepo/issues"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}