@craftsamo/whatsapp-tools 0.1.0 → 0.1.2

package/dist/mcp.js

@@ -2984,7 +2984,7 @@ var require_compile = __commonJS({
       const schOrFunc = root.refs[ref];
       if (schOrFunc)
         return schOrFunc;
-      let _sch = resolve7.call(this, root, ref);
+      let _sch = resolve5.call(this, root, ref);
       if (_sch === void 0) {
         const schema = (_a3 = root.localRefs) === null || _a3 === void 0 ? void 0 : _a3[ref];
         const { schemaId } = this.opts;
@@ -3011,7 +3011,7 @@ var require_compile = __commonJS({
     function sameSchemaEnv(s1, s2) {
       return s1.schema === s2.schema && s1.root === s2.root && s1.baseId === s2.baseId;
     }
-    function resolve7(root, ref) {
+    function resolve5(root, ref) {
       let sch;
       while (typeof (sch = this.refs[ref]) == "string")
         ref = sch;
@@ -3875,7 +3875,7 @@ var require_fast_uri = __commonJS({
       }
       return uri;
     }
-    function resolve7(baseURI, relativeURI, options) {
+    function resolve5(baseURI, relativeURI, options) {
       const schemelessOptions = options ? Object.assign({ scheme: "null" }, options) : { scheme: "null" };
       const {
         parsed: baseParsed,
@@ -4266,7 +4266,7 @@ var require_fast_uri = __commonJS({
     var fastUri = {
       SCHEMES,
       normalize,
-      resolve: resolve7,
+      resolve: resolve5,
       resolveComponent,
       equal,
       serialize,
@@ -12325,7 +12325,7 @@ var recursive = /* @__PURE__ */ new WeakMap();
 var NONE = 0;
 var ASSUMED = 1;
 var PROVEN = 2;
-function isRecursive(inst, stack, resolve7) {
+function isRecursive(inst, stack, resolve5) {
   const cached2 = recursive.get(inst);
   if (cached2 !== void 0)
     return cached2 ? PROVEN : NONE;
@@ -12335,7 +12335,7 @@ function isRecursive(inst, stack, resolve7) {
   let result = NONE;
   const check2 = (child) => {
     if (result !== PROVEN && child?._zod) {
-      const answer = isRecursive(child, stack, resolve7);
+      const answer = isRecursive(child, stack, resolve5);
       if (answer > result)
         result = answer;
     }
@@ -12346,7 +12346,7 @@ function isRecursive(inst, stack, resolve7) {
       const desc = Object.getOwnPropertyDescriptor(sh, key);
       if (spread && !desc.enumerable)
         continue;
-      const child = desc.get ? ASSUMED : desc.value?._zod ? isRecursive(desc.value, stack, resolve7) : NONE;
+      const child = desc.get ? ASSUMED : desc.value?._zod ? isRecursive(desc.value, stack, resolve5) : NONE;
       if (child > answer)
         answer = child;
     }
@@ -12410,7 +12410,7 @@ function isRecursive(inst, stack, resolve7) {
       break;
     // `$ZodLazy` caches its inner on the def, so a resolved edge is followed exactly
     case "lazy": {
-      const inner = def._cachedInner ?? (resolve7 ? inst._zod.innerType : void 0);
+      const inner = def._cachedInner ?? (resolve5 ? inst._zod.innerType : void 0);
       merge2(inner ? isRecursive(inner, stack, false) : ASSUMED);
       break;
     }
@@ -28587,12 +28587,12 @@ var StdioServerTransport = class {
     this.onclose?.();
   }
   send(message) {
-    return new Promise((resolve7) => {
+    return new Promise((resolve5) => {
       const json2 = serializeMessage(message);
       if (this._stdout.write(json2)) {
-        resolve7();
+        resolve5();
       } else {
-        this._stdout.once("drain", resolve7);
+        this._stdout.once("drain", resolve5);
       }
     });
   }
@@ -28639,7 +28639,7 @@ function abortError(signal) {
 }
 function exec(argv, options) {
   const { signal } = options;
-  return new Promise((resolve7, reject) => {
+  return new Promise((resolve5, reject) => {
     if (signal?.aborted) {
       reject(abortError(signal));
       return;
@@ -28698,7 +28698,7 @@ function exec(argv, options) {
     }
     const finish = () => settle2(() => {
       const { code, killedBy } = exitedWith ?? { code: null, killedBy: null };
-      resolve7({
+      resolve5({
         code: code ?? -1,
         stdout,
         stderr,
@@ -28882,6 +28882,10 @@ function packageRoot(bundleUrl) {
   return dirname(dirname(fileURLToPath(bundleUrl)));
 }
 
+// src/entry/settings.ts
+import { homedir as homedir2 } from "node:os";
+import { isAbsolute as isAbsolute3, join, resolve as resolvePath, sep as sep2 } from "node:path";
+
 // src/project.ts
 var PROJECT = {
   /** The plugin, MCP server and program name. */
@@ -28896,70 +28900,53 @@ var PROJECT = {
   toolsets: ["account", "chats", "contacts", "history", "files", "sends", "actions"],
   /** The toolsets on when a setting names none. */
   defaultToolsets: ["account", "chats", "contacts", "history", "sends"],
+  /** The package's own settings, which the tools themselves read: each snake_case name and its type, with bounds when it needs them. */
+  options: {
+    state_dir: "path",
+    download_dir: "path",
+    send_dirs: "paths"
+  },
   /** The environment variables the tools read besides the settings, which Codex forwards to the server after them. */
   toolVariables: []
 };
 
 // src/entry/directory.ts
 import { homedir } from "node:os";
-import { isAbsolute as isAbsolute2, join, resolve, sep as sep2 } from "node:path";
+import { isAbsolute as isAbsolute2, resolve } from "node:path";
+var DOWNLOADS_DIR = "Downloads";
 function homeDir(env7) {
   const envHome = env7.HOME;
   if (envHome && isAbsolute2(envHome)) return envHome;
   return homedir();
 }
-function expandTilde(text2, home) {
-  if (text2 === "~") return home;
-  if (text2.startsWith("~/") || text2.startsWith(`~${sep2}`)) {
-    return join(home, text2.slice(2));
-  }
-  return text2;
+function pathOf(value) {
+  return typeof value === "string" ? value : void 0;
 }
-function resolveGivenDirectory(given, home) {
-  const text2 = given.text.trim();
-  const expanded = expandTilde(text2, home);
-  if (!text2 || !isAbsolute2(expanded)) {
-    throw new ToolError("invalid_argument", `${given.source} must be an absolute path.`);
-  }
-  return resolve(expanded);
+function pathsOf(value) {
+  return typeof value === "object" ? value : [];
+}
+function directorySettings(options, env7, profile) {
+  const home = homeDir(env7);
+  const xdg = env7.XDG_STATE_HOME;
+  const stateHome = xdg && isAbsolute2(xdg) ? xdg : resolve(home, ".local", "state");
+  return {
+    state_dir: pathOf(options.state_dir) ?? resolve(stateHome, profile.name),
+    download_dir: pathOf(options.download_dir) ?? resolve(home, DOWNLOADS_DIR, profile.name),
+    send_dirs: [...new Set(pathsOf(options.send_dirs))]
+  };
 }
 function toolDirectories(settings) {
   return { stateDir: settings.state_dir, downloadDir: settings.download_dir, sendDirs: settings.send_dirs };
 }
 
-// src/entry/download-dir.ts
-import { resolve as resolve2 } from "node:path";
-var DOWNLOADS_DIR = "Downloads";
-function resolveDownloadDir(given, env7, profile) {
-  const home = homeDir(env7);
-  return given !== void 0 ? resolveGivenDirectory(given, home) : resolve2(home, DOWNLOADS_DIR, profile.name);
-}
-
 // src/entry/profile.ts
 var PROJECT_PROFILE = {
   name: PROJECT.name,
   envPrefix: PROJECT.envPrefix,
-  toolsets: { names: PROJECT.toolsets, defaults: PROJECT.defaultToolsets }
+  toolsets: { names: PROJECT.toolsets, defaults: PROJECT.defaultToolsets },
+  options: PROJECT.options
 };
 
-// src/entry/send-dirs.ts
-function resolveSendDirs(given, env7) {
-  const home = homeDir(env7);
-  return [...new Set(given.map((directory) => resolveGivenDirectory(directory, home)))];
-}
-
-// src/entry/state-dir.ts
-import { isAbsolute as isAbsolute3, resolve as resolve3 } from "node:path";
-function resolveStateDir(given, env7, profile) {
-  const home = homeDir(env7);
-  if (given !== void 0) return resolveGivenDirectory(given, home);
-  const xdg = env7.XDG_STATE_HOME;
-  if (xdg && isAbsolute3(xdg)) {
-    return resolve3(xdg, profile.name);
-  }
-  return resolve3(home, ".local", "state", profile.name);
-}
-
 // src/entry/settings.ts
 var CONFIRM_MODES = ["harness", "elicitation"];
 var ALL_TOOLSETS = "all";
@@ -28970,17 +28957,28 @@ var OPTIONS = {
   read_only: { flag: "--read-only", envSuffix: "READ_ONLY", boolean: true },
   tools: { flag: "--tools", envSuffix: "TOOLS" },
   exclude_tools: { flag: "--exclude-tools", envSuffix: "EXCLUDE_TOOLS" },
-  confirm: { flag: "--confirm", envSuffix: "CONFIRM" },
-  state_dir: { flag: "--state-dir", envSuffix: "STATE_DIR" },
-  download_dir: { flag: "--download-dir", envSuffix: "DOWNLOAD_DIR" },
-  send_dirs: { flag: "--send-dirs", envSuffix: "SEND_DIRS" }
+  confirm: { flag: "--confirm", envSuffix: "CONFIRM" }
 };
+function profileOptions(profile) {
+  return profile.options ?? {};
+}
+function settingOptions(profile) {
+  const toolOptions = Object.entries(profileOptions(profile)).map(([name, spec]) => [
+    name,
+    {
+      flag: `--${name.replace(/_/g, "-")}`,
+      envSuffix: name.toUpperCase(),
+      ...optionType(spec) === "boolean" && { boolean: true }
+    }
+  ]);
+  return { ...OPTIONS, ...Object.fromEntries(toolOptions) };
+}
 function envName(name, profile) {
-  return `${profile.envPrefix}_${OPTIONS[name].envSuffix}`;
+  return `${profile.envPrefix}_${settingOptions(profile)[name].envSuffix}`;
 }
-function readFlags(argv) {
+function readFlags(argv, profile) {
   const byFlag = new Map(
-    Object.keys(OPTIONS).map((name) => [OPTIONS[name].flag, { name, ...OPTIONS[name] }])
+    Object.entries(settingOptions(profile)).map(([name, option]) => [option.flag, { name, ...option }])
   );
   const given = {};
   for (let i = 0; i < argv.length; i++) {
@@ -29005,9 +29003,6 @@ function readFlags(argv) {
 function splitList(value) {
   return value.split(",").map((item) => item.trim()).filter((item) => item !== "");
 }
-function listedDirectories(given) {
-  return given === void 0 ? [] : splitList(given.text).map((text2) => ({ text: text2, source: given.source }));
-}
 function checkToolsets(names, source, toolsets) {
   if (names.includes(ALL_TOOLSETS)) return ALL_TOOLSETS;
   const unknown2 = names.find((name) => !toolsets.names.includes(name));
@@ -29036,20 +29031,99 @@ function parseConfirm(value, source) {
   }
   return mode;
 }
+function parseNumber(value, source) {
+  const trimmed = value.trim();
+  const parsed = trimmed === "" ? Number.NaN : Number(trimmed);
+  if (!Number.isFinite(parsed)) {
+    throw new ToolError("invalid_argument", `Unknown number "${value}" in ${source}; use a finite number.`);
+  }
+  return parsed;
+}
+function absolutePath(text2, source, env7) {
+  const home = env7.HOME !== void 0 && isAbsolute3(env7.HOME) ? env7.HOME : homedir2();
+  const expanded = text2 === "~" || text2.startsWith("~/") || text2.startsWith(`~${sep2}`) ? join(home, text2.slice(1)) : text2;
+  if (!isAbsolute3(expanded)) throw new ToolError("invalid_argument", `${source} must be an absolute path.`);
+  return resolvePath(expanded);
+}
+function absolutePaths(items, source, env7) {
+  return items.length > 0 ? items.map((item) => absolutePath(item, source, env7)) : void 0;
+}
 function envText(name, env7, profile) {
   const variable = envName(name, profile);
   const text2 = env7[variable];
   return text2 === void 0 || text2.trim() === "" ? void 0 : { text: text2, source: variable };
 }
+function optionType(spec) {
+  return typeof spec === "string" ? spec : spec.type;
+}
+function itemCount(count) {
+  return count === 1 ? "1 item" : `${count} items`;
+}
+function numberBoundsError({ integer: integer2, min, max }, source) {
+  const range = min !== void 0 && max !== void 0 ? ` from ${min} to ${max}` : min !== void 0 ? ` of at least ${min}` : max !== void 0 ? ` of at most ${max}` : "";
+  return new ToolError("invalid_argument", `${source} must be ${integer2 ? "a whole number" : "a number"}${range}.`);
+}
+function countBoundsError({ min, max }, source) {
+  const range = min !== void 0 && max !== void 0 ? `from ${min} to ${max} items` : min !== void 0 ? `at least ${itemCount(min)}` : `at most ${itemCount(max)}`;
+  return new ToolError("invalid_argument", `${source} must list ${range}.`);
+}
+function withinBounds(spec, value, source) {
+  if (value === void 0 || typeof spec === "string") return value;
+  const bounds = spec;
+  const { integer: integer2, min, max } = bounds;
+  if (typeof value === "number") {
+    if (integer2 && !Number.isInteger(value) || min !== void 0 && value < min || max !== void 0 && value > max) {
+      throw numberBoundsError(bounds, source);
+    }
+  } else if (typeof value === "object" && (min !== void 0 && value.length < min || max !== void 0 && value.length > max)) {
+    throw countBoundsError(bounds, source);
+  }
+  return value;
+}
+function parseOptionText(spec, given, env7) {
+  return withinBounds(spec, parseTypedText(optionType(spec), given, env7), given.source);
+}
+function parseTypedText(kind, given, env7) {
+  switch (kind) {
+    case "text":
+      return nonBlank(given.text);
+    case "boolean":
+      return parseBoolean(given.text, given.source);
+    case "number":
+      return parseNumber(given.text, given.source);
+    case "list": {
+      const items = splitList(given.text);
+      return items.length > 0 ? items : void 0;
+    }
+    case "path": {
+      const text2 = nonBlank(given.text);
+      return text2 === void 0 ? void 0 : absolutePath(text2, given.source, env7);
+    }
+    case "paths":
+      return absolutePaths(splitList(given.text), given.source, env7);
+  }
+}
+function optionsFrom(flags, env7, profile) {
+  const options = {};
+  for (const [name, spec] of Object.entries(profileOptions(profile))) {
+    if (flags[name] !== void 0) {
+      const parsed = parseOptionText(spec, { text: flags[name], source: settingOptions(profile)[name].flag }, env7);
+      if (parsed !== void 0) options[name] = parsed;
+      continue;
+    }
+    const fromEnv = envText(name, env7, profile);
+    if (fromEnv !== void 0) {
+      const parsed = parseOptionText(spec, fromEnv, env7);
+      if (parsed !== void 0) options[name] = parsed;
+    }
+  }
+  return options;
+}
 function parseSettings(argv, env7, profile = PROJECT_PROFILE) {
-  const flags = readFlags(argv);
+  const flags = readFlags(argv, profile);
   const value = (name) => flags[name] !== void 0 ? { text: flags[name], source: OPTIONS[name].flag } : envText(name, env7, profile);
-  const settings = {
-    confirm: "harness",
-    state_dir: resolveStateDir(value("state_dir"), env7, profile),
-    download_dir: resolveDownloadDir(value("download_dir"), env7, profile),
-    send_dirs: resolveSendDirs(listedDirectories(value("send_dirs")), env7)
-  };
+  const options = optionsFrom(flags, env7, profile);
+  const settings = { confirm: "harness", ...directorySettings(options, env7, profile), options };
   const toolsets = value("toolsets");
   if (toolsets) settings.toolsets = checkToolsets(splitList(toolsets.text), toolsets.source, profile.toolsets);
   const readOnly = value("read_only");
@@ -29062,17 +29136,10 @@ function parseSettings(argv, env7, profile = PROJECT_PROFILE) {
   if (confirm) settings.confirm = parseConfirm(confirm.text.trim(), confirm.source);
   return settings;
 }
-var TOOL_OPTION_NAMES = [
-  "toolsets",
-  "read_only",
-  "tools",
-  "exclude_tools",
-  "state_dir",
-  "download_dir",
-  "send_dirs"
-];
-var LANGUAGE_OPTION = "language";
-var PLUGIN_OPTION_NAMES = [...TOOL_OPTION_NAMES, LANGUAGE_OPTION];
+function nonBlank(text2) {
+  const trimmed = text2?.trim();
+  return trimmed === "" ? void 0 : trimmed;
+}
 
 // src/core/account/read.ts
 import { env as env2 } from "node:process";
@@ -30815,7 +30882,7 @@ var deleteResult = external_exports.object({
 var deleteAnswer = deleteResult.extend({ service_running: external_exports.boolean() });
 
 // src/core/whatsapp/file-send.ts
-import { isAbsolute as isAbsolute5, resolve as resolve4 } from "node:path";
+import { isAbsolute as isAbsolute5, resolve as resolve2 } from "node:path";
 var FILE_SEND_OP = "file_send";
 var SEND_AS = ["image", "video", "audio", "document"];
 var FILE_CAPTION_MAX_CHARACTERS = 1024;
@@ -30954,7 +31021,7 @@ function callService(paths, op, args, { mode, signal, timeoutMs: requestedMs = D
   if (signal?.aborted) return Promise.reject(abortError(signal));
   const timeoutMs = Number.isNaN(requestedMs) ? DEFAULT_TIMEOUT_MS2 : Math.min(Math.max(Math.ceil(requestedMs), 1), MAX_DEADLINE_MS);
   const request = encodeLine({ op, args, deadline_ms: timeoutMs });
-  return new Promise((resolve7, reject) => {
+  return new Promise((resolve5, reject) => {
     const socket = createConnection(paths.socket);
     socket.setEncoding("utf8");
     let sent = false;
@@ -30999,7 +31066,7 @@ function callService(paths, op, args, { mode, signal, timeoutMs: requestedMs = D
       if (end === -1) return;
       const response = parseResponse(received.slice(0, end));
       if (!response) return unknownOutcome2("The sync service's answer could not be read");
-      if (response.ok) return finish(() => resolve7(response.data));
+      if (response.ok) return finish(() => resolve5(response.data));
       fail(new ToolError(response.error.code, response.error.message));
     });
     socket.on("error", (error62) => {
@@ -32421,7 +32488,7 @@ function parseOctal(field) {
   }
   return digits > 0 ? value : void 0;
 }
-function parseNumber(field) {
+function parseNumber2(field) {
   const first = field[0];
   if (first === void 0 || (first & BASE256_FLAG) === 0) return parseOctal(field);
   if (first === BASE256_NEGATIVE) return void 0;
@@ -32460,7 +32527,7 @@ function parseHeader(block) {
     path[prefix.length] = "/".charCodeAt(0);
     path.set(name, prefix.length + 1);
   }
-  return { path, size: parseNumber(block.subarray(SIZE_START, SIZE_END)), type: block[TYPE_OFFSET] };
+  return { path, size: parseNumber2(block.subarray(SIZE_START, SIZE_END)), type: block[TYPE_OFFSET] };
 }
 function parseDecimal(text2) {
   if (!/^[0-9]{1,15}$/.test(text2)) return void 0;
@@ -34086,7 +34153,7 @@ var whatsappFileSave = createFileSave();
 
 // src/core/file/send/tool.ts
 import { realpath as realpath5 } from "node:fs/promises";
-import { resolve as resolve6 } from "node:path";
+import { resolve as resolve4 } from "node:path";
 
 // src/core/outgoing/limits.ts
 var MAX_FILES = 10;
@@ -34317,7 +34384,7 @@ function kindOf(name, head, { asDocument = false } = {}) {
 }
 
 // src/core/file/send/resolve-files.ts
-import { homedir as homedir2 } from "node:os";
+import { homedir as homedir3 } from "node:os";
 
 // src/core/outgoing/roots.ts
 import { realpath as realpath3 } from "node:fs/promises";
@@ -34355,7 +34422,7 @@ async function allowedRoots({ cwd, sendDirs, home, forbidden }) {
 
 // src/core/outgoing/resolve.ts
 import { lstat as lstat5, realpath as realpath4 } from "node:fs/promises";
-import { basename as basename2, resolve as resolve5, sep as sep4 } from "node:path";
+import { basename as basename2, resolve as resolve3, sep as sep4 } from "node:path";
 
 // src/core/outgoing/deny-lists.ts
 import { sep as sep3 } from "node:path";
@@ -34441,7 +34508,7 @@ async function realPathOf(path, shown) {
 }
 async function resolveOutgoing(path, { cwd, roots, forbidden, home }) {
   const shown = JSON.stringify(path);
-  const real = await realPathOf(resolve5(cwd, path), shown);
+  const real = await realPathOf(resolve3(cwd, path), shown);
   const stats = await lstat5(real, { bigint: true });
   if (!stats.isFile()) throw new ToolError("invalid_argument", `${shown} is not a regular file.`);
   if (stats.nlink > 1n) throw hardLinked(shown);
@@ -34472,7 +34539,7 @@ async function resolveOutgoing(path, { cwd, roots, forbidden, home }) {
 // src/core/file/send/resolve-files.ts
 async function resolveFiles(files, ctx) {
   const forbidden = [ctx.stateDir, ctx.ownDir].filter((directory) => directory !== void 0);
-  const home = homedir2();
+  const home = homedir3();
   const roots = await allowedRoots({ cwd: ctx.cwd, sendDirs: ctx.sendDirs ?? [], home, forbidden });
   const seen = /* @__PURE__ */ new Set();
   const resolvedFiles = [];
@@ -34953,7 +35020,7 @@ var CAPTION_RULES = {
 };
 var CAPTION_ON_AUDIO = "A caption on an audio file is dropped by WhatsApp without a word, so it is refused. Send the audio without text, send it as a document with as_document, or put the text in a message of its own with whatsapp_message_send if the user wants that. Nothing was sent.";
 async function fileTarget(path, cwd) {
-  const absolute = resolve6(cwd, path);
+  const absolute = resolve4(cwd, path);
   return realpath5(absolute).catch(() => absolute);
 }
 async function sendTargets(args, ctx) {
@@ -36367,7 +36434,7 @@ var Protocol = class {
           return;
         }
         const pollInterval = task2.pollInterval ?? this._options?.defaultTaskPollInterval ?? 1e3;
-        await new Promise((resolve7) => setTimeout(resolve7, pollInterval));
+        await new Promise((resolve5) => setTimeout(resolve5, pollInterval));
         options?.signal?.throwIfAborted();
       }
     } catch (error62) {
@@ -36384,7 +36451,7 @@ var Protocol = class {
    */
   request(request, resultSchema, options) {
     const { relatedRequestId, resumptionToken, onresumptiontoken, task, relatedTask } = options ?? {};
-    return new Promise((resolve7, reject) => {
+    return new Promise((resolve5, reject) => {
       const earlyReject = (error62) => {
         reject(error62);
       };
@@ -36462,7 +36529,7 @@ var Protocol = class {
           if (!parseResult.success) {
             reject(parseResult.error);
           } else {
-            resolve7(parseResult.data);
+            resolve5(parseResult.data);
           }
         } catch (error62) {
           reject(error62);
@@ -36724,12 +36791,12 @@ var Protocol = class {
       }
     } catch {
     }
-    return new Promise((resolve7, reject) => {
+    return new Promise((resolve5, reject) => {
       if (signal.aborted) {
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
         return;
       }
-      const timeoutId = setTimeout(resolve7, interval);
+      const timeoutId = setTimeout(resolve5, interval);
       signal.addEventListener("abort", () => {
         clearTimeout(timeoutId);
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
@@ -37545,23 +37612,52 @@ function elicitationConfirm(server, signal) {
 
 // src/mcp/roots.ts
 import { statSync } from "node:fs";
+import { isAbsolute as isAbsolute7 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 var FILE_URI_PROTOCOL = "file:";
+var SANDBOX_STATE_META = "codex/sandbox-state-meta";
+var TURN_METADATA = "x-codex-turn-metadata";
+function existingDirectory(dir) {
+  try {
+    return statSync(dir, { throwIfNoEntry: false })?.isDirectory() ? dir : void 0;
+  } catch {
+    return void 0;
+  }
+}
 function localDirectory(uri) {
   try {
     const url2 = new URL(uri);
-    if (url2.protocol !== FILE_URI_PROTOCOL) return void 0;
-    const dir = fileURLToPath2(url2);
-    return statSync(dir, { throwIfNoEntry: false })?.isDirectory() ? dir : void 0;
+    return url2.protocol === FILE_URI_PROTOCOL ? existingDirectory(fileURLToPath2(url2)) : void 0;
   } catch {
     return void 0;
   }
 }
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+async function usableDirectory(candidate, ownDir, allowPath = false) {
+  if (typeof candidate !== "string") return void 0;
+  const dir = allowPath && isAbsolute7(candidate) ? existingDirectory(candidate) : localDirectory(candidate);
+  if (dir === void 0 || ownDir !== void 0 && await isWithin(dir, ownDir)) return void 0;
+  return dir;
+}
+async function callDirectory(meta3, ownDir) {
+  if (!isRecord2(meta3)) return void 0;
+  const sandbox = meta3[SANDBOX_STATE_META];
+  if (isRecord2(sandbox)) {
+    const dir = await usableDirectory(sandbox.sandboxCwd, ownDir, true);
+    if (dir !== void 0) return dir;
+  }
+  const turn = meta3[TURN_METADATA];
+  if (!isRecord2(turn) || !isRecord2(turn.workspaces)) return void 0;
+  const workspaces = Object.keys(turn.workspaces);
+  return workspaces.length === 1 ? usableDirectory(workspaces[0], ownDir, true) : void 0;
+}
 async function firstUsableRoot(server, ownDir, signal) {
   const { roots } = await server.listRoots(void 0, { signal });
   for (const root of roots) {
-    const dir = localDirectory(root.uri);
-    if (dir !== void 0 && !(ownDir !== void 0 && await isWithin(dir, ownDir))) return dir;
+    const dir = await usableDirectory(root.uri, ownDir);
+    if (dir !== void 0) return dir;
   }
   return void 0;
 }
@@ -37572,7 +37668,9 @@ function createWorkingDirResolver(server, fallback, ownDir) {
     cached2 = void 0;
     generation++;
   });
-  return async (signal) => {
+  return async (signal, meta3) => {
+    const callDir = await callDirectory(meta3, ownDir);
+    if (callDir !== void 0) return callDir;
     if (!server.getClientCapabilities()?.roots) return fallback();
     if (cached2 !== void 0) return cached2;
     const started = generation;
@@ -37613,7 +37711,7 @@ function createServer(specs, settings, options = {}) {
 `));
   const server = new Server(
     { name: PROJECT.name, version: options.version ?? DEFAULT_VERSION },
-    { capabilities: { tools: {} } }
+    { capabilities: { tools: {}, experimental: { [SANDBOX_STATE_META]: {} } } }
   );
   const workingDir = createWorkingDirResolver(server, options.cwd ?? (() => process.cwd()), options.ownDir);
   const toolsets = options.toolsets ?? PROJECT_PROFILE.toolsets;
@@ -37626,10 +37724,11 @@ function createServer(specs, settings, options = {}) {
     try {
       const confirm = settings.confirm === "elicitation" ? elicitationConfirm(server, extra.signal) : void 0;
       const ctx = {
-        cwd: await workingDir(extra.signal),
+        cwd: await workingDir(extra.signal, request.params._meta),
         ownDir: options.ownDir,
         ...toolDirectories(settings),
         programName: PROJECT.name,
+        options: settings.options,
         signal: extra.signal,
         ...confirm && { confirm }
       };
@@ -37655,7 +37754,7 @@ async function main() {
     const settings = parseSettings(process.argv.slice(2), process.env);
     server = createServer(ALL_TOOLS, settings, {
       ownDir: packageRoot(import.meta.url),
-      version: true ? "0.0.0" : void 0
+      version: true ? "0.1.2" : void 0
     });
   } catch (error62) {
     if (!isToolError(error62)) throw error62;