@mastra/code-sdk 0.0.0-aggregate-trace-20261015182851

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

@@ -0,0 +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 *\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  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\n/** Default per-command deadline so a hung sandbox can't block file tools forever. */\nconst COMMAND_TIMEOUT_MS = 30_000;\n\n/** Single-quote a string for safe POSIX shell interpolation. */\nfunction shellQuote(value: string): string {\n  return `'${value.replace(/'/g, `'\\\\''`)}'`;\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\n  constructor(options: SandboxFilesystemOptions) {\n    this.sandbox = options.sandbox;\n    this.workdirSource = options.workdir;\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<void> {\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;\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  }\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<void> {\n    // First check the target itself (covers overwriting an existing symlink).\n    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  }\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    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    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    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    // 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    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    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    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    // 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    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.\n    const hiddenPrune = options?.includeHidden ? '' : `-name '.*' -prune -o `;\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}-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. Prefers\n   * ripgrep (`rg --json`) when installed; otherwise falls back to\n   * `grep -rnE`. Patterns the ERE fallback can't express (PCRE-style classes,\n   * word boundaries, lookarounds, non-greedy quantifiers) throw\n   * {@link UnsupportedGrepPatternError} so callers use their host-side walk.\n   *\n   * Callers are expected to apply their own gitignore/hidden/glob filtering\n   * to the returned paths; both engines run with ignore rules disabled so\n   * results are a superset of what any host-side filter would keep.\n   */\n  async grep(options: FilesystemGrepOptions): Promise<FilesystemGrepResult[]> {\n    const abs = await this.resolveAsync(options.path);\n    await this.assertContainedRealpath(abs, options.path);\n    if (await this.hasRipgrep()) {\n      return this.grepWithRipgrep(abs, options);\n    }\n    return this.grepWithPosixGrep(abs, options);\n  }\n\n  private rgCheck: Promise<boolean> | undefined;\n\n  private hasRipgrep(): Promise<boolean> {\n    this.rgCheck ??= this.exec('command -v rg >/dev/null 2>&1').then(\n      r => r.exitCode === 0,\n      () => false,\n    );\n    return this.rgCheck;\n  }\n\n  private async grepWithRipgrep(abs: string, options: FilesystemGrepOptions): Promise<FilesystemGrepResult[]> {\n    const args = [\n      'rg --json --no-ignore --hidden',\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      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);\n    }\n    return results;\n  }\n\n  private parseRipgrepJson(stdout: string, abs: string, options: FilesystemGrepOptions): FilesystemGrepResult[] {\n    interface FileState {\n      matches: Array<FilesystemGrepMatch & { lineNumber: number }>;\n      linesByNumber: Map<number, string>;\n    }\n    const files = new Map<string, FileState>();\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      let state = files.get(filePath);\n      if (!state) {\n        state = { matches: [], linesByNumber: new Map() };\n        files.set(filePath, state);\n      }\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, lineNumber });\n      }\n    }\n    const contextLines = options.contextLines ?? 0;\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: FilesystemGrepMatch[] = state.matches.map(({ lineNumber, ...match }) => {\n        if (contextLines <= 0) return match;\n        const before: string[] = [];\n        for (let n = lineNumber - 1; n >= Math.max(1, lineNumber - contextLines); n--) {\n          const t = state.linesByNumber.get(n);\n          if (t === undefined) break;\n          before.unshift(t);\n        }\n        const after: string[] = [];\n        for (let n = lineNumber + 1; n <= lineNumber + contextLines; n++) {\n          const t = state.linesByNumber.get(n);\n          if (t === undefined) break;\n          after.push(t);\n        }\n        return { ...match, before, after };\n      });\n      results.push({ path: rel, matches });\n    }\n    return this.applyTotalCap(results, 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  private async grepWithPosixGrep(abs: string, options: FilesystemGrepOptions): Promise<FilesystemGrepResult[]> {\n    if (SandboxFilesystem.ERE_UNSUPPORTED.test(options.pattern)) {\n      throw new UnsupportedGrepPatternError(options.pattern);\n    }\n    let jsRegex: RegExp;\n    try {\n      jsRegex = new RegExp(options.pattern, options.caseSensitive ? '' : 'i');\n    } catch {\n      throw new UnsupportedGrepPatternError(options.pattern);\n    }\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);\n    }\n    const args = [\n      'grep -rnIE',\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    if (result.exitCode !== 0) {\n      throw new UnsupportedGrepPatternError(options.pattern);\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) throw new UnsupportedGrepPatternError(options.pattern);\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 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    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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"}

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

@@ -0,0 +1,3 @@
+import type { AgentControllerSubagent } from '@mastra/core/agent-controller';
+export declare const executeSubagent: AgentControllerSubagent;
+//# sourceMappingURL=execute.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/agents/subagents/execute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAG7E,eAAO,MAAM,eAAe,EAAE,uBAoB7B,CAAC"}

package/dist/agents/subagents/execute.js

@@ -0,0 +1,27 @@
+import { MC_TOOLS } from "../../tool-names.js";
+//#region src/agents/subagents/execute.ts
+const executeSubagent = {
+	id: "execute",
+	name: "Execute",
+	description: "Implement a focused task, run relevant checks, and report the result.",
+	instructions: `You are a focused execution agent. Read relevant files before editing them and follow existing conventions. Stay within the assigned task; do not make unrelated changes. Use workspace tools to edit files and execute commands to verify your changes. Do not delegate work or modify the parent task list. Return a concise summary of changed files, verification results, and any blockers. Never claim checks passed unless you ran them successfully.`,
+	allowedWorkspaceTools: [
+		MC_TOOLS.VIEW,
+		MC_TOOLS.FIND_FILES,
+		MC_TOOLS.SEARCH_CONTENT,
+		MC_TOOLS.FILE_STAT,
+		MC_TOOLS.WRITE_FILE,
+		MC_TOOLS.STRING_REPLACE_LSP,
+		MC_TOOLS.DELETE_FILE,
+		MC_TOOLS.MKDIR,
+		MC_TOOLS.AST_SMART_EDIT,
+		MC_TOOLS.EXECUTE_COMMAND,
+		MC_TOOLS.GET_PROCESS_OUTPUT,
+		MC_TOOLS.KILL_PROCESS,
+		MC_TOOLS.LSP_INSPECT
+	]
+};
+//#endregion
+export { executeSubagent };
+
+//# sourceMappingURL=execute.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execute.js","names":[],"sources":["../../../src/agents/subagents/execute.ts"],"sourcesContent":["import type { AgentControllerSubagent } from '@mastra/core/agent-controller';\nimport { MC_TOOLS } from '../../tool-names.js';\n\nexport const executeSubagent: AgentControllerSubagent = {\n  id: 'execute',\n  name: 'Execute',\n  description: 'Implement a focused task, run relevant checks, and report the result.',\n  instructions: `You are a focused execution agent. Read relevant files before editing them and follow existing conventions. Stay within the assigned task; do not make unrelated changes. Use workspace tools to edit files and execute commands to verify your changes. Do not delegate work or modify the parent task list. Return a concise summary of changed files, verification results, and any blockers. Never claim checks passed unless you ran them successfully.`,\n  allowedWorkspaceTools: [\n    MC_TOOLS.VIEW,\n    MC_TOOLS.FIND_FILES,\n    MC_TOOLS.SEARCH_CONTENT,\n    MC_TOOLS.FILE_STAT,\n    MC_TOOLS.WRITE_FILE,\n    MC_TOOLS.STRING_REPLACE_LSP,\n    MC_TOOLS.DELETE_FILE,\n    MC_TOOLS.MKDIR,\n    MC_TOOLS.AST_SMART_EDIT,\n    MC_TOOLS.EXECUTE_COMMAND,\n    MC_TOOLS.GET_PROCESS_OUTPUT,\n    MC_TOOLS.KILL_PROCESS,\n    MC_TOOLS.LSP_INSPECT,\n  ],\n};\n"],"mappings":";;AAGA,MAAa,kBAA2C;CACtD,IAAI;CACJ,MAAM;CACN,aAAa;CACb,cAAc;CACd,uBAAuB;EACrB,SAAS;EACT,SAAS;EACT,SAAS;EACT,SAAS;EACT,SAAS;EACT,SAAS;EACT,SAAS;EACT,SAAS;EACT,SAAS;EACT,SAAS;EACT,SAAS;EACT,SAAS;EACT,SAAS;CACX;AACF"}

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

@@ -0,0 +1,3 @@
+import type { AgentControllerSubagent } from '@mastra/core/agent-controller';
+export declare const exploreSubagent: AgentControllerSubagent;
+//# sourceMappingURL=explore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"explore.d.ts","sourceRoot":"","sources":["../../../src/agents/subagents/explore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAG7E,eAAO,MAAM,eAAe,EAAE,uBAM7B,CAAC"}

package/dist/agents/subagents/explore.js

@@ -0,0 +1,18 @@
+import { MC_TOOLS } from "../../tool-names.js";
+//#region src/agents/subagents/explore.ts
+const exploreSubagent = {
+	id: "explore",
+	name: "Explore",
+	description: "Explore the codebase and answer focused questions without modifying files.",
+	instructions: `You are a read-only codebase exploration agent. Read relevant files before drawing conclusions. Use view, find_files, search_content, and file_stat to investigate. Do not modify files or run shell commands. Return concise findings with file paths and line numbers, and clearly distinguish verified facts from assumptions.`,
+	allowedWorkspaceTools: [
+		MC_TOOLS.VIEW,
+		MC_TOOLS.FIND_FILES,
+		MC_TOOLS.SEARCH_CONTENT,
+		MC_TOOLS.FILE_STAT
+	]
+};
+//#endregion
+export { exploreSubagent };
+
+//# sourceMappingURL=explore.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"explore.js","names":[],"sources":["../../../src/agents/subagents/explore.ts"],"sourcesContent":["import type { AgentControllerSubagent } from '@mastra/core/agent-controller';\nimport { MC_TOOLS } from '../../tool-names.js';\n\nexport const exploreSubagent: AgentControllerSubagent = {\n  id: 'explore',\n  name: 'Explore',\n  description: 'Explore the codebase and answer focused questions without modifying files.',\n  instructions: `You are a read-only codebase exploration agent. Read relevant files before drawing conclusions. Use view, find_files, search_content, and file_stat to investigate. Do not modify files or run shell commands. Return concise findings with file paths and line numbers, and clearly distinguish verified facts from assumptions.`,\n  allowedWorkspaceTools: [MC_TOOLS.VIEW, MC_TOOLS.FIND_FILES, MC_TOOLS.SEARCH_CONTENT, MC_TOOLS.FILE_STAT],\n};\n"],"mappings":";;AAGA,MAAa,kBAA2C;CACtD,IAAI;CACJ,MAAM;CACN,aAAa;CACb,cAAc;CACd,uBAAuB;EAAC,SAAS;EAAM,SAAS;EAAY,SAAS;EAAgB,SAAS;CAAS;AACzG"}

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

@@ -0,0 +1,3 @@
+import type { AgentControllerSubagent } from '@mastra/core/agent-controller';
+export declare const planSubagent: AgentControllerSubagent;
+//# sourceMappingURL=plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../src/agents/subagents/plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAG7E,eAAO,MAAM,YAAY,EAAE,uBAM1B,CAAC"}

package/dist/agents/subagents/plan.js

@@ -0,0 +1,18 @@
+import { MC_TOOLS } from "../../tool-names.js";
+//#region src/agents/subagents/plan.ts
+const planSubagent = {
+	id: "plan",
+	name: "Plan",
+	description: "Investigate a task and propose an implementation plan without modifying files.",
+	instructions: `You are a read-only planning agent. Inspect the relevant code using view, find_files, search_content, and file_stat before proposing changes. Do not modify files or run shell commands. Return a concise implementation plan with file paths, ordered steps, risks, and concrete verification criteria. State assumptions and unresolved questions.`,
+	allowedWorkspaceTools: [
+		MC_TOOLS.VIEW,
+		MC_TOOLS.FIND_FILES,
+		MC_TOOLS.SEARCH_CONTENT,
+		MC_TOOLS.FILE_STAT
+	]
+};
+//#endregion
+export { planSubagent };
+
+//# sourceMappingURL=plan.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","names":[],"sources":["../../../src/agents/subagents/plan.ts"],"sourcesContent":["import type { AgentControllerSubagent } from '@mastra/core/agent-controller';\nimport { MC_TOOLS } from '../../tool-names.js';\n\nexport const planSubagent: AgentControllerSubagent = {\n  id: 'plan',\n  name: 'Plan',\n  description: 'Investigate a task and propose an implementation plan without modifying files.',\n  instructions: `You are a read-only planning agent. Inspect the relevant code using view, find_files, search_content, and file_stat before proposing changes. Do not modify files or run shell commands. Return a concise implementation plan with file paths, ordered steps, risks, and concrete verification criteria. State assumptions and unresolved questions.`,\n  allowedWorkspaceTools: [MC_TOOLS.VIEW, MC_TOOLS.FIND_FILES, MC_TOOLS.SEARCH_CONTENT, MC_TOOLS.FILE_STAT],\n};\n"],"mappings":";;AAGA,MAAa,eAAwC;CACnD,IAAI;CACJ,MAAM;CACN,aAAa;CACb,cAAc;CACd,uBAAuB;EAAC,SAAS;EAAM,SAAS;EAAY,SAAS;EAAgB,SAAS;CAAS;AACzG"}

package/dist/agents/thread-caveman-state.d.ts

@@ -0,0 +1,17 @@
+import type { Session } from '@mastra/core/agent-controller';
+/**
+ * Wires MastraCode-owned state into controller thread events so it persists
+ * per-thread and new threads inherit the most recent value.
+ *
+ * This is intentionally implemented in mastracode rather than core: these
+ * settings are mastracode-specific concepts, so persistence stays scoped to
+ * the host.
+ */
+export declare function attachOMThreadStatePersistence(session: Session<Record<string, unknown>>): void;
+/**
+ * Eagerly restores MastraCode-owned OM settings for the currently-selected
+ * thread. Called once at TUI startup after the initial thread is selected,
+ * since the subscription set up later misses the startup `thread_changed` event.
+ */
+export declare function restoreOMThreadStateForCurrentThread(session: Session<Record<string, unknown>>): Promise<void>;
+//# sourceMappingURL=thread-caveman-state.d.ts.map

package/dist/agents/thread-caveman-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-caveman-state.d.ts","sourceRoot":"","sources":["../../src/agents/thread-caveman-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAyB,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAkGpF;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAqB9F;AAED;;;;GAIG;AACH,wBAAsB,oCAAoC,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAInH"}

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

@@ -0,0 +1,107 @@
+//#region src/agents/thread-caveman-state.ts
+const THREAD_STATE_SETTINGS = [
+	{
+		key: "cavemanObservations",
+		isValid: (value) => typeof value === "boolean",
+		seedMissingFromCurrentState: true
+	},
+	{
+		key: "observeAttachments",
+		isValid: (value) => value === "auto" || typeof value === "boolean",
+		seedMissingFromCurrentState: true
+	},
+	{
+		key: "sandboxAllowedPaths",
+		isValid: (value) => Array.isArray(value) && value.every((item) => typeof item === "string"),
+		clearValueWhenMissing: []
+	}
+];
+function getStateValue(session, setting) {
+	const value = session.state.get()[setting.key];
+	return setting.isValid(value) ? value : void 0;
+}
+function stateValuesEqual(left, right) {
+	if (Array.isArray(left) && Array.isArray(right)) return left.length === right.length && left.every((item, index) => item === right[index]);
+	return left === right;
+}
+async function findThread(session, threadId) {
+	return (await session.thread.list({ allResources: true })).find((t) => t.id === threadId);
+}
+/**
+* Restores MastraCode-owned per-thread state for the given thread:
+* - If the thread already has a valid value in metadata, mirror it into controller state.
+* - Otherwise, persist the current session.state value to the thread so future
+*   sessions see the user's last-selected setting.
+*/
+async function restoreSettingsForThread(session, threadId) {
+	const thread = await findThread(session, threadId);
+	if (session.thread.getId() !== threadId) return;
+	const updates = {};
+	const settingsToSeed = [];
+	for (const setting of THREAD_STATE_SETTINGS) {
+		const persisted = thread?.metadata?.[setting.key];
+		if (setting.isValid(persisted)) {
+			if (getStateValue(session, setting) !== persisted) updates[setting.key] = persisted;
+			continue;
+		}
+		if (setting.clearValueWhenMissing !== void 0) {
+			const current = getStateValue(session, setting);
+			if (current !== void 0 && !stateValuesEqual(current, setting.clearValueWhenMissing)) updates[setting.key] = setting.clearValueWhenMissing;
+			continue;
+		}
+		if (setting.seedMissingFromCurrentState) {
+			const current = getStateValue(session, setting);
+			if (current !== void 0) settingsToSeed.push({
+				key: setting.key,
+				value: current
+			});
+		}
+	}
+	if (Object.keys(updates).length > 0) {
+		if (session.thread.getId() !== threadId) return;
+		await session.state.set(updates);
+	}
+	for (const setting of settingsToSeed) {
+		if (session.thread.getId() !== threadId) return;
+		await session.thread.setSetting(setting);
+	}
+}
+/**
+* Wires MastraCode-owned state into controller thread events so it persists
+* per-thread and new threads inherit the most recent value.
+*
+* This is intentionally implemented in mastracode rather than core: these
+* settings are mastracode-specific concepts, so persistence stays scoped to
+* the host.
+*/
+function attachOMThreadStatePersistence(session) {
+	session.subscribe((event) => {
+		if (event.type === "thread_changed" || event.type === "thread_created") {
+			restoreSettingsForThread(session, event.type === "thread_changed" ? event.threadId : event.thread.id).catch(() => {});
+			return;
+		}
+		if (event.type === "state_changed") for (const setting of THREAD_STATE_SETTINGS) {
+			if (!event.changedKeys.includes(setting.key)) continue;
+			const value = event.state[setting.key];
+			if (!setting.isValid(value)) continue;
+			session.thread.setSetting({
+				key: setting.key,
+				value
+			}).catch(() => {});
+		}
+	});
+}
+/**
+* Eagerly restores MastraCode-owned OM settings for the currently-selected
+* thread. Called once at TUI startup after the initial thread is selected,
+* since the subscription set up later misses the startup `thread_changed` event.
+*/
+async function restoreOMThreadStateForCurrentThread(session) {
+	const threadId = session.thread.getId();
+	if (!threadId) return;
+	await restoreSettingsForThread(session, threadId);
+}
+//#endregion
+export { attachOMThreadStatePersistence, restoreOMThreadStateForCurrentThread };
+
+//# sourceMappingURL=thread-caveman-state.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"thread-caveman-state.js","names":[],"sources":["../../src/agents/thread-caveman-state.ts"],"sourcesContent":["import type { AgentControllerThread, Session } from '@mastra/core/agent-controller';\n\ninterface ThreadStateSetting {\n  key: string;\n  isValid(value: unknown): boolean;\n  seedMissingFromCurrentState?: boolean;\n  clearValueWhenMissing?: unknown;\n}\n\nconst THREAD_STATE_SETTINGS: ThreadStateSetting[] = [\n  {\n    key: 'cavemanObservations',\n    isValid: (value: unknown): value is boolean => typeof value === 'boolean',\n    seedMissingFromCurrentState: true,\n  },\n  {\n    key: 'observeAttachments',\n    isValid: (value: unknown): value is 'auto' | boolean => value === 'auto' || typeof value === 'boolean',\n    seedMissingFromCurrentState: true,\n  },\n  {\n    key: 'sandboxAllowedPaths',\n    isValid: (value: unknown): value is string[] =>\n      Array.isArray(value) && value.every(item => typeof item === 'string'),\n    clearValueWhenMissing: [],\n  },\n];\n\nfunction getStateValue(session: Session<Record<string, unknown>>, setting: ThreadStateSetting): unknown {\n  const value = session.state.get()[setting.key];\n  return setting.isValid(value) ? value : undefined;\n}\n\nfunction stateValuesEqual(left: unknown, right: unknown): boolean {\n  if (Array.isArray(left) && Array.isArray(right)) {\n    return left.length === right.length && left.every((item, index) => item === right[index]);\n  }\n  return left === right;\n}\n\nasync function findThread(\n  session: Session<Record<string, unknown>>,\n  threadId: string,\n): Promise<AgentControllerThread | undefined> {\n  const threads = await session.thread.list({ allResources: true });\n  return threads.find(t => t.id === threadId);\n}\n\n/**\n * Restores MastraCode-owned per-thread state for the given thread:\n * - If the thread already has a valid value in metadata, mirror it into controller state.\n * - Otherwise, persist the current session.state value to the thread so future\n *   sessions see the user's last-selected setting.\n */\nasync function restoreSettingsForThread(session: Session<Record<string, unknown>>, threadId: string): Promise<void> {\n  const thread = await findThread(session, threadId);\n  if (session.thread.getId() !== threadId) return;\n\n  const updates: Record<string, unknown> = {};\n  const settingsToSeed: Array<{ key: string; value: unknown }> = [];\n\n  for (const setting of THREAD_STATE_SETTINGS) {\n    const persisted = thread?.metadata?.[setting.key];\n\n    if (setting.isValid(persisted)) {\n      if (getStateValue(session, setting) !== persisted) {\n        updates[setting.key] = persisted;\n      }\n      continue;\n    }\n\n    if (setting.clearValueWhenMissing !== undefined) {\n      const current = getStateValue(session, setting);\n      if (current !== undefined && !stateValuesEqual(current, setting.clearValueWhenMissing)) {\n        updates[setting.key] = setting.clearValueWhenMissing;\n      }\n      continue;\n    }\n\n    if (setting.seedMissingFromCurrentState) {\n      const current = getStateValue(session, setting);\n      if (current !== undefined) {\n        settingsToSeed.push({ key: setting.key, value: current });\n      }\n    }\n  }\n\n  if (Object.keys(updates).length > 0) {\n    if (session.thread.getId() !== threadId) return;\n    await session.state.set(updates);\n  }\n\n  for (const setting of settingsToSeed) {\n    if (session.thread.getId() !== threadId) return;\n    await session.thread.setSetting(setting);\n  }\n}\n\n/**\n * Wires MastraCode-owned state into controller thread events so it persists\n * per-thread and new threads inherit the most recent value.\n *\n * This is intentionally implemented in mastracode rather than core: these\n * settings are mastracode-specific concepts, so persistence stays scoped to\n * the host.\n */\nexport function attachOMThreadStatePersistence(session: Session<Record<string, unknown>>): void {\n  session.subscribe(event => {\n    if (event.type === 'thread_changed' || event.type === 'thread_created') {\n      const threadId = event.type === 'thread_changed' ? event.threadId : event.thread.id;\n      void restoreSettingsForThread(session, threadId).catch(() => {\n        // Persistence is best-effort; don't crash the TUI if storage hiccups.\n      });\n      return;\n    }\n\n    if (event.type === 'state_changed') {\n      for (const setting of THREAD_STATE_SETTINGS) {\n        if (!event.changedKeys.includes(setting.key)) continue;\n        const value = event.state[setting.key];\n        if (!setting.isValid(value)) continue;\n        void session.thread.setSetting({ key: setting.key, value }).catch(() => {\n          // Persistence is best-effort; don't crash the TUI if storage hiccups.\n        });\n      }\n    }\n  });\n}\n\n/**\n * Eagerly restores MastraCode-owned OM settings for the currently-selected\n * thread. Called once at TUI startup after the initial thread is selected,\n * since the subscription set up later misses the startup `thread_changed` event.\n */\nexport async function restoreOMThreadStateForCurrentThread(session: Session<Record<string, unknown>>): Promise<void> {\n  const threadId = session.thread.getId();\n  if (!threadId) return;\n  await restoreSettingsForThread(session, threadId);\n}\n"],"mappings":"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"}

package/dist/agents/tool-availability.d.ts

@@ -0,0 +1,12 @@
+import type { WorkspaceToolHookContext, WorkspaceToolsConfig } from '@mastra/core/workspace';
+export declare function guardPlanModePlanFileWrites({ workspaceToolName, input, context }: WorkspaceToolHookContext): {
+    proceed: false;
+    output: string;
+} | undefined;
+export declare function createMastraCodeWorkspaceTools(backgroundToolsEnabled?: boolean): WorkspaceToolsConfig;
+/** Default foreground-only configuration for consumers without Mastra Code settings. */
+export declare const MASTRACODE_WORKSPACE_TOOLS: WorkspaceToolsConfig;
+export declare const PLAN_MODE_AVAILABLE_TOOLS: readonly string[];
+export declare const EXPLORE_MODE_AVAILABLE_TOOLS: readonly string[];
+export declare const GOAL_JUDGE_READONLY_TOOLS: readonly string[];
+//# sourceMappingURL=tool-availability.d.ts.map

package/dist/agents/tool-availability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-availability.d.ts","sourceRoot":"","sources":["../../src/agents/tool-availability.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AA4D7F,wBAAgB,2BAA2B,CAAC,EAAE,iBAAiB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,wBAAwB;;;cA0B1G;AAID,wBAAgB,8BAA8B,CAAC,sBAAsB,UAAQ,GAAG,oBAAoB,CAiCnG;AAED,wFAAwF;AACxF,eAAO,MAAM,0BAA0B,sBAAmC,CAAC;AAE3E,eAAO,MAAM,yBAAyB,EAAE,SAAS,MAAM,EAwBtD,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,SAAS,MAAM,EAUzD,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,SAAS,MAAM,EAMtD,CAAC"}

package/dist/agents/tool-availability.js

@@ -0,0 +1,129 @@
+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
+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;
+	if (typeof requestContext.get === "function") return requestContext.get(key);
+	return requestContext[key];
+}
+function getHarnessContext(context) {
+	const requestContext = context?.requestContext;
+	const harness = getRequestContextValue(requestContext, "harness");
+	return harness && typeof harness === "object" ? harness : void 0;
+}
+function getHarnessState(harness) {
+	const state = harness?.session?.state?.get?.();
+	return state && typeof state === "object" ? state : void 0;
+}
+function getHarnessModeId(harness) {
+	const modeId = harness?.session?.modeId ?? getHarnessState(harness)?.modeId;
+	return typeof modeId === "string" ? modeId : void 0;
+}
+function getHarnessProjectPath(harness) {
+	const projectPath = getHarnessState(harness)?.projectPath;
+	return typeof projectPath === "string" ? projectPath : void 0;
+}
+function getHarnessFactoryProjectId(harness) {
+	const factoryProjectId = getHarnessState(harness)?.factoryProjectId;
+	return typeof factoryProjectId === "string" ? factoryProjectId : void 0;
+}
+function getToolInputPath(input) {
+	const toolPath = input?.path;
+	return typeof toolPath === "string" ? toolPath : void 0;
+}
+function guardPlanModePlanFileWrites({ workspaceToolName, input, context }) {
+	if (!PLAN_MODE_WRITE_TOOL_NAMES.has(workspaceToolName)) return;
+	const harness = getHarnessContext(context);
+	if (getHarnessModeId(harness) !== "plan") return;
+	const planOptions = { factoryProjectId: getHarnessFactoryProjectId(harness) };
+	const planDirHint = `${getLocalPlansRelativeDir(planOptions)}/`;
+	const projectPath = getHarnessProjectPath(harness);
+	const inputPath = getToolInputPath(input);
+	if (!projectPath || !inputPath) return {
+		proceed: false,
+		output: `Plan mode can only write plan files inside ${planDirHint}.`
+	};
+	if (isPlanFilePath(projectPath, inputPath, planOptions)) return;
+	return {
+		proceed: false,
+		output: `Plan mode can only write plan files inside ${planDirHint}. Refusing to edit ${inputPath}.`
+	};
+}
+const BACKGROUND_TOOL_CONFIG = {
+	enabled: true,
+	defaultDisposition: "foreground"
+};
+function createMastraCodeWorkspaceTools(backgroundToolsEnabled = false) {
+	const background = backgroundToolsEnabled ? BACKGROUND_TOOL_CONFIG : void 0;
+	return {
+		...TOOL_NAME_OVERRIDES,
+		[WORKSPACE_TOOLS.SANDBOX.EXECUTE_COMMAND]: {
+			...TOOL_NAME_OVERRIDES[WORKSPACE_TOOLS.SANDBOX.EXECUTE_COMMAND],
+			requireDescription: true
+		},
+		[WORKSPACE_TOOLS.FILESYSTEM.READ_FILE]: {
+			...TOOL_NAME_OVERRIDES[WORKSPACE_TOOLS.FILESYSTEM.READ_FILE],
+			...background ? { background } : {}
+		},
+		[WORKSPACE_TOOLS.FILESYSTEM.LIST_FILES]: {
+			...TOOL_NAME_OVERRIDES[WORKSPACE_TOOLS.FILESYSTEM.LIST_FILES],
+			...background ? { background } : {}
+		},
+		[WORKSPACE_TOOLS.FILESYSTEM.FILE_STAT]: {
+			...TOOL_NAME_OVERRIDES[WORKSPACE_TOOLS.FILESYSTEM.FILE_STAT],
+			...background ? { background } : {}
+		},
+		[WORKSPACE_TOOLS.FILESYSTEM.GREP]: {
+			...TOOL_NAME_OVERRIDES[WORKSPACE_TOOLS.FILESYSTEM.GREP],
+			...background ? { background } : {}
+		},
+		[WORKSPACE_TOOLS.LSP.LSP_INSPECT]: {
+			...TOOL_NAME_OVERRIDES[WORKSPACE_TOOLS.LSP.LSP_INSPECT],
+			...background ? { background } : {}
+		},
+		hooks: { beforeToolCall: guardPlanModePlanFileWrites }
+	};
+}
+/** Default foreground-only configuration for consumers without Mastra Code settings. */
+const MASTRACODE_WORKSPACE_TOOLS = createMastraCodeWorkspaceTools();
+const PLAN_MODE_AVAILABLE_TOOLS = [
+	MC_TOOLS.VIEW,
+	MC_TOOLS.FIND_FILES,
+	MC_TOOLS.SEARCH_CONTENT,
+	MC_TOOLS.FILE_STAT,
+	MC_TOOLS.LSP_INSPECT,
+	MC_TOOLS.WRITE_FILE,
+	MC_TOOLS.STRING_REPLACE_LSP,
+	"ask_user",
+	"submit_plan",
+	"task_write",
+	"task_update",
+	"task_complete",
+	"task_check",
+	MC_TOOLS.NOTIFICATION_INBOX,
+	"list-workflows",
+	"get-workflow"
+];
+const EXPLORE_MODE_AVAILABLE_TOOLS = [
+	MC_TOOLS.VIEW,
+	MC_TOOLS.FIND_FILES,
+	MC_TOOLS.SEARCH_CONTENT,
+	MC_TOOLS.FILE_STAT,
+	MC_TOOLS.LSP_INSPECT,
+	"ask_user",
+	"list-workflows",
+	"get-workflow"
+];
+const GOAL_JUDGE_READONLY_TOOLS = [
+	MC_TOOLS.VIEW,
+	MC_TOOLS.SEARCH_CONTENT,
+	MC_TOOLS.FIND_FILES,
+	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/tool-availability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-availability.js","names":[],"sources":["../../src/agents/tool-availability.ts"],"sourcesContent":["import { WORKSPACE_TOOLS } from '@mastra/core/workspace';\nimport type { WorkspaceToolHookContext, WorkspaceToolsConfig } from '@mastra/core/workspace';\nimport { MC_TOOLS, TOOL_NAME_OVERRIDES } from '../tool-names.js';\nimport { getLocalPlansRelativeDir, isPlanFilePath } from '../utils/plans.js';\n\nconst PLAN_MODE_WRITE_TOOL_NAMES = new Set<string>([\n  WORKSPACE_TOOLS.FILESYSTEM.WRITE_FILE,\n  WORKSPACE_TOOLS.FILESYSTEM.EDIT_FILE,\n]);\n\nfunction getRequestContextValue(requestContext: unknown, key: string): unknown {\n  if (!requestContext) return undefined;\n  if (typeof (requestContext as { get?: unknown }).get === 'function') {\n    return (requestContext as { get: (key: string) => unknown }).get(key);\n  }\n  return (requestContext as Record<string, unknown>)[key];\n}\n\n/**\n * Subset of the real `HarnessRequestContext` shape (see\n * packages/core/src/harness/types.ts). The mode is a string property\n * (`session.modeId`) and live state is read via `session.state.get()`.\n */\ninterface PlanModeGuardHarness {\n  session?: {\n    modeId?: unknown;\n    state?: { get?: () => unknown };\n  };\n}\n\nfunction getHarnessContext(context: unknown): PlanModeGuardHarness | undefined {\n  const requestContext = (context as { requestContext?: unknown } | undefined)?.requestContext;\n  const harness = getRequestContextValue(requestContext, 'harness');\n  return harness && typeof harness === 'object' ? (harness as PlanModeGuardHarness) : undefined;\n}\n\nfunction getHarnessState(harness: PlanModeGuardHarness | undefined): Record<string, unknown> | undefined {\n  const state = harness?.session?.state?.get?.();\n  return state && typeof state === 'object' ? (state as Record<string, unknown>) : undefined;\n}\n\nfunction getHarnessModeId(harness: PlanModeGuardHarness | undefined): string | undefined {\n  const modeId = harness?.session?.modeId ?? getHarnessState(harness)?.modeId;\n  return typeof modeId === 'string' ? modeId : undefined;\n}\n\nfunction getHarnessProjectPath(harness: PlanModeGuardHarness | undefined): string | undefined {\n  const projectPath = getHarnessState(harness)?.projectPath;\n  return typeof projectPath === 'string' ? projectPath : undefined;\n}\n\nfunction getHarnessFactoryProjectId(harness: PlanModeGuardHarness | undefined): string | undefined {\n  const factoryProjectId = getHarnessState(harness)?.factoryProjectId;\n  return typeof factoryProjectId === 'string' ? factoryProjectId : undefined;\n}\n\nfunction getToolInputPath(input: unknown): string | undefined {\n  const toolPath = (input as { path?: unknown } | undefined)?.path;\n  return typeof toolPath === 'string' ? toolPath : undefined;\n}\n\nexport function guardPlanModePlanFileWrites({ workspaceToolName, input, context }: WorkspaceToolHookContext) {\n  if (!PLAN_MODE_WRITE_TOOL_NAMES.has(workspaceToolName)) return;\n\n  const harness = getHarnessContext(context);\n  if (getHarnessModeId(harness) !== 'plan') return;\n\n  const factoryProjectId = getHarnessFactoryProjectId(harness);\n  const planOptions = { factoryProjectId };\n  const planDirHint = `${getLocalPlansRelativeDir(planOptions)}/`;\n  const projectPath = getHarnessProjectPath(harness);\n  const inputPath = getToolInputPath(input);\n  if (!projectPath || !inputPath) {\n    return {\n      proceed: false as const,\n      output: `Plan mode can only write plan files inside ${planDirHint}.`,\n    };\n  }\n\n  // Plan mode may write any `.md` file directly inside the configured plan directory,\n  // but nothing else in the project.\n  if (isPlanFilePath(projectPath, inputPath, planOptions)) return;\n\n  return {\n    proceed: false as const,\n    output: `Plan mode can only write plan files inside ${planDirHint}. Refusing to edit ${inputPath}.`,\n  };\n}\n\nconst BACKGROUND_TOOL_CONFIG = { enabled: true, defaultDisposition: 'foreground' } as const;\n\nexport function createMastraCodeWorkspaceTools(backgroundToolsEnabled = false): WorkspaceToolsConfig {\n  const background = backgroundToolsEnabled ? BACKGROUND_TOOL_CONFIG : undefined;\n  return {\n    ...TOOL_NAME_OVERRIDES,\n    // The TUI shows this description in place of the raw command.\n    [WORKSPACE_TOOLS.SANDBOX.EXECUTE_COMMAND]: {\n      ...TOOL_NAME_OVERRIDES[WORKSPACE_TOOLS.SANDBOX.EXECUTE_COMMAND],\n      requireDescription: true,\n    },\n    [WORKSPACE_TOOLS.FILESYSTEM.READ_FILE]: {\n      ...TOOL_NAME_OVERRIDES[WORKSPACE_TOOLS.FILESYSTEM.READ_FILE],\n      ...(background ? { background } : {}),\n    },\n    [WORKSPACE_TOOLS.FILESYSTEM.LIST_FILES]: {\n      ...TOOL_NAME_OVERRIDES[WORKSPACE_TOOLS.FILESYSTEM.LIST_FILES],\n      ...(background ? { background } : {}),\n    },\n    [WORKSPACE_TOOLS.FILESYSTEM.FILE_STAT]: {\n      ...TOOL_NAME_OVERRIDES[WORKSPACE_TOOLS.FILESYSTEM.FILE_STAT],\n      ...(background ? { background } : {}),\n    },\n    [WORKSPACE_TOOLS.FILESYSTEM.GREP]: {\n      ...TOOL_NAME_OVERRIDES[WORKSPACE_TOOLS.FILESYSTEM.GREP],\n      ...(background ? { background } : {}),\n    },\n    [WORKSPACE_TOOLS.LSP.LSP_INSPECT]: {\n      ...TOOL_NAME_OVERRIDES[WORKSPACE_TOOLS.LSP.LSP_INSPECT],\n      ...(background ? { background } : {}),\n    },\n    hooks: {\n      beforeToolCall: guardPlanModePlanFileWrites,\n    },\n  };\n}\n\n/** Default foreground-only configuration for consumers without Mastra Code settings. */\nexport const MASTRACODE_WORKSPACE_TOOLS = createMastraCodeWorkspaceTools();\n\nexport const PLAN_MODE_AVAILABLE_TOOLS: readonly string[] = [\n  // Read-only exploration tools\n  MC_TOOLS.VIEW,\n  MC_TOOLS.FIND_FILES,\n  MC_TOOLS.SEARCH_CONTENT,\n  MC_TOOLS.FILE_STAT,\n  MC_TOOLS.LSP_INSPECT,\n  // Plan file writing. Tool hooks enforce that these can only write `.md`\n  // files inside the session's configured plan directory while in plan mode.\n  MC_TOOLS.WRITE_FILE,\n  MC_TOOLS.STRING_REPLACE_LSP,\n  // Plan delivery tools\n  'ask_user',\n  'submit_plan',\n  // Task tools for plan-stage tracking\n  'task_write',\n  'task_update',\n  'task_complete',\n  'task_check',\n  // Notification access\n  MC_TOOLS.NOTIFICATION_INBOX,\n  // Read-only workflow inspection (no create/run/delete in plan mode).\n  'list-workflows',\n  'get-workflow',\n];\n\nexport const EXPLORE_MODE_AVAILABLE_TOOLS: readonly string[] = [\n  MC_TOOLS.VIEW,\n  MC_TOOLS.FIND_FILES,\n  MC_TOOLS.SEARCH_CONTENT,\n  MC_TOOLS.FILE_STAT,\n  MC_TOOLS.LSP_INSPECT,\n  'ask_user',\n  // Read-only workflow inspection (no create/run/delete in fast mode either).\n  'list-workflows',\n  'get-workflow',\n];\n\nexport const GOAL_JUDGE_READONLY_TOOLS: readonly string[] = [\n  MC_TOOLS.VIEW,\n  MC_TOOLS.SEARCH_CONTENT,\n  MC_TOOLS.FIND_FILES,\n  MC_TOOLS.FILE_STAT,\n  MC_TOOLS.LSP_INSPECT,\n];\n"],"mappings":"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"}

package/dist/agents/tools.d.ts

@@ -0,0 +1,37 @@
+import type { ToolsInput } from '@mastra/core/agent';
+import { NotificationsStorage } from '@mastra/core/notifications';
+import type { CreateNotificationInput, ListDueNotificationsInput, ListNotificationsInput, UpdateNotificationInput, UpdateNotificationsStatusInput } from '@mastra/core/notifications';
+import type { RequestContext } from '@mastra/core/request-context';
+import type { MastraCompositeStore } from '@mastra/core/storage';
+import type { ToolAfterHookContext, ToolHooks } from '@mastra/core/tools';
+import type { HookManager } from '../hooks/index.js';
+import type { McpManager } from '../mcp/index.js';
+/** Minimal shape for tools passed to createDynamicTools. */
+export type ToolLike = {
+    execute?: (...args: any[]) => Promise<unknown> | unknown;
+} & Record<string, any>;
+export declare class LazyNotificationsStorage extends NotificationsStorage {
+    private readonly storage;
+    constructor(storage: MastraCompositeStore);
+    private getNotificationsStorage;
+    createNotification(input: CreateNotificationInput): Promise<import("@mastra/core/storage").NotificationRecord>;
+    listNotifications(input: ListNotificationsInput): Promise<import("@mastra/core/storage").NotificationRecord[]>;
+    listDueNotifications(input: ListDueNotificationsInput): Promise<import("@mastra/core/storage").NotificationRecord[]>;
+    getNotification(input: {
+        threadId: string;
+        id: string;
+    }): Promise<import("@mastra/core/storage").NotificationRecord | null>;
+    updateNotification(input: UpdateNotificationInput): Promise<import("@mastra/core/storage").NotificationRecord>;
+    updateNotificationsStatus(input: UpdateNotificationsStatusInput): Promise<import("@mastra/core/storage").NotificationRecord[]>;
+    dangerouslyClearAll(): Promise<void>;
+}
+export type PostToolObserver = (context: ToolAfterHookContext) => void | Promise<void>;
+export declare function createToolHooks(hookManager?: HookManager, postToolObserver?: PostToolObserver): ToolHooks | undefined;
+type DynamicToolProvider = Record<string, ToolLike | undefined> | ((ctx: {
+    requestContext: RequestContext;
+}) => Record<string, ToolLike | undefined> | Promise<Record<string, ToolLike | undefined>>);
+export declare function createDynamicTools(mcpManager?: McpManager, extraTools?: DynamicToolProvider, disabledTools?: string[], storage?: MastraCompositeStore, pluginTools?: Record<string, ToolLike>, backgroundToolsEnabled?: boolean, builtinTools?: Record<string, ToolLike>): ({ requestContext, }: {
+    requestContext: RequestContext;
+}) => ToolsInput | Promise<ToolsInput>;
+export {};
+//# sourceMappingURL=tools.d.ts.map

package/dist/agents/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/agents/tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAA+B,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAC/F,OAAO,KAAK,EACV,uBAAuB,EACvB,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,8BAA8B,EAC/B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAWlD,4DAA4D;AAC5D,MAAM,MAAM,QAAQ,GAAG;IACrB,OAAO,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAC1D,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAOxB,qBAAa,wBAAyB,SAAQ,oBAAoB;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,oBAAoB;YAI5C,uBAAuB;IAQ/B,kBAAkB,CAAC,KAAK,EAAE,uBAAuB;IAIjD,iBAAiB,CAAC,KAAK,EAAE,sBAAsB;IAI/C,oBAAoB,CAAC,KAAK,EAAE,yBAAyB;IAIrD,eAAe,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE;IAIvD,kBAAkB,CAAC,KAAK,EAAE,uBAAuB;IAIxC,yBAAyB,CAAC,KAAK,EAAE,8BAA8B;IAIxE,mBAAmB;CAG1B;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEvF,wBAAgB,eAAe,CAAC,WAAW,CAAC,EAAE,WAAW,EAAE,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,SAAS,GAAG,SAAS,CAoCrH;AAED,KAAK,mBAAmB,GACpB,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC,GACpC,CAAC,CAAC,GAAG,EAAE;IACL,cAAc,EAAE,cAAc,CAAC;CAChC,KAAK,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;AAEhG,wBAAgB,kBAAkB,CAChC,UAAU,CAAC,EAAE,UAAU,EACvB,UAAU,CAAC,EAAE,mBAAmB,EAChC,aAAa,CAAC,EAAE,MAAM,EAAE,EACxB,OAAO,CAAC,EAAE,oBAAoB,EAC9B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EACtC,sBAAsB,UAAQ,EAC9B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAEP,qBAE7B;IACD,cAAc,EAAE,cAAc,CAAC;CAChC,KAAG,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAgGrC"}