@hasna/conversations 0.2.6 → 0.2.7

package/bin/index.js

@@ -2646,6 +2646,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 +2686,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 +4440,7 @@ var init_poll = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/conversations",
-    version: "0.2.6",
+    version: "0.2.7",
     description: "Real-time CLI messaging for AI agents",
     type: "module",
     bin: {
@@ -33763,19 +33779,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", {

package/bin/mcp.js

@@ -29143,6 +29143,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 +29183,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 +30924,7 @@ function getGraphStats() {
 // package.json
 var package_default = {
   name: "@hasna/conversations",
-  version: "0.2.6",
+  version: "0.2.7",
   description: "Real-time CLI messaging for AI agents",
   type: "module",
   bin: {
@@ -31126,19 +31142,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", {

package/dist/index.js

@@ -2568,6 +2568,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 +2608,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

@@ -118,8 +118,11 @@ export interface SearchMessagesOptions {
     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.7",
   "description": "Real-time CLI messaging for AI agents",
   "type": "module",
   "bin": {