@crewhaus/mcp-server 0.5.2 → 0.5.4

package/dist/build.d.ts

@@ -33,9 +33,16 @@ export declare function resolveSubAgentTools(subAgents: readonly McpSubAgentDesc
 /** The tool names a projection will register, without building a server. */
 export declare function computeToolNames(opts: CreateMcpServerOptions): readonly string[];
 /** Register the projected tools onto `server`; returns their names in order. */
-export declare function registerAgentTools(server: McpServer, opts: CreateMcpServerOptions): readonly string[];
-/** Mint a fresh SDK server with the projected tools registered. */
-export declare function buildConfiguredServer(opts: CreateMcpServerOptions): {
+export declare function registerAgentTools(server: McpServer, opts: CreateMcpServerOptions, sessionId?: string): readonly string[];
+/**
+ * Mint a fresh SDK server with the projected tools registered.
+ *
+ * `sessionId` is threaded into every {@link McpInvokeContext} this server's
+ * tools build. The SSE path mints one server PER SESSION and passes that
+ * session's id, so a projected bundle can key its own conversation state per
+ * caller; stdio passes nothing (one process, one conversation).
+ */
+export declare function buildConfiguredServer(opts: CreateMcpServerOptions, sessionId?: string): {
     readonly server: McpServer;
     readonly toolNames: readonly string[];
 };

package/dist/build.js

@@ -82,7 +82,7 @@ async function runInvoke(invoke, message, context) {
     }
 }
 /** Register the projected tools onto `server`; returns their names in order. */
-export function registerAgentTools(server, opts) {
+export function registerAgentTools(server, opts, sessionId) {
     const agentName = opts.name ?? DEFAULT_NAME;
     const names = [];
     server.registerTool(CHAT_TOOL_NAME, {
@@ -90,7 +90,10 @@ export function registerAgentTools(server, opts) {
         description: opts.chatToolDescription ??
             `Send a message to the ${agentName} agent and receive its final response.`,
         inputSchema: { message: z.string().describe("The message to send to the agent.") },
-    }, ({ message }) => runInvoke(opts.invoke, message, { toolName: CHAT_TOOL_NAME }));
+    }, ({ message }) => runInvoke(opts.invoke, message, {
+        toolName: CHAT_TOOL_NAME,
+        ...(sessionId !== undefined ? { sessionId } : {}),
+    }));
     names.push(CHAT_TOOL_NAME);
     if (resolveToolsMode(opts.tools) === "per-subagent") {
         for (const tool of resolveSubAgentTools(opts.subAgents ?? [])) {
@@ -100,15 +103,26 @@ export function registerAgentTools(server, opts) {
                 inputSchema: {
                     message: z.string().describe(`The message to route to the ${tool.subAgent} sub-agent.`),
                 },
-            }, ({ message }) => runInvoke(opts.invoke, message, { toolName: tool.toolName, subAgent: tool.subAgent }));
+            }, ({ message }) => runInvoke(opts.invoke, message, {
+                toolName: tool.toolName,
+                subAgent: tool.subAgent,
+                ...(sessionId !== undefined ? { sessionId } : {}),
+            }));
             names.push(tool.toolName);
         }
     }
     return names;
 }
-/** Mint a fresh SDK server with the projected tools registered. */
-export function buildConfiguredServer(opts) {
+/**
+ * Mint a fresh SDK server with the projected tools registered.
+ *
+ * `sessionId` is threaded into every {@link McpInvokeContext} this server's
+ * tools build. The SSE path mints one server PER SESSION and passes that
+ * session's id, so a projected bundle can key its own conversation state per
+ * caller; stdio passes nothing (one process, one conversation).
+ */
+export function buildConfiguredServer(opts, sessionId) {
     const server = new McpServer({ name: opts.name ?? DEFAULT_NAME, version: opts.version ?? DEFAULT_VERSION }, opts.instructions === undefined ? undefined : { instructions: opts.instructions });
-    const toolNames = registerAgentTools(server, opts);
+    const toolNames = registerAgentTools(server, opts, sessionId);
     return { server, toolNames };
 }

package/dist/index.js

@@ -60,9 +60,14 @@ function createSseServer(opts) {
         await session.server.close().catch(() => { });
     };
     const openSession = async (request) => {
-        const { server } = buildConfiguredServer(opts);
+        // The id is minted HERE rather than by the transport's generator so the
+        // per-session server can be built with it: a projected bundle keys its
+        // own conversation state on this, and a server built before the id
+        // existed could only ever hand every caller the same one.
+        const sessionId = randomUUID();
+        const { server } = buildConfiguredServer(opts, sessionId);
         const transport = new WebStandardStreamableHTTPServerTransport({
-            sessionIdGenerator: () => randomUUID(),
+            sessionIdGenerator: () => sessionId,
             onsessioninitialized: (id) => {
                 sessions.set(id, { server, transport });
             },

package/dist/types.d.ts

@@ -49,6 +49,19 @@ export declare const CHAT_TOOL_NAME = "chat";
 export interface McpInvokeContext {
     readonly toolName: string;
     readonly subAgent?: string;
+    /**
+     * The MCP transport's session id, on the `sse` transport once the client
+     * has initialized one. Absent on `stdio` (one process, one conversation)
+     * and on the very first request of an SSE session.
+     *
+     * It exists so a bundle that projects itself can key its OWN conversation
+     * state per CALLER: a channel daemon exposing `expose.mcp` maps this onto
+     * a harness session id, so two IDEs driving the same daemon do not write
+     * into one transcript. Without it every caller collapses onto a single
+     * shared session — which is not a subtle wrong, it is one user reading
+     * another's conversation.
+     */
+    readonly sessionId?: string;
 }
 /**
  * The injected delegate: run one agent turn for `message` and resolve with the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crewhaus/mcp-server",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "type": "module",
   "description": "Project a compiled bundle's turn function as an MCP server (stdio + SSE) — a chat/invoke tool plus optional per-sub-agent tools delegating to an injected invoke fn, built on @modelcontextprotocol/sdk",
   "main": "dist/index.js",
@@ -15,7 +15,7 @@
     "test": "bun test src"
   },
   "dependencies": {
-    "@crewhaus/errors": "0.5.2",
+    "@crewhaus/errors": "0.5.4",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^3.23.8"
   },