@zooid/context-mcp 0.7.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zooid contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/bin.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+import {
+  buildContextMcpServer,
+  callDaemon
+} from "./chunk-QQD76TLH.js";
+
+// src/bin.ts
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+var spawnIdIdx = process.argv.indexOf("--spawn-id");
+var spawnId = spawnIdIdx >= 0 ? process.argv[spawnIdIdx + 1] : void 0;
+var sockPath = process.env.ZOOID_DAEMON_SOCK;
+if (!spawnId || !sockPath) {
+  process.stderr.write("zooid-context-mcp: --spawn-id and ZOOID_DAEMON_SOCK are required\n");
+  process.exit(2);
+}
+process.stderr.write(
+  `zooid-context-mcp: starting (pid=${process.pid} spawnId=${spawnId} sock=${sockPath})
+`
+);
+var remoteProvider = {
+  getRoomHistory: (_channelId, opts) => callDaemon(sockPath, {
+    spawnId,
+    method: "getRoomHistory",
+    params: opts ?? {}
+  }),
+  getRecentThreads: (_channelId, opts) => callDaemon(sockPath, {
+    spawnId,
+    method: "getRecentThreads",
+    params: opts ?? {}
+  }),
+  getThreadHistory: (_channelId, threadId, opts) => callDaemon(sockPath, {
+    spawnId,
+    method: "getThreadHistory",
+    params: { ...opts ?? {}, threadId }
+  }),
+  getChannelMembers: () => callDaemon(sockPath, { spawnId, method: "getChannelMembers", params: {} }),
+  getChannelInfo: () => callDaemon(sockPath, { spawnId, method: "getChannelInfo", params: {} })
+};
+var server = buildContextMcpServer({ resolve: async () => remoteProvider });
+await server.connect(new StdioServerTransport());
+process.stderr.write(`zooid-context-mcp: ready (spawnId=${spawnId})
+`);
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bin.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'\nimport { buildContextMcpServer } from './mcp-server.js'\nimport { callDaemon } from './daemon-socket.js'\nimport type { TransportContextProvider } from '@zooid/core'\n\nconst spawnIdIdx = process.argv.indexOf('--spawn-id')\nconst spawnId = spawnIdIdx >= 0 ? process.argv[spawnIdIdx + 1] : undefined\nconst sockPath = process.env.ZOOID_DAEMON_SOCK\nif (!spawnId || !sockPath) {\n  process.stderr.write('zooid-context-mcp: --spawn-id and ZOOID_DAEMON_SOCK are required\\n')\n  process.exit(2)\n}\nprocess.stderr.write(\n  `zooid-context-mcp: starting (pid=${process.pid} spawnId=${spawnId} sock=${sockPath})\\n`,\n)\n\nconst remoteProvider: TransportContextProvider = {\n  getRoomHistory: (_channelId, opts) =>\n    callDaemon(sockPath, {\n      spawnId,\n      method: 'getRoomHistory',\n      params: (opts ?? {}) as Record<string, unknown>,\n    }) as Promise<Awaited<ReturnType<TransportContextProvider['getRoomHistory']>>>,\n  getRecentThreads: (_channelId, opts) =>\n    callDaemon(sockPath, {\n      spawnId,\n      method: 'getRecentThreads',\n      params: (opts ?? {}) as Record<string, unknown>,\n    }) as Promise<Awaited<ReturnType<TransportContextProvider['getRecentThreads']>>>,\n  getThreadHistory: (_channelId, threadId, opts) =>\n    callDaemon(sockPath, {\n      spawnId,\n      method: 'getThreadHistory',\n      params: { ...(opts ?? {}), threadId } as Record<string, unknown>,\n    }) as Promise<Awaited<ReturnType<TransportContextProvider['getThreadHistory']>>>,\n  getChannelMembers: () =>\n    callDaemon(sockPath, { spawnId, method: 'getChannelMembers', params: {} }) as Promise<\n      Awaited<ReturnType<TransportContextProvider['getChannelMembers']>>\n    >,\n  getChannelInfo: () =>\n    callDaemon(sockPath, { spawnId, method: 'getChannelInfo', params: {} }) as Promise<\n      Awaited<ReturnType<TransportContextProvider['getChannelInfo']>>\n    >,\n}\n\nconst server = buildContextMcpServer({ resolve: async () => remoteProvider })\nawait server.connect(new StdioServerTransport())\nprocess.stderr.write(`zooid-context-mcp: ready (spawnId=${spawnId})\\n`)\n"],"mappings":";;;;;;;AACA,SAAS,4BAA4B;AAKrC,IAAM,aAAa,QAAQ,KAAK,QAAQ,YAAY;AACpD,IAAM,UAAU,cAAc,IAAI,QAAQ,KAAK,aAAa,CAAC,IAAI;AACjE,IAAM,WAAW,QAAQ,IAAI;AAC7B,IAAI,CAAC,WAAW,CAAC,UAAU;AACzB,UAAQ,OAAO,MAAM,oEAAoE;AACzF,UAAQ,KAAK,CAAC;AAChB;AACA,QAAQ,OAAO;AAAA,EACb,oCAAoC,QAAQ,GAAG,YAAY,OAAO,SAAS,QAAQ;AAAA;AACrF;AAEA,IAAM,iBAA2C;AAAA,EAC/C,gBAAgB,CAAC,YAAY,SAC3B,WAAW,UAAU;AAAA,IACnB;AAAA,IACA,QAAQ;AAAA,IACR,QAAS,QAAQ,CAAC;AAAA,EACpB,CAAC;AAAA,EACH,kBAAkB,CAAC,YAAY,SAC7B,WAAW,UAAU;AAAA,IACnB;AAAA,IACA,QAAQ;AAAA,IACR,QAAS,QAAQ,CAAC;AAAA,EACpB,CAAC;AAAA,EACH,kBAAkB,CAAC,YAAY,UAAU,SACvC,WAAW,UAAU;AAAA,IACnB;AAAA,IACA,QAAQ;AAAA,IACR,QAAQ,EAAE,GAAI,QAAQ,CAAC,GAAI,SAAS;AAAA,EACtC,CAAC;AAAA,EACH,mBAAmB,MACjB,WAAW,UAAU,EAAE,SAAS,QAAQ,qBAAqB,QAAQ,CAAC,EAAE,CAAC;AAAA,EAG3E,gBAAgB,MACd,WAAW,UAAU,EAAE,SAAS,QAAQ,kBAAkB,QAAQ,CAAC,EAAE,CAAC;AAG1E;AAEA,IAAM,SAAS,sBAAsB,EAAE,SAAS,YAAY,eAAe,CAAC;AAC5E,MAAM,OAAO,QAAQ,IAAI,qBAAqB,CAAC;AAC/C,QAAQ,OAAO,MAAM,qCAAqC,OAAO;AAAA,CAAK;","names":[]}

