@hasna/conversations 0.2.2 → 0.2.4

package/bin/index.js

@@ -2372,7 +2372,15 @@ function readMessages(opts = {}) {
   const resolvedLimit = Number.isFinite(opts.limit) && opts.limit > 0 ? Math.floor(opts.limit) : 20;
   const order = opts.order?.toLowerCase() === "desc" ? "DESC" : "ASC";
   const rows = db2.prepare(`SELECT * FROM messages ${where} ORDER BY created_at ${order}, id ${order} LIMIT ${resolvedLimit}`).all(...params);
-  const messages = rows.map(parseMessage);
+  let messages = rows.map(parseMessage);
+  if (opts.max_content_length && opts.max_content_length > 0) {
+    messages = messages.map((m) => {
+      if (m.content.length > opts.max_content_length) {
+        return { ...m, content: m.content.slice(0, opts.max_content_length) + "\u2026", truncated: true };
+      }
+      return m;
+    });
+  }
   if (opts.compact)
     return messages.map(compactMessage);
   return messages;
@@ -2644,6 +2652,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 +4324,7 @@ var init_poll = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/conversations",
-    version: "0.2.2",
+    version: "0.2.4",
     description: "Real-time CLI messaging for AI agents",
     type: "module",
     bin: {
@@ -33535,7 +33576,8 @@ var init_mcp2 = __esm(() => {
       since: exports_external.string().optional(),
       limit: exports_external.coerce.number().optional(),
       unread_only: exports_external.coerce.boolean().optional(),
-      mark_read: exports_external.coerce.boolean().optional()
+      mark_read: exports_external.coerce.boolean().optional(),
+      max_content_length: exports_external.coerce.number().optional().describe("Truncate each message content to N chars (adds truncated:true flag)")
     }
   }, async (args) => {
     const agent = resolveIdentity(args.from);
@@ -33704,6 +33746,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: {
@@ -33742,11 +33795,12 @@ var init_mcp2 = __esm(() => {
       space: exports_external.string(),
       since: exports_external.string().optional(),
       limit: exports_external.coerce.number().optional(),
-      mark_read: exports_external.coerce.boolean().optional()
+      mark_read: exports_external.coerce.boolean().optional(),
+      max_content_length: exports_external.coerce.number().optional().describe("Truncate each message content to N chars (adds truncated:true flag)")
     }
   }, async (args) => {
-    const { space, since, limit, mark_read } = args;
-    const messages = readMessages({ space, since, limit });
+    const { space, since, limit, mark_read, max_content_length } = args;
+    const messages = readMessages({ space, since, limit, max_content_length });
     if (mark_read !== false && messages.length > 0) {
       markReadByIds(messages.map((m) => m.id));
     }
@@ -34656,6 +34710,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

@@ -28881,7 +28881,15 @@ function readMessages(opts = {}) {
   const resolvedLimit = Number.isFinite(opts.limit) && opts.limit > 0 ? Math.floor(opts.limit) : 20;
   const order = opts.order?.toLowerCase() === "desc" ? "DESC" : "ASC";
   const rows = db2.prepare(`SELECT * FROM messages ${where} ORDER BY created_at ${order}, id ${order} LIMIT ${resolvedLimit}`).all(...params);
-  const messages = rows.map(parseMessage);
+  let messages = rows.map(parseMessage);
+  if (opts.max_content_length && opts.max_content_length > 0) {
+    messages = messages.map((m) => {
+      if (m.content.length > opts.max_content_length) {
+        return { ...m, content: m.content.slice(0, opts.max_content_length) + "\u2026", truncated: true };
+      }
+      return m;
+    });
+  }
   if (opts.compact)
     return messages.map(compactMessage);
   return messages;
@@ -29141,6 +29149,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 +30808,7 @@ function getGraphStats() {
 // package.json
 var package_default = {
   name: "@hasna/conversations",
-  version: "0.2.2",
+  version: "0.2.4",
   description: "Real-time CLI messaging for AI agents",
   type: "module",
   bin: {
@@ -30898,7 +30939,8 @@ server.registerTool("read_messages", {
     since: exports_external.string().optional(),
     limit: exports_external.coerce.number().optional(),
     unread_only: exports_external.coerce.boolean().optional(),
-    mark_read: exports_external.coerce.boolean().optional()
+    mark_read: exports_external.coerce.boolean().optional(),
+    max_content_length: exports_external.coerce.number().optional().describe("Truncate each message content to N chars (adds truncated:true flag)")
   }
 }, async (args) => {
   const agent = resolveIdentity(args.from);
@@ -31067,6 +31109,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: {
@@ -31105,11 +31158,12 @@ server.registerTool("read_space", {
     space: exports_external.string(),
     since: exports_external.string().optional(),
     limit: exports_external.coerce.number().optional(),
-    mark_read: exports_external.coerce.boolean().optional()
+    mark_read: exports_external.coerce.boolean().optional(),
+    max_content_length: exports_external.coerce.number().optional().describe("Truncate each message content to N chars (adds truncated:true flag)")
   }
 }, async (args) => {
-  const { space, since, limit, mark_read } = args;
-  const messages = readMessages({ space, since, limit });
+  const { space, since, limit, mark_read, max_content_length } = args;
+  const messages = readMessages({ space, since, limit, max_content_length });
   if (mark_read !== false && messages.length > 0) {
     markReadByIds(messages.map((m) => m.id));
   }
@@ -32019,6 +32073,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/index.js

@@ -2346,7 +2346,15 @@ function readMessages(opts = {}) {
   const resolvedLimit = Number.isFinite(opts.limit) && opts.limit > 0 ? Math.floor(opts.limit) : 20;
   const order = opts.order?.toLowerCase() === "desc" ? "DESC" : "ASC";
   const rows = db2.prepare(`SELECT * FROM messages ${where} ORDER BY created_at ${order}, id ${order} LIMIT ${resolvedLimit}`).all(...params);
-  const messages = rows.map(parseMessage);
+  let messages = rows.map(parseMessage);
+  if (opts.max_content_length && opts.max_content_length > 0) {
+    messages = messages.map((m) => {
+      if (m.content.length > opts.max_content_length) {
+        return { ...m, content: m.content.slice(0, opts.max_content_length) + "\u2026", truncated: true };
+      }
+      return m;
+    });
+  }
   if (opts.compact)
     return messages.map(compactMessage);
   return messages;

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/dist/types.d.ts

@@ -19,6 +19,7 @@ export interface Message {
     blocking: boolean;
     attachments: Attachment[] | null;
     reply_to: number | null;
+    truncated?: boolean;
 }
 export interface Reaction {
     id: number;
@@ -106,6 +107,7 @@ export interface ReadMessagesOptions {
     unread_only?: boolean;
     order?: "asc" | "desc";
     compact?: boolean;
+    max_content_length?: number;
 }
 export interface SearchMessagesOptions {
     query: string;

package/package.json

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