@struktoai/mirage-agents 0.0.3 → 0.0.5-alpha.1

package/dist/claude-agent-sdk/index.js

@@ -1,115 +1,24 @@
+import {
+  EDIT_DESCRIPTION,
+  EXECUTE_DESCRIPTION,
+  GREP_DESCRIPTION,
+  LS_DESCRIPTION,
+  MirageToolOperations,
+  READ_DESCRIPTION,
+  WRITE_DESCRIPTION
+} from "../chunk-Y4G25V5V.js";
 import {
   MIRAGE_SYSTEM_PROMPT,
   buildSystemPrompt
-} from "../chunk-ODKR5YZI.js";
+} from "../chunk-ZPXFVDYT.js";
+import "../chunk-XEQB7N3F.js";
 
 // src/claude-agent-sdk/server.ts
-import { VERSION, gnuDirname } from "@struktoai/mirage-core";
+import { VERSION } from "@struktoai/mirage-core";
 import { createSdkMcpServer, tool } from "@anthropic-ai/claude-agent-sdk";
 import { z } from "zod";
-
-// src/io-text.ts
-function decode(value) {
-  if (value === null || value === void 0) return "";
-  return new TextDecoder("utf-8").decode(value);
-}
-function ioToStr(io) {
-  const stdout = io.stdoutText;
-  const stderr = io.stderrText;
-  if (stderr) return stdout ? `${stdout}
-${stderr}` : stderr;
-  return stdout;
-}
-
-// src/claude-agent-sdk/descriptions.ts
-var EXECUTE_DESCRIPTION = "Run a shell-style command on the Mirage virtual filesystem. Supports cat, grep, find, head, tail, ls, wc, sort, uniq, tee, pipe, and any other Unix command on mounted resources (S3, disk, RAM, etc.). Also supports reading structured files: cat on .parquet/.orc/.csv returns a table.";
-var READ_DESCRIPTION = "Read the contents of a file on the Mirage virtual filesystem. Returns line-numbered text. Optionally pass 'offset' (default 0) to start at a given line and 'limit' (default 2000) to cap the number of lines returned.";
-var WRITE_DESCRIPTION = "Write content to a new file on the Mirage virtual filesystem. Fails if the file already exists; use edit to modify an existing file.";
-var EDIT_DESCRIPTION = "Replace a string in an existing file on the Mirage virtual filesystem. Fails if old_string is not found or appears more than once. Pass replace_all=true (default false) to replace every occurrence.";
-var LS_DESCRIPTION = "List files and directories at the given path on the Mirage virtual filesystem.";
-var GREP_DESCRIPTION = "Search for a pattern in files on the Mirage virtual filesystem. Supports regex. Searches recursively under path.";
-
-// src/claude-agent-sdk/server.ts
-function textResult(text) {
-  return { content: [{ type: "text", text }] };
-}
-function errorResult(text) {
-  return { content: [{ type: "text", text }], isError: true };
-}
-function ioResult(io) {
-  const result = textResult(ioToStr(io));
-  if (io.exitCode !== 0) result.isError = true;
-  return result;
-}
-function shQuote(value) {
-  return `'${value.replace(/'/g, "'\\''")}'`;
-}
-async function ensureParents(ws, path) {
-  const parent = gnuDirname(path);
-  if (parent === "/" || parent === "" || parent === ".") return;
-  if (await ws.fs.exists(parent)) return;
-  await ensureParents(ws, parent);
-  try {
-    await ws.fs.mkdir(parent);
-  } catch (err) {
-    if (!await ws.fs.exists(parent)) throw err;
-  }
-}
-async function runExecute(ws, command) {
-  return ioResult(await ws.execute(command));
-}
-async function runRead(ws, path, offset = 0, limit = 2e3) {
-  let data;
-  try {
-    data = await ws.fs.readFile(path);
-  } catch (err) {
-    if (!await ws.fs.exists(path)) {
-      return errorResult(`Error: file '${path}' not found`);
-    }
-    return errorResult(`Error: ${err instanceof Error ? err.message : String(err)}`);
-  }
-  const text = decode(data);
-  const raw = text.length === 0 ? [] : text.split(/(?<=\n)/);
-  const lines = raw.length > 0 && raw[raw.length - 1] === "" ? raw.slice(0, -1) : raw;
-  const sliced = lines.slice(offset, offset + limit);
-  const numbered = sliced.map((line, i) => `${String(i + offset + 1).padStart(6)}	${line}`);
-  return textResult(numbered.join(""));
-}
-async function runWrite(ws, path, content) {
-  if (await ws.fs.exists(path)) {
-    return errorResult(`Error: file '${path}' already exists`);
-  }
-  await ensureParents(ws, path);
-  await ws.fs.writeFile(path, content);
-  return textResult(`Written: ${path}`);
-}
-async function runEdit(ws, path, oldString, newString, replaceAll = false) {
-  let content;
-  try {
-    content = await ws.fs.readFileText(path);
-  } catch {
-    return errorResult(`Error: file '${path}' not found`);
-  }
-  const count = content.split(oldString).length - 1;
-  if (count === 0) {
-    return errorResult(`Error: string not found in file: '${oldString}'`);
-  }
-  if (count > 1 && !replaceAll) {
-    return errorResult(`Error: string appears ${String(count)} times. Pass replace_all=true`);
-  }
-  const newContent = replaceAll ? content.split(oldString).join(newString) : content.replace(oldString, newString);
-  await ws.fs.writeFile(path, newContent);
-  const occurrences = replaceAll ? count : 1;
-  return textResult(`Edited: ${path} (${String(occurrences)} occurrence(s))`);
-}
-async function runLs(ws, path) {
-  return ioResult(await ws.execute(`ls ${shQuote(path)}`));
-}
-async function runGrep(ws, pattern, path) {
-  const io = await ws.execute(`grep -rn ${shQuote(pattern)} ${shQuote(path)}`);
-  return textResult(ioToStr(io));
-}
-function MirageServer(workspace) {
+function MirageServer(workspace, options = {}) {
+  const operations = new MirageToolOperations(workspace, options);
   return createSdkMcpServer({
     name: "mirage",
     version: VERSION,
@@ -119,20 +28,20 @@ function MirageServer(workspace) {
         "execute_command",
         EXECUTE_DESCRIPTION,
         { command: z.string() },
-        (args) => runExecute(workspace, args.command)
+        (args) => operations.execute(args.command)
       ),
       tool(
         "read",
         READ_DESCRIPTION,
         { path: z.string(), offset: z.number().optional(), limit: z.number().optional() },
-        (args) => runRead(workspace, args.path, args.offset, args.limit),
+        (args) => operations.read(args.path, args.offset, args.limit),
         { annotations: { readOnlyHint: true } }
       ),
       tool(
         "write",
         WRITE_DESCRIPTION,
         { path: z.string(), content: z.string() },
-        (args) => runWrite(workspace, args.path, args.content)
+        (args) => operations.write(args.path, args.content)
       ),
       tool(
         "edit",
@@ -143,16 +52,16 @@ function MirageServer(workspace) {
           new_string: z.string(),
           replace_all: z.boolean().optional()
         },
-        (args) => runEdit(workspace, args.path, args.old_string, args.new_string, args.replace_all)
+        (args) => operations.edit(args.path, args.old_string, args.new_string, args.replace_all)
       ),
-      tool("ls", LS_DESCRIPTION, { path: z.string() }, (args) => runLs(workspace, args.path), {
+      tool("ls", LS_DESCRIPTION, { path: z.string() }, (args) => operations.ls(args.path), {
         annotations: { readOnlyHint: true }
       }),
       tool(
         "grep",
         GREP_DESCRIPTION,
         { pattern: z.string(), path: z.string() },
-        (args) => runGrep(workspace, args.pattern, args.path),
+        (args) => operations.grep(args.pattern, args.path),
         { annotations: { readOnlyHint: true } }
       )
     ]

package/dist/claude-agent-sdk/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/claude-agent-sdk/server.ts","../../src/io-text.ts","../../src/claude-agent-sdk/descriptions.ts","../../src/claude-agent-sdk/options.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 { ExecuteResult, Workspace } from '@struktoai/mirage-core'\nimport { VERSION, gnuDirname } from '@struktoai/mirage-core'\nimport { createSdkMcpServer, tool } from '@anthropic-ai/claude-agent-sdk'\nimport { z } from 'zod'\nimport { decode, ioToStr } from '../io-text.ts'\nimport {\n  EDIT_DESCRIPTION,\n  EXECUTE_DESCRIPTION,\n  GREP_DESCRIPTION,\n  LS_DESCRIPTION,\n  READ_DESCRIPTION,\n  WRITE_DESCRIPTION,\n} from './descriptions.ts'\n\nexport interface ToolResult {\n  [key: string]: unknown\n  content: { type: 'text'; text: string }[]\n  isError?: boolean\n}\n\nfunction textResult(text: string): ToolResult {\n  return { content: [{ type: 'text', text }] }\n}\n\nfunction errorResult(text: string): ToolResult {\n  return { content: [{ type: 'text', text }], isError: true }\n}\n\nfunction ioResult(io: ExecuteResult): ToolResult {\n  const result = textResult(ioToStr(io))\n  if (io.exitCode !== 0) result.isError = true\n  return result\n}\n\nfunction shQuote(value: string): string {\n  return `'${value.replace(/'/g, \"'\\\\''\")}'`\n}\n\nasync function ensureParents(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 ensureParents(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\nexport async function runExecute(ws: Workspace, command: string): Promise<ToolResult> {\n  return ioResult(await ws.execute(command))\n}\n\nexport async function runRead(\n  ws: Workspace,\n  path: string,\n  offset = 0,\n  limit = 2000,\n): Promise<ToolResult> {\n  let data: Uint8Array\n  try {\n    data = await ws.fs.readFile(path)\n  } catch (err) {\n    if (!(await ws.fs.exists(path))) {\n      return errorResult(`Error: file '${path}' not found`)\n    }\n    return errorResult(`Error: ${err instanceof Error ? err.message : String(err)}`)\n  }\n  const text = decode(data)\n  const raw = text.length === 0 ? [] : text.split(/(?<=\\n)/)\n  const lines = raw.length > 0 && raw[raw.length - 1] === '' ? raw.slice(0, -1) : raw\n  const sliced = lines.slice(offset, offset + limit)\n  const numbered = sliced.map((line, i) => `${String(i + offset + 1).padStart(6)}\\t${line}`)\n  return textResult(numbered.join(''))\n}\n\nexport async function runWrite(ws: Workspace, path: string, content: string): Promise<ToolResult> {\n  if (await ws.fs.exists(path)) {\n    return errorResult(`Error: file '${path}' already exists`)\n  }\n  await ensureParents(ws, path)\n  await ws.fs.writeFile(path, content)\n  return textResult(`Written: ${path}`)\n}\n\nexport async function runEdit(\n  ws: Workspace,\n  path: string,\n  oldString: string,\n  newString: string,\n  replaceAll = false,\n): Promise<ToolResult> {\n  let content: string\n  try {\n    content = await ws.fs.readFileText(path)\n  } catch {\n    return errorResult(`Error: file '${path}' not found`)\n  }\n  const count = content.split(oldString).length - 1\n  if (count === 0) {\n    return errorResult(`Error: string not found in file: '${oldString}'`)\n  }\n  if (count > 1 && !replaceAll) {\n    return errorResult(`Error: string appears ${String(count)} times. Pass replace_all=true`)\n  }\n  const newContent = replaceAll\n    ? content.split(oldString).join(newString)\n    : content.replace(oldString, newString)\n  await ws.fs.writeFile(path, newContent)\n  const occurrences = replaceAll ? count : 1\n  return textResult(`Edited: ${path} (${String(occurrences)} occurrence(s))`)\n}\n\nexport async function runLs(ws: Workspace, path: string): Promise<ToolResult> {\n  return ioResult(await ws.execute(`ls ${shQuote(path)}`))\n}\n\nexport async function runGrep(ws: Workspace, pattern: string, path: string): Promise<ToolResult> {\n  const io = await ws.execute(`grep -rn ${shQuote(pattern)} ${shQuote(path)}`)\n  return textResult(ioToStr(io))\n}\n\nexport function MirageServer(workspace: Workspace) {\n  return createSdkMcpServer({\n    name: 'mirage',\n    version: VERSION,\n    alwaysLoad: true,\n    tools: [\n      tool('execute_command', EXECUTE_DESCRIPTION, { command: z.string() }, (args) =>\n        runExecute(workspace, args.command),\n      ),\n      tool(\n        'read',\n        READ_DESCRIPTION,\n        { path: z.string(), offset: z.number().optional(), limit: z.number().optional() },\n        (args) => runRead(workspace, args.path, args.offset, args.limit),\n        { annotations: { readOnlyHint: true } },\n      ),\n      tool('write', WRITE_DESCRIPTION, { path: z.string(), content: z.string() }, (args) =>\n        runWrite(workspace, args.path, args.content),\n      ),\n      tool(\n        'edit',\n        EDIT_DESCRIPTION,\n        {\n          path: z.string(),\n          old_string: z.string(),\n          new_string: z.string(),\n          replace_all: z.boolean().optional(),\n        },\n        (args) => runEdit(workspace, args.path, args.old_string, args.new_string, args.replace_all),\n      ),\n      tool('ls', LS_DESCRIPTION, { path: z.string() }, (args) => runLs(workspace, args.path), {\n        annotations: { readOnlyHint: true },\n      }),\n      tool(\n        'grep',\n        GREP_DESCRIPTION,\n        { pattern: z.string(), path: z.string() },\n        (args) => runGrep(workspace, args.pattern, args.path),\n        { annotations: { readOnlyHint: true } },\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 type { ExecuteResult } from '@struktoai/mirage-core'\n\nexport function decode(value: Uint8Array | null | undefined): string {\n  if (value === null || value === undefined) return ''\n  return new TextDecoder('utf-8').decode(value)\n}\n\nexport function ioToStr(io: ExecuteResult): string {\n  const stdout = io.stdoutText\n  const stderr = io.stderrText\n  if (stderr) return stdout ? `${stdout}\\n${stderr}` : stderr\n  return stdout\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\nexport const EXECUTE_DESCRIPTION =\n  'Run a shell-style command on the Mirage virtual filesystem. ' +\n  'Supports cat, grep, find, head, tail, ls, wc, sort, uniq, tee, pipe, ' +\n  'and any other Unix command on mounted resources (S3, disk, RAM, etc.). ' +\n  'Also supports reading structured files: cat on .parquet/.orc/.csv returns a table.'\n\nexport const READ_DESCRIPTION =\n  'Read the contents of a file on the Mirage virtual filesystem. ' +\n  'Returns line-numbered text. ' +\n  \"Optionally pass 'offset' (default 0) to start at a given line \" +\n  \"and 'limit' (default 2000) to cap the number of lines returned.\"\n\nexport const WRITE_DESCRIPTION =\n  'Write content to a new file on the Mirage virtual filesystem. ' +\n  'Fails if the file already exists; use edit to modify an existing file.'\n\nexport const EDIT_DESCRIPTION =\n  'Replace a string in an existing file on the Mirage virtual filesystem. ' +\n  'Fails if old_string is not found or appears more than once. ' +\n  'Pass replace_all=true (default false) to replace every occurrence.'\n\nexport const LS_DESCRIPTION =\n  'List files and directories at the given path on the Mirage virtual filesystem.'\n\nexport const GREP_DESCRIPTION =\n  'Search for a pattern in files on the Mirage virtual filesystem. ' +\n  'Supports regex. Searches recursively under path.'\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 { Options } from '@anthropic-ai/claude-agent-sdk'\nimport { buildSystemPrompt } from '../prompt.ts'\nimport { MirageServer } from './server.ts'\n\nexport interface BuildOptionsOptions {\n  systemPrompt?: string\n}\n\nexport function buildOptions(workspace: Workspace, opts: BuildOptionsOptions = {}): Options {\n  return {\n    mcpServers: { mirage: MirageServer(workspace) },\n    allowedTools: ['mcp__mirage__*'],\n    systemPrompt: opts.systemPrompt ?? buildSystemPrompt({ workspace }),\n  }\n}\n"],"mappings":";;;;;;AAeA,SAAS,SAAS,kBAAkB;AACpC,SAAS,oBAAoB,YAAY;AACzC,SAAS,SAAS;;;ACDX,SAAS,OAAO,OAA8C;AACnE,MAAI,UAAU,QAAQ,UAAU,OAAW,QAAO;AAClD,SAAO,IAAI,YAAY,OAAO,EAAE,OAAO,KAAK;AAC9C;AAEO,SAAS,QAAQ,IAA2B;AACjD,QAAM,SAAS,GAAG;AAClB,QAAM,SAAS,GAAG;AAClB,MAAI,OAAQ,QAAO,SAAS,GAAG,MAAM;AAAA,EAAK,MAAM,KAAK;AACrD,SAAO;AACT;;;ACZO,IAAM,sBACX;AAKK,IAAM,mBACX;AAKK,IAAM,oBACX;AAGK,IAAM,mBACX;AAIK,IAAM,iBACX;AAEK,IAAM,mBACX;;;AFLF,SAAS,WAAW,MAA0B;AAC5C,SAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAQ,KAAK,CAAC,EAAE;AAC7C;AAEA,SAAS,YAAY,MAA0B;AAC7C,SAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAQ,KAAK,CAAC,GAAG,SAAS,KAAK;AAC5D;AAEA,SAAS,SAAS,IAA+B;AAC/C,QAAM,SAAS,WAAW,QAAQ,EAAE,CAAC;AACrC,MAAI,GAAG,aAAa,EAAG,QAAO,UAAU;AACxC,SAAO;AACT;AAEA,SAAS,QAAQ,OAAuB;AACtC,SAAO,IAAI,MAAM,QAAQ,MAAM,OAAO,CAAC;AACzC;AAEA,eAAe,cAAc,IAAe,MAA6B;AACvE,QAAM,SAAS,WAAW,IAAI;AAC9B,MAAI,WAAW,OAAO,WAAW,MAAM,WAAW,IAAK;AACvD,MAAI,MAAM,GAAG,GAAG,OAAO,MAAM,EAAG;AAChC,QAAM,cAAc,IAAI,MAAM;AAC9B,MAAI;AACF,UAAM,GAAG,GAAG,MAAM,MAAM;AAAA,EAC1B,SAAS,KAAK;AACZ,QAAI,CAAE,MAAM,GAAG,GAAG,OAAO,MAAM,EAAI,OAAM;AAAA,EAC3C;AACF;AAEA,eAAsB,WAAW,IAAe,SAAsC;AACpF,SAAO,SAAS,MAAM,GAAG,QAAQ,OAAO,CAAC;AAC3C;AAEA,eAAsB,QACpB,IACA,MACA,SAAS,GACT,QAAQ,KACa;AACrB,MAAI;AACJ,MAAI;AACF,WAAO,MAAM,GAAG,GAAG,SAAS,IAAI;AAAA,EAClC,SAAS,KAAK;AACZ,QAAI,CAAE,MAAM,GAAG,GAAG,OAAO,IAAI,GAAI;AAC/B,aAAO,YAAY,gBAAgB,IAAI,aAAa;AAAA,IACtD;AACA,WAAO,YAAY,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,CAAC,EAAE;AAAA,EACjF;AACA,QAAM,OAAO,OAAO,IAAI;AACxB,QAAM,MAAM,KAAK,WAAW,IAAI,CAAC,IAAI,KAAK,MAAM,SAAS;AACzD,QAAM,QAAQ,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,MAAM,KAAK,IAAI,MAAM,GAAG,EAAE,IAAI;AAChF,QAAM,SAAS,MAAM,MAAM,QAAQ,SAAS,KAAK;AACjD,QAAM,WAAW,OAAO,IAAI,CAAC,MAAM,MAAM,GAAG,OAAO,IAAI,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC,IAAK,IAAI,EAAE;AACzF,SAAO,WAAW,SAAS,KAAK,EAAE,CAAC;AACrC;AAEA,eAAsB,SAAS,IAAe,MAAc,SAAsC;AAChG,MAAI,MAAM,GAAG,GAAG,OAAO,IAAI,GAAG;AAC5B,WAAO,YAAY,gBAAgB,IAAI,kBAAkB;AAAA,EAC3D;AACA,QAAM,cAAc,IAAI,IAAI;AAC5B,QAAM,GAAG,GAAG,UAAU,MAAM,OAAO;AACnC,SAAO,WAAW,YAAY,IAAI,EAAE;AACtC;AAEA,eAAsB,QACpB,IACA,MACA,WACA,WACA,aAAa,OACQ;AACrB,MAAI;AACJ,MAAI;AACF,cAAU,MAAM,GAAG,GAAG,aAAa,IAAI;AAAA,EACzC,QAAQ;AACN,WAAO,YAAY,gBAAgB,IAAI,aAAa;AAAA,EACtD;AACA,QAAM,QAAQ,QAAQ,MAAM,SAAS,EAAE,SAAS;AAChD,MAAI,UAAU,GAAG;AACf,WAAO,YAAY,qCAAqC,SAAS,GAAG;AAAA,EACtE;AACA,MAAI,QAAQ,KAAK,CAAC,YAAY;AAC5B,WAAO,YAAY,yBAAyB,OAAO,KAAK,CAAC,+BAA+B;AAAA,EAC1F;AACA,QAAM,aAAa,aACf,QAAQ,MAAM,SAAS,EAAE,KAAK,SAAS,IACvC,QAAQ,QAAQ,WAAW,SAAS;AACxC,QAAM,GAAG,GAAG,UAAU,MAAM,UAAU;AACtC,QAAM,cAAc,aAAa,QAAQ;AACzC,SAAO,WAAW,WAAW,IAAI,KAAK,OAAO,WAAW,CAAC,iBAAiB;AAC5E;AAEA,eAAsB,MAAM,IAAe,MAAmC;AAC5E,SAAO,SAAS,MAAM,GAAG,QAAQ,MAAM,QAAQ,IAAI,CAAC,EAAE,CAAC;AACzD;AAEA,eAAsB,QAAQ,IAAe,SAAiB,MAAmC;AAC/F,QAAM,KAAK,MAAM,GAAG,QAAQ,YAAY,QAAQ,OAAO,CAAC,IAAI,QAAQ,IAAI,CAAC,EAAE;AAC3E,SAAO,WAAW,QAAQ,EAAE,CAAC;AAC/B;AAEO,SAAS,aAAa,WAAsB;AACjD,SAAO,mBAAmB;AAAA,IACxB,MAAM;AAAA,IACN,SAAS;AAAA,IACT,YAAY;AAAA,IACZ,OAAO;AAAA,MACL;AAAA,QAAK;AAAA,QAAmB;AAAA,QAAqB,EAAE,SAAS,EAAE,OAAO,EAAE;AAAA,QAAG,CAAC,SACrE,WAAW,WAAW,KAAK,OAAO;AAAA,MACpC;AAAA,MACA;AAAA,QACE;AAAA,QACA;AAAA,QACA,EAAE,MAAM,EAAE,OAAO,GAAG,QAAQ,EAAE,OAAO,EAAE,SAAS,GAAG,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE;AAAA,QAChF,CAAC,SAAS,QAAQ,WAAW,KAAK,MAAM,KAAK,QAAQ,KAAK,KAAK;AAAA,QAC/D,EAAE,aAAa,EAAE,cAAc,KAAK,EAAE;AAAA,MACxC;AAAA,MACA;AAAA,QAAK;AAAA,QAAS;AAAA,QAAmB,EAAE,MAAM,EAAE,OAAO,GAAG,SAAS,EAAE,OAAO,EAAE;AAAA,QAAG,CAAC,SAC3E,SAAS,WAAW,KAAK,MAAM,KAAK,OAAO;AAAA,MAC7C;AAAA,MACA;AAAA,QACE;AAAA,QACA;AAAA,QACA;AAAA,UACE,MAAM,EAAE,OAAO;AAAA,UACf,YAAY,EAAE,OAAO;AAAA,UACrB,YAAY,EAAE,OAAO;AAAA,UACrB,aAAa,EAAE,QAAQ,EAAE,SAAS;AAAA,QACpC;AAAA,QACA,CAAC,SAAS,QAAQ,WAAW,KAAK,MAAM,KAAK,YAAY,KAAK,YAAY,KAAK,WAAW;AAAA,MAC5F;AAAA,MACA,KAAK,MAAM,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,SAAS,MAAM,WAAW,KAAK,IAAI,GAAG;AAAA,QACtF,aAAa,EAAE,cAAc,KAAK;AAAA,MACpC,CAAC;AAAA,MACD;AAAA,QACE;AAAA,QACA;AAAA,QACA,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,EAAE,OAAO,EAAE;AAAA,QACxC,CAAC,SAAS,QAAQ,WAAW,KAAK,SAAS,KAAK,IAAI;AAAA,QACpD,EAAE,aAAa,EAAE,cAAc,KAAK,EAAE;AAAA,MACxC;AAAA,IACF;AAAA,EACF,CAAC;AACH;;;AG5JO,SAAS,aAAa,WAAsB,OAA4B,CAAC,GAAY;AAC1F,SAAO;AAAA,IACL,YAAY,EAAE,QAAQ,aAAa,SAAS,EAAE;AAAA,IAC9C,cAAc,CAAC,gBAAgB;AAAA,IAC/B,cAAc,KAAK,gBAAgB,kBAAkB,EAAE,UAAU,CAAC;AAAA,EACpE;AACF;","names":[]}
+{"version":3,"sources":["../../src/claude-agent-sdk/server.ts","../../src/claude-agent-sdk/options.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 { VERSION } from '@struktoai/mirage-core'\nimport { createSdkMcpServer, tool } from '@anthropic-ai/claude-agent-sdk'\nimport { z } from 'zod'\nimport {\n  MirageToolOperations,\n  type MirageToolOperationsOptions,\n  type ToolResult,\n} from '../tool-operations.ts'\nimport {\n  EDIT_DESCRIPTION,\n  EXECUTE_DESCRIPTION,\n  GREP_DESCRIPTION,\n  LS_DESCRIPTION,\n  READ_DESCRIPTION,\n  WRITE_DESCRIPTION,\n} from './descriptions.ts'\n\nexport async function runExecute(ws: Workspace, command: string): Promise<ToolResult> {\n  return new MirageToolOperations(ws).execute(command)\n}\n\nexport async function runRead(\n  ws: Workspace,\n  path: string,\n  offset = 0,\n  limit = 2000,\n): Promise<ToolResult> {\n  return new MirageToolOperations(ws).read(path, offset, limit)\n}\n\nexport async function runWrite(ws: Workspace, path: string, content: string): Promise<ToolResult> {\n  return new MirageToolOperations(ws).write(path, content)\n}\n\nexport async function runEdit(\n  ws: Workspace,\n  path: string,\n  oldString: string,\n  newString: string,\n  replaceAll = false,\n): Promise<ToolResult> {\n  return new MirageToolOperations(ws).edit(path, oldString, newString, replaceAll)\n}\n\nexport async function runLs(ws: Workspace, path: string): Promise<ToolResult> {\n  return new MirageToolOperations(ws).ls(path)\n}\n\nexport async function runGrep(ws: Workspace, pattern: string, path: string): Promise<ToolResult> {\n  return new MirageToolOperations(ws).grep(pattern, path)\n}\n\nexport function MirageServer(workspace: Workspace, options: MirageToolOperationsOptions = {}) {\n  const operations = new MirageToolOperations(workspace, options)\n  return createSdkMcpServer({\n    name: 'mirage',\n    version: VERSION,\n    alwaysLoad: true,\n    tools: [\n      tool('execute_command', EXECUTE_DESCRIPTION, { command: z.string() }, (args) =>\n        operations.execute(args.command),\n      ),\n      tool(\n        'read',\n        READ_DESCRIPTION,\n        { path: z.string(), offset: z.number().optional(), limit: z.number().optional() },\n        (args) => operations.read(args.path, args.offset, args.limit),\n        { annotations: { readOnlyHint: true } },\n      ),\n      tool('write', WRITE_DESCRIPTION, { path: z.string(), content: z.string() }, (args) =>\n        operations.write(args.path, args.content),\n      ),\n      tool(\n        'edit',\n        EDIT_DESCRIPTION,\n        {\n          path: z.string(),\n          old_string: z.string(),\n          new_string: z.string(),\n          replace_all: z.boolean().optional(),\n        },\n        (args) => operations.edit(args.path, args.old_string, args.new_string, args.replace_all),\n      ),\n      tool('ls', LS_DESCRIPTION, { path: z.string() }, (args) => operations.ls(args.path), {\n        annotations: { readOnlyHint: true },\n      }),\n      tool(\n        'grep',\n        GREP_DESCRIPTION,\n        { pattern: z.string(), path: z.string() },\n        (args) => operations.grep(args.pattern, args.path),\n        { annotations: { readOnlyHint: true } },\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 type { Workspace } from '@struktoai/mirage-core'\nimport type { Options } from '@anthropic-ai/claude-agent-sdk'\nimport { buildSystemPrompt } from '../prompt.ts'\nimport { MirageServer } from './server.ts'\n\nexport interface BuildOptionsOptions {\n  systemPrompt?: string\n}\n\nexport function buildOptions(workspace: Workspace, opts: BuildOptionsOptions = {}): Options {\n  return {\n    mcpServers: { mirage: MirageServer(workspace) },\n    allowedTools: ['mcp__mirage__*'],\n    systemPrompt: opts.systemPrompt ?? buildSystemPrompt({ workspace }),\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAeA,SAAS,eAAe;AACxB,SAAS,oBAAoB,YAAY;AACzC,SAAS,SAAS;AAkDX,SAAS,aAAa,WAAsB,UAAuC,CAAC,GAAG;AAC5F,QAAM,aAAa,IAAI,qBAAqB,WAAW,OAAO;AAC9D,SAAO,mBAAmB;AAAA,IACxB,MAAM;AAAA,IACN,SAAS;AAAA,IACT,YAAY;AAAA,IACZ,OAAO;AAAA,MACL;AAAA,QAAK;AAAA,QAAmB;AAAA,QAAqB,EAAE,SAAS,EAAE,OAAO,EAAE;AAAA,QAAG,CAAC,SACrE,WAAW,QAAQ,KAAK,OAAO;AAAA,MACjC;AAAA,MACA;AAAA,QACE;AAAA,QACA;AAAA,QACA,EAAE,MAAM,EAAE,OAAO,GAAG,QAAQ,EAAE,OAAO,EAAE,SAAS,GAAG,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE;AAAA,QAChF,CAAC,SAAS,WAAW,KAAK,KAAK,MAAM,KAAK,QAAQ,KAAK,KAAK;AAAA,QAC5D,EAAE,aAAa,EAAE,cAAc,KAAK,EAAE;AAAA,MACxC;AAAA,MACA;AAAA,QAAK;AAAA,QAAS;AAAA,QAAmB,EAAE,MAAM,EAAE,OAAO,GAAG,SAAS,EAAE,OAAO,EAAE;AAAA,QAAG,CAAC,SAC3E,WAAW,MAAM,KAAK,MAAM,KAAK,OAAO;AAAA,MAC1C;AAAA,MACA;AAAA,QACE;AAAA,QACA;AAAA,QACA;AAAA,UACE,MAAM,EAAE,OAAO;AAAA,UACf,YAAY,EAAE,OAAO;AAAA,UACrB,YAAY,EAAE,OAAO;AAAA,UACrB,aAAa,EAAE,QAAQ,EAAE,SAAS;AAAA,QACpC;AAAA,QACA,CAAC,SAAS,WAAW,KAAK,KAAK,MAAM,KAAK,YAAY,KAAK,YAAY,KAAK,WAAW;AAAA,MACzF;AAAA,MACA,KAAK,MAAM,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,SAAS,WAAW,GAAG,KAAK,IAAI,GAAG;AAAA,QACnF,aAAa,EAAE,cAAc,KAAK;AAAA,MACpC,CAAC;AAAA,MACD;AAAA,QACE;AAAA,QACA;AAAA,QACA,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,EAAE,OAAO,EAAE;AAAA,QACxC,CAAC,SAAS,WAAW,KAAK,KAAK,SAAS,KAAK,IAAI;AAAA,QACjD,EAAE,aAAa,EAAE,cAAc,KAAK,EAAE;AAAA,MACxC;AAAA,IACF;AAAA,EACF,CAAC;AACH;;;ACvFO,SAAS,aAAa,WAAsB,OAA4B,CAAC,GAAY;AAC1F,SAAO;AAAA,IACL,YAAY,EAAE,QAAQ,aAAa,SAAS,EAAE;AAAA,IAC9C,cAAc,CAAC,gBAAgB;AAAA,IAC/B,cAAc,KAAK,gBAAgB,kBAAkB,EAAE,UAAU,CAAC;AAAA,EACpE;AACF;","names":[]}

package/dist/file-version-Clij-pms.d.ts

@@ -0,0 +1,22 @@
+import { Workspace } from '@struktoai/mirage-core';
+
+declare class StaleMirageFileError extends Error {
+    readonly path: string;
+    constructor(path: string);
+}
+declare class FileVersionTracker {
+    private readonly ws;
+    private readonly enabled;
+    private readonly readVersions;
+    private readonly editVersions;
+    constructor(ws: Workspace, enabled?: boolean);
+    private currentVersion;
+    private assertVersion;
+    private recordWrite;
+    read(path: string): Promise<Buffer>;
+    readForEdit(path: string): Promise<Buffer>;
+    write(path: string, content: string): Promise<void>;
+    writeEdit(path: string, content: string): Promise<void>;
+}
+
+export { FileVersionTracker as F, StaleMirageFileError as S };

package/dist/langchain/index.d.ts

@@ -1,6 +1,6 @@
 import { Workspace } from '@struktoai/mirage-node';
 import { SandboxBackendProtocolV2, ExecuteResponse, LsResult, ReadResult, ReadRawResult, WriteResult, EditResult, GrepResult, GlobResult, FileUploadResponse, FileDownloadResponse } from 'deepagents';
-export { B as BuildSystemPromptOptions, M as MIRAGE_SYSTEM_PROMPT, b as buildSystemPrompt } from '../prompt-Ca4hc1Ul.js';
+export { B as BuildSystemPromptOptions, M as MIRAGE_SYSTEM_PROMPT, b as buildSystemPrompt } from '../prompt-B_6pxgjj.js';
 import '@struktoai/mirage-core';
 
 interface LangchainWorkspaceOptions {

package/dist/langchain/index.js

@@ -1,7 +1,7 @@
 import {
   MIRAGE_SYSTEM_PROMPT,
   buildSystemPrompt
-} from "../chunk-ODKR5YZI.js";
+} from "../chunk-ZPXFVDYT.js";
 
 // src/langchain/convert.ts
 function ioToExecuteResponse(io) {
@@ -106,7 +106,6 @@ function extOf(path) {
   if (dot < 0) return "";
   return path.slice(dot + 1).toLowerCase();
 }
-var MIRAGE_RENDERED_AS_TEXT = /* @__PURE__ */ new Set(["parquet", "h5", "hdf5", "feather"]);
 function mimeFor(path) {
   const ext = extOf(path);
   if (ext === "json" || ext === "jsonl") return "application/json";
@@ -114,7 +113,6 @@ function mimeFor(path) {
   if (ext === "html" || ext === "htm") return "text/html";
   if (ext === "md") return "text/markdown";
   if (TEXT_EXTENSIONS.has(ext)) return "text/plain";
-  if (MIRAGE_RENDERED_AS_TEXT.has(ext)) return "text/plain";
   if (ext === "png") return "image/png";
   if (ext === "jpg" || ext === "jpeg") return "image/jpeg";
   if (ext === "pdf") return "application/pdf";

package/dist/langchain/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/langchain/convert.ts","../../src/langchain/backend.ts","../../src/langchain/messages.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 { ExecuteResponse, FileInfo, GrepMatch } from 'deepagents'\n\ninterface IOLike {\n  stdoutText: string\n  stderrText: string\n  exitCode: number | null\n}\n\nexport function ioToExecuteResponse(io: IOLike): ExecuteResponse {\n  const stdout = io.stdoutText\n  const stderr = io.stderrText\n  let output = stdout\n  if (stderr.length > 0) {\n    output = stdout.length > 0 ? `${stdout}\\n${stderr}` : stderr\n  }\n  return { output, exitCode: io.exitCode, truncated: false }\n}\n\nexport function ioToGrepMatches(io: IOLike): GrepMatch[] {\n  const stdout = io.stdoutText.trim()\n  if (stdout.length === 0) return []\n  const matches: GrepMatch[] = []\n  for (const line of stdout.split('\\n')) {\n    const firstColon = line.indexOf(':')\n    if (firstColon < 0) continue\n    const secondColon = line.indexOf(':', firstColon + 1)\n    if (secondColon < 0) continue\n    const path = line.slice(0, firstColon)\n    const lineNumStr = line.slice(firstColon + 1, secondColon)\n    const text = line.slice(secondColon + 1)\n    const lineNum = Number.parseInt(lineNumStr, 10)\n    if (Number.isNaN(lineNum)) continue\n    matches.push({ path, line: lineNum, text })\n  }\n  return matches\n}\n\nexport function ioToFileInfos(io: IOLike): FileInfo[] {\n  const stdout = io.stdoutText.trim()\n  if (stdout.length === 0) return []\n  const infos: FileInfo[] = []\n  for (const raw of stdout.split('\\n')) {\n    const entry = raw.trim()\n    if (entry.length === 0) continue\n    const isDir = entry.endsWith('/')\n    infos.push({ path: isDir ? entry.slice(0, -1) : entry, is_dir: isDir })\n  }\n  return infos\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-node'\nimport type {\n  EditResult,\n  ExecuteResponse,\n  FileData,\n  FileDownloadResponse,\n  FileInfo,\n  FileUploadResponse,\n  GlobResult,\n  GrepResult,\n  LsResult,\n  ReadRawResult,\n  ReadResult,\n  SandboxBackendProtocolV2 as SandboxBackendProtocol,\n  WriteResult,\n} from 'deepagents'\nimport { ioToExecuteResponse, ioToFileInfos, ioToGrepMatches } from './convert.ts'\nimport { gnuDirname } from '@struktoai/mirage-core'\n\nconst TEXT_EXTENSIONS = 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  'fish',\n  'sql',\n  'log',\n  'env',\n  'ini',\n  'toml',\n  'conf',\n  'cfg',\n])\n\nfunction shellQuote(s: string): string {\n  if (/^[A-Za-z0-9_./-]+$/.test(s)) return s\n  return `'${s.replaceAll(`'`, `'\\\\''`)}'`\n}\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 extOf(path: string): string {\n  const dot = path.lastIndexOf('.')\n  if (dot < 0) return ''\n  return path.slice(dot + 1).toLowerCase()\n}\n\nconst MIRAGE_RENDERED_AS_TEXT = new Set(['parquet', 'h5', 'hdf5', 'feather'])\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_EXTENSIONS.has(ext)) return 'text/plain'\n  if (MIRAGE_RENDERED_AS_TEXT.has(ext)) return 'text/plain'\n  if (ext === 'png') return 'image/png'\n  if (ext === 'jpg' || ext === 'jpeg') return 'image/jpeg'\n  if (ext === 'pdf') return 'application/pdf'\n  return 'application/octet-stream'\n}\n\nfunction isTextMime(mimeType: string): boolean {\n  return mimeType.startsWith('text/') || mimeType === 'application/json'\n}\n\nconst ANTHROPIC_BINARY_MIMES = new Set([\n  'application/pdf',\n  'image/jpeg',\n  'image/png',\n  'image/gif',\n  'image/webp',\n])\n\nexport interface LangchainWorkspaceOptions {\n  sandboxId?: string\n}\n\nexport class LangchainWorkspace implements SandboxBackendProtocol {\n  readonly id: string\n  private readonly ws: Workspace\n\n  constructor(workspace: Workspace, options: LangchainWorkspaceOptions = {}) {\n    this.ws = workspace\n    this.id = options.sandboxId ?? 'mirage'\n  }\n\n  async execute(command: string): Promise<ExecuteResponse> {\n    const io = await this.ws.execute(command)\n    return ioToExecuteResponse(io)\n  }\n\n  async ls(path: string): Promise<LsResult> {\n    let entries: string[]\n    try {\n      entries = await this.ws.fs.readdir(path)\n    } catch (err) {\n      return { error: err instanceof Error ? err.message : String(err) }\n    }\n    const files: FileInfo[] = []\n    for (const entry of entries) {\n      const isDir = await this.ws.fs.isDir(entry)\n      files.push({ path: entry, is_dir: isDir })\n    }\n    return { files }\n  }\n\n  async read(filePath: string, offset = 0, limit = 500): Promise<ReadResult> {\n    const mimeType = mimeFor(filePath)\n    let bytes: Uint8Array\n    try {\n      bytes = await this.ws.fs.readFile(filePath)\n    } catch (err) {\n      return { error: err instanceof Error ? err.message : String(err) }\n    }\n    if (!isTextMime(mimeType)) {\n      if (ANTHROPIC_BINARY_MIMES.has(mimeType)) {\n        return { content: bytes, mimeType }\n      }\n      return {\n        error: `Binary file '${filePath}' (${mimeType}, ${String(bytes.length)} bytes). Use shell commands (head, file, wc, od) via execute() to inspect.`,\n      }\n    }\n    const text = new TextDecoder('utf-8').decode(bytes)\n    const lines = text.split('\\n')\n    if (offset >= lines.length) {\n      return {\n        error: `Line offset ${String(offset)} exceeds file length (${String(lines.length)} lines)`,\n      }\n    }\n    const end = Math.min(offset + limit, lines.length)\n    return { content: lines.slice(offset, end).join('\\n'), mimeType }\n  }\n\n  async readRaw(filePath: string): Promise<ReadRawResult> {\n    let stat: Awaited<ReturnType<Workspace['fs']['stat']>>\n    let bytes: Uint8Array\n    try {\n      stat = await this.ws.fs.stat(filePath)\n      bytes = await this.ws.fs.readFile(filePath)\n    } catch (err) {\n      return { error: err instanceof Error ? err.message : String(err) }\n    }\n    const mimeType = mimeFor(filePath)\n    const content: string | Uint8Array = isTextMime(mimeType)\n      ? new TextDecoder('utf-8').decode(bytes)\n      : bytes\n    const modified = stat.modified ?? new Date().toISOString()\n    const data: FileData = {\n      content,\n      mimeType,\n      created_at: modified,\n      modified_at: modified,\n    }\n    return { data }\n  }\n\n  async write(filePath: string, content: string): Promise<WriteResult> {\n    if (await this.ws.fs.exists(filePath)) {\n      return { error: `Error: file '${filePath}' already exists` }\n    }\n    await ensureParent(this.ws, filePath)\n    await this.ws.fs.writeFile(filePath, content)\n    return { path: filePath }\n  }\n\n  async edit(\n    filePath: string,\n    oldString: string,\n    newString: string,\n    replaceAll = false,\n  ): Promise<EditResult> {\n    let current: string\n    try {\n      current = await this.ws.fs.readFileText(filePath)\n    } catch {\n      return { error: `Error: file '${filePath}' 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) {\n      return {\n        error: `Error: string '${oldString}' appears ${String(count)} times. Use replaceAll=true`,\n      }\n    }\n    const next = replaceAll\n      ? current.split(oldString).join(newString)\n      : current.replace(oldString, newString)\n    await this.ws.fs.writeFile(filePath, next)\n    return { path: filePath, occurrences: replaceAll ? count : 1 }\n  }\n\n  async grep(pattern: string, path?: string | null, glob?: string | null): Promise<GrepResult> {\n    const parts: string[] = ['grep', '-rn']\n    if (glob !== undefined && glob !== null && glob.length > 0) {\n      parts.push('--include', shellQuote(glob))\n    }\n    parts.push(shellQuote(pattern))\n    parts.push(shellQuote(path ?? '/'))\n    const io = await this.ws.execute(parts.join(' '))\n    return { matches: ioToGrepMatches(io) }\n  }\n\n  async glob(pattern: string, path = '/'): Promise<GlobResult> {\n    const name = pattern.includes('/') ? (pattern.split('/').pop() ?? pattern) : pattern\n    const io = await this.ws.execute(`find ${shellQuote(path)} -name ${shellQuote(name)}`)\n    return { files: ioToFileInfos(io) }\n  }\n\n  async uploadFiles(\n    files: readonly (readonly [string, Uint8Array])[],\n  ): Promise<FileUploadResponse[]> {\n    const results: FileUploadResponse[] = []\n    for (const [path, data] of files) {\n      await ensureParent(this.ws, path)\n      await this.ws.fs.writeFile(path, data)\n      results.push({ path, error: null })\n    }\n    return results\n  }\n\n  async downloadFiles(paths: readonly string[]): Promise<FileDownloadResponse[]> {\n    const results: FileDownloadResponse[] = []\n    for (const path of paths) {\n      try {\n        const content = await this.ws.fs.readFile(path)\n        results.push({ path, content, error: null })\n      } catch {\n        results.push({ path, content: null, error: 'file_not_found' })\n      }\n    }\n    return results\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\ninterface MessageLike {\n  content?: unknown\n}\n\ninterface ContentBlock {\n  type?: string\n  text?: string\n}\n\nfunction isTextBlock(value: unknown): value is { type: 'text'; text: string } {\n  if (typeof value !== 'object' || value === null) return false\n  const block = value as ContentBlock\n  return block.type === 'text' && typeof block.text === 'string'\n}\n\nexport function extractText(messages: readonly MessageLike[]): string[] {\n  const texts: string[] = []\n  for (const msg of messages) {\n    if (!('content' in msg) || msg.content === undefined || msg.content === null) continue\n    const content = msg.content\n    if (typeof content === 'string') {\n      if (content.trim().length > 0) texts.push(content)\n      continue\n    }\n    if (Array.isArray(content)) {\n      for (const block of content) {\n        if (isTextBlock(block) && block.text.trim().length > 0) {\n          texts.push(block.text)\n        }\n      }\n    }\n  }\n  return texts\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/langchain/convert.ts","../../src/langchain/backend.ts","../../src/langchain/messages.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 { ExecuteResponse, FileInfo, GrepMatch } from 'deepagents'\n\ninterface IOLike {\n  stdoutText: string\n  stderrText: string\n  exitCode: number | null\n}\n\nexport function ioToExecuteResponse(io: IOLike): ExecuteResponse {\n  const stdout = io.stdoutText\n  const stderr = io.stderrText\n  let output = stdout\n  if (stderr.length > 0) {\n    output = stdout.length > 0 ? `${stdout}\\n${stderr}` : stderr\n  }\n  return { output, exitCode: io.exitCode, truncated: false }\n}\n\nexport function ioToGrepMatches(io: IOLike): GrepMatch[] {\n  const stdout = io.stdoutText.trim()\n  if (stdout.length === 0) return []\n  const matches: GrepMatch[] = []\n  for (const line of stdout.split('\\n')) {\n    const firstColon = line.indexOf(':')\n    if (firstColon < 0) continue\n    const secondColon = line.indexOf(':', firstColon + 1)\n    if (secondColon < 0) continue\n    const path = line.slice(0, firstColon)\n    const lineNumStr = line.slice(firstColon + 1, secondColon)\n    const text = line.slice(secondColon + 1)\n    const lineNum = Number.parseInt(lineNumStr, 10)\n    if (Number.isNaN(lineNum)) continue\n    matches.push({ path, line: lineNum, text })\n  }\n  return matches\n}\n\nexport function ioToFileInfos(io: IOLike): FileInfo[] {\n  const stdout = io.stdoutText.trim()\n  if (stdout.length === 0) return []\n  const infos: FileInfo[] = []\n  for (const raw of stdout.split('\\n')) {\n    const entry = raw.trim()\n    if (entry.length === 0) continue\n    const isDir = entry.endsWith('/')\n    infos.push({ path: isDir ? entry.slice(0, -1) : entry, is_dir: isDir })\n  }\n  return infos\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-node'\nimport type {\n  EditResult,\n  ExecuteResponse,\n  FileData,\n  FileDownloadResponse,\n  FileInfo,\n  FileUploadResponse,\n  GlobResult,\n  GrepResult,\n  LsResult,\n  ReadRawResult,\n  ReadResult,\n  SandboxBackendProtocolV2 as SandboxBackendProtocol,\n  WriteResult,\n} from 'deepagents'\nimport { ioToExecuteResponse, ioToFileInfos, ioToGrepMatches } from './convert.ts'\nimport { gnuDirname } from '@struktoai/mirage-core'\n\nconst TEXT_EXTENSIONS = 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  'fish',\n  'sql',\n  'log',\n  'env',\n  'ini',\n  'toml',\n  'conf',\n  'cfg',\n])\n\nfunction shellQuote(s: string): string {\n  if (/^[A-Za-z0-9_./-]+$/.test(s)) return s\n  return `'${s.replaceAll(`'`, `'\\\\''`)}'`\n}\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 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_EXTENSIONS.has(ext)) return 'text/plain'\n  if (ext === 'png') return 'image/png'\n  if (ext === 'jpg' || ext === 'jpeg') return 'image/jpeg'\n  if (ext === 'pdf') return 'application/pdf'\n  return 'application/octet-stream'\n}\n\nfunction isTextMime(mimeType: string): boolean {\n  return mimeType.startsWith('text/') || mimeType === 'application/json'\n}\n\nconst ANTHROPIC_BINARY_MIMES = new Set([\n  'application/pdf',\n  'image/jpeg',\n  'image/png',\n  'image/gif',\n  'image/webp',\n])\n\nexport interface LangchainWorkspaceOptions {\n  sandboxId?: string\n}\n\nexport class LangchainWorkspace implements SandboxBackendProtocol {\n  readonly id: string\n  private readonly ws: Workspace\n\n  constructor(workspace: Workspace, options: LangchainWorkspaceOptions = {}) {\n    this.ws = workspace\n    this.id = options.sandboxId ?? 'mirage'\n  }\n\n  async execute(command: string): Promise<ExecuteResponse> {\n    const io = await this.ws.execute(command)\n    return ioToExecuteResponse(io)\n  }\n\n  async ls(path: string): Promise<LsResult> {\n    let entries: string[]\n    try {\n      entries = await this.ws.fs.readdir(path)\n    } catch (err) {\n      return { error: err instanceof Error ? err.message : String(err) }\n    }\n    const files: FileInfo[] = []\n    for (const entry of entries) {\n      const isDir = await this.ws.fs.isDir(entry)\n      files.push({ path: entry, is_dir: isDir })\n    }\n    return { files }\n  }\n\n  async read(filePath: string, offset = 0, limit = 500): Promise<ReadResult> {\n    const mimeType = mimeFor(filePath)\n    let bytes: Uint8Array\n    try {\n      bytes = await this.ws.fs.readFile(filePath)\n    } catch (err) {\n      return { error: err instanceof Error ? err.message : String(err) }\n    }\n    if (!isTextMime(mimeType)) {\n      if (ANTHROPIC_BINARY_MIMES.has(mimeType)) {\n        return { content: bytes, mimeType }\n      }\n      return {\n        error: `Binary file '${filePath}' (${mimeType}, ${String(bytes.length)} bytes). Use shell commands (head, file, wc, od) via execute() to inspect.`,\n      }\n    }\n    const text = new TextDecoder('utf-8').decode(bytes)\n    const lines = text.split('\\n')\n    if (offset >= lines.length) {\n      return {\n        error: `Line offset ${String(offset)} exceeds file length (${String(lines.length)} lines)`,\n      }\n    }\n    const end = Math.min(offset + limit, lines.length)\n    return { content: lines.slice(offset, end).join('\\n'), mimeType }\n  }\n\n  async readRaw(filePath: string): Promise<ReadRawResult> {\n    let stat: Awaited<ReturnType<Workspace['fs']['stat']>>\n    let bytes: Uint8Array\n    try {\n      stat = await this.ws.fs.stat(filePath)\n      bytes = await this.ws.fs.readFile(filePath)\n    } catch (err) {\n      return { error: err instanceof Error ? err.message : String(err) }\n    }\n    const mimeType = mimeFor(filePath)\n    const content: string | Uint8Array = isTextMime(mimeType)\n      ? new TextDecoder('utf-8').decode(bytes)\n      : bytes\n    const modified = stat.modified ?? new Date().toISOString()\n    const data: FileData = {\n      content,\n      mimeType,\n      created_at: modified,\n      modified_at: modified,\n    }\n    return { data }\n  }\n\n  async write(filePath: string, content: string): Promise<WriteResult> {\n    if (await this.ws.fs.exists(filePath)) {\n      return { error: `Error: file '${filePath}' already exists` }\n    }\n    await ensureParent(this.ws, filePath)\n    await this.ws.fs.writeFile(filePath, content)\n    return { path: filePath }\n  }\n\n  async edit(\n    filePath: string,\n    oldString: string,\n    newString: string,\n    replaceAll = false,\n  ): Promise<EditResult> {\n    let current: string\n    try {\n      current = await this.ws.fs.readFileText(filePath)\n    } catch {\n      return { error: `Error: file '${filePath}' 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) {\n      return {\n        error: `Error: string '${oldString}' appears ${String(count)} times. Use replaceAll=true`,\n      }\n    }\n    const next = replaceAll\n      ? current.split(oldString).join(newString)\n      : current.replace(oldString, newString)\n    await this.ws.fs.writeFile(filePath, next)\n    return { path: filePath, occurrences: replaceAll ? count : 1 }\n  }\n\n  async grep(pattern: string, path?: string | null, glob?: string | null): Promise<GrepResult> {\n    const parts: string[] = ['grep', '-rn']\n    if (glob !== undefined && glob !== null && glob.length > 0) {\n      parts.push('--include', shellQuote(glob))\n    }\n    parts.push(shellQuote(pattern))\n    parts.push(shellQuote(path ?? '/'))\n    const io = await this.ws.execute(parts.join(' '))\n    return { matches: ioToGrepMatches(io) }\n  }\n\n  async glob(pattern: string, path = '/'): Promise<GlobResult> {\n    const name = pattern.includes('/') ? (pattern.split('/').pop() ?? pattern) : pattern\n    const io = await this.ws.execute(`find ${shellQuote(path)} -name ${shellQuote(name)}`)\n    return { files: ioToFileInfos(io) }\n  }\n\n  async uploadFiles(\n    files: readonly (readonly [string, Uint8Array])[],\n  ): Promise<FileUploadResponse[]> {\n    const results: FileUploadResponse[] = []\n    for (const [path, data] of files) {\n      await ensureParent(this.ws, path)\n      await this.ws.fs.writeFile(path, data)\n      results.push({ path, error: null })\n    }\n    return results\n  }\n\n  async downloadFiles(paths: readonly string[]): Promise<FileDownloadResponse[]> {\n    const results: FileDownloadResponse[] = []\n    for (const path of paths) {\n      try {\n        const content = await this.ws.fs.readFile(path)\n        results.push({ path, content, error: null })\n      } catch {\n        results.push({ path, content: null, error: 'file_not_found' })\n      }\n    }\n    return results\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\ninterface MessageLike {\n  content?: unknown\n}\n\ninterface ContentBlock {\n  type?: string\n  text?: string\n}\n\nfunction isTextBlock(value: unknown): value is { type: 'text'; text: string } {\n  if (typeof value !== 'object' || value === null) return false\n  const block = value as ContentBlock\n  return block.type === 'text' && typeof block.text === 'string'\n}\n\nexport function extractText(messages: readonly MessageLike[]): string[] {\n  const texts: string[] = []\n  for (const msg of messages) {\n    if (!('content' in msg) || msg.content === undefined || msg.content === null) continue\n    const content = msg.content\n    if (typeof content === 'string') {\n      if (content.trim().length > 0) texts.push(content)\n      continue\n    }\n    if (Array.isArray(content)) {\n      for (const block of content) {\n        if (isTextBlock(block) && block.text.trim().length > 0) {\n          texts.push(block.text)\n        }\n      }\n    }\n  }\n  return texts\n}\n"],"mappings":"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","names":[]}

package/dist/mcp/index.d.ts

@@ -0,0 +1,14 @@
+import { Workspace } from '@struktoai/mirage-core';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { M as MirageToolOperationsOptions } from '../tool-descriptions-7CgIovZc.js';
+export { E as EDIT_DESCRIPTION, a as EXECUTE_DESCRIPTION, G as GREP_DESCRIPTION, L as LS_DESCRIPTION, b as MirageToolOperations, R as READ_DESCRIPTION, T as ToolResult, W as WRITE_DESCRIPTION } from '../tool-descriptions-7CgIovZc.js';
+export { F as FileVersionTracker, S as StaleMirageFileError } from '../file-version-Clij-pms.js';
+
+interface MirageMcpServerOptions extends MirageToolOperationsOptions {
+    name?: string;
+    version?: string;
+}
+declare function createMirageMcpServer(workspace: Workspace, options?: MirageMcpServerOptions): McpServer;
+declare function serveMirageMcp(workspace: Workspace, options?: MirageMcpServerOptions): Promise<McpServer>;
+
+export { type MirageMcpServerOptions, MirageToolOperationsOptions, createMirageMcpServer, serveMirageMcp };

package/dist/mcp/index.js

@@ -0,0 +1,100 @@
+import {
+  EDIT_DESCRIPTION,
+  EXECUTE_DESCRIPTION,
+  GREP_DESCRIPTION,
+  LS_DESCRIPTION,
+  MirageToolOperations,
+  READ_DESCRIPTION,
+  WRITE_DESCRIPTION
+} from "../chunk-Y4G25V5V.js";
+import {
+  FileVersionTracker,
+  StaleMirageFileError
+} from "../chunk-XEQB7N3F.js";
+
+// src/mcp/server.ts
+import { VERSION } from "@struktoai/mirage-core";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+function createMirageMcpServer(workspace, options = {}) {
+  const operations = new MirageToolOperations(workspace, options);
+  const server = new McpServer({
+    name: options.name ?? "mirage",
+    version: options.version ?? VERSION
+  });
+  server.registerTool(
+    "execute_command",
+    { description: EXECUTE_DESCRIPTION, inputSchema: { command: z.string() } },
+    (args) => operations.execute(args.command)
+  );
+  server.registerTool(
+    "read",
+    {
+      description: READ_DESCRIPTION,
+      inputSchema: {
+        path: z.string(),
+        offset: z.number().int().min(0).optional(),
+        limit: z.number().int().min(1).optional()
+      },
+      annotations: { readOnlyHint: true }
+    },
+    (args) => operations.read(args.path, args.offset, args.limit)
+  );
+  server.registerTool(
+    "write",
+    { description: WRITE_DESCRIPTION, inputSchema: { path: z.string(), content: z.string() } },
+    (args) => operations.write(args.path, args.content)
+  );
+  server.registerTool(
+    "edit",
+    {
+      description: EDIT_DESCRIPTION,
+      inputSchema: {
+        path: z.string(),
+        old_string: z.string(),
+        new_string: z.string(),
+        replace_all: z.boolean().optional()
+      }
+    },
+    (args) => operations.edit(args.path, args.old_string, args.new_string, args.replace_all)
+  );
+  server.registerTool(
+    "ls",
+    {
+      description: LS_DESCRIPTION,
+      inputSchema: { path: z.string() },
+      annotations: { readOnlyHint: true }
+    },
+    (args) => operations.ls(args.path)
+  );
+  server.registerTool(
+    "grep",
+    {
+      description: GREP_DESCRIPTION,
+      inputSchema: { pattern: z.string(), path: z.string() },
+      annotations: { readOnlyHint: true }
+    },
+    (args) => operations.grep(args.pattern, args.path)
+  );
+  return server;
+}
+async function serveMirageMcp(workspace, options = {}) {
+  const server = createMirageMcpServer(workspace, options);
+  await server.connect(new StdioServerTransport());
+  return server;
+}
+export {
+  EDIT_DESCRIPTION,
+  EXECUTE_DESCRIPTION,
+  FileVersionTracker,
+  GREP_DESCRIPTION,
+  LS_DESCRIPTION,
+  MirageToolOperations,
+  READ_DESCRIPTION,
+  StaleMirageFileError,
+  WRITE_DESCRIPTION,
+  createMirageMcpServer,
+  serveMirageMcp
+};
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/mcp/server.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 { VERSION } from '@struktoai/mirage-core'\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'\nimport { z } from 'zod'\nimport {\n  EDIT_DESCRIPTION,\n  EXECUTE_DESCRIPTION,\n  GREP_DESCRIPTION,\n  LS_DESCRIPTION,\n  READ_DESCRIPTION,\n  WRITE_DESCRIPTION,\n} from '../tool-descriptions.ts'\nimport { MirageToolOperations, type MirageToolOperationsOptions } from '../tool-operations.ts'\n\nexport interface MirageMcpServerOptions extends MirageToolOperationsOptions {\n  name?: string\n  version?: string\n}\n\nexport function createMirageMcpServer(\n  workspace: Workspace,\n  options: MirageMcpServerOptions = {},\n): McpServer {\n  const operations = new MirageToolOperations(workspace, options)\n  const server = new McpServer({\n    name: options.name ?? 'mirage',\n    version: options.version ?? VERSION,\n  })\n\n  server.registerTool(\n    'execute_command',\n    { description: EXECUTE_DESCRIPTION, inputSchema: { command: z.string() } },\n    (args) => operations.execute(args.command),\n  )\n  server.registerTool(\n    'read',\n    {\n      description: READ_DESCRIPTION,\n      inputSchema: {\n        path: z.string(),\n        offset: z.number().int().min(0).optional(),\n        limit: z.number().int().min(1).optional(),\n      },\n      annotations: { readOnlyHint: true },\n    },\n    (args) => operations.read(args.path, args.offset, args.limit),\n  )\n  server.registerTool(\n    'write',\n    { description: WRITE_DESCRIPTION, inputSchema: { path: z.string(), content: z.string() } },\n    (args) => operations.write(args.path, args.content),\n  )\n  server.registerTool(\n    'edit',\n    {\n      description: EDIT_DESCRIPTION,\n      inputSchema: {\n        path: z.string(),\n        old_string: z.string(),\n        new_string: z.string(),\n        replace_all: z.boolean().optional(),\n      },\n    },\n    (args) => operations.edit(args.path, args.old_string, args.new_string, args.replace_all),\n  )\n  server.registerTool(\n    'ls',\n    {\n      description: LS_DESCRIPTION,\n      inputSchema: { path: z.string() },\n      annotations: { readOnlyHint: true },\n    },\n    (args) => operations.ls(args.path),\n  )\n  server.registerTool(\n    'grep',\n    {\n      description: GREP_DESCRIPTION,\n      inputSchema: { pattern: z.string(), path: z.string() },\n      annotations: { readOnlyHint: true },\n    },\n    (args) => operations.grep(args.pattern, args.path),\n  )\n\n  return server\n}\n\nexport async function serveMirageMcp(\n  workspace: Workspace,\n  options: MirageMcpServerOptions = {},\n): Promise<McpServer> {\n  const server = createMirageMcpServer(workspace, options)\n  await server.connect(new StdioServerTransport())\n  return server\n}\n"],"mappings":";;;;;;;;;;;;;;;AAeA,SAAS,eAAe;AACxB,SAAS,iBAAiB;AAC1B,SAAS,4BAA4B;AACrC,SAAS,SAAS;AAgBX,SAAS,sBACd,WACA,UAAkC,CAAC,GACxB;AACX,QAAM,aAAa,IAAI,qBAAqB,WAAW,OAAO;AAC9D,QAAM,SAAS,IAAI,UAAU;AAAA,IAC3B,MAAM,QAAQ,QAAQ;AAAA,IACtB,SAAS,QAAQ,WAAW;AAAA,EAC9B,CAAC;AAED,SAAO;AAAA,IACL;AAAA,IACA,EAAE,aAAa,qBAAqB,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE;AAAA,IACzE,CAAC,SAAS,WAAW,QAAQ,KAAK,OAAO;AAAA,EAC3C;AACA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,MACE,aAAa;AAAA,MACb,aAAa;AAAA,QACX,MAAM,EAAE,OAAO;AAAA,QACf,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,SAAS;AAAA,QACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,SAAS;AAAA,MAC1C;AAAA,MACA,aAAa,EAAE,cAAc,KAAK;AAAA,IACpC;AAAA,IACA,CAAC,SAAS,WAAW,KAAK,KAAK,MAAM,KAAK,QAAQ,KAAK,KAAK;AAAA,EAC9D;AACA,SAAO;AAAA,IACL;AAAA,IACA,EAAE,aAAa,mBAAmB,aAAa,EAAE,MAAM,EAAE,OAAO,GAAG,SAAS,EAAE,OAAO,EAAE,EAAE;AAAA,IACzF,CAAC,SAAS,WAAW,MAAM,KAAK,MAAM,KAAK,OAAO;AAAA,EACpD;AACA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,MACE,aAAa;AAAA,MACb,aAAa;AAAA,QACX,MAAM,EAAE,OAAO;AAAA,QACf,YAAY,EAAE,OAAO;AAAA,QACrB,YAAY,EAAE,OAAO;AAAA,QACrB,aAAa,EAAE,QAAQ,EAAE,SAAS;AAAA,MACpC;AAAA,IACF;AAAA,IACA,CAAC,SAAS,WAAW,KAAK,KAAK,MAAM,KAAK,YAAY,KAAK,YAAY,KAAK,WAAW;AAAA,EACzF;AACA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,MACE,aAAa;AAAA,MACb,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE;AAAA,MAChC,aAAa,EAAE,cAAc,KAAK;AAAA,IACpC;AAAA,IACA,CAAC,SAAS,WAAW,GAAG,KAAK,IAAI;AAAA,EACnC;AACA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,MACE,aAAa;AAAA,MACb,aAAa,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,EAAE,OAAO,EAAE;AAAA,MACrD,aAAa,EAAE,cAAc,KAAK;AAAA,IACpC;AAAA,IACA,CAAC,SAAS,WAAW,KAAK,KAAK,SAAS,KAAK,IAAI;AAAA,EACnD;AAEA,SAAO;AACT;AAEA,eAAsB,eACpB,WACA,UAAkC,CAAC,GACf;AACpB,QAAM,SAAS,sBAAsB,WAAW,OAAO;AACvD,QAAM,OAAO,QAAQ,IAAI,qBAAqB,CAAC;AAC/C,SAAO;AACT;","names":[]}

package/dist/openai/index.d.ts

@@ -1,6 +1,8 @@
 import { Workspace } from '@struktoai/mirage-core';
-import { Editor, ApplyPatchOperation, ApplyPatchResult, Shell, ShellAction, ShellResult } from '@openai/agents';
-export { B as BuildSystemPromptOptions, M as MIRAGE_SYSTEM_PROMPT, b as buildSystemPrompt } from '../prompt-Ca4hc1Ul.js';
+import * as _openai_agents from '@openai/agents';
+import { Editor, ApplyPatchOperation, ApplyPatchResult, ToolOutputText, ToolOutputImage, ToolOutputFileContent, Shell, ShellAction, ShellResult } from '@openai/agents';
+import { z } from 'zod';
+export { B as BuildSystemPromptOptions, M as MIRAGE_SYSTEM_PROMPT, b as buildSystemPrompt } from '../prompt-B_6pxgjj.js';
 
 declare class MirageEditor implements Editor {
     private readonly ws;
@@ -16,10 +18,19 @@ declare class MirageEditor implements Editor {
     }>): Promise<ApplyPatchResult>;
 }
 
+declare function mirageExecuteTool(ws: Workspace): _openai_agents.FunctionTool<unknown, z.ZodObject<{
+    command: z.ZodString;
+}, z.core.$strip>, string>;
+
+type MirageReadFileOutput = ToolOutputText | ToolOutputImage | ToolOutputFileContent;
+declare function mirageReadFileTool(ws: Workspace): _openai_agents.FunctionTool<unknown, z.ZodObject<{
+    path: z.ZodString;
+}, z.core.$strip>, string>;
+
 declare class MirageShell implements Shell {
     private readonly ws;
     constructor(ws: Workspace);
     run(action: ShellAction): Promise<ShellResult>;
 }
 
-export { MirageEditor, MirageShell };
+export { MirageEditor, type MirageReadFileOutput, MirageShell, mirageExecuteTool, mirageReadFileTool };