@hasna/conversations 0.2.45 → 0.2.47

package/dist/index.js

@@ -9680,6 +9680,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,
@@ -9720,6 +9732,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")) {
@@ -9767,6 +9789,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")) {
@@ -12568,6 +12603,122 @@ function isSpaceMember(spaceName, agent) {
   const row = db2.prepare("SELECT 1 FROM space_members WHERE space = ? AND agent = ?").get(spaceName, agent);
   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 getSubscribedSpaces(agent) {
+  return listSpaceNotificationSubscriptions(agent).map((row) => row.space);
+}
+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/lib/projects.ts
 init_db();
 import { randomUUID as randomUUID2 } from "crypto";
@@ -14221,9 +14372,11 @@ export {
   useMessages,
   updateSpace,
   updateProject,
+  unsubscribeFromSpaceNotifications,
   unpinMessage,
   unarchiveSpace,
   tryBulkAcquireLock,
+  subscribeToSpaceNotifications,
   startPolling,
   setActiveModel,
   sendMessage,
@@ -14236,13 +14389,17 @@ export {
   releaseStaleAgentLocks,
   releaseLock,
   registerAgent,
+  readSpaceNotifications,
   readMessages,
   pinMessage,
   markSpaceRead,
+  markSpaceNotificationsRead,
   markSessionRead,
   markRead,
+  markAllSpaceNotificationsRead,
   markAllRead,
   listSpaces,
+  listSpaceNotificationSubscriptions,
   listSessions,
   listProjects,
   listLocksEnriched,
@@ -14257,6 +14414,7 @@ export {
   getUnreadBlockers,
   getTrendingTopics,
   getThreadReplies,
+  getSubscribedSpaces,
   getSpaceTopics,
   getSpaceMembers,
   getSpaceDepth,
@@ -14292,6 +14450,7 @@ export {
   clearActiveModel,
   cleanExpiredLocks,
   checkLock,
+  buildMessagePreview,
   buildGraph,
   archiveSpace,
   addReaction,

package/dist/lib/space-notifications.d.ts

@@ -0,0 +1,19 @@
+import type { SpaceNotification, SpaceNotificationSubscription } from "../types.js";
+export declare function buildMessagePreview(content: string, maxChars?: number): string;
+export declare function subscribeToSpaceNotifications(space: string, agent: string, opts?: {
+    preview_chars?: number;
+}): SpaceNotificationSubscription;
+export declare function unsubscribeFromSpaceNotifications(space: string, agent: string): boolean;
+export declare function listSpaceNotificationSubscriptions(agent?: string): SpaceNotificationSubscription[];
+export declare function getSubscribedSpaces(agent: string): string[];
+export interface ReadSpaceNotificationsOptions {
+    agent: string;
+    space?: string;
+    unread_only?: boolean;
+    limit?: number;
+    since?: string;
+    mark_read?: boolean;
+}
+export declare function readSpaceNotifications(opts: ReadSpaceNotificationsOptions): SpaceNotification[];
+export declare function markSpaceNotificationsRead(agent: string, messageIds: number[]): number;
+export declare function markAllSpaceNotificationsRead(agent: string, space?: string): number;

package/dist/lib/space-notifications.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/mcp/channel.d.ts

@@ -21,4 +21,7 @@ export declare function setSessionAgent(agentId: string, claudeSessionId?: strin
 export declare function setClaudeSessionId(id: string): void;
 export declare function getSessionAgent(): string | null;
 export declare function getClaudeSessionId(): string | null;
-export declare function registerChannelBridge(server: McpServer): void;
+export declare function registerChannelBridge(server: McpServer, opts?: {
+    pollIntervalMs?: number;
+    startDelayMs?: number;
+}): () => void;

package/dist/mcp/channel.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/mcp/tools/messaging.d.ts

@@ -1,5 +1,5 @@
 /**
- * Messaging tools: send_message, read_messages, read_digest, list_sessions, reply,
+ * Messaging tools: send_message, read_messages, get_message, read_digest, list_sessions, reply,
  * mark_read, mark_unread, mark_space_read, search_messages, export_messages,
  * delete_message, edit_message, pin_message, unpin_message, get_pinned_messages,
  * mark_all_read, broadcast

package/dist/mcp/tools/spaces.d.ts

@@ -1,6 +1,8 @@
 /**
  * Space tools: create_space, list_spaces, send_to_space, read_space,
  * join_space, leave_space, update_space, archive_space, unarchive_space,
+ * subscribe_space_notifications, unsubscribe_space_notifications,
+ * list_space_subscriptions, read_space_notifications, mark_space_notifications_read,
  * set_space_topic, get_space_topic, summarize_space
  */
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

package/dist/types.d.ts

@@ -56,6 +56,23 @@ export interface SpaceMember {
     agent: string;
     joined_at: string;
 }
+export interface SpaceNotificationSubscription {
+    space: string;
+    agent: string;
+    created_at: string;
+    preview_chars: number;
+    since_message_id: number;
+}
+export interface SpaceNotification {
+    message_id: number;
+    space: string;
+    from_agent: string;
+    created_at: string;
+    priority: Priority;
+    preview: string;
+    unread: boolean;
+    has_attachments: boolean;
+}
 export interface SpaceInfo extends Space {
     member_count: number;
     message_count: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/conversations",
-  "version": "0.2.45",
+  "version": "0.2.47",
   "description": "Real-time CLI messaging for AI agents",
   "type": "module",
   "bin": {