@frontmcp/plugin-codecall 1.8.4 → 1.8.6

package/esm/index.mjs

@@ -1871,6 +1871,121 @@ function toSandboxToolNamespaces(namespaces, reservedGlobals = []) {
   return count > 0 ? bindable : void 0;
 }
 
+// plugins/plugin-codecall/src/utils/script-lines.ts
+import { isWrappedInMain, transformAgentScript } from "@enclave-vm/ast";
+import * as acorn from "acorn";
+var PARSE_OPTIONS = { ecmaVersion: "latest", locations: true };
+var NON_CHILD_KEYS = /* @__PURE__ */ new Set(["type", "loc", "start", "end", "range"]);
+function isNode(value) {
+  return typeof value === "object" && value !== null && typeof value.type === "string";
+}
+function isAddedByTransform(node) {
+  if (node.type === "VariableDeclaration") {
+    const [declaration] = node["declarations"] ?? [];
+    const id = declaration?.["id"];
+    return typeof id?.["name"] === "string" && id["name"].startsWith("__iter_");
+  }
+  if (node.type === "IfStatement") {
+    const right = node["test"]?.["right"];
+    return right?.type === "Identifier" && right["name"] === "__maxIterations";
+  }
+  return false;
+}
+function parseScript(script) {
+  try {
+    return { body: parseBody(script, "script"), offset: 0 };
+  } catch {
+    try {
+      return { body: parseBody(script, "module"), offset: 0 };
+    } catch {
+      const wrapped = parseBody(`async function __temp__() {
+${script}
+}`, "script");
+      const fn = wrapped[0];
+      const block = fn?.["body"];
+      return { body: block?.["body"] ?? [], offset: 1 };
+    }
+  }
+}
+function parseBody(code, sourceType) {
+  const program = acorn.parse(code, { ...PARSE_OPTIONS, sourceType });
+  return program["body"] ?? [];
+}
+function treesOf(script) {
+  try {
+    const wrap = !isWrappedInMain(script);
+    const printed = parseBody(transformAgentScript(script, { wrapInMain: wrap }), "script");
+    const { body, offset } = parseScript(script);
+    if (!wrap) return { printed, script: body, offset };
+    const main = printed[0]?.["body"];
+    return { printed: main?.["body"] ?? [], script: body, offset };
+  } catch {
+    return void 0;
+  }
+}
+function pairLists(printed, script, depth, out, offset) {
+  const kept = printed.filter((node) => !(isNode(node) && isAddedByTransform(node)));
+  if (kept.length !== script.length) return;
+  kept.forEach((node, index) => {
+    const own = script[index];
+    if (isNode(node) && isNode(own)) pairNodes(node, own, depth, out, offset);
+  });
+}
+function pairNodes(printed, script, depth, out, offset) {
+  if (printed.type === "ReturnStatement" && script.type === "ExpressionStatement") {
+    record(printed, script, depth, out, offset);
+    const argument = printed["argument"];
+    const expression = script["expression"];
+    if (isNode(argument) && isNode(expression)) pairNodes(argument, expression, depth + 1, out, offset);
+    return;
+  }
+  if (printed.type !== script.type) return;
+  record(printed, script, depth, out, offset);
+  for (const key of Object.keys(printed)) {
+    if (NON_CHILD_KEYS.has(key)) continue;
+    const printedChild = printed[key];
+    const scriptChild = script[key];
+    if (Array.isArray(printedChild) && Array.isArray(scriptChild)) {
+      pairLists(printedChild, scriptChild, depth + 1, out, offset);
+    } else if (isNode(printedChild) && isNode(scriptChild)) {
+      pairNodes(printedChild, scriptChild, depth + 1, out, offset);
+    }
+  }
+}
+function record(printed, script, depth, out, offset) {
+  if (!printed.loc || !script.loc) return;
+  out.push({
+    printedStart: printed.loc.start.line,
+    printedEnd: printed.loc.end.line,
+    scriptLine: script.loc.start.line - offset,
+    depth
+  });
+}
+function validatedLineMapper(script) {
+  const trees = treesOf(script);
+  if (!trees) return () => void 0;
+  const pairs = [];
+  pairLists(trees.printed, trees.script, 0, pairs, trees.offset);
+  return (printedLine) => {
+    const starting = pairs.filter((pair) => pair.printedStart === printedLine);
+    const candidates = starting.length > 0 ? starting : pairs.filter((pair) => pair.printedStart <= printedLine && printedLine <= pair.printedEnd);
+    const best = candidates.reduce(
+      (deepest, pair) => !deepest || pair.depth > deepest.depth ? pair : deepest,
+      void 0
+    );
+    return best && best.scriptLine >= 1 ? best.scriptLine : void 0;
+  };
+}
+var ISSUE_LINE_RE = / \(line (\d+)\)/g;
+function withScriptLines(message, script) {
+  if (!message.includes("(line ")) return message;
+  const lineOf = validatedLineMapper(script);
+  return message.replace(ISSUE_LINE_RE, (_match, printed) => {
+    const line = lineOf(Number(printed));
+    return line === void 0 ? "" : ` (line ${line})`;
+  });
+}
+
 // plugins/plugin-codecall/src/services/enclave.service.ts
 function toolFailureMessage(error, toolName) {
   if (typeof error === "string" && error) return error;
@@ -1995,7 +2110,7 @@ var EnclaveService = class {
     const enclave = createEnclave(options);
     try {
       const result = await enclave.run(code);
-      return this.mapEnclaveResult(result, logs, toolFailures);
+      return this.mapEnclaveResult(result, logs, toolFailures, code);
     } finally {
       enclave.dispose();
     }
@@ -2003,7 +2118,7 @@ var EnclaveService = class {
   /**
    * Map Enclave ExecutionResult to EnclaveExecutionResult
    */
-  mapEnclaveResult(result, logs, toolFailures = []) {
+  mapEnclaveResult(result, logs, toolFailures = [], script = "") {
     const stats = {
       duration: result.stats.duration,
       toolCallCount: result.stats.toolCallCount,
@@ -2045,7 +2160,9 @@ var EnclaveService = class {
       return {
         success: false,
         error: {
-          message: error.message,
+          // The enclave names lines of the code it validated (the script wrapped and printed again),
+          // not the script's own.
+          message: withScriptLines(error.message, script),
           name: "ValidationError",
           code: error.code,
           ...blockedPatterns.length > 0 ? { blockedPatterns } : {}
@@ -2651,6 +2768,43 @@ function generateSampleParams(schema) {
   }
   return Object.keys(params).length > 0 ? params : null;
 }
+function fitString(schema, value) {
+  let fitted = value;
+  if (schema.maxLength !== void 0 && fitted.length > schema.maxLength) {
+    fitted = fitted.slice(0, Math.max(0, schema.maxLength));
+  }
+  if (schema.minLength !== void 0 && fitted.length < schema.minLength) {
+    fitted = fitted.padEnd(schema.minLength, "x");
+  }
+  return fitted;
+}
+function isFreeTextString(schema) {
+  return schema?.type === "string" && schema.enum === void 0 && schema.const === void 0 && schema.default === void 0 && schema.pattern === void 0 && schema.format === void 0;
+}
+function acceptsNumber(schema, value) {
+  if (schema.const !== void 0) return schema.const === value;
+  if (schema.enum !== void 0) return schema.enum.includes(value);
+  if (schema.minimum !== void 0 && value < schema.minimum) return false;
+  if (schema.maximum !== void 0 && value > schema.maximum) return false;
+  return true;
+}
+function pickNumber(schema, preferred) {
+  const accepted = preferred.find((value) => acceptsNumber(schema, value));
+  if (accepted !== void 0) return accepted;
+  const named = [schema.const, schema.enum?.[0], schema.minimum, schema.maximum].find(
+    (value) => typeof value === "number" && acceptsNumber(schema, value)
+  );
+  return named;
+}
+function formatInlineArgs(args) {
+  const entries = Object.entries(args).map(([key, value]) => {
+    const name = /^[A-Za-z_$][\w$]*$/.test(key) ? key : JSON.stringify(key);
+    const plain = typeof value === "string" && [...value].every((ch) => ch !== "'" && ch !== "\\" && ch >= " ");
+    const literal = plain ? `'${value}'` : JSON.stringify(value);
+    return `${name}: ${literal}`;
+  });
+  return entries.length > 0 ? `{ ${entries.join(", ")} }` : "{}";
+}
 function getSampleValue(schema, key) {
   if (schema.default !== void 0) {
     return schema.default;
@@ -2664,11 +2818,11 @@ function getSampleValue(schema, key) {
   const type = Array.isArray(schema.type) ? schema.type[0] : schema.type;
   switch (type) {
     case "string":
-      if (key.toLowerCase().includes("id")) return "abc123";
-      if (key.toLowerCase().includes("email")) return "user@example.com";
-      if (key.toLowerCase().includes("name")) return "Example";
-      if (key.toLowerCase().includes("url")) return "https://example.com";
-      return "string";
+      if (key.toLowerCase().includes("id")) return fitString(schema, "abc123");
+      if (key.toLowerCase().includes("email")) return fitString(schema, "user@example.com");
+      if (key.toLowerCase().includes("name")) return fitString(schema, "Example");
+      if (key.toLowerCase().includes("url")) return fitString(schema, "https://example.com");
+      return fitString(schema, "string");
     case "number":
     case "integer":
       if (key.toLowerCase().includes("limit")) return 10;
@@ -2685,24 +2839,88 @@ function getSampleValue(schema, key) {
       return null;
   }
 }
+var PAGINATION_PROPERTIES = ["limit", "offset", "page", "pagesize", "cursor"];
+function isPaginationProperty(name) {
+  return PAGINATION_PROPERTIES.includes(name.toLowerCase());
+}
 function hasPaginationParams(schema) {
   if (!schema || schema.type !== "object" || !schema.properties) {
     return false;
   }
-  const props = Object.keys(schema.properties);
-  return props.some((p) => ["limit", "offset", "page", "pageSize", "cursor"].includes(p.toLowerCase()));
+  return Object.keys(schema.properties).some(isPaginationProperty);
 }
-function generatePaginationExample(toolName) {
-  return {
-    description: `Pagination example for ${toolName}`,
-    code: `// Fetch first page
-const page1 = await callTool('${toolName}', { limit: 10, offset: 0 });
+function inputProperties(schema) {
+  if (!schema || schema.type !== "object" || !schema.properties) {
+    return {};
+  }
+  const properties = {};
+  for (const [key, propSchema] of Object.entries(schema.properties)) {
+    if (typeof propSchema !== "boolean") properties[key] = propSchema;
+  }
+  return properties;
+}
+function buildExampleArgs(schema, keys, values = {}) {
+  const properties = inputProperties(schema);
+  const args = {};
+  for (const key of [...keys, ...schema?.required ?? []]) {
+    const propSchema = properties[key];
+    if (!propSchema || key in args) continue;
+    args[key] = key in values ? values[key] : getSampleValue(propSchema, key);
+  }
+  return args;
+}
+function formatExampleArgs(args) {
+  return Object.keys(args).length > 0 ? JSON.stringify(args, null, 2) : "{}";
+}
+function getFilterProperties(schema) {
+  if (!schema || schema.type !== "object" || !schema.properties) {
+    return [];
+  }
+  return Object.keys(schema.properties).filter(
+    (p) => p.toLowerCase().includes("filter") || p.toLowerCase().includes("query") || p.toLowerCase().includes("search") || p.toLowerCase() === "status" || p.toLowerCase() === "type" || p.toLowerCase() === "role"
+  );
+}
+function generatePaginationExample(toolName, inputSchema) {
+  const description = `Pagination example for ${toolName}`;
+  const props = Object.keys(inputProperties(inputSchema));
+  const limitKey = props.find((p) => p.toLowerCase() === "limit");
+  const offsetKey = props.find((p) => p.toLowerCase() === "offset");
+  if (limitKey && offsetKey) {
+    const properties = inputProperties(inputSchema);
+    const limit = pickNumber(properties[limitKey], [10]);
+    const firstOffset = pickNumber(properties[offsetKey], [0]);
+    const values = {};
+    if (limit !== void 0) values[limitKey] = limit;
+    if (firstOffset !== void 0) values[offsetKey] = firstOffset;
+    const firstPage = buildExampleArgs(inputSchema, [limitKey, offsetKey], values);
+    const nextOffset = [limit ?? 10, 10, 20, ...properties[offsetKey].enum ?? []].find(
+      (value) => typeof value === "number" && value !== firstPage[offsetKey] && acceptsNumber(properties[offsetKey], value)
+    );
+    if (nextOffset !== void 0) {
+      const secondPage = { ...firstPage, [offsetKey]: nextOffset };
+      return {
+        description,
+        code: `// Fetch first page
+const page1 = await callTool('${toolName}', ${formatExampleArgs(firstPage)});
 
 // Fetch second page
-const page2 = await callTool('${toolName}', { limit: 10, offset: 10 });
+const page2 = await callTool('${toolName}', ${formatExampleArgs(secondPage)});
 
 // Combine results
 return [...page1.items, ...page2.items];`
+      };
+    }
+    return {
+      description,
+      code: `const page = await callTool('${toolName}', ${formatExampleArgs(firstPage)});
+return page.items || page;`
+    };
+  }
+  const args = buildExampleArgs(inputSchema, props.filter(isPaginationProperty));
+  return {
+    description,
+    code: `const page = await callTool('${toolName}', ${formatExampleArgs(args)});
+return page.items || page;`
   };
 }
 function extractEntityName(toolName) {
@@ -2720,13 +2938,18 @@ function generateCreateExample(toolName, inputSchema) {
 return result;`
   };
 }
+function idArgs(schema, idParam) {
+  const idSchema = inputProperties(schema)[idParam];
+  const values = isFreeTextString(idSchema) ? { [idParam]: fitString(idSchema, "abc123") } : {};
+  return buildExampleArgs(schema, [idParam], values);
+}
 function generateGetExample(toolName, inputSchema) {
   const entity = extractEntityName(toolName);
   const idParam = findIdParameter(inputSchema);
   if (idParam) {
     return {
       description: `Get ${entity} by ${idParam}`,
-      code: `const ${entity} = await callTool('${toolName}', { ${idParam}: 'abc123' });
+      code: `const ${entity} = await callTool('${toolName}', ${formatInlineArgs(idArgs(inputSchema, idParam))});
 return ${entity};`
     };
   }
@@ -2742,7 +2965,7 @@ function generateListExample(toolName, inputSchema) {
   const entity = extractEntityName(toolName);
   return {
     description: `List all ${entity}s`,
-    code: `const result = await callTool('${toolName}', {});
+    code: `const result = await callTool('${toolName}', ${formatExampleArgs(buildExampleArgs(inputSchema, []))});
 return result.items || result;`
   };
 }
@@ -2752,10 +2975,11 @@ function generateUpdateExample(toolName, inputSchema) {
   const updateFields = generateUpdateFields(inputSchema);
   const fieldsStr = updateFields ? JSON.stringify(updateFields, null, 2).replace(/\n/g, "\n  ") : "{ /* fields to update */ }";
   if (idParam) {
+    const identifiers = formatInlineArgs(idArgs(inputSchema, idParam)).slice(2, -2);
     return {
       description: `Update ${entity} by ${idParam}`,
       code: `const updated = await callTool('${toolName}', {
-  ${idParam}: 'abc123',
+  ${identifiers},
   ...${fieldsStr}
 });
 return updated;`
@@ -2773,7 +2997,7 @@ function generateDeleteExample(toolName, inputSchema) {
   if (idParam) {
     return {
       description: `Delete ${entity} by ${idParam}`,
-      code: `const result = await callTool('${toolName}', { ${idParam}: 'abc123' });
+      code: `const result = await callTool('${toolName}', ${formatInlineArgs(idArgs(inputSchema, idParam))});
 return result;`
     };
   }
@@ -2787,17 +3011,18 @@ return result;`
 }
 function generateSearchExample(toolName, inputSchema) {
   const entity = extractEntityName(toolName);
-  const queryParam = findQueryParameter(inputSchema);
-  if (queryParam) {
-    return {
-      description: `Search for ${entity}s`,
-      code: `const results = await callTool('${toolName}', { ${queryParam}: 'search term' });
-return results.items || results;`
-    };
-  }
+  const searchParam = findQueryParameter(inputSchema) ?? getFilterProperties(inputSchema)[0];
+  const searchSchema = searchParam ? inputProperties(inputSchema)[searchParam] : void 0;
+  const required = new Set(inputSchema?.required ?? []);
+  const unfillable = searchSchema?.type === "string" && (searchSchema.pattern !== void 0 || searchSchema.format !== void 0) && searchSchema.enum === void 0 && searchSchema.const === void 0 && searchSchema.default === void 0 && !required.has(searchParam ?? "");
+  const args = searchParam && !unfillable ? buildExampleArgs(
+    inputSchema,
+    [searchParam],
+    isFreeTextString(searchSchema) && searchSchema ? { [searchParam]: fitString(searchSchema, "search term") } : {}
+  ) : buildExampleArgs(inputSchema, []);
   return {
     description: `Search for ${entity}s`,
-    code: `const results = await callTool('${toolName}', { query: 'search term' });
+    code: `const results = await callTool('${toolName}', ${formatExampleArgs(args)});
 return results.items || results;`
   };
 }
@@ -2854,7 +3079,7 @@ function generateSmartExample(toolName, inputSchema, description) {
     case "get":
       return generateGetExample(toolName, inputSchema);
     case "list":
-      return hasPaginationParams(inputSchema) ? generatePaginationExample(toolName) : generateListExample(toolName, inputSchema);
+      return hasPaginationParams(inputSchema) ? generatePaginationExample(toolName, inputSchema) : generateListExample(toolName, inputSchema);
     case "update":
       return generateUpdateExample(toolName, inputSchema);
     case "delete":
@@ -3082,7 +3307,9 @@ var DescribeTool = class extends ToolContext4 {
    *
    * Priority:
    * 1. User-provided examples from @Tool decorator metadata (up to 5)
-   * 2. Smart intent-based generation to fill remaining slots
+   * 2. Without any, one smart intent-based example built from the input schema. It is never added
+   *    next to the tool's own examples: those show how the tool is called, and a generated one
+   *    only guesses (#647).
    * 3. Returns at least 1 example
    */
   generateExamples(tool, inputSchema) {
@@ -3097,7 +3324,7 @@ return result;`
         });
       }
     }
-    if (result.length < 5) {
+    if (result.length === 0) {
       result.push(generateSmartExample(tool.name, inputSchema, tool.metadata?.description));
     }
     return result.slice(0, 5);
@@ -3186,7 +3413,11 @@ var runtimeErrorPayloadSchema = z7.object({
 var toolErrorPayloadSchema = z7.object({
   source: z7.literal("tool"),
   toolName: z7.string(),
-  toolInput: z7.unknown(),
+  /**
+   * @deprecated Never set: the sandbox resolves sidecar references in a call's arguments before
+   * the tool sees them, so they may hold data the script itself never had.
+   */
+  toolInput: z7.unknown().optional(),
   message: z7.string(),
   code: z7.string().optional(),
   /** @deprecated Never set: the enclave's error data is not sanitized for clients. */
@@ -3433,10 +3664,10 @@ var ExecuteTool = class extends ToolContext5 {
             error: {
               source: "tool",
               toolName: error.toolName,
-              toolInput: error.toolInput,
               message: toClientErrorMessage(error.message),
               code: error.code
-              // No `details`: the enclave's error data is not sanitized for clients.
+              // No `details`: the enclave's error data is not sanitized for clients. No `toolInput`:
+              // the arguments the tool saw may hold sidecar-resolved data the script never had.
             }
           };
         }

package/esm/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontmcp/plugin-codecall",
-  "version": "1.8.4",
+  "version": "1.8.6",
   "description": "CodeCall plugin for FrontMCP - AgentScript-based meta-tools for orchestrating MCP tools",
   "author": "AgentFront <info@agentfront.dev>",
   "license": "Apache-2.0",
@@ -48,14 +48,16 @@
     }
   },
   "dependencies": {
+    "@enclave-vm/ast": "^2.15.3",
     "@enclave-vm/core": "^2.15.3",
-    "@frontmcp/protocol": "1.8.4",
-    "@frontmcp/sdk": "1.8.4",
+    "@frontmcp/protocol": "1.8.6",
+    "@frontmcp/sdk": "1.8.6",
+    "acorn": "^8.15.0",
     "vectoriadb": "^2.3.2"
   },
   "peerDependencies": {
-    "@frontmcp/lazy-zod": "1.8.4",
-    "@frontmcp/plugin-cache": "1.8.4"
+    "@frontmcp/lazy-zod": "1.8.6",
+    "@frontmcp/plugin-cache": "1.8.6"
   },
   "devDependencies": {
     "reflect-metadata": "^0.2.2"

package/index.js

@@ -1908,6 +1908,121 @@ function toSandboxToolNamespaces(namespaces, reservedGlobals = []) {
   return count > 0 ? bindable : void 0;
 }
 
+// plugins/plugin-codecall/src/utils/script-lines.ts
+var import_ast = require("@enclave-vm/ast");
+var acorn = __toESM(require("acorn"));
+var PARSE_OPTIONS = { ecmaVersion: "latest", locations: true };
+var NON_CHILD_KEYS = /* @__PURE__ */ new Set(["type", "loc", "start", "end", "range"]);
+function isNode(value) {
+  return typeof value === "object" && value !== null && typeof value.type === "string";
+}
+function isAddedByTransform(node) {
+  if (node.type === "VariableDeclaration") {
+    const [declaration] = node["declarations"] ?? [];
+    const id = declaration?.["id"];
+    return typeof id?.["name"] === "string" && id["name"].startsWith("__iter_");
+  }
+  if (node.type === "IfStatement") {
+    const right = node["test"]?.["right"];
+    return right?.type === "Identifier" && right["name"] === "__maxIterations";
+  }
+  return false;
+}
+function parseScript(script) {
+  try {
+    return { body: parseBody(script, "script"), offset: 0 };
+  } catch {
+    try {
+      return { body: parseBody(script, "module"), offset: 0 };
+    } catch {
+      const wrapped = parseBody(`async function __temp__() {
+${script}
+}`, "script");
+      const fn = wrapped[0];
+      const block = fn?.["body"];
+      return { body: block?.["body"] ?? [], offset: 1 };
+    }
+  }
+}
+function parseBody(code, sourceType) {
+  const program = acorn.parse(code, { ...PARSE_OPTIONS, sourceType });
+  return program["body"] ?? [];
+}
+function treesOf(script) {
+  try {
+    const wrap = !(0, import_ast.isWrappedInMain)(script);
+    const printed = parseBody((0, import_ast.transformAgentScript)(script, { wrapInMain: wrap }), "script");
+    const { body, offset } = parseScript(script);
+    if (!wrap) return { printed, script: body, offset };
+    const main = printed[0]?.["body"];
+    return { printed: main?.["body"] ?? [], script: body, offset };
+  } catch {
+    return void 0;
+  }
+}
+function pairLists(printed, script, depth, out, offset) {
+  const kept = printed.filter((node) => !(isNode(node) && isAddedByTransform(node)));
+  if (kept.length !== script.length) return;
+  kept.forEach((node, index) => {
+    const own = script[index];
+    if (isNode(node) && isNode(own)) pairNodes(node, own, depth, out, offset);
+  });
+}
+function pairNodes(printed, script, depth, out, offset) {
+  if (printed.type === "ReturnStatement" && script.type === "ExpressionStatement") {
+    record(printed, script, depth, out, offset);
+    const argument = printed["argument"];
+    const expression = script["expression"];
+    if (isNode(argument) && isNode(expression)) pairNodes(argument, expression, depth + 1, out, offset);
+    return;
+  }
+  if (printed.type !== script.type) return;
+  record(printed, script, depth, out, offset);
+  for (const key of Object.keys(printed)) {
+    if (NON_CHILD_KEYS.has(key)) continue;
+    const printedChild = printed[key];
+    const scriptChild = script[key];
+    if (Array.isArray(printedChild) && Array.isArray(scriptChild)) {
+      pairLists(printedChild, scriptChild, depth + 1, out, offset);
+    } else if (isNode(printedChild) && isNode(scriptChild)) {
+      pairNodes(printedChild, scriptChild, depth + 1, out, offset);
+    }
+  }
+}
+function record(printed, script, depth, out, offset) {
+  if (!printed.loc || !script.loc) return;
+  out.push({
+    printedStart: printed.loc.start.line,
+    printedEnd: printed.loc.end.line,
+    scriptLine: script.loc.start.line - offset,
+    depth
+  });
+}
+function validatedLineMapper(script) {
+  const trees = treesOf(script);
+  if (!trees) return () => void 0;
+  const pairs = [];
+  pairLists(trees.printed, trees.script, 0, pairs, trees.offset);
+  return (printedLine) => {
+    const starting = pairs.filter((pair) => pair.printedStart === printedLine);
+    const candidates = starting.length > 0 ? starting : pairs.filter((pair) => pair.printedStart <= printedLine && printedLine <= pair.printedEnd);
+    const best = candidates.reduce(
+      (deepest, pair) => !deepest || pair.depth > deepest.depth ? pair : deepest,
+      void 0
+    );
+    return best && best.scriptLine >= 1 ? best.scriptLine : void 0;
+  };
+}
+var ISSUE_LINE_RE = / \(line (\d+)\)/g;
+function withScriptLines(message, script) {
+  if (!message.includes("(line ")) return message;
+  const lineOf = validatedLineMapper(script);
+  return message.replace(ISSUE_LINE_RE, (_match, printed) => {
+    const line = lineOf(Number(printed));
+    return line === void 0 ? "" : ` (line ${line})`;
+  });
+}
+
 // plugins/plugin-codecall/src/services/enclave.service.ts
 function toolFailureMessage(error, toolName) {
   if (typeof error === "string" && error) return error;
@@ -2032,7 +2147,7 @@ var EnclaveService = class {
     const enclave = createEnclave(options);
     try {
       const result = await enclave.run(code);
-      return this.mapEnclaveResult(result, logs, toolFailures);
+      return this.mapEnclaveResult(result, logs, toolFailures, code);
     } finally {
       enclave.dispose();
     }
@@ -2040,7 +2155,7 @@ var EnclaveService = class {
   /**
    * Map Enclave ExecutionResult to EnclaveExecutionResult
    */
-  mapEnclaveResult(result, logs, toolFailures = []) {
+  mapEnclaveResult(result, logs, toolFailures = [], script = "") {
     const stats = {
       duration: result.stats.duration,
       toolCallCount: result.stats.toolCallCount,
@@ -2082,7 +2197,9 @@ var EnclaveService = class {
       return {
         success: false,
         error: {
-          message: error.message,
+          // The enclave names lines of the code it validated (the script wrapped and printed again),
+          // not the script's own.
+          message: withScriptLines(error.message, script),
           name: "ValidationError",
           code: error.code,
           ...blockedPatterns.length > 0 ? { blockedPatterns } : {}
@@ -2688,6 +2805,43 @@ function generateSampleParams(schema) {
   }
   return Object.keys(params).length > 0 ? params : null;
 }
+function fitString(schema, value) {
+  let fitted = value;
+  if (schema.maxLength !== void 0 && fitted.length > schema.maxLength) {
+    fitted = fitted.slice(0, Math.max(0, schema.maxLength));
+  }
+  if (schema.minLength !== void 0 && fitted.length < schema.minLength) {
+    fitted = fitted.padEnd(schema.minLength, "x");
+  }
+  return fitted;
+}
+function isFreeTextString(schema) {
+  return schema?.type === "string" && schema.enum === void 0 && schema.const === void 0 && schema.default === void 0 && schema.pattern === void 0 && schema.format === void 0;
+}
+function acceptsNumber(schema, value) {
+  if (schema.const !== void 0) return schema.const === value;
+  if (schema.enum !== void 0) return schema.enum.includes(value);
+  if (schema.minimum !== void 0 && value < schema.minimum) return false;
+  if (schema.maximum !== void 0 && value > schema.maximum) return false;
+  return true;
+}
+function pickNumber(schema, preferred) {
+  const accepted = preferred.find((value) => acceptsNumber(schema, value));
+  if (accepted !== void 0) return accepted;
+  const named = [schema.const, schema.enum?.[0], schema.minimum, schema.maximum].find(
+    (value) => typeof value === "number" && acceptsNumber(schema, value)
+  );
+  return named;
+}
+function formatInlineArgs(args) {
+  const entries = Object.entries(args).map(([key, value]) => {
+    const name = /^[A-Za-z_$][\w$]*$/.test(key) ? key : JSON.stringify(key);
+    const plain = typeof value === "string" && [...value].every((ch) => ch !== "'" && ch !== "\\" && ch >= " ");
+    const literal = plain ? `'${value}'` : JSON.stringify(value);
+    return `${name}: ${literal}`;
+  });
+  return entries.length > 0 ? `{ ${entries.join(", ")} }` : "{}";
+}
 function getSampleValue(schema, key) {
   if (schema.default !== void 0) {
     return schema.default;
@@ -2701,11 +2855,11 @@ function getSampleValue(schema, key) {
   const type = Array.isArray(schema.type) ? schema.type[0] : schema.type;
   switch (type) {
     case "string":
-      if (key.toLowerCase().includes("id")) return "abc123";
-      if (key.toLowerCase().includes("email")) return "user@example.com";
-      if (key.toLowerCase().includes("name")) return "Example";
-      if (key.toLowerCase().includes("url")) return "https://example.com";
-      return "string";
+      if (key.toLowerCase().includes("id")) return fitString(schema, "abc123");
+      if (key.toLowerCase().includes("email")) return fitString(schema, "user@example.com");
+      if (key.toLowerCase().includes("name")) return fitString(schema, "Example");
+      if (key.toLowerCase().includes("url")) return fitString(schema, "https://example.com");
+      return fitString(schema, "string");
     case "number":
     case "integer":
       if (key.toLowerCase().includes("limit")) return 10;
@@ -2722,24 +2876,88 @@ function getSampleValue(schema, key) {
       return null;
   }
 }
+var PAGINATION_PROPERTIES = ["limit", "offset", "page", "pagesize", "cursor"];
+function isPaginationProperty(name) {
+  return PAGINATION_PROPERTIES.includes(name.toLowerCase());
+}
 function hasPaginationParams(schema) {
   if (!schema || schema.type !== "object" || !schema.properties) {
     return false;
   }
-  const props = Object.keys(schema.properties);
-  return props.some((p) => ["limit", "offset", "page", "pageSize", "cursor"].includes(p.toLowerCase()));
+  return Object.keys(schema.properties).some(isPaginationProperty);
 }
-function generatePaginationExample(toolName) {
-  return {
-    description: `Pagination example for ${toolName}`,
-    code: `// Fetch first page
-const page1 = await callTool('${toolName}', { limit: 10, offset: 0 });
+function inputProperties(schema) {
+  if (!schema || schema.type !== "object" || !schema.properties) {
+    return {};
+  }
+  const properties = {};
+  for (const [key, propSchema] of Object.entries(schema.properties)) {
+    if (typeof propSchema !== "boolean") properties[key] = propSchema;
+  }
+  return properties;
+}
+function buildExampleArgs(schema, keys, values = {}) {
+  const properties = inputProperties(schema);
+  const args = {};
+  for (const key of [...keys, ...schema?.required ?? []]) {
+    const propSchema = properties[key];
+    if (!propSchema || key in args) continue;
+    args[key] = key in values ? values[key] : getSampleValue(propSchema, key);
+  }
+  return args;
+}
+function formatExampleArgs(args) {
+  return Object.keys(args).length > 0 ? JSON.stringify(args, null, 2) : "{}";
+}
+function getFilterProperties(schema) {
+  if (!schema || schema.type !== "object" || !schema.properties) {
+    return [];
+  }
+  return Object.keys(schema.properties).filter(
+    (p) => p.toLowerCase().includes("filter") || p.toLowerCase().includes("query") || p.toLowerCase().includes("search") || p.toLowerCase() === "status" || p.toLowerCase() === "type" || p.toLowerCase() === "role"
+  );
+}
+function generatePaginationExample(toolName, inputSchema) {
+  const description = `Pagination example for ${toolName}`;
+  const props = Object.keys(inputProperties(inputSchema));
+  const limitKey = props.find((p) => p.toLowerCase() === "limit");
+  const offsetKey = props.find((p) => p.toLowerCase() === "offset");
+  if (limitKey && offsetKey) {
+    const properties = inputProperties(inputSchema);
+    const limit = pickNumber(properties[limitKey], [10]);
+    const firstOffset = pickNumber(properties[offsetKey], [0]);
+    const values = {};
+    if (limit !== void 0) values[limitKey] = limit;
+    if (firstOffset !== void 0) values[offsetKey] = firstOffset;
+    const firstPage = buildExampleArgs(inputSchema, [limitKey, offsetKey], values);
+    const nextOffset = [limit ?? 10, 10, 20, ...properties[offsetKey].enum ?? []].find(
+      (value) => typeof value === "number" && value !== firstPage[offsetKey] && acceptsNumber(properties[offsetKey], value)
+    );
+    if (nextOffset !== void 0) {
+      const secondPage = { ...firstPage, [offsetKey]: nextOffset };
+      return {
+        description,
+        code: `// Fetch first page
+const page1 = await callTool('${toolName}', ${formatExampleArgs(firstPage)});
 
 // Fetch second page
-const page2 = await callTool('${toolName}', { limit: 10, offset: 10 });
+const page2 = await callTool('${toolName}', ${formatExampleArgs(secondPage)});
 
 // Combine results
 return [...page1.items, ...page2.items];`
+      };
+    }
+    return {
+      description,
+      code: `const page = await callTool('${toolName}', ${formatExampleArgs(firstPage)});
+return page.items || page;`
+    };
+  }
+  const args = buildExampleArgs(inputSchema, props.filter(isPaginationProperty));
+  return {
+    description,
+    code: `const page = await callTool('${toolName}', ${formatExampleArgs(args)});
+return page.items || page;`
   };
 }
 function extractEntityName(toolName) {
@@ -2757,13 +2975,18 @@ function generateCreateExample(toolName, inputSchema) {
 return result;`
   };
 }
+function idArgs(schema, idParam) {
+  const idSchema = inputProperties(schema)[idParam];
+  const values = isFreeTextString(idSchema) ? { [idParam]: fitString(idSchema, "abc123") } : {};
+  return buildExampleArgs(schema, [idParam], values);
+}
 function generateGetExample(toolName, inputSchema) {
   const entity = extractEntityName(toolName);
   const idParam = findIdParameter(inputSchema);
   if (idParam) {
     return {
       description: `Get ${entity} by ${idParam}`,
-      code: `const ${entity} = await callTool('${toolName}', { ${idParam}: 'abc123' });
+      code: `const ${entity} = await callTool('${toolName}', ${formatInlineArgs(idArgs(inputSchema, idParam))});
 return ${entity};`
     };
   }
@@ -2779,7 +3002,7 @@ function generateListExample(toolName, inputSchema) {
   const entity = extractEntityName(toolName);
   return {
     description: `List all ${entity}s`,
-    code: `const result = await callTool('${toolName}', {});
+    code: `const result = await callTool('${toolName}', ${formatExampleArgs(buildExampleArgs(inputSchema, []))});
 return result.items || result;`
   };
 }
@@ -2789,10 +3012,11 @@ function generateUpdateExample(toolName, inputSchema) {
   const updateFields = generateUpdateFields(inputSchema);
   const fieldsStr = updateFields ? JSON.stringify(updateFields, null, 2).replace(/\n/g, "\n  ") : "{ /* fields to update */ }";
   if (idParam) {
+    const identifiers = formatInlineArgs(idArgs(inputSchema, idParam)).slice(2, -2);
     return {
       description: `Update ${entity} by ${idParam}`,
       code: `const updated = await callTool('${toolName}', {
-  ${idParam}: 'abc123',
+  ${identifiers},
   ...${fieldsStr}
 });
 return updated;`
@@ -2810,7 +3034,7 @@ function generateDeleteExample(toolName, inputSchema) {
   if (idParam) {
     return {
       description: `Delete ${entity} by ${idParam}`,
-      code: `const result = await callTool('${toolName}', { ${idParam}: 'abc123' });
+      code: `const result = await callTool('${toolName}', ${formatInlineArgs(idArgs(inputSchema, idParam))});
 return result;`
     };
   }
@@ -2824,17 +3048,18 @@ return result;`
 }
 function generateSearchExample(toolName, inputSchema) {
   const entity = extractEntityName(toolName);
-  const queryParam = findQueryParameter(inputSchema);
-  if (queryParam) {
-    return {
-      description: `Search for ${entity}s`,
-      code: `const results = await callTool('${toolName}', { ${queryParam}: 'search term' });
-return results.items || results;`
-    };
-  }
+  const searchParam = findQueryParameter(inputSchema) ?? getFilterProperties(inputSchema)[0];
+  const searchSchema = searchParam ? inputProperties(inputSchema)[searchParam] : void 0;
+  const required = new Set(inputSchema?.required ?? []);
+  const unfillable = searchSchema?.type === "string" && (searchSchema.pattern !== void 0 || searchSchema.format !== void 0) && searchSchema.enum === void 0 && searchSchema.const === void 0 && searchSchema.default === void 0 && !required.has(searchParam ?? "");
+  const args = searchParam && !unfillable ? buildExampleArgs(
+    inputSchema,
+    [searchParam],
+    isFreeTextString(searchSchema) && searchSchema ? { [searchParam]: fitString(searchSchema, "search term") } : {}
+  ) : buildExampleArgs(inputSchema, []);
   return {
     description: `Search for ${entity}s`,
-    code: `const results = await callTool('${toolName}', { query: 'search term' });
+    code: `const results = await callTool('${toolName}', ${formatExampleArgs(args)});
 return results.items || results;`
   };
 }
@@ -2891,7 +3116,7 @@ function generateSmartExample(toolName, inputSchema, description) {
     case "get":
       return generateGetExample(toolName, inputSchema);
     case "list":
-      return hasPaginationParams(inputSchema) ? generatePaginationExample(toolName) : generateListExample(toolName, inputSchema);
+      return hasPaginationParams(inputSchema) ? generatePaginationExample(toolName, inputSchema) : generateListExample(toolName, inputSchema);
     case "update":
       return generateUpdateExample(toolName, inputSchema);
     case "delete":
@@ -3119,7 +3344,9 @@ var DescribeTool = class extends import_sdk7.ToolContext {
    *
    * Priority:
    * 1. User-provided examples from @Tool decorator metadata (up to 5)
-   * 2. Smart intent-based generation to fill remaining slots
+   * 2. Without any, one smart intent-based example built from the input schema. It is never added
+   *    next to the tool's own examples: those show how the tool is called, and a generated one
+   *    only guesses (#647).
    * 3. Returns at least 1 example
    */
   generateExamples(tool, inputSchema) {
@@ -3134,7 +3361,7 @@ return result;`
         });
       }
     }
-    if (result.length < 5) {
+    if (result.length === 0) {
       result.push(generateSmartExample(tool.name, inputSchema, tool.metadata?.description));
     }
     return result.slice(0, 5);
@@ -3223,7 +3450,11 @@ var runtimeErrorPayloadSchema = import_lazy_zod7.z.object({
 var toolErrorPayloadSchema = import_lazy_zod7.z.object({
   source: import_lazy_zod7.z.literal("tool"),
   toolName: import_lazy_zod7.z.string(),
-  toolInput: import_lazy_zod7.z.unknown(),
+  /**
+   * @deprecated Never set: the sandbox resolves sidecar references in a call's arguments before
+   * the tool sees them, so they may hold data the script itself never had.
+   */
+  toolInput: import_lazy_zod7.z.unknown().optional(),
   message: import_lazy_zod7.z.string(),
   code: import_lazy_zod7.z.string().optional(),
   /** @deprecated Never set: the enclave's error data is not sanitized for clients. */
@@ -3470,10 +3701,10 @@ var ExecuteTool = class extends import_sdk8.ToolContext {
             error: {
               source: "tool",
               toolName: error.toolName,
-              toolInput: error.toolInput,
               message: toClientErrorMessage(error.message),
               code: error.code
-              // No `details`: the enclave's error data is not sanitized for clients.
+              // No `details`: the enclave's error data is not sanitized for clients. No `toolInput`:
+              // the arguments the tool saw may hold sidecar-resolved data the script never had.
             }
           };
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontmcp/plugin-codecall",
-  "version": "1.8.4",
+  "version": "1.8.6",
   "description": "CodeCall plugin for FrontMCP - AgentScript-based meta-tools for orchestrating MCP tools",
   "author": "AgentFront <info@agentfront.dev>",
   "license": "Apache-2.0",
@@ -48,14 +48,16 @@
     }
   },
   "dependencies": {
+    "@enclave-vm/ast": "^2.15.3",
     "@enclave-vm/core": "^2.15.3",
-    "@frontmcp/protocol": "1.8.4",
-    "@frontmcp/sdk": "1.8.4",
+    "@frontmcp/protocol": "1.8.6",
+    "@frontmcp/sdk": "1.8.6",
+    "acorn": "^8.15.0",
     "vectoriadb": "^2.3.2"
   },
   "peerDependencies": {
-    "@frontmcp/lazy-zod": "1.8.4",
-    "@frontmcp/plugin-cache": "1.8.4"
+    "@frontmcp/lazy-zod": "1.8.6",
+    "@frontmcp/plugin-cache": "1.8.6"
   },
   "devDependencies": {
     "reflect-metadata": "^0.2.2"

package/services/enclave.service.d.ts

@@ -12,7 +12,6 @@ export interface EnclaveExecutionResult {
         stack?: string;
         code?: string;
         toolName?: string;
-        toolInput?: unknown;
         details?: unknown;
         /** For a script that doesn't parse (`code: 'SYNTAX_ERROR'`): where, in the script's own lines. */
         location?: {

package/services/enclave.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enclave.service.d.ts","sourceRoot":"","sources":["../../src/services/enclave.service.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,qBAAqB,EAA6B,MAAM,oBAAoB,CAAC;AAE3F,OAAO,KAAK,cAAc,MAAM,+BAA+B,CAAC;AAGhE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,kGAAkG;QAClG,QAAQ,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAC5C;;;;;WAKG;QACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAkDD;;;;;;;;GAQG;AACH;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,sBAAsB;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CASpD;AAOD,MAAM,CAAC,OAAO,OAAO,cAAc;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;IACtD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;gBAE5C,MAAM,EAAE,cAAc;IAOlC;;;;;;;OAOG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAwGhG;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAsFzB"}
+{"version":3,"file":"enclave.service.d.ts","sourceRoot":"","sources":["../../src/services/enclave.service.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,qBAAqB,EAA6B,MAAM,oBAAoB,CAAC;AAE3F,OAAO,KAAK,cAAc,MAAM,+BAA+B,CAAC;AAIhE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,kGAAkG;QAClG,QAAQ,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAC5C;;;;;WAKG;QACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAkDD;;;;;;;;GAQG;AACH;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,sBAAsB;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CASpD;AAOD,MAAM,CAAC,OAAO,OAAO,cAAc;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;IACtD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;gBAE5C,MAAM,EAAE,cAAc;IAOlC;;;;;;;OAOG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAwGhG;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAyFzB"}

package/tools/describe.tool.d.ts

@@ -28,7 +28,9 @@ export default class DescribeTool extends ToolContext {
      *
      * Priority:
      * 1. User-provided examples from @Tool decorator metadata (up to 5)
-     * 2. Smart intent-based generation to fill remaining slots
+     * 2. Without any, one smart intent-based example built from the input schema. It is never added
+     *    next to the tool's own examples: those show how the tool is called, and a generated one
+     *    only guesses (#647).
      * 3. Returns at least 1 example
      */
     private generateExamples;

package/tools/describe.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"describe.tool.d.ts","sourceRoot":"","sources":["../../src/tools/describe.tool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,WAAW,EAAkB,MAAM,eAAe,CAAC;AAMlF,OAAO,EAIL,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAuB3B,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,WAAW;IAC7C,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAkEpE;;;;;;;;OAQG;IACH,OAAO,CAAC,cAAc;IAuBtB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAkDpB;;OAEG;IACH,OAAO,CAAC,YAAY;IA6BpB;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;CAyBzB"}
+{"version":3,"file":"describe.tool.d.ts","sourceRoot":"","sources":["../../src/tools/describe.tool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,WAAW,EAAkB,MAAM,eAAe,CAAC;AAMlF,OAAO,EAIL,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAuB3B,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,WAAW;IAC7C,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAkEpE;;;;;;;;OAQG;IACH,OAAO,CAAC,cAAc;IAuBtB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAkDpB;;OAEG;IACH,OAAO,CAAC,YAAY;IA6BpB;;;;;;;;;OASG;IACH,OAAO,CAAC,gBAAgB;CAyBzB"}

package/tools/execute.schema.d.ts

@@ -44,7 +44,7 @@ export declare const codeCallToolErrorResultSchema: import("@frontmcp/lazy-zod")
     error: import("@frontmcp/lazy-zod").ZodObject<{
         source: import("@frontmcp/lazy-zod").ZodLiteral<"tool">;
         toolName: import("@frontmcp/lazy-zod").ZodString;
-        toolInput: import("@frontmcp/lazy-zod").ZodUnknown;
+        toolInput: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodUnknown>;
         message: import("@frontmcp/lazy-zod").ZodString;
         code: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
         details: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodUnknown>;
@@ -91,7 +91,7 @@ export declare const executeToolOutputSchema: import("@frontmcp/lazy-zod").ZodDi
     error: import("@frontmcp/lazy-zod").ZodObject<{
         source: import("@frontmcp/lazy-zod").ZodLiteral<"tool">;
         toolName: import("@frontmcp/lazy-zod").ZodString;
-        toolInput: import("@frontmcp/lazy-zod").ZodUnknown;
+        toolInput: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodUnknown>;
         message: import("@frontmcp/lazy-zod").ZodString;
         code: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
         details: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodUnknown>;

package/tools/execute.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execute.schema.d.ts","sourceRoot":"","sources":["../../src/tools/execute.schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,oBAAoB,CAAC;AAKvC,eAAO,MAAM,sBAAsB,o7BAoBe,CAAC;AAEnD,eAAO,MAAM,sBAAsB;;;CAclC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAC;AA8CnF;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;gCAIjC,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;;;;gCAG1C,CAAC;AAEH,eAAO,MAAM,iCAAiC;;;;;;gCAG5C,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;;;;;;gCAG3C,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;;;;;;;gCAGxC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;gCAGtC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4CAOlC,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AACxF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAC5F,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAC1F,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AACpF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,MAAM,MAAM,qBAAqB,GAC7B,gBAAgB,GAChB,yBAAyB,GACzB,2BAA2B,GAC3B,0BAA0B,GAC1B,uBAAuB,GACvB,qBAAqB,CAAC"}
+{"version":3,"file":"execute.schema.d.ts","sourceRoot":"","sources":["../../src/tools/execute.schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,oBAAoB,CAAC;AAKvC,eAAO,MAAM,sBAAsB,o7BAoBe,CAAC;AAEnD,eAAO,MAAM,sBAAsB;;;CAclC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAC;AAkDnF;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;gCAIjC,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;;;;gCAG1C,CAAC;AAEH,eAAO,MAAM,iCAAiC;;;;;;gCAG5C,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;;;;;;gCAG3C,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;;;;;;;gCAGxC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;gCAGtC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4CAOlC,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AACxF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAC5F,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAC1F,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AACpF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,MAAM,MAAM,qBAAqB,GAC7B,gBAAgB,GAChB,yBAAyB,GACzB,2BAA2B,GAC3B,0BAA0B,GAC1B,uBAAuB,GACvB,qBAAqB,CAAC"}

package/utils/describe.utils.d.ts

@@ -46,13 +46,14 @@ export declare function hasFilterParams(schema?: JsonSchema): boolean;
  */
 export declare function getFilterProperties(schema?: JsonSchema): string[];
 /**
- * Generate a pagination example for a tool.
+ * Generate a pagination example for a tool, paging with the pagination properties its schema
+ * declares (two pages when it takes `limit` and `offset`, one otherwise).
  */
-export declare function generatePaginationExample(toolName: string): ToolUsageExample;
+export declare function generatePaginationExample(toolName: string, inputSchema?: JsonSchema): ToolUsageExample;
 /**
- * Generate a filter example for a tool.
+ * Generate a filter example for a tool, with a value the property's schema accepts.
  */
-export declare function generateFilterExample(toolName: string, filterProp: string): ToolUsageExample;
+export declare function generateFilterExample(toolName: string, filterProp: string, inputSchema?: JsonSchema): ToolUsageExample;
 /**
  * Generate a create example for a tool.
  * Shows required parameters with contextual sample values.
@@ -63,7 +64,8 @@ export declare function generateCreateExample(toolName: string, inputSchema?: Js
  */
 export declare function generateGetExample(toolName: string, inputSchema?: JsonSchema): ToolUsageExample;
 /**
- * Generate a list example for a tool.
+ * Generate a list example for a tool: the required properties, or `{}` when it has none. Tools
+ * that declare pagination properties get `generatePaginationExample` instead.
  */
 export declare function generateListExample(toolName: string, inputSchema?: JsonSchema): ToolUsageExample;
 /**
@@ -76,6 +78,10 @@ export declare function generateUpdateExample(toolName: string, inputSchema?: Js
 export declare function generateDeleteExample(toolName: string, inputSchema?: JsonSchema): ToolUsageExample;
 /**
  * Generate a search example for a tool.
+ *
+ * Searches by the tool's query-like property, else by its first filter property (`status`, `type`,
+ * ...), with the required properties alongside. Never a `query` the schema does not declare: a tool
+ * searched by `status` and `priority` was shown `callTool('<tool>', { query: 'search term' })`.
  */
 export declare function generateSearchExample(toolName: string, inputSchema?: JsonSchema): ToolUsageExample;
 /**

package/utils/describe.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"describe.utils.d.ts","sourceRoot":"","sources":["../../src/utils/describe.utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,mCAAmC;AACnC,KAAK,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAiB3G;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,CAwBnF;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,UAAU,EAAE,YAAY,CAAC,EAAE,UAAU,GAAG,MAAM,CAKnH;AAkFD;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,IAAI,EACrC,SAAS,EAAE,OAAO,GAAG,QAAQ,GAC5B,MAAM,CAkCR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,UAAU,GAAG,gBAAgB,CASjG;AAyED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAOhE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAe5D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,EAAE,CAcjE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAY5E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAM5F;AAgBD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,UAAU,GAAG,gBAAgB,CAUlG;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,UAAU,GAAG,gBAAgB,CAqB/F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,UAAU,GAAG,gBAAgB,CAQhG;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,UAAU,GAAG,gBAAgB,CA0BlG;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,UAAU,GAAG,gBAAgB,CAoBlG;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,UAAU,GAAG,gBAAgB,CAiBlG;AA2ED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,UAAU,EACxB,WAAW,CAAC,EAAE,MAAM,GACnB,gBAAgB,CAuBlB"}
+{"version":3,"file":"describe.utils.d.ts","sourceRoot":"","sources":["../../src/utils/describe.utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,mCAAmC;AACnC,KAAK,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAiB3G;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,CAwBnF;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,UAAU,EAAE,YAAY,CAAC,EAAE,UAAU,GAAG,MAAM,CAKnH;AAkFD;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,IAAI,EACrC,SAAS,EAAE,OAAO,GAAG,QAAQ,GAC5B,MAAM,CAkCR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,UAAU,GAAG,gBAAgB,CASjG;AA+ID;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAMhE;AA0CD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAe5D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,EAAE,CAcjE;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,UAAU,GAAG,gBAAgB,CA+CtG;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,UAAU,GACvB,gBAAgB,CASlB;AAgBD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,UAAU,GAAG,gBAAgB,CAUlG;AAYD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,UAAU,GAAG,gBAAgB,CAqB/F;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,UAAU,GAAG,gBAAgB,CAQhG;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,UAAU,GAAG,gBAAgB,CA2BlG;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,UAAU,GAAG,gBAAgB,CAoBlG;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,UAAU,GAAG,gBAAgB,CA8BlG;AA2ED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,UAAU,EACxB,WAAW,CAAC,EAAE,MAAM,GACnB,gBAAgB,CAuBlB"}

package/utils/script-lines.d.ts

@@ -0,0 +1,14 @@
+/**
+ * A function from a line of the code the enclave validated (for this script) to the script's own
+ * line, or `undefined` for a line that is none of the script's (the wrapper, a line the loop
+ * transform added) or a script that can't be parsed.
+ *
+ * @param script The script as the caller sent it
+ */
+export declare function validatedLineMapper(script: string): (printedLine: number) => number | undefined;
+/**
+ * `message` with the lines its issues name mapped back to the script's own lines. A line that is
+ * none of the script's is dropped rather than left pointing at the wrong line.
+ */
+export declare function withScriptLines(message: string, script: string): string;
+//# sourceMappingURL=script-lines.d.ts.map

package/utils/script-lines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-lines.d.ts","sourceRoot":"","sources":["../../src/utils/script-lines.ts"],"names":[],"mappings":"AA4IA;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAmB/F;AAKD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAOvE"}