@hasna/conversations 0.2.44 → 0.2.46

package/bin/index.js

@@ -13571,6 +13571,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,
@@ -13611,6 +13623,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")) {
@@ -13658,6 +13680,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")) {
@@ -15261,11 +15296,127 @@ var init_presence = __esm(() => {
   CONFLICT_THRESHOLD_SECONDS = 30 * 60;
 });
 
+// src/lib/space-notifications.ts
+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));
+}
+var DEFAULT_PREVIEW_CHARS = 140;
+var init_space_notifications = __esm(() => {
+  init_db();
+});
+
 // package.json
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/conversations",
-    version: "0.2.44",
+    version: "0.2.46",
     description: "Real-time CLI messaging for AI agents",
     type: "module",
     bin: {
@@ -45160,6 +45311,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_external2.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: {
@@ -45554,6 +45722,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) }]
@@ -45593,6 +45762,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_external2.string(),
+      from: exports_external2.string().optional(),
+      preview_chars: exports_external2.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_external2.string(),
+      from: exports_external2.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_external2.string().optional(),
+      space: exports_external2.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_external2.string().optional(),
+      space: exports_external2.string().optional(),
+      unread_only: exports_external2.coerce.boolean().optional(),
+      limit: exports_external2.coerce.number().optional(),
+      since: exports_external2.string().optional(),
+      mark_read: exports_external2.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_external2.string().optional(),
+      ids: exports_external2.array(exports_external2.coerce.number()).optional(),
+      space: exports_external2.string().optional(),
+      all: exports_external2.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: {
@@ -45750,6 +45999,7 @@ var init_spaces2 = __esm(() => {
   init_zod2();
   init_messages();
   init_spaces();
+  init_space_notifications();
   init_identity();
   init_messages();
 });
@@ -45981,87 +46231,131 @@ 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 startPolling2() {
-    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(() => startPolling2(), 2000);
+  function startPolling2() {
+    if (pollTimer)
+      return;
+    pollTimer = setInterval(() => {
+      pollOnce().catch(() => {});
+    }, pollIntervalMs);
+    pollOnce().catch(() => {});
+  }
+  startTimer = setTimeout(() => startPolling2(), startDelayMs);
+  return () => {
+    if (startTimer)
+      clearTimeout(startTimer);
+    if (pollTimer)
+      clearInterval(pollTimer);
+    startTimer = null;
+    pollTimer = null;
+  };
 }
-var POLL_INTERVAL_MS = 1000, sessionAgentId = null, sessionClaudeId = null;
+var DEFAULT_POLL_INTERVAL_MS = 1000, DEFAULT_START_DELAY_MS = 2000, sessionAgentId = null, sessionClaudeId = null;
 var init_channel = __esm(() => {
   init_messages();
+  init_space_notifications();
 });
 
 // src/mcp/tools/agents.ts
@@ -46784,6 +47078,7 @@ function registerAdvancedTools(server, pkgVersion) {
     const all = [
       "send_message",
       "read_messages",
+      "get_message",
       "read_digest",
       "list_sessions",
       "reply",
@@ -46799,6 +47094,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",
@@ -46854,6 +47154,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?",
@@ -46871,6 +47172,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",
@@ -46987,6 +47293,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,
@@ -47064,6 +47388,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,
@@ -47497,11 +47830,11 @@ ${msg.text}`;
     } catch {}
   }
   setTimeout(() => {
-    pollTimer = setInterval(() => poll(), POLL_INTERVAL_MS2);
+    pollTimer = setInterval(() => poll(), POLL_INTERVAL_MS);
     console.error("[telegram-channel] polling started");
   }, 2000);
 }
-var POLL_INTERVAL_MS2 = 2000;
+var POLL_INTERVAL_MS = 2000;
 var init_telegram_channel = __esm(() => {
   init_zod2();
 });
@@ -49362,7 +49695,7 @@ init_db();
 init_identity();
 init_terminal_markdown();
 init_presence();
-init_db();
+init_space_notifications();
 import chalk4 from "chalk";
 function registerMessagingCommands(program2) {
   program2.command("send").description("Send a message to an agent").argument("<message>", "Message content").option("--to <agent>", "Recipient agent ID (required unless --space is used)").option("--from <agent>", "Sender agent ID").option("--session <id>", "Session ID (auto-generated if omitted)").option("--priority <level>", "Priority: low, normal, high, urgent", "normal").option("--working-dir <path>", "Working directory context").option("--repository <repo>", "Repository context").option("--branch <branch>", "Branch context").option("--metadata <json>", "JSON metadata string").option("--space <name>", "Send to a space instead of a specific agent").option("--blocking", "Send as a blocking message (recipient must acknowledge)").option("-j, --json", "Output as JSON").action((message, opts) => {
@@ -49459,6 +49792,32 @@ function registerMessagingCommands(program2) {
     }
     closeDb();
   });
+  program2.command("show").description("Show a full message by ID").argument("<id>", "Numeric message ID").option("-j, --json", "Output as JSON").action((idArg, opts) => {
+    const id = Number.parseInt(String(idArg), 10);
+    if (!Number.isFinite(id) || id <= 0) {
+      console.error(chalk4.red("Message ID must be a positive integer."));
+      process.exit(1);
+    }
+    const msg = getMessageById(id);
+    if (!msg) {
+      console.error(chalk4.red(`Message #${id} not found.`));
+      process.exit(1);
+    }
+    if (opts.json) {
+      console.log(JSON.stringify(msg, null, 2));
+    } else {
+      const time = chalk4.dim(msg.created_at.slice(0, 19).replace("T", " "));
+      const destination = msg.space ? chalk4.magenta(`#${msg.space}`) : chalk4.yellow(msg.to_agent);
+      const priority = msg.priority !== "normal" ? chalk4.red(` [${msg.priority}]`) : "";
+      const unread = !msg.read_at ? chalk4.green(" [unread]") : "";
+      console.log(`${chalk4.cyan(msg.from_agent)} \u2192 ${destination}${priority}${unread} ${chalk4.dim(`[#${msg.id}] ${time}`)}`);
+      if (msg.attachments?.length) {
+        console.log(chalk4.dim(`Attachments: ${msg.attachments.map((att) => att.name).join(", ")}`));
+      }
+      console.log(renderContent(msg.content));
+    }
+    closeDb();
+  });
   program2.command("digest").description("Show unread message digest (preview only, auto-marks read)").argument("[space]", "Space name to digest (omit for DMs)").option("--since <timestamp>", "Messages after this ISO timestamp").option("--limit <n>", "Max messages to show", parseInt).option("--to <agent>", "Filter by recipient (for DMs)").option("-j, --json", "Output as JSON").action((spaceArg, opts) => {
     const result = readDigest({
       space: spaceArg || undefined,
@@ -49734,6 +50093,44 @@ Acknowledge with: conversations mark-read ${blockers.map((b) => b.id).join(" ")}
     }
     closeDb();
   });
+  program2.command("notifications").description("List preview-only notifications from subscribed spaces").option("--from <agent>", "Your agent identity").option("--space <name>", "Filter to a single space").option("--since <timestamp>", "Notifications after this ISO timestamp").option("--limit <n>", "Max notifications to return", parseInt).option("--all", "Include already-read notifications").option("--mark-read", "Mark returned notifications as read").option("--clear", "Mark all matching unread notifications as read without listing").option("-j, --json", "Output as JSON").action((opts) => {
+    const agent = resolveIdentity(opts.from);
+    heartbeat(agent);
+    if (opts.clear) {
+      const cleared = markAllSpaceNotificationsRead(agent, opts.space);
+      if (opts.json) {
+        console.log(JSON.stringify({ cleared, agent, space: opts.space || null }, null, 2));
+      } else {
+        console.log(chalk4.green(`Cleared ${cleared} notification(s).`));
+      }
+      closeDb();
+      return;
+    }
+    const notifications = readSpaceNotifications({
+      agent,
+      space: opts.space,
+      since: opts.since,
+      unread_only: !opts.all,
+      limit: opts.limit,
+      mark_read: opts.markRead
+    });
+    if (opts.json) {
+      console.log(JSON.stringify(notifications, null, 2));
+    } else if (notifications.length === 0) {
+      console.log(chalk4.dim("No space notifications."));
+    } else {
+      for (const item of notifications) {
+        const time = chalk4.dim(item.created_at.slice(11, 19));
+        const priority = item.priority !== "normal" ? chalk4.red(` [${item.priority}]`) : "";
+        const unread = item.unread ? chalk4.yellow(" [unread]") : "";
+        console.log(`${time} ${chalk4.cyan(item.from_agent)} ${chalk4.magenta(`#${item.space}`)}${priority}${unread} ${chalk4.dim(`msg #${item.message_id}`)}`);
+        console.log(`  ${item.preview}`);
+      }
+      console.log(chalk4.dim(`
+Inspect the full message later with: conversations show <message-id>`));
+    }
+    closeDb();
+  });
   program2.command("watch").description("Watch for new messages with desktop notifications").option("--from <agent>", "Your agent identity").option("--space <name>", "Watch a specific space").option("--all", "Watch DMs and all subscribed spaces").option("--interval <ms>", "Poll interval in milliseconds", parseInt).action((opts) => {
     const agent = resolveIdentity(opts.from);
     heartbeat(agent);
@@ -49741,9 +50138,7 @@ Acknowledge with: conversations mark-read ${blockers.map((b) => b.id).join(" ")}
     const cols = Math.min(process.stdout.columns || 80, 100);
     let agentSpaces = [];
     if (opts.all) {
-      const db2 = getDb();
-      const rows = db2.prepare("SELECT space FROM space_members WHERE agent = ?").all(agent);
-      agentSpaces = rows.map((r) => r.space);
+      agentSpaces = listSpaceNotificationSubscriptions(agent).map((row) => row.space);
     }
     const modeLabel = opts.all ? `DMs + ${agentSpaces.length} space(s)` : opts.space ? `Space: #${opts.space}` : "All DMs";
     console.log("");
@@ -49778,19 +50173,39 @@ Acknowledge with: conversations mark-read ${blockers.map((b) => b.id).join(" ")}
       console.log(chalk4.dim("    " + "\xB7".repeat(Math.min(cols - 8, 60))));
       console.log("");
     };
+    const renderNotification = (notification) => {
+      const time = chalk4.dim(notification.created_at.slice(11, 19));
+      const priority = notification.priority !== "normal" ? notification.priority === "urgent" ? chalk4.red.bold(` [${notification.priority}]`) : notification.priority === "high" ? chalk4.yellow(` [${notification.priority}]`) : chalk4.dim(` [${notification.priority}]`) : "";
+      const sender = chalk4.cyan.bold(notification.from_agent);
+      console.log(`  ${sender}  ${chalk4.magenta(`#${notification.space}`)}  ${time}${priority} ${chalk4.dim(`[#${notification.message_id}]`)}`);
+      console.log(`    ${notification.preview}`);
+      console.log(chalk4.dim(`    Preview only. Inspect with: conversations show ${notification.message_id}`));
+      console.log(chalk4.dim("    " + "\xB7".repeat(Math.min(cols - 8, 60))));
+      console.log("");
+    };
     if (opts.all) {
       const dmRecent = readMessages({ to: agent, limit: 20, order: "asc" });
-      const spaceRecent = [];
-      for (const sp of agentSpaces) {
-        spaceRecent.push(...readMessages({ space: sp, limit: 10, order: "asc" }));
-      }
-      const recent = [...dmRecent, ...spaceRecent].sort((a, b) => a.created_at.localeCompare(b.created_at)).slice(-20);
-      if (recent.length > 0) {
-        console.log(chalk4.dim(`  \u2500\u2500 Recent messages (${recent.length}) \u2500\u2500
+      const pendingNotifications = readSpaceNotifications({
+        agent,
+        unread_only: true,
+        limit: 20,
+        mark_read: true
+      }).sort((left, right) => left.created_at.localeCompare(right.created_at) || left.message_id - right.message_id);
+      if (dmRecent.length > 0) {
+        console.log(chalk4.dim(`  \u2500\u2500 Recent DMs (${dmRecent.length}) \u2500\u2500
 `));
-        for (const msg of recent) {
+        for (const msg of dmRecent) {
           renderMessage(msg);
         }
+      }
+      if (pendingNotifications.length > 0) {
+        console.log(chalk4.dim(`  \u2500\u2500 Pending space notifications (${pendingNotifications.length}) \u2500\u2500
+`));
+        for (const notification of pendingNotifications) {
+          renderNotification(notification);
+        }
+      }
+      if (dmRecent.length > 0 || pendingNotifications.length > 0) {
         console.log(chalk4.dim(`  \u2500\u2500 Live \u2500\u2500
 `));
       }
@@ -49817,24 +50232,50 @@ Acknowledge with: conversations mark-read ${blockers.map((b) => b.id).join(" ")}
           continue;
         renderMessage(msg);
         const where = msg.space ? `#${msg.space}` : "DM";
-        const preview = msg.content.replace(/[*#`~_>\-]/g, "").slice(0, 150);
+        const preview = buildMessagePreview(msg.content, 150);
         desktopNotify(`${msg.from_agent} (${where})`, preview);
       }
     };
-    if (opts.all) {
-      startPolling2({ to_agent: agent, interval_ms: interval, on_messages: onNewMessages });
-      for (const sp of agentSpaces) {
-        startPolling2({ space: sp, interval_ms: interval, on_messages: onNewMessages });
+    const onNewNotifications = (notifications) => {
+      for (const notification of notifications) {
+        renderNotification(notification);
+        desktopNotify(`${notification.from_agent} (#${notification.space})`, notification.preview);
       }
+    };
+    const stops = [];
+    if (opts.all) {
+      stops.push(startPolling2({ to_agent: agent, interval_ms: interval, on_messages: onNewMessages }));
+      let inFlightNotifications = false;
+      const timer = setInterval(() => {
+        if (inFlightNotifications)
+          return;
+        inFlightNotifications = true;
+        try {
+          const notifications = readSpaceNotifications({
+            agent,
+            unread_only: true,
+            limit: 200,
+            mark_read: true
+          }).sort((left, right) => left.created_at.localeCompare(right.created_at) || left.message_id - right.message_id);
+          if (notifications.length > 0) {
+            onNewNotifications(notifications);
+          }
+        } finally {
+          inFlightNotifications = false;
+        }
+      }, interval);
+      stops.push({ stop: () => clearInterval(timer) });
     } else {
-      startPolling2({
+      stops.push(startPolling2({
         to_agent: opts.space ? undefined : agent,
         space: opts.space,
         interval_ms: interval,
         on_messages: onNewMessages
-      });
+      }));
     }
     process.on("SIGINT", () => {
+      for (const stop of stops)
+        stop.stop();
       console.log(chalk4.dim(`
   Stopped watching.`));
       closeDb();
@@ -49900,6 +50341,7 @@ Update failed (exit code ${exitCode})`));
 // src/cli/commands/spaces.ts
 init_messages();
 init_spaces();
+init_space_notifications();
 init_db();
 init_identity();
 init_terminal_markdown();
@@ -50067,7 +50509,7 @@ function registerSpaceCommands(program2) {
     }
     closeDb();
   });
-  space.command("read").description("Read messages from a space").argument("<space>", "Space name").option("--since <timestamp>", "Messages after this ISO timestamp").option("--limit <n>", "Max messages to return", parseInt).option("-j, --json", "Output as JSON").action((spaceName, opts) => {
+  space.command("read").description("Read messages from a space").argument("<space>", "Space name").option("--from <agent>", "Agent reading the space").option("--since <timestamp>", "Messages after this ISO timestamp").option("--limit <n>", "Max messages to return", parseInt).option("-j, --json", "Output as JSON").action((spaceName, opts) => {
     const spaceArg = typeof spaceName === "string" ? spaceName.trim() : "";
     if (!spaceArg) {
       console.error(chalk5.red("Space name cannot be empty."));
@@ -50078,6 +50520,15 @@ function registerSpaceCommands(program2) {
       since: opts.since,
       limit: opts.limit
     });
+    if (opts.from && messages.length > 0) {
+      const agent = resolveIdentity(opts.from).trim();
+      if (!agent) {
+        console.error(chalk5.red("Agent identity is required."));
+        process.exit(1);
+      }
+      recordReadReceiptsBatch(messages.map((m) => m.id), agent);
+      markSpaceNotificationsRead(agent, messages.map((m) => m.id));
+    }
     if (opts.json) {
       console.log(JSON.stringify(messages, null, 2));
     } else {
@@ -50145,6 +50596,73 @@ function registerSpaceCommands(program2) {
     }
     closeDb();
   });
+  space.command("subscribe").description("Subscribe to preview-only notifications for a space").argument("<space>", "Space name").option("--from <agent>", "Agent ID").option("--preview-chars <n>", "Preview length", parseInt).option("-j, --json", "Output as JSON").action((spaceName, opts) => {
+    const agent = resolveIdentity(opts.from).trim();
+    const spaceArg = typeof spaceName === "string" ? spaceName.trim() : "";
+    if (!agent) {
+      console.error(chalk5.red("Agent identity is required."));
+      process.exit(1);
+    }
+    if (!spaceArg) {
+      console.error(chalk5.red("Space name cannot be empty."));
+      process.exit(1);
+    }
+    try {
+      const subscription = subscribeToSpaceNotifications(spaceArg, agent, { preview_chars: opts.previewChars });
+      if (opts.json) {
+        console.log(JSON.stringify(subscription, null, 2));
+      } else {
+        console.log(chalk5.green(`${agent} subscribed to #${spaceArg} notifications`) + chalk5.dim(` (${subscription.preview_chars} chars)`));
+      }
+    } catch (e) {
+      console.error(chalk5.red(e.message));
+      process.exit(1);
+    }
+    closeDb();
+  });
+  space.command("unsubscribe").description("Stop preview-only notifications for a space").argument("<space>", "Space name").option("--from <agent>", "Agent ID").option("-j, --json", "Output as JSON").action((spaceName, opts) => {
+    const agent = resolveIdentity(opts.from).trim();
+    const spaceArg = typeof spaceName === "string" ? spaceName.trim() : "";
+    if (!agent) {
+      console.error(chalk5.red("Agent identity is required."));
+      process.exit(1);
+    }
+    if (!spaceArg) {
+      console.error(chalk5.red("Space name cannot be empty."));
+      process.exit(1);
+    }
+    const unsubscribed = unsubscribeFromSpaceNotifications(spaceArg, agent);
+    if (opts.json) {
+      console.log(JSON.stringify({ space: spaceArg, agent, unsubscribed }));
+    } else if (unsubscribed) {
+      console.log(chalk5.green(`${agent} unsubscribed from #${spaceArg} notifications`));
+    } else {
+      console.log(chalk5.dim(`${agent} had no notification subscription for #${spaceArg}`));
+    }
+    closeDb();
+  });
+  space.command("subscriptions").description("List preview-only space notification subscriptions").option("--from <agent>", "Agent ID").option("--space <name>", "Filter by space").option("-j, --json", "Output as JSON").action((opts) => {
+    const agent = resolveIdentity(opts.from).trim();
+    if (!agent) {
+      console.error(chalk5.red("Agent identity is required."));
+      process.exit(1);
+    }
+    let subscriptions = listSpaceNotificationSubscriptions(agent);
+    if (opts.space) {
+      subscriptions = subscriptions.filter((row) => row.space === opts.space);
+    }
+    if (opts.json) {
+      console.log(JSON.stringify(subscriptions, null, 2));
+    } else if (subscriptions.length === 0) {
+      console.log(chalk5.dim(`No notification subscriptions for ${agent}.`));
+    } else {
+      console.log(chalk5.bold(`${agent} notification subscriptions:`));
+      for (const row of subscriptions) {
+        console.log(`  ${chalk5.magenta(`#${row.space}`)} ${chalk5.dim(`preview ${row.preview_chars} chars`)}`);
+      }
+    }
+    closeDb();
+  });
   space.command("members").description("List space members").argument("<space>", "Space name").option("-j, --json", "Output as JSON").action((spaceName, opts) => {
     const spaceArg = typeof spaceName === "string" ? spaceName.trim() : "";
     if (!spaceArg) {
@@ -50573,6 +51091,7 @@ init_hot();
 init_topics();
 init_summary();
 init_graph();
+init_space_notifications();
 var import__package = __toESM(require_package(), 1);
 import chalk8 from "chalk";
 function registerAnalyticsCommands(program2) {
@@ -50726,8 +51245,22 @@ function registerAnalyticsCommands(program2) {
         WHERE sm.agent = ?
         ORDER BY s.name
       `).all(agent);
+    const subscriptions = listSpaceNotificationSubscriptions(agent);
+    const spaceNotifications = readSpaceNotifications({
+      agent,
+      unread_only: true,
+      limit: 5
+    });
     const recentDMs = readMessages({ to: agent, limit: 3 });
-    const context = { agent, online_agents: onlineAgents, unread_dms: unreadDMs, spaces: mySpaces, recent_dms: recentDMs };
+    const context = {
+      agent,
+      online_agents: onlineAgents,
+      unread_dms: unreadDMs,
+      spaces: mySpaces,
+      space_subscriptions: subscriptions,
+      space_notifications: spaceNotifications,
+      recent_dms: recentDMs
+    };
     if (opts.json) {
       console.log(JSON.stringify(context, null, 2));
     } else {
@@ -50756,6 +51289,24 @@ function registerAnalyticsCommands(program2) {
       } else {
         console.log(`${chalk8.bold("My spaces:")} ${chalk8.dim("none")}`);
       }
+      if (subscriptions.length > 0) {
+        console.log(`${chalk8.bold("Subscribed spaces:")}`);
+        for (const row of subscriptions) {
+          console.log(`  ${chalk8.magenta("#" + row.space)} ${chalk8.dim(`preview ${row.preview_chars} chars`)}`);
+        }
+      } else {
+        console.log(`${chalk8.bold("Subscribed spaces:")} ${chalk8.dim("none")}`);
+      }
+      if (spaceNotifications.length > 0) {
+        console.log(`${chalk8.bold("Space notifications:")}`);
+        for (const notification of spaceNotifications) {
+          console.log(`  ${chalk8.dim(notification.created_at.slice(11, 16))} ${chalk8.cyan(notification.from_agent)} ${chalk8.magenta("#" + notification.space)} ${chalk8.dim(`msg #${notification.message_id}`)}`);
+          console.log(`    ${chalk8.dim(notification.preview)}`);
+        }
+        console.log(chalk8.dim("  Inspect with: conversations show <message-id>"));
+      } else {
+        console.log(`${chalk8.bold("Space notifications:")} ${chalk8.dim("none")}`);
+      }
     }
     closeDb();
   });