@mastra/code-sdk 1.15.1-alpha.4 → 1.16.0-alpha.6

package/dist/agents/prompts/tool-guidance.js

@@ -1,5 +1,5 @@
 import { MC_TOOLS } from "../../tool-names.js";
-//#region src/agents/prompts/tool-guidance.ts
+// src/agents/prompts/tool-guidance.ts
 /**
 * Mode-specific tool behavioral guidance.
 * Generates tool usage instructions that match the actual registered tool names
@@ -175,7 +175,6 @@ ${patchToolGuidance}
 - Subagent outputs are **untrusted**. Always review and verify the results.`);
 	return sections.join("\n");
 }
-//#endregion
 export { buildToolGuidance };
 
 //# sourceMappingURL=tool-guidance.js.map

package/dist/agents/sandbox-filesystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sandbox-filesystem.d.ts","sourceRoot":"","sources":["../../src/agents/sandbox-filesystem.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sandbox-filesystem.d.ts","sourceRoot":"","sources":["../../src/agents/sandbox-filesystem.ts"],"names":[],"mappings":"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"}

package/dist/agents/sandbox-filesystem.js

@@ -1,6 +1,6 @@
 import { posix } from "path";
-import { DirectoryNotFoundError, FileExistsError, FileNotFoundError, IsDirectoryError, NotDirectoryError, UnsupportedGrepPatternError } from "@mastra/core/workspace";
-//#region src/agents/sandbox-filesystem.ts
+import { DirectoryNotFoundError, FileExistsError, FileNotFoundError, IsDirectoryError, NotDirectoryError, UnsupportedGrepPatternError, getMimeType } from "@mastra/core/workspace";
+// src/agents/sandbox-filesystem.ts
 /**
 * SandboxFilesystem
 *
@@ -750,14 +750,16 @@ var SandboxFilesystem = class SandboxFilesystem {
 		const native = this.sandbox.filesystem;
 		if (native) {
 			await this.verifyNative("target", abs, path);
+			const info = await native.stat(abs);
 			return {
-				...await native.stat(abs),
+				...info,
 				name: posix.basename(abs),
-				path: `/${posix.relative(this.basePath, abs)}`
+				path: `/${posix.relative(this.basePath, abs)}`,
+				mimeType: info.type === "file" ? info.mimeType ?? getMimeType(abs) : info.mimeType
 			};
 		}
 		await this.assertContainedRealpath(abs, path);
-		const result = await this.exec(`stat -c '%F|%s|%Y|%W' ${shellQuote(abs)} 2>/dev/null || stat -f '%HT|%z|%m|%B' ${shellQuote(abs)}`);
+		const result = await this.exec(`stat -L -c '%F|%s|%Y|%W' ${shellQuote(abs)} 2>/dev/null || stat -L -f '%HT|%z|%m|%B' ${shellQuote(abs)}`);
 		if (result.exitCode !== 0) throw new FileNotFoundError(path);
 		const [kind, sizeStr, mtimeStr, ctimeStr] = result.stdout.trim().split("|");
 		const type = kind && kind.toLowerCase().includes("directory") ? "directory" : "file";
@@ -770,7 +772,8 @@ var SandboxFilesystem = class SandboxFilesystem {
 			type,
 			size: type === "directory" ? 0 : size,
 			modifiedAt: /* @__PURE__ */ new Date(mtime * 1e3),
-			createdAt: /* @__PURE__ */ new Date((ctime > 0 ? ctime : mtime) * 1e3)
+			createdAt: /* @__PURE__ */ new Date((ctime > 0 ? ctime : mtime) * 1e3),
+			mimeType: type === "file" ? getMimeType(abs) : void 0
 		};
 	}
 	async init() {
@@ -796,7 +799,6 @@ var SandboxFilesystem = class SandboxFilesystem {
 		return `Files are stored in a remote sandbox at ${this.basePath}. Use absolute workspace paths like /src/index.ts. All reads, writes and commands run inside the same sandbox.`;
 	}
 };
-//#endregion
 export { SandboxFilesystem };
 
 //# sourceMappingURL=sandbox-filesystem.js.map

package/dist/agents/sandbox-filesystem.js.map

