@ttoss/http-server-mcp 0.34.0 → 0.34.1

package/README.md

@@ -484,14 +484,14 @@ 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, 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 (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.
 
 Pass options instead of `true` to tune it:
 
 - `except` — tools kept standalone, not deferred; they stay reachable through `search` too. Defaults to those linked to an [MCP Apps](#mcp-apps-interactive-uis) view, since a host finds a view through the tool's own `tools/list` entry.
 - `visible` — runs on every `search`, `describe` and `call`; a tool it rejects is absent from all three. Standalone tools stay listed.
 - `search` — replaces the default ranking, `rankTools`, e.g. with embeddings.
-- `searchLimit` (default `10`) and `names` (default `search` / `describe` / `call`).
+- `searchLimit` (default `10`), `searchMaxLimit` — the largest `limit` accepted (default `50`, or `searchLimit` when higher) — and `names` (default `search` / `describe` / `call`).
 
 A gate (below) sees each call with the tool's own name and arguments, so authorization stays per tool when deferred.
 

package/dist/index.cjs

@@ -507,6 +507,7 @@ 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`;
@@ -573,23 +574,29 @@ var scoreOf = ({
   }
   return score;
 };
+var withTag = ({
+  tag,
+  tools
+}) => {
+  return tag === void 0 ? tools : tools.filter(tool => {
+    return tool.tags?.includes(tag) ?? false;
+  });
+};
 /**
-* The deferred tools' default search: scores each tool by the query's terms,
-* weighted name > summary > tags > description, and breaks ties by the
-* tools' order. No index — a few hundred tools need none.
+* The tools `query` matches, best first, ties in the tools' order; `undefined`
+* when the query has no words.
 */
-var rankTools = ({
+var scoreTools = ({
   query,
   tag,
-  limit,
   tools
 }) => {
-  const candidates = tag === void 0 ? tools : tools.filter(tool => {
-    return tool.tags?.includes(tag) ?? false;
-  });
   const terms = [...new Set(termsOf(query))];
-  if (terms.length === 0) return candidates.slice(0, limit);
-  return candidates.map((tool, index) => {
+  if (terms.length === 0) return void 0;
+  return withTag({
+    tag,
+    tools
+  }).map((tool, index) => {
     return {
       tool,
       index,
@@ -604,7 +611,29 @@ var rankTools = ({
     return score > 0;
   }).sort((a, b) => {
     return b.score - a.score || a.index - b.index;
-  }).slice(0, limit).map(({
+  });
+};
+/**
+* The deferred tools' default search: scores each tool by the query's terms,
+* weighted name > summary > tags > description, and breaks ties by the
+* tools' order. No index — a few hundred tools need none.
+*/
+var rankTools = ({
+  query,
+  tag,
+  limit,
+  tools
+}) => {
+  const scored = scoreTools({
+    query,
+    tag,
+    tools
+  });
+  if (!scored) return withTag({
+    tag,
+    tools
+  }).slice(0, limit);
+  return scored.slice(0, limit).map(({
     tool
   }) => {
     return tool;
@@ -651,11 +680,16 @@ var suggestionsFor = ({
   }).map(candidate => {
     return candidate.name;
   });
-  const related = rankTools({
+  const related = (scoreTools({
     query: name,
-    limit: SUGGESTION_COUNT,
     tools
-  }).map(tool => {
+  }) ?? []).filter(({
+    score
+  }) => {
+    return score >= MIN_RELATED_SCORE;
+  }).slice(0, SUGGESTION_COUNT).map(({
+    tool
+  }) => {
     return tool.name;
   });
   return [...new Set([...nearMisses, ...related])].slice(0, SUGGESTION_COUNT);
@@ -664,6 +698,7 @@ var suggestionsFor = ({
 //#endregion
 //#region src/deferTools.ts
 var DEFAULT_SEARCH_LIMIT = 10;
+var DEFAULT_SEARCH_MAX_LIMIT = 50;
 var jsonResult = ({
   data,
   isError = false
@@ -708,6 +743,7 @@ var deferredToolsOf = ({
       tool
     }) : true;
   };
+  const searchLimit = options.searchLimit ?? DEFAULT_SEARCH_LIMIT;
   return {
     names: {
       search: "search",
@@ -716,7 +752,8 @@ var deferredToolsOf = ({
       ...options.names
     },
     tools,
-    searchLimit: options.searchLimit ?? DEFAULT_SEARCH_LIMIT,
+    searchLimit,
+    searchMaxLimit: options.searchMaxLimit ?? Math.max(DEFAULT_SEARCH_MAX_LIMIT, searchLimit),
     searchTools: options.search ?? rankTools,
     visibleTools: () => {
       return tools.filter(isVisible);
@@ -731,6 +768,7 @@ var searchToolOf = ({
   names,
   tools,
   searchLimit,
+  searchMaxLimit,
   searchTools,
   visibleTools
 }) => {
@@ -745,7 +783,7 @@ var searchToolOf = ({
       properties: {
         query: {
           type: "string",
-          description: "Words describing the action, e.g. \"create agent\". Empty lists every tool."
+          description: "Words describing the action, e.g. \"create agent\". Empty lists the tools in order."
         },
         tag: {
           type: "string",
@@ -757,6 +795,7 @@ var searchToolOf = ({
         limit: {
           type: "integer",
           minimum: 1,
+          maximum: searchMaxLimit,
           description: `Maximum number of results. Defaults to ${searchLimit}.`
         }
       },

package/dist/index.d.cts

@@ -865,6 +865,12 @@ interface DeferToolsOptions {
    * @default 10
    */
   searchLimit?: number;
+  /**
+   * The largest `limit` `search` accepts. With no ceiling, an empty query
+   * lists every tool, more than a client's context holds.
+   * @default 50, or `searchLimit` when that is higher
+   */
+  searchMaxLimit?: number;
   /**
    * Runs on every `search`, `describe` and `call`. A tool it rejects is
    * absent from all three; `call` answers it as an unknown name. Tools

package/dist/index.d.mts

@@ -866,6 +866,12 @@ interface DeferToolsOptions {
    * @default 10
    */
   searchLimit?: number;
+  /**
+   * The largest `limit` `search` accepts. With no ceiling, an empty query
+   * lists every tool, more than a client's context holds.
+   * @default 50, or `searchLimit` when that is higher
+   */
+  searchMaxLimit?: number;
   /**
    * Runs on every `search`, `describe` and `call`. A tool it rejects is
    * absent from all three; `call` answers it as an unknown name. Tools

package/dist/index.mjs

@@ -504,6 +504,7 @@ 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`;
@@ -570,23 +571,29 @@ var scoreOf = ({
   }
   return score;
 };
+var withTag = ({
+  tag,
+  tools
+}) => {
+  return tag === void 0 ? tools : tools.filter(tool => {
+    return tool.tags?.includes(tag) ?? false;
+  });
+};
 /**
-* The deferred tools' default search: scores each tool by the query's terms,
-* weighted name > summary > tags > description, and breaks ties by the
-* tools' order. No index — a few hundred tools need none.
+* The tools `query` matches, best first, ties in the tools' order; `undefined`
+* when the query has no words.
 */
-var rankTools = ({
+var scoreTools = ({
   query,
   tag,
-  limit,
   tools
 }) => {
-  const candidates = tag === void 0 ? tools : tools.filter(tool => {
-    return tool.tags?.includes(tag) ?? false;
-  });
   const terms = [...new Set(termsOf(query))];
-  if (terms.length === 0) return candidates.slice(0, limit);
-  return candidates.map((tool, index) => {
+  if (terms.length === 0) return void 0;
+  return withTag({
+    tag,
+    tools
+  }).map((tool, index) => {
     return {
       tool,
       index,
@@ -601,7 +608,29 @@ var rankTools = ({
     return score > 0;
   }).sort((a, b) => {
     return b.score - a.score || a.index - b.index;
-  }).slice(0, limit).map(({
+  });
+};
+/**
+* The deferred tools' default search: scores each tool by the query's terms,
+* weighted name > summary > tags > description, and breaks ties by the
+* tools' order. No index — a few hundred tools need none.
+*/
+var rankTools = ({
+  query,
+  tag,
+  limit,
+  tools
+}) => {
+  const scored = scoreTools({
+    query,
+    tag,
+    tools
+  });
+  if (!scored) return withTag({
+    tag,
+    tools
+  }).slice(0, limit);
+  return scored.slice(0, limit).map(({
     tool
   }) => {
     return tool;
@@ -648,11 +677,16 @@ var suggestionsFor = ({
   }).map(candidate => {
     return candidate.name;
   });
-  const related = rankTools({
+  const related = (scoreTools({
     query: name,
-    limit: SUGGESTION_COUNT,
     tools
-  }).map(tool => {
+  }) ?? []).filter(({
+    score
+  }) => {
+    return score >= MIN_RELATED_SCORE;
+  }).slice(0, SUGGESTION_COUNT).map(({
+    tool
+  }) => {
     return tool.name;
   });
   return [...new Set([...nearMisses, ...related])].slice(0, SUGGESTION_COUNT);
@@ -661,6 +695,7 @@ var suggestionsFor = ({
 //#endregion
 //#region src/deferTools.ts
 var DEFAULT_SEARCH_LIMIT = 10;
+var DEFAULT_SEARCH_MAX_LIMIT = 50;
 var jsonResult = ({
   data,
   isError = false
@@ -705,6 +740,7 @@ var deferredToolsOf = ({
       tool
     }) : true;
   };
+  const searchLimit = options.searchLimit ?? DEFAULT_SEARCH_LIMIT;
   return {
     names: {
       search: "search",
@@ -713,7 +749,8 @@ var deferredToolsOf = ({
       ...options.names
     },
     tools,
-    searchLimit: options.searchLimit ?? DEFAULT_SEARCH_LIMIT,
+    searchLimit,
+    searchMaxLimit: options.searchMaxLimit ?? Math.max(DEFAULT_SEARCH_MAX_LIMIT, searchLimit),
     searchTools: options.search ?? rankTools,
     visibleTools: () => {
       return tools.filter(isVisible);
@@ -728,6 +765,7 @@ var searchToolOf = ({
   names,
   tools,
   searchLimit,
+  searchMaxLimit,
   searchTools,
   visibleTools
 }) => {
@@ -742,7 +780,7 @@ var searchToolOf = ({
       properties: {
         query: {
           type: "string",
-          description: "Words describing the action, e.g. \"create agent\". Empty lists every tool."
+          description: "Words describing the action, e.g. \"create agent\". Empty lists the tools in order."
         },
         tag: {
           type: "string",
@@ -754,6 +792,7 @@ var searchToolOf = ({
         limit: {
           type: "integer",
           minimum: 1,
+          maximum: searchMaxLimit,
           description: `Maximum number of results. Defaults to ${searchLimit}.`
         }
       },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttoss/http-server-mcp",
-  "version": "0.34.0",
+  "version": "0.34.1",
   "description": "Model Context Protocol (MCP) server integration for @ttoss/http-server",
   "keywords": [
     "ai",
@@ -39,8 +39,8 @@
     "zod": "^4.4.3",
     "@ttoss/auth-core": "^0.16.1",
     "@ttoss/http-server": "^0.11.1",
-    "@ttoss/http-server-auth": "^0.8.1",
-    "@ttoss/i18n-core": "^0.7.0"
+    "@ttoss/i18n-core": "^0.7.0",
+    "@ttoss/http-server-auth": "^0.8.1"
   },
   "devDependencies": {
     "@modelcontextprotocol/client": "^2.0.0",