package/dist/chunk-QQD76TLH.js

@@ -0,0 +1,203 @@
+// src/mcp-server.ts
+import { z } from "zod";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+var MAX_LIMIT = 200;
+var DEFAULT_LIMIT = 50;
+function buildContextMcpServer(opts) {
+  const server = new McpServer({ name: "zooid-context", version: "0.0.1" });
+  server.tool(
+    "zooid_get_history",
+    "Read every message in the current room chronologically \u2014 top-level messages and all thread replies. Each message has an optional `thread_id` so the agent can group by thread. For a scan-the-room overview without reply noise, use `zooid_get_recent_threads` instead. Supports `limit` + `before` pagination.",
+    {
+      limit: z.number().int().positive().optional(),
+      before: z.string().optional()
+    },
+    async ({ limit, before }) => {
+      const provider = await opts.resolve();
+      const clamped = Math.min(limit ?? DEFAULT_LIMIT, MAX_LIMIT);
+      const page = await provider.getRoomHistory("", { limit: clamped, before });
+      return { content: [{ type: "text", text: JSON.stringify(page) }] };
+    }
+  );
+  server.tool(
+    "zooid_get_recent_threads",
+    "Scan-the-room overview: top-level messages and thread roots in the current room, newest first. Each entry has `reply_count` and `last_activity_at` so the agent can spot active conversations. Drill into a thread with `zooid_get_thread_history(thread_id)` where `thread_id` is the entry's `id`.",
+    {
+      limit: z.number().int().positive().optional(),
+      before: z.string().optional()
+    },
+    async ({ limit, before }) => {
+      const provider = await opts.resolve();
+      const clamped = Math.min(limit ?? DEFAULT_LIMIT, MAX_LIMIT);
+      const page = await provider.getRecentThreads("", { limit: clamped, before });
+      return { content: [{ type: "text", text: JSON.stringify(page) }] };
+    }
+  );
+  server.tool(
+    "zooid_get_thread_history",
+    "Drill into a specific thread: the root message followed by all replies in chronological order. Pass the `thread_id` from a `zooid_get_recent_threads` entry or a `Message.thread_id` from `zooid_get_history`.",
+    {
+      thread_id: z.string(),
+      limit: z.number().int().positive().optional(),
+      before: z.string().optional()
+    },
+    async ({ thread_id, limit, before }) => {
+      const provider = await opts.resolve();
+      const clamped = Math.min(limit ?? DEFAULT_LIMIT, MAX_LIMIT);
+      const page = await provider.getThreadHistory("", thread_id, {
+        limit: clamped,
+        before
+      });
+      return { content: [{ type: "text", text: JSON.stringify(page) }] };
+    }
+  );
+  server.tool(
+    "zooid_get_members",
+    "List the humans and agents in the current room.",
+    {},
+    async () => {
+      const provider = await opts.resolve();
+      const members = await provider.getChannelMembers("");
+      return { content: [{ type: "text", text: JSON.stringify({ members }) }] };
+    }
+  );
+  server.tool(
+    "zooid_get_channel_info",
+    "Describe the current room: id, display name, transport kind.",
+    {},
+    async () => {
+      const provider = await opts.resolve();
+      const info = await provider.getChannelInfo("");
+      return { content: [{ type: "text", text: JSON.stringify(info) }] };
+    }
+  );
+  return server;
+}
+
+// src/daemon-socket.ts
+import { createServer, createConnection } from "net";
+import { unlink } from "fs/promises";
+async function startDaemonSocketServer(opts) {
+  await unlink(opts.sockPath).catch(() => {
+  });
+  const server = createServer((socket) => {
+    let buf = "";
+    socket.setEncoding("utf8");
+    socket.on("data", async (chunk) => {
+      buf += chunk;
+      let idx;
+      while ((idx = buf.indexOf("\n")) >= 0) {
+        const line = buf.slice(0, idx);
+        buf = buf.slice(idx + 1);
+        if (!line) continue;
+        await handleLine(line, socket, opts.registry);
+      }
+    });
+    socket.on("error", () => {
+    });
+  });
+  await new Promise((resolve, reject) => {
+    server.once("error", reject);
+    server.listen(opts.sockPath, () => {
+      server.removeListener("error", reject);
+      resolve();
+    });
+  });
+  return {
+    close: () => new Promise((resolve) => {
+      server.close(() => resolve());
+    })
+  };
+}
+async function handleLine(line, socket, registry) {
+  let req;
+  try {
+    req = JSON.parse(line);
+  } catch {
+    socket.write(JSON.stringify({ ok: false, error: "invalid json" }) + "\n");
+    return;
+  }
+  const binding = registry.get(req.spawnId);
+  if (!binding) {
+    process.stderr.write(
+      `[context-mcp] daemon: unknown spawn-id ${req.spawnId} for method=${req.method}
+`
+    );
+    socket.write(
+      JSON.stringify({
+        ok: false,
+        error: `unknown spawn-id: ${req.spawnId}`
+      }) + "\n"
+    );
+    return;
+  }
+  process.stderr.write(
+    `[context-mcp] daemon: ${req.method} spawn=${req.spawnId.slice(0, 8)} agent=${binding.agentName}
+`
+  );
+  try {
+    let result;
+    const channelId = binding.threadRef.channelId;
+    if (req.method === "getRoomHistory") {
+      result = await binding.provider.getRoomHistory(channelId, req.params);
+    } else if (req.method === "getRecentThreads") {
+      result = await binding.provider.getRecentThreads(channelId, req.params);
+    } else if (req.method === "getThreadHistory") {
+      const threadId = String(req.params.threadId ?? "");
+      result = await binding.provider.getThreadHistory(channelId, threadId, req.params);
+    } else if (req.method === "getChannelMembers") {
+      result = await binding.provider.getChannelMembers(channelId);
+    } else if (req.method === "getChannelInfo") {
+      result = await binding.provider.getChannelInfo(channelId);
+    } else {
+      socket.write(
+        JSON.stringify({
+          ok: false,
+          error: `unknown method: ${req.method}`
+        }) + "\n"
+      );
+      return;
+    }
+    socket.write(JSON.stringify({ ok: true, result }) + "\n");
+  } catch (err) {
+    socket.write(
+      JSON.stringify({
+        ok: false,
+        error: String(err instanceof Error ? err.message : err)
+      }) + "\n"
+    );
+  }
+}
+async function callDaemon(sockPath, req) {
+  return new Promise((resolve, reject) => {
+    const socket = createConnection(sockPath);
+    let buf = "";
+    socket.setEncoding("utf8");
+    socket.on("error", reject);
+    socket.on("data", (chunk) => {
+      buf += chunk;
+      const idx = buf.indexOf("\n");
+      if (idx < 0) return;
+      const line = buf.slice(0, idx);
+      let parsed;
+      try {
+        parsed = JSON.parse(line);
+      } catch (e) {
+        socket.end();
+        reject(e instanceof Error ? e : new Error(String(e)));
+        return;
+      }
+      socket.end();
+      if (parsed.ok) resolve(parsed.result);
+      else reject(new Error(parsed.error));
+    });
+    socket.write(JSON.stringify(req) + "\n");
+  });
+}
+
+export {
+  buildContextMcpServer,
+  startDaemonSocketServer,
+  callDaemon
+};
+//# sourceMappingURL=chunk-QQD76TLH.js.map

