@struktoai/mirage-agents 0.0.3-alpha.0 → 0.0.4

package/dist/pi/index.js

@@ -1,7 +1,11 @@
 import {
   MIRAGE_SYSTEM_PROMPT,
   buildSystemPrompt
-} from "../chunk-KAHWIK63.js";
+} from "../chunk-ODKR5YZI.js";
+import {
+  FileVersionTracker,
+  StaleMirageFileError
+} from "../chunk-XEQB7N3F.js";
 
 // src/pi/extension.ts
 import {
@@ -12,11 +16,11 @@ import {
   createLsToolDefinition,
   createReadToolDefinition,
   createWriteToolDefinition
-} from "@mariozechner/pi-coding-agent";
+} from "@earendil-works/pi-coding-agent";
 
 // src/pi/operations.ts
-import picomatch from "picomatch";
 import { rstripSlash } from "@struktoai/mirage-core";
+import picomatch from "picomatch";
 async function ensureParent(ws, dir) {
   const norm = rstripSlash(dir) || "/";
   if (norm === "/" || await ws.fs.exists(norm)) return;
@@ -31,12 +35,7 @@ async function ensureParent(ws, dir) {
 }
 async function walkDirectory(ws, dir, cwdPrefix, matcher, opts, results) {
   if (results.length >= opts.limit) return;
-  let entries;
-  try {
-    entries = await ws.fs.readdir(dir);
-  } catch {
-    return;
-  }
+  const entries = await ws.fs.readdir(dir);
   for (const full of entries) {
     if (results.length >= opts.limit) return;
     const rel = full.startsWith(cwdPrefix) ? full.slice(cwdPrefix.length) : full;
@@ -46,20 +45,16 @@ async function walkDirectory(ws, dir, cwdPrefix, matcher, opts, results) {
     if (isDir) await walkDirectory(ws, full, cwdPrefix, matcher, opts, results);
   }
 }
-function mirageOperations(ws) {
+function mirageOperations(ws, options = {}) {
+  const versions = new FileVersionTracker(ws, options.staleWriteProtection ?? true);
   const read = {
-    readFile: async (absolutePath) => {
-      const bytes = await ws.fs.readFile(absolutePath, { raw: true });
-      return Buffer.from(bytes);
-    },
+    readFile: (absolutePath) => versions.read(absolutePath),
     access: async (absolutePath) => {
       await ws.fs.stat(absolutePath);
     }
   };
   const write = {
-    writeFile: async (absolutePath, content) => {
-      await ws.fs.writeFile(absolutePath, content);
-    },
+    writeFile: (absolutePath, content) => versions.write(absolutePath, content),
     mkdir: async (dir) => {
       await ensureParent(ws, dir);
       if (!await ws.fs.exists(dir)) {
@@ -68,29 +63,44 @@ function mirageOperations(ws) {
     }
   };
   const edit = {
-    readFile: read.readFile,
-    writeFile: write.writeFile,
+    readFile: (absolutePath) => versions.readForEdit(absolutePath),
+    writeFile: (absolutePath, content) => versions.writeEdit(absolutePath, content),
     access: read.access
   };
   const bash = {
-    exec: async (command, _cwd, options) => {
-      const result = await ws.execute(command);
-      const combined = result.stdoutText + result.stderrText;
-      if (combined.length > 0) {
-        options.onData(Buffer.from(combined));
+    exec: async (command, cwd, options2) => {
+      const timeoutSignal = options2.timeout !== void 0 && options2.timeout > 0 ? AbortSignal.timeout(options2.timeout * 1e3) : void 0;
+      const signal = options2.signal !== void 0 && timeoutSignal !== void 0 ? AbortSignal.any([options2.signal, timeoutSignal]) : options2.signal ?? timeoutSignal;
+      let result;
+      try {
+        result = signal === void 0 ? await ws.execute(command, { cwd }) : await ws.execute(command, { cwd, signal });
+      } catch (error) {
+        if (options2.signal?.aborted === true) {
+          throw new Error("aborted");
+        }
+        if (timeoutSignal?.aborted === true) {
+          throw new Error("timeout:" + String(options2.timeout));
+        }
+        throw error;
+      }
+      if (result.stdout.length > 0) {
+        options2.onData(Buffer.from(result.stdout));
+      }
+      if (result.stderr.length > 0) {
+        options2.onData(Buffer.from(result.stderr));
       }
       return { exitCode: result.exitCode };
     }
   };
   const grep = {
     isDirectory: async (absolutePath) => ws.fs.isDir(absolutePath),
-    readFile: async (absolutePath) => ws.fs.readFileText(absolutePath)
+    readFile: async (absolutePath) => (await versions.read(absolutePath)).toString("utf-8")
   };
   const find = {
     exists: async (absolutePath) => ws.fs.exists(absolutePath),
-    glob: async (pattern, cwd, options) => {
+    glob: async (pattern, cwd, options2) => {
       const matcher = picomatch(pattern, { dot: false });
-      const ignoreMatchers = options.ignore.map((p) => picomatch(p, { dot: false }));
+      const ignoreMatchers = options2.ignore.map((p) => picomatch(p, { dot: false }));
       const root = rstripSlash(cwd) || "/";
       const cwdPrefix = root === "/" ? "/" : `${root}/`;
       const results = [];
@@ -99,7 +109,7 @@ function mirageOperations(ws) {
         root,
         cwdPrefix,
         matcher,
-        { ignoreMatchers, limit: options.limit },
+        { ignoreMatchers, limit: options2.limit },
         results
       );
       return results;
@@ -121,21 +131,40 @@ function mirageOperations(ws) {
 }
 
 // src/pi/extension.ts
+function bashAtCwd(operations, cwd) {
+  return {
+    exec: (command, _hostCwd, options) => operations.exec(command, cwd, options)
+  };
+}
 function mirageExtension(ws, opts = {}) {
   const cwd = opts.cwd ?? "/";
-  const ops = mirageOperations(ws);
-  return (pi) => {
-    pi.registerTool(createReadToolDefinition(cwd, { operations: ops.read }));
-    pi.registerTool(createWriteToolDefinition(cwd, { operations: ops.write }));
-    pi.registerTool(createEditToolDefinition(cwd, { operations: ops.edit }));
-    pi.registerTool(createBashToolDefinition(cwd, { operations: ops.bash }));
-    pi.registerTool(createGrepToolDefinition(cwd, { operations: ops.grep }));
-    pi.registerTool(createFindToolDefinition(cwd, { operations: ops.find }));
-    pi.registerTool(createLsToolDefinition(cwd, { operations: ops.ls }));
+  const ops = mirageOperations(ws, opts);
+  const userBash = bashAtCwd(ops.bash, cwd);
+  const systemPrompt = opts.systemPrompt === false ? void 0 : opts.systemPrompt ?? buildSystemPrompt({ workspace: ws });
+  return {
+    name: "mirage",
+    factory: (pi) => {
+      pi.registerTool(createReadToolDefinition(cwd, { operations: ops.read }));
+      pi.registerTool(createWriteToolDefinition(cwd, { operations: ops.write }));
+      pi.registerTool(createEditToolDefinition(cwd, { operations: ops.edit }));
+      pi.registerTool(createBashToolDefinition(cwd, { operations: ops.bash }));
+      pi.registerTool(createGrepToolDefinition(cwd, { operations: ops.grep }));
+      pi.registerTool(createFindToolDefinition(cwd, { operations: ops.find }));
+      pi.registerTool(createLsToolDefinition(cwd, { operations: ops.ls }));
+      pi.on("user_bash", () => ({ operations: userBash }));
+      if (systemPrompt !== void 0) {
+        pi.on("before_agent_start", (event) => ({
+          systemPrompt: `${event.systemPrompt}
+
+${systemPrompt}`
+        }));
+      }
+    }
   };
 }
 export {
   MIRAGE_SYSTEM_PROMPT,
+  StaleMirageFileError,
   buildSystemPrompt,
   mirageExtension,
   mirageOperations

package/dist/pi/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/pi/extension.ts","../../src/pi/operations.ts"],"sourcesContent":["// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n//     http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========\n\nimport type { Workspace } from '@struktoai/mirage-core'\nimport {\n  createBashToolDefinition,\n  createEditToolDefinition,\n  createFindToolDefinition,\n  createGrepToolDefinition,\n  createLsToolDefinition,\n  createReadToolDefinition,\n  createWriteToolDefinition,\n  type ExtensionFactory,\n} from '@mariozechner/pi-coding-agent'\nimport { mirageOperations } from './operations.ts'\n\nexport interface MirageExtensionOptions {\n  cwd?: string\n}\n\nexport function mirageExtension(\n  ws: Workspace,\n  opts: MirageExtensionOptions = {},\n): ExtensionFactory {\n  const cwd = opts.cwd ?? '/'\n  const ops = mirageOperations(ws)\n  return (pi) => {\n    pi.registerTool(createReadToolDefinition(cwd, { operations: ops.read }))\n    pi.registerTool(createWriteToolDefinition(cwd, { operations: ops.write }))\n    pi.registerTool(createEditToolDefinition(cwd, { operations: ops.edit }))\n    pi.registerTool(createBashToolDefinition(cwd, { operations: ops.bash }))\n    pi.registerTool(createGrepToolDefinition(cwd, { operations: ops.grep }))\n    pi.registerTool(createFindToolDefinition(cwd, { operations: ops.find }))\n    pi.registerTool(createLsToolDefinition(cwd, { operations: ops.ls }))\n  }\n}\n","// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n//     http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========\n\nimport type { Workspace } from '@struktoai/mirage-core'\nimport type {\n  BashOperations,\n  EditOperations,\n  FindOperations,\n  GrepOperations,\n  LsOperations,\n  ReadOperations,\n  WriteOperations,\n} from '@mariozechner/pi-coding-agent'\nimport picomatch from 'picomatch'\nimport { rstripSlash } from '@struktoai/mirage-core'\n\nexport interface MirageOperationsBundle {\n  read: ReadOperations\n  write: WriteOperations\n  edit: EditOperations\n  bash: BashOperations\n  grep: GrepOperations\n  find: FindOperations\n  ls: LsOperations\n}\n\nasync function ensureParent(ws: Workspace, dir: string): Promise<void> {\n  const norm = rstripSlash(dir) || '/'\n  if (norm === '/' || (await ws.fs.exists(norm))) return\n  const parent = norm.substring(0, norm.lastIndexOf('/')) || '/'\n  await ensureParent(ws, parent)\n  try {\n    await ws.fs.mkdir(norm)\n  } catch (err) {\n    if (await ws.fs.isDir(norm)) return\n    throw err\n  }\n}\n\ninterface WalkOptions {\n  ignoreMatchers: ((path: string) => boolean)[]\n  limit: number\n}\n\nasync function walkDirectory(\n  ws: Workspace,\n  dir: string,\n  cwdPrefix: string,\n  matcher: (relativePath: string) => boolean,\n  opts: WalkOptions,\n  results: string[],\n): Promise<void> {\n  if (results.length >= opts.limit) return\n  let entries: string[]\n  try {\n    entries = await ws.fs.readdir(dir)\n  } catch {\n    return\n  }\n  for (const full of entries) {\n    if (results.length >= opts.limit) return\n    const rel = full.startsWith(cwdPrefix) ? full.slice(cwdPrefix.length) : full\n    if (opts.ignoreMatchers.some((m) => m(rel))) continue\n    const isDir = await ws.fs.isDir(full)\n    if (matcher(rel)) results.push(full)\n    if (isDir) await walkDirectory(ws, full, cwdPrefix, matcher, opts, results)\n  }\n}\n\nexport function mirageOperations(ws: Workspace): MirageOperationsBundle {\n  const read: ReadOperations = {\n    readFile: async (absolutePath: string) => {\n      const bytes = await ws.fs.readFile(absolutePath, { raw: true })\n      return Buffer.from(bytes)\n    },\n    access: async (absolutePath: string) => {\n      await ws.fs.stat(absolutePath)\n    },\n  }\n\n  const write: WriteOperations = {\n    writeFile: async (absolutePath: string, content: string) => {\n      await ws.fs.writeFile(absolutePath, content)\n    },\n    mkdir: async (dir: string) => {\n      await ensureParent(ws, dir)\n      if (!(await ws.fs.exists(dir))) {\n        await ws.fs.mkdir(dir)\n      }\n    },\n  }\n\n  const edit: EditOperations = {\n    readFile: read.readFile,\n    writeFile: write.writeFile,\n    access: read.access,\n  }\n\n  const bash: BashOperations = {\n    exec: async (command, _cwd, options) => {\n      const result = await ws.execute(command)\n      const combined = result.stdoutText + result.stderrText\n      if (combined.length > 0) {\n        options.onData(Buffer.from(combined))\n      }\n      return { exitCode: result.exitCode }\n    },\n  }\n\n  const grep: GrepOperations = {\n    isDirectory: async (absolutePath: string) => ws.fs.isDir(absolutePath),\n    readFile: async (absolutePath: string) => ws.fs.readFileText(absolutePath),\n  }\n\n  const find: FindOperations = {\n    exists: async (absolutePath: string) => ws.fs.exists(absolutePath),\n    glob: async (pattern, cwd, options) => {\n      const matcher = picomatch(pattern, { dot: false })\n      const ignoreMatchers = options.ignore.map((p) => picomatch(p, { dot: false }))\n      const root = rstripSlash(cwd) || '/'\n      const cwdPrefix = root === '/' ? '/' : `${root}/`\n      const results: string[] = []\n      await walkDirectory(\n        ws,\n        root,\n        cwdPrefix,\n        matcher,\n        { ignoreMatchers, limit: options.limit },\n        results,\n      )\n      return results\n    },\n  }\n\n  const ls: LsOperations = {\n    exists: async (absolutePath: string) => ws.fs.exists(absolutePath),\n    stat: async (absolutePath: string) => {\n      const isDir = await ws.fs.isDir(absolutePath)\n      return { isDirectory: () => isDir }\n    },\n    readdir: async (absolutePath: string) => {\n      const entries = await ws.fs.readdir(absolutePath)\n      const prefix = absolutePath === '/' ? '/' : `${rstripSlash(absolutePath)}/`\n      return entries.map((e) => (e.startsWith(prefix) ? e.slice(prefix.length) : e))\n    },\n  }\n\n  return { read, write, edit, bash, grep, find, ls }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/pi/extension.ts","../../src/pi/operations.ts"],"sourcesContent":["// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n//     http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========\n\nimport type { Workspace } from '@struktoai/mirage-core'\nimport {\n  createBashToolDefinition,\n  createEditToolDefinition,\n  createFindToolDefinition,\n  createGrepToolDefinition,\n  createLsToolDefinition,\n  createReadToolDefinition,\n  createWriteToolDefinition,\n  type BashOperations,\n  type InlineExtension,\n} from '@earendil-works/pi-coding-agent'\nimport { buildSystemPrompt } from '../prompt.ts'\nimport { mirageOperations, type MirageOperationsOptions } from './operations.ts'\n\nexport interface MirageExtensionOptions extends MirageOperationsOptions {\n  cwd?: string\n  systemPrompt?: string | false\n}\n\nfunction bashAtCwd(operations: BashOperations, cwd: string): BashOperations {\n  return {\n    exec: (command, _hostCwd, options) => operations.exec(command, cwd, options),\n  }\n}\n\nexport function mirageExtension(ws: Workspace, opts: MirageExtensionOptions = {}): InlineExtension {\n  const cwd = opts.cwd ?? '/'\n  const ops = mirageOperations(ws, opts)\n  const userBash = bashAtCwd(ops.bash, cwd)\n  const systemPrompt =\n    opts.systemPrompt === false\n      ? undefined\n      : (opts.systemPrompt ?? buildSystemPrompt({ workspace: ws }))\n  return {\n    name: 'mirage',\n    factory: (pi) => {\n      pi.registerTool(createReadToolDefinition(cwd, { operations: ops.read }))\n      pi.registerTool(createWriteToolDefinition(cwd, { operations: ops.write }))\n      pi.registerTool(createEditToolDefinition(cwd, { operations: ops.edit }))\n      pi.registerTool(createBashToolDefinition(cwd, { operations: ops.bash }))\n      pi.registerTool(createGrepToolDefinition(cwd, { operations: ops.grep }))\n      pi.registerTool(createFindToolDefinition(cwd, { operations: ops.find }))\n      pi.registerTool(createLsToolDefinition(cwd, { operations: ops.ls }))\n      pi.on('user_bash', () => ({ operations: userBash }))\n      if (systemPrompt !== undefined) {\n        pi.on('before_agent_start', (event) => ({\n          systemPrompt: `${event.systemPrompt}\\n\\n${systemPrompt}`,\n        }))\n      }\n    },\n  }\n}\n","// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n//     http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========\n\nimport { rstripSlash, type ExecuteResult, type Workspace } from '@struktoai/mirage-core'\nimport type {\n  BashOperations,\n  EditOperations,\n  FindOperations,\n  GrepOperations,\n  LsOperations,\n  ReadOperations,\n  WriteOperations,\n} from '@earendil-works/pi-coding-agent'\nimport picomatch from 'picomatch'\nimport { FileVersionTracker } from '../file-version.ts'\n\nexport { StaleMirageFileError } from '../file-version.ts'\n\nexport interface MirageOperationsOptions {\n  staleWriteProtection?: boolean\n}\n\nexport interface MirageOperationsBundle {\n  read: ReadOperations\n  write: WriteOperations\n  edit: EditOperations\n  bash: BashOperations\n  grep: GrepOperations\n  find: FindOperations\n  ls: LsOperations\n}\n\nasync function ensureParent(ws: Workspace, dir: string): Promise<void> {\n  const norm = rstripSlash(dir) || '/'\n  if (norm === '/' || (await ws.fs.exists(norm))) return\n  const parent = norm.substring(0, norm.lastIndexOf('/')) || '/'\n  await ensureParent(ws, parent)\n  try {\n    await ws.fs.mkdir(norm)\n  } catch (err) {\n    if (await ws.fs.isDir(norm)) return\n    throw err\n  }\n}\n\ninterface WalkOptions {\n  ignoreMatchers: ((path: string) => boolean)[]\n  limit: number\n}\n\nasync function walkDirectory(\n  ws: Workspace,\n  dir: string,\n  cwdPrefix: string,\n  matcher: (relativePath: string) => boolean,\n  opts: WalkOptions,\n  results: string[],\n): Promise<void> {\n  if (results.length >= opts.limit) return\n  const entries = await ws.fs.readdir(dir)\n  for (const full of entries) {\n    if (results.length >= opts.limit) return\n    const rel = full.startsWith(cwdPrefix) ? full.slice(cwdPrefix.length) : full\n    if (opts.ignoreMatchers.some((m) => m(rel))) continue\n    const isDir = await ws.fs.isDir(full)\n    if (matcher(rel)) results.push(full)\n    if (isDir) await walkDirectory(ws, full, cwdPrefix, matcher, opts, results)\n  }\n}\n\nexport function mirageOperations(\n  ws: Workspace,\n  options: MirageOperationsOptions = {},\n): MirageOperationsBundle {\n  const versions = new FileVersionTracker(ws, options.staleWriteProtection ?? true)\n  const read: ReadOperations = {\n    readFile: (absolutePath: string) => versions.read(absolutePath),\n    access: async (absolutePath: string) => {\n      await ws.fs.stat(absolutePath)\n    },\n  }\n\n  const write: WriteOperations = {\n    writeFile: (absolutePath: string, content: string) => versions.write(absolutePath, content),\n    mkdir: async (dir: string) => {\n      await ensureParent(ws, dir)\n      if (!(await ws.fs.exists(dir))) {\n        await ws.fs.mkdir(dir)\n      }\n    },\n  }\n\n  const edit: EditOperations = {\n    readFile: (absolutePath: string) => versions.readForEdit(absolutePath),\n    writeFile: (absolutePath: string, content: string) => versions.writeEdit(absolutePath, content),\n    access: read.access,\n  }\n\n  const bash: BashOperations = {\n    exec: async (command, cwd, options) => {\n      const timeoutSignal =\n        options.timeout !== undefined && options.timeout > 0\n          ? AbortSignal.timeout(options.timeout * 1000)\n          : undefined\n      const signal =\n        options.signal !== undefined && timeoutSignal !== undefined\n          ? AbortSignal.any([options.signal, timeoutSignal])\n          : (options.signal ?? timeoutSignal)\n      let result: ExecuteResult\n      try {\n        result =\n          signal === undefined\n            ? await ws.execute(command, { cwd })\n            : await ws.execute(command, { cwd, signal })\n      } catch (error) {\n        if (options.signal?.aborted === true) {\n          throw new Error('aborted')\n        }\n        if (timeoutSignal?.aborted === true) {\n          throw new Error('timeout:' + String(options.timeout))\n        }\n        throw error\n      }\n      if (result.stdout.length > 0) {\n        options.onData(Buffer.from(result.stdout))\n      }\n      if (result.stderr.length > 0) {\n        options.onData(Buffer.from(result.stderr))\n      }\n      return { exitCode: result.exitCode }\n    },\n  }\n\n  const grep: GrepOperations = {\n    isDirectory: async (absolutePath: string) => ws.fs.isDir(absolutePath),\n    readFile: async (absolutePath: string) => (await versions.read(absolutePath)).toString('utf-8'),\n  }\n\n  const find: FindOperations = {\n    exists: async (absolutePath: string) => ws.fs.exists(absolutePath),\n    glob: async (pattern, cwd, options) => {\n      const matcher = picomatch(pattern, { dot: false })\n      const ignoreMatchers = options.ignore.map((p) => picomatch(p, { dot: false }))\n      const root = rstripSlash(cwd) || '/'\n      const cwdPrefix = root === '/' ? '/' : `${root}/`\n      const results: string[] = []\n      await walkDirectory(\n        ws,\n        root,\n        cwdPrefix,\n        matcher,\n        { ignoreMatchers, limit: options.limit },\n        results,\n      )\n      return results\n    },\n  }\n\n  const ls: LsOperations = {\n    exists: async (absolutePath: string) => ws.fs.exists(absolutePath),\n    stat: async (absolutePath: string) => {\n      const isDir = await ws.fs.isDir(absolutePath)\n      return { isDirectory: () => isDir }\n    },\n    readdir: async (absolutePath: string) => {\n      const entries = await ws.fs.readdir(absolutePath)\n      const prefix = absolutePath === '/' ? '/' : `${rstripSlash(absolutePath)}/`\n      return entries.map((e) => (e.startsWith(prefix) ? e.slice(prefix.length) : e))\n    },\n  }\n\n  return { read, write, edit, bash, grep, find, ls }\n}\n"],"mappings":"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","names":["options"]}

package/dist/prompt-Ca4hc1Ul.d.ts

@@ -0,0 +1,11 @@
+import { Workspace } from '@struktoai/mirage-core';
+
+declare const MIRAGE_SYSTEM_PROMPT = "Your filesystem is powered by Mirage \u2014 a virtual filesystem that mounts cloud storage, local files, and in-memory data as a unified file tree.\n\nCapabilities beyond standard filesystem:\n- cat on .parquet, .orc, .feather files returns a formatted table\n- head -n 5 on data files returns the first 5 rows\n- grep works natively on CSV, JSON, Parquet \u2014 not just text\n- Pipes work: cat data.parquet | grep error | sort | uniq | wc -l\n- head, tail, cut, wc, sort, uniq, tee, xargs are all available\n\nYou can write Python code and execute it. The workspace is pre-configured with your data sources mounted at their respective paths.\n\nUse the execute tool for complex operations. Use read/write/edit for simple file operations.\n";
+interface BuildSystemPromptOptions {
+    workspace?: Workspace;
+    mountInfo?: Record<string, string>;
+    extraInstructions?: string;
+}
+declare function buildSystemPrompt(opts?: BuildSystemPromptOptions): string;
+
+export { type BuildSystemPromptOptions as B, MIRAGE_SYSTEM_PROMPT as M, buildSystemPrompt as b };

package/dist/tool-descriptions-7CgIovZc.d.ts

@@ -0,0 +1,33 @@
+import { Workspace } from '@struktoai/mirage-core';
+
+interface ToolResult {
+    [key: string]: unknown;
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    isError?: boolean;
+}
+interface MirageToolOperationsOptions {
+    staleWriteProtection?: boolean;
+}
+declare class MirageToolOperations {
+    private readonly ws;
+    private readonly versions;
+    constructor(ws: Workspace, options?: MirageToolOperationsOptions);
+    execute(command: string): Promise<ToolResult>;
+    read(path: string, offset?: number, limit?: number): Promise<ToolResult>;
+    write(path: string, content: string): Promise<ToolResult>;
+    edit(path: string, oldString: string, newString: string, replaceAll?: boolean): Promise<ToolResult>;
+    ls(path: string): Promise<ToolResult>;
+    grep(pattern: string, path: string): Promise<ToolResult>;
+}
+
+declare const EXECUTE_DESCRIPTION: string;
+declare const READ_DESCRIPTION: string;
+declare const WRITE_DESCRIPTION: string;
+declare const EDIT_DESCRIPTION: string;
+declare const LS_DESCRIPTION = "List files and directories at the given path on the Mirage virtual filesystem.";
+declare const GREP_DESCRIPTION: string;
+
+export { EDIT_DESCRIPTION as E, GREP_DESCRIPTION as G, LS_DESCRIPTION as L, type MirageToolOperationsOptions as M, READ_DESCRIPTION as R, type ToolResult as T, WRITE_DESCRIPTION as W, EXECUTE_DESCRIPTION as a, MirageToolOperations as b };

package/dist/vercel/index.d.ts

@@ -1,70 +1,6 @@
-import * as ai from 'ai';
-import { Workspace } from '@struktoai/mirage-node';
+import { Workspace } from '@struktoai/mirage-core';
+import { ToolSet } from 'ai';
 
-type ReadFileResult = {
-    kind: 'text';
-    path: string;
-    mimeType: string;
-    content: string;
-    bytes: number;
-} | {
-    kind: 'media';
-    path: string;
-    mimeType: string;
-    base64: string;
-    bytes: number;
-} | {
-    kind: 'binary';
-    path: string;
-    mimeType: string;
-    bytes: number;
-    note: string;
-} | {
-    error: string;
-};
-declare function mirageTools(ws: Workspace): {
-    execute: ai.Tool<{
-        command: string;
-    }, {
-        stdout: string;
-        stderr: string;
-        exitCode: number;
-    }>;
-    readFile: ai.Tool<{
-        path: string;
-    }, ReadFileResult>;
-    writeFile: ai.Tool<{
-        path: string;
-        content: string;
-    }, {
-        path: string;
-    }>;
-    editFile: ai.Tool<{
-        path: string;
-        oldString: string;
-        newString: string;
-        replaceAll?: boolean | undefined;
-    }, {
-        error: string;
-        path?: never;
-        occurrences?: never;
-    } | {
-        path: string;
-        occurrences: number;
-        error?: never;
-    }>;
-    ls: ai.Tool<{
-        path: string;
-    }, {
-        error: string;
-        files?: never;
-    } | {
-        files: {
-            path: string;
-            is_dir: boolean;
-        }[];
-        error?: never;
-    }>;
-};
+declare function mirageTools(ws: Workspace): ToolSet;
 
 export { mirageTools };

package/dist/vercel/index.js

@@ -1,3 +1,7 @@
+import {
+  readWorkspaceFile
+} from "../chunk-IMI7BLEG.js";
+
 // src/vercel/index.ts
 import { encodeBase64, gnuDirname } from "@struktoai/mirage-core";
 import { tool } from "ai";
@@ -13,79 +17,30 @@ async function ensureParent(ws, path) {
     if (!await ws.fs.exists(parent)) throw err;
   }
 }
-var TEXT_EXTS = /* @__PURE__ */ new Set([
-  "txt",
-  "md",
-  "json",
-  "jsonl",
-  "yaml",
-  "yml",
-  "csv",
-  "tsv",
-  "xml",
-  "html",
-  "htm",
-  "js",
-  "mjs",
-  "cjs",
-  "ts",
-  "tsx",
-  "jsx",
-  "py",
-  "rb",
-  "rs",
-  "go",
-  "java",
-  "c",
-  "cpp",
-  "h",
-  "hpp",
-  "sh",
-  "bash",
-  "zsh",
-  "sql",
-  "log",
-  "env",
-  "ini",
-  "toml",
-  "conf",
-  "cfg"
-]);
-var PRESENTABLE_BINARY = /* @__PURE__ */ new Set([
-  "application/pdf",
-  "image/jpeg",
-  "image/png",
-  "image/gif",
-  "image/webp"
-]);
-function extOf(path) {
-  const dot = path.lastIndexOf(".");
-  if (dot < 0) return "";
-  return path.slice(dot + 1).toLowerCase();
-}
-function mimeFor(path) {
-  const ext = extOf(path);
-  if (ext === "json" || ext === "jsonl") return "application/json";
-  if (ext === "csv") return "text/csv";
-  if (ext === "html" || ext === "htm") return "text/html";
-  if (ext === "md") return "text/markdown";
-  if (TEXT_EXTS.has(ext)) return "text/plain";
-  if (ext === "png") return "image/png";
-  if (ext === "jpg" || ext === "jpeg") return "image/jpeg";
-  if (ext === "gif") return "image/gif";
-  if (ext === "webp") return "image/webp";
-  if (ext === "pdf") return "application/pdf";
-  return "application/octet-stream";
-}
-function isTextMime(mime) {
-  return mime.startsWith("text/") || mime === "application/json";
-}
 function bytesToBase64(bytes) {
   return encodeBase64(bytes);
 }
 function isError(r) {
   return "error" in r;
 }
+async function readFileResult(ws, path) {
+  try {
+    const result = await readWorkspaceFile(ws, path);
+    if (result.kind === "text") return result;
+    if (result.kind === "image" || result.kind === "file") {
+      return {
+        kind: "media",
+        path: result.path,
+        mimeType: result.mimeType,
+        base64: bytesToBase64(result.data),
+        bytes: result.bytes
+      };
+    }
+    return result;
+  } catch (error) {
+    return { error: error instanceof Error ? error.message : String(error) };
+  }
+}
 function mirageTools(ws) {
   return {
     execute: tool({
@@ -107,40 +62,7 @@ function mirageTools(ws) {
       inputSchema: z.object({
         path: z.string().describe("Absolute path inside the workspace.")
       }),
-      execute: async ({ path }) => {
-        let bytes;
-        try {
-          bytes = await ws.fs.readFile(path);
-        } catch (err) {
-          return { error: err instanceof Error ? err.message : String(err) };
-        }
-        const mimeType = mimeFor(path);
-        if (isTextMime(mimeType)) {
-          return {
-            kind: "text",
-            path,
-            mimeType,
-            content: new TextDecoder("utf-8", { fatal: false }).decode(bytes),
-            bytes: bytes.length
-          };
-        }
-        if (PRESENTABLE_BINARY.has(mimeType)) {
-          return {
-            kind: "media",
-            path,
-            mimeType,
-            base64: bytesToBase64(bytes),
-            bytes: bytes.length
-          };
-        }
-        return {
-          kind: "binary",
-          path,
-          mimeType,
-          bytes: bytes.length,
-          note: `Binary file ${path} (${mimeType}, ${String(bytes.length)} bytes). Use the execute tool with shell commands (head, file, wc, od) to inspect.`
-        };
-      },
+      execute: async ({ path }) => readFileResult(ws, path),
       toModelOutput: ({ output }) => {
         const out = output;
         if (isError(out)) return { type: "error-text", value: out.error };
@@ -153,7 +75,11 @@ function mirageTools(ws) {
                 type: "text",
                 text: `[${out.path}] ${out.mimeType} (${String(out.bytes)} bytes)`
               },
-              { type: "media", data: out.base64, mediaType: out.mimeType }
+              {
+                type: "file",
+                data: { type: "data", data: out.base64 },
+                mediaType: out.mimeType
+              }
             ]
           };
         }

package/dist/vercel/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/vercel/index.ts"],"sourcesContent":["// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n//     http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========\n\nimport { encodeBase64, gnuDirname } from '@struktoai/mirage-core'\nimport type { Workspace } from '@struktoai/mirage-node'\nimport { tool } from 'ai'\nimport { z } from 'zod'\n\nasync function ensureParent(ws: Workspace, path: string): Promise<void> {\n  const parent = gnuDirname(path)\n  if (parent === '/' || parent === '' || parent === '.') return\n  if (await ws.fs.exists(parent)) return\n  await ensureParent(ws, parent)\n  try {\n    await ws.fs.mkdir(parent)\n  } catch (err) {\n    if (!(await ws.fs.exists(parent))) throw err\n  }\n}\n\nconst TEXT_EXTS = new Set([\n  'txt',\n  'md',\n  'json',\n  'jsonl',\n  'yaml',\n  'yml',\n  'csv',\n  'tsv',\n  'xml',\n  'html',\n  'htm',\n  'js',\n  'mjs',\n  'cjs',\n  'ts',\n  'tsx',\n  'jsx',\n  'py',\n  'rb',\n  'rs',\n  'go',\n  'java',\n  'c',\n  'cpp',\n  'h',\n  'hpp',\n  'sh',\n  'bash',\n  'zsh',\n  'sql',\n  'log',\n  'env',\n  'ini',\n  'toml',\n  'conf',\n  'cfg',\n])\n\nconst PRESENTABLE_BINARY = new Set([\n  'application/pdf',\n  'image/jpeg',\n  'image/png',\n  'image/gif',\n  'image/webp',\n])\n\nfunction extOf(path: string): string {\n  const dot = path.lastIndexOf('.')\n  if (dot < 0) return ''\n  return path.slice(dot + 1).toLowerCase()\n}\n\nfunction mimeFor(path: string): string {\n  const ext = extOf(path)\n  if (ext === 'json' || ext === 'jsonl') return 'application/json'\n  if (ext === 'csv') return 'text/csv'\n  if (ext === 'html' || ext === 'htm') return 'text/html'\n  if (ext === 'md') return 'text/markdown'\n  if (TEXT_EXTS.has(ext)) return 'text/plain'\n  if (ext === 'png') return 'image/png'\n  if (ext === 'jpg' || ext === 'jpeg') return 'image/jpeg'\n  if (ext === 'gif') return 'image/gif'\n  if (ext === 'webp') return 'image/webp'\n  if (ext === 'pdf') return 'application/pdf'\n  return 'application/octet-stream'\n}\n\nfunction isTextMime(mime: string): boolean {\n  return mime.startsWith('text/') || mime === 'application/json'\n}\n\nfunction bytesToBase64(bytes: Uint8Array): string {\n  return encodeBase64(bytes)\n}\n\ntype ReadFileResult =\n  | { kind: 'text'; path: string; mimeType: string; content: string; bytes: number }\n  | { kind: 'media'; path: string; mimeType: string; base64: string; bytes: number }\n  | { kind: 'binary'; path: string; mimeType: string; bytes: number; note: string }\n  | { error: string }\n\nfunction isError(r: ReadFileResult): r is { error: string } {\n  return 'error' in r\n}\n\nexport function mirageTools(ws: Workspace) {\n  return {\n    execute: tool({\n      description:\n        'Execute a shell command in the Mirage workspace and return stdout, stderr, and exitCode.',\n      inputSchema: z.object({\n        command: z.string().describe('The shell command to execute.'),\n      }),\n      execute: async ({ command }) => {\n        const io = await ws.execute(command)\n        return {\n          stdout: io.stdoutText,\n          stderr: io.stderrText,\n          exitCode: io.exitCode,\n        }\n      },\n    }),\n\n    readFile: tool({\n      description:\n        'Read a file from the Mirage workspace. Text files (utf-8 source/data) come back as text; PDFs and images (png/jpeg/gif/webp) come back as base64 media that is forwarded to the model as a multimodal attachment; other binaries return a metadata stub.',\n      inputSchema: z.object({\n        path: z.string().describe('Absolute path inside the workspace.'),\n      }),\n      execute: async ({ path }): Promise<ReadFileResult> => {\n        let bytes: Uint8Array\n        try {\n          bytes = await ws.fs.readFile(path)\n        } catch (err) {\n          return { error: err instanceof Error ? err.message : String(err) }\n        }\n        const mimeType = mimeFor(path)\n        if (isTextMime(mimeType)) {\n          return {\n            kind: 'text',\n            path,\n            mimeType,\n            content: new TextDecoder('utf-8', { fatal: false }).decode(bytes),\n            bytes: bytes.length,\n          }\n        }\n        if (PRESENTABLE_BINARY.has(mimeType)) {\n          return {\n            kind: 'media',\n            path,\n            mimeType,\n            base64: bytesToBase64(bytes),\n            bytes: bytes.length,\n          }\n        }\n        return {\n          kind: 'binary',\n          path,\n          mimeType,\n          bytes: bytes.length,\n          note: `Binary file ${path} (${mimeType}, ${String(bytes.length)} bytes). Use the execute tool with shell commands (head, file, wc, od) to inspect.`,\n        }\n      },\n      toModelOutput: ({ output }) => {\n        const out: ReadFileResult = output\n        if (isError(out)) return { type: 'error-text', value: out.error }\n        if (out.kind === 'text') return { type: 'text', value: out.content }\n        if (out.kind === 'media') {\n          return {\n            type: 'content',\n            value: [\n              {\n                type: 'text',\n                text: `[${out.path}] ${out.mimeType} (${String(out.bytes)} bytes)`,\n              },\n              { type: 'media', data: out.base64, mediaType: out.mimeType },\n            ],\n          }\n        }\n        return { type: 'text', value: out.note }\n      },\n    }),\n\n    writeFile: tool({\n      description:\n        'Write content to a file in the Mirage workspace. Creates missing parent directories.',\n      inputSchema: z.object({\n        path: z.string().describe('Absolute path inside the workspace.'),\n        content: z.string().describe('UTF-8 text content to write.'),\n      }),\n      execute: async ({ path, content }) => {\n        await ensureParent(ws, path)\n        await ws.fs.writeFile(path, content)\n        return { path }\n      },\n    }),\n\n    editFile: tool({\n      description:\n        'Replace a string inside an existing file. Errors if the string appears more than once unless replaceAll is true.',\n      inputSchema: z.object({\n        path: z.string().describe('Absolute path of the file to edit.'),\n        oldString: z.string().describe('The exact string to replace.'),\n        newString: z.string().describe('The replacement string.'),\n        replaceAll: z\n          .boolean()\n          .optional()\n          .describe('Replace every occurrence rather than requiring a unique match.'),\n      }),\n      execute: async ({ path, oldString, newString, replaceAll }) => {\n        let current: string\n        try {\n          current = await ws.fs.readFileText(path)\n        } catch {\n          return { error: `Error: file '${path}' not found` }\n        }\n        const count = current.split(oldString).length - 1\n        if (count === 0) {\n          return { error: `Error: string not found in file: '${oldString}'` }\n        }\n        if (count > 1 && replaceAll !== true) {\n          return {\n            error: `Error: string '${oldString}' appears ${String(count)} times. Use replaceAll=true`,\n          }\n        }\n        const next =\n          replaceAll === true\n            ? current.split(oldString).join(newString)\n            : current.replace(oldString, newString)\n        await ws.fs.writeFile(path, next)\n        return { path, occurrences: replaceAll === true ? count : 1 }\n      },\n    }),\n\n    ls: tool({\n      description: 'List entries of a directory in the Mirage workspace.',\n      inputSchema: z.object({\n        path: z.string().describe('Absolute directory path inside the workspace.'),\n      }),\n      execute: async ({ path }) => {\n        let entries: string[]\n        try {\n          entries = await ws.fs.readdir(path)\n        } catch (err) {\n          return { error: err instanceof Error ? err.message : String(err) }\n        }\n        const files: { path: string; is_dir: boolean }[] = []\n        for (const entry of entries) {\n          const isDir = await ws.fs.isDir(entry)\n          files.push({ path: entry, is_dir: isDir })\n        }\n        return { files }\n      },\n    }),\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/vercel/index.ts"],"sourcesContent":["// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n//     http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========\n\nimport { encodeBase64, gnuDirname, type Workspace } from '@struktoai/mirage-core'\nimport { tool, type ToolSet } from 'ai'\nimport { z } from 'zod'\nimport { readWorkspaceFile } from '../read-file.ts'\n\nasync function ensureParent(ws: Workspace, path: string): Promise<void> {\n  const parent = gnuDirname(path)\n  if (parent === '/' || parent === '' || parent === '.') return\n  if (await ws.fs.exists(parent)) return\n  await ensureParent(ws, parent)\n  try {\n    await ws.fs.mkdir(parent)\n  } catch (err) {\n    if (!(await ws.fs.exists(parent))) throw err\n  }\n}\n\nfunction bytesToBase64(bytes: Uint8Array): string {\n  return encodeBase64(bytes)\n}\n\ntype ReadFileResult =\n  | { kind: 'text'; path: string; mimeType: string; content: string; bytes: number }\n  | { kind: 'media'; path: string; mimeType: string; base64: string; bytes: number }\n  | { kind: 'binary'; path: string; mimeType: string; bytes: number; note: string }\n  | { error: string }\n\nfunction isError(r: ReadFileResult): r is { error: string } {\n  return 'error' in r\n}\n\nasync function readFileResult(ws: Workspace, path: string): Promise<ReadFileResult> {\n  try {\n    const result = await readWorkspaceFile(ws, path)\n    if (result.kind === 'text') return result\n    if (result.kind === 'image' || result.kind === 'file') {\n      return {\n        kind: 'media',\n        path: result.path,\n        mimeType: result.mimeType,\n        base64: bytesToBase64(result.data),\n        bytes: result.bytes,\n      }\n    }\n    return result\n  } catch (error) {\n    return { error: error instanceof Error ? error.message : String(error) }\n  }\n}\n\nexport function mirageTools(ws: Workspace): ToolSet {\n  return {\n    execute: tool({\n      description:\n        'Execute a shell command in the Mirage workspace and return stdout, stderr, and exitCode.',\n      inputSchema: z.object({\n        command: z.string().describe('The shell command to execute.'),\n      }),\n      execute: async ({ command }) => {\n        const io = await ws.execute(command)\n        return {\n          stdout: io.stdoutText,\n          stderr: io.stderrText,\n          exitCode: io.exitCode,\n        }\n      },\n    }),\n\n    readFile: tool({\n      description:\n        'Read a file from the Mirage workspace. Text files (utf-8 source/data) come back as text; PDFs and images (png/jpeg/gif/webp) come back as base64 media that is forwarded to the model as a multimodal attachment; other binaries return a metadata stub.',\n      inputSchema: z.object({\n        path: z.string().describe('Absolute path inside the workspace.'),\n      }),\n      execute: async ({ path }): Promise<ReadFileResult> => readFileResult(ws, path),\n      toModelOutput: ({ output }) => {\n        const out: ReadFileResult = output\n        if (isError(out)) return { type: 'error-text', value: out.error }\n        if (out.kind === 'text') return { type: 'text', value: out.content }\n        if (out.kind === 'media') {\n          return {\n            type: 'content',\n            value: [\n              {\n                type: 'text',\n                text: `[${out.path}] ${out.mimeType} (${String(out.bytes)} bytes)`,\n              },\n              {\n                type: 'file',\n                data: { type: 'data', data: out.base64 },\n                mediaType: out.mimeType,\n              },\n            ],\n          }\n        }\n        return { type: 'text', value: out.note }\n      },\n    }),\n\n    writeFile: tool({\n      description:\n        'Write content to a file in the Mirage workspace. Creates missing parent directories.',\n      inputSchema: z.object({\n        path: z.string().describe('Absolute path inside the workspace.'),\n        content: z.string().describe('UTF-8 text content to write.'),\n      }),\n      execute: async ({ path, content }) => {\n        await ensureParent(ws, path)\n        await ws.fs.writeFile(path, content)\n        return { path }\n      },\n    }),\n\n    editFile: tool({\n      description:\n        'Replace a string inside an existing file. Errors if the string appears more than once unless replaceAll is true.',\n      inputSchema: z.object({\n        path: z.string().describe('Absolute path of the file to edit.'),\n        oldString: z.string().describe('The exact string to replace.'),\n        newString: z.string().describe('The replacement string.'),\n        replaceAll: z\n          .boolean()\n          .optional()\n          .describe('Replace every occurrence rather than requiring a unique match.'),\n      }),\n      execute: async ({ path, oldString, newString, replaceAll }) => {\n        let current: string\n        try {\n          current = await ws.fs.readFileText(path)\n        } catch {\n          return { error: `Error: file '${path}' not found` }\n        }\n        const count = current.split(oldString).length - 1\n        if (count === 0) {\n          return { error: `Error: string not found in file: '${oldString}'` }\n        }\n        if (count > 1 && replaceAll !== true) {\n          return {\n            error: `Error: string '${oldString}' appears ${String(count)} times. Use replaceAll=true`,\n          }\n        }\n        const next =\n          replaceAll === true\n            ? current.split(oldString).join(newString)\n            : current.replace(oldString, newString)\n        await ws.fs.writeFile(path, next)\n        return { path, occurrences: replaceAll === true ? count : 1 }\n      },\n    }),\n\n    ls: tool({\n      description: 'List entries of a directory in the Mirage workspace.',\n      inputSchema: z.object({\n        path: z.string().describe('Absolute directory path inside the workspace.'),\n      }),\n      execute: async ({ path }) => {\n        let entries: string[]\n        try {\n          entries = await ws.fs.readdir(path)\n        } catch (err) {\n          return { error: err instanceof Error ? err.message : String(err) }\n        }\n        const files: { path: string; is_dir: boolean }[] = []\n        for (const entry of entries) {\n          const isDir = await ws.fs.isDir(entry)\n          files.push({ path: entry, is_dir: isDir })\n        }\n        return { files }\n      },\n    }),\n  }\n}\n"],"mappings":"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","names":[]}