@hasna/conversations 0.2.8 → 0.2.10

package/bin/index.js

@@ -2399,7 +2399,8 @@ function readMessages(opts = {}) {
   const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
   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);
+  const resolvedOffset = opts.offset && opts.offset > 0 ? Math.floor(opts.offset) : 0;
+  const rows = db2.prepare(`SELECT * FROM messages ${where} ORDER BY created_at ${order}, id ${order} LIMIT ${resolvedLimit} OFFSET ${resolvedOffset}`).all(...params);
   let messages = rows.map(parseMessage);
   if (opts.include_reply_counts && messages.length > 0) {
     const db22 = getDb();
@@ -4441,7 +4442,7 @@ var init_poll = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/conversations",
-    version: "0.2.8",
+    version: "0.2.10",
     description: "Real-time CLI messaging for AI agents",
     type: "module",
     bin: {
@@ -33698,7 +33699,8 @@ var init_mcp2 = __esm(() => {
       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"),
-      latest: exports_external.coerce.number().optional().describe("Return the N most recent unread messages, newest first. Shorthand for order:desc + limit:N.")
+      latest: exports_external.coerce.number().optional().describe("Return the N most recent unread messages, newest first. Shorthand for order:desc + limit:N."),
+      offset: exports_external.coerce.number().optional().describe("Skip first N messages for pagination (use with limit)")
     }
   }, async (args) => {
     const agent = resolveIdentity(args.from);
@@ -33710,7 +33712,7 @@ var init_mcp2 = __esm(() => {
       markReadByIds(messages.map((m) => m.id));
     }
     return {
-      content: [{ type: "text", text: JSON.stringify(messages) }]
+      content: [{ type: "text", text: JSON.stringify({ messages, count: messages.length, offset: args.offset ?? 0 }) }]
     };
   });
   server.registerTool("list_sessions", {
@@ -33780,6 +33782,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: {
@@ -34884,6 +34899,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

@@ -28908,7 +28908,8 @@ function readMessages(opts = {}) {
   const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
   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);
+  const resolvedOffset = opts.offset && opts.offset > 0 ? Math.floor(opts.offset) : 0;
+  const rows = db2.prepare(`SELECT * FROM messages ${where} ORDER BY created_at ${order}, id ${order} LIMIT ${resolvedLimit} OFFSET ${resolvedOffset}`).all(...params);
   let messages = rows.map(parseMessage);
   if (opts.include_reply_counts && messages.length > 0) {
     const db22 = getDb();
@@ -28937,6 +28938,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);
@@ -30925,7 +30932,7 @@ function getGraphStats() {
 // package.json
 var package_default = {
   name: "@hasna/conversations",
-  version: "0.2.8",
+  version: "0.2.10",
   description: "Real-time CLI messaging for AI agents",
   type: "module",
   bin: {
@@ -31061,7 +31068,8 @@ server.registerTool("read_messages", {
     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"),
-    latest: exports_external.coerce.number().optional().describe("Return the N most recent unread messages, newest first. Shorthand for order:desc + limit:N.")
+    latest: exports_external.coerce.number().optional().describe("Return the N most recent unread messages, newest first. Shorthand for order:desc + limit:N."),
+    offset: exports_external.coerce.number().optional().describe("Skip first N messages for pagination (use with limit)")
   }
 }, async (args) => {
   const agent = resolveIdentity(args.from);
@@ -31073,7 +31081,7 @@ server.registerTool("read_messages", {
     markReadByIds(messages.map((m) => m.id));
   }
   return {
-    content: [{ type: "text", text: JSON.stringify(messages) }]
+    content: [{ type: "text", text: JSON.stringify({ messages, count: messages.length, offset: args.offset ?? 0 }) }]
   };
 });
 server.registerTool("list_sessions", {
@@ -31143,6 +31151,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: {
@@ -32247,6 +32268,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

@@ -2373,7 +2373,8 @@ function readMessages(opts = {}) {
   const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
   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);
+  const resolvedOffset = opts.offset && opts.offset > 0 ? Math.floor(opts.offset) : 0;
+  const rows = db2.prepare(`SELECT * FROM messages ${where} ORDER BY created_at ${order}, id ${order} LIMIT ${resolvedLimit} OFFSET ${resolvedOffset}`).all(...params);
   let messages = rows.map(parseMessage);
   if (opts.include_reply_counts && messages.length > 0) {
     const db22 = getDb();

package/dist/types.d.ts

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

package/package.json

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