@hasna/conversations 0.2.6 → 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) {
@@ -2646,6 +2647,14 @@ function searchMessages(opts) {
       extraWhere += " AND m.to_agent = ?";
       ftsParams.push(opts.to);
     }
+    if (opts.since) {
+      extraWhere += " AND m.created_at >= ?";
+      ftsParams.push(opts.since);
+    }
+    if (opts.until) {
+      extraWhere += " AND m.created_at <= ?";
+      ftsParams.push(opts.until);
+    }
     const orderClause = sortByRelevance ? "ORDER BY rank" : "ORDER BY m.created_at DESC, m.id DESC";
     const rows2 = db2.prepare(`SELECT m.*, rank,
         snippet(messages_fts, 0, '**', '**', '...', 20) as snippet
@@ -2678,6 +2687,14 @@ function searchMessages(opts) {
     conditions.push("to_agent = ?");
     params.push(opts.to);
   }
+  if (opts.since) {
+    conditions.push("created_at >= ?");
+    params.push(opts.since);
+  }
+  if (opts.until) {
+    conditions.push("created_at <= ?");
+    params.push(opts.until);
+  }
   const where = `WHERE ${conditions.join(" AND ")}`;
   const rows = db2.prepare(`SELECT * FROM messages ${where} ORDER BY created_at DESC, id DESC LIMIT ${limit}`).all(...params);
   return rows.map((row) => {
@@ -4424,7 +4441,7 @@ var init_poll = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/conversations",
-    version: "0.2.6",
+    version: "0.2.8",
     description: "Real-time CLI messaging for AI agents",
     type: "module",
     bin: {
@@ -33680,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);
@@ -33763,19 +33781,26 @@ var init_mcp2 = __esm(() => {
     };
   });
   server.registerTool("search_messages", {
-    description: "Full-text search across 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: {
-      query: exports_external.string(),
-      space: exports_external.string().optional(),
-      from: exports_external.string().optional(),
-      to: exports_external.string().optional(),
-      limit: exports_external.coerce.number().optional()
+      query: exports_external.string().describe(`Search query. Wrap in quotes for exact phrase: '"BUG-005"'`),
+      space: exports_external.string().optional().describe("Limit to a specific space"),
+      from: exports_external.string().optional().describe("Filter by sender"),
+      to: exports_external.string().optional().describe("Filter by recipient"),
+      since: exports_external.string().optional().describe("ISO 8601 date \u2014 only messages after this"),
+      until: exports_external.string().optional().describe("ISO 8601 date \u2014 only messages before this"),
+      sort: exports_external.enum(["relevance", "recent"]).optional().describe("Sort order (default: relevance)"),
+      limit: exports_external.coerce.number().optional().describe("Max results (default: 20)")
     }
   }, async (args) => {
-    const { query, space, from, to, limit } = args;
-    const messages = searchMessages({ query, space, from, to, limit });
+    const { query, space, from, to, since, until, sort, limit } = args;
+    const results = searchMessages({ query, space, from, to, since, until, sort, limit });
     return {
-      content: [{ type: "text", text: JSON.stringify(messages) }]
+      content: [{ type: "text", text: JSON.stringify({
+        results,
+        count: results.length,
+        query
+      }) }]
     };
   });
   server.registerTool("export_messages", {
@@ -33930,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) {
@@ -29143,6 +29144,14 @@ function searchMessages(opts) {
       extraWhere += " AND m.to_agent = ?";
       ftsParams.push(opts.to);
     }
+    if (opts.since) {
+      extraWhere += " AND m.created_at >= ?";
+      ftsParams.push(opts.since);
+    }
+    if (opts.until) {
+      extraWhere += " AND m.created_at <= ?";
+      ftsParams.push(opts.until);
+    }
     const orderClause = sortByRelevance ? "ORDER BY rank" : "ORDER BY m.created_at DESC, m.id DESC";
     const rows2 = db2.prepare(`SELECT m.*, rank,
         snippet(messages_fts, 0, '**', '**', '...', 20) as snippet
@@ -29175,6 +29184,14 @@ function searchMessages(opts) {
     conditions.push("to_agent = ?");
     params.push(opts.to);
   }
+  if (opts.since) {
+    conditions.push("created_at >= ?");
+    params.push(opts.since);
+  }
+  if (opts.until) {
+    conditions.push("created_at <= ?");
+    params.push(opts.until);
+  }
   const where = `WHERE ${conditions.join(" AND ")}`;
   const rows = db2.prepare(`SELECT * FROM messages ${where} ORDER BY created_at DESC, id DESC LIMIT ${limit}`).all(...params);
   return rows.map((row) => {
@@ -30908,7 +30925,7 @@ function getGraphStats() {
 // package.json
 var package_default = {
   name: "@hasna/conversations",
-  version: "0.2.6",
+  version: "0.2.8",
   description: "Real-time CLI messaging for AI agents",
   type: "module",
   bin: {
@@ -31043,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);
@@ -31126,19 +31144,26 @@ server.registerTool("mark_read", {
   };
 });
 server.registerTool("search_messages", {
-  description: "Full-text search across 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: {
-    query: exports_external.string(),
-    space: exports_external.string().optional(),
-    from: exports_external.string().optional(),
-    to: exports_external.string().optional(),
-    limit: exports_external.coerce.number().optional()
+    query: exports_external.string().describe(`Search query. Wrap in quotes for exact phrase: '"BUG-005"'`),
+    space: exports_external.string().optional().describe("Limit to a specific space"),
+    from: exports_external.string().optional().describe("Filter by sender"),
+    to: exports_external.string().optional().describe("Filter by recipient"),
+    since: exports_external.string().optional().describe("ISO 8601 date \u2014 only messages after this"),
+    until: exports_external.string().optional().describe("ISO 8601 date \u2014 only messages before this"),
+    sort: exports_external.enum(["relevance", "recent"]).optional().describe("Sort order (default: relevance)"),
+    limit: exports_external.coerce.number().optional().describe("Max results (default: 20)")
   }
 }, async (args) => {
-  const { query, space, from, to, limit } = args;
-  const messages = searchMessages({ query, space, from, to, limit });
+  const { query, space, from, to, since, until, sort, limit } = args;
+  const results = searchMessages({ query, space, from, to, since, until, sort, limit });
   return {
-    content: [{ type: "text", text: JSON.stringify(messages) }]
+    content: [{ type: "text", text: JSON.stringify({
+      results,
+      count: results.length,
+      query
+    }) }]
   };
 });
 server.registerTool("export_messages", {
@@ -31293,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) {
@@ -2568,6 +2569,14 @@ function searchMessages(opts) {
       extraWhere += " AND m.to_agent = ?";
       ftsParams.push(opts.to);
     }
+    if (opts.since) {
+      extraWhere += " AND m.created_at >= ?";
+      ftsParams.push(opts.since);
+    }
+    if (opts.until) {
+      extraWhere += " AND m.created_at <= ?";
+      ftsParams.push(opts.until);
+    }
     const orderClause = sortByRelevance ? "ORDER BY rank" : "ORDER BY m.created_at DESC, m.id DESC";
     const rows2 = db2.prepare(`SELECT m.*, rank,
         snippet(messages_fts, 0, '**', '**', '...', 20) as snippet
@@ -2600,6 +2609,14 @@ function searchMessages(opts) {
     conditions.push("to_agent = ?");
     params.push(opts.to);
   }
+  if (opts.since) {
+    conditions.push("created_at >= ?");
+    params.push(opts.since);
+  }
+  if (opts.until) {
+    conditions.push("created_at <= ?");
+    params.push(opts.until);
+  }
   const where = `WHERE ${conditions.join(" AND ")}`;
   const rows = db2.prepare(`SELECT * FROM messages ${where} ORDER BY created_at DESC, id DESC LIMIT ${limit}`).all(...params);
   return rows.map((row) => {

package/dist/types.d.ts

@@ -112,14 +112,18 @@ export interface ReadMessagesOptions {
     threads_only?: boolean;
     include_reply_counts?: boolean;
     mentions_only?: string;
+    latest?: number;
 }
 export interface SearchMessagesOptions {
     query: string;
     space?: string;
     from?: string;
     to?: string;
+    since?: string;
+    until?: string;
     limit?: number;
     sort?: "relevance" | "recent";
+    snippet_length?: number;
 }
 export interface SearchResult extends Message {
     snippet: string | null;

package/package.json

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