computer: Add workspace file tools

.changeset/computer-workspace-file-tools.md

@@ -0,0 +1,5 @@
+---
+"@cloudflare/computer": minor
+---
+
+Add bounded `find` and `grep` tools, a read-only-aware `delete` tool, and shared locking for file mutations.

packages/computer/src/stub.test.ts

@@ -228,6 +228,18 @@ describe("WorkspaceStub", () => {
     });
   });
 
+  it("fs.find forwards bounded search options", async () => {
+    await withStub(async (ws) => {
+      const stub = ws.stub();
+      await ws.fs.writeFile("/a.ts", "");
+      await ws.fs.writeFile("/b.ts", "");
+      await ws.fs.writeFile("/c.ts", "");
+      expect(await stub.fs.find("/", "*.ts", { limit: 1, offset: 1 })).toEqual([
+        { path: "/b.ts", type: "file" },
+      ]);
+    });
+  });
+
   it("fs.stat propagates ENOENT for missing paths", async () => {
     await withStub(async (ws) => {
       const stub = ws.stub();

packages/computer/src/stub.ts

@@ -41,6 +41,7 @@
 
 import { trackStub, untrackStub } from "@cloudflare/computer-rpc/debug";
 import type {
+  FindOptions,
   GrepOptions,
   MkdirOptions,
   ReaddirOptions,
@@ -190,12 +191,16 @@ export class WorkspaceFilesystemStub extends RpcTarget {
     );
   }
 
-  find(directory: string, pattern?: string): Promise<WorkspaceFoundEntry[]> {
+  find(
+    directory: string,
+    pattern?: string,
+    options: FindOptions = {},
+  ): Promise<WorkspaceFoundEntry[]> {
     return withSpan(
       this.#ws.observer,
       "workspace.fs.find",
       { "workspace.fs.path": directory, "workspace.fs.pattern": pattern },
-      () => this.#ws.fs.find(directory, pattern),
+      () => this.#ws.fs.find(directory, pattern, options),
       (span, outcome) => {
         if (outcome.ok) span.setAttribute("workspace.fs.matches", outcome.value.length);
       },