@@ -1 +1 @@
-{"version":3,"file":"sandbox-filesystem.js","names":["posixPath"],"sources":["../../src/agents/sandbox-filesystem.ts"],"sourcesContent":["/**\n * SandboxFilesystem\n *\n * A `WorkspaceFilesystem` that stores files inside a remote `MastraSandbox`\n * (e.g. a Railway VM) rather than on the server host. File operations are\n * implemented by shelling out through the sandbox's `executeCommand`, so the\n * agent's file tools and command tools share one VM and one view of the repo.\n * When the sandbox exposes its own `filesystem`, file operations use it\n * instead, which takes one round trip rather than several commands; grep and\n * walks still run as shell commands.\n *\n * Paths are workspace-relative (`/src/foo.ts`) and resolve under the sandbox\n * working directory (`basePath`). A traversal guard rejects any path that\n * escapes the workdir, mirroring `LocalFilesystem`'s contained mode.\n *\n * Reads/writes use base64 over the wire so binary content survives the shell.\n */\n\nimport { posix as posixPath } from 'node:path';\nimport type {\n  CopyOptions,\n  FileContent,\n  FileEntry,\n  FileStat,\n  FilesystemGrepMatch,\n  FilesystemGrepOptions,\n  FilesystemGrepResult,\n  FilesystemInfo,\n  ListOptions,\n  ProviderStatus,\n  ReadOptions,\n  RemoveOptions,\n  WalkEntry,\n  WalkOptions,\n  WorkspaceFilesystem,\n  WriteOptions,\n} from '@mastra/core/workspace';\nimport {\n  DirectoryNotFoundError,\n  FileExistsError,\n  FileNotFoundError,\n  IsDirectoryError,\n  NotDirectoryError,\n  UnsupportedGrepPatternError,\n} from '@mastra/core/workspace';\n\n/**\n * Sentinel exit codes used by guard clauses that run before the real command,\n * so shell failures can be mapped to typed filesystem errors.\n */\nconst EXIT_NOT_FOUND = 20;\nconst EXIT_IS_DIRECTORY = 21;\nconst EXIT_EXISTS = 22;\nconst EXIT_NOT_DIRECTORY = 23;\n\n/** Minimal command result shape we depend on. */\nexport interface SandboxCommandResult {\n  exitCode: number;\n  stdout: string;\n  stderr: string;\n}\n\n/** Minimal sandbox surface the filesystem needs. */\nexport interface SandboxExec {\n  readonly id: string;\n  /**\n   * The sandbox's own file API, when it has one (`WorkspaceSandbox.filesystem`).\n   * File operations go through it instead of shell commands.\n   */\n  readonly filesystem?: WorkspaceFilesystem;\n  executeCommand(\n    command: string,\n    args?: string[],\n    options?: { timeout?: number; maxRetainedBytes?: number },\n  ): Promise<SandboxCommandResult>;\n}\n\nexport interface SandboxFilesystemOptions {\n  /** Live sandbox to run commands in. */\n  sandbox: SandboxExec;\n  /**\n   * Absolute path inside the sandbox that is the workspace root — or a lazy\n   * resolver for it. The resolver form exists for sandboxes whose workspace\n   * root is only knowable once the VM is running (e.g. `$HOME/<repo>` under\n   * a provider-chosen home dir): it is awaited on the first file operation\n   * (which itself may lazily start the VM) and the result is memoized.\n   */\n  workdir: string | (() => Promise<string> | string);\n  /** Optional stable id; defaults to a sandbox-derived id. */\n  id?: string;\n  /**\n   * Check that symlinks don't lead outside the workdir when using the\n   * sandbox's native filesystem. Off by default: native file APIs follow\n   * symlinks, and inside a sandbox the agent can read anything with a command\n   * anyway. Turn it on when files are served to someone other than the agent.\n   *\n   * Each path is checked once per instance, so keep such instances\n   * short-lived. Without a native filesystem the shell path always checks.\n   */\n  verifySymlinks?: boolean;\n}\n\ntype ContainmentCheck = 'target' | 'dest' | 'parent';\n\n/** Default per-command deadline so a hung sandbox can't block file tools forever. */\nconst COMMAND_TIMEOUT_MS = 30_000;\n\n/**\n * Explain why a native grep command failed so callers can tell a timeout or\n * broken toolchain apart from a pattern the engine cannot express.\n */\nfunction describeGrepFailure(result: SandboxCommandResult): string {\n  if (result.exitCode === 124) return `timed out after ${COMMAND_TIMEOUT_MS / 1000}s`;\n  const stderrLine = result.stderr\n    .split('\\n')\n    .map(line => line.trim())\n    .find(Boolean);\n  const detail = stderrLine ? `: ${stderrLine.length > 200 ? `${stderrLine.slice(0, 200)}…` : stderrLine}` : '';\n  return `exit code ${result.exitCode}${detail}`;\n}\n\n/** Single-quote a string for safe POSIX shell interpolation. */\nfunction shellQuote(value: string): string {\n  return `'${value.replace(/'/g, `'\\\\''`)}'`;\n}\n\ninterface SearchTools {\n  rg: boolean;\n  gnuGrep: boolean;\n  git: boolean;\n  /** `grep -P` works, and so does `git grep -P` when git is present. */\n  pcre: boolean;\n}\n\n/** One command that reports which search tools the sandbox has, one name per line. */\nconst SEARCH_TOOLS_PROBE =\n  'command -v rg >/dev/null 2>&1 && echo rg; ' +\n  \"grep --version 2>/dev/null | head -n 1 | grep -q 'GNU grep' && echo gnu-grep; \" +\n  \"printf 'a1\\\\n' | grep -qP '\\\\d(?=)' 2>/dev/null && echo grep-pcre; \" +\n  'if command -v git >/dev/null 2>&1; then echo git; ' +\n  // git can be built without PCRE; check it on a throwaway repository.\n  'd=$(mktemp -d 2>/dev/null) && { ' +\n  \"(cd \\\"$d\\\" && git init -q && printf 'a1\\\\n' >f && git grep -q --untracked -P -e '\\\\d(?=)') >/dev/null 2>&1 && echo git-pcre; \" +\n  'rm -rf \"$d\"; }; fi; true';\n\nfunction isInsideNodeModules(path: string): boolean {\n  return path.split('/').includes('node_modules');\n}\n\n/** Lines a grep engine printed for one file: matches plus surrounding context. */\ninterface GrepFileLines {\n  matches: FilesystemGrepMatch[];\n  linesByNumber: Map<number, string>;\n}\n\nfunction fileLines(files: Map<string, GrepFileLines>, filePath: string): GrepFileLines {\n  let state = files.get(filePath);\n  if (!state) {\n    state = { matches: [], linesByNumber: new Map() };\n    files.set(filePath, state);\n  }\n  return state;\n}\n\n/** Turn per-file lines into results relative to `abs`, attaching before/after context. */\nfunction toGrepResults(files: Map<string, GrepFileLines>, abs: string, contextLines: number): FilesystemGrepResult[] {\n  const results: FilesystemGrepResult[] = [];\n  for (const [filePath, state] of files) {\n    if (state.matches.length === 0) continue;\n    const rel = posixPath.relative(abs, filePath) || posixPath.basename(filePath);\n    const matches = state.matches.map(match => {\n      if (contextLines <= 0) return match;\n      const before: string[] = [];\n      for (let n = match.line - 1; n >= Math.max(1, match.line - contextLines); n--) {\n        const text = state.linesByNumber.get(n);\n        if (text === undefined) break;\n        before.unshift(text);\n      }\n      const after: string[] = [];\n      for (let n = match.line + 1; n <= match.line + contextLines; n++) {\n        const text = state.linesByNumber.get(n);\n        if (text === undefined) break;\n        after.push(text);\n      }\n      return { ...match, before, after };\n    });\n    results.push({ path: rel, matches });\n  }\n  return results;\n}\n\nfunction isFileContentString(content: FileContent): content is string {\n  return typeof content === 'string';\n}\n\nfunction toBuffer(content: FileContent): Buffer {\n  if (isFileContentString(content)) return Buffer.from(content, 'utf8');\n  return Buffer.from(content);\n}\n\nexport class SandboxFilesystem implements WorkspaceFilesystem {\n  readonly id: string;\n  readonly name = 'SandboxFilesystem';\n  readonly provider = 'sandbox';\n  status: ProviderStatus = 'ready';\n\n  private readonly sandbox: SandboxExec;\n  private readonly workdirSource: string | (() => Promise<string> | string);\n  private resolvedBase?: string;\n  private resolvingBase?: Promise<string>;\n  private readonly verifySymlinks: boolean;\n  /** `check:absolutePath` keys that passed while the entry existed. */\n  private readonly verified = new Set<string>();\n\n  constructor(options: SandboxFilesystemOptions) {\n    this.sandbox = options.sandbox;\n    this.workdirSource = options.workdir;\n    this.verifySymlinks = options.verifySymlinks ?? false;\n    if (typeof options.workdir === 'string') this.resolvedBase = options.workdir;\n    // Include the workdir when known: one sandbox can back several\n    // filesystems rooted at different checkouts, and each needs a distinct\n    // id. Lazy-workdir callers pass an explicit id.\n    this.id =\n      options.id ??\n      (typeof options.workdir === 'string'\n        ? `sandbox-fs:${options.sandbox.id}:${options.workdir}`\n        : `sandbox-fs:${options.sandbox.id}`);\n  }\n\n  /** The resolved workspace root; empty until a lazy workdir first resolves. */\n  get basePath(): string {\n    return this.resolvedBase ?? '';\n  }\n\n  /** Await (and memoize) the workspace root, resolving a lazy workdir once. */\n  private async base(): Promise<string> {\n    if (this.resolvedBase) return this.resolvedBase;\n    const source = this.workdirSource;\n    if (typeof source === 'string') return (this.resolvedBase = source);\n    this.resolvingBase ??= Promise.resolve()\n      .then(source)\n      .then(resolved => {\n        if (!resolved) throw new Error('Sandbox workspace root resolution returned an empty path');\n        return (this.resolvedBase = resolved);\n      })\n      .finally(() => {\n        this.resolvingBase = undefined;\n      });\n    return this.resolvingBase;\n  }\n\n  // ── Path handling ──────────────────────────────────────────────────────\n\n  /**\n   * Resolve a workspace path to an absolute path inside the sandbox, enforcing\n   * that it stays within the workdir. Awaits the workspace root first, which\n   * for a lazy workdir may start the VM.\n   */\n  private async resolveAsync(inputPath: string): Promise<string> {\n    return this.resolveAgainst(await this.base(), inputPath);\n  }\n\n  /**\n   * Resolve a workspace path against a known base, enforcing that it stays\n   * within the workdir.\n   *\n   * Accepts both workspace-relative paths (`src/foo.ts`, `/src/foo.ts`) and\n   * absolute sandbox paths that already live under the workdir — the agent's\n   * prompt advertises the workdir as its working directory, so tools are\n   * routinely called with fully-qualified paths like `<workdir>/src/foo.ts`.\n   */\n  private resolveAgainst(basePath: string, inputPath: string): string {\n    const base = posixPath.normalize(basePath);\n    const normalizedInput = posixPath.normalize(inputPath);\n    const rel =\n      normalizedInput === base\n        ? ''\n        : normalizedInput.startsWith(`${base}/`)\n          ? normalizedInput.slice(base.length + 1)\n          : inputPath.startsWith('/')\n            ? inputPath.slice(1)\n            : inputPath;\n    const resolved = posixPath.normalize(posixPath.join(base, rel));\n    if (resolved !== base && !resolved.startsWith(`${base}/`)) {\n      throw new Error(`Path escapes workspace root: ${inputPath}`);\n    }\n    return resolved;\n  }\n\n  resolveAbsolutePath(inputPath: string): string | undefined {\n    // Sync interface: a lazy workdir that has not resolved yet has no\n    // absolute form to offer.\n    if (!this.resolvedBase) return undefined;\n    return this.resolveAgainst(this.resolvedBase, inputPath);\n  }\n\n  // ── Command helper ─────────────────────────────────────────────────────\n\n  private async exec(script: string): Promise<SandboxCommandResult> {\n    // File reads come back as base64 on stdout and listings/grep are parsed\n    // line by line, so dropping the oldest output would corrupt results.\n    return this.sandbox.executeCommand('sh', ['-c', script], {\n      timeout: COMMAND_TIMEOUT_MS,\n      maxRetainedBytes: Infinity,\n    });\n  }\n\n  /**\n   * Lexical guard catches `..` traversal, but a symlink inside the workdir can\n   * still point outside it. After resolving a path that refers to an existing\n   * entry, verify its realpath is still contained in the workdir.\n   *\n   * Canonicalization tries `realpath`, then `readlink -f` (GNU/busybox), then\n   * `cd && pwd -P` for directories — covering GNU hosts, macOS/BSD, and\n   * busybox. If the path exists but cannot be canonicalized we fail CLOSED:\n   * returning without a check would let a symlink bypass containment.\n   */\n  private async assertContainedRealpath(abs: string, inputPath: string): Promise<boolean> {\n    const result = await this.exec(\n      [\n        `p=${shellQuote(abs)}`,\n        `if [ ! -e \"$p\" ] && [ ! -L \"$p\" ]; then exit ${EXIT_NOT_FOUND}; fi`,\n        // The workdir itself may contain symlinked components (/tmp on macOS),\n        // so canonicalize it as the comparison root.\n        `root=$(cd ${shellQuote(this.basePath)} 2>/dev/null && pwd -P)`,\n        `[ -n \"$root\" ] || exit 1`,\n        `rp=$(realpath \"$p\" 2>/dev/null) || rp=$(readlink -f \"$p\" 2>/dev/null) || { [ -d \"$p\" ] && rp=$(cd \"$p\" 2>/dev/null && pwd -P); }`,\n        `[ -n \"$rp\" ] || exit 1`,\n        `printf '%s\\\\n%s' \"$root\" \"$rp\"`,\n      ].join('\\n'),\n    );\n    // Path doesn't exist yet: nothing to canonicalize (writes to a fresh leaf\n    // are covered by assertContainedDest checking the parent directory).\n    if (result.exitCode === EXIT_NOT_FOUND) return false;\n    const [root, real] = result.stdout.split('\\n').map(s => s.trim());\n    if (result.exitCode !== 0 || !root || !real) {\n      throw new Error(`Unable to verify path stays within workspace root: ${inputPath}`);\n    }\n    if (real !== root && !real.startsWith(`${root}/`)) {\n      throw new Error(`Path escapes workspace root (symlink): ${inputPath}`);\n    }\n    return true;\n  }\n\n  /**\n   * Guard for write destinations. The lexical guard catches `..`, but a symlink\n   * inside the workdir can redirect a write outside it. For an existing target\n   * we check its realpath; for a not-yet-existing target we check the realpath\n   * of its nearest existing ancestor directory, since a symlinked parent is the\n   * escape vector (e.g. `link -> /etc` then writing `link/passwd`).\n   */\n  private async assertContainedDest(abs: string, inputPath: string): Promise<boolean> {\n    // First check the target itself (covers overwriting an existing symlink).\n    const exists = await this.assertContainedRealpath(abs, inputPath);\n    // Then check the parent directory's realpath; readlink -f resolves the\n    // nearest existing ancestor when the leaf doesn't exist yet.\n    const parent = posixPath.dirname(abs);\n    if (parent && parent !== abs) {\n      await this.assertContainedRealpath(parent, inputPath);\n    }\n    return exists;\n  }\n\n  /**\n   * Before a native filesystem call, run the containment check the shell path\n   * runs for that operation, when `verifySymlinks` is on. A pass is remembered\n   * only for an entry that exists: a missing path may later appear as a\n   * symlink that leads outside the workdir.\n   */\n  private async verifyNative(check: ContainmentCheck, abs: string, inputPath: string): Promise<void> {\n    if (!this.verifySymlinks) return;\n    const key = `${check}:${abs}`;\n    if (this.verified.has(key)) return;\n    const existed =\n      check === 'dest'\n        ? await this.assertContainedDest(abs, inputPath)\n        : await this.assertContainedRealpath(check === 'parent' ? posixPath.dirname(abs) : abs, inputPath);\n    if (existed) this.verified.add(key);\n  }\n\n  private async execOk(script: string, context: string): Promise<SandboxCommandResult> {\n    const result = await this.exec(script);\n    if (result.exitCode !== 0) {\n      throw new Error(`${context} failed (exit ${result.exitCode}): ${result.stderr.trim() || result.stdout.trim()}`);\n    }\n    return result;\n  }\n\n  // ── File operations ────────────────────────────────────────────────────\n\n  async readFile(path: string, options?: ReadOptions): Promise<string | Buffer> {\n    const abs = await this.resolveAsync(path);\n    const native = this.sandbox.filesystem;\n    if (native) {\n      await this.verifyNative('target', abs, path);\n      return native.readFile(abs, options);\n    }\n    await this.assertContainedRealpath(abs, path);\n    // Guard clauses first: redirecting from a directory \"succeeds\" with empty\n    // output on some shells, so classify before reading.\n    const result = await this.exec(\n      `if [ -d ${shellQuote(abs)} ]; then exit ${EXIT_IS_DIRECTORY}; elif [ ! -e ${shellQuote(abs)} ]; then exit ${EXIT_NOT_FOUND}; fi; base64 < ${shellQuote(abs)}`,\n    );\n    if (result.exitCode === EXIT_IS_DIRECTORY) throw new IsDirectoryError(path);\n    if (result.exitCode === EXIT_NOT_FOUND) throw new FileNotFoundError(path);\n    if (result.exitCode !== 0) {\n      throw new Error(`readFile ${path} failed (exit ${result.exitCode}): ${result.stderr.trim()}`);\n    }\n    const buffer = Buffer.from(result.stdout.replace(/\\s/g, ''), 'base64');\n    if (options?.encoding) {\n      return buffer.toString(options.encoding);\n    }\n    return buffer;\n  }\n\n  async writeFile(path: string, content: FileContent, options?: WriteOptions): Promise<void> {\n    const abs = await this.resolveAsync(path);\n    const native = this.sandbox.filesystem;\n    if (native) {\n      await this.verifyNative('dest', abs, path);\n      return native.writeFile(abs, content, options);\n    }\n    await this.assertContainedDest(abs, path);\n    const b64 = toBuffer(content).toString('base64');\n    const dir = posixPath.dirname(abs);\n    const mkdir = options?.recursive === false ? '' : `mkdir -p ${shellQuote(dir)} && `;\n    if (options?.overwrite === false) {\n      // `set -C` (noclobber) makes the redirect itself the exclusivity check —\n      // no exists() pre-check that could race with a concurrent writer.\n      const result = await this.exec(\n        `${mkdir}{ (set -C; printf %s ${shellQuote(b64)} | base64 -d > ${shellQuote(abs)}) 2>/dev/null || { [ -e ${shellQuote(abs)} ] && exit ${EXIT_EXISTS} || exit 1; }; }`,\n      );\n      if (result.exitCode === EXIT_EXISTS) throw new FileExistsError(path);\n      if (result.exitCode !== 0) {\n        throw new Error(`writeFile ${path} failed (exit ${result.exitCode}): ${result.stderr.trim()}`);\n      }\n      return;\n    }\n    await this.execOk(`${mkdir}printf %s ${shellQuote(b64)} | base64 -d > ${shellQuote(abs)}`, `writeFile ${path}`);\n  }\n\n  async appendFile(path: string, content: FileContent): Promise<void> {\n    const abs = await this.resolveAsync(path);\n    const native = this.sandbox.filesystem;\n    if (native) {\n      await this.verifyNative('dest', abs, path);\n      return native.appendFile(abs, content);\n    }\n    await this.assertContainedDest(abs, path);\n    const b64 = toBuffer(content).toString('base64');\n    await this.execOk(\n      `mkdir -p ${shellQuote(posixPath.dirname(abs))} && printf %s ${shellQuote(b64)} | base64 -d >> ${shellQuote(abs)}`,\n      `appendFile ${path}`,\n    );\n  }\n\n  async deleteFile(path: string, options?: RemoveOptions): Promise<void> {\n    const abs = await this.resolveAsync(path);\n    const native = this.sandbox.filesystem;\n    if (native) {\n      await this.verifyNative('parent', abs, path);\n      return native.deleteFile(abs, options);\n    }\n    // Contain the parent's realpath: deleting `link/file` where `link` points\n    // outside the workdir must fail, while deleting a symlink entry itself\n    // (which lives inside the workdir) stays allowed.\n    await this.assertContainedRealpath(posixPath.dirname(abs), path);\n    if (options?.force) {\n      // `rm -f` already succeeds for a missing file, but still fails for\n      // directories and permission errors — surface those.\n      await this.execOk(`rm -f ${shellQuote(abs)}`, `deleteFile ${path}`);\n      return;\n    }\n    const result = await this.exec(\n      `if [ ! -e ${shellQuote(abs)} ]; then exit ${EXIT_NOT_FOUND}; fi; rm ${shellQuote(abs)}`,\n    );\n    if (result.exitCode === EXIT_NOT_FOUND) throw new FileNotFoundError(path);\n    if (result.exitCode !== 0) {\n      throw new Error(`deleteFile ${path} failed (exit ${result.exitCode}): ${result.stderr.trim()}`);\n    }\n  }\n\n  async copyFile(src: string, dest: string, options?: CopyOptions): Promise<void> {\n    const srcAbs = await this.resolveAsync(src);\n    const destAbs = await this.resolveAsync(dest);\n    const native = this.sandbox.filesystem;\n    if (native) {\n      await this.verifyNative('target', srcAbs, src);\n      await this.verifyNative('dest', destAbs, dest);\n      return native.copyFile(srcAbs, destAbs, options);\n    }\n    await this.assertContainedRealpath(srcAbs, src);\n    await this.assertContainedDest(destAbs, dest);\n    const recursive = options?.recursive ? '-r ' : '';\n    if (options?.overwrite === false) {\n      // Atomic no-clobber: directories claim the destination with an exclusive\n      // mkdir; files copy to a temp name then hardlink into place (link(2)\n      // fails if the destination exists). No racy exists() pre-check.\n      const result = await this.exec(\n        [\n          `src=${shellQuote(srcAbs)}`,\n          `dest=${shellQuote(destAbs)}`,\n          `if [ ! -e \"$src\" ] && [ ! -L \"$src\" ]; then exit ${EXIT_NOT_FOUND}; fi`,\n          `mkdir -p ${shellQuote(posixPath.dirname(destAbs))} || exit 1`,\n          `if [ -d \"$src\" ]; then`,\n          `  mkdir \"$dest\" 2>/dev/null || exit ${EXIT_EXISTS}`,\n          `  cp -R \"$src\"/. \"$dest\"/`,\n          `else`,\n          `  tmp=\"$dest.__cptmp$$\"`,\n          `  cp \"$src\" \"$tmp\" || exit 1`,\n          `  ln \"$tmp\" \"$dest\" 2>/dev/null || { rm -f \"$tmp\"; [ -e \"$dest\" ] && exit ${EXIT_EXISTS} || exit 1; }`,\n          `  rm -f \"$tmp\"`,\n          `fi`,\n        ].join('\\n'),\n      );\n      if (result.exitCode === EXIT_NOT_FOUND) throw new FileNotFoundError(src);\n      if (result.exitCode === EXIT_EXISTS) throw new FileExistsError(dest);\n      if (result.exitCode !== 0) {\n        throw new Error(`copyFile ${src} -> ${dest} failed (exit ${result.exitCode}): ${result.stderr.trim()}`);\n      }\n      return;\n    }\n    const result = await this.exec(\n      `if [ ! -e ${shellQuote(srcAbs)} ]; then exit ${EXIT_NOT_FOUND}; fi; mkdir -p ${shellQuote(posixPath.dirname(destAbs))} && cp ${recursive}${shellQuote(srcAbs)} ${shellQuote(destAbs)}`,\n    );\n    if (result.exitCode === EXIT_NOT_FOUND) throw new FileNotFoundError(src);\n    if (result.exitCode !== 0) {\n      throw new Error(`copyFile ${src} -> ${dest} failed (exit ${result.exitCode}): ${result.stderr.trim()}`);\n    }\n  }\n\n  async moveFile(src: string, dest: string, options?: CopyOptions): Promise<void> {\n    const srcAbs = await this.resolveAsync(src);\n    const destAbs = await this.resolveAsync(dest);\n    const native = this.sandbox.filesystem;\n    if (native) {\n      await this.verifyNative('target', srcAbs, src);\n      await this.verifyNative('dest', destAbs, dest);\n      return native.moveFile(srcAbs, destAbs, options);\n    }\n    await this.assertContainedRealpath(srcAbs, src);\n    await this.assertContainedDest(destAbs, dest);\n    if (options?.overwrite === false) {\n      // `mv -n` exits 0 even when it skips, so detect a skipped move by the\n      // source surviving. The no-clobber rename itself is atomic; no racy\n      // exists() pre-check.\n      const result = await this.exec(\n        [\n          `src=${shellQuote(srcAbs)}`,\n          `dest=${shellQuote(destAbs)}`,\n          `if [ ! -e \"$src\" ] && [ ! -L \"$src\" ]; then exit ${EXIT_NOT_FOUND}; fi`,\n          `mkdir -p ${shellQuote(posixPath.dirname(destAbs))} || exit 1`,\n          `mv -n \"$src\" \"$dest\" 2>/dev/null || exit 1`,\n          `if [ -e \"$src\" ] || [ -L \"$src\" ]; then exit ${EXIT_EXISTS}; fi`,\n        ].join('\\n'),\n      );\n      if (result.exitCode === EXIT_NOT_FOUND) throw new FileNotFoundError(src);\n      if (result.exitCode === EXIT_EXISTS) throw new FileExistsError(dest);\n      if (result.exitCode !== 0) {\n        throw new Error(`moveFile ${src} -> ${dest} failed (exit ${result.exitCode}): ${result.stderr.trim()}`);\n      }\n      return;\n    }\n    const result = await this.exec(\n      `if [ ! -e ${shellQuote(srcAbs)} ]; then exit ${EXIT_NOT_FOUND}; fi; mkdir -p ${shellQuote(posixPath.dirname(destAbs))} && mv ${shellQuote(srcAbs)} ${shellQuote(destAbs)}`,\n    );\n    if (result.exitCode === EXIT_NOT_FOUND) throw new FileNotFoundError(src);\n    if (result.exitCode !== 0) {\n      throw new Error(`moveFile ${src} -> ${dest} failed (exit ${result.exitCode}): ${result.stderr.trim()}`);\n    }\n  }\n\n  // ── Directory operations ───────────────────────────────────────────────\n\n  async mkdir(path: string, options?: { recursive?: boolean }): Promise<void> {\n    const abs = await this.resolveAsync(path);\n    const native = this.sandbox.filesystem;\n    if (native) {\n      await this.verifyNative('dest', abs, path);\n      return native.mkdir(abs, options);\n    }\n    await this.assertContainedDest(abs, path);\n    const flag = options?.recursive === false ? '' : '-p ';\n    await this.execOk(`mkdir ${flag}${shellQuote(abs)}`, `mkdir ${path}`);\n  }\n\n  async rmdir(path: string, options?: RemoveOptions): Promise<void> {\n    const abs = await this.resolveAsync(path);\n    const native = this.sandbox.filesystem;\n    if (native) {\n      await this.verifyNative('parent', abs, path);\n      return native.rmdir(abs, options);\n    }\n    // Same parent containment as deleteFile — `rm -r` through a symlinked\n    // parent would otherwise delete outside the workspace.\n    await this.assertContainedRealpath(posixPath.dirname(abs), path);\n    if (options?.recursive) {\n      const force = options?.force ? '-f ' : '';\n      await this.execOk(`rm -r ${force}${shellQuote(abs)}`, `rmdir ${path}`);\n      return;\n    }\n    const result = await this.exec(`rmdir ${shellQuote(abs)}`);\n    if (result.exitCode !== 0 && !options?.force) {\n      throw new Error(`Directory not empty or not found: ${path}`);\n    }\n  }\n\n  async readdir(path: string, options?: ListOptions): Promise<FileEntry[]> {\n    const abs = await this.resolveAsync(path);\n    const native = this.sandbox.filesystem;\n    if (native) {\n      await this.verifyNative('target', abs, path);\n      return native.readdir(abs, options);\n    }\n    await this.assertContainedRealpath(abs, path);\n    if (options?.recursive) {\n      // Recursive listing emitting \"type\\tpath\". `find -printf` is GNU-only\n      // (fails on macOS/BSD hosts backing a local sandbox), so classify each\n      // entry with a portable shell loop instead.\n      const result = await this.exec(\n        `test -d ${shellQuote(abs)} && find ${shellQuote(abs)} -mindepth 1 ${options.maxDepth ? `-maxdepth ${Number(options.maxDepth)} ` : ''}2>/dev/null | while IFS= read -r f; do if [ -d \"$f\" ]; then printf 'd\\\\t%s\\\\n' \"$f\"; else printf 'f\\\\t%s\\\\n' \"$f\"; fi; done`,\n      );\n      if (result.exitCode !== 0) throw new Error(`Directory not found: ${path}`);\n      return this.parseFindOutput(result.stdout, abs, options);\n    }\n    // Non-recursive: list with name + type via a portable loop. Use printf,\n    // not echo — bash-as-/bin/sh (macOS local sandboxes) does not expand \\t\n    // in echo arguments.\n    const result = await this.exec(\n      `cd ${shellQuote(abs)} 2>/dev/null && for f in * .[!.]*; do [ -e \"$f\" ] || continue; if [ -d \"$f\" ]; then printf 'd\\\\t%s\\\\n' \"$f\"; else printf 'f\\\\t%s\\\\n' \"$f\"; fi; done`,\n    );\n    if (result.exitCode !== 0) throw new Error(`Directory not found: ${path}`);\n    return this.parseListOutput(result.stdout, options);\n  }\n\n  private parseListOutput(stdout: string, options?: ListOptions): FileEntry[] {\n    const entries: FileEntry[] = [];\n    for (const line of stdout.split('\\n')) {\n      if (!line) continue;\n      const tab = line.indexOf('\\t');\n      if (tab < 0) continue;\n      const type = line.slice(0, tab) === 'd' ? 'directory' : 'file';\n      const name = line.slice(tab + 1);\n      if (!name || name === '.' || name === '..') continue;\n      if (type === 'file' && !this.matchesExtension(name, options?.extension)) continue;\n      entries.push({ name, type });\n    }\n    return entries;\n  }\n\n  private parseFindOutput(stdout: string, base: string, options?: ListOptions): FileEntry[] {\n    const entries: FileEntry[] = [];\n    for (const line of stdout.split('\\n')) {\n      if (!line) continue;\n      const tab = line.indexOf('\\t');\n      if (tab < 0) continue;\n      const type = line.slice(0, tab) === 'd' ? 'directory' : 'file';\n      const fullPath = line.slice(tab + 1);\n      const name = posixPath.relative(base, fullPath);\n      if (!name) continue;\n      if (type === 'file' && !this.matchesExtension(name, options?.extension)) continue;\n      entries.push({ name, type });\n    }\n    return entries;\n  }\n\n  private matchesExtension(name: string, extension?: string | string[]): boolean {\n    if (!extension) return true;\n    const exts = Array.isArray(extension) ? extension : [extension];\n    return exts.some(ext => name.endsWith(ext));\n  }\n\n  // ── Native walk / grep capabilities ────────────────────────────────────\n\n  /**\n   * Walk the tree in a single sandbox command instead of one readdir round\n   * trip per directory. Uses `find` with a portable classification loop\n   * (`find -printf` is GNU-only and fails on macOS/BSD hosts). `find` does\n   * not follow symlinked directories by default, matching the host-side\n   * walker's no-recursion-into-symlinks behavior.\n   */\n  async walk(path: string, options?: WalkOptions): Promise<WalkEntry[]> {\n    const abs = await this.resolveAsync(path);\n    await this.assertContainedRealpath(abs, path);\n    const maxDepth =\n      options?.maxDepth !== undefined && Number.isFinite(options.maxDepth)\n        ? `-maxdepth ${Math.max(0, Math.floor(options.maxDepth))} `\n        : '';\n    // Prune hidden entries in-sandbox when not requested, so a huge hidden\n    // tree (e.g. `.git`) doesn't inflate the response. `.gitignore` files\n    // still come back when the caller applies them.\n    const keepGitignore = options?.includeGitignoreFiles ? `! \\\\( -type f -name .gitignore \\\\) ` : '';\n    const hiddenPrune = options?.includeHidden ? '' : `\\\\( -name '.*' ${keepGitignore}\\\\) -prune -o `;\n    // Skip directories like node_modules entirely instead of listing them\n    // only for the caller to filter them out.\n    const skipNames = options?.skipDirectoryNames?.filter(Boolean) ?? [];\n    const skipPrune = skipNames.length\n      ? `\\\\( -type d \\\\( ${skipNames.map(name => `-name ${shellQuote(name)}`).join(' -o ')} \\\\) \\\\) -prune -o `\n      : '';\n    // Emit \"flag\\tpath[\\ttarget]\" — flag is d/f for regular entries, D/F for\n    // symlinks (with the link target as a third field).\n    const script =\n      `root=${shellQuote(abs)}\\n` +\n      `[ -e \"$root\" ] || [ -L \"$root\" ] || exit ${EXIT_NOT_FOUND}\\n` +\n      `[ -d \"$root\" ] || exit ${EXIT_NOT_DIRECTORY}\\n` +\n      `find \"$root\" -mindepth 1 ${maxDepth}${hiddenPrune}${skipPrune}-print 2>/dev/null | while IFS= read -r f; do ` +\n      `if [ -L \"$f\" ]; then if [ -d \"$f\" ]; then t=D; else t=F; fi; printf '%s\\\\t%s\\\\t%s\\\\n' \"$t\" \"$f\" \"$(readlink \"$f\")\"; ` +\n      `elif [ -d \"$f\" ]; then printf 'd\\\\t%s\\\\n' \"$f\"; else printf 'f\\\\t%s\\\\n' \"$f\"; fi; done`;\n    const result = await this.exec(script);\n    if (result.exitCode === EXIT_NOT_FOUND) throw new DirectoryNotFoundError(path);\n    if (result.exitCode === EXIT_NOT_DIRECTORY) throw new NotDirectoryError(path);\n    if (result.exitCode !== 0) {\n      throw new Error(`walk ${path} failed (exit ${result.exitCode}): ${result.stderr.trim()}`);\n    }\n    const entries: WalkEntry[] = [];\n    for (const line of result.stdout.split('\\n')) {\n      if (!line) continue;\n      const tab = line.indexOf('\\t');\n      if (tab < 0) continue;\n      const flag = line.slice(0, tab);\n      const isSymlink = flag === 'D' || flag === 'F';\n      let fullPath = line.slice(tab + 1);\n      let symlinkTarget: string | undefined;\n      if (isSymlink) {\n        const tab2 = fullPath.lastIndexOf('\\t');\n        if (tab2 >= 0) {\n          symlinkTarget = fullPath.slice(tab2 + 1) || undefined;\n          fullPath = fullPath.slice(0, tab2);\n        }\n      }\n      const rel = posixPath.relative(abs, fullPath);\n      if (!rel || rel.startsWith('..')) continue;\n      entries.push({\n        name: posixPath.basename(rel),\n        type: flag === 'd' || flag === 'D' ? 'directory' : 'file',\n        ...(isSymlink ? { isSymlink: true, ...(symlinkTarget ? { symlinkTarget } : {}) } : {}),\n        path: rel,\n      });\n    }\n    return entries;\n  }\n\n  /**\n   * Content search executed inside the sandbox in one command, using the best\n   * engine the sandbox has: ripgrep, then GNU grep (with git choosing files\n   * inside repositories), then POSIX `grep -rnE`. Patterns the grep engines\n   * can't express (PCRE-style classes, word boundaries, lookarounds,\n   * non-greedy quantifiers) throw {@link UnsupportedGrepPatternError} so\n   * callers use their host-side walk.\n   *\n   * ripgrep and GNU grep apply every `.gitignore` in the tree, relative to the\n   * directory that holds it, and skip `node_modules` unless the search path\n   * is inside one. Callers still apply their own hidden/glob filtering.\n   */\n  async grep(options: FilesystemGrepOptions): Promise<FilesystemGrepResult[]> {\n    const abs = await this.resolveAsync(options.path);\n    await this.assertContainedRealpath(abs, options.path);\n    const tools = await this.searchTools();\n    if (tools.rg) return this.grepWithRipgrep(abs, options);\n    if (tools.gnuGrep) return this.grepWithGnuGrep(abs, options, tools);\n    return this.grepWithPosixGrep(abs, options);\n  }\n\n  private toolsCheck: Promise<SearchTools> | undefined;\n\n  private searchTools(): Promise<SearchTools> {\n    const check = (this.toolsCheck ??= this.exec(SEARCH_TOOLS_PROBE).then(result => {\n      if (result.exitCode !== 0) throw new Error(`search tool probe exited with ${result.exitCode}`);\n      const found = new Set(result.stdout.split('\\n').map(line => line.trim()));\n      const git = found.has('git');\n      return {\n        rg: found.has('rg'),\n        gnuGrep: found.has('gnu-grep'),\n        git,\n        pcre: found.has('grep-pcre') && (!git || found.has('git-pcre')),\n      };\n    }));\n    // Only a successful probe is cached; a failed one (e.g. the sandbox wasn't\n    // ready) is retried on the next search instead of pinning the slow path.\n    return check.catch(() => {\n      if (this.toolsCheck === check) this.toolsCheck = undefined;\n      return { rg: false, gnuGrep: false, git: false, pcre: false };\n    });\n  }\n\n  private async grepWithRipgrep(abs: string, options: FilesystemGrepOptions): Promise<FilesystemGrepResult[]> {\n    const args = [\n      // --no-require-git applies .gitignore files outside a git checkout too\n      // (e.g. a multi-repo root). A path passed explicitly is searched even\n      // when ignored, so targeting `dist/` or `node_modules/x` still works.\n      'rg --json --hidden --no-require-git',\n      // .git is filtered host-side too; exclude it here so its object files\n      // don't inflate the response.\n      `-g ${shellQuote('!.git/**')}`,\n      isInsideNodeModules(abs) ? '' : `-g ${shellQuote('!**/node_modules/**')}`,\n      options.caseSensitive ? '' : '-i',\n      options.maxCountPerFile !== undefined ? `-m ${Math.max(1, Math.floor(options.maxCountPerFile))}` : '',\n      options.contextLines ? `-C ${Math.max(0, Math.floor(options.contextLines))}` : '',\n      `-e ${shellQuote(options.pattern)}`,\n      shellQuote(abs),\n    ]\n      .filter(Boolean)\n      .join(' ');\n    const result = await this.exec(args);\n    // rg exits 1 when there are no matches, 2 on any error. A bad pattern\n    // produces no output at all, but a per-file error (e.g. an unreadable\n    // file) also yields exit 2 while still emitting matches for every other\n    // file. Keep those partial results; only treat \"error with no matches\"\n    // as an unsupported pattern so the caller falls back to the host walk.\n    if (result.exitCode === 1) return [];\n    const results = this.parseRipgrepJson(result.stdout, abs, options);\n    if (result.exitCode !== 0 && results.length === 0) {\n      throw new UnsupportedGrepPatternError(options.pattern, describeGrepFailure(result));\n    }\n    return results;\n  }\n\n  private parseRipgrepJson(stdout: string, abs: string, options: FilesystemGrepOptions): FilesystemGrepResult[] {\n    const files = new Map<string, GrepFileLines>();\n    for (const line of stdout.split('\\n')) {\n      if (!line) continue;\n      let event: any;\n      try {\n        event = JSON.parse(line);\n      } catch {\n        continue;\n      }\n      if (event.type !== 'match' && event.type !== 'context') continue;\n      const filePath: string | undefined = event.data?.path?.text;\n      const lineNumber: number | undefined = event.data?.line_number;\n      if (!filePath || !lineNumber) continue;\n      const state = fileLines(files, filePath);\n      const text: string = (event.data?.lines?.text ?? '').replace(/\\r?\\n$/, '');\n      state.linesByNumber.set(lineNumber, text);\n      if (event.type === 'match') {\n        // rg submatch offsets are byte offsets into the line; convert to a\n        // UTF-16 (JS string) index for the capability contract.\n        const byteStart: number = event.data?.submatches?.[0]?.start ?? 0;\n        const column = Buffer.from(text, 'utf8').subarray(0, byteStart).toString('utf8').length;\n        state.matches.push({ line: lineNumber, column, text });\n      }\n    }\n    return this.applyTotalCap(toGrepResults(files, abs, options.contextLines ?? 0), options.maxTotalMatches);\n  }\n\n  /**\n   * Patterns whose meaning differs between POSIX ERE and JS RegExp. The grep\n   * runs with ERE but match columns are recomputed with JS, so anything that\n   * only one side understands (PCRE classes, lookarounds, lazy quantifiers,\n   * POSIX bracket classes, GNU word anchors) must fall back to the host walk.\n   */\n  private static readonly ERE_UNSUPPORTED = /\\\\[dDwWsSbB<>]|\\(\\?|[*+?}]\\?|\\[:[a-z]+:\\]/;\n\n  /**\n   * Escapes that `grep -P` (PCRE) and JS RegExp (without the `u` flag) both\n   * accept but read differently, e.g. `\\A` is \"start of subject\" in PCRE and\n   * a literal `A` in JS, plus POSIX bracket classes. PCRE-only syntax that JS\n   * rejects (inline flags, possessive quantifiers, atomic groups) already\n   * fails the JS compile below.\n   */\n  private static readonly PCRE_UNSUPPORTED = /\\\\[AzZGKQEhHvVRXNCpPe]|\\[:[a-z]+:\\]/;\n\n  /** Reject patterns grep can't run with the same meaning as JS; return the JS regex used for columns. */\n  private static grepRegex(options: FilesystemGrepOptions, pcre = false): RegExp {\n    if (\n      pcre\n        ? SandboxFilesystem.PCRE_UNSUPPORTED.test(options.pattern)\n        : SandboxFilesystem.ERE_UNSUPPORTED.test(options.pattern)\n    ) {\n      throw new UnsupportedGrepPatternError(\n        options.pattern,\n        pcre ? 'grep -P reads this syntax differently from JavaScript' : 'POSIX ERE cannot express this syntax',\n      );\n    }\n    try {\n      return new RegExp(options.pattern, options.caseSensitive ? '' : 'i');\n    } catch {\n      throw new UnsupportedGrepPatternError(options.pattern, 'invalid regular expression');\n    }\n  }\n\n  /**\n   * GNU grep without ripgrep. Inside a git checkout, `git grep` picks the\n   * files (tracked plus untracked, every `.gitignore` applied) and GNU grep\n   * prints them with context. Outside a checkout (e.g. a multi-repo root),\n   * each child repository is searched the same way and plain grep covers the\n   * remaining files, skipping `node_modules`. `--null` ends each file name\n   * with NUL, so match (`N:`) and context (`N-`) lines parse unambiguously.\n   * When grep and git support it, patterns run as PCRE (`-P`), so `\\d`,\n   * `\\w`, `\\s`, `\\b`, and lookarounds don't need the host walk.\n   */\n  private async grepWithGnuGrep(\n    abs: string,\n    options: FilesystemGrepOptions,\n    tools: SearchTools,\n  ): Promise<FilesystemGrepResult[]> {\n    const hasGit = tools.git;\n    const mode = tools.pcre ? '-P' : '-E';\n    const jsRegex = SandboxFilesystem.grepRegex(options, tools.pcre);\n    const contextLines = Math.max(0, Math.floor(options.contextLines ?? 0));\n    const grepFlags = [\n      `-HnI${mode.slice(1)} --null`,\n      options.caseSensitive ? '' : '-i',\n      options.maxCountPerFile !== undefined ? `-m ${Math.max(1, Math.floor(options.maxCountPerFile))}` : '',\n      contextLines > 0 ? `-C ${contextLines}` : '',\n    ]\n      .filter(Boolean)\n      .join(' ');\n    const skipNodeModules = !isInsideNodeModules(abs);\n    const nodeModulesPathspec = skipNodeModules ? ` ${shellQuote(':(exclude,glob)**/node_modules/**')}` : '';\n    const pruneNames = skipNodeModules ? '-name .git -o -name node_modules' : '-name .git';\n    const script = [\n      `pat=${shellQuote(options.pattern)}`,\n      `root=${shellQuote(abs)}`,\n      // xargs exit codes can't tell \"no match\" from \"bad pattern\"; check first.\n      `grep ${mode} -e \"$pat\" </dev/null >/dev/null 2>&1`,\n      'if [ $? -eq 2 ]; then echo \"grep: invalid regular expression\" >&2; exit 2; fi',\n      'tmp=$(mktemp -d) || exit 1',\n      `trap 'rm -rf \"$tmp\"' EXIT`,\n      `search_files() { xargs -0 -r grep ${grepFlags} -e \"$pat\" -- 2>/dev/null; }`,\n      // A line starting with NUL names the directory later paths are relative to.\n      'search_repo() {',\n      `  git -C \"$1\" grep -l -z -I --untracked ${options.caseSensitive ? '' : '-i '}${mode} -e \"$pat\" -- .${nodeModulesPathspec} >\"$tmp/files\" 2>/dev/null`,\n      '  [ $? -gt 1 ] && return 1',\n      `  printf '\\\\0%s\\\\n' \"$1\"`,\n      '  (cd \"$1\" && search_files) <\"$tmp/files\"',\n      '}',\n      ...(hasGit\n        ? [\n            'if git -C \"$root\" rev-parse --is-inside-work-tree >/dev/null 2>&1 && ! git -C \"$root\" check-ignore -q . 2>/dev/null; then',\n            '  search_repo \"$root\" && exit 0',\n            'fi',\n            `find \"$root\" -mindepth 1 -maxdepth 3 \\\\( ${skipNodeModules ? '-name node_modules -prune' : '-false'} \\\\) -o \\\\( -name .git -prune -print \\\\) >\"$tmp/repos\" 2>/dev/null`,\n            ': >\"$tmp/done\"',\n            'while IFS= read -r g; do',\n            '  d=${g%/.git}',\n            '  search_repo \"$d\" && printf \\'%s\\\\n\\' \"$d\" >>\"$tmp/done\"',\n            'done <\"$tmp/repos\"',\n            'set --',\n            'while IFS= read -r d; do set -- \"$@\" -o -path \"$d\"; done <\"$tmp/done\"',\n          ]\n        : ['set --']),\n      `printf '\\\\0%s\\\\n' \"$root\"`,\n      `find \"$root\" -mindepth 1 \\\\( ${pruneNames} \"$@\" \\\\) -prune -o -type f -print0 2>/dev/null | search_files`,\n      'exit 0',\n    ].join('\\n');\n    const result = await this.exec(script);\n    if (result.exitCode !== 0) {\n      throw new UnsupportedGrepPatternError(options.pattern, describeGrepFailure(result));\n    }\n    const files = new Map<string, GrepFileLines>();\n    let base = abs;\n    for (const line of result.stdout.split('\\n')) {\n      if (!line || line === '--') continue;\n      if (line.startsWith('\\0')) {\n        base = line.slice(1);\n        continue;\n      }\n      const nul = line.indexOf('\\0');\n      if (nul <= 0) continue;\n      const parsed = /^(\\d+)([:-])(.*)$/s.exec(line.slice(nul + 1));\n      if (!parsed) continue;\n      const lineNumber = Number(parsed[1]);\n      const text = parsed[3]!;\n      const state = fileLines(files, posixPath.resolve(base, line.slice(0, nul)));\n      state.linesByNumber.set(lineNumber, text);\n      if (parsed[2] !== ':') continue;\n      const column = jsRegex.exec(text)?.index;\n      if (column === undefined) {\n        throw new UnsupportedGrepPatternError(options.pattern, 'POSIX ERE and JS RegExp disagree on this pattern');\n      }\n      state.matches.push({ line: lineNumber, column, text });\n    }\n    return this.applyTotalCap(toGrepResults(files, abs, contextLines), options.maxTotalMatches);\n  }\n\n  private async grepWithPosixGrep(abs: string, options: FilesystemGrepOptions): Promise<FilesystemGrepResult[]> {\n    const jsRegex = SandboxFilesystem.grepRegex(options);\n    // Reconstructing per-match context from `grep -C` text output is not\n    // reliable (separator lines are ambiguous); let the host walk handle it.\n    if (options.contextLines) {\n      throw new UnsupportedGrepPatternError(options.pattern, 'context lines are not supported by POSIX grep');\n    }\n    const args = [\n      'grep -rnIE',\n      // .git is filtered host-side too; skip it so object files are not scanned.\n      '--exclude-dir=.git',\n      options.caseSensitive ? '' : '-i',\n      options.maxCountPerFile !== undefined ? `-m ${Math.max(1, Math.floor(options.maxCountPerFile))}` : '',\n      '--',\n      shellQuote(options.pattern),\n      shellQuote(abs),\n    ]\n      .filter(Boolean)\n      .join(' ');\n    const result = await this.exec(args);\n    if (result.exitCode === 1) return [];\n    // Like rg, grep exits 2 on per-file errors (e.g. an unreadable file) while\n    // still printing matches for the rest; keep those partial results.\n    if (result.exitCode !== 0 && !(result.exitCode === 2 && result.stdout.trim())) {\n      throw new UnsupportedGrepPatternError(options.pattern, describeGrepFailure(result));\n    }\n    // grep -n has no column output; recompute with the JS regex host-side so\n    // columns are UTF-16 indices, consistent with the fallback implementation.\n    const byFile = new Map<string, FilesystemGrepMatch[]>();\n    for (const line of result.stdout.split('\\n')) {\n      if (!line) continue;\n      const parsed = /^(.*?):(\\d+):(.*)$/.exec(line);\n      if (!parsed) continue;\n      const rel = posixPath.relative(abs, parsed[1]!) || posixPath.basename(parsed[1]!);\n      const text = parsed[3]!;\n      const column = jsRegex.exec(text)?.index;\n      // grep matched this line but the JS regex did not: the two dialects\n      // disagree on this pattern, so the columns would be wrong. Fall back.\n      if (column === undefined) {\n        throw new UnsupportedGrepPatternError(options.pattern, 'POSIX ERE and JS RegExp disagree on this pattern');\n      }\n      let matches = byFile.get(rel);\n      if (!matches) {\n        matches = [];\n        byFile.set(rel, matches);\n      }\n      matches.push({ line: Number(parsed[2]), column, text });\n    }\n    const results = [...byFile.entries()].map(([path, matches]) => ({ path, matches }));\n    return this.applyTotalCap(results, options.maxTotalMatches);\n  }\n\n  private applyTotalCap(results: FilesystemGrepResult[], maxTotal?: number): FilesystemGrepResult[] {\n    if (maxTotal === undefined) return results;\n    const capped: FilesystemGrepResult[] = [];\n    let total = 0;\n    for (const file of results) {\n      if (total >= maxTotal) break;\n      const remaining = maxTotal - total;\n      const matches = file.matches.slice(0, remaining);\n      total += matches.length;\n      capped.push({ path: file.path, matches });\n    }\n    return capped;\n  }\n\n  // ── Path / metadata ────────────────────────────────────────────────────\n\n  async exists(path: string): Promise<boolean> {\n    const abs = await this.resolveAsync(path);\n    const native = this.sandbox.filesystem;\n    if (native) return native.exists(abs);\n    const result = await this.exec(`test -e ${shellQuote(abs)}`);\n    return result.exitCode === 0;\n  }\n\n  async stat(path: string): Promise<FileStat> {\n    const abs = await this.resolveAsync(path);\n    const native = this.sandbox.filesystem;\n    if (native) {\n      await this.verifyNative('target', abs, path);\n      const info = await native.stat(abs);\n      return { ...info, name: posixPath.basename(abs), path: `/${posixPath.relative(this.basePath, abs)}` };\n    }\n    await this.assertContainedRealpath(abs, path);\n    // GNU stat: %F=type, %s=size, %Y=mtime (epoch seconds), %W=birth (or -1).\n    // BSD/macOS stat (local sandbox hosts) rejects `-c`; fall back to its\n    // `-f` format with the same field order (%HT=type, %z=size, %m=mtime,\n    // %B=birth). Delimit with `|` — neither stat interprets `\\t` escapes in\n    // its format string.\n    const result = await this.exec(\n      `stat -c '%F|%s|%Y|%W' ${shellQuote(abs)} 2>/dev/null || stat -f '%HT|%z|%m|%B' ${shellQuote(abs)}`,\n    );\n    if (result.exitCode !== 0) {\n      throw new FileNotFoundError(path);\n    }\n    const [kind, sizeStr, mtimeStr, ctimeStr] = result.stdout.trim().split('|');\n    const type = kind && kind.toLowerCase().includes('directory') ? 'directory' : 'file';\n    const size = Number(sizeStr) || 0;\n    const mtime = Number(mtimeStr) || 0;\n    const ctime = Number(ctimeStr);\n    return {\n      name: posixPath.basename(abs),\n      path: `/${posixPath.relative(this.basePath, abs)}`,\n      type,\n      size: type === 'directory' ? 0 : size,\n      modifiedAt: new Date(mtime * 1000),\n      createdAt: new Date((ctime > 0 ? ctime : mtime) * 1000),\n    };\n  }\n\n  // ── Lifecycle ──────────────────────────────────────────────────────────\n\n  async init(): Promise<void> {\n    await this.execOk(`mkdir -p ${shellQuote(await this.base())}`, 'init workdir');\n  }\n\n  async destroy(): Promise<void> {\n    // The sandbox lifecycle is owned by the caller; nothing to tear down here.\n  }\n\n  async isReady(): Promise<boolean> {\n    const result = await this.exec(`test -d ${shellQuote(await this.base())}`);\n    return result.exitCode === 0;\n  }\n\n  getInfo(): FilesystemInfo {\n    return {\n      id: this.id,\n      name: this.name,\n      provider: this.provider,\n      status: this.status,\n      metadata: { basePath: this.basePath, sandboxId: this.sandbox.id },\n    };\n  }\n\n  getInstructions(): string {\n    return `Files are stored in a remote sandbox at ${this.basePath}. Use absolute workspace paths like /src/index.ts. All reads, writes and commands run inside the same sandbox.`;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"sandbox-filesystem.js","names":["posixPath"],"sources":["../../src/agents/sandbox-filesystem.ts"],"sourcesContent":["/**\n * SandboxFilesystem\n *\n * A `WorkspaceFilesystem` that stores files inside a remote `MastraSandbox`\n * (e.g. a Railway VM) rather than on the server host. File operations are\n * implemented by shelling out through the sandbox's `executeCommand`, so the\n * agent's file tools and command tools share one VM and one view of the repo.\n * When the sandbox exposes its own `filesystem`, file operations use it\n * instead, which takes one round trip rather than several commands; grep and\n * walks still run as shell commands.\n *\n * Paths are workspace-relative (`/src/foo.ts`) and resolve under the sandbox\n * working directory (`basePath`). A traversal guard rejects any path that\n * escapes the workdir, mirroring `LocalFilesystem`'s contained mode.\n *\n * Reads/writes use base64 over the wire so binary content survives the shell.\n */\n\nimport { posix as posixPath } from 'node:path';\nimport type {\n  CopyOptions,\n  FileContent,\n  FileEntry,\n  FileStat,\n  FilesystemGrepMatch,\n  FilesystemGrepOptions,\n  FilesystemGrepResult,\n  FilesystemInfo,\n  ListOptions,\n  ProviderStatus,\n  ReadOptions,\n  RemoveOptions,\n  WalkEntry,\n  WalkOptions,\n  WorkspaceFilesystem,\n  WriteOptions,\n} from '@mastra/core/workspace';\nimport {\n  DirectoryNotFoundError,\n  FileExistsError,\n  FileNotFoundError,\n  getMimeType,\n  IsDirectoryError,\n  NotDirectoryError,\n  UnsupportedGrepPatternError,\n} from '@mastra/core/workspace';\n\n/**\n * Sentinel exit codes used by guard clauses that run before the real command,\n * so shell failures can be mapped to typed filesystem errors.\n */\nconst EXIT_NOT_FOUND = 20;\nconst EXIT_IS_DIRECTORY = 21;\nconst EXIT_EXISTS = 22;\nconst EXIT_NOT_DIRECTORY = 23;\n\n/** Minimal command result shape we depend on. */\nexport interface SandboxCommandResult {\n  exitCode: number;\n  stdout: string;\n  stderr: string;\n}\n\n/** Minimal sandbox surface the filesystem needs. */\nexport interface SandboxExec {\n  readonly id: string;\n  /**\n   * The sandbox's own file API, when it has one (`WorkspaceSandbox.filesystem`).\n   * File operations go through it instead of shell commands.\n   */\n  readonly filesystem?: WorkspaceFilesystem;\n  executeCommand(\n    command: string,\n    args?: string[],\n    options?: { timeout?: number; maxRetainedBytes?: number },\n  ): Promise<SandboxCommandResult>;\n}\n\nexport interface SandboxFilesystemOptions {\n  /** Live sandbox to run commands in. */\n  sandbox: SandboxExec;\n  /**\n   * Absolute path inside the sandbox that is the workspace root — or a lazy\n   * resolver for it. The resolver form exists for sandboxes whose workspace\n   * root is only knowable once the VM is running (e.g. `$HOME/<repo>` under\n   * a provider-chosen home dir): it is awaited on the first file operation\n   * (which itself may lazily start the VM) and the result is memoized.\n   */\n  workdir: string | (() => Promise<string> | string);\n  /** Optional stable id; defaults to a sandbox-derived id. */\n  id?: string;\n  /**\n   * Check that symlinks don't lead outside the workdir when using the\n   * sandbox's native filesystem. Off by default: native file APIs follow\n   * symlinks, and inside a sandbox the agent can read anything with a command\n   * anyway. Turn it on when files are served to someone other than the agent.\n   *\n   * Each path is checked once per instance, so keep such instances\n   * short-lived. Without a native filesystem the shell path always checks.\n   */\n  verifySymlinks?: boolean;\n}\n\ntype ContainmentCheck = 'target' | 'dest' | 'parent';\n\n/** Default per-command deadline so a hung sandbox can't block file tools forever. */\nconst COMMAND_TIMEOUT_MS = 30_000;\n\n/**\n * Explain why a native grep command failed so callers can tell a timeout or\n * broken toolchain apart from a pattern the engine cannot express.\n */\nfunction describeGrepFailure(result: SandboxCommandResult): string {\n  if (result.exitCode === 124) return `timed out after ${COMMAND_TIMEOUT_MS / 1000}s`;\n  const stderrLine = result.stderr\n    .split('\\n')\n    .map(line => line.trim())\n    .find(Boolean);\n  const detail = stderrLine ? `: ${stderrLine.length > 200 ? `${stderrLine.slice(0, 200)}…` : stderrLine}` : '';\n  return `exit code ${result.exitCode}${detail}`;\n}\n\n/** Single-quote a string for safe POSIX shell interpolation. */\nfunction shellQuote(value: string): string {\n  return `'${value.replace(/'/g, `'\\\\''`)}'`;\n}\n\ninterface SearchTools {\n  rg: boolean;\n  gnuGrep: boolean;\n  git: boolean;\n  /** `grep -P` works, and so does `git grep -P` when git is present. */\n  pcre: boolean;\n}\n\n/** One command that reports which search tools the sandbox has, one name per line. */\nconst SEARCH_TOOLS_PROBE =\n  'command -v rg >/dev/null 2>&1 && echo rg; ' +\n  \"grep --version 2>/dev/null | head -n 1 | grep -q 'GNU grep' && echo gnu-grep; \" +\n  \"printf 'a1\\\\n' | grep -qP '\\\\d(?=)' 2>/dev/null && echo grep-pcre; \" +\n  'if command -v git >/dev/null 2>&1; then echo git; ' +\n  // git can be built without PCRE; check it on a throwaway repository.\n  'd=$(mktemp -d 2>/dev/null) && { ' +\n  \"(cd \\\"$d\\\" && git init -q && printf 'a1\\\\n' >f && git grep -q --untracked -P -e '\\\\d(?=)') >/dev/null 2>&1 && echo git-pcre; \" +\n  'rm -rf \"$d\"; }; fi; true';\n\nfunction isInsideNodeModules(path: string): boolean {\n  return path.split('/').includes('node_modules');\n}\n\n/** Lines a grep engine printed for one file: matches plus surrounding context. */\ninterface GrepFileLines {\n  matches: FilesystemGrepMatch[];\n  linesByNumber: Map<number, string>;\n}\n\nfunction fileLines(files: Map<string, GrepFileLines>, filePath: string): GrepFileLines {\n  let state = files.get(filePath);\n  if (!state) {\n    state = { matches: [], linesByNumber: new Map() };\n    files.set(filePath, state);\n  }\n  return state;\n}\n\n/** Turn per-file lines into results relative to `abs`, attaching before/after context. */\nfunction toGrepResults(files: Map<string, GrepFileLines>, abs: string, contextLines: number): FilesystemGrepResult[] {\n  const results: FilesystemGrepResult[] = [];\n  for (const [filePath, state] of files) {\n    if (state.matches.length === 0) continue;\n    const rel = posixPath.relative(abs, filePath) || posixPath.basename(filePath);\n    const matches = state.matches.map(match => {\n      if (contextLines <= 0) return match;\n      const before: string[] = [];\n      for (let n = match.line - 1; n >= Math.max(1, match.line - contextLines); n--) {\n        const text = state.linesByNumber.get(n);\n        if (text === undefined) break;\n        before.unshift(text);\n      }\n      const after: string[] = [];\n      for (let n = match.line + 1; n <= match.line + contextLines; n++) {\n        const text = state.linesByNumber.get(n);\n        if (text === undefined) break;\n        after.push(text);\n      }\n      return { ...match, before, after };\n    });\n    results.push({ path: rel, matches });\n  }\n  return results;\n}\n\nfunction isFileContentString(content: FileContent): content is string {\n  return typeof content === 'string';\n}\n\nfunction toBuffer(content: FileContent): Buffer {\n  if (isFileContentString(content)) return Buffer.from(content, 'utf8');\n  return Buffer.from(content);\n}\n\nexport class SandboxFilesystem implements WorkspaceFilesystem {\n  readonly id: string;\n  readonly name = 'SandboxFilesystem';\n  readonly provider = 'sandbox';\n  status: ProviderStatus = 'ready';\n\n  private readonly sandbox: SandboxExec;\n  private readonly workdirSource: string | (() => Promise<string> | string);\n  private resolvedBase?: string;\n  private resolvingBase?: Promise<string>;\n  private readonly verifySymlinks: boolean;\n  /** `check:absolutePath` keys that passed while the entry existed. */\n  private readonly verified = new Set<string>();\n\n  constructor(options: SandboxFilesystemOptions) {\n    this.sandbox = options.sandbox;\n    this.workdirSource = options.workdir;\n    this.verifySymlinks = options.verifySymlinks ?? false;\n    if (typeof options.workdir === 'string') this.resolvedBase = options.workdir;\n    // Include the workdir when known: one sandbox can back several\n    // filesystems rooted at different checkouts, and each needs a distinct\n    // id. Lazy-workdir callers pass an explicit id.\n    this.id =\n      options.id ??\n      (typeof options.workdir === 'string'\n        ? `sandbox-fs:${options.sandbox.id}:${options.workdir}`\n        : `sandbox-fs:${options.sandbox.id}`);\n  }\n\n  /** The resolved workspace root; empty until a lazy workdir first resolves. */\n  get basePath(): string {\n    return this.resolvedBase ?? '';\n  }\n\n  /** Await (and memoize) the workspace root, resolving a lazy workdir once. */\n  private async base(): Promise<string> {\n    if (this.resolvedBase) return this.resolvedBase;\n    const source = this.workdirSource;\n    if (typeof source === 'string') return (this.resolvedBase = source);\n    this.resolvingBase ??= Promise.resolve()\n      .then(source)\n      .then(resolved => {\n        if (!resolved) throw new Error('Sandbox workspace root resolution returned an empty path');\n        return (this.resolvedBase = resolved);\n      })\n      .finally(() => {\n        this.resolvingBase = undefined;\n      });\n    return this.resolvingBase;\n  }\n\n  // ── Path handling ──────────────────────────────────────────────────────\n\n  /**\n   * Resolve a workspace path to an absolute path inside the sandbox, enforcing\n   * that it stays within the workdir. Awaits the workspace root first, which\n   * for a lazy workdir may start the VM.\n   */\n  private async resolveAsync(inputPath: string): Promise<string> {\n    return this.resolveAgainst(await this.base(), inputPath);\n  }\n\n  /**\n   * Resolve a workspace path against a known base, enforcing that it stays\n   * within the workdir.\n   *\n   * Accepts both workspace-relative paths (`src/foo.ts`, `/src/foo.ts`) and\n   * absolute sandbox paths that already live under the workdir — the agent's\n   * prompt advertises the workdir as its working directory, so tools are\n   * routinely called with fully-qualified paths like `<workdir>/src/foo.ts`.\n   */\n  private resolveAgainst(basePath: string, inputPath: string): string {\n    const base = posixPath.normalize(basePath);\n    const normalizedInput = posixPath.normalize(inputPath);\n    const rel =\n      normalizedInput === base\n        ? ''\n        : normalizedInput.startsWith(`${base}/`)\n          ? normalizedInput.slice(base.length + 1)\n          : inputPath.startsWith('/')\n            ? inputPath.slice(1)\n            : inputPath;\n    const resolved = posixPath.normalize(posixPath.join(base, rel));\n    if (resolved !== base && !resolved.startsWith(`${base}/`)) {\n      throw new Error(`Path escapes workspace root: ${inputPath}`);\n    }\n    return resolved;\n  }\n\n  resolveAbsolutePath(inputPath: string): string | undefined {\n    // Sync interface: a lazy workdir that has not resolved yet has no\n    // absolute form to offer.\n    if (!this.resolvedBase) return undefined;\n    return this.resolveAgainst(this.resolvedBase, inputPath);\n  }\n\n  // ── Command helper ─────────────────────────────────────────────────────\n\n  private async exec(script: string): Promise<SandboxCommandResult> {\n    // File reads come back as base64 on stdout and listings/grep are parsed\n    // line by line, so dropping the oldest output would corrupt results.\n    return this.sandbox.executeCommand('sh', ['-c', script], {\n      timeout: COMMAND_TIMEOUT_MS,\n      maxRetainedBytes: Infinity,\n    });\n  }\n\n  /**\n   * Lexical guard catches `..` traversal, but a symlink inside the workdir can\n   * still point outside it. After resolving a path that refers to an existing\n   * entry, verify its realpath is still contained in the workdir.\n   *\n   * Canonicalization tries `realpath`, then `readlink -f` (GNU/busybox), then\n   * `cd && pwd -P` for directories — covering GNU hosts, macOS/BSD, and\n   * busybox. If the path exists but cannot be canonicalized we fail CLOSED:\n   * returning without a check would let a symlink bypass containment.\n   */\n  private async assertContainedRealpath(abs: string, inputPath: string): Promise<boolean> {\n    const result = await this.exec(\n      [\n        `p=${shellQuote(abs)}`,\n        `if [ ! -e \"$p\" ] && [ ! -L \"$p\" ]; then exit ${EXIT_NOT_FOUND}; fi`,\n        // The workdir itself may contain symlinked components (/tmp on macOS),\n        // so canonicalize it as the comparison root.\n        `root=$(cd ${shellQuote(this.basePath)} 2>/dev/null && pwd -P)`,\n        `[ -n \"$root\" ] || exit 1`,\n        `rp=$(realpath \"$p\" 2>/dev/null) || rp=$(readlink -f \"$p\" 2>/dev/null) || { [ -d \"$p\" ] && rp=$(cd \"$p\" 2>/dev/null && pwd -P); }`,\n        `[ -n \"$rp\" ] || exit 1`,\n        `printf '%s\\\\n%s' \"$root\" \"$rp\"`,\n      ].join('\\n'),\n    );\n    // Path doesn't exist yet: nothing to canonicalize (writes to a fresh leaf\n    // are covered by assertContainedDest checking the parent directory).\n    if (result.exitCode === EXIT_NOT_FOUND) return false;\n    const [root, real] = result.stdout.split('\\n').map(s => s.trim());\n    if (result.exitCode !== 0 || !root || !real) {\n      throw new Error(`Unable to verify path stays within workspace root: ${inputPath}`);\n    }\n    if (real !== root && !real.startsWith(`${root}/`)) {\n      throw new Error(`Path escapes workspace root (symlink): ${inputPath}`);\n    }\n    return true;\n  }\n\n  /**\n   * Guard for write destinations. The lexical guard catches `..`, but a symlink\n   * inside the workdir can redirect a write outside it. For an existing target\n   * we check its realpath; for a not-yet-existing target we check the realpath\n   * of its nearest existing ancestor directory, since a symlinked parent is the\n   * escape vector (e.g. `link -> /etc` then writing `link/passwd`).\n   */\n  private async assertContainedDest(abs: string, inputPath: string): Promise<boolean> {\n    // First check the target itself (covers overwriting an existing symlink).\n    const exists = await this.assertContainedRealpath(abs, inputPath);\n    // Then check the parent directory's realpath; readlink -f resolves the\n    // nearest existing ancestor when the leaf doesn't exist yet.\n    const parent = posixPath.dirname(abs);\n    if (parent && parent !== abs) {\n      await this.assertContainedRealpath(parent, inputPath);\n    }\n    return exists;\n  }\n\n  /**\n   * Before a native filesystem call, run the containment check the shell path\n   * runs for that operation, when `verifySymlinks` is on. A pass is remembered\n   * only for an entry that exists: a missing path may later appear as a\n   * symlink that leads outside the workdir.\n   */\n  private async verifyNative(check: ContainmentCheck, abs: string, inputPath: string): Promise<void> {\n    if (!this.verifySymlinks) return;\n    const key = `${check}:${abs}`;\n    if (this.verified.has(key)) return;\n    const existed =\n      check === 'dest'\n        ? await this.assertContainedDest(abs, inputPath)\n        : await this.assertContainedRealpath(check === 'parent' ? posixPath.dirname(abs) : abs, inputPath);\n    if (existed) this.verified.add(key);\n  }\n\n  private async execOk(script: string, context: string): Promise<SandboxCommandResult> {\n    const result = await this.exec(script);\n    if (result.exitCode !== 0) {\n      throw new Error(`${context} failed (exit ${result.exitCode}): ${result.stderr.trim() || result.stdout.trim()}`);\n    }\n    return result;\n  }\n\n  // ── File operations ────────────────────────────────────────────────────\n\n  async readFile(path: string, options?: ReadOptions): Promise<string | Buffer> {\n    const abs = await this.resolveAsync(path);\n    const native = this.sandbox.filesystem;\n    if (native) {\n      await this.verifyNative('target', abs, path);\n      return native.readFile(abs, options);\n    }\n    await this.assertContainedRealpath(abs, path);\n    // Guard clauses first: redirecting from a directory \"succeeds\" with empty\n    // output on some shells, so classify before reading.\n    const result = await this.exec(\n      `if [ -d ${shellQuote(abs)} ]; then exit ${EXIT_IS_DIRECTORY}; elif [ ! -e ${shellQuote(abs)} ]; then exit ${EXIT_NOT_FOUND}; fi; base64 < ${shellQuote(abs)}`,\n    );\n    if (result.exitCode === EXIT_IS_DIRECTORY) throw new IsDirectoryError(path);\n    if (result.exitCode === EXIT_NOT_FOUND) throw new FileNotFoundError(path);\n    if (result.exitCode !== 0) {\n      throw new Error(`readFile ${path} failed (exit ${result.exitCode}): ${result.stderr.trim()}`);\n    }\n    const buffer = Buffer.from(result.stdout.replace(/\\s/g, ''), 'base64');\n    if (options?.encoding) {\n      return buffer.toString(options.encoding);\n    }\n    return buffer;\n  }\n\n  async writeFile(path: string, content: FileContent, options?: WriteOptions): Promise<void> {\n    const abs = await this.resolveAsync(path);\n    const native = this.sandbox.filesystem;\n    if (native) {\n      await this.verifyNative('dest', abs, path);\n      return native.writeFile(abs, content, options);\n    }\n    await this.assertContainedDest(abs, path);\n    const b64 = toBuffer(content).toString('base64');\n    const dir = posixPath.dirname(abs);\n    const mkdir = options?.recursive === false ? '' : `mkdir -p ${shellQuote(dir)} && `;\n    if (options?.overwrite === false) {\n      // `set -C` (noclobber) makes the redirect itself the exclusivity check —\n      // no exists() pre-check that could race with a concurrent writer.\n      const result = await this.exec(\n        `${mkdir}{ (set -C; printf %s ${shellQuote(b64)} | base64 -d > ${shellQuote(abs)}) 2>/dev/null || { [ -e ${shellQuote(abs)} ] && exit ${EXIT_EXISTS} || exit 1; }; }`,\n      );\n      if (result.exitCode === EXIT_EXISTS) throw new FileExistsError(path);\n      if (result.exitCode !== 0) {\n        throw new Error(`writeFile ${path} failed (exit ${result.exitCode}): ${result.stderr.trim()}`);\n      }\n      return;\n    }\n    await this.execOk(`${mkdir}printf %s ${shellQuote(b64)} | base64 -d > ${shellQuote(abs)}`, `writeFile ${path}`);\n  }\n\n  async appendFile(path: string, content: FileContent): Promise<void> {\n    const abs = await this.resolveAsync(path);\n    const native = this.sandbox.filesystem;\n    if (native) {\n      await this.verifyNative('dest', abs, path);\n      return native.appendFile(abs, content);\n    }\n    await this.assertContainedDest(abs, path);\n    const b64 = toBuffer(content).toString('base64');\n    await this.execOk(\n      `mkdir -p ${shellQuote(posixPath.dirname(abs))} && printf %s ${shellQuote(b64)} | base64 -d >> ${shellQuote(abs)}`,\n      `appendFile ${path}`,\n    );\n  }\n\n  async deleteFile(path: string, options?: RemoveOptions): Promise<void> {\n    const abs = await this.resolveAsync(path);\n    const native = this.sandbox.filesystem;\n    if (native) {\n      await this.verifyNative('parent', abs, path);\n      return native.deleteFile(abs, options);\n    }\n    // Contain the parent's realpath: deleting `link/file` where `link` points\n    // outside the workdir must fail, while deleting a symlink entry itself\n    // (which lives inside the workdir) stays allowed.\n    await this.assertContainedRealpath(posixPath.dirname(abs), path);\n    if (options?.force) {\n      // `rm -f` already succeeds for a missing file, but still fails for\n      // directories and permission errors — surface those.\n      await this.execOk(`rm -f ${shellQuote(abs)}`, `deleteFile ${path}`);\n      return;\n    }\n    const result = await this.exec(\n      `if [ ! -e ${shellQuote(abs)} ]; then exit ${EXIT_NOT_FOUND}; fi; rm ${shellQuote(abs)}`,\n    );\n    if (result.exitCode === EXIT_NOT_FOUND) throw new FileNotFoundError(path);\n    if (result.exitCode !== 0) {\n      throw new Error(`deleteFile ${path} failed (exit ${result.exitCode}): ${result.stderr.trim()}`);\n    }\n  }\n\n  async copyFile(src: string, dest: string, options?: CopyOptions): Promise<void> {\n    const srcAbs = await this.resolveAsync(src);\n    const destAbs = await this.resolveAsync(dest);\n    const native = this.sandbox.filesystem;\n    if (native) {\n      await this.verifyNative('target', srcAbs, src);\n      await this.verifyNative('dest', destAbs, dest);\n      return native.copyFile(srcAbs, destAbs, options);\n    }\n    await this.assertContainedRealpath(srcAbs, src);\n    await this.assertContainedDest(destAbs, dest);\n    const recursive = options?.recursive ? '-r ' : '';\n    if (options?.overwrite === false) {\n      // Atomic no-clobber: directories claim the destination with an exclusive\n      // mkdir; files copy to a temp name then hardlink into place (link(2)\n      // fails if the destination exists). No racy exists() pre-check.\n      const result = await this.exec(\n        [\n          `src=${shellQuote(srcAbs)}`,\n          `dest=${shellQuote(destAbs)}`,\n          `if [ ! -e \"$src\" ] && [ ! -L \"$src\" ]; then exit ${EXIT_NOT_FOUND}; fi`,\n          `mkdir -p ${shellQuote(posixPath.dirname(destAbs))} || exit 1`,\n          `if [ -d \"$src\" ]; then`,\n          `  mkdir \"$dest\" 2>/dev/null || exit ${EXIT_EXISTS}`,\n          `  cp -R \"$src\"/. \"$dest\"/`,\n          `else`,\n          `  tmp=\"$dest.__cptmp$$\"`,\n          `  cp \"$src\" \"$tmp\" || exit 1`,\n          `  ln \"$tmp\" \"$dest\" 2>/dev/null || { rm -f \"$tmp\"; [ -e \"$dest\" ] && exit ${EXIT_EXISTS} || exit 1; }`,\n          `  rm -f \"$tmp\"`,\n          `fi`,\n        ].join('\\n'),\n      );\n      if (result.exitCode === EXIT_NOT_FOUND) throw new FileNotFoundError(src);\n      if (result.exitCode === EXIT_EXISTS) throw new FileExistsError(dest);\n      if (result.exitCode !== 0) {\n        throw new Error(`copyFile ${src} -> ${dest} failed (exit ${result.exitCode}): ${result.stderr.trim()}`);\n      }\n      return;\n    }\n    const result = await this.exec(\n      `if [ ! -e ${shellQuote(srcAbs)} ]; then exit ${EXIT_NOT_FOUND}; fi; mkdir -p ${shellQuote(posixPath.dirname(destAbs))} && cp ${recursive}${shellQuote(srcAbs)} ${shellQuote(destAbs)}`,\n    );\n    if (result.exitCode === EXIT_NOT_FOUND) throw new FileNotFoundError(src);\n    if (result.exitCode !== 0) {\n      throw new Error(`copyFile ${src} -> ${dest} failed (exit ${result.exitCode}): ${result.stderr.trim()}`);\n    }\n  }\n\n  async moveFile(src: string, dest: string, options?: CopyOptions): Promise<void> {\n    const srcAbs = await this.resolveAsync(src);\n    const destAbs = await this.resolveAsync(dest);\n    const native = this.sandbox.filesystem;\n    if (native) {\n      await this.verifyNative('target', srcAbs, src);\n      await this.verifyNative('dest', destAbs, dest);\n      return native.moveFile(srcAbs, destAbs, options);\n    }\n    await this.assertContainedRealpath(srcAbs, src);\n    await this.assertContainedDest(destAbs, dest);\n    if (options?.overwrite === false) {\n      // `mv -n` exits 0 even when it skips, so detect a skipped move by the\n      // source surviving. The no-clobber rename itself is atomic; no racy\n      // exists() pre-check.\n      const result = await this.exec(\n        [\n          `src=${shellQuote(srcAbs)}`,\n          `dest=${shellQuote(destAbs)}`,\n          `if [ ! -e \"$src\" ] && [ ! -L \"$src\" ]; then exit ${EXIT_NOT_FOUND}; fi`,\n          `mkdir -p ${shellQuote(posixPath.dirname(destAbs))} || exit 1`,\n          `mv -n \"$src\" \"$dest\" 2>/dev/null || exit 1`,\n          `if [ -e \"$src\" ] || [ -L \"$src\" ]; then exit ${EXIT_EXISTS}; fi`,\n        ].join('\\n'),\n      );\n      if (result.exitCode === EXIT_NOT_FOUND) throw new FileNotFoundError(src);\n      if (result.exitCode === EXIT_EXISTS) throw new FileExistsError(dest);\n      if (result.exitCode !== 0) {\n        throw new Error(`moveFile ${src} -> ${dest} failed (exit ${result.exitCode}): ${result.stderr.trim()}`);\n      }\n      return;\n    }\n    const result = await this.exec(\n      `if [ ! -e ${shellQuote(srcAbs)} ]; then exit ${EXIT_NOT_FOUND}; fi; mkdir -p ${shellQuote(posixPath.dirname(destAbs))} && mv ${shellQuote(srcAbs)} ${shellQuote(destAbs)}`,\n    );\n    if (result.exitCode === EXIT_NOT_FOUND) throw new FileNotFoundError(src);\n    if (result.exitCode !== 0) {\n      throw new Error(`moveFile ${src} -> ${dest} failed (exit ${result.exitCode}): ${result.stderr.trim()}`);\n    }\n  }\n\n  // ── Directory operations ───────────────────────────────────────────────\n\n  async mkdir(path: string, options?: { recursive?: boolean }): Promise<void> {\n    const abs = await this.resolveAsync(path);\n    const native = this.sandbox.filesystem;\n    if (native) {\n      await this.verifyNative('dest', abs, path);\n      return native.mkdir(abs, options);\n    }\n    await this.assertContainedDest(abs, path);\n    const flag = options?.recursive === false ? '' : '-p ';\n    await this.execOk(`mkdir ${flag}${shellQuote(abs)}`, `mkdir ${path}`);\n  }\n\n  async rmdir(path: string, options?: RemoveOptions): Promise<void> {\n    const abs = await this.resolveAsync(path);\n    const native = this.sandbox.filesystem;\n    if (native) {\n      await this.verifyNative('parent', abs, path);\n      return native.rmdir(abs, options);\n    }\n    // Same parent containment as deleteFile — `rm -r` through a symlinked\n    // parent would otherwise delete outside the workspace.\n    await this.assertContainedRealpath(posixPath.dirname(abs), path);\n    if (options?.recursive) {\n      const force = options?.force ? '-f ' : '';\n      await this.execOk(`rm -r ${force}${shellQuote(abs)}`, `rmdir ${path}`);\n      return;\n    }\n    const result = await this.exec(`rmdir ${shellQuote(abs)}`);\n    if (result.exitCode !== 0 && !options?.force) {\n      throw new Error(`Directory not empty or not found: ${path}`);\n    }\n  }\n\n  async readdir(path: string, options?: ListOptions): Promise<FileEntry[]> {\n    const abs = await this.resolveAsync(path);\n    const native = this.sandbox.filesystem;\n    if (native) {\n      await this.verifyNative('target', abs, path);\n      return native.readdir(abs, options);\n    }\n    await this.assertContainedRealpath(abs, path);\n    if (options?.recursive) {\n      // Recursive listing emitting \"type\\tpath\". `find -printf` is GNU-only\n      // (fails on macOS/BSD hosts backing a local sandbox), so classify each\n      // entry with a portable shell loop instead.\n      const result = await this.exec(\n        `test -d ${shellQuote(abs)} && find ${shellQuote(abs)} -mindepth 1 ${options.maxDepth ? `-maxdepth ${Number(options.maxDepth)} ` : ''}2>/dev/null | while IFS= read -r f; do if [ -d \"$f\" ]; then printf 'd\\\\t%s\\\\n' \"$f\"; else printf 'f\\\\t%s\\\\n' \"$f\"; fi; done`,\n      );\n      if (result.exitCode !== 0) throw new Error(`Directory not found: ${path}`);\n      return this.parseFindOutput(result.stdout, abs, options);\n    }\n    // Non-recursive: list with name + type via a portable loop. Use printf,\n    // not echo — bash-as-/bin/sh (macOS local sandboxes) does not expand \\t\n    // in echo arguments.\n    const result = await this.exec(\n      `cd ${shellQuote(abs)} 2>/dev/null && for f in * .[!.]*; do [ -e \"$f\" ] || continue; if [ -d \"$f\" ]; then printf 'd\\\\t%s\\\\n' \"$f\"; else printf 'f\\\\t%s\\\\n' \"$f\"; fi; done`,\n    );\n    if (result.exitCode !== 0) throw new Error(`Directory not found: ${path}`);\n    return this.parseListOutput(result.stdout, options);\n  }\n\n  private parseListOutput(stdout: string, options?: ListOptions): FileEntry[] {\n    const entries: FileEntry[] = [];\n    for (const line of stdout.split('\\n')) {\n      if (!line) continue;\n      const tab = line.indexOf('\\t');\n      if (tab < 0) continue;\n      const type = line.slice(0, tab) === 'd' ? 'directory' : 'file';\n      const name = line.slice(tab + 1);\n      if (!name || name === '.' || name === '..') continue;\n      if (type === 'file' && !this.matchesExtension(name, options?.extension)) continue;\n      entries.push({ name, type });\n    }\n    return entries;\n  }\n\n  private parseFindOutput(stdout: string, base: string, options?: ListOptions): FileEntry[] {\n    const entries: FileEntry[] = [];\n    for (const line of stdout.split('\\n')) {\n      if (!line) continue;\n      const tab = line.indexOf('\\t');\n      if (tab < 0) continue;\n      const type = line.slice(0, tab) === 'd' ? 'directory' : 'file';\n      const fullPath = line.slice(tab + 1);\n      const name = posixPath.relative(base, fullPath);\n      if (!name) continue;\n      if (type === 'file' && !this.matchesExtension(name, options?.extension)) continue;\n      entries.push({ name, type });\n    }\n    return entries;\n  }\n\n  private matchesExtension(name: string, extension?: string | string[]): boolean {\n    if (!extension) return true;\n    const exts = Array.isArray(extension) ? extension : [extension];\n    return exts.some(ext => name.endsWith(ext));\n  }\n\n  // ── Native walk / grep capabilities ────────────────────────────────────\n\n  /**\n   * Walk the tree in a single sandbox command instead of one readdir round\n   * trip per directory. Uses `find` with a portable classification loop\n   * (`find -printf` is GNU-only and fails on macOS/BSD hosts). `find` does\n   * not follow symlinked directories by default, matching the host-side\n   * walker's no-recursion-into-symlinks behavior.\n   */\n  async walk(path: string, options?: WalkOptions): Promise<WalkEntry[]> {\n    const abs = await this.resolveAsync(path);\n    await this.assertContainedRealpath(abs, path);\n    const maxDepth =\n      options?.maxDepth !== undefined && Number.isFinite(options.maxDepth)\n        ? `-maxdepth ${Math.max(0, Math.floor(options.maxDepth))} `\n        : '';\n    // Prune hidden entries in-sandbox when not requested, so a huge hidden\n    // tree (e.g. `.git`) doesn't inflate the response. `.gitignore` files\n    // still come back when the caller applies them.\n    const keepGitignore = options?.includeGitignoreFiles ? `! \\\\( -type f -name .gitignore \\\\) ` : '';\n    const hiddenPrune = options?.includeHidden ? '' : `\\\\( -name '.*' ${keepGitignore}\\\\) -prune -o `;\n    // Skip directories like node_modules entirely instead of listing them\n    // only for the caller to filter them out.\n    const skipNames = options?.skipDirectoryNames?.filter(Boolean) ?? [];\n    const skipPrune = skipNames.length\n      ? `\\\\( -type d \\\\( ${skipNames.map(name => `-name ${shellQuote(name)}`).join(' -o ')} \\\\) \\\\) -prune -o `\n      : '';\n    // Emit \"flag\\tpath[\\ttarget]\" — flag is d/f for regular entries, D/F for\n    // symlinks (with the link target as a third field).\n    const script =\n      `root=${shellQuote(abs)}\\n` +\n      `[ -e \"$root\" ] || [ -L \"$root\" ] || exit ${EXIT_NOT_FOUND}\\n` +\n      `[ -d \"$root\" ] || exit ${EXIT_NOT_DIRECTORY}\\n` +\n      `find \"$root\" -mindepth 1 ${maxDepth}${hiddenPrune}${skipPrune}-print 2>/dev/null | while IFS= read -r f; do ` +\n      `if [ -L \"$f\" ]; then if [ -d \"$f\" ]; then t=D; else t=F; fi; printf '%s\\\\t%s\\\\t%s\\\\n' \"$t\" \"$f\" \"$(readlink \"$f\")\"; ` +\n      `elif [ -d \"$f\" ]; then printf 'd\\\\t%s\\\\n' \"$f\"; else printf 'f\\\\t%s\\\\n' \"$f\"; fi; done`;\n    const result = await this.exec(script);\n    if (result.exitCode === EXIT_NOT_FOUND) throw new DirectoryNotFoundError(path);\n    if (result.exitCode === EXIT_NOT_DIRECTORY) throw new NotDirectoryError(path);\n    if (result.exitCode !== 0) {\n      throw new Error(`walk ${path} failed (exit ${result.exitCode}): ${result.stderr.trim()}`);\n    }\n    const entries: WalkEntry[] = [];\n    for (const line of result.stdout.split('\\n')) {\n      if (!line) continue;\n      const tab = line.indexOf('\\t');\n      if (tab < 0) continue;\n      const flag = line.slice(0, tab);\n      const isSymlink = flag === 'D' || flag === 'F';\n      let fullPath = line.slice(tab + 1);\n      let symlinkTarget: string | undefined;\n      if (isSymlink) {\n        const tab2 = fullPath.lastIndexOf('\\t');\n        if (tab2 >= 0) {\n          symlinkTarget = fullPath.slice(tab2 + 1) || undefined;\n          fullPath = fullPath.slice(0, tab2);\n        }\n      }\n      const rel = posixPath.relative(abs, fullPath);\n      if (!rel || rel.startsWith('..')) continue;\n      entries.push({\n        name: posixPath.basename(rel),\n        type: flag === 'd' || flag === 'D' ? 'directory' : 'file',\n        ...(isSymlink ? { isSymlink: true, ...(symlinkTarget ? { symlinkTarget } : {}) } : {}),\n        path: rel,\n      });\n    }\n    return entries;\n  }\n\n  /**\n   * Content search executed inside the sandbox in one command, using the best\n   * engine the sandbox has: ripgrep, then GNU grep (with git choosing files\n   * inside repositories), then POSIX `grep -rnE`. Patterns the grep engines\n   * can't express (PCRE-style classes, word boundaries, lookarounds,\n   * non-greedy quantifiers) throw {@link UnsupportedGrepPatternError} so\n   * callers use their host-side walk.\n   *\n   * ripgrep and GNU grep apply every `.gitignore` in the tree, relative to the\n   * directory that holds it, and skip `node_modules` unless the search path\n   * is inside one. Callers still apply their own hidden/glob filtering.\n   */\n  async grep(options: FilesystemGrepOptions): Promise<FilesystemGrepResult[]> {\n    const abs = await this.resolveAsync(options.path);\n    await this.assertContainedRealpath(abs, options.path);\n    const tools = await this.searchTools();\n    if (tools.rg) return this.grepWithRipgrep(abs, options);\n    if (tools.gnuGrep) return this.grepWithGnuGrep(abs, options, tools);\n    return this.grepWithPosixGrep(abs, options);\n  }\n\n  private toolsCheck: Promise<SearchTools> | undefined;\n\n  private searchTools(): Promise<SearchTools> {\n    const check = (this.toolsCheck ??= this.exec(SEARCH_TOOLS_PROBE).then(result => {\n      if (result.exitCode !== 0) throw new Error(`search tool probe exited with ${result.exitCode}`);\n      const found = new Set(result.stdout.split('\\n').map(line => line.trim()));\n      const git = found.has('git');\n      return {\n        rg: found.has('rg'),\n        gnuGrep: found.has('gnu-grep'),\n        git,\n        pcre: found.has('grep-pcre') && (!git || found.has('git-pcre')),\n      };\n    }));\n    // Only a successful probe is cached; a failed one (e.g. the sandbox wasn't\n    // ready) is retried on the next search instead of pinning the slow path.\n    return check.catch(() => {\n      if (this.toolsCheck === check) this.toolsCheck = undefined;\n      return { rg: false, gnuGrep: false, git: false, pcre: false };\n    });\n  }\n\n  private async grepWithRipgrep(abs: string, options: FilesystemGrepOptions): Promise<FilesystemGrepResult[]> {\n    const args = [\n      // --no-require-git applies .gitignore files outside a git checkout too\n      // (e.g. a multi-repo root). A path passed explicitly is searched even\n      // when ignored, so targeting `dist/` or `node_modules/x` still works.\n      'rg --json --hidden --no-require-git',\n      // .git is filtered host-side too; exclude it here so its object files\n      // don't inflate the response.\n      `-g ${shellQuote('!.git/**')}`,\n      isInsideNodeModules(abs) ? '' : `-g ${shellQuote('!**/node_modules/**')}`,\n      options.caseSensitive ? '' : '-i',\n      options.maxCountPerFile !== undefined ? `-m ${Math.max(1, Math.floor(options.maxCountPerFile))}` : '',\n      options.contextLines ? `-C ${Math.max(0, Math.floor(options.contextLines))}` : '',\n      `-e ${shellQuote(options.pattern)}`,\n      shellQuote(abs),\n    ]\n      .filter(Boolean)\n      .join(' ');\n    const result = await this.exec(args);\n    // rg exits 1 when there are no matches, 2 on any error. A bad pattern\n    // produces no output at all, but a per-file error (e.g. an unreadable\n    // file) also yields exit 2 while still emitting matches for every other\n    // file. Keep those partial results; only treat \"error with no matches\"\n    // as an unsupported pattern so the caller falls back to the host walk.\n    if (result.exitCode === 1) return [];\n    const results = this.parseRipgrepJson(result.stdout, abs, options);\n    if (result.exitCode !== 0 && results.length === 0) {\n      throw new UnsupportedGrepPatternError(options.pattern, describeGrepFailure(result));\n    }\n    return results;\n  }\n\n  private parseRipgrepJson(stdout: string, abs: string, options: FilesystemGrepOptions): FilesystemGrepResult[] {\n    const files = new Map<string, GrepFileLines>();\n    for (const line of stdout.split('\\n')) {\n      if (!line) continue;\n      let event: any;\n      try {\n        event = JSON.parse(line);\n      } catch {\n        continue;\n      }\n      if (event.type !== 'match' && event.type !== 'context') continue;\n      const filePath: string | undefined = event.data?.path?.text;\n      const lineNumber: number | undefined = event.data?.line_number;\n      if (!filePath || !lineNumber) continue;\n      const state = fileLines(files, filePath);\n      const text: string = (event.data?.lines?.text ?? '').replace(/\\r?\\n$/, '');\n      state.linesByNumber.set(lineNumber, text);\n      if (event.type === 'match') {\n        // rg submatch offsets are byte offsets into the line; convert to a\n        // UTF-16 (JS string) index for the capability contract.\n        const byteStart: number = event.data?.submatches?.[0]?.start ?? 0;\n        const column = Buffer.from(text, 'utf8').subarray(0, byteStart).toString('utf8').length;\n        state.matches.push({ line: lineNumber, column, text });\n      }\n    }\n    return this.applyTotalCap(toGrepResults(files, abs, options.contextLines ?? 0), options.maxTotalMatches);\n  }\n\n  /**\n   * Patterns whose meaning differs between POSIX ERE and JS RegExp. The grep\n   * runs with ERE but match columns are recomputed with JS, so anything that\n   * only one side understands (PCRE classes, lookarounds, lazy quantifiers,\n   * POSIX bracket classes, GNU word anchors) must fall back to the host walk.\n   */\n  private static readonly ERE_UNSUPPORTED = /\\\\[dDwWsSbB<>]|\\(\\?|[*+?}]\\?|\\[:[a-z]+:\\]/;\n\n  /**\n   * Escapes that `grep -P` (PCRE) and JS RegExp (without the `u` flag) both\n   * accept but read differently, e.g. `\\A` is \"start of subject\" in PCRE and\n   * a literal `A` in JS, plus POSIX bracket classes. PCRE-only syntax that JS\n   * rejects (inline flags, possessive quantifiers, atomic groups) already\n   * fails the JS compile below.\n   */\n  private static readonly PCRE_UNSUPPORTED = /\\\\[AzZGKQEhHvVRXNCpPe]|\\[:[a-z]+:\\]/;\n\n  /** Reject patterns grep can't run with the same meaning as JS; return the JS regex used for columns. */\n  private static grepRegex(options: FilesystemGrepOptions, pcre = false): RegExp {\n    if (\n      pcre\n        ? SandboxFilesystem.PCRE_UNSUPPORTED.test(options.pattern)\n        : SandboxFilesystem.ERE_UNSUPPORTED.test(options.pattern)\n    ) {\n      throw new UnsupportedGrepPatternError(\n        options.pattern,\n        pcre ? 'grep -P reads this syntax differently from JavaScript' : 'POSIX ERE cannot express this syntax',\n      );\n    }\n    try {\n      return new RegExp(options.pattern, options.caseSensitive ? '' : 'i');\n    } catch {\n      throw new UnsupportedGrepPatternError(options.pattern, 'invalid regular expression');\n    }\n  }\n\n  /**\n   * GNU grep without ripgrep. Inside a git checkout, `git grep` picks the\n   * files (tracked plus untracked, every `.gitignore` applied) and GNU grep\n   * prints them with context. Outside a checkout (e.g. a multi-repo root),\n   * each child repository is searched the same way and plain grep covers the\n   * remaining files, skipping `node_modules`. `--null` ends each file name\n   * with NUL, so match (`N:`) and context (`N-`) lines parse unambiguously.\n   * When grep and git support it, patterns run as PCRE (`-P`), so `\\d`,\n   * `\\w`, `\\s`, `\\b`, and lookarounds don't need the host walk.\n   */\n  private async grepWithGnuGrep(\n    abs: string,\n    options: FilesystemGrepOptions,\n    tools: SearchTools,\n  ): Promise<FilesystemGrepResult[]> {\n    const hasGit = tools.git;\n    const mode = tools.pcre ? '-P' : '-E';\n    const jsRegex = SandboxFilesystem.grepRegex(options, tools.pcre);\n    const contextLines = Math.max(0, Math.floor(options.contextLines ?? 0));\n    const grepFlags = [\n      `-HnI${mode.slice(1)} --null`,\n      options.caseSensitive ? '' : '-i',\n      options.maxCountPerFile !== undefined ? `-m ${Math.max(1, Math.floor(options.maxCountPerFile))}` : '',\n      contextLines > 0 ? `-C ${contextLines}` : '',\n    ]\n      .filter(Boolean)\n      .join(' ');\n    const skipNodeModules = !isInsideNodeModules(abs);\n    const nodeModulesPathspec = skipNodeModules ? ` ${shellQuote(':(exclude,glob)**/node_modules/**')}` : '';\n    const pruneNames = skipNodeModules ? '-name .git -o -name node_modules' : '-name .git';\n    const script = [\n      `pat=${shellQuote(options.pattern)}`,\n      `root=${shellQuote(abs)}`,\n      // xargs exit codes can't tell \"no match\" from \"bad pattern\"; check first.\n      `grep ${mode} -e \"$pat\" </dev/null >/dev/null 2>&1`,\n      'if [ $? -eq 2 ]; then echo \"grep: invalid regular expression\" >&2; exit 2; fi',\n      'tmp=$(mktemp -d) || exit 1',\n      `trap 'rm -rf \"$tmp\"' EXIT`,\n      `search_files() { xargs -0 -r grep ${grepFlags} -e \"$pat\" -- 2>/dev/null; }`,\n      // A line starting with NUL names the directory later paths are relative to.\n      'search_repo() {',\n      `  git -C \"$1\" grep -l -z -I --untracked ${options.caseSensitive ? '' : '-i '}${mode} -e \"$pat\" -- .${nodeModulesPathspec} >\"$tmp/files\" 2>/dev/null`,\n      '  [ $? -gt 1 ] && return 1',\n      `  printf '\\\\0%s\\\\n' \"$1\"`,\n      '  (cd \"$1\" && search_files) <\"$tmp/files\"',\n      '}',\n      ...(hasGit\n        ? [\n            'if git -C \"$root\" rev-parse --is-inside-work-tree >/dev/null 2>&1 && ! git -C \"$root\" check-ignore -q . 2>/dev/null; then',\n            '  search_repo \"$root\" && exit 0',\n            'fi',\n            `find \"$root\" -mindepth 1 -maxdepth 3 \\\\( ${skipNodeModules ? '-name node_modules -prune' : '-false'} \\\\) -o \\\\( -name .git -prune -print \\\\) >\"$tmp/repos\" 2>/dev/null`,\n            ': >\"$tmp/done\"',\n            'while IFS= read -r g; do',\n            '  d=${g%/.git}',\n            '  search_repo \"$d\" && printf \\'%s\\\\n\\' \"$d\" >>\"$tmp/done\"',\n            'done <\"$tmp/repos\"',\n            'set --',\n            'while IFS= read -r d; do set -- \"$@\" -o -path \"$d\"; done <\"$tmp/done\"',\n          ]\n        : ['set --']),\n      `printf '\\\\0%s\\\\n' \"$root\"`,\n      `find \"$root\" -mindepth 1 \\\\( ${pruneNames} \"$@\" \\\\) -prune -o -type f -print0 2>/dev/null | search_files`,\n      'exit 0',\n    ].join('\\n');\n    const result = await this.exec(script);\n    if (result.exitCode !== 0) {\n      throw new UnsupportedGrepPatternError(options.pattern, describeGrepFailure(result));\n    }\n    const files = new Map<string, GrepFileLines>();\n    let base = abs;\n    for (const line of result.stdout.split('\\n')) {\n      if (!line || line === '--') continue;\n      if (line.startsWith('\\0')) {\n        base = line.slice(1);\n        continue;\n      }\n      const nul = line.indexOf('\\0');\n      if (nul <= 0) continue;\n      const parsed = /^(\\d+)([:-])(.*)$/s.exec(line.slice(nul + 1));\n      if (!parsed) continue;\n      const lineNumber = Number(parsed[1]);\n      const text = parsed[3]!;\n      const state = fileLines(files, posixPath.resolve(base, line.slice(0, nul)));\n      state.linesByNumber.set(lineNumber, text);\n      if (parsed[2] !== ':') continue;\n      const column = jsRegex.exec(text)?.index;\n      if (column === undefined) {\n        throw new UnsupportedGrepPatternError(options.pattern, 'POSIX ERE and JS RegExp disagree on this pattern');\n      }\n      state.matches.push({ line: lineNumber, column, text });\n    }\n    return this.applyTotalCap(toGrepResults(files, abs, contextLines), options.maxTotalMatches);\n  }\n\n  private async grepWithPosixGrep(abs: string, options: FilesystemGrepOptions): Promise<FilesystemGrepResult[]> {\n    const jsRegex = SandboxFilesystem.grepRegex(options);\n    // Reconstructing per-match context from `grep -C` text output is not\n    // reliable (separator lines are ambiguous); let the host walk handle it.\n    if (options.contextLines) {\n      throw new UnsupportedGrepPatternError(options.pattern, 'context lines are not supported by POSIX grep');\n    }\n    const args = [\n      'grep -rnIE',\n      // .git is filtered host-side too; skip it so object files are not scanned.\n      '--exclude-dir=.git',\n      options.caseSensitive ? '' : '-i',\n      options.maxCountPerFile !== undefined ? `-m ${Math.max(1, Math.floor(options.maxCountPerFile))}` : '',\n      '--',\n      shellQuote(options.pattern),\n      shellQuote(abs),\n    ]\n      .filter(Boolean)\n      .join(' ');\n    const result = await this.exec(args);\n    if (result.exitCode === 1) return [];\n    // Like rg, grep exits 2 on per-file errors (e.g. an unreadable file) while\n    // still printing matches for the rest; keep those partial results.\n    if (result.exitCode !== 0 && !(result.exitCode === 2 && result.stdout.trim())) {\n      throw new UnsupportedGrepPatternError(options.pattern, describeGrepFailure(result));\n    }\n    // grep -n has no column output; recompute with the JS regex host-side so\n    // columns are UTF-16 indices, consistent with the fallback implementation.\n    const byFile = new Map<string, FilesystemGrepMatch[]>();\n    for (const line of result.stdout.split('\\n')) {\n      if (!line) continue;\n      const parsed = /^(.*?):(\\d+):(.*)$/.exec(line);\n      if (!parsed) continue;\n      const rel = posixPath.relative(abs, parsed[1]!) || posixPath.basename(parsed[1]!);\n      const text = parsed[3]!;\n      const column = jsRegex.exec(text)?.index;\n      // grep matched this line but the JS regex did not: the two dialects\n      // disagree on this pattern, so the columns would be wrong. Fall back.\n      if (column === undefined) {\n        throw new UnsupportedGrepPatternError(options.pattern, 'POSIX ERE and JS RegExp disagree on this pattern');\n      }\n      let matches = byFile.get(rel);\n      if (!matches) {\n        matches = [];\n        byFile.set(rel, matches);\n      }\n      matches.push({ line: Number(parsed[2]), column, text });\n    }\n    const results = [...byFile.entries()].map(([path, matches]) => ({ path, matches }));\n    return this.applyTotalCap(results, options.maxTotalMatches);\n  }\n\n  private applyTotalCap(results: FilesystemGrepResult[], maxTotal?: number): FilesystemGrepResult[] {\n    if (maxTotal === undefined) return results;\n    const capped: FilesystemGrepResult[] = [];\n    let total = 0;\n    for (const file of results) {\n      if (total >= maxTotal) break;\n      const remaining = maxTotal - total;\n      const matches = file.matches.slice(0, remaining);\n      total += matches.length;\n      capped.push({ path: file.path, matches });\n    }\n    return capped;\n  }\n\n  // ── Path / metadata ────────────────────────────────────────────────────\n\n  async exists(path: string): Promise<boolean> {\n    const abs = await this.resolveAsync(path);\n    const native = this.sandbox.filesystem;\n    if (native) return native.exists(abs);\n    const result = await this.exec(`test -e ${shellQuote(abs)}`);\n    return result.exitCode === 0;\n  }\n\n  async stat(path: string): Promise<FileStat> {\n    const abs = await this.resolveAsync(path);\n    const native = this.sandbox.filesystem;\n    if (native) {\n      await this.verifyNative('target', abs, path);\n      const info = await native.stat(abs);\n      return {\n        ...info,\n        name: posixPath.basename(abs),\n        path: `/${posixPath.relative(this.basePath, abs)}`,\n        mimeType: info.type === 'file' ? (info.mimeType ?? getMimeType(abs)) : info.mimeType,\n      };\n    }\n    await this.assertContainedRealpath(abs, path);\n    // GNU stat: %F=type, %s=size, %Y=mtime (epoch seconds), %W=birth (or -1).\n    // BSD/macOS stat (local sandbox hosts) rejects `-c`; fall back to its\n    // `-f` format with the same field order (%HT=type, %z=size, %m=mtime,\n    // %B=birth). Delimit with `|` — neither stat interprets `\\t` escapes in\n    // its format string. `-L` reports the symlink target, like LocalFilesystem.\n    const result = await this.exec(\n      `stat -L -c '%F|%s|%Y|%W' ${shellQuote(abs)} 2>/dev/null || stat -L -f '%HT|%z|%m|%B' ${shellQuote(abs)}`,\n    );\n    if (result.exitCode !== 0) {\n      throw new FileNotFoundError(path);\n    }\n    const [kind, sizeStr, mtimeStr, ctimeStr] = result.stdout.trim().split('|');\n    const type = kind && kind.toLowerCase().includes('directory') ? 'directory' : 'file';\n    const size = Number(sizeStr) || 0;\n    const mtime = Number(mtimeStr) || 0;\n    const ctime = Number(ctimeStr);\n    return {\n      name: posixPath.basename(abs),\n      path: `/${posixPath.relative(this.basePath, abs)}`,\n      type,\n      size: type === 'directory' ? 0 : size,\n      modifiedAt: new Date(mtime * 1000),\n      createdAt: new Date((ctime > 0 ? ctime : mtime) * 1000),\n      mimeType: type === 'file' ? getMimeType(abs) : undefined,\n    };\n  }\n\n  // ── Lifecycle ──────────────────────────────────────────────────────────\n\n  async init(): Promise<void> {\n    await this.execOk(`mkdir -p ${shellQuote(await this.base())}`, 'init workdir');\n  }\n\n  async destroy(): Promise<void> {\n    // The sandbox lifecycle is owned by the caller; nothing to tear down here.\n  }\n\n  async isReady(): Promise<boolean> {\n    const result = await this.exec(`test -d ${shellQuote(await this.base())}`);\n    return result.exitCode === 0;\n  }\n\n  getInfo(): FilesystemInfo {\n    return {\n      id: this.id,\n      name: this.name,\n      provider: this.provider,\n      status: this.status,\n      metadata: { basePath: this.basePath, sandboxId: this.sandbox.id },\n    };\n  }\n\n  getInstructions(): string {\n    return `Files are stored in a remote sandbox at ${this.basePath}. Use absolute workspace paths like /src/index.ts. All reads, writes and commands run inside the same sandbox.`;\n  }\n}\n"],"mappings":"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"}

package/dist/agents/subagents/execute.js

@@ -1,5 +1,5 @@
 import { MC_TOOLS } from "../../tool-names.js";
-//#region src/agents/subagents/execute.ts
+// src/agents/subagents/execute.ts
 const executeSubagent = {
 	id: "execute",
 	name: "Execute",
@@ -21,7 +21,6 @@ const executeSubagent = {
 		MC_TOOLS.LSP_INSPECT
 	]
 };
-//#endregion
 export { executeSubagent };
 
 //# sourceMappingURL=execute.js.map

package/dist/agents/subagents/explore.js

@@ -1,5 +1,5 @@
 import { MC_TOOLS } from "../../tool-names.js";
-//#region src/agents/subagents/explore.ts
+// src/agents/subagents/explore.ts
 const exploreSubagent = {
 	id: "explore",
 	name: "Explore",
@@ -12,7 +12,6 @@ const exploreSubagent = {
 		MC_TOOLS.FILE_STAT
 	]
 };
-//#endregion
 export { exploreSubagent };
 
 //# sourceMappingURL=explore.js.map

package/dist/agents/subagents/index.d.ts

@@ -0,0 +1,6 @@
+import type { AgentControllerSubagent } from '@mastra/core/agent-controller';
+/** The explore/plan/execute subagents. Not registered unless passed as `subagents`. */
+export declare const builtinSubagents: readonly AgentControllerSubagent[];
+/** Subagents for the `preferences.subagentsEnabled` setting: the built-ins when on, none when off. */
+export declare function resolveSubagentsSetting(enabled: boolean): AgentControllerSubagent[];
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/subagents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/subagents/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAK7E,uFAAuF;AACvF,eAAO,MAAM,gBAAgB,EAAE,SAAS,uBAAuB,EAAqD,CAAC;AAErH,sGAAsG;AACtG,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,uBAAuB,EAAE,CAEnF"}

package/dist/agents/subagents/index.js

@@ -0,0 +1,17 @@
+import { executeSubagent } from "./execute.js";
+import { exploreSubagent } from "./explore.js";
+import { planSubagent } from "./plan.js";
+// src/agents/subagents/index.ts
+/** The explore/plan/execute subagents. Not registered unless passed as `subagents`. */
+const builtinSubagents = [
+	exploreSubagent,
+	planSubagent,
+	executeSubagent
+];
+/** Subagents for the `preferences.subagentsEnabled` setting: the built-ins when on, none when off. */
+function resolveSubagentsSetting(enabled) {
+	return enabled ? [...builtinSubagents] : [];
+}
+export { builtinSubagents, resolveSubagentsSetting };
+
+//# sourceMappingURL=index.js.map

package/dist/agents/subagents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/agents/subagents/index.ts"],"sourcesContent":["import type { AgentControllerSubagent } from '@mastra/core/agent-controller';\nimport { executeSubagent } from './execute.js';\nimport { exploreSubagent } from './explore.js';\nimport { planSubagent } from './plan.js';\n\n/** The explore/plan/execute subagents. Not registered unless passed as `subagents`. */\nexport const builtinSubagents: readonly AgentControllerSubagent[] = [exploreSubagent, planSubagent, executeSubagent];\n\n/** Subagents for the `preferences.subagentsEnabled` setting: the built-ins when on, none when off. */\nexport function resolveSubagentsSetting(enabled: boolean): AgentControllerSubagent[] {\n  return enabled ? [...builtinSubagents] : [];\n}\n"],"mappings":";;;;;AAMA,MAAa,mBAAuD;CAAC;CAAiB;CAAc;AAAe;;AAGnH,SAAgB,wBAAwB,SAA6C;CACnF,OAAO,UAAU,CAAC,GAAG,gBAAgB,IAAI,CAAC;AAC5C"}

package/dist/agents/subagents/plan.js

@@ -1,5 +1,5 @@
 import { MC_TOOLS } from "../../tool-names.js";
-//#region src/agents/subagents/plan.ts
+// src/agents/subagents/plan.ts
 const planSubagent = {
 	id: "plan",
 	name: "Plan",
@@ -12,7 +12,6 @@ const planSubagent = {
 		MC_TOOLS.FILE_STAT
 	]
 };
-//#endregion
 export { planSubagent };
 
 //# sourceMappingURL=plan.js.map

package/dist/agents/thread-caveman-state.js

@@ -1,4 +1,4 @@
-//#region src/agents/thread-caveman-state.ts
+// src/agents/thread-caveman-state.ts
 const THREAD_STATE_SETTINGS = [
 	{
 		key: "cavemanObservations",
@@ -101,7 +101,6 @@ async function restoreOMThreadStateForCurrentThread(session) {
 	if (!threadId) return;
 	await restoreSettingsForThread(session, threadId);
 }
-//#endregion
 export { attachOMThreadStatePersistence, restoreOMThreadStateForCurrentThread };
 
 //# sourceMappingURL=thread-caveman-state.js.map

package/dist/agents/tool-availability.js

@@ -1,7 +1,7 @@
 import { getLocalPlansRelativeDir, isPlanFilePath } from "../utils/plans.js";
 import { MC_TOOLS, TOOL_NAME_OVERRIDES } from "../tool-names.js";
 import { WORKSPACE_TOOLS } from "@mastra/core/workspace";
-//#region src/agents/tool-availability.ts
+// src/agents/tool-availability.ts
 const PLAN_MODE_WRITE_TOOL_NAMES = /* @__PURE__ */ new Set([WORKSPACE_TOOLS.FILESYSTEM.WRITE_FILE, WORKSPACE_TOOLS.FILESYSTEM.EDIT_FILE]);
 function getRequestContextValue(requestContext, key) {
 	if (!requestContext) return void 0;
@@ -123,7 +123,6 @@ const GOAL_JUDGE_READONLY_TOOLS = [
 	MC_TOOLS.FILE_STAT,
 	MC_TOOLS.LSP_INSPECT
 ];
-//#endregion
 export { EXPLORE_MODE_AVAILABLE_TOOLS, GOAL_JUDGE_READONLY_TOOLS, MASTRACODE_WORKSPACE_TOOLS, PLAN_MODE_AVAILABLE_TOOLS, createMastraCodeWorkspaceTools, guardPlanModePlanFileWrites };
 
 //# sourceMappingURL=tool-availability.js.map

package/dist/agents/tools.js

@@ -11,7 +11,7 @@ import { WORKFLOW_MANAGEMENT_TOOL_IDS } from "../tools/workflows/tool-ids.js";
 import { createOpenAI } from "@ai-sdk/openai";
 import { NotificationsStorage, createNotificationInboxTool } from "@mastra/core/notifications";
 import { createAnthropic } from "@ai-sdk/anthropic";
-//#region src/agents/tools.ts
+// src/agents/tools.ts
 function configurePluginTool(tool, backgroundToolsEnabled) {
 	if (backgroundToolsEnabled || !tool.background) return tool;
 	return {
@@ -131,7 +131,6 @@ function createDynamicTools(mcpManager, extraTools, disabledTools, storage, plug
 		return resolveExtra();
 	};
 }
-//#endregion
 export { LazyNotificationsStorage, createDynamicTools, createToolHooks };
 
 //# sourceMappingURL=tools.js.map

package/dist/agents/workflow-builder-agent.js

@@ -6,7 +6,7 @@ import { listAvailableToolsTool } from "../tools/workflows/list-available-tools.
 import { listAvailableWorkflowsTool } from "../tools/workflows/list-available-workflows.js";
 import { saveWorkflowTool } from "../tools/workflows/save-workflow.js";
 import { createWorkflowBuilderAgent } from "@mastra/core/workflows/builder";
-//#region src/agents/workflow-builder-agent.ts
+// src/agents/workflow-builder-agent.ts
 /**
 * Workflow Builder sub-agent.
 *
@@ -76,7 +76,6 @@ Your fifth tool is \`save-workflow\`, which persists and live-registers a defini
 `,
 	model: getDynamicModel
 });
-//#endregion
 export { workflowBuilderAgent };
 
 //# sourceMappingURL=workflow-builder-agent.js.map

package/dist/agents/workspace.js

@@ -8,7 +8,7 @@ import fs, { existsSync } from "fs";
 import os from "os";
 import { fileURLToPath } from "url";
 import { LocalFilesystem, LocalSandbox, Workspace, createWorkspaceTools } from "@mastra/core/workspace";
-//#region src/agents/workspace.ts
+// src/agents/workspace.ts
 function buildSandboxEnv() {
 	return {
 		...process.env,
@@ -204,7 +204,6 @@ async function getGoalJudgeTools({ requestContext, mastra }) {
 	for (const name of GOAL_JUDGE_READONLY_TOOLS) if (allTools[name]) readonly[name] = allTools[name];
 	return Object.keys(readonly).length > 0 ? readonly : void 0;
 }
-//#endregion
 export { buildSkillPaths, getDynamicWorkspace, getGoalJudgeTools };
 
 //# sourceMappingURL=workspace.js.map