package/dist/chunk-QQD76TLH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mcp-server.ts","../src/daemon-socket.ts"],"sourcesContent":["import { z } from 'zod'\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { TransportContextProvider } from '@zooid/core'\n\nconst MAX_LIMIT = 200\nconst DEFAULT_LIMIT = 50\n\nexport interface BuildContextMcpServerOpts {\n  /**\n   * Resolves the provider for the current spawn. In production this calls\n   * back to the daemon over the Unix socket; in unit tests it returns a\n   * fake provider directly.\n   */\n  resolve: () => Promise<TransportContextProvider>\n}\n\nexport function buildContextMcpServer(opts: BuildContextMcpServerOpts): McpServer {\n  const server = new McpServer({ name: 'zooid-context', version: '0.0.1' })\n\n  server.tool(\n    'zooid_get_history',\n    \"Read every message in the current room chronologically — top-level messages and all thread replies. Each message has an optional `thread_id` so the agent can group by thread. For a scan-the-room overview without reply noise, use `zooid_get_recent_threads` instead. Supports `limit` + `before` pagination.\",\n    {\n      limit: z.number().int().positive().optional(),\n      before: z.string().optional(),\n    },\n    async ({ limit, before }) => {\n      const provider = await opts.resolve()\n      const clamped = Math.min(limit ?? DEFAULT_LIMIT, MAX_LIMIT)\n      const page = await provider.getRoomHistory('', { limit: clamped, before })\n      return { content: [{ type: 'text', text: JSON.stringify(page) }] }\n    },\n  )\n\n  server.tool(\n    'zooid_get_recent_threads',\n    \"Scan-the-room overview: top-level messages and thread roots in the current room, newest first. Each entry has `reply_count` and `last_activity_at` so the agent can spot active conversations. Drill into a thread with `zooid_get_thread_history(thread_id)` where `thread_id` is the entry's `id`.\",\n    {\n      limit: z.number().int().positive().optional(),\n      before: z.string().optional(),\n    },\n    async ({ limit, before }) => {\n      const provider = await opts.resolve()\n      const clamped = Math.min(limit ?? DEFAULT_LIMIT, MAX_LIMIT)\n      const page = await provider.getRecentThreads('', { limit: clamped, before })\n      return { content: [{ type: 'text', text: JSON.stringify(page) }] }\n    },\n  )\n\n  server.tool(\n    'zooid_get_thread_history',\n    \"Drill into a specific thread: the root message followed by all replies in chronological order. Pass the `thread_id` from a `zooid_get_recent_threads` entry or a `Message.thread_id` from `zooid_get_history`.\",\n    {\n      thread_id: z.string(),\n      limit: z.number().int().positive().optional(),\n      before: z.string().optional(),\n    },\n    async ({ thread_id, limit, before }) => {\n      const provider = await opts.resolve()\n      const clamped = Math.min(limit ?? DEFAULT_LIMIT, MAX_LIMIT)\n      const page = await provider.getThreadHistory('', thread_id, {\n        limit: clamped,\n        before,\n      })\n      return { content: [{ type: 'text', text: JSON.stringify(page) }] }\n    },\n  )\n\n  server.tool(\n    'zooid_get_members',\n    'List the humans and agents in the current room.',\n    {},\n    async () => {\n      const provider = await opts.resolve()\n      const members = await provider.getChannelMembers('')\n      return { content: [{ type: 'text', text: JSON.stringify({ members }) }] }\n    },\n  )\n\n  server.tool(\n    'zooid_get_channel_info',\n    'Describe the current room: id, display name, transport kind.',\n    {},\n    async () => {\n      const provider = await opts.resolve()\n      const info = await provider.getChannelInfo('')\n      return { content: [{ type: 'text', text: JSON.stringify(info) }] }\n    },\n  )\n\n  return server\n}\n","import { createServer, createConnection, type Server, type Socket } from 'node:net'\nimport { unlink } from 'node:fs/promises'\nimport type { SpawnRegistry } from './spawn-registry.js'\n\ninterface DaemonRequest {\n  spawnId: string\n  method:\n    | 'getRoomHistory'\n    | 'getRecentThreads'\n    | 'getThreadHistory'\n    | 'getChannelMembers'\n    | 'getChannelInfo'\n  params: Record<string, unknown>\n}\n\ninterface DaemonResponse {\n  ok: true\n  result: unknown\n}\n\ninterface DaemonError {\n  ok: false\n  error: string\n}\n\nexport interface DaemonSocketHandle {\n  close(): Promise<void>\n}\n\nexport async function startDaemonSocketServer(opts: {\n  sockPath: string\n  registry: SpawnRegistry\n}): Promise<DaemonSocketHandle> {\n  await unlink(opts.sockPath).catch(() => {})\n  const server: Server = createServer((socket: Socket) => {\n    let buf = ''\n    socket.setEncoding('utf8')\n    socket.on('data', async (chunk) => {\n      buf += chunk\n      let idx: number\n      while ((idx = buf.indexOf('\\n')) >= 0) {\n        const line = buf.slice(0, idx)\n        buf = buf.slice(idx + 1)\n        if (!line) continue\n        await handleLine(line, socket, opts.registry)\n      }\n    })\n    socket.on('error', () => {})\n  })\n  await new Promise<void>((resolve, reject) => {\n    server.once('error', reject)\n    server.listen(opts.sockPath, () => {\n      server.removeListener('error', reject)\n      resolve()\n    })\n  })\n  return {\n    close: () =>\n      new Promise<void>((resolve) => {\n        server.close(() => resolve())\n      }),\n  }\n}\n\nasync function handleLine(line: string, socket: Socket, registry: SpawnRegistry) {\n  let req: DaemonRequest\n  try {\n    req = JSON.parse(line) as DaemonRequest\n  } catch {\n    socket.write(JSON.stringify({ ok: false, error: 'invalid json' } satisfies DaemonError) + '\\n')\n    return\n  }\n  const binding = registry.get(req.spawnId)\n  if (!binding) {\n    process.stderr.write(\n      `[context-mcp] daemon: unknown spawn-id ${req.spawnId} for method=${req.method}\\n`,\n    )\n    socket.write(\n      JSON.stringify({\n        ok: false,\n        error: `unknown spawn-id: ${req.spawnId}`,\n      } satisfies DaemonError) + '\\n',\n    )\n    return\n  }\n  process.stderr.write(\n    `[context-mcp] daemon: ${req.method} spawn=${req.spawnId.slice(0, 8)} agent=${binding.agentName}\\n`,\n  )\n  try {\n    let result: unknown\n    const channelId = binding.threadRef.channelId\n    if (req.method === 'getRoomHistory') {\n      result = await binding.provider.getRoomHistory(channelId, req.params)\n    } else if (req.method === 'getRecentThreads') {\n      result = await binding.provider.getRecentThreads(channelId, req.params)\n    } else if (req.method === 'getThreadHistory') {\n      const threadId = String(req.params.threadId ?? '')\n      result = await binding.provider.getThreadHistory(channelId, threadId, req.params)\n    } else if (req.method === 'getChannelMembers') {\n      result = await binding.provider.getChannelMembers(channelId)\n    } else if (req.method === 'getChannelInfo') {\n      result = await binding.provider.getChannelInfo(channelId)\n    } else {\n      socket.write(\n        JSON.stringify({\n          ok: false,\n          error: `unknown method: ${(req as { method: string }).method}`,\n        } satisfies DaemonError) + '\\n',\n      )\n      return\n    }\n    socket.write(JSON.stringify({ ok: true, result } satisfies DaemonResponse) + '\\n')\n  } catch (err) {\n    socket.write(\n      JSON.stringify({\n        ok: false,\n        error: String(err instanceof Error ? err.message : err),\n      } satisfies DaemonError) + '\\n',\n    )\n  }\n}\n\nexport async function callDaemon(sockPath: string, req: DaemonRequest): Promise<unknown> {\n  return new Promise((resolve, reject) => {\n    const socket = createConnection(sockPath)\n    let buf = ''\n    socket.setEncoding('utf8')\n    socket.on('error', reject)\n    socket.on('data', (chunk) => {\n      buf += chunk\n      const idx = buf.indexOf('\\n')\n      if (idx < 0) return\n      const line = buf.slice(0, idx)\n      let parsed: DaemonResponse | DaemonError\n      try {\n        parsed = JSON.parse(line) as DaemonResponse | DaemonError\n      } catch (e) {\n        socket.end()\n        reject(e instanceof Error ? e : new Error(String(e)))\n        return\n      }\n      socket.end()\n      if (parsed.ok) resolve(parsed.result)\n      else reject(new Error(parsed.error))\n    })\n    socket.write(JSON.stringify(req) + '\\n')\n  })\n}\n"],"mappings":"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","names":[]}

