@hasna/conversations 0.2.45 → 0.2.47

package/bin/mcp.js

@@ -17851,6 +17851,18 @@ function getDb() {
       PRIMARY KEY (space, agent)
     )
   `);
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS space_subscriptions (
+      space TEXT NOT NULL REFERENCES spaces(name),
+      agent TEXT NOT NULL,
+      created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
+      preview_chars INTEGER NOT NULL DEFAULT 140,
+      since_message_id INTEGER NOT NULL DEFAULT 0,
+      PRIMARY KEY (space, agent)
+    )
+  `);
+  db.exec("CREATE INDEX IF NOT EXISTS idx_space_subscriptions_agent ON space_subscriptions(agent)");
+  db.exec("CREATE INDEX IF NOT EXISTS idx_space_subscriptions_space ON space_subscriptions(space)");
   db.exec(`
     CREATE TABLE IF NOT EXISTS agent_presence (
       id TEXT NOT NULL,
@@ -17891,6 +17903,16 @@ function getDb() {
     )
   `);
   db.exec("CREATE INDEX IF NOT EXISTS idx_reactions_message ON reactions(message_id)");
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS space_notification_reads (
+      agent TEXT NOT NULL,
+      message_id INTEGER NOT NULL REFERENCES messages(id) ON DELETE CASCADE,
+      read_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
+      PRIMARY KEY (agent, message_id)
+    )
+  `);
+  db.exec("CREATE INDEX IF NOT EXISTS idx_space_notification_reads_agent ON space_notification_reads(agent)");
+  db.exec("CREATE INDEX IF NOT EXISTS idx_space_notification_reads_message ON space_notification_reads(message_id)");
   const existingTables = db.prepare("SELECT name FROM sqlite_master WHERE type='table'").all();
   const tableNames = existingTables.map((t) => t.name);
   if (tableNames.includes("channels") && tableNames.includes("spaces")) {
@@ -17938,6 +17960,19 @@ function getDb() {
   if (!spaceColNames.includes("topic")) {
     db.exec("ALTER TABLE spaces ADD COLUMN topic TEXT");
   }
+  const spaceSubscriptionCols = db.prepare("PRAGMA table_info(space_subscriptions)").all();
+  const spaceSubscriptionColNames = spaceSubscriptionCols.map((c) => c.name);
+  if (!spaceSubscriptionColNames.includes("since_message_id")) {
+    db.exec("ALTER TABLE space_subscriptions ADD COLUMN since_message_id INTEGER NOT NULL DEFAULT 0");
+    db.exec(`
+      UPDATE space_subscriptions
+      SET since_message_id = COALESCE(
+        (SELECT MAX(m.id) FROM messages m WHERE m.space = space_subscriptions.space),
+        0
+      )
+      WHERE since_message_id = 0
+    `);
+  }
   const msgCols2 = db.prepare("PRAGMA table_info(messages)").all();
   const colNames2 = msgCols2.map((c) => c.name);
   if (!colNames2.includes("edited_at")) {
@@ -18558,6 +18593,24 @@ var init_pg_migrations = __esm(() => {
     PRIMARY KEY (space, agent)
   );
 
+  CREATE TABLE IF NOT EXISTS space_subscriptions (
+    space TEXT NOT NULL REFERENCES spaces(name),
+    agent TEXT NOT NULL,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    preview_chars INTEGER NOT NULL DEFAULT 140,
+    since_message_id BIGINT NOT NULL DEFAULT 0,
+    PRIMARY KEY (space, agent)
+  );
+  CREATE INDEX IF NOT EXISTS idx_space_subscriptions_agent ON space_subscriptions(agent);
+  CREATE INDEX IF NOT EXISTS idx_space_subscriptions_space ON space_subscriptions(space);
+  ALTER TABLE space_subscriptions ADD COLUMN IF NOT EXISTS since_message_id BIGINT NOT NULL DEFAULT 0;
+  UPDATE space_subscriptions ss
+  SET since_message_id = COALESCE(
+    (SELECT MAX(m.id) FROM messages m WHERE m.space = ss.space),
+    0
+  )
+  WHERE ss.since_message_id = 0;
+
   CREATE TABLE IF NOT EXISTS messages (
     id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
     uuid TEXT NOT NULL DEFAULT gen_random_uuid()::text UNIQUE,
@@ -18635,6 +18688,15 @@ var init_pg_migrations = __esm(() => {
   CREATE INDEX IF NOT EXISTS idx_read_receipts_message ON message_read_receipts(message_id);
   CREATE INDEX IF NOT EXISTS idx_read_receipts_agent ON message_read_receipts(agent);
 
+  CREATE TABLE IF NOT EXISTS space_notification_reads (
+    agent TEXT NOT NULL,
+    message_id BIGINT NOT NULL REFERENCES messages(id) ON DELETE CASCADE,
+    read_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    PRIMARY KEY (agent, message_id)
+  );
+  CREATE INDEX IF NOT EXISTS idx_space_notification_reads_agent ON space_notification_reads(agent);
+  CREATE INDEX IF NOT EXISTS idx_space_notification_reads_message ON space_notification_reads(message_id);
+
   CREATE TABLE IF NOT EXISTS message_mentions (
     id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
     message_id BIGINT NOT NULL REFERENCES messages(id) ON DELETE CASCADE,
@@ -41663,6 +41725,23 @@ function registerMessagingTools(server, resolveProjectId) {
       content: [{ type: "text", text: JSON.stringify({ messages, count: messages.length, offset: args.offset ?? 0 }) }]
     };
   });
+  server.registerTool("get_message", {
+    description: "Get the full content of a message by numeric ID. Use this to inspect a full space message after receiving a preview-only notification blurb.",
+    inputSchema: {
+      id: exports_external.coerce.number().describe("Numeric message ID to fetch")
+    }
+  }, async (args) => {
+    const message = getMessageById(args.id);
+    if (!message) {
+      return {
+        content: [{ type: "text", text: `Message #${args.id} not found` }],
+        isError: true
+      };
+    }
+    return {
+      content: [{ type: "text", text: JSON.stringify(message) }]
+    };
+  });
   server.registerTool("list_sessions", {
     description: "List all sessions by agent.",
     inputSchema: {
@@ -42106,6 +42185,120 @@ function unarchiveSpace(name) {
   return row;
 }
 
+// src/lib/space-notifications.ts
+init_db();
+var DEFAULT_PREVIEW_CHARS = 140;
+function buildMessagePreview(content, maxChars = DEFAULT_PREVIEW_CHARS) {
+  const normalized = content.replace(/[*#`~_>\-]/g, " ").replace(/\s+/g, " ").trim();
+  if (normalized.length <= maxChars)
+    return normalized;
+  return normalized.slice(0, Math.max(1, maxChars)).trimEnd() + "\u2026";
+}
+function subscribeToSpaceNotifications(space, agent, opts) {
+  const db2 = getDb();
+  const existingSpace = db2.prepare("SELECT name FROM spaces WHERE name = ?").get(space);
+  if (!existingSpace) {
+    throw new Error(`Space not found: ${space}`);
+  }
+  const previewChars = Number.isFinite(opts?.preview_chars) && opts?.preview_chars > 0 ? Math.floor(opts.preview_chars) : DEFAULT_PREVIEW_CHARS;
+  const currentMaxMessageId = db2.prepare("SELECT COALESCE(MAX(id), 0) AS max_id FROM messages WHERE space = ?").get(space).max_id;
+  db2.prepare(`
+    INSERT INTO space_subscriptions (space, agent, preview_chars, since_message_id)
+    VALUES (?, ?, ?, ?)
+    ON CONFLICT(space, agent) DO UPDATE SET preview_chars = excluded.preview_chars
+  `).run(space, agent, previewChars, currentMaxMessageId);
+  return db2.prepare("SELECT space, agent, created_at, preview_chars, since_message_id FROM space_subscriptions WHERE space = ? AND agent = ?").get(space, agent);
+}
+function unsubscribeFromSpaceNotifications(space, agent) {
+  const db2 = getDb();
+  const result = db2.prepare("DELETE FROM space_subscriptions WHERE space = ? AND agent = ?").run(space, agent);
+  return result.changes > 0;
+}
+function listSpaceNotificationSubscriptions(agent) {
+  const db2 = getDb();
+  if (agent) {
+    return db2.prepare("SELECT space, agent, created_at, preview_chars, since_message_id FROM space_subscriptions WHERE agent = ? ORDER BY created_at ASC, space ASC").all(agent);
+  }
+  return db2.prepare("SELECT space, agent, created_at, preview_chars, since_message_id FROM space_subscriptions ORDER BY agent ASC, space ASC").all();
+}
+function readSpaceNotifications(opts) {
+  const db2 = getDb();
+  const conditions = [
+    "s.agent = ?",
+    "m.space IS NOT NULL",
+    "m.from_agent != ?",
+    "m.id > s.since_message_id"
+  ];
+  const params = [opts.agent, opts.agent];
+  if (opts.space) {
+    conditions.push("m.space = ?");
+    params.push(opts.space);
+  }
+  if (opts.since) {
+    conditions.push("m.created_at > ?");
+    params.push(opts.since);
+  }
+  if (opts.unread_only !== false) {
+    conditions.push("snr.message_id IS NULL");
+  }
+  const limit = Number.isFinite(opts.limit) && opts.limit > 0 ? Math.floor(opts.limit) : 20;
+  const rows = db2.prepare(`
+    SELECT
+      m.id AS message_id,
+      m.space,
+      m.from_agent,
+      m.created_at,
+      m.priority,
+      m.content,
+      m.attachments,
+      s.preview_chars,
+      snr.message_id AS read_message_id
+    FROM messages m
+    INNER JOIN space_subscriptions s
+      ON s.space = m.space
+    LEFT JOIN space_notification_reads snr
+      ON snr.message_id = m.id AND snr.agent = s.agent
+    WHERE ${conditions.join(" AND ")}
+    ORDER BY m.created_at DESC, m.id DESC
+    LIMIT ${Math.max(1, Math.min(limit, 500))}
+  `).all(...params);
+  const notifications = rows.map((row) => ({
+    message_id: row.message_id,
+    space: row.space,
+    from_agent: row.from_agent,
+    created_at: row.created_at,
+    priority: row.priority,
+    preview: buildMessagePreview(row.content, row.preview_chars),
+    unread: row.read_message_id == null,
+    has_attachments: !!row.attachments && row.attachments !== "[]"
+  }));
+  if (opts.mark_read && notifications.length > 0) {
+    markSpaceNotificationsRead(opts.agent, notifications.map((row) => row.message_id));
+    for (const row of notifications)
+      row.unread = false;
+  }
+  return notifications;
+}
+function markSpaceNotificationsRead(agent, messageIds) {
+  if (messageIds.length === 0)
+    return 0;
+  const db2 = getDb();
+  const insert = db2.prepare(`
+    INSERT OR IGNORE INTO space_notification_reads (agent, message_id)
+    VALUES (?, ?)
+  `);
+  let count = 0;
+  for (const id of messageIds) {
+    const result = insert.run(agent, id);
+    count += result.changes;
+  }
+  return count;
+}
+function markAllSpaceNotificationsRead(agent, space) {
+  const unread = readSpaceNotifications({ agent, space, unread_only: true, limit: 1e4 });
+  return markSpaceNotificationsRead(agent, unread.map((row) => row.message_id));
+}
+
 // src/mcp/tools/spaces.ts
 init_identity();
 function registerSpaceTools(server) {
@@ -42226,6 +42419,7 @@ function registerSpaceTools(server) {
     if (fromParam && messages.length > 0) {
       const agent = resolveIdentity(fromParam);
       recordReadReceiptsBatch(messages.map((m) => m.id), agent);
+      markSpaceNotificationsRead(agent, messages.map((m) => m.id));
     }
     return {
       content: [{ type: "text", text: JSON.stringify(messages) }]
@@ -42265,6 +42459,86 @@ function registerSpaceTools(server) {
       content: [{ type: "text", text: JSON.stringify({ space, agent, left }) }]
     };
   });
+  server.registerTool("subscribe_space_notifications", {
+    description: "Subscribe an agent to preview-only notifications for a space.",
+    inputSchema: {
+      space: exports_external.string(),
+      from: exports_external.string().optional(),
+      preview_chars: exports_external.coerce.number().optional()
+    }
+  }, async (args) => {
+    const agent = resolveIdentity(args.from);
+    try {
+      const subscription = subscribeToSpaceNotifications(args.space, agent, { preview_chars: args.preview_chars });
+      return { content: [{ type: "text", text: JSON.stringify(subscription) }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: e.message }], isError: true };
+    }
+  });
+  server.registerTool("unsubscribe_space_notifications", {
+    description: "Stop preview-only notifications for a space.",
+    inputSchema: {
+      space: exports_external.string(),
+      from: exports_external.string().optional()
+    }
+  }, async (args) => {
+    const agent = resolveIdentity(args.from);
+    const unsubscribed = unsubscribeFromSpaceNotifications(args.space, agent);
+    return { content: [{ type: "text", text: JSON.stringify({ space: args.space, agent, unsubscribed }) }] };
+  });
+  server.registerTool("list_space_subscriptions", {
+    description: "List an agent's preview-only space notification subscriptions.",
+    inputSchema: {
+      from: exports_external.string().optional(),
+      space: exports_external.string().optional()
+    }
+  }, async (args) => {
+    const agent = resolveIdentity(args.from);
+    const subscriptions = listSpaceNotificationSubscriptions(agent).filter((row) => !args.space || row.space === args.space);
+    return { content: [{ type: "text", text: JSON.stringify(subscriptions) }] };
+  });
+  server.registerTool("read_space_notifications", {
+    description: "Read preview-only notifications for an agent's subscribed spaces. Returns blurbs, not full message bodies.",
+    inputSchema: {
+      from: exports_external.string().optional(),
+      space: exports_external.string().optional(),
+      unread_only: exports_external.coerce.boolean().optional(),
+      limit: exports_external.coerce.number().optional(),
+      since: exports_external.string().optional(),
+      mark_read: exports_external.coerce.boolean().optional()
+    }
+  }, async (args) => {
+    const agent = resolveIdentity(args.from);
+    const notifications = readSpaceNotifications({
+      agent,
+      space: args.space,
+      unread_only: args.unread_only,
+      limit: args.limit,
+      since: args.since,
+      mark_read: args.mark_read
+    });
+    return { content: [{ type: "text", text: JSON.stringify({ notifications, count: notifications.length }) }] };
+  });
+  server.registerTool("mark_space_notifications_read", {
+    description: "Mark preview-only space notifications as read for an agent.",
+    inputSchema: {
+      from: exports_external.string().optional(),
+      ids: exports_external.array(exports_external.coerce.number()).optional(),
+      space: exports_external.string().optional(),
+      all: exports_external.coerce.boolean().optional()
+    }
+  }, async (args) => {
+    const agent = resolveIdentity(args.from);
+    let marked = 0;
+    if (args.all) {
+      marked = markAllSpaceNotificationsRead(agent, args.space);
+    } else if (Array.isArray(args.ids) && args.ids.length > 0) {
+      marked = markSpaceNotificationsRead(agent, args.ids);
+    } else {
+      return { content: [{ type: "text", text: "Provide ids or all=true" }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify({ marked_read: marked }) }] };
+  });
   server.registerTool("update_space", {
     description: "Update space description or parent.",
     inputSchema: {
@@ -42807,7 +43081,8 @@ function registerProjectTools(server) {
 init_identity();
 
 // src/mcp/channel.ts
-var POLL_INTERVAL_MS = 1000;
+var DEFAULT_POLL_INTERVAL_MS = 1000;
+var DEFAULT_START_DELAY_MS = 2000;
 var sessionAgentId = null;
 var sessionClaudeId = null;
 function setSessionAgent(agentId, claudeSessionId) {
@@ -42828,83 +43103,126 @@ function getSessionAgent() {
 function getClaudeSessionId() {
   return sessionClaudeId || process.env.CONVERSATIONS_SESSION_ID || null;
 }
-function registerChannelBridge(server) {
+function registerChannelBridge(server, opts) {
   server.server.registerCapabilities({
     experimental: { "claude/channel": {} }
   });
+  const pollIntervalMs = opts?.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+  const startDelayMs = opts?.startDelayMs ?? DEFAULT_START_DELAY_MS;
   let lastAgentMsgId = 0;
   let lastSessionMsgId = 0;
   let pollTimer = null;
+  let startTimer = null;
+  let polling = false;
   function getSessionId() {
     return getClaudeSessionId();
   }
-  function seedLastSeen() {
-    const agent = getSessionAgent();
-    const sid = getSessionId();
-    if (agent) {
-      const latest = readMessages({ to: agent, order: "desc", limit: 1 });
-      if (latest.length > 0)
-        lastAgentMsgId = latest[0].id;
-    }
-    if (sid) {
-      const latest = readMessages({ to: `session:${sid}`, order: "desc", limit: 1 });
-      if (latest.length > 0)
-        lastSessionMsgId = latest[0].id;
-    }
-  }
-  function pushNotification(msg, isDirect) {
-    if (isDirect) {
-      try {
-        markReadByIds([msg.id]);
-      } catch {}
-    }
-    const senderSession = msg.session_id;
-    const replyHint = `To reply, use conversations send_message with to="${msg.from_agent}". For direct session injection, use send_to_session with target_session_id from the sender's session.`;
-    const enrichedContent = `${msg.content}
+  async function pushNotification(msg, mode) {
+    const enrichedContent = mode === "space_blurb" ? `${msg.from_agent} posted in #${msg.space}: ${msg.content}
 
 ---
-[Via Conversations from ${msg.from_agent} (msg #${msg.id}). ${replyHint}]`;
-    server.server.notification({
-      method: "notifications/claude/channel",
-      params: {
-        content: enrichedContent,
-        meta: {
-          from: msg.from_agent,
-          message_id: String(msg.id),
-          session_id: msg.session_id,
-          mode: isDirect ? "direct" : "dm",
-          ...msg.space ? { space: msg.space } : {},
-          ...msg.priority && msg.priority !== "normal" ? { priority: msg.priority } : {}
+[Preview only for space message #${msg.id}. To inspect the full message later, call get_message with id=${msg.id} or run conversations show ${msg.id}.]` : `${msg.content}
+
+---
+[Via Conversations from ${msg.from_agent} (msg #${msg.id}). To reply, use conversations send_message with to="${msg.from_agent}". For direct session injection, use send_to_session with target_session_id from the sender's session.]`;
+    try {
+      await server.server.notification({
+        method: "notifications/claude/channel",
+        params: {
+          content: enrichedContent,
+          meta: {
+            from: msg.from_agent,
+            message_id: String(msg.id),
+            session_id: msg.session_id,
+            mode,
+            ...msg.space ? { space: msg.space } : {},
+            ...msg.priority && msg.priority !== "normal" ? { priority: msg.priority } : {}
+          }
+        }
+      });
+      if (mode === "direct") {
+        try {
+          markReadByIds([msg.id]);
+        } catch {}
+      } else if (mode === "space_blurb") {
+        const agent = getSessionAgent();
+        if (agent) {
+          try {
+            markSpaceNotificationsRead(agent, [msg.id]);
+          } catch {}
         }
       }
-    }).catch(() => {});
+      return true;
+    } catch {
+      return false;
+    }
   }
-  function startPolling() {
-    if (pollTimer)
+  async function pollOnce() {
+    if (polling)
       return;
-    seedLastSeen();
-    pollTimer = setInterval(() => {
-      try {
-        const agent = getSessionAgent();
-        const sid = getSessionId();
-        if (agent) {
-          const msgs = readMessages({ to: agent, order: "asc", limit: 20 }).filter((m) => m.id > lastAgentMsgId && m.from_agent !== agent);
-          for (const msg of msgs) {
-            lastAgentMsgId = msg.id;
-            pushNotification(msg, false);
-          }
+    polling = true;
+    try {
+      const agent = getSessionAgent();
+      const sid = getSessionId();
+      if (agent) {
+        const msgs = readMessages({ to: agent, unread_only: true, order: "asc", limit: 20 }).filter((m) => m.id > lastAgentMsgId && m.from_agent !== agent);
+        for (const msg of msgs) {
+          const delivered = await pushNotification(msg, "dm");
+          if (!delivered)
+            break;
+          lastAgentMsgId = msg.id;
         }
-        if (sid) {
-          const msgs = readMessages({ to: `session:${sid}`, order: "asc", limit: 20 }).filter((m) => m.id > lastSessionMsgId && m.from_agent !== agent);
-          for (const msg of msgs) {
-            lastSessionMsgId = msg.id;
-            pushNotification(msg, true);
-          }
+      }
+      if (sid) {
+        const msgs = readMessages({ to: `session:${sid}`, unread_only: true, order: "asc", limit: 20 }).filter((m) => m.id > lastSessionMsgId && m.from_agent !== agent);
+        for (const msg of msgs) {
+          const delivered = await pushNotification(msg, "direct");
+          if (!delivered)
+            break;
+          lastSessionMsgId = msg.id;
         }
-      } catch {}
-    }, POLL_INTERVAL_MS);
+      }
+      if (agent) {
+        const notifications = readSpaceNotifications({
+          agent,
+          unread_only: true,
+          limit: 20,
+          mark_read: false
+        }).sort((left, right) => left.created_at.localeCompare(right.created_at) || left.message_id - right.message_id);
+        for (const notification of notifications) {
+          const delivered = await pushNotification({
+            id: notification.message_id,
+            content: notification.preview,
+            from_agent: notification.from_agent,
+            session_id: `space:${notification.space}`,
+            space: notification.space,
+            priority: notification.priority
+          }, "space_blurb");
+          if (!delivered)
+            break;
+        }
+      }
+    } finally {
+      polling = false;
+    }
   }
-  setTimeout(() => startPolling(), 2000);
+  function startPolling() {
+    if (pollTimer)
+      return;
+    pollTimer = setInterval(() => {
+      pollOnce().catch(() => {});
+    }, pollIntervalMs);
+    pollOnce().catch(() => {});
+  }
+  startTimer = setTimeout(() => startPolling(), startDelayMs);
+  return () => {
+    if (startTimer)
+      clearTimeout(startTimer);
+    if (pollTimer)
+      clearInterval(pollTimer);
+    startTimer = null;
+    pollTimer = null;
+  };
 }
 
 // src/mcp/tools/agents.ts
@@ -44139,6 +44457,7 @@ function registerAdvancedTools(server, pkgVersion) {
     const all = [
       "send_message",
       "read_messages",
+      "get_message",
       "read_digest",
       "list_sessions",
       "reply",
@@ -44154,6 +44473,11 @@ function registerAdvancedTools(server, pkgVersion) {
       "update_space",
       "archive_space",
       "unarchive_space",
+      "subscribe_space_notifications",
+      "unsubscribe_space_notifications",
+      "list_space_subscriptions",
+      "read_space_notifications",
+      "mark_space_notifications_read",
       "create_project",
       "list_projects",
       "get_project",
@@ -44209,6 +44533,7 @@ function registerAdvancedTools(server, pkgVersion) {
     const descriptions = {
       send_message: "Send DM to agent. Required: to, content. Optional: from?, priority?(low|normal|high|urgent), blocking?",
       read_messages: "Read messages with filters. Optional: session_id?, from?, to?, space?, since?(ISO), limit?, unread_only?, mark_read?(default true \u2014 auto-marks returned messages as read, pass false to peek without consuming)",
+      get_message: "Get the full content of a specific message by id. Required: id",
       read_digest: "Lightweight unread digest \u2014 preview only (no full bodies), auto-marks read, never overflows tokens. Returns { messages, total_unread, shown }. Optional: space?, session_id?, to?, since?(ISO), limit?, project_id?",
       list_sessions: "List all DM sessions. Optional: agent?(filter by participant)",
       reply: "Reply to a specific message, creating a thread (sets reply_to). Use read_thread to retrieve. Required: message_id, content. Optional: from?",
@@ -44226,6 +44551,11 @@ function registerAdvancedTools(server, pkgVersion) {
       update_space: "Update space fields. Required: name. Optional: description?, parent_id?(use 'null' to remove), project_id?(use 'null' to remove)",
       archive_space: "Archive a space (hidden from default list). Required: name",
       unarchive_space: "Restore archived space. Required: name",
+      subscribe_space_notifications: "Subscribe to preview-only notifications for a space. Required: space. Optional: from?, preview_chars?",
+      unsubscribe_space_notifications: "Stop preview-only notifications for a space. Required: space. Optional: from?",
+      list_space_subscriptions: "List preview-only space notification subscriptions for the current agent. Optional: from?, space?",
+      read_space_notifications: "Read preview-only notifications from subscribed spaces. Returns blurbs instead of full message bodies. Optional: from?, space?, unread_only?, since?, limit?, mark_read?",
+      mark_space_notifications_read: "Mark preview-only space notifications as read. Optional: from?, ids?(array), space?, all?(bool)",
       create_project: "Create a project. Required: name. Optional: from?, description?, path?, repository?, tags?(JSON array), metadata?(JSON), settings?(JSON)",
       list_projects: "List projects. Optional: status?(active|archived)",
       get_project: "Get project by UUID or name. Required: id",
@@ -44572,7 +44902,7 @@ function formatError2(e) {
 }
 
 // src/mcp/telegram-channel.ts
-var POLL_INTERVAL_MS2 = 2000;
+var POLL_INTERVAL_MS = 2000;
 async function telegramRequest(token, method, params) {
   const url2 = `https://api.telegram.org/bot${token}/${method}`;
   const res = await fetch(url2, {
@@ -44655,7 +44985,7 @@ ${msg.text}`;
     } catch {}
   }
   setTimeout(() => {
-    pollTimer = setInterval(() => poll(), POLL_INTERVAL_MS2);
+    pollTimer = setInterval(() => poll(), POLL_INTERVAL_MS);
     console.error("[telegram-channel] polling started");
   }, 2000);
 }
@@ -44808,7 +45138,7 @@ function registerTmuxTools(server) {
 // package.json
 var package_default = {
   name: "@hasna/conversations",
-  version: "0.2.45",
+  version: "0.2.47",
   description: "Real-time CLI messaging for AI agents",
   type: "module",
   bin: {

package/dist/index.d.ts

@@ -13,6 +13,7 @@ export { sendMessage, readMessages, markRead, markSessionRead, markSpaceRead, ma
 export { listSessions, getSession, getSessionActivity, } from "./lib/sessions.js";
 export type { SessionActivity } from "./lib/sessions.js";
 export { createSpace, updateSpace, archiveSpace, unarchiveSpace, listSpaces, getSpace, joinSpace, leaveSpace, getSpaceMembers, isSpaceMember, getSpaceDepth, } from "./lib/spaces.js";
+export { buildMessagePreview, subscribeToSpaceNotifications, unsubscribeFromSpaceNotifications, listSpaceNotificationSubscriptions, getSubscribedSpaces, readSpaceNotifications, markSpaceNotificationsRead, markAllSpaceNotificationsRead, } from "./lib/space-notifications.js";
 export { createProject, listProjects, getProject, getProjectByName, updateProject, deleteProject, } from "./lib/projects.js";
 export { getDb, getDbPath, closeDb, } from "./lib/db.js";
 export { startPolling, useMessages, useSpaceMessages, } from "./lib/poll.js";