@loupekit/mcp 0.10.23 → 0.10.24-next.70

package/dist/index.js

@@ -164,6 +164,66 @@ var AgentRegistry = class {
   }
 };
 
+// src/bridge/presence-registry.ts
+import {
+  PEER_TTL_MS,
+  heartbeatPresence,
+  joinPresence,
+  leavePresence,
+  peerId,
+  sweepPresence
+} from "@loupekit/shared";
+var PresenceRegistry = class {
+  peers = [];
+  ttlMs;
+  now;
+  // Explicit fields, not constructor parameter properties — Node's strip-only
+  // TypeScript mode rejects those and this file runs unbundled from source.
+  constructor(ttlMs = PEER_TTL_MS, now = Date.now) {
+    if (!Number.isFinite(ttlMs) || ttlMs <= 0) throw new Error("ttlMs must be positive");
+    this.ttlMs = ttlMs;
+    this.now = now;
+  }
+  /** Join or refresh. The same person on the same page is one peer, not two. */
+  join(input) {
+    this.peers = joinPresence(this.peers, input, this.now());
+    return this.peers.find((p) => p.id === peerId(input.url, input.userId));
+  }
+  heartbeat(id) {
+    const before = this.peers.length;
+    this.peers = heartbeatPresence(this.peers, id, this.now());
+    if (this.peers.length !== before) return null;
+    return this.peers.find((p) => p.id === id) ?? null;
+  }
+  leave(id) {
+    const had = this.peers.some((p) => p.id === id);
+    this.peers = leavePresence(this.peers, id);
+    return had;
+  }
+  /** Everyone on a page, the viewer excluded — "who else is here". */
+  list(url, viewerId) {
+    const live = this.peers;
+    if (!url) return live;
+    return live.filter((p) => p.url === url && p.id !== viewerId);
+  }
+  /**
+   * Drop anything silent for the TTL. Returns what went, so the caller can broadcast —
+   * a peer vanishing matters as much as one arriving.
+   */
+  sweep() {
+    const before = this.peers;
+    const after = sweepPresence(before, this.now(), this.ttlMs);
+    if (after.length === before.length) return [];
+    const kept = new Set(after.map((p) => p.id));
+    const gone = before.filter((p) => !kept.has(p.id));
+    this.peers = after;
+    return gone;
+  }
+  size() {
+    return this.peers.length;
+  }
+};
+
 // src/bridge/events.ts
 var EventBus = class {
   subscribers = /* @__PURE__ */ new Set();
@@ -315,6 +375,7 @@ async function handle(req, res, deps) {
         ok: true,
         selections: deps.store.size(),
         agents: deps.registry.size(),
+        peers: deps.presence.size(),
         subscribers: deps.bus.count()
       }, origin);
     }
@@ -381,6 +442,40 @@ async function handle(req, res, deps) {
       const id = path.slice("/agents/".length);
       return send(res, 200, { ok: deps.registry.unregister(id) }, origin);
     }
+    if (method === "POST" && path === "/presence") {
+      const body = await readBody(req);
+      if (!body.ok) return send(res, 400, { error: body.error }, origin);
+      let parsed;
+      try {
+        parsed = JSON.parse(body.text);
+      } catch {
+        return send(res, 400, { error: "body is not valid JSON" }, origin);
+      }
+      const join2 = parsed;
+      if (!join2 || typeof join2 !== "object" || !join2.url || !join2.userId || !join2.name) {
+        return send(res, 400, { error: "url, userId and name are required" }, origin);
+      }
+      const peer = deps.presence.join({ url: join2.url, userId: join2.userId, name: join2.name, tab: join2.tab });
+      deps.bus.publish({ type: "presence", data: deps.presence.list(), at: (/* @__PURE__ */ new Date()).toISOString() });
+      return send(res, 201, { ok: true, peer, peers: deps.presence.list(join2.url, peer.id) }, origin);
+    }
+    if (method === "GET" && path === "/presence") {
+      const pageUrl = url.searchParams.get("url") ?? void 0;
+      const viewer = url.searchParams.get("viewer") ?? void 0;
+      return send(res, 200, { peers: deps.presence.list(pageUrl, viewer) }, origin);
+    }
+    if (method === "POST" && path.startsWith("/presence/") && path.endsWith("/heartbeat")) {
+      const id = path.slice("/presence/".length, -"/heartbeat".length);
+      const peer = deps.presence.heartbeat(id);
+      if (!peer) return send(res, 404, { error: "unknown peer" }, origin);
+      return send(res, 200, { ok: true, peer }, origin);
+    }
+    if (method === "DELETE" && path.startsWith("/presence/")) {
+      const id = path.slice("/presence/".length);
+      const gone = deps.presence.leave(id);
+      if (gone) deps.bus.publish({ type: "presence", data: deps.presence.list(), at: (/* @__PURE__ */ new Date()).toISOString() });
+      return send(res, 200, { ok: gone }, origin);
+    }
     if (method === "GET" && (path === "/events" || path === "/thread-updates")) {
       return streamEvents(req, res, deps, path === "/thread-updates" ? "thread" : null, origin);
     }
