@aexhq/tools-mcp 0.3.5 → 0.4.0

package/README.md

@@ -19,10 +19,17 @@ const tools = await mcpTools({
 // await client.close();
 ```
 
-The client SDK owns transport and protocol negotiation. `connectMcp` disables automatic interactive fulfilment; specify the protocol revision your server supports. A connected client can also be supplied directly. The bridge uses a fixed discovered Tool definition on every call, so an SDK cache refresh cannot change the session's schemas or trigger the header-mismatch resend path. Discovery uses the SDK's bounded pagination. Later list changes do not add or replace placed Tools; authorize a new session for changed definitions.
+The client SDK owns transport and protocol negotiation. `connectMcp` disables automatic interactive fulfilment; specify the protocol revision your server supports. For Tool requests it also disables the MCP SDK's independent timer: Brain's original deadline and cancellation signal own invocation lifetime, including unlimited deadlines. Discovery still uses the SDK's normal timeout. A connected client can be supplied directly for finite deadlines of at most 2,147,483,647 ms; use `connectMcp` for longer or unlimited calls. Unsupported timer ranges fail before dispatch instead of shortening the deadline.
+
+The bridge uses a fixed discovered Tool definition on every call, so an SDK cache refresh cannot change the session's schemas or trigger the header-mismatch resend path. Discovery uses the SDK's bounded pagination. Later list changes do not add or replace placed Tools; authorize a new session for changed definitions.
 
 ## Results and failures
 
+The bridge uses Brain SDK 0.28 and explicitly finishes each invocation after committing its
+evidence and normalized result. Return alone does not complete a Brain Tool. A missing deadline
+means no invocation timer; keep the application's host connection and MCP client alive until
+completion or cancellation.
+
 MCP images and embedded image/PDF resources require a caller-supplied
 `publishMedia({ bytes, mediaType, index }, context)` callback on `mcpTools`. Return an HTTPS URL
 reachable by the model provider. `context` supplies the session ID, invocation sequence, deadline

package/dist/index.mjs

@@ -26,8 +26,13 @@ function toolOutput(content, media = []) {
 }
 
 // src/index.mjs
-async function connectMcp(transport, { name = "aex-mcp", version = "0.3.0", ...options } = {}) {
-  const client = new Client({ name, version }, { ...options, inputRequired: { autoFulfill: false } });
+var SignalClient = class extends Client {
+  _setupTimeout(messageId, timeout, ...options) {
+    if (timeout !== Infinity) super._setupTimeout(messageId, timeout, ...options);
+  }
+};
+async function connectMcp(transport, { name = "aex-mcp", version = "0.4.0", ...options } = {}) {
+  const client = new SignalClient({ name, version }, { ...options, inputRequired: { autoFulfill: false } });
   try {
     await client.connect(transport);
   } catch (error) {
@@ -60,11 +65,15 @@ async function mcpTools({ client, names, env, prefix = "", project, publishMedia
       input,
       run: async (arguments_, context) => {
         context.signal.throwIfAborted();
+        const timeout = client instanceof SignalClient ? Infinity : context.deadline === void 0 ? Infinity : Math.max(1, context.deadline.getTime() - Date.now());
+        if (!(client instanceof SignalClient) && timeout > 2147483647) {
+          throw new TypeError("use connectMcp for unlimited or long Tool deadlines; the MCP SDK timer cannot represent them");
+        }
         let response;
         try {
           response = await client.callTool({ name: definition.name, arguments: arguments_ }, {
             signal: context.signal,
-            timeout: Math.max(1, context.deadline.getTime() - Date.now()),
+            timeout,
             toolDefinition: definition,
             allowInputRequired: true
           });
@@ -80,7 +89,7 @@ async function mcpTools({ client, names, env, prefix = "", project, publishMedia
             message,
             details: details.data
           });
-          return outcome;
+          return context.finish(outcome);
         }
         const media = [];
         const content = [];
@@ -98,19 +107,19 @@ async function mcpTools({ client, names, env, prefix = "", project, publishMedia
         } catch (error) {
           if (context.signal.aborted) throw error;
           await context.emit("mcp_media_failed", { tool: definition.name, published: media });
-          return failure("mcp_media_failed", String(error.message), { published: media });
+          return context.finish(failure("mcp_media_failed", String(error.message), { published: media }));
         }
         const retained = { ...response, content, ...media.length ? { media } : {} };
         const evidenceSequence = await context.emit("mcp_result", { tool: definition.name, result: retained });
         if (response.resultType && response.resultType !== "complete") {
-          return failure("mcp_unsupported_result", `MCP ${definition.name} requires unsupported continuation (${response.resultType}); evidence ${evidenceSequence}`, retained);
+          return context.finish(failure("mcp_unsupported_result", `MCP ${definition.name} requires unsupported continuation (${response.resultType}); evidence ${evidenceSequence}`, retained));
         }
         if (response.isError) {
           const message = content.filter((block) => block.type === "text").map((block) => block.text).join("\n");
-          return failure("mcp_tool_error", `MCP ${definition.name}: ${message || "Tool failed"}; evidence ${evidenceSequence}`, retained);
+          return context.finish(failure("mcp_tool_error", `MCP ${definition.name}: ${message || "Tool failed"}; evidence ${evidenceSequence}`, retained));
         }
         const presented = { content, ...response.structuredContent === void 0 ? {} : { structuredContent: response.structuredContent }, evidenceSequence };
-        return toolOutput(project ? await project(presented, definition.name) : presented, media);
+        return context.finish(toolOutput(project ? await project(presented, definition.name) : presented, media));
       }
     })({ env });
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aexhq/tools-mcp",
-  "version": "0.3.5",
+  "version": "0.4.0",
   "description": "Selected MCP Tools in a Brain application host",
   "license": "MIT",
   "type": "module",
@@ -10,6 +10,6 @@
   "exports": { ".": { "types": "./index.d.ts", "import": "./dist/index.mjs" }, "./package.json": "./package.json" },
   "files": ["dist", "index.d.ts", "README.md"],
   "scripts": { "build": "node ../../tools/build-environment.mjs", "test": "npm run build && node --test test/*.test.mjs", "test:journeys": "node --test test/journeys.mjs", "prepack": "npm run build" },
-  "dependencies": { "@aexhq/brain": "0.27.0", "@modelcontextprotocol/client": "2.0.0", "zod": "4.4.3" },
+  "dependencies": { "@aexhq/brain": "0.28.0", "@modelcontextprotocol/client": "2.0.0", "zod": "4.4.3" },
   "devDependencies": { "@modelcontextprotocol/server": "2.0.0" }
 }