@tomradex/mcp 0.18.0 → 0.20.0

package/dist/index.d.ts

@@ -45,6 +45,8 @@ export interface PortClash {
     port: number;
     /** The Tomrade holding it, when it answered; null for anything else. */
     heldBy: InstanceBadge | null;
+    /** Windows keeps it in a reserved range (Hyper-V, WSL, Docker): nothing holds it, nothing can listen there. */
+    reserved?: true;
 }
 interface SyncSummaryLike {
     state: string;
@@ -129,7 +131,13 @@ export declare class Mcp extends Service implements McpReader {
     /** Captured from the injected context: HTTP callbacks run after Cordis's injection frame has closed. */
     private tools;
     private bindings;
+    /** Hear a tokenless hook; the first answer with anything in it goes back to the agent. */
     private eventListeners;
+    /**
+     * Where each outside client's connection runs, from the headers its first request carried: an agent's MCP
+     * config can name the herdr pane it was started in, so its claim lands on that pane without hooks.
+     */
+    private places;
     private prompts;
     private instructions;
     constructor(ctx: Context, config: McpConfig);
@@ -148,8 +156,8 @@ export declare class Mcp extends Service implements McpReader {
     eventUrlFor(token: string): string | null;
     /** Where hooks with no token post — the ones a repository commits for every developer. */
     get eventUrl(): string | null;
-    /** Hear tokenless hook events. Reversible: the listener goes with the plugin that registered it. */
-    onEvent(listener: (payload: unknown) => void): () => void;
+    /** Hear tokenless hook events, and answer them (the first answer with anything in it is the agent's). Reversible: the listener goes with the plugin that registered it. */
+    onEvent(listener: (payload: unknown) => unknown): () => void;
     /** Offer a prompt to every session opened from now on. Reversible with the plugin that registered it. */
     prompt(prompt: McpPrompt): () => void;
     /**

package/dist/words.d.ts

@@ -1,7 +1,9 @@
 export declare const MCP_WORDS: import("@tomradex/domain").WordBook<{
     readonly portClash: "MCP on {{port}} · {{clashPort}} held by {{holder}}";
     readonly portClashTitle: "Agents configured for the usual port reach the other Tomrade and its data, not this one. Quit the other, or give this instance its own port with TOMRADE_MCP_PORT.";
+    readonly portReservedTitle: "Windows reserves this port (Hyper-V, WSL or Docker), so agents configured for it cannot reach this Tomrade. Give this instance a port outside the reserved ranges with TOMRADE_MCP_PORT.";
     readonly holderUnknown: "another program";
+    readonly holderReserved: "a range Windows reserves";
     readonly holderPackaged: "the installed Tomrade";
     readonly holderDev: "a development Tomrade";
     readonly holder: "{{kind}} {{version}} (pid {{pid}})";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomradex/mcp",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "type": "module",
   "author": "Haoyuan Tang",
   "engines": {
@@ -27,11 +27,11 @@
     "dist"
   ],
   "dependencies": {
-    "@tomradex/contracts": "0.18.0",
-    "@tomradex/contributions": "0.18.0",
-    "@tomradex/domain": "0.2.26",
-    "@tomradex/ipc": "0.18.0",
-    "@tomradex/tools": "0.18.0",
+    "@tomradex/contracts": "0.20.0",
+    "@tomradex/contributions": "0.20.0",
+    "@tomradex/domain": "0.2.28",
+    "@tomradex/ipc": "0.20.0",
+    "@tomradex/tools": "0.20.0",
     "cordis": "4.0.0-rc.8",
     "zod": "^4.4.3"
   },