@ttoss/http-server-mcp 0.41.0 → 0.43.0

package/README.md

@@ -484,13 +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 (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.
+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 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.
+- `schemaOnError` (default `'invalidArguments'`) — which failed calls carry the input schema. By default only arguments that fail it do: a tool's own error result or a thrown error is usually a refusal of the operation (a 404, a 409), and a large schema on every refusal costs more context than deferring saved. `'always'` attaches it to those too, for tools that do not validate their arguments and whose errors may be argument errors only the API detects.
 - `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

@@ -997,6 +997,7 @@ var deferredToolsOf = ({
     tools,
     searchLimit,
     searchMaxLimit: options.searchMaxLimit ?? Math.max(DEFAULT_SEARCH_MAX_LIMIT, searchLimit),
+    schemaOnError: options.schemaOnError ?? "invalidArguments",
     searchTools: options.search ?? rankTools,
     visibleTools: () => {
       return tools.filter(isVisible);
@@ -1140,7 +1141,8 @@ var describeToolOf = ({
 /** Runs one tool the way a direct call would, with errors that help a retry. */
 var runTool = async ({
   tool,
-  args
+  args,
+  schemaOnError
 }) => {
   const schemas = resolveToolSchemas(tool);
   const validated = await schemas.input["~standard"].validate(args);
@@ -1152,24 +1154,24 @@ var runTool = async ({
     },
     isError: true
   });
-  const schemaHint = {
+  const schemaHint = schemaOnError === "always" ? [{
     type: "text",
     text: JSON.stringify({
       inputSchema: schemas.inputJson
     })
-  };
+  }] : [];
   try {
     const result = await tool.handler(validated.value);
     return result.isError ? {
       ...result,
-      content: [...result.content, schemaHint]
+      content: [...result.content, ...schemaHint]
     } : result;
   } catch (error) {
     return {
       content: [{
         type: "text",
         text: errorMessageOf(error)
-      }, schemaHint],
+      }, ...schemaHint],
       isError: true
     };
   }
@@ -1177,7 +1179,8 @@ var runTool = async ({
 var callToolOf = ({
   names,
   find,
-  visibleTools
+  visibleTools,
+  schemaOnError
 }) => {
   return {
     name: names.call,
@@ -1212,7 +1215,8 @@ var callToolOf = ({
       });
       return runTool({
         tool,
-        args: args.arguments ?? {}
+        args: args.arguments ?? {},
+        schemaOnError
       });
     }
   };

package/dist/index.d.cts

@@ -861,6 +861,20 @@ interface DeferToolsOptions {
    * @default 50, or `searchLimit` when that is higher
    */
   searchMaxLimit?: number;
+  /**
+   * Which failed `call`s carry the tool's input schema.
+   *
+   * - `'invalidArguments'` — only arguments that fail the tool's schema, so a
+   *   `call` made without `describe` corrects itself in one retry. A tool's
+   *   own error result or a thrown error is usually a refusal of the
+   *   operation (a 404, a 409), and a large schema on every refusal costs
+   *   more context than deferring saved.
+   * - `'always'` — those carry it too. For tools that do not validate their
+   *   arguments, whose errors may be argument errors only the API detects.
+   *
+   * @default 'invalidArguments'
+   */
+  schemaOnError?: 'always' | 'invalidArguments';
   /**
    * 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

@@ -862,6 +862,20 @@ interface DeferToolsOptions {
    * @default 50, or `searchLimit` when that is higher
    */
   searchMaxLimit?: number;
+  /**
+   * Which failed `call`s carry the tool's input schema.
+   *
+   * - `'invalidArguments'` — only arguments that fail the tool's schema, so a
+   *   `call` made without `describe` corrects itself in one retry. A tool's
+   *   own error result or a thrown error is usually a refusal of the
+   *   operation (a 404, a 409), and a large schema on every refusal costs
+   *   more context than deferring saved.
+   * - `'always'` — those carry it too. For tools that do not validate their
+   *   arguments, whose errors may be argument errors only the API detects.
+   *
+   * @default 'invalidArguments'
+   */
+  schemaOnError?: 'always' | 'invalidArguments';
   /**
    * 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

@@ -994,6 +994,7 @@ var deferredToolsOf = ({
     tools,
     searchLimit,
     searchMaxLimit: options.searchMaxLimit ?? Math.max(DEFAULT_SEARCH_MAX_LIMIT, searchLimit),
+    schemaOnError: options.schemaOnError ?? "invalidArguments",
     searchTools: options.search ?? rankTools,
     visibleTools: () => {
       return tools.filter(isVisible);
@@ -1137,7 +1138,8 @@ var describeToolOf = ({
 /** Runs one tool the way a direct call would, with errors that help a retry. */
 var runTool = async ({
   tool,
-  args
+  args,
+  schemaOnError
 }) => {
   const schemas = resolveToolSchemas(tool);
   const validated = await schemas.input["~standard"].validate(args);
@@ -1149,24 +1151,24 @@ var runTool = async ({
     },
     isError: true
   });
-  const schemaHint = {
+  const schemaHint = schemaOnError === "always" ? [{
     type: "text",
     text: JSON.stringify({
       inputSchema: schemas.inputJson
     })
-  };
+  }] : [];
   try {
     const result = await tool.handler(validated.value);
     return result.isError ? {
       ...result,
-      content: [...result.content, schemaHint]
+      content: [...result.content, ...schemaHint]
     } : result;
   } catch (error) {
     return {
       content: [{
         type: "text",
         text: errorMessageOf(error)
-      }, schemaHint],
+      }, ...schemaHint],
       isError: true
     };
   }
@@ -1174,7 +1176,8 @@ var runTool = async ({
 var callToolOf = ({
   names,
   find,
-  visibleTools
+  visibleTools,
+  schemaOnError
 }) => {
   return {
     name: names.call,
@@ -1209,7 +1212,8 @@ var callToolOf = ({
       });
       return runTool({
         tool,
-        args: args.arguments ?? {}
+        args: args.arguments ?? {},
+        schemaOnError
       });
     }
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttoss/http-server-mcp",
-  "version": "0.41.0",
+  "version": "0.43.0",
   "description": "Model Context Protocol (MCP) server integration for @ttoss/http-server",
   "keywords": [
     "ai",
@@ -37,10 +37,10 @@
     "@modelcontextprotocol/node": "^2.1.1",
     "@modelcontextprotocol/server": "^2.3.1",
     "zod": "^4.6.7",
-    "@ttoss/http-server": "^0.14.2",
-    "@ttoss/http-server-auth": "^0.10.2",
-    "@ttoss/auth-core": "^0.20.1",
-    "@ttoss/i18n-core": "^0.9.2"
+    "@ttoss/auth-core": "^0.21.0",
+    "@ttoss/http-server": "^0.15.0",
+    "@ttoss/http-server-auth": "^0.11.0",
+    "@ttoss/i18n-core": "^0.10.0"
   },
   "devDependencies": {
     "@modelcontextprotocol/client": "^2.3.1",
@@ -48,7 +48,7 @@
     "jest": "^30.5.2",
     "supertest": "^7.3.1",
     "tsdown": "^0.23.1",
-    "@ttoss/config": "^3.0.0"
+    "@ttoss/config": "^4.0.0"
   },
   "publishConfig": {
     "access": "public",