@hasna/conversations 0.2.3 → 0.2.5

package/bin/index.js

@@ -2368,11 +2368,28 @@ function readMessages(opts = {}) {
   if (opts.unread_only) {
     conditions.push("read_at IS NULL");
   }
+  if (opts.threads_only) {
+    conditions.push("reply_to IS NULL");
+  }
   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 rows = db2.prepare(`SELECT * FROM messages ${where} ORDER BY created_at ${order}, id ${order} LIMIT ${resolvedLimit}`).all(...params);
-  const messages = rows.map(parseMessage);
+  let messages = rows.map(parseMessage);
+  if (opts.include_reply_counts && messages.length > 0) {
+    const db22 = getDb();
+    const counts = db22.prepare(`SELECT reply_to, COUNT(*) as c FROM messages WHERE reply_to IN (${messages.map(() => "?").join(",")}) GROUP BY reply_to`).all(...messages.map((m) => m.id));
+    const countMap = new Map(counts.map((r) => [r.reply_to, r.c]));
+    messages = messages.map((m) => ({ ...m, reply_count: countMap.get(m.id) ?? 0 }));
+  }
+  if (opts.max_content_length && opts.max_content_length > 0) {
+    messages = messages.map((m) => {
+      if (m.content.length > opts.max_content_length) {
+        return { ...m, content: m.content.slice(0, opts.max_content_length) + "\u2026", truncated: true };
+      }
+      return m;
+    });
+  }
   if (opts.compact)
     return messages.map(compactMessage);
   return messages;
@@ -4316,7 +4333,7 @@ var init_poll = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/conversations",
-    version: "0.2.3",
+    version: "0.2.5",
     description: "Real-time CLI messaging for AI agents",
     type: "module",
     bin: {
@@ -33568,7 +33585,10 @@ var init_mcp2 = __esm(() => {
       since: exports_external.string().optional(),
       limit: exports_external.coerce.number().optional(),
       unread_only: exports_external.coerce.boolean().optional(),
-      mark_read: exports_external.coerce.boolean().optional()
+      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 (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)")
     }
   }, async (args) => {
     const agent = resolveIdentity(args.from);
@@ -33596,7 +33616,7 @@ var init_mcp2 = __esm(() => {
     };
   });
   server.registerTool("reply", {
-    description: "Reply to a message by ID.",
+    description: "Reply to a specific message, creating a thread. Sets reply_to so it can be retrieved with get_thread_replies.",
     inputSchema: {
       message_id: exports_external.coerce.number(),
       content: exports_external.string(),
@@ -33613,13 +33633,13 @@ var init_mcp2 = __esm(() => {
     }
     const from = resolveIdentity(fromParam);
     const space = original.space || (original.session_id?.startsWith("space:") ? original.session_id.slice(6) : undefined);
-    const to = space ? space : original.from_agent === from ? original.to_agent : original.from_agent;
     const msg = sendMessage({
       from,
-      to,
+      to: space ?? (original.from_agent === from ? original.to_agent : original.from_agent),
       content,
       session_id: original.session_id,
-      space
+      space,
+      reply_to: message_id
     });
     return {
       content: [{ type: "text", text: JSON.stringify(msg) }]
@@ -33786,11 +33806,14 @@ var init_mcp2 = __esm(() => {
       space: exports_external.string(),
       since: exports_external.string().optional(),
       limit: exports_external.coerce.number().optional(),
-      mark_read: exports_external.coerce.boolean().optional()
+      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")
     }
   }, async (args) => {
-    const { space, since, limit, mark_read } = args;
-    const messages = readMessages({ space, since, limit });
+    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 });
     if (mark_read !== false && messages.length > 0) {
       markReadByIds(messages.map((m) => m.id));
     }
@@ -34441,13 +34464,30 @@ var init_mcp2 = __esm(() => {
     return { content: [{ type: "text", text: JSON.stringify({ released_stale_agent: stale, released_expired: expired, total: stale + expired }) }] };
   });
   server.registerTool("get_thread_replies", {
-    description: "Get all replies in a thread for a given parent message ID.",
+    description: "Get all replies in a thread for a given parent message ID. Also accessible as read_thread.",
     inputSchema: {
-      message_id: exports_external.coerce.number()
+      message_id: exports_external.coerce.number(),
+      limit: exports_external.coerce.number().optional()
+    }
+  }, async (args) => {
+    let replies = getThreadReplies(args.message_id);
+    if (args.limit)
+      replies = replies.slice(0, args.limit);
+    const parent = getMessageById(args.message_id);
+    return { content: [{ type: "text", text: JSON.stringify({ parent, replies, reply_count: replies.length }) }] };
+  });
+  server.registerTool("read_thread", {
+    description: "Alias for get_thread_replies. Read all replies to a specific message, forming a thread view.",
+    inputSchema: {
+      message_id: exports_external.coerce.number(),
+      limit: exports_external.coerce.number().optional()
     }
   }, async (args) => {
-    const replies = getThreadReplies(args.message_id);
-    return { content: [{ type: "text", text: JSON.stringify(replies) }] };
+    let replies = getThreadReplies(args.message_id);
+    if (args.limit)
+      replies = replies.slice(0, args.limit);
+    const parent = getMessageById(args.message_id);
+    return { content: [{ type: "text", text: JSON.stringify({ parent, replies, reply_count: replies.length }) }] };
   });
   server.registerTool("set_focus", {
     description: "Set agent focus to a project. All read-heavy tools will default to this project scope. Stores in MCP session memory AND updates agent_presence.project_id in DB.",
@@ -34695,7 +34735,7 @@ var init_mcp2 = __esm(() => {
       read_messages: "Read messages with filters. Optional: session_id?, from?, to?, space?, since?(ISO), limit?, unread_only?, mark_read?(default true \u2014 auto-marks returned messages as read, pass false to peek without consuming)",
       read_digest: "Lightweight unread digest \u2014 preview only (no full bodies), auto-marks read, never overflows tokens. Returns { messages, total_unread, shown }. Optional: space?, session_id?, to?, since?(ISO), limit?, project_id?",
       list_sessions: "List all DM sessions. Optional: agent?(filter by participant)",
-      reply: "Reply to a message in same session. Required: message_id, content. Optional: from?",
+      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)",
       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)",
@@ -34739,6 +34779,7 @@ var init_mcp2 = __esm(() => {
       list_locks: "List active locks enriched with agent presence + time context. Optional: resource_type?, agent_id?",
       clean_expired_locks: "Release expired locks + locks held by agents with stale heartbeat (>30 min). Returns {released_stale_agent, released_expired, total}",
       get_thread_replies: "Get all replies in a thread. Required: message_id. Optional: limit?",
+      read_thread: "Alias for get_thread_replies. Required: message_id. Optional: limit?",
       set_focus: "Set agent focus to a project. All read tools default to this scope. Required: project_id. Optional: from?",
       get_focus: "Get current focus: session focus, DB project_id, effective project_id. Optional: from?",
       unfocus: "Clear agent focus (session + DB). Optional: from?",

package/bin/mcp.js

@@ -28877,11 +28877,28 @@ function readMessages(opts = {}) {
   if (opts.unread_only) {
     conditions.push("read_at IS NULL");
   }
+  if (opts.threads_only) {
+    conditions.push("reply_to IS NULL");
+  }
   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 rows = db2.prepare(`SELECT * FROM messages ${where} ORDER BY created_at ${order}, id ${order} LIMIT ${resolvedLimit}`).all(...params);
-  const messages = rows.map(parseMessage);
+  let messages = rows.map(parseMessage);
+  if (opts.include_reply_counts && messages.length > 0) {
+    const db22 = getDb();
+    const counts = db22.prepare(`SELECT reply_to, COUNT(*) as c FROM messages WHERE reply_to IN (${messages.map(() => "?").join(",")}) GROUP BY reply_to`).all(...messages.map((m) => m.id));
+    const countMap = new Map(counts.map((r) => [r.reply_to, r.c]));
+    messages = messages.map((m) => ({ ...m, reply_count: countMap.get(m.id) ?? 0 }));
+  }
+  if (opts.max_content_length && opts.max_content_length > 0) {
+    messages = messages.map((m) => {
+      if (m.content.length > opts.max_content_length) {
+        return { ...m, content: m.content.slice(0, opts.max_content_length) + "\u2026", truncated: true };
+      }
+      return m;
+    });
+  }
   if (opts.compact)
     return messages.map(compactMessage);
   return messages;
@@ -30800,7 +30817,7 @@ function getGraphStats() {
 // package.json
 var package_default = {
   name: "@hasna/conversations",
-  version: "0.2.3",
+  version: "0.2.5",
   description: "Real-time CLI messaging for AI agents",
   type: "module",
   bin: {
@@ -30931,7 +30948,10 @@ server.registerTool("read_messages", {
     since: exports_external.string().optional(),
     limit: exports_external.coerce.number().optional(),
     unread_only: exports_external.coerce.boolean().optional(),
-    mark_read: exports_external.coerce.boolean().optional()
+    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 (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)")
   }
 }, async (args) => {
   const agent = resolveIdentity(args.from);
@@ -30959,7 +30979,7 @@ server.registerTool("list_sessions", {
   };
 });
 server.registerTool("reply", {
-  description: "Reply to a message by ID.",
+  description: "Reply to a specific message, creating a thread. Sets reply_to so it can be retrieved with get_thread_replies.",
   inputSchema: {
     message_id: exports_external.coerce.number(),
     content: exports_external.string(),
@@ -30976,13 +30996,13 @@ server.registerTool("reply", {
   }
   const from = resolveIdentity(fromParam);
   const space = original.space || (original.session_id?.startsWith("space:") ? original.session_id.slice(6) : undefined);
-  const to = space ? space : original.from_agent === from ? original.to_agent : original.from_agent;
   const msg = sendMessage({
     from,
-    to,
+    to: space ?? (original.from_agent === from ? original.to_agent : original.from_agent),
     content,
     session_id: original.session_id,
-    space
+    space,
+    reply_to: message_id
   });
   return {
     content: [{ type: "text", text: JSON.stringify(msg) }]
@@ -31149,11 +31169,14 @@ server.registerTool("read_space", {
     space: exports_external.string(),
     since: exports_external.string().optional(),
     limit: exports_external.coerce.number().optional(),
-    mark_read: exports_external.coerce.boolean().optional()
+    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")
   }
 }, async (args) => {
-  const { space, since, limit, mark_read } = args;
-  const messages = readMessages({ space, since, limit });
+  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 });
   if (mark_read !== false && messages.length > 0) {
     markReadByIds(messages.map((m) => m.id));
   }
@@ -31804,13 +31827,30 @@ server.registerTool("clean_expired_locks", {
   return { content: [{ type: "text", text: JSON.stringify({ released_stale_agent: stale, released_expired: expired, total: stale + expired }) }] };
 });
 server.registerTool("get_thread_replies", {
-  description: "Get all replies in a thread for a given parent message ID.",
+  description: "Get all replies in a thread for a given parent message ID. Also accessible as read_thread.",
   inputSchema: {
-    message_id: exports_external.coerce.number()
+    message_id: exports_external.coerce.number(),
+    limit: exports_external.coerce.number().optional()
+  }
+}, async (args) => {
+  let replies = getThreadReplies(args.message_id);
+  if (args.limit)
+    replies = replies.slice(0, args.limit);
+  const parent = getMessageById(args.message_id);
+  return { content: [{ type: "text", text: JSON.stringify({ parent, replies, reply_count: replies.length }) }] };
+});
+server.registerTool("read_thread", {
+  description: "Alias for get_thread_replies. Read all replies to a specific message, forming a thread view.",
+  inputSchema: {
+    message_id: exports_external.coerce.number(),
+    limit: exports_external.coerce.number().optional()
   }
 }, async (args) => {
-  const replies = getThreadReplies(args.message_id);
-  return { content: [{ type: "text", text: JSON.stringify(replies) }] };
+  let replies = getThreadReplies(args.message_id);
+  if (args.limit)
+    replies = replies.slice(0, args.limit);
+  const parent = getMessageById(args.message_id);
+  return { content: [{ type: "text", text: JSON.stringify({ parent, replies, reply_count: replies.length }) }] };
 });
 server.registerTool("set_focus", {
   description: "Set agent focus to a project. All read-heavy tools will default to this project scope. Stores in MCP session memory AND updates agent_presence.project_id in DB.",
@@ -32058,7 +32098,7 @@ server.registerTool("describe_tools", {
     read_messages: "Read messages with filters. Optional: session_id?, from?, to?, space?, since?(ISO), limit?, unread_only?, mark_read?(default true \u2014 auto-marks returned messages as read, pass false to peek without consuming)",
     read_digest: "Lightweight unread digest \u2014 preview only (no full bodies), auto-marks read, never overflows tokens. Returns { messages, total_unread, shown }. Optional: space?, session_id?, to?, since?(ISO), limit?, project_id?",
     list_sessions: "List all DM sessions. Optional: agent?(filter by participant)",
-    reply: "Reply to a message in same session. Required: message_id, content. Optional: from?",
+    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)",
     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)",
@@ -32102,6 +32142,7 @@ server.registerTool("describe_tools", {
     list_locks: "List active locks enriched with agent presence + time context. Optional: resource_type?, agent_id?",
     clean_expired_locks: "Release expired locks + locks held by agents with stale heartbeat (>30 min). Returns {released_stale_agent, released_expired, total}",
     get_thread_replies: "Get all replies in a thread. Required: message_id. Optional: limit?",
+    read_thread: "Alias for get_thread_replies. Required: message_id. Optional: limit?",
     set_focus: "Set agent focus to a project. All read tools default to this scope. Required: project_id. Optional: from?",
     get_focus: "Get current focus: session focus, DB project_id, effective project_id. Optional: from?",
     unfocus: "Clear agent focus (session + DB). Optional: from?",

package/dist/index.js

@@ -2342,11 +2342,28 @@ function readMessages(opts = {}) {
   if (opts.unread_only) {
     conditions.push("read_at IS NULL");
   }
+  if (opts.threads_only) {
+    conditions.push("reply_to IS NULL");
+  }
   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 rows = db2.prepare(`SELECT * FROM messages ${where} ORDER BY created_at ${order}, id ${order} LIMIT ${resolvedLimit}`).all(...params);
-  const messages = rows.map(parseMessage);
+  let messages = rows.map(parseMessage);
+  if (opts.include_reply_counts && messages.length > 0) {
+    const db22 = getDb();
+    const counts = db22.prepare(`SELECT reply_to, COUNT(*) as c FROM messages WHERE reply_to IN (${messages.map(() => "?").join(",")}) GROUP BY reply_to`).all(...messages.map((m) => m.id));
+    const countMap = new Map(counts.map((r) => [r.reply_to, r.c]));
+    messages = messages.map((m) => ({ ...m, reply_count: countMap.get(m.id) ?? 0 }));
+  }
+  if (opts.max_content_length && opts.max_content_length > 0) {
+    messages = messages.map((m) => {
+      if (m.content.length > opts.max_content_length) {
+        return { ...m, content: m.content.slice(0, opts.max_content_length) + "\u2026", truncated: true };
+      }
+      return m;
+    });
+  }
   if (opts.compact)
     return messages.map(compactMessage);
   return messages;

package/dist/types.d.ts

@@ -19,6 +19,8 @@ export interface Message {
     blocking: boolean;
     attachments: Attachment[] | null;
     reply_to: number | null;
+    reply_count?: number;
+    truncated?: boolean;
 }
 export interface Reaction {
     id: number;
@@ -106,6 +108,9 @@ export interface ReadMessagesOptions {
     unread_only?: boolean;
     order?: "asc" | "desc";
     compact?: boolean;
+    max_content_length?: number;
+    threads_only?: boolean;
+    include_reply_counts?: boolean;
 }
 export interface SearchMessagesOptions {
     query: string;

package/package.json

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