@frontmcp/plugin-codecall 1.8.5 → 1.8.7

package/esm/index.mjs

@@ -2768,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;
@@ -2781,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;
@@ -2802,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) {
@@ -2837,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};`
     };
   }
@@ -2859,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;`
   };
 }
@@ -2869,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;`
@@ -2890,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;`
     };
   }
@@ -2904,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;`
   };
 }
@@ -2971,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":
@@ -3199,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) {
@@ -3214,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);

package/esm/package.json

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

package/index.js

@@ -2805,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;
@@ -2818,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;
@@ -2839,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) {
@@ -2874,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};`
     };
   }
@@ -2896,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;`
   };
 }
@@ -2906,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;`
@@ -2927,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;`
     };
   }
@@ -2941,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;`
   };
 }
@@ -3008,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":
@@ -3236,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) {
@@ -3251,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);

package/package.json

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

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/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"}