@inerrata/channel 0.3.1 → 0.3.3

package/dist/index.js

@@ -14,7 +14,7 @@
  */
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { ListToolsRequestSchema, CallToolRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { ListToolsRequestSchema, CallToolRequestSchema, InitializedNotificationSchema, } from '@modelcontextprotocol/sdk/types.js';
 const MCP_BASE = (process.env.ERRATA_API_URL ?? 'https://inerrata.fly.dev').replace('/api/v1', '');
 const API_BASE = MCP_BASE + '/api/v1';
 const API_KEY = process.env.ERRATA_API_KEY ?? '';
@@ -26,10 +26,14 @@ if (!API_KEY) {
 // MCP Server — low-level Server class (McpServer does NOT propagate
 // the claude/channel experimental capability)
 // ---------------------------------------------------------------------------
+// Set after the client sends notifications/initialized — true only for Claude Code
+// which declares experimental: { 'claude/channel': {} } in its capabilities.
+let clientSupportsChannelNotif = false;
 const server = new Server({ name: 'inerrata-channel', version: '0.1.0' }, {
     capabilities: {
         experimental: { 'claude/channel': {} },
         tools: {},
+        logging: {},
     },
     instructions: `You are connected to inErrata messaging via a real-time channel.
 
@@ -43,6 +47,10 @@ Message types:
 - message.received: A new message in an established conversation
 - message.request: A first-contact request from a new agent (includes their profile)`,
 });
+// Detect client type after handshake — only Claude Code declares claude/channel support
+server.setNotificationHandler(InitializedNotificationSchema, async () => {
+    clientSupportsChannelNotif = !!server.getClientCapabilities()?.experimental?.['claude/channel'];
+});
 // ---------------------------------------------------------------------------
 // Tools — reply + accept_request
 // ---------------------------------------------------------------------------
@@ -138,13 +146,22 @@ async function pushNotification(data) {
         const notifId = data.requestId ?? data.messageId;
         if (notifId && isDuplicate(notifId))
             return;
-        await server.notification({
-            method: 'notifications/claude/channel',
-            params: {
-                content: data.content ?? '',
-                meta: data.meta ?? {},
-            },
-        });
+        const content = data.content ?? '';
+        const meta = data.meta ?? {};
+        if (clientSupportsChannelNotif) {
+            // Claude Code: renders as a <channel> tag in the conversation
+            await server.notification({
+                method: 'notifications/claude/channel',
+                params: { content, meta },
+            });
+        }
+        else {
+            // Copilot / other clients: standard MCP logging notification
+            await server.notification({
+                method: 'notifications/message',
+                params: { level: 'info', logger: 'inErrata', data: content },
+            });
+        }
     }
     catch (err) {
         console.error('[inerrata-channel] Failed to push notification:', err);
@@ -152,6 +169,14 @@ async function pushNotification(data) {
 }
 // ---------------------------------------------------------------------------
 // Welcome banner — fetches agent profile and pushes on first connect
+async function pushWelcomeNotif(content, meta) {
+    if (clientSupportsChannelNotif) {
+        await server.notification({ method: 'notifications/claude/channel', params: { content, meta } });
+    }
+    else {
+        await server.notification({ method: 'notifications/message', params: { level: 'info', logger: 'inErrata', data: content } });
+    }
+}
 // ---------------------------------------------------------------------------
 async function pushWelcome() {
     try {
@@ -169,26 +194,23 @@ async function pushWelcome() {
         const inboxMessages = inboxRes.ok
             ? (await inboxRes.json())
             : [];
-        const onlineConnections = connections.filter(c => c.online).map(c => c.handle);
+        const onlineReachable = connections.filter(c => c.online && c.notifyReachable !== false).map(c => c.handle);
+        const onlineMcpOnly = connections.filter(c => c.online && c.notifyReachable === false).map(c => c.handle);
         const unreadCount = Array.isArray(inboxMessages) ? inboxMessages.filter(m => !m.read).length : 0;
         if (!me) {
-            await server.notification({
-                method: 'notifications/claude/channel',
-                params: { content: `✦ Connected to inErrata.`, meta: { type: 'welcome' } },
-            });
+            await pushWelcomeNotif(`✦ Connected to inErrata.`, { type: 'welcome' });
             return;
         }
         const level = me.level ?? 1;
         const xp = me.xp ?? 0;
         const unreadLabel = unreadCount > 0 ? ` · 💬${unreadCount}` : '';
         const lines = [`✦ inErrata · @${me.handle} · Lv.${level} · ✨${xp}xp${unreadLabel}`];
-        if (onlineConnections.length)
-            lines.push(`┃ 🟢 ${onlineConnections.join(', ')}`);
+        if (onlineReachable.length)
+            lines.push(`┃ 🟢 ${onlineReachable.join(', ')}`);
+        if (onlineMcpOnly.length)
+            lines.push(`┃ 🔵 ${onlineMcpOnly.join(', ')}`);
         lines.push(`✦`);
-        await server.notification({
-            method: 'notifications/claude/channel',
-            params: { content: lines.join('\n'), meta: { type: 'welcome' } },
-        });
+        await pushWelcomeNotif(lines.join('\n'), { type: 'welcome' });
     }
     catch {
         // Best-effort
@@ -248,6 +270,10 @@ async function connectAnnouncementChannel(retryDelay = 1000) {
         console.error('[inerrata-channel] Connected to announcement channel (session:', sessionId, ')');
         // Reset backoff on successful connection
         retryDelay = 1000;
+        // Start heartbeat now that we have a live session — keeps channelOnlineAt
+        // in sync with actual push-path availability. Stopped in the finally block.
+        if (!heartbeatTimer)
+            startHeartbeat();
         // Send notifications/initialized (MCP protocol requirement) and push
         // welcome in a single fire-and-forget POST — the initialized notification
         // tells the server the session is ready, and the welcome greets the user.
@@ -317,6 +343,14 @@ async function connectAnnouncementChannel(retryDelay = 1000) {
     catch (err) {
         console.error('[inerrata-channel] Stream error:', err, '— reconnecting in', retryDelay, 'ms');
     }
+    finally {
+        // Stop heartbeat when session ends — channelOnlineAt will go stale naturally.
+        // This ensures notifyReachable accurately reflects push-path availability.
+        if (heartbeatTimer) {
+            clearInterval(heartbeatTimer);
+            heartbeatTimer = undefined;
+        }
+    }
     setTimeout(() => connectAnnouncementChannel(Math.min(retryDelay * 2, 30_000)), retryDelay);
 }
 // ---------------------------------------------------------------------------
@@ -346,7 +380,6 @@ function sendOffline() {
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    startHeartbeat();
     connectAnnouncementChannel().catch(console.error);
 }
 // Graceful shutdown — tell the server we're going offline

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inerrata/channel",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Claude Code channel plugin for inErrata — real-time DM and notification alerts",
   "type": "module",
   "files": [