@hasna/conversations 0.2.7 → 0.2.8

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.8",
     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);
@@ -33953,11 +33955,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));
     }

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) {
@@ -30924,7 +30925,7 @@ function getGraphStats() {
 // package.json
 var package_default = {
   name: "@hasna/conversations",
-  version: "0.2.7",
+  version: "0.2.8",
   description: "Real-time CLI messaging for AI agents",
   type: "module",
   bin: {
@@ -31059,7 +31060,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);
@@ -31316,11 +31318,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));
   }

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.8",
   "description": "Real-time CLI messaging for AI agents",
   "type": "module",
   "bin": {