@rackbops/plugin-mcp 0.3.3 → 0.5.0

package/README.md

@@ -4,7 +4,8 @@ The bridge plugin for the Discord delivery MCP ([`Rackbops/discord-mcp`](https:/
 [Rackbops/Tooling#742](https://github.com/Rackbops/Tooling/issues/742)). It implements the service
 side of that repo's `docs/bridge-protocol.md` under `/mcp/` on the bot's own HTTP listener
 (rackbops-discord-bot's host-owned router, ADR-0007) -- `GET /capabilities`,
-`POST /deliveries`, `GET /deliveries/{request_id}` and `GET /recipients` -- so the MCP service can
+`POST /deliveries`, `GET /deliveries/{request_id}`, `GET /recipients` and
+`GET /recipients/{user_id}` -- so the MCP service can
 hand it a message and get one Discord post, DM or edit out of it: a retry of a request that is
 delivered or in flight never delivers again (a retry of a failed or unknown one, and the restart
 re-drive, deliver at least once -- see below). It also owns Discord-side agent identity ([Rackbops/Tooling#743](https://github.com/Rackbops/Tooling/issues/743)):
@@ -90,6 +91,17 @@ most 100, each `display_name` truncated to 100 characters (same bearer auth; any
 200: {"items":[]}
 ```
 
+`GET /recipients/{user_id}` -- one registered user, in the same shape as a `GET /recipients` item
+and with the same display-name truncation, but with no cap: a user registered after the first 100
+still finds their own entry here. `user_id` must be a snowflake (`[1-9][0-9]{16,19}`); a malformed
+one falls through to the generic `404 {"error":"not found"}`. Same bearer auth; any other method is
+`405`:
+
+```
+200: {"user_id":"123456789012345678","display_name":"Roshne"}
+404: {"error":"not registered"}
+```
+
 `GET /capabilities` now reflects the host's real `dm`/`edit` support:
 
 ```
@@ -143,6 +155,7 @@ Declared so the operator can map each to a channel per server in the admin panel
 | `deals` | Notable deals or opportunities |
 | `digest` | Periodic summaries |
 | `ops` | Operational status and infrastructure notices |
+| `agent-chat` | Agent-to-agent conversation: list it under `conversations` in discord-mcp's config so posts carry the sender's name and agents can read them back with `read_messages` |
 
 ## Operator steps (not done by this plugin)
 

package/dist/plugin.js

@@ -108,7 +108,8 @@ var DESTINATIONS = [
   { name: "alerts", description: "Time-sensitive findings and warnings" },
   { name: "deals", description: "Notable deals or opportunities" },
   { name: "digest", description: "Periodic summaries" },
-  { name: "ops", description: "Operational status and infrastructure notices" }
+  { name: "ops", description: "Operational status and infrastructure notices" },
+  { name: "agent-chat", description: "Agent-to-agent conversation (read back with discord-mcp's read_messages)" }
 ];
 var DESTINATION_NAMES = DESTINATIONS.map((d) => d.name);
 function isPostTarget(target) {
@@ -257,9 +258,10 @@ function toWireState(stored) {
 }
 function recipientsResponse(entries) {
   const sorted = [...entries].sort((a, b) => a.registeredAt.localeCompare(b.registeredAt) || a.userId.localeCompare(b.userId));
-  return {
-    items: sorted.slice(0, RECIPIENTS_MAX).map((e) => ({ user_id: e.userId, display_name: e.displayName.slice(0, DISPLAY_NAME_MAX) }))
-  };
+  return { items: sorted.slice(0, RECIPIENTS_MAX).map(recipientResponse) };
+}
+function recipientResponse(entry) {
+  return { user_id: entry.userId, display_name: entry.displayName.slice(0, DISPLAY_NAME_MAX) };
 }
 
 // plugins/mcp/src/drain.ts
@@ -549,8 +551,15 @@ async function handleGetRecipients(deps) {
   const entries = await deps.registry.listRecipients();
   return json(200, recipientsResponse(entries));
 }
+async function handleGetRecipient(userId, deps) {
+  const entry = await deps.registry.recipientOf(userId);
+  if (entry === undefined)
+    return json(404, { error: "not registered" });
+  return json(200, recipientResponse(entry));
+}
 var DELIVERY_ID_RE = /^\/deliveries\/([0-9a-f]{64})$/;
 var REGISTRATION_ID_RE = /^\/registration\/([1-9][0-9]{16,19})$/;
+var RECIPIENT_ID_RE = /^\/recipients\/([1-9][0-9]{16,19})$/;
 async function handleMcpHttp(request, info, deps) {
   if (deps.token === undefined)
     return json(503, { error: "bridge not configured" });
@@ -593,6 +602,12 @@ async function handleMcpHttp(request, info, deps) {
       return json(405, { error: "method not allowed" });
     return handleGetRecipients(deps);
   }
+  const recipientMatch = RECIPIENT_ID_RE.exec(info.path);
+  if (recipientMatch) {
+    if (request.method !== "GET")
+      return json(405, { error: "method not allowed" });
+    return handleGetRecipient(recipientMatch[1], deps);
+  }
   return json(404, { error: "not found" });
 }
 
@@ -739,6 +754,13 @@ function createRegistryStore(dataDir, storage) {
         const entry = current.users[userId];
         return { userId, displayName: entry.displayName, registeredAt: entry.registeredAt };
       });
+    },
+    async recipientOf(userId) {
+      const current = normalizeRegistry(await storage.readJsonOrFresh(path, freshRegistry, "mcp-registry"));
+      const entry = entryOf(current, userId);
+      if (entry === undefined)
+        return;
+      return { userId, displayName: entry.displayName, registeredAt: entry.registeredAt };
     }
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rackbops/plugin-mcp",
-  "version": "0.3.3",
+  "version": "0.5.0",
   "description": "Bridge plugin for the Discord delivery MCP (Rackbops/discord-mcp): the service side of docs/bridge-protocol.md, plus /agent registration and pairing",
   "type": "module",
   "main": "dist/plugin.js",
@@ -30,7 +30,8 @@
       { "name": "alerts", "description": "Time-sensitive findings and warnings" },
       { "name": "deals", "description": "Notable deals or opportunities" },
       { "name": "digest", "description": "Periodic summaries" },
-      { "name": "ops", "description": "Operational status and infrastructure notices" }
+      { "name": "ops", "description": "Operational status and infrastructure notices" },
+      { "name": "agent-chat", "description": "Agent-to-agent conversation (read back with discord-mcp's read_messages)" }
     ]
   }
 }