@swmansion/argent 0.31.2-next.0 → 0.31.2-next.1

package/dist/mcp-server.mjs

@@ -11621,9 +11621,9 @@ var require_resolve_flow_scalar = __commonJS({
             res += parseCharCode(source, i + 1, length, onError);
             i += length;
           } else {
-            const raw = source.substr(i - 1, 2);
-            onError(i - 1, "BAD_DQ_ESCAPE", `Invalid escape sequence ${raw}`);
-            res += raw;
+            const raw2 = source.substr(i - 1, 2);
+            onError(i - 1, "BAD_DQ_ESCAPE", `Invalid escape sequence ${raw2}`);
+            res += raw2;
           }
         } else if (ch === " " || ch === "	") {
           const wsStart = i;
@@ -11695,9 +11695,9 @@ var require_resolve_flow_scalar = __commonJS({
       try {
         return String.fromCodePoint(code);
       } catch {
-        const raw = source.substr(offset - 2, length + 2);
-        onError(offset - 2, "BAD_DQ_ESCAPE", `Invalid escape sequence ${raw}`);
-        return raw;
+        const raw2 = source.substr(offset - 2, length + 2);
+        onError(offset - 2, "BAD_DQ_ESCAPE", `Invalid escape sequence ${raw2}`);
+        return raw2;
       }
     }
     exports.resolveFlowScalar = resolveFlowScalar;
@@ -14826,9 +14826,9 @@ function putProp(target, key, value) {
     target[key] = value;
 }
 function mirrorShape(target, source, keys, wrap) {
-  const raw = sourceShape(source);
+  const raw2 = sourceShape(source);
   for (const key of keys) {
-    const desc = Object.getOwnPropertyDescriptor(raw, key);
+    const desc = Object.getOwnPropertyDescriptor(raw2, key);
     if (!desc.enumerable)
       continue;
     if (desc.get) {
@@ -15094,10 +15094,10 @@ function pick(schema, mask) {
   return clone(schema, mergeDefs(currDef, { shape: newShape, checks: [] }));
 }
 function maskedKeys(schema, mask) {
-  const raw = sourceShape(schema);
+  const raw2 = sourceShape(schema);
   const keys = [];
   for (const key of Reflect.ownKeys(mask)) {
-    if (!Object.getOwnPropertyDescriptor(raw, key)?.enumerable) {
+    if (!Object.getOwnPropertyDescriptor(raw2, key)?.enumerable) {
       throw new Error(`Unrecognized key: "${String(key)}"`);
     }
     if (mask[key])
@@ -18011,8 +18011,8 @@ function isRecursive(inst, stack, resolve10) {
   const kind = def.type;
   switch (kind) {
     case "object": {
-      const raw = rawShape(def);
-      merge2(raw ? shape(raw, true) : ASSUMED);
+      const raw2 = rawShape(def);
+      merge2(raw2 ? shape(raw2, true) : ASSUMED);
       check(def.catchall);
       break;
     }
@@ -24622,8 +24622,8 @@ function stateFileForBundle(bundlePath) {
 }
 async function readStateFile(file) {
   try {
-    const raw = await readFile(file, "utf8");
-    return JSON.parse(raw);
+    const raw2 = await readFile(file, "utf8");
+    return JSON.parse(raw2);
   } catch {
     return null;
   }
@@ -24972,15 +24972,15 @@ function getFlagsPath(scope, options = {}) {
   return path2.join(resolveProjectRoot(cwd), ".argent", "flags.json");
 }
 function readFlagsFile(filePath) {
-  let raw;
+  let raw2;
   try {
-    raw = fs2.readFileSync(filePath, "utf8");
+    raw2 = fs2.readFileSync(filePath, "utf8");
   } catch {
     return {};
   }
   let parsed;
   try {
-    parsed = JSON.parse(raw);
+    parsed = JSON.parse(raw2);
   } catch {
     return {};
   }
@@ -25042,8 +25042,8 @@ import * as fs3 from "node:fs";
 import * as path4 from "node:path";
 function readConfigObject(scope = "global", options = {}) {
   try {
-    const raw = fs3.readFileSync(configFilePath(scope, options), "utf8");
-    const json = JSON.parse(raw);
+    const raw2 = fs3.readFileSync(configFilePath(scope, options), "utf8");
+    const json = JSON.parse(raw2);
     if (json && typeof json === "object" && !Array.isArray(json)) {
       return json;
     }
@@ -25308,23 +25308,23 @@ function applyMergePolicy(policy, local, global) {
 
 // ../configuration-core/src/config-schema.ts
 import { isAbsolute as isAbsolute2 } from "node:path";
-function asBoolean(raw) {
-  return typeof raw === "boolean" ? raw : void 0;
+function asBoolean(raw2) {
+  return typeof raw2 === "boolean" ? raw2 : void 0;
 }
-function asString(raw) {
-  if (typeof raw !== "string") return void 0;
-  const trimmed = raw.trim();
+function asString(raw2) {
+  if (typeof raw2 !== "string") return void 0;
+  const trimmed = raw2.trim();
   return trimmed === "" ? void 0 : trimmed;
 }
-function asPositiveInteger(raw) {
-  return typeof raw === "number" && Number.isSafeInteger(raw) && raw > 0 ? raw : void 0;
+function asPositiveInteger(raw2) {
+  return typeof raw2 === "number" && Number.isSafeInteger(raw2) && raw2 > 0 ? raw2 : void 0;
 }
 var MIN_SCRIPT_HEAP_LIMIT_MB = 32;
 var MIN_SCRIPT_TIMEOUT_MS = 100;
-function asStringArray(raw) {
-  if (!Array.isArray(raw)) return void 0;
+function asStringArray(raw2) {
+  if (!Array.isArray(raw2)) return void 0;
   const out = [];
-  for (const item of raw) {
+  for (const item of raw2) {
     if (typeof item === "string" && item.trim() !== "") out.push(item.trim());
   }
   return out;
@@ -25374,8 +25374,8 @@ var CONFIG_SCHEMA = [
     key: "android.sdkRoot",
     description: "Android SDK root argent uses instead of `ANDROID_HOME`, for hosts whose SDK is not where the environment says (Nix, custom layouts). Absolute or `~/`-prefixed. Applies to the tool-server and to the simulator-server it starts. `adb` on PATH still wins, as it does with the environment variable.",
     scopes: ["project", "global"],
-    parse: (raw) => {
-      const value = asString(raw);
+    parse: (raw2) => {
+      const value = asString(raw2);
       return value !== void 0 && (value === "~" || value.startsWith("~/") || isAbsolute2(value)) ? value : void 0;
     },
     expected: "an absolute path, or one starting with `~/`",
@@ -25386,8 +25386,8 @@ var CONFIG_SCHEMA = [
     key: "android.adbServerPort",
     description: "Port of the adb server argent uses, for hosts that run Android devices on a server other than the default 5037 (a device pool with its own server, for example). Applies when the tool-server starts, to the tool-server and every adb and simulator-server it runs. `ANDROID_ADB_SERVER_PORT` or `ADB_SERVER_SOCKET` in the tool-server's environment still wins, as it does for adb itself.",
     scopes: ["project", "global"],
-    parse: (raw) => {
-      const value = asPositiveInteger(raw);
+    parse: (raw2) => {
+      const value = asPositiveInteger(raw2);
       return value !== void 0 && value < 65536 ? value : void 0;
     },
     expected: "a TCP port, 1-65535",
@@ -25411,8 +25411,8 @@ var CONFIG_SCHEMA = [
     key: "scripts.maxTimeoutMs",
     description: `Upper bound, in milliseconds, on the time limit an e2e test \`script\` step may ask for (default 300000 \u2014 five minutes). Bounds how long one script can occupy the host. Values below ${MIN_SCRIPT_TIMEOUT_MS} ms are refused: the step starts a Node process before the script runs, so a smaller ceiling ends a script that did nothing wrong.`,
     scopes: ["global"],
-    parse: (raw) => {
-      const value = asPositiveInteger(raw);
+    parse: (raw2) => {
+      const value = asPositiveInteger(raw2);
       return value !== void 0 && value >= MIN_SCRIPT_TIMEOUT_MS ? value : void 0;
     },
     expected: `a whole number of milliseconds, at least ${MIN_SCRIPT_TIMEOUT_MS}`,
@@ -25424,8 +25424,8 @@ var CONFIG_SCHEMA = [
     key: "scripts.heapLimitMb",
     description: `Old-space heap limit, in MiB, given to each e2e test \`script\` process (default 512). Values below ${MIN_SCRIPT_HEAP_LIMIT_MB} MiB are refused: that is already below what importing a real npm dependency needs, and under about 5 MiB the process dies inside V8's own startup before any script runs.`,
     scopes: ["global"],
-    parse: (raw) => {
-      const value = asPositiveInteger(raw);
+    parse: (raw2) => {
+      const value = asPositiveInteger(raw2);
       return value !== void 0 && value >= MIN_SCRIPT_HEAP_LIMIT_MB ? value : void 0;
     },
     expected: `a whole number of MiB, at least ${MIN_SCRIPT_HEAP_LIMIT_MB}`,
@@ -25442,8 +25442,8 @@ function getConfigDefinition(key, registry2 = CONFIG_SCHEMA) {
 import * as path6 from "node:path";
 function readScopeValue(def, scope, options) {
   if (!def.scopes.includes(scope)) return void 0;
-  const raw = getAtPath(readConfigObject(scope, options), def.key);
-  return raw === void 0 ? void 0 : def.parse(raw);
+  const raw2 = getAtPath(readConfigObject(scope, options), def.key);
+  return raw2 === void 0 ? void 0 : def.parse(raw2);
 }
 function getConfigValue(def, options = {}) {
   const local = readScopeValue(def, "project", options);
@@ -26137,8 +26137,8 @@ var LINK_DIR = path9.join(homedir4(), ".argent");
 var LINK_FILE = path9.join(LINK_DIR, "link.json");
 async function readLinkConfig() {
   try {
-    const raw = await readFile2(LINK_FILE, "utf8");
-    const parsed = JSON.parse(raw);
+    const raw2 = await readFile2(LINK_FILE, "utf8");
+    const parsed = JSON.parse(raw2);
     if (!parsed || typeof parsed.url !== "string" || typeof parsed.host !== "string" || typeof parsed.port !== "number" || typeof parsed.createdAt !== "string") {
       return null;
     }
@@ -28439,8 +28439,8 @@ function readConfigOverrideAt(filePath) {
   }
   let parsedEnabled = null;
   try {
-    const raw = fs10.readFileSync(filePath, "utf8");
-    const json = JSON.parse(raw);
+    const raw2 = fs10.readFileSync(filePath, "utf8");
+    const json = JSON.parse(raw2);
     if (json && typeof json === "object") {
       const t = json.telemetry;
       if (t && typeof t === "object") {
@@ -28865,6 +28865,144 @@ function getAutoScreenshotDelayMs(toolName) {
   return base;
 }
 
+// ../argent-mcp/src/keyword-facts.ts
+var SHOWS_KEYWORDS = [
+  /^claude-code\b/,
+  /^gemini-cli-mcp-client\b/,
+  /^zed\b/,
+  /^kiro\b/,
+  /^q dev cli\b/,
+  /^copilot-cli\b/
+];
+function showsSchemaKeywords(clientName) {
+  const name = clientName?.trim().toLowerCase() ?? "";
+  return SHOWS_KEYWORDS.some((pattern) => pattern.test(name));
+}
+function withKeywordFacts(schema) {
+  const properties = asSchema(schema.properties);
+  return properties ? { ...schema, properties: withPropertyFacts(properties) } : schema;
+}
+function withPropertyFacts(properties) {
+  return Object.fromEntries(
+    Object.entries(properties).map(([key, value]) => {
+      const prop = asSchema(value);
+      return [key, prop ? withFacts(prop) : value];
+    })
+  );
+}
+function withFacts(prop) {
+  const out = { ...prop };
+  const nested = asSchema(prop.properties);
+  if (nested) out.properties = withPropertyFacts(nested);
+  const items = asSchema(prop.items);
+  if (items) out.items = withKeywordFacts(items);
+  const description = typeof prop.description === "string" ? prop.description.trimEnd() : "";
+  const facts = factsOf(prop, description);
+  if (facts.length === 0) return out;
+  const separator = description === "" ? "" : /[.!?:]$/.test(description) ? " " : ". ";
+  out.description = `${description}${separator}${facts.join(" ")}`;
+  return out;
+}
+function factsOf(prop, description) {
+  const facts = [];
+  if (prop.default !== void 0 && !statesDefault(description, prop.default)) {
+    facts.push(`Default: ${show(prop.default)}.`);
+  }
+  for (const branch of [prop, ...branchesOf(prop)]) {
+    facts.push(...boundFacts(branch, description));
+    if (branch.const !== void 0 && !mentions(description, branch.const)) {
+      facts.push(`Also accepts ${show(branch.const)}.`);
+    }
+  }
+  return facts;
+}
+function branchesOf(prop) {
+  const branches = [prop.anyOf, prop.oneOf].flatMap((list) => Array.isArray(list) ? list : []);
+  return branches.map(asSchema).filter((branch) => branch !== void 0);
+}
+function boundFacts(schema, description) {
+  const facts = [];
+  const min = bound(schema.minimum);
+  const max = bound(schema.maximum);
+  const above = bound(schema.exclusiveMinimum);
+  const below = bound(schema.exclusiveMaximum);
+  const rangeStated = min !== void 0 && max !== void 0 && statesRange(description, min, max);
+  const showMin = min !== void 0 && !rangeStated && !statesLimit(description, MIN_WORDS, min);
+  const showMax = max !== void 0 && !rangeStated && !statesLimit(description, MAX_WORDS, max);
+  if (showMin && showMax) facts.push(`Range: ${min} to ${max}.`);
+  else if (showMin) facts.push(`Minimum: ${min}.`);
+  else if (showMax) facts.push(`Maximum: ${max}.`);
+  if (above !== void 0 && !statesAbove(description, above)) {
+    facts.push(`Must be greater than ${above}.`);
+  }
+  if (below !== void 0 && !statesLimit(description, BELOW_WORDS, below)) {
+    facts.push(`Must be less than ${below}.`);
+  }
+  const lengthOrCount = [
+    [schema.minLength, "Min length", MIN_WORDS],
+    [schema.maxLength, "Max length", MAX_WORDS],
+    [schema.minItems, "Min items", MIN_WORDS],
+    [schema.maxItems, "Max items", MAX_WORDS]
+  ];
+  for (const [value, label, words] of lengthOrCount) {
+    const n = bound(value);
+    const trivialMin = label.startsWith("Min") && n !== void 0 && n <= 1;
+    if (n !== void 0 && !trivialMin && !statesLimit(description, words, n)) {
+      facts.push(`${label}: ${n}.`);
+    }
+  }
+  return facts;
+}
+var MIN_WORDS = /\b(min(imum)?|at least|no less than)\b|>=|≥/;
+var MAX_WORDS = /\b(max(imum)?|at most|up to|no more than|caps? at|capped at|limit)\b|<=|≤/;
+var BELOW_WORDS = /\b(less than|below|under)\b|</;
+function statesLimit(description, words, value) {
+  return new RegExp(`(${words.source})[^.;\\n]{0,24}?${numberPattern(value)}`, "i").test(
+    description
+  );
+}
+function statesRange(description, min, max) {
+  return new RegExp(
+    `${numberPattern(min)}\\s*(\\([^)]{0,20}\\)\\s*)?(\u2013|\u2014|-|to|\\.\\.)\\s*${numberPattern(max)}`,
+    "i"
+  ).test(description);
+}
+function statesAbove(description, value) {
+  if (value === 0 && /\bpositive\b/i.test(description)) return true;
+  return statesLimit(description, /\b(greater than|more than|above|over)\b|>/, value);
+}
+function statesDefault(description, value) {
+  const v = valuePattern(raw(value));
+  return new RegExp(
+    `\\bdefault(s|s to| is|:)?[^.;\\n]{0,24}?${v}|${v}[^.;\\n]{0,16}\\bby default|${v}\\s*\\(default\\)`,
+    "i"
+  ).test(description);
+}
+function mentions(description, value) {
+  return new RegExp(valuePattern(raw(value)), "i").test(description);
+}
+function valuePattern(value) {
+  return `(?<![\\w.])${escapeRegExp(value)}(?![\\w])`;
+}
+function numberPattern(value) {
+  return `(?<![\\w.])${escapeRegExp(String(value))}(\\.0+)?(?![\\w]|\\.\\d)`;
+}
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function bound(value) {
+  return typeof value === "number" && Math.abs(value) < Number.MAX_SAFE_INTEGER ? value : void 0;
+}
+function raw(value) {
+  return typeof value === "string" ? value : JSON.stringify(value);
+}
+function show(value) {
+  return JSON.stringify(value);
+}
+function asSchema(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+}
+
 // ../argent-mcp/src/tool-mapping.ts
 function withoutRetiredParams(schema) {
   const properties = schema.properties;
@@ -28875,24 +29013,25 @@ function withoutRetiredParams(schema) {
   if (live.length === Object.keys(properties).length) return schema;
   return { ...schema, properties: Object.fromEntries(live) };
 }
-function toMcpTool(t) {
+function toMcpTool(t, { keywordFacts = false } = {}) {
   const meta2 = {};
   if (t.alwaysLoad) meta2["anthropic/alwaysLoad"] = true;
   if (t.searchHint) meta2["anthropic/searchHint"] = t.searchHint;
+  const schema = withoutRetiredParams(t.inputSchema);
   return {
     name: t.name,
     description: t.description,
-    inputSchema: { type: "object", ...withoutRetiredParams(t.inputSchema) },
+    inputSchema: { type: "object", ...keywordFacts ? withKeywordFacts(schema) : schema },
     ...t.readOnly ? { annotations: { readOnlyHint: true } } : {},
     ...Object.keys(meta2).length > 0 ? { _meta: meta2 } : {}
   };
 }
-function toMcpToolList(tools) {
-  return tools.filter((t) => !t.hideFromMcp).map(toMcpTool);
+function toMcpToolList(tools, options = {}) {
+  return tools.filter((t) => !t.hideFromMcp).map((t) => toMcpTool(t, options));
 }
 
 // ../argent-mcp/src/instructions.ts
-var SERVER_INSTRUCTIONS = "Argent \u2014 iOS Simulator, Android Emulator, and Chromium app control for interacting, testing, profiling and debugging mobile and Chromium applications. Interaction tools return the screen after the action: a screenshot plus the accessibility element tree with normalized tap frames. Take coordinates from that tree; call describe (or debugger-component-tree) only when no fresh tree is available \u2014 never guess coordinates from pixels. Do not stop simulator servers when a task finishes: the next task reuses them. Call stop-all-simulator-servers when the user asks to clean up or ends the session, or when a skill tells you to recycle a device's services, always with devices: [...] naming the devices this session used. Never stop a Metro the user started unless they ask. One tool-server is shared by every agent using this argent install, so an unscoped call tears down their devices too \u2014 reserve it for a deliberate machine-wide cleanup. Full guidance is in the argent rule loaded from .claude/rules/argent.md.";
+var SERVER_INSTRUCTIONS = "Argent \u2014 iOS Simulator, Android Emulator, and Chromium app control for interacting, testing, profiling and debugging mobile and Chromium applications. Interaction tools return the screen after the action: a screenshot plus the accessibility element tree with normalized tap frames. Take coordinates from that tree; call describe (or debugger-component-tree) only when no fresh tree is available \u2014 never guess coordinates from pixels. Do not stop simulator servers when a task finishes: the next task reuses them. Call stop-all-simulator-servers when the user asks to clean up or ends the session, or when a skill tells you to recycle a device's services, always with devices: [...] naming the devices this session used. Never stop a Metro the user started unless they ask. One tool-server is shared by every agent using this argent install, so an unscoped call tears down their devices too \u2014 reserve it for a deliberate machine-wide cleanup.";
 
 // ../argent-mcp/src/installed-version.ts
 import * as fs11 from "node:fs";
@@ -29159,11 +29298,13 @@ ${desc}` }];
   );
   server.setRequestHandler(ListToolsRequestSchema, async () => {
     try {
-      const tools = toMcpToolList(await fetchTools());
+      const keywordFacts = !showsSchemaKeywords(server.getClientVersion()?.name);
+      const tools = toMcpToolList(await fetchTools(), { keywordFacts });
       await spyLog({
         ts: (/* @__PURE__ */ new Date()).toISOString(),
         event: "list_tools",
-        count: tools.length
+        count: tools.length,
+        keywordFacts
       });
       return { tools };
     } catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swmansion/argent",
-  "version": "0.31.2-next.0",
+  "version": "0.31.2-next.1",
   "mcpName": "io.github.software-mansion/argent",
   "description": "MCP server for iOS Simulator and Android Emulator control",
   "license": "Apache-2.0",