@hasna/conversations 0.2.7 → 0.2.9

package/bin/index.js

@@ -2395,9 +2395,10 @@ function readMessages(opts = {}) {
     conditions.push(`id IN (SELECT message_id FROM message_mentions WHERE mentioned_agent = ?)`);
     params.push(opts.mentions_only.toLowerCase());
   }
+  const isLatest = opts.latest && opts.latest > 0;
   const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-  const resolvedLimit = Number.isFinite(opts.limit) && opts.limit > 0 ? Math.floor(opts.limit) : 20;
-  const order = opts.order?.toLowerCase() === "desc" ? "DESC" : "ASC";
+  const resolvedLimit = isLatest ? Math.floor(opts.latest) : Number.isFinite(opts.limit) && opts.limit > 0 ? Math.floor(opts.limit) : 20;
+  const order = isLatest ? "DESC" : 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);
   let messages = rows.map(parseMessage);
   if (opts.include_reply_counts && messages.length > 0) {
@@ -4440,7 +4441,7 @@ var init_poll = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/conversations",
-    version: "0.2.7",
+    version: "0.2.9",
     description: "Real-time CLI messaging for AI agents",
     type: "module",
     bin: {
@@ -33696,7 +33697,8 @@ var init_mcp2 = __esm(() => {
       max_content_length: exports_external.coerce.number().optional().describe("Truncate each message content to N chars (adds truncated:true flag)"),
       threads_only: exports_external.coerce.boolean().optional().describe("Only return root messages (reply_to IS NULL) \u2014 hides thread replies"),
       include_reply_counts: exports_external.coerce.boolean().optional().describe("Include reply_count on each message (adds one extra query)"),
-      mentions_only: exports_external.string().optional().describe("Only return messages that @mention this agent")
+      mentions_only: exports_external.string().optional().describe("Only return messages that @mention this agent"),
+      latest: exports_external.coerce.number().optional().describe("Return the N most recent unread messages, newest first. Shorthand for order:desc + limit:N.")
     }
   }, async (args) => {
     const agent = resolveIdentity(args.from);
@@ -33778,6 +33780,19 @@ var init_mcp2 = __esm(() => {
       content: [{ type: "text", text: JSON.stringify({ marked_read: count }) }]
     };
   });
+  server.registerTool("mark_space_read", {
+    description: "Mark ALL messages in a space as read without fetching them. Use this on busy spaces (200+ messages) where read_messages would overflow tokens.",
+    inputSchema: {
+      space: exports_external.string().describe("Space name"),
+      from: exports_external.string().optional().describe("Mark read on behalf of this agent (default: current agent)")
+    }
+  }, async (args) => {
+    const { space, from: fromParam } = args;
+    const count = markSpaceRead(space, fromParam);
+    return {
+      content: [{ type: "text", text: JSON.stringify({ space, marked_read: count }) }]
+    };
+  });
   server.registerTool("search_messages", {
     description: "Full-text search across messages. Uses FTS5 with BM25 ranking if available, falls back to LIKE. Returns messages with snippet and relevance_score.",
     inputSchema: {
@@ -33953,11 +33968,12 @@ var init_mcp2 = __esm(() => {
       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)"),
       threads_only: exports_external.coerce.boolean().optional().describe("Only return root messages (hides thread replies)"),
-      include_reply_counts: exports_external.coerce.boolean().optional().describe("Include reply_count on each message")
+      include_reply_counts: exports_external.coerce.boolean().optional().describe("Include reply_count on each message"),
+      latest: exports_external.coerce.number().optional().describe("Return the N most recent messages, newest first")
     }
   }, async (args) => {
-    const { space, since, limit, mark_read, max_content_length, threads_only, include_reply_counts } = args;
-    const messages = readMessages({ space, since, limit, max_content_length, threads_only, include_reply_counts });
+    const { space, since, limit, mark_read, max_content_length, threads_only, include_reply_counts, latest } = args;
+    const messages = readMessages({ space, since, limit, max_content_length, threads_only, include_reply_counts, latest });
     if (mark_read !== false && messages.length > 0) {
       markReadByIds(messages.map((m) => m.id));
     }
@@ -34881,6 +34897,7 @@ var init_mcp2 = __esm(() => {
       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?",
       mark_read: "Mark messages as read. Optional: from?, ids?(array), all?(bool \u2014 mark all unread)",
+      mark_space_read: "Mark ALL messages in a space as read without fetching. Required: space. Optional: from?",
       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?",

package/bin/mcp.js

@@ -28904,9 +28904,10 @@ function readMessages(opts = {}) {
     conditions.push(`id IN (SELECT message_id FROM message_mentions WHERE mentioned_agent = ?)`);
     params.push(opts.mentions_only.toLowerCase());
   }
+  const isLatest = opts.latest && opts.latest > 0;
   const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-  const resolvedLimit = Number.isFinite(opts.limit) && opts.limit > 0 ? Math.floor(opts.limit) : 20;
-  const order = opts.order?.toLowerCase() === "desc" ? "DESC" : "ASC";
+  const resolvedLimit = isLatest ? Math.floor(opts.latest) : Number.isFinite(opts.limit) && opts.limit > 0 ? Math.floor(opts.limit) : 20;
+  const order = isLatest ? "DESC" : 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);
   let messages = rows.map(parseMessage);
   if (opts.include_reply_counts && messages.length > 0) {
@@ -28936,6 +28937,12 @@ function markRead(ids, reader) {
   const result = stmt.run(...ids, reader);
   return result.changes;
 }
+function markSpaceRead(spaceName, reader) {
+  const db2 = getDb();
+  const stmt = db2.prepare(`UPDATE messages SET read_at = strftime('%Y-%m-%dT%H:%M:%f', 'now') WHERE space = ? AND from_agent != ? AND read_at IS NULL`);
+  const result = stmt.run(spaceName, reader);
+  return result.changes;
+}
 function getMessageById(id) {
   const db2 = getDb();
   const row = db2.prepare("SELECT * FROM messages WHERE id = ?").get(id);
@@ -30924,7 +30931,7 @@ function getGraphStats() {
 // package.json
 var package_default = {
   name: "@hasna/conversations",
-  version: "0.2.7",
+  version: "0.2.9",
   description: "Real-time CLI messaging for AI agents",
   type: "module",
   bin: {
@@ -31059,7 +31066,8 @@ server.registerTool("read_messages", {
     max_content_length: exports_external.coerce.number().optional().describe("Truncate each message content to N chars (adds truncated:true flag)"),
     threads_only: exports_external.coerce.boolean().optional().describe("Only return root messages (reply_to IS NULL) \u2014 hides thread replies"),
     include_reply_counts: exports_external.coerce.boolean().optional().describe("Include reply_count on each message (adds one extra query)"),
-    mentions_only: exports_external.string().optional().describe("Only return messages that @mention this agent")
+    mentions_only: exports_external.string().optional().describe("Only return messages that @mention this agent"),
+    latest: exports_external.coerce.number().optional().describe("Return the N most recent unread messages, newest first. Shorthand for order:desc + limit:N.")
   }
 }, async (args) => {
   const agent = resolveIdentity(args.from);
@@ -31141,6 +31149,19 @@ server.registerTool("mark_read", {
     content: [{ type: "text", text: JSON.stringify({ marked_read: count }) }]
   };
 });
+server.registerTool("mark_space_read", {
+  description: "Mark ALL messages in a space as read without fetching them. Use this on busy spaces (200+ messages) where read_messages would overflow tokens.",
+  inputSchema: {
+    space: exports_external.string().describe("Space name"),
+    from: exports_external.string().optional().describe("Mark read on behalf of this agent (default: current agent)")
+  }
+}, async (args) => {
+  const { space, from: fromParam } = args;
+  const count = markSpaceRead(space, fromParam);
+  return {
+    content: [{ type: "text", text: JSON.stringify({ space, marked_read: count }) }]
+  };
+});
 server.registerTool("search_messages", {
   description: "Full-text search across messages. Uses FTS5 with BM25 ranking if available, falls back to LIKE. Returns messages with snippet and relevance_score.",
   inputSchema: {
@@ -31316,11 +31337,12 @@ server.registerTool("read_space", {
     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)"),
     threads_only: exports_external.coerce.boolean().optional().describe("Only return root messages (hides thread replies)"),
-    include_reply_counts: exports_external.coerce.boolean().optional().describe("Include reply_count on each message")
+    include_reply_counts: exports_external.coerce.boolean().optional().describe("Include reply_count on each message"),
+    latest: exports_external.coerce.number().optional().describe("Return the N most recent messages, newest first")
   }
 }, async (args) => {
-  const { space, since, limit, mark_read, max_content_length, threads_only, include_reply_counts } = args;
-  const messages = readMessages({ space, since, limit, max_content_length, threads_only, include_reply_counts });
+  const { space, since, limit, mark_read, max_content_length, threads_only, include_reply_counts, latest } = args;
+  const messages = readMessages({ space, since, limit, max_content_length, threads_only, include_reply_counts, latest });
   if (mark_read !== false && messages.length > 0) {
     markReadByIds(messages.map((m) => m.id));
   }
@@ -32244,6 +32266,7 @@ server.registerTool("describe_tools", {
     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?",
     mark_read: "Mark messages as read. Optional: from?, ids?(array), all?(bool \u2014 mark all unread)",
+    mark_space_read: "Mark ALL messages in a space as read without fetching. Required: space. Optional: from?",
     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?",

package/dist/index.js

@@ -2369,9 +2369,10 @@ function readMessages(opts = {}) {
     conditions.push(`id IN (SELECT message_id FROM message_mentions WHERE mentioned_agent = ?)`);
     params.push(opts.mentions_only.toLowerCase());
   }
+  const isLatest = opts.latest && opts.latest > 0;
   const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-  const resolvedLimit = Number.isFinite(opts.limit) && opts.limit > 0 ? Math.floor(opts.limit) : 20;
-  const order = opts.order?.toLowerCase() === "desc" ? "DESC" : "ASC";
+  const resolvedLimit = isLatest ? Math.floor(opts.latest) : Number.isFinite(opts.limit) && opts.limit > 0 ? Math.floor(opts.limit) : 20;
+  const order = isLatest ? "DESC" : 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);
   let messages = rows.map(parseMessage);
   if (opts.include_reply_counts && messages.length > 0) {

package/dist/types.d.ts

@@ -112,6 +112,7 @@ export interface ReadMessagesOptions {
     threads_only?: boolean;
     include_reply_counts?: boolean;
     mentions_only?: string;
+    latest?: number;
 }
 export interface SearchMessagesOptions {
     query: string;

package/package.json

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