@hasna/conversations 0.2.2 → 0.2.3

package/bin/index.js

@@ -2644,6 +2644,39 @@ function searchMessages(opts) {
     return { ...msg, snippet: null, relevance_score: 0 };
   });
 }
+function listUnreadCounts(agent) {
+  const db2 = getDb();
+  if (agent) {
+    const rows2 = db2.prepare(`
+      SELECT
+        space,
+        COUNT(CASE WHEN read_at IS NULL AND (to_agent = ? OR to_agent IS NULL OR to_agent = '') THEN 1 END) AS unread_count,
+        MAX(created_at) AS latest_message_at
+      FROM messages
+      WHERE space IN (
+        SELECT DISTINCT space FROM space_members WHERE agent = ?
+        UNION
+        SELECT DISTINCT space FROM messages WHERE to_agent = ? AND space IS NOT NULL
+      )
+      GROUP BY space
+      HAVING COUNT(*) > 0
+      ORDER BY unread_count DESC, latest_message_at DESC
+    `).all(agent, agent, agent);
+    return rows2;
+  }
+  const rows = db2.prepare(`
+    SELECT
+      space,
+      COUNT(CASE WHEN read_at IS NULL THEN 1 END) AS unread_count,
+      MAX(created_at) AS latest_message_at
+    FROM messages
+    WHERE space IS NOT NULL
+    GROUP BY space
+    HAVING COUNT(*) > 0
+    ORDER BY unread_count DESC, latest_message_at DESC
+  `).all();
+  return rows;
+}
 var init_messages = __esm(() => {
   init_db();
   init_webhooks();
@@ -4283,7 +4316,7 @@ var init_poll = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/conversations",
-    version: "0.2.2",
+    version: "0.2.3",
     description: "Real-time CLI messaging for AI agents",
     type: "module",
     bin: {
@@ -33704,6 +33737,17 @@ var init_mcp2 = __esm(() => {
       content: [{ type: "text", text: JSON.stringify(spaces) }]
     };
   });
+  server.registerTool("list_unread_counts", {
+    description: "Get unread message counts per space without fetching message content. Use this at session start to triage which spaces need attention before calling read_messages.",
+    inputSchema: {
+      agent: exports_external.string().optional().describe("Filter to spaces the agent is a member of or has received messages in. Omit for global unread counts.")
+    }
+  }, async (args) => {
+    const counts = listUnreadCounts(args.agent);
+    return {
+      content: [{ type: "text", text: JSON.stringify(counts) }]
+    };
+  });
   server.registerTool("send_to_space", {
     description: "Post a message to a space.",
     inputSchema: {
@@ -34656,6 +34700,7 @@ var init_mcp2 = __esm(() => {
       search_messages: "Full-text search messages. Required: query. Optional: space?, from?, to?, limit?",
       export_messages: "Export messages as JSON or CSV. Optional: space?, session_id?, from?, since?, until?, format?(json|csv)",
       create_space: "Create space and auto-join. Required: name. Optional: from?, description?, parent_id?(max 3 levels), project_id?",
+      list_unread_counts: "Get unread message counts per space (no content). Ideal for session start triage. Optional: agent?(filter to agent's spaces)",
       list_spaces: "List spaces with member/message counts. Optional: project_id?, parent_id?(use 'null' for top-level), include_archived?",
       send_to_space: "Post message to space. Required: space, content. Optional: from?, priority?(low|normal|high|urgent), blocking?",
       read_space: "Read messages in a space. Required: space. Optional: since?(ISO), limit?, mark_read?(default true \u2014 auto-marks returned messages as read)",

package/bin/mcp.js

@@ -29141,6 +29141,39 @@ function searchMessages(opts) {
     return { ...msg, snippet: null, relevance_score: 0 };
   });
 }
+function listUnreadCounts(agent) {
+  const db2 = getDb();
+  if (agent) {
+    const rows2 = db2.prepare(`
+      SELECT
+        space,
+        COUNT(CASE WHEN read_at IS NULL AND (to_agent = ? OR to_agent IS NULL OR to_agent = '') THEN 1 END) AS unread_count,
+        MAX(created_at) AS latest_message_at
+      FROM messages
+      WHERE space IN (
+        SELECT DISTINCT space FROM space_members WHERE agent = ?
+        UNION
+        SELECT DISTINCT space FROM messages WHERE to_agent = ? AND space IS NOT NULL
+      )
+      GROUP BY space
+      HAVING COUNT(*) > 0
+      ORDER BY unread_count DESC, latest_message_at DESC
+    `).all(agent, agent, agent);
+    return rows2;
+  }
+  const rows = db2.prepare(`
+    SELECT
+      space,
+      COUNT(CASE WHEN read_at IS NULL THEN 1 END) AS unread_count,
+      MAX(created_at) AS latest_message_at
+    FROM messages
+    WHERE space IS NOT NULL
+    GROUP BY space
+    HAVING COUNT(*) > 0
+    ORDER BY unread_count DESC, latest_message_at DESC
+  `).all();
+  return rows;
+}
 
 // src/lib/sessions.ts
 init_db();
@@ -30767,7 +30800,7 @@ function getGraphStats() {
 // package.json
 var package_default = {
   name: "@hasna/conversations",
-  version: "0.2.2",
+  version: "0.2.3",
   description: "Real-time CLI messaging for AI agents",
   type: "module",
   bin: {
@@ -31067,6 +31100,17 @@ server.registerTool("list_spaces", {
     content: [{ type: "text", text: JSON.stringify(spaces) }]
   };
 });
+server.registerTool("list_unread_counts", {
+  description: "Get unread message counts per space without fetching message content. Use this at session start to triage which spaces need attention before calling read_messages.",
+  inputSchema: {
+    agent: exports_external.string().optional().describe("Filter to spaces the agent is a member of or has received messages in. Omit for global unread counts.")
+  }
+}, async (args) => {
+  const counts = listUnreadCounts(args.agent);
+  return {
+    content: [{ type: "text", text: JSON.stringify(counts) }]
+  };
+});
 server.registerTool("send_to_space", {
   description: "Post a message to a space.",
   inputSchema: {
@@ -32019,6 +32063,7 @@ server.registerTool("describe_tools", {
     search_messages: "Full-text search messages. Required: query. Optional: space?, from?, to?, limit?",
     export_messages: "Export messages as JSON or CSV. Optional: space?, session_id?, from?, since?, until?, format?(json|csv)",
     create_space: "Create space and auto-join. Required: name. Optional: from?, description?, parent_id?(max 3 levels), project_id?",
+    list_unread_counts: "Get unread message counts per space (no content). Ideal for session start triage. Optional: agent?(filter to agent's spaces)",
     list_spaces: "List spaces with member/message counts. Optional: project_id?, parent_id?(use 'null' for top-level), include_archived?",
     send_to_space: "Post message to space. Required: space, content. Optional: from?, priority?(low|normal|high|urgent), blocking?",
     read_space: "Read messages in a space. Required: space. Optional: since?(ISO), limit?, mark_read?(default true \u2014 auto-marks returned messages as read)",

package/dist/lib/messages.d.ts

@@ -56,3 +56,14 @@ export declare function getPinnedMessages(opts?: {
 export declare function getUnreadBlockers(agent: string): Message[];
 export declare function getThreadReplies(messageId: number): Message[];
 export declare function searchMessages(opts: SearchMessagesOptions): SearchResult[];
+export interface UnreadCount {
+    space: string;
+    unread_count: number;
+    latest_message_at: string | null;
+}
+/**
+ * Get unread message counts per space — lightweight alternative to read_messages.
+ * Returns only spaces where the agent is a member (via space_members) or has received messages.
+ * If agent is omitted, returns counts for all spaces.
+ */
+export declare function listUnreadCounts(agent?: string): UnreadCount[];

package/package.json

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