@hasna/conversations 0.2.12 → 0.2.14

package/bin/hook.js

@@ -205,6 +205,9 @@ function getDb() {
   if (!spaceColNames.includes("archived_at")) {
     db.exec("ALTER TABLE spaces ADD COLUMN archived_at TEXT");
   }
+  if (!spaceColNames.includes("topic")) {
+    db.exec("ALTER TABLE spaces ADD COLUMN topic TEXT");
+  }
   const msgCols2 = db.prepare("PRAGMA table_info(messages)").all();
   const colNames2 = msgCols2.map((c) => c.name);
   if (!colNames2.includes("edited_at")) {

package/bin/index.js

@@ -2070,6 +2070,9 @@ function getDb() {
   if (!spaceColNames.includes("archived_at")) {
     db.exec("ALTER TABLE spaces ADD COLUMN archived_at TEXT");
   }
+  if (!spaceColNames.includes("topic")) {
+    db.exec("ALTER TABLE spaces ADD COLUMN topic TEXT");
+  }
   const msgCols2 = db.prepare("PRAGMA table_info(messages)").all();
   const colNames2 = msgCols2.map((c) => c.name);
   if (!colNames2.includes("edited_at")) {
@@ -2803,6 +2806,14 @@ function markMentionsRead(agent, space) {
   const result = db2.prepare("UPDATE message_mentions SET notified_at = strftime('%Y-%m-%dT%H:%M:%f', 'now') WHERE mentioned_agent = ? AND notified_at IS NULL").run(agent);
   return result.changes;
 }
+function markUnreadByIds(ids) {
+  if (ids.length === 0)
+    return 0;
+  const db2 = getDb();
+  const placeholders = ids.map(() => "?").join(",");
+  const result = db2.prepare(`UPDATE messages SET read_at = NULL WHERE id IN (${placeholders})`).run(...ids);
+  return result.changes;
+}
 var init_messages = __esm(() => {
   init_db();
   init_webhooks();
@@ -4442,7 +4453,7 @@ var init_poll = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/conversations",
-    version: "0.2.12",
+    version: "0.2.14",
     description: "Real-time CLI messaging for AI agents",
     type: "module",
     bin: {
@@ -33782,6 +33793,20 @@ var init_mcp2 = __esm(() => {
       content: [{ type: "text", text: JSON.stringify({ marked_read: count }) }]
     };
   });
+  server.registerTool("mark_unread", {
+    description: "Re-flag a message (or messages) as unread so it re-appears in read_messages(unread_only:true). Useful for bookmarking messages to action later.",
+    inputSchema: {
+      message_id: exports_external.coerce.number().optional().describe("Single message ID"),
+      ids: exports_external.array(exports_external.coerce.number()).optional().describe("Multiple message IDs")
+    }
+  }, async (args) => {
+    if (!args.message_id && (!args.ids || args.ids.length === 0)) {
+      return { content: [{ type: "text", text: "Provide message_id or ids" }], isError: true };
+    }
+    const ids = args.ids ?? (args.message_id ? [args.message_id] : []);
+    const count = markUnreadByIds(ids);
+    return { content: [{ type: "text", text: JSON.stringify({ marked_unread: 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: {
@@ -34458,6 +34483,31 @@ var init_mcp2 = __esm(() => {
     const topics = getTrendingTopics({ hours: args.hours, project_id: args.project_id, top_n: args.top_n });
     return { content: [{ type: "text", text: JSON.stringify(topics) }] };
   });
+  server.registerTool("set_space_topic", {
+    description: "Set the current topic/status of a space. Separate from the static description \u2014 use this for live status like '\uD83D\uDD34 blocked on auth' or '\u2705 shipping v2'.",
+    inputSchema: {
+      space: exports_external.string().describe("Space name"),
+      topic: exports_external.string().nullable().describe("New topic/status. Pass null to clear.")
+    }
+  }, async (args) => {
+    const db2 = (await Promise.resolve().then(() => (init_db(), exports_db))).getDb();
+    const existing = db2.prepare("SELECT name FROM spaces WHERE name = ?").get(args.space);
+    if (!existing) {
+      return { content: [{ type: "text", text: `Space not found: ${args.space}` }], isError: true };
+    }
+    db2.prepare("UPDATE spaces SET topic = ? WHERE name = ?").run(args.topic ?? null, args.space);
+    return { content: [{ type: "text", text: args.topic ? `Topic set: ${args.topic}` : "Topic cleared" }] };
+  });
+  server.registerTool("get_space_topic", {
+    description: "Get the current topic/status of a space.",
+    inputSchema: { space: exports_external.string() }
+  }, async (args) => {
+    const db2 = (await Promise.resolve().then(() => (init_db(), exports_db))).getDb();
+    const row = db2.prepare("SELECT topic FROM spaces WHERE name = ?").get(args.space);
+    if (!row)
+      return { content: [{ type: "text", text: `Space not found: ${args.space}` }], isError: true };
+    return { content: [{ type: "text", text: JSON.stringify({ space: args.space, topic: row.topic }) }] };
+  });
   server.registerTool("get_session_activity", {
     description: "Get activity metrics for a session: message velocity, unique agents, reply ratio, reaction count, trending status.",
     inputSchema: {
@@ -34991,6 +35041,8 @@ Last message: ${rows[0]?.created_at?.slice(0, 16) ?? "?"}`);
       get_summary: "Structured conversation summary: participants, topics, key messages, blockers. Required: session_id? or space?. Optional: limit?",
       get_topics: "Extract topics from space or session. Optional: space?, session_id?, limit?",
       trending_topics: "Trending topics across all messages. Optional: hours?, project_id?, top_n?",
+      set_space_topic: "Set current topic/status of a space. Required: space, topic (pass null to clear).",
+      get_space_topic: "Get current topic/status of a space. Required: space.",
       get_session_activity: "Get activity metrics for a session: velocity, agents, reply ratio, reactions, trending. Required: session_id",
       hot_sessions: "List conversations by hotness score (velocity, reactions, replies, priority, blockers). Optional: limit?, min_score?, space?, project_id?",
       add_reaction: "Add emoji reaction to a message. Required: message_id, emoji. Optional: from?",

package/bin/mcp.js

@@ -6702,6 +6702,9 @@ function getDb() {
   if (!spaceColNames.includes("archived_at")) {
     db.exec("ALTER TABLE spaces ADD COLUMN archived_at TEXT");
   }
+  if (!spaceColNames.includes("topic")) {
+    db.exec("ALTER TABLE spaces ADD COLUMN topic TEXT");
+  }
   const msgCols2 = db.prepare("PRAGMA table_info(messages)").all();
   const colNames2 = msgCols2.map((c) => c.name);
   if (!colNames2.includes("edited_at")) {
@@ -29306,6 +29309,14 @@ function markMentionsRead(agent, space) {
   const result = db2.prepare("UPDATE message_mentions SET notified_at = strftime('%Y-%m-%dT%H:%M:%f', 'now') WHERE mentioned_agent = ? AND notified_at IS NULL").run(agent);
   return result.changes;
 }
+function markUnreadByIds(ids) {
+  if (ids.length === 0)
+    return 0;
+  const db2 = getDb();
+  const placeholders = ids.map(() => "?").join(",");
+  const result = db2.prepare(`UPDATE messages SET read_at = NULL WHERE id IN (${placeholders})`).run(...ids);
+  return result.changes;
+}
 
 // src/lib/sessions.ts
 init_db();
@@ -30932,7 +30943,7 @@ function getGraphStats() {
 // package.json
 var package_default = {
   name: "@hasna/conversations",
-  version: "0.2.12",
+  version: "0.2.14",
   description: "Real-time CLI messaging for AI agents",
   type: "module",
   bin: {
@@ -31151,6 +31162,20 @@ server.registerTool("mark_read", {
     content: [{ type: "text", text: JSON.stringify({ marked_read: count }) }]
   };
 });
+server.registerTool("mark_unread", {
+  description: "Re-flag a message (or messages) as unread so it re-appears in read_messages(unread_only:true). Useful for bookmarking messages to action later.",
+  inputSchema: {
+    message_id: exports_external.coerce.number().optional().describe("Single message ID"),
+    ids: exports_external.array(exports_external.coerce.number()).optional().describe("Multiple message IDs")
+  }
+}, async (args) => {
+  if (!args.message_id && (!args.ids || args.ids.length === 0)) {
+    return { content: [{ type: "text", text: "Provide message_id or ids" }], isError: true };
+  }
+  const ids = args.ids ?? (args.message_id ? [args.message_id] : []);
+  const count = markUnreadByIds(ids);
+  return { content: [{ type: "text", text: JSON.stringify({ marked_unread: 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: {
@@ -31827,6 +31852,31 @@ server.registerTool("trending_topics", {
   const topics = getTrendingTopics({ hours: args.hours, project_id: args.project_id, top_n: args.top_n });
   return { content: [{ type: "text", text: JSON.stringify(topics) }] };
 });
+server.registerTool("set_space_topic", {
+  description: "Set the current topic/status of a space. Separate from the static description \u2014 use this for live status like '\uD83D\uDD34 blocked on auth' or '\u2705 shipping v2'.",
+  inputSchema: {
+    space: exports_external.string().describe("Space name"),
+    topic: exports_external.string().nullable().describe("New topic/status. Pass null to clear.")
+  }
+}, async (args) => {
+  const db2 = (await Promise.resolve().then(() => (init_db(), exports_db))).getDb();
+  const existing = db2.prepare("SELECT name FROM spaces WHERE name = ?").get(args.space);
+  if (!existing) {
+    return { content: [{ type: "text", text: `Space not found: ${args.space}` }], isError: true };
+  }
+  db2.prepare("UPDATE spaces SET topic = ? WHERE name = ?").run(args.topic ?? null, args.space);
+  return { content: [{ type: "text", text: args.topic ? `Topic set: ${args.topic}` : "Topic cleared" }] };
+});
+server.registerTool("get_space_topic", {
+  description: "Get the current topic/status of a space.",
+  inputSchema: { space: exports_external.string() }
+}, async (args) => {
+  const db2 = (await Promise.resolve().then(() => (init_db(), exports_db))).getDb();
+  const row = db2.prepare("SELECT topic FROM spaces WHERE name = ?").get(args.space);
+  if (!row)
+    return { content: [{ type: "text", text: `Space not found: ${args.space}` }], isError: true };
+  return { content: [{ type: "text", text: JSON.stringify({ space: args.space, topic: row.topic }) }] };
+});
 server.registerTool("get_session_activity", {
   description: "Get activity metrics for a session: message velocity, unique agents, reply ratio, reaction count, trending status.",
   inputSchema: {
@@ -32360,6 +32410,8 @@ server.registerTool("describe_tools", {
     get_summary: "Structured conversation summary: participants, topics, key messages, blockers. Required: session_id? or space?. Optional: limit?",
     get_topics: "Extract topics from space or session. Optional: space?, session_id?, limit?",
     trending_topics: "Trending topics across all messages. Optional: hours?, project_id?, top_n?",
+    set_space_topic: "Set current topic/status of a space. Required: space, topic (pass null to clear).",
+    get_space_topic: "Get current topic/status of a space. Required: space.",
     get_session_activity: "Get activity metrics for a session: velocity, agents, reply ratio, reactions, trending. Required: session_id",
     hot_sessions: "List conversations by hotness score (velocity, reactions, replies, priority, blockers). Optional: limit?, min_score?, space?, project_id?",
     add_reaction: "Add emoji reaction to a message. Required: message_id, emoji. Optional: from?",

package/dist/index.js

@@ -229,6 +229,9 @@ function getDb() {
   if (!spaceColNames.includes("archived_at")) {
     db.exec("ALTER TABLE spaces ADD COLUMN archived_at TEXT");
   }
+  if (!spaceColNames.includes("topic")) {
+    db.exec("ALTER TABLE spaces ADD COLUMN topic TEXT");
+  }
   const msgCols2 = db.prepare("PRAGMA table_info(messages)").all();
   const colNames2 = msgCols2.map((c) => c.name);
   if (!colNames2.includes("edited_at")) {

package/dist/lib/messages.d.ts

@@ -88,3 +88,7 @@ export declare function getMessagesForAgent(agent: string, opts?: {
 }>;
 /** Mark mentions as notified (agent has seen them). */
 export declare function markMentionsRead(agent: string, space?: string): number;
+/** Mark a specific message as unread (resets read_at to null). */
+export declare function markUnread(messageId: number): number;
+/** Mark multiple messages as unread. */
+export declare function markUnreadByIds(ids: number[]): number;

package/package.json

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