File Tool

interface FileTool extends Tool {
  name: "file";

  actions: {
    // Read
    read(path: string, encoding?: string): Promise<string>;
    readBinary(path: string): Promise<Buffer>;
    exists(path: string): Promise<boolean>;
    stat(path: string): Promise<FileStat>;

    // Write
    write(path: string, content: string): Promise<void>;
    writeBinary(path: string, content: Buffer): Promise<void>;
    append(path: string, content: string): Promise<void>;

    // Directory
    list(path: string, options?: ListOptions): Promise<FileInfo[]>;
    mkdir(path: string, recursive?: boolean): Promise<void>;

    // Search
    glob(pattern: string, options?: GlobOptions): Promise<string[]>;
    grep(pattern: string, path: string): Promise<GrepResult[]>;

    // Modify
    copy(src: string, dest: string): Promise<void>;
    move(src: string, dest: string): Promise<void>;
    delete(path: string): Promise<void>;

    // Watch
    watch(path: string, callback: WatchCallback): Promise<Watcher>;
  };
}

interface FileInfo {
  name: string;
  path: string;
  isDirectory: boolean;
  size: number;
  modified: Date;
}

// Read a file
const content = await file.read("/path/to/file.txt");

// Write a file
await file.write("/path/to/output.md", "# Hello\n\nWorld");

// Find all TypeScript files
const tsFiles = await file.glob("**/*.ts", { cwd: "/project" });

// Search for pattern in files
const matches = await file.grep("TODO", "/project/src");