package/dist/index.js

@@ -0,0 +1,50 @@
+import {
+  buildContextMcpServer,
+  callDaemon,
+  startDaemonSocketServer
+} from "./chunk-QQD76TLH.js";
+
+// src/spawn-registry.ts
+import { randomUUID } from "crypto";
+var SpawnRegistry = class {
+  bindings = /* @__PURE__ */ new Map();
+  register(input) {
+    const spawnId = randomUUID();
+    this.bindings.set(spawnId, { spawnId, ...input });
+    return spawnId;
+  }
+  get(spawnId) {
+    return this.bindings.get(spawnId);
+  }
+  release(spawnId) {
+    this.bindings.delete(spawnId);
+  }
+};
+
+// src/factory.ts
+import { createRequire } from "module";
+function resolveDefaultBin() {
+  const req = createRequire(import.meta.url);
+  return req.resolve("@zooid/context-mcp/bin");
+}
+var cachedDefaultBin = null;
+function getDefaultBin() {
+  if (!cachedDefaultBin) cachedDefaultBin = resolveDefaultBin();
+  return cachedDefaultBin;
+}
+function buildContextServerSpec(opts) {
+  return {
+    name: "zooid-context",
+    command: process.execPath,
+    args: [opts.binPath ?? getDefaultBin(), "--spawn-id", opts.spawnId],
+    env: [{ name: "ZOOID_DAEMON_SOCK", value: opts.sockPath }]
+  };
+}
+export {
+  SpawnRegistry,
+  buildContextMcpServer,
+  buildContextServerSpec,
+  callDaemon,
+  startDaemonSocketServer
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/spawn-registry.ts","../src/factory.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto'\nimport type { SpawnBinding } from './types.js'\nimport type { TransportContextProvider, ThreadRef } from '@zooid/core'\n\nexport class SpawnRegistry {\n  private readonly bindings = new Map<string, SpawnBinding>()\n\n  register(input: {\n    agentName: string\n    threadRef: ThreadRef\n    provider: TransportContextProvider\n  }): string {\n    const spawnId = randomUUID()\n    this.bindings.set(spawnId, { spawnId, ...input })\n    return spawnId\n  }\n\n  get(spawnId: string): SpawnBinding | undefined {\n    return this.bindings.get(spawnId)\n  }\n\n  release(spawnId: string): void {\n    this.bindings.delete(spawnId)\n  }\n}\n","import { createRequire } from 'node:module'\nimport type { ZooidContextServerSpec } from './types.js'\n\n/**\n * Resolve `dist/bin.js` via Node's runtime module resolver rather than\n * `import.meta.url`. tsup bundles this file into the CLI's own chunk, so\n * `import.meta.url` at runtime points to the CLI bundle — not this\n * package's dist. `createRequire` walks the runtime `node_modules` tree\n * instead and finds the package wherever it actually lives.\n */\nfunction resolveDefaultBin(): string {\n  const req = createRequire(import.meta.url)\n  // Resolve via the dedicated `./bin` export → `./dist/bin.js`. Avoids the\n  // exports-restriction surprise of importing `./package.json`.\n  return req.resolve('@zooid/context-mcp/bin')\n}\n\nlet cachedDefaultBin: string | null = null\nfunction getDefaultBin(): string {\n  if (!cachedDefaultBin) cachedDefaultBin = resolveDefaultBin()\n  return cachedDefaultBin\n}\n\nexport function buildContextServerSpec(opts: {\n  spawnId: string\n  sockPath: string\n  binPath?: string\n}): ZooidContextServerSpec {\n  return {\n    name: 'zooid-context',\n    command: process.execPath,\n    args: [opts.binPath ?? getDefaultBin(), '--spawn-id', opts.spawnId],\n    env: [{ name: 'ZOOID_DAEMON_SOCK', value: opts.sockPath }],\n  }\n}\n"],"mappings":";;;;;;;AAAA,SAAS,kBAAkB;AAIpB,IAAM,gBAAN,MAAoB;AAAA,EACR,WAAW,oBAAI,IAA0B;AAAA,EAE1D,SAAS,OAIE;AACT,UAAM,UAAU,WAAW;AAC3B,SAAK,SAAS,IAAI,SAAS,EAAE,SAAS,GAAG,MAAM,CAAC;AAChD,WAAO;AAAA,EACT;AAAA,EAEA,IAAI,SAA2C;AAC7C,WAAO,KAAK,SAAS,IAAI,OAAO;AAAA,EAClC;AAAA,EAEA,QAAQ,SAAuB;AAC7B,SAAK,SAAS,OAAO,OAAO;AAAA,EAC9B;AACF;;;ACxBA,SAAS,qBAAqB;AAU9B,SAAS,oBAA4B;AACnC,QAAM,MAAM,cAAc,YAAY,GAAG;AAGzC,SAAO,IAAI,QAAQ,wBAAwB;AAC7C;AAEA,IAAI,mBAAkC;AACtC,SAAS,gBAAwB;AAC/B,MAAI,CAAC,iBAAkB,oBAAmB,kBAAkB;AAC5D,SAAO;AACT;AAEO,SAAS,uBAAuB,MAIZ;AACzB,SAAO;AAAA,IACL,MAAM;AAAA,IACN,SAAS,QAAQ;AAAA,IACjB,MAAM,CAAC,KAAK,WAAW,cAAc,GAAG,cAAc,KAAK,OAAO;AAAA,IAClE,KAAK,CAAC,EAAE,MAAM,qBAAqB,OAAO,KAAK,SAAS,CAAC;AAAA,EAC3D;AACF;","names":[]}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@zooid/context-mcp",
+  "version": "0.7.0",
+  "description": "Daemon-side stdio MCP server + per-spawn registry that exposes zooid_get_history / zooid_get_members / zooid_get_channel_info to ACP shims, backed by each transport's TransportContextProvider.",
+  "type": "module",
+  "license": "MIT",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "bin": {
+    "zooid-context-mcp": "./dist/bin.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "import": "./src/index.ts"
+    },
+    "./bin": "./dist/bin.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "zod": "^3.23.0",
+    "@zooid/core": "^0.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.5.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.5.0",
+    "vitest": "^3.2.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/bin.ts

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
+import { buildContextMcpServer } from './mcp-server.js'
+import { callDaemon } from './daemon-socket.js'
+import type { TransportContextProvider } from '@zooid/core'
+
+const spawnIdIdx = process.argv.indexOf('--spawn-id')
+const spawnId = spawnIdIdx >= 0 ? process.argv[spawnIdIdx + 1] : undefined
+const sockPath = process.env.ZOOID_DAEMON_SOCK
+if (!spawnId || !sockPath) {
+  process.stderr.write('zooid-context-mcp: --spawn-id and ZOOID_DAEMON_SOCK are required\n')
+  process.exit(2)
+}
+process.stderr.write(
+  `zooid-context-mcp: starting (pid=${process.pid} spawnId=${spawnId} sock=${sockPath})\n`,
+)
+
+const remoteProvider: TransportContextProvider = {
+  getRoomHistory: (_channelId, opts) =>
+    callDaemon(sockPath, {
+      spawnId,
+      method: 'getRoomHistory',
+      params: (opts ?? {}) as Record<string, unknown>,
+    }) as Promise<Awaited<ReturnType<TransportContextProvider['getRoomHistory']>>>,
+  getRecentThreads: (_channelId, opts) =>
+    callDaemon(sockPath, {
+      spawnId,
+      method: 'getRecentThreads',
+      params: (opts ?? {}) as Record<string, unknown>,
+    }) as Promise<Awaited<ReturnType<TransportContextProvider['getRecentThreads']>>>,
+  getThreadHistory: (_channelId, threadId, opts) =>
+    callDaemon(sockPath, {
+      spawnId,
+      method: 'getThreadHistory',
+      params: { ...(opts ?? {}), threadId } as Record<string, unknown>,
+    }) as Promise<Awaited<ReturnType<TransportContextProvider['getThreadHistory']>>>,
+  getChannelMembers: () =>
+    callDaemon(sockPath, { spawnId, method: 'getChannelMembers', params: {} }) as Promise<
+      Awaited<ReturnType<TransportContextProvider['getChannelMembers']>>
+    >,
+  getChannelInfo: () =>
+    callDaemon(sockPath, { spawnId, method: 'getChannelInfo', params: {} }) as Promise<
+      Awaited<ReturnType<TransportContextProvider['getChannelInfo']>>
+    >,
+}
+
+const server = buildContextMcpServer({ resolve: async () => remoteProvider })
+await server.connect(new StdioServerTransport())
+process.stderr.write(`zooid-context-mcp: ready (spawnId=${spawnId})\n`)