@ttoss/http-server-mcp 0.34.1 → 0.34.2

package/README.md

@@ -484,7 +484,7 @@ registerTools({ server: fullServer, tools });
 registerTools({ server: deferredServer, tools, defer: true });
 ```
 
-A schema enters the model's context only for the tools it is about to use. `call` enforces the tool's schema as a direct call would, and its errors help the model recover: an unknown name answers suggestions (near-miss names, then tools the name's words match; a lone prefix in a description is not enough), and invalid arguments, a tool's own error result, or a thrown error carry the input schema, so a `call` made without `describe` corrects itself in one retry.
+A schema enters the model's context only for the tools it is about to use. `call` enforces the tool's schema as a direct call would, and its errors help the model recover: an unknown name answers suggestions (close typos first, then near-misses and tools sharing the name's words, by how much they share), and invalid arguments, a tool's own error result, or a thrown error carry the input schema, so a `call` made without `describe` corrects itself in one retry.
 
 Pass options instead of `true` to tune it:
 

package/dist/index.cjs

@@ -507,7 +507,6 @@ var defineTool = ({
 //#region src/toolSearch.ts
 var SUMMARY_MAX_LENGTH = 160;
 var SUGGESTION_COUNT = 3;
-var MIN_RELATED_SCORE = 1;
 /** Plural and singular forms rank alike: `agents` finds `get-agent`. */
 var stem = term => {
   if (term.length > 4 && term.endsWith("ies")) return `${term.slice(0, -3)}y`;
@@ -660,39 +659,47 @@ var editDistance = (a, b) => {
   }
   return row[b.length];
 };
-/** Names a model probably meant: near-misses first, then related tools. */
+/**
+* Names a model probably meant: close typos first, nearest first; then the
+* near-misses and the tools sharing the name's words, by word score, so a tool
+* holding every word outranks a distant near-miss.
+*/
 var suggestionsFor = ({
   name,
   tools
 }) => {
   const tolerance = Math.max(2, Math.floor(name.length / 3));
-  const nearMisses = tools.map(tool => {
+  const scores = new Map((scoreTools({
+    query: name,
+    tools
+  }) ?? []).map(({
+    tool,
+    score
+  }) => {
+    return [tool, score];
+  }));
+  const rankOf = distance => {
+    return Math.min(distance, 3);
+  };
+  return tools.map((tool, index) => {
     return {
-      name: tool.name,
-      distance: editDistance(name, tool.name)
+      tool,
+      index,
+      distance: editDistance(name, tool.name),
+      score: scores.get(tool) ?? 0
     };
   }).filter(({
-    distance
-  }) => {
-    return distance <= tolerance;
-  }).sort((a, b) => {
-    return a.distance - b.distance;
-  }).map(candidate => {
-    return candidate.name;
-  });
-  const related = (scoreTools({
-    query: name,
-    tools
-  }) ?? []).filter(({
+    distance,
     score
   }) => {
-    return score >= MIN_RELATED_SCORE;
+    return distance <= tolerance || score > 0;
+  }).sort((a, b) => {
+    return rankOf(a.distance) - rankOf(b.distance) || b.score - a.score || a.distance - b.distance || a.index - b.index;
   }).slice(0, SUGGESTION_COUNT).map(({
     tool
   }) => {
     return tool.name;
   });
-  return [...new Set([...nearMisses, ...related])].slice(0, SUGGESTION_COUNT);
 };
 
 //#endregion

package/dist/index.mjs

@@ -504,7 +504,6 @@ var defineTool = ({
 //#region src/toolSearch.ts
 var SUMMARY_MAX_LENGTH = 160;
 var SUGGESTION_COUNT = 3;
-var MIN_RELATED_SCORE = 1;
 /** Plural and singular forms rank alike: `agents` finds `get-agent`. */
 var stem = term => {
   if (term.length > 4 && term.endsWith("ies")) return `${term.slice(0, -3)}y`;
@@ -657,39 +656,47 @@ var editDistance = (a, b) => {
   }
   return row[b.length];
 };
-/** Names a model probably meant: near-misses first, then related tools. */
+/**
+* Names a model probably meant: close typos first, nearest first; then the
+* near-misses and the tools sharing the name's words, by word score, so a tool
+* holding every word outranks a distant near-miss.
+*/
 var suggestionsFor = ({
   name,
   tools
 }) => {
   const tolerance = Math.max(2, Math.floor(name.length / 3));
-  const nearMisses = tools.map(tool => {
+  const scores = new Map((scoreTools({
+    query: name,
+    tools
+  }) ?? []).map(({
+    tool,
+    score
+  }) => {
+    return [tool, score];
+  }));
+  const rankOf = distance => {
+    return Math.min(distance, 3);
+  };
+  return tools.map((tool, index) => {
     return {
-      name: tool.name,
-      distance: editDistance(name, tool.name)
+      tool,
+      index,
+      distance: editDistance(name, tool.name),
+      score: scores.get(tool) ?? 0
     };
   }).filter(({
-    distance
-  }) => {
-    return distance <= tolerance;
-  }).sort((a, b) => {
-    return a.distance - b.distance;
-  }).map(candidate => {
-    return candidate.name;
-  });
-  const related = (scoreTools({
-    query: name,
-    tools
-  }) ?? []).filter(({
+    distance,
     score
   }) => {
-    return score >= MIN_RELATED_SCORE;
+    return distance <= tolerance || score > 0;
+  }).sort((a, b) => {
+    return rankOf(a.distance) - rankOf(b.distance) || b.score - a.score || a.distance - b.distance || a.index - b.index;
   }).slice(0, SUGGESTION_COUNT).map(({
     tool
   }) => {
     return tool.name;
   });
-  return [...new Set([...nearMisses, ...related])].slice(0, SUGGESTION_COUNT);
 };
 
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttoss/http-server-mcp",
-  "version": "0.34.1",
+  "version": "0.34.2",
   "description": "Model Context Protocol (MCP) server integration for @ttoss/http-server",
   "keywords": [
     "ai",