@@ -1463,6 +1558,7 @@ var PROJECT_KEY = process.env.LOUPE_PROJECT_KEY || "pk_demo_acme";
 var BRIDGE_PORT = Number(process.env.LOUPE_BRIDGE_PORT ?? 9800);
 var store = new SelectionStore(Number(process.env.LOUPE_SELECTION_CAP ?? 50));
 var registry = new AgentRegistry();
+var presence = new PresenceRegistry();
 var bus = new EventBus();
 var ADMIN = process.env.LOUPE_ADMIN_KEY || "";
 async function api(path, init) {
@@ -1612,7 +1708,7 @@ async function proposeChange({ id, html, css, notes }) {
   bus.publishThread(id, "preview_live", { author: proposal.author });
   return wrap(`Proposal saved for #${id}. The dev team can now review your modified HTML/CSS in the dashboard.`);
 }
-var server = new McpServer({ name: "loupe", version: "0.10.23" });
+var server = new McpServer({ name: "loupe", version: "0.10.24" });
 server.tool(
   "list_comments",
   "List Loupe product-feedback comments for the project as a task backlog. Each item carries its board stage, priority and change type, so you can start with the most urgent. Use this to see what a PM has flagged, then work through the items.",
@@ -1799,7 +1895,7 @@ function isEntrypoint() {
   }
 }
 if (isEntrypoint()) {
-  const bridge = BRIDGE_PORT ? await startHttpBridge(BRIDGE_PORT, { store, registry, bus }) : null;
+  const bridge = BRIDGE_PORT ? await startHttpBridge(BRIDGE_PORT, { store, registry, presence, bus }) : null;
   const self = registry.register({
     name: process.env.LOUPE_AGENT_NAME || "loupe-mcp",
     type: process.env.LOUPE_AGENT_TYPE || "claude-code",
@@ -1808,6 +1904,7 @@ if (isEntrypoint()) {
   });
   const sweep = setInterval(() => {
     if (registry.sweep().length) bus.publish({ type: "agents", data: registry.list(), at: (/* @__PURE__ */ new Date()).toISOString() });
+    if (presence.sweep().length) bus.publish({ type: "presence", data: presence.list(), at: (/* @__PURE__ */ new Date()).toISOString() });
     registry.heartbeat(self.id);
   }, AGENT_SWEEP_MS);
   if (typeof sweep.unref === "function") sweep.unref();

package/package.json

@@ -5,7 +5,7 @@
     "email": "m.ashraf.saed@gmail.com",
     "url": "https://www.linkedin.com/in/mohamedashrafelsaed/"
   },
-  "version": "0.10.23",
+  "version": "0.10.24-next.70",
   "description": "MCP server that exposes Loupe comments to Claude Code as an actionable, fully-contextualized backlog.",
   "keywords": [
     "loupe",
@@ -46,6 +46,6 @@
     "zod": "^3.24.1"
   },
   "devDependencies": {
-    "@loupekit/shared": "0.10.23"
+    "@loupekit/shared": "0.10.24-next.70"
   }
 }