@hasna/conversations 0.1.32 → 0.2.0

package/bin/index.js

@@ -2498,15 +2498,26 @@ function getUnreadBlockers(agent) {
   `).all(agent, agent);
   return rows.map(parseMessage);
 }
+function getThreadReplies(messageId) {
+  const db2 = getDb();
+  const rows = db2.prepare("SELECT * FROM messages WHERE reply_to = ? ORDER BY created_at ASC, id ASC").all(messageId);
+  return rows.map(parseMessage);
+}
 function searchMessages(opts) {
   const db2 = getDb();
   const limit = Number.isFinite(opts.limit) && opts.limit > 0 ? Math.floor(opts.limit) : 20;
+  const sortByRelevance = opts.sort !== "recent";
+  const priorityWeights = { urgent: 10, high: 5, normal: 1, low: 0.5 };
   try {
-    const ftsConditions = [];
     const ftsParams = [];
-    const words = opts.query.trim().split(/\s+/).filter(Boolean);
-    const ftsQuery = words.map((w) => `"${w.replace(/"/g, '""')}"`).join(" ");
-    ftsConditions.push("messages_fts MATCH ?");
+    const query = opts.query.trim();
+    let ftsQuery;
+    if (query.startsWith('"') && query.endsWith('"')) {
+      ftsQuery = query;
+    } else {
+      const words = query.split(/\s+/).filter(Boolean);
+      ftsQuery = words.map((w) => `"${w.replace(/"/g, '""')}"`).join(" ");
+    }
     ftsParams.push(ftsQuery);
     let extraWhere = "";
     if (opts.space) {
@@ -2521,11 +2532,23 @@ function searchMessages(opts) {
       extraWhere += " AND m.to_agent = ?";
       ftsParams.push(opts.to);
     }
-    const rows2 = db2.prepare(`SELECT m.* FROM messages m
+    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
+       FROM messages m
        JOIN messages_fts ON messages_fts.rowid = m.id
-       WHERE ${ftsConditions.join(" AND ")}${extraWhere}
-       ORDER BY m.created_at DESC, m.id DESC LIMIT ${limit}`).all(...ftsParams);
-    return rows2.map(parseMessage);
+       WHERE messages_fts MATCH ?${extraWhere}
+       ${orderClause} LIMIT ${limit}`).all(...ftsParams);
+    const maxRank = rows2.reduce((max, r) => Math.max(max, Math.abs(r.rank || 0)), 0) || 1;
+    return rows2.map((row) => {
+      const msg = parseMessage(row);
+      const ftsScore = maxRank > 0 ? Math.abs(row.rank || 0) / maxRank * 100 : 50;
+      const priorityBoost = priorityWeights[msg.priority] || 1;
+      const pinnedBoost = msg.pinned_at ? 20 : 0;
+      const blockingBoost = msg.blocking ? 15 : 0;
+      const relevance_score = Math.round((ftsScore * priorityBoost + pinnedBoost + blockingBoost) * 100) / 100;
+      return { ...msg, snippet: row.snippet || null, relevance_score };
+    });
   } catch {}
   const conditions = ["content LIKE ?"];
   const params = [`%${opts.query}%`];
@@ -2543,7 +2566,10 @@ function searchMessages(opts) {
   }
   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(parseMessage);
+  return rows.map((row) => {
+    const msg = parseMessage(row);
+    return { ...msg, snippet: null, relevance_score: 0 };
+  });
 }
 var init_messages = __esm(() => {
   init_db();
@@ -2579,6 +2605,32 @@ function listSessions(agent) {
     };
   });
 }
+function getSessionActivity(sessionId) {
+  const db2 = getDb();
+  const exists = db2.prepare("SELECT 1 FROM messages WHERE session_id = ? LIMIT 1").get(sessionId);
+  if (!exists)
+    return null;
+  const msgsLast1h = db2.prepare("SELECT COUNT(*) as c FROM messages WHERE session_id = ? AND created_at > strftime('%Y-%m-%dT%H:%M:%f', 'now', '-1 hour')").get(sessionId).c;
+  const msgsLast24h = db2.prepare("SELECT COUNT(*) as c FROM messages WHERE session_id = ? AND created_at > strftime('%Y-%m-%dT%H:%M:%f', 'now', '-24 hours')").get(sessionId).c;
+  const uniqueAgents = db2.prepare("SELECT COUNT(DISTINCT from_agent) as c FROM messages WHERE session_id = ?").get(sessionId).c;
+  const totalMsgs = db2.prepare("SELECT COUNT(*) as c FROM messages WHERE session_id = ?").get(sessionId).c;
+  const replyCount = db2.prepare("SELECT COUNT(*) as c FROM messages WHERE session_id = ? AND reply_to IS NOT NULL").get(sessionId).c;
+  const replyRatio = totalMsgs > 0 ? Math.round(replyCount / totalMsgs * 100) / 100 : 0;
+  const priorityRow = db2.prepare("SELECT priority, COUNT(*) as c FROM messages WHERE session_id = ? GROUP BY priority ORDER BY c DESC LIMIT 1").get(sessionId);
+  const reactionCount = db2.prepare("SELECT COUNT(*) as c FROM reactions r JOIN messages m ON r.message_id = m.id WHERE m.session_id = ?").get(sessionId).c;
+  const agentsLast1h = db2.prepare("SELECT COUNT(DISTINCT from_agent) as c FROM messages WHERE session_id = ? AND created_at > strftime('%Y-%m-%dT%H:%M:%f', 'now', '-1 hour')").get(sessionId).c;
+  const isTrending = msgsLast1h >= 5 || agentsLast1h >= 3;
+  return {
+    session_id: sessionId,
+    msgs_last_1h: msgsLast1h,
+    msgs_last_24h: msgsLast24h,
+    unique_agents: uniqueAgents,
+    reply_ratio: replyRatio,
+    avg_priority: priorityRow?.priority ?? "normal",
+    reaction_count: reactionCount,
+    is_trending: isTrending
+  };
+}
 var init_sessions = __esm(() => {
   init_db();
 });
@@ -3478,6 +3530,539 @@ var init_presence = __esm(() => {
   CONFLICT_THRESHOLD_SECONDS = 30 * 60;
 });
 
+// src/lib/reactions.ts
+function addReaction(messageId, agent, emoji) {
+  const db2 = getDb();
+  const stmt = db2.prepare(`
+    INSERT INTO reactions (message_id, agent, emoji)
+    VALUES (?, ?, ?)
+    ON CONFLICT (message_id, agent, emoji) DO UPDATE SET agent = agent
+    RETURNING *
+  `);
+  const row = stmt.get(messageId, agent, emoji);
+  return row;
+}
+function removeReaction(messageId, agent, emoji) {
+  const db2 = getDb();
+  const stmt = db2.prepare("DELETE FROM reactions WHERE message_id = ? AND agent = ? AND emoji = ?");
+  const result = stmt.run(messageId, agent, emoji);
+  return result.changes > 0;
+}
+function getReactions(messageId) {
+  const db2 = getDb();
+  const rows = db2.prepare("SELECT * FROM reactions WHERE message_id = ? ORDER BY created_at ASC, id ASC").all(messageId);
+  return rows;
+}
+function getReactionSummary(messageId) {
+  const db2 = getDb();
+  const rows = db2.prepare(`
+    SELECT emoji, GROUP_CONCAT(agent) as agents, COUNT(*) as count
+    FROM reactions
+    WHERE message_id = ?
+    GROUP BY emoji
+    ORDER BY count DESC, MIN(created_at) ASC
+  `).all(messageId);
+  return rows.map((row) => ({
+    emoji: row.emoji,
+    count: row.count,
+    agents: row.agents.split(",")
+  }));
+}
+var init_reactions = __esm(() => {
+  init_db();
+});
+
+// src/lib/hot.ts
+function computeHotness(sessionId) {
+  const db2 = getDb();
+  const base = db2.prepare(`
+    SELECT session_id,
+      GROUP_CONCAT(DISTINCT from_agent) as agents,
+      MAX(space) as space,
+      MAX(created_at) as last_message_at,
+      COUNT(*) as message_count
+    FROM messages WHERE session_id = ?
+    GROUP BY session_id
+  `).get(sessionId);
+  if (!base)
+    return null;
+  const msgsLast1h = db2.prepare("SELECT COUNT(*) as c FROM messages WHERE session_id = ? AND created_at > strftime('%Y-%m-%dT%H:%M:%f', 'now', '-1 hour')").get(sessionId).c;
+  const msgsLast24h = db2.prepare("SELECT COUNT(*) as c FROM messages WHERE session_id = ? AND created_at > strftime('%Y-%m-%dT%H:%M:%f', 'now', '-24 hours')").get(sessionId).c;
+  const uniqueAgents = db2.prepare("SELECT COUNT(DISTINCT from_agent) as c FROM messages WHERE session_id = ?").get(sessionId).c;
+  const reactionCount = db2.prepare("SELECT COUNT(*) as c FROM reactions r JOIN messages m ON r.message_id = m.id WHERE m.session_id = ?").get(sessionId).c;
+  const replyCount = db2.prepare("SELECT COUNT(*) as c FROM messages WHERE session_id = ? AND reply_to IS NOT NULL").get(sessionId).c;
+  const highPriorityCount = db2.prepare("SELECT COUNT(*) as c FROM messages WHERE session_id = ? AND priority IN ('high', 'urgent')").get(sessionId).c;
+  const blockerCount = db2.prepare("SELECT COUNT(*) as c FROM messages WHERE session_id = ? AND blocking = 1").get(sessionId).c;
+  const lastMsgMs = new Date(base.last_message_at + "Z").getTime();
+  const hoursSinceLast = Math.max(0, (Date.now() - lastMsgMs) / 3600000);
+  const hotness_score = Math.round(msgsLast1h * 3 + uniqueAgents * 5 + reactionCount * 2 + replyCount * 4 + highPriorityCount * 10 + blockerCount * 20 - hoursSinceLast * 2);
+  return {
+    session_id: base.session_id,
+    participants: base.agents.split(","),
+    space: base.space,
+    last_message_at: base.last_message_at,
+    message_count: base.message_count,
+    hotness_score,
+    metrics: {
+      msgs_last_1h: msgsLast1h,
+      msgs_last_24h: msgsLast24h,
+      unique_agents: uniqueAgents,
+      reaction_count: reactionCount,
+      reply_count: replyCount,
+      high_priority_count: highPriorityCount,
+      blocker_count: blockerCount,
+      hours_since_last: Math.round(hoursSinceLast * 10) / 10
+    }
+  };
+}
+function listHotSessions(opts) {
+  const db2 = getDb();
+  const limit = opts?.limit ?? 20;
+  const minScore = opts?.min_score ?? 0;
+  let where = "";
+  const params = [];
+  if (opts?.space) {
+    where = " WHERE space = ?";
+    params.push(opts.space);
+  } else if (opts?.project_id) {
+    where = " WHERE project_id = ?";
+    params.push(opts.project_id);
+  }
+  const sessions = db2.prepare(`SELECT session_id, MAX(created_at) as last_at FROM messages${where} GROUP BY session_id ORDER BY last_at DESC LIMIT 100`).all(...params);
+  const hotSessions = [];
+  for (const { session_id } of sessions) {
+    const hot = computeHotness(session_id);
+    if (hot && hot.hotness_score >= minScore) {
+      hotSessions.push(hot);
+    }
+  }
+  hotSessions.sort((a, b) => b.hotness_score - a.hotness_score);
+  return hotSessions.slice(0, limit);
+}
+var init_hot = __esm(() => {
+  init_db();
+});
+
+// src/lib/topics.ts
+function extractTopics(text, topN = 10) {
+  const cleaned = text.replace(/```[\s\S]*?```/g, " ").replace(/`[^`]+`/g, " ").replace(/https?:\/\/\S+/g, " ").replace(/[#*_~|>\[\](){}]/g, " ").replace(/\d+/g, " ").toLowerCase();
+  const words = cleaned.split(/\s+/).filter((w) => w.length >= 3 && !STOPWORDS.has(w) && /^[a-z]/.test(w));
+  const freq = new Map;
+  for (const w of words) {
+    freq.set(w, (freq.get(w) || 0) + 1);
+  }
+  const totalWords = words.length || 1;
+  return [...freq.entries()].sort((a, b) => b[1] - a[1]).slice(0, topN).map(([topic, count]) => ({
+    topic,
+    weight: Math.round(count / totalWords * 1000) / 1000,
+    count
+  }));
+}
+function getSpaceTopics(spaceName, opts) {
+  const db2 = getDb();
+  const limit = opts?.limit ?? 100;
+  const sinceClause = opts?.since ? "AND created_at > ?" : "";
+  const params = [spaceName];
+  if (opts?.since)
+    params.push(opts.since);
+  const rows = db2.prepare(`SELECT content FROM messages WHERE space = ? ${sinceClause} ORDER BY created_at DESC LIMIT ${limit}`).all(...params);
+  const combined = rows.map((r) => r.content).join(`
+`);
+  return extractTopics(combined, 15);
+}
+function getSessionTopics(sessionId, opts) {
+  const db2 = getDb();
+  const limit = opts?.limit ?? 100;
+  const rows = db2.prepare(`SELECT content FROM messages WHERE session_id = ? ORDER BY created_at DESC LIMIT ${limit}`).all(sessionId);
+  const combined = rows.map((r) => r.content).join(`
+`);
+  return extractTopics(combined, 15);
+}
+function getTrendingTopics(opts) {
+  const db2 = getDb();
+  const hours = opts?.hours ?? 24;
+  const topN = opts?.top_n ?? 20;
+  let where = `WHERE created_at > strftime('%Y-%m-%dT%H:%M:%f', 'now', '-${hours} hours')`;
+  const params = [];
+  if (opts?.project_id) {
+    where += " AND project_id = ?";
+    params.push(opts.project_id);
+  }
+  const rows = db2.prepare(`SELECT content FROM messages ${where} ORDER BY created_at DESC LIMIT 500`).all(...params);
+  const combined = rows.map((r) => r.content).join(`
+`);
+  return extractTopics(combined, topN);
+}
+var STOPWORDS;
+var init_topics = __esm(() => {
+  init_db();
+  STOPWORDS = new Set([
+    "a",
+    "an",
+    "the",
+    "and",
+    "or",
+    "but",
+    "in",
+    "on",
+    "at",
+    "to",
+    "for",
+    "of",
+    "with",
+    "by",
+    "from",
+    "is",
+    "it",
+    "this",
+    "that",
+    "are",
+    "was",
+    "were",
+    "be",
+    "been",
+    "being",
+    "have",
+    "has",
+    "had",
+    "do",
+    "does",
+    "did",
+    "will",
+    "would",
+    "could",
+    "should",
+    "may",
+    "might",
+    "shall",
+    "can",
+    "need",
+    "not",
+    "no",
+    "so",
+    "if",
+    "then",
+    "than",
+    "too",
+    "very",
+    "just",
+    "about",
+    "up",
+    "out",
+    "all",
+    "also",
+    "as",
+    "into",
+    "only",
+    "other",
+    "each",
+    "every",
+    "both",
+    "few",
+    "more",
+    "most",
+    "some",
+    "such",
+    "any",
+    "over",
+    "after",
+    "before",
+    "between",
+    "under",
+    "above",
+    "here",
+    "there",
+    "when",
+    "where",
+    "how",
+    "what",
+    "which",
+    "who",
+    "whom",
+    "why",
+    "its",
+    "my",
+    "your",
+    "his",
+    "her",
+    "our",
+    "their",
+    "we",
+    "you",
+    "he",
+    "she",
+    "they",
+    "i",
+    "me",
+    "him",
+    "us",
+    "them",
+    "now",
+    "new",
+    "get",
+    "got",
+    "go",
+    "going",
+    "done",
+    "make",
+    "made",
+    "see",
+    "know",
+    "think",
+    "want",
+    "one",
+    "two",
+    "like",
+    "still",
+    "back",
+    "even"
+  ]);
+});
+
+// src/lib/summary.ts
+function getConversationSummary(sessionOrSpace, opts) {
+  const db2 = getDb();
+  const limit = opts?.limit ?? 50;
+  const isSpace = sessionOrSpace.startsWith("space:") || db2.prepare("SELECT 1 FROM spaces WHERE name = ?").get(sessionOrSpace);
+  const filterCol = isSpace ? "space" : "session_id";
+  const filterVal = isSpace && !sessionOrSpace.startsWith("space:") ? sessionOrSpace : sessionOrSpace;
+  const messages = db2.prepare(`SELECT * FROM messages WHERE ${filterCol} = ? ORDER BY created_at DESC LIMIT ${limit}`).all(filterVal);
+  if (messages.length === 0)
+    return null;
+  const agents = new Set;
+  for (const m of messages) {
+    agents.add(m.from_agent);
+    if (m.to_agent)
+      agents.add(m.to_agent);
+  }
+  const dates = messages.map((m) => m.created_at).sort();
+  const dateRange = { first: dates[0], last: dates[dates.length - 1] };
+  const allContent = messages.map((m) => m.content).join(`
+`);
+  const topics = extractTopics(allContent, 10);
+  const keyMessages = [];
+  for (const m of messages) {
+    const priority = m.priority;
+    if (priority === "high" || priority === "urgent") {
+      keyMessages.push({
+        id: m.id,
+        from: m.from_agent,
+        content: m.content.slice(0, 200),
+        reason: `${priority} priority`
+      });
+    }
+    if (m.blocking) {
+      keyMessages.push({
+        id: m.id,
+        from: m.from_agent,
+        content: m.content.slice(0, 200),
+        reason: "blocking message"
+      });
+    }
+  }
+  for (const m of messages) {
+    if (m.pinned_at) {
+      keyMessages.push({
+        id: m.id,
+        from: m.from_agent,
+        content: m.content.slice(0, 200),
+        reason: "pinned"
+      });
+    }
+  }
+  const msgIds = messages.map((m) => m.id);
+  if (msgIds.length > 0) {
+    const placeholders = msgIds.map(() => "?").join(",");
+    const reacted = db2.prepare(`SELECT message_id, COUNT(*) as c FROM reactions WHERE message_id IN (${placeholders}) GROUP BY message_id ORDER BY c DESC LIMIT 3`).all(...msgIds);
+    for (const r of reacted) {
+      const m = messages.find((msg) => msg.id === r.message_id);
+      if (m) {
+        keyMessages.push({
+          id: r.message_id,
+          from: m.from_agent,
+          content: m.content.slice(0, 200),
+          reason: `${r.c} reaction(s)`
+        });
+      }
+    }
+  }
+  const seen = new Set;
+  const uniqueKey = keyMessages.filter((k) => {
+    if (seen.has(k.id))
+      return false;
+    seen.add(k.id);
+    return true;
+  }).slice(0, 10);
+  const blockers = messages.filter((m) => m.blocking && !m.read_at).map((m) => ({
+    id: m.id,
+    from: m.from_agent,
+    content: m.content.slice(0, 200),
+    created_at: m.created_at
+  }));
+  const replyCount = messages.filter((m) => m.reply_to).length;
+  const reactionCount = msgIds.length > 0 ? db2.prepare(`SELECT COUNT(*) as c FROM reactions WHERE message_id IN (${msgIds.map(() => "?").join(",")})`).get(...msgIds).c : 0;
+  const priorityCounts = {};
+  for (const m of messages) {
+    const p = m.priority;
+    priorityCounts[p] = (priorityCounts[p] || 0) + 1;
+  }
+  const avgPriority = Object.entries(priorityCounts).sort((a, b) => b[1] - a[1])[0]?.[0] ?? "normal";
+  return {
+    session_id: sessionOrSpace,
+    participants: [...agents].filter((a) => a !== sessionOrSpace),
+    message_count: messages.length,
+    date_range: dateRange,
+    topics,
+    key_messages: uniqueKey,
+    unresolved_blockers: blockers,
+    activity: {
+      reply_count: replyCount,
+      reaction_count: reactionCount,
+      avg_priority: avgPriority
+    }
+  };
+}
+var init_summary = __esm(() => {
+  init_db();
+  init_topics();
+});
+
+// src/lib/graph.ts
+function ensureGraphTable() {
+  const db2 = getDb();
+  db2.exec(`
+    CREATE TABLE IF NOT EXISTS graph_edges (
+      from_type TEXT NOT NULL,
+      from_id TEXT NOT NULL,
+      to_type TEXT NOT NULL,
+      to_id TEXT NOT NULL,
+      relation TEXT NOT NULL,
+      weight REAL NOT NULL DEFAULT 1,
+      metadata TEXT,
+      created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
+      updated_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
+      UNIQUE(from_type, from_id, to_type, to_id, relation)
+    )
+  `);
+  db2.exec("CREATE INDEX IF NOT EXISTS idx_graph_from ON graph_edges(from_type, from_id)");
+  db2.exec("CREATE INDEX IF NOT EXISTS idx_graph_to ON graph_edges(to_type, to_id)");
+  db2.exec("CREATE INDEX IF NOT EXISTS idx_graph_relation ON graph_edges(relation)");
+}
+function buildGraph() {
+  const db2 = getDb();
+  ensureGraphTable();
+  let created = 0;
+  let updated = 0;
+  const upsert = db2.prepare(`
+    INSERT INTO graph_edges (from_type, from_id, to_type, to_id, relation, weight, updated_at)
+    VALUES (?, ?, ?, ?, ?, ?, strftime('%Y-%m-%dT%H:%M:%f', 'now'))
+    ON CONFLICT(from_type, from_id, to_type, to_id, relation) DO UPDATE SET
+      weight = excluded.weight,
+      updated_at = excluded.updated_at
+  `);
+  const insertOrUpdate = db2.transaction(() => {
+    const dmPairs = db2.prepare(`
+      SELECT from_agent, to_agent, COUNT(*) as cnt, MAX(created_at) as last_at
+      FROM messages WHERE space IS NULL AND from_agent != to_agent
+      GROUP BY from_agent, to_agent
+    `).all();
+    for (const pair of dmPairs) {
+      const existing = db2.prepare("SELECT 1 FROM graph_edges WHERE from_type='agent' AND from_id=? AND to_type='agent' AND to_id=? AND relation='communicates_with'").get(pair.from_agent, pair.to_agent);
+      upsert.run("agent", pair.from_agent, "agent", pair.to_agent, "communicates_with", pair.cnt);
+      if (existing)
+        updated++;
+      else
+        created++;
+    }
+    const spacePosts = db2.prepare(`
+      SELECT from_agent, space, COUNT(*) as cnt
+      FROM messages WHERE space IS NOT NULL
+      GROUP BY from_agent, space
+    `).all();
+    for (const sp of spacePosts) {
+      const existing = db2.prepare("SELECT 1 FROM graph_edges WHERE from_type='agent' AND from_id=? AND to_type='space' AND to_id=? AND relation='posts_in'").get(sp.from_agent, sp.space);
+      upsert.run("agent", sp.from_agent, "space", sp.space, "posts_in", sp.cnt);
+      if (existing)
+        updated++;
+      else
+        created++;
+    }
+    const members = db2.prepare("SELECT agent, space FROM space_members").all();
+    for (const m of members) {
+      const existing = db2.prepare("SELECT 1 FROM graph_edges WHERE from_type='agent' AND from_id=? AND to_type='space' AND to_id=? AND relation='member_of'").get(m.agent, m.space);
+      upsert.run("agent", m.agent, "space", m.space, "member_of", 1);
+      if (existing)
+        updated++;
+      else
+        created++;
+    }
+    const spaceProjects = db2.prepare("SELECT name, project_id FROM spaces WHERE project_id IS NOT NULL").all();
+    for (const sp of spaceProjects) {
+      const existing = db2.prepare("SELECT 1 FROM graph_edges WHERE from_type='space' AND from_id=? AND to_type='project' AND to_id=? AND relation='belongs_to'").get(sp.name, sp.project_id);
+      upsert.run("space", sp.name, "project", sp.project_id, "belongs_to", 1);
+      if (existing)
+        updated++;
+      else
+        created++;
+    }
+  });
+  insertOrUpdate();
+  return { edges_created: created, edges_updated: updated };
+}
+function getRelated(entityType, entityId) {
+  const db2 = getDb();
+  ensureGraphTable();
+  const outgoing = db2.prepare(`
+    SELECT to_type as type, to_id as id, relation, weight FROM graph_edges
+    WHERE from_type = ? AND from_id = ? ORDER BY weight DESC
+  `).all(entityType, entityId);
+  const incoming = db2.prepare(`
+    SELECT from_type as type, from_id as id, relation, weight FROM graph_edges
+    WHERE to_type = ? AND to_id = ? ORDER BY weight DESC
+  `).all(entityType, entityId);
+  return [...outgoing, ...incoming];
+}
+function getAgentNetwork(agent) {
+  const db2 = getDb();
+  ensureGraphTable();
+  const comms = db2.prepare(`
+    SELECT to_id as agent, weight as message_count,
+      (SELECT MAX(created_at) FROM messages WHERE from_agent = ? AND to_agent = ge.to_id AND space IS NULL) as last_at
+    FROM graph_edges ge
+    WHERE from_type = 'agent' AND from_id = ? AND relation = 'communicates_with'
+    ORDER BY weight DESC LIMIT 20
+  `).all(agent, agent);
+  const spaces = db2.prepare(`
+    SELECT to_id as space, weight as message_count FROM graph_edges
+    WHERE from_type = 'agent' AND from_id = ? AND relation = 'posts_in'
+    ORDER BY weight DESC LIMIT 20
+  `).all(agent);
+  const projects = db2.prepare(`
+    SELECT DISTINCT g2.to_id FROM graph_edges g1
+    JOIN graph_edges g2 ON g1.to_type = 'space' AND g1.to_id = g2.from_id AND g2.relation = 'belongs_to'
+    WHERE g1.from_type = 'agent' AND g1.from_id = ? AND g1.relation IN ('member_of', 'posts_in')
+  `).all(agent);
+  return {
+    agent,
+    communicates_with: comms,
+    spaces,
+    projects: projects.map((p) => p.to_id)
+  };
+}
+function getGraphStats() {
+  const db2 = getDb();
+  ensureGraphTable();
+  const total = db2.prepare("SELECT COUNT(*) as c FROM graph_edges").get().c;
+  const byRelation = db2.prepare("SELECT relation, COUNT(*) as c FROM graph_edges GROUP BY relation ORDER BY c DESC").all();
+  const map = {};
+  for (const r of byRelation)
+    map[r.relation] = r.c;
+  return { total_edges: total, by_relation: map };
+}
+var init_graph = __esm(() => {
+  init_db();
+});
+
 // src/lib/terminal-markdown.ts
 var exports_terminal_markdown = {};
 __export(exports_terminal_markdown, {
@@ -3622,7 +4207,7 @@ var init_poll = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/conversations",
-    version: "0.1.32",
+    version: "0.2.0",
     description: "Real-time CLI messaging for AI agents",
     type: "module",
     bin: {
@@ -32566,6 +33151,84 @@ var init_stdio2 = __esm(() => {
   init_stdio();
 });
 
+// src/lib/locks.ts
+function acquireLock(resourceType, resourceId, agentId, lockType = "advisory", expiryMs = DEFAULT_LOCK_EXPIRY_MS) {
+  const db2 = getDb();
+  return db2.transaction(() => {
+    cleanExpiredLocks();
+    const existing = db2.prepare(`
+      SELECT * FROM resource_locks
+      WHERE resource_type = ? AND resource_id = ? AND lock_type = ?
+    `).get(resourceType, resourceId, lockType);
+    if (existing) {
+      if (existing.agent_id !== agentId) {
+        return { acquired: false, lock: null, held_by: existing.agent_id };
+      }
+      const expiresAt = new Date(Date.now() + expiryMs).toISOString().replace("T", "T").replace("Z", "");
+      db2.prepare(`
+        UPDATE resource_locks SET expires_at = ?, locked_at = strftime('%Y-%m-%dT%H:%M:%f', 'now')
+        WHERE resource_type = ? AND resource_id = ? AND lock_type = ?
+      `).run(expiresAt, resourceType, resourceId, lockType);
+    } else {
+      const expiresAt = new Date(Date.now() + expiryMs).toISOString().slice(0, -1);
+      db2.prepare(`
+        INSERT INTO resource_locks (resource_type, resource_id, agent_id, lock_type, locked_at, expires_at)
+        VALUES (?, ?, ?, ?, strftime('%Y-%m-%dT%H:%M:%f', 'now'), ?)
+      `).run(resourceType, resourceId, agentId, lockType, expiresAt);
+    }
+    const lock = db2.prepare(`
+      SELECT * FROM resource_locks WHERE resource_type = ? AND resource_id = ? AND lock_type = ?
+    `).get(resourceType, resourceId, lockType);
+    return { acquired: true, lock };
+  }).immediate();
+}
+function releaseLock(resourceType, resourceId, agentId) {
+  const db2 = getDb();
+  const result = db2.prepare(`
+    DELETE FROM resource_locks
+    WHERE resource_type = ? AND resource_id = ? AND agent_id = ?
+  `).run(resourceType, resourceId, agentId);
+  return result.changes > 0;
+}
+function checkLock(resourceType, resourceId) {
+  const db2 = getDb();
+  cleanExpiredLocks();
+  return db2.prepare(`
+    SELECT * FROM resource_locks
+    WHERE resource_type = ? AND resource_id = ?
+    ORDER BY locked_at ASC
+    LIMIT 1
+  `).get(resourceType, resourceId);
+}
+function cleanExpiredLocks() {
+  const db2 = getDb();
+  const result = db2.prepare(`
+    DELETE FROM resource_locks WHERE expires_at < strftime('%Y-%m-%dT%H:%M:%f', 'now')
+  `).run();
+  return result.changes;
+}
+function listLocks(opts) {
+  const db2 = getDb();
+  cleanExpiredLocks();
+  let query = "SELECT * FROM resource_locks WHERE 1=1";
+  const params = [];
+  if (opts?.resource_type) {
+    query += " AND resource_type = ?";
+    params.push(opts.resource_type);
+  }
+  if (opts?.agent_id) {
+    query += " AND agent_id = ?";
+    params.push(opts.agent_id);
+  }
+  query += " ORDER BY locked_at ASC";
+  return db2.prepare(query).all(...params);
+}
+var DEFAULT_LOCK_EXPIRY_MS;
+var init_locks = __esm(() => {
+  init_db();
+  DEFAULT_LOCK_EXPIRY_MS = 5 * 60 * 1000;
+});
+
 // src/mcp/index.ts
 var exports_mcp = {};
 __export(exports_mcp, {
@@ -32599,6 +33262,12 @@ var init_mcp2 = __esm(() => {
   init_projects();
   init_identity();
   init_presence();
+  init_reactions();
+  init_locks();
+  init_hot();
+  init_topics();
+  init_summary();
+  init_graph();
   import__package = __toESM(require_package(), 1);
   server = new McpServer({
     name: "conversations",
@@ -33239,6 +33908,207 @@ var init_mcp2 = __esm(() => {
       content: [{ type: "text", text: JSON.stringify(messages) }]
     };
   });
+  server.registerTool("build_graph", {
+    description: "Build/rebuild the knowledge graph from messages, spaces, and projects. Creates relationship edges between agents, spaces, and projects.",
+    inputSchema: {}
+  }, async () => {
+    const result = buildGraph();
+    return { content: [{ type: "text", text: JSON.stringify(result) }] };
+  });
+  server.registerTool("get_related", {
+    description: "Find all entities related to a given entity in the knowledge graph.",
+    inputSchema: {
+      entity_type: exports_external.string(),
+      entity_id: exports_external.string()
+    }
+  }, async (args) => {
+    const related = getRelated(args.entity_type, args.entity_id);
+    return { content: [{ type: "text", text: JSON.stringify(related) }] };
+  });
+  server.registerTool("get_agent_network", {
+    description: "Get an agent's communication network: who they talk to, spaces, projects.",
+    inputSchema: {
+      agent: exports_external.string()
+    }
+  }, async (args) => {
+    const network = getAgentNetwork(args.agent);
+    return { content: [{ type: "text", text: JSON.stringify(network) }] };
+  });
+  server.registerTool("graph_stats", {
+    description: "Get knowledge graph statistics: total edges and counts by relation type.",
+    inputSchema: {}
+  }, async () => {
+    const stats = getGraphStats();
+    return { content: [{ type: "text", text: JSON.stringify(stats) }] };
+  });
+  server.registerTool("get_summary", {
+    description: "Get a structured summary of a conversation (session or space): participants, topics, key messages, blockers, activity.",
+    inputSchema: {
+      session_id: exports_external.string().optional(),
+      space: exports_external.string().optional(),
+      limit: exports_external.coerce.number().optional()
+    }
+  }, async (args) => {
+    const target = args.space || args.session_id;
+    if (!target)
+      return { content: [{ type: "text", text: "session_id or space required" }], isError: true };
+    const summary = getConversationSummary(target, { limit: args.limit });
+    if (!summary)
+      return { content: [{ type: "text", text: `No messages found for "${target}"` }], isError: true };
+    return { content: [{ type: "text", text: JSON.stringify(summary) }] };
+  });
+  server.registerTool("get_topics", {
+    description: "Extract topics from a space or session. Returns weighted keyword list.",
+    inputSchema: {
+      space: exports_external.string().optional(),
+      session_id: exports_external.string().optional(),
+      limit: exports_external.coerce.number().optional()
+    }
+  }, async (args) => {
+    const topics = args.space ? getSpaceTopics(args.space, { limit: args.limit }) : args.session_id ? getSessionTopics(args.session_id, { limit: args.limit }) : getTrendingTopics({ top_n: args.limit });
+    return { content: [{ type: "text", text: JSON.stringify(topics) }] };
+  });
+  server.registerTool("trending_topics", {
+    description: "Get trending topics across all messages in the last N hours.",
+    inputSchema: {
+      hours: exports_external.coerce.number().optional(),
+      project_id: exports_external.string().optional(),
+      top_n: exports_external.coerce.number().optional()
+    }
+  }, async (args) => {
+    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("get_session_activity", {
+    description: "Get activity metrics for a session: message velocity, unique agents, reply ratio, reaction count, trending status.",
+    inputSchema: {
+      session_id: exports_external.string()
+    }
+  }, async (args) => {
+    const activity = getSessionActivity(args.session_id);
+    if (!activity) {
+      return { content: [{ type: "text", text: `session "${args.session_id}" not found` }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(activity) }] };
+  });
+  server.registerTool("hot_sessions", {
+    description: "List conversations ranked by activity hotness (message velocity, reactions, replies, priority, blockers).",
+    inputSchema: {
+      limit: exports_external.coerce.number().optional(),
+      min_score: exports_external.coerce.number().optional(),
+      space: exports_external.string().optional(),
+      project_id: exports_external.string().optional()
+    }
+  }, async (args) => {
+    const sessions = listHotSessions({
+      limit: args.limit,
+      min_score: args.min_score,
+      space: args.space,
+      project_id: args.project_id
+    });
+    return { content: [{ type: "text", text: JSON.stringify(sessions) }] };
+  });
+  server.registerTool("add_reaction", {
+    description: "Add an emoji reaction to a message.",
+    inputSchema: {
+      message_id: exports_external.coerce.number(),
+      emoji: exports_external.string(),
+      from: exports_external.string().optional()
+    }
+  }, async (args) => {
+    const { message_id, emoji: emoji3, from: fromParam } = args;
+    const agent = resolveIdentity(fromParam);
+    const reaction = addReaction(message_id, agent, emoji3);
+    return { content: [{ type: "text", text: JSON.stringify(reaction) }] };
+  });
+  server.registerTool("remove_reaction", {
+    description: "Remove an emoji reaction from a message.",
+    inputSchema: {
+      message_id: exports_external.coerce.number(),
+      emoji: exports_external.string(),
+      from: exports_external.string().optional()
+    }
+  }, async (args) => {
+    const { message_id, emoji: emoji3, from: fromParam } = args;
+    const agent = resolveIdentity(fromParam);
+    const removed = removeReaction(message_id, agent, emoji3);
+    return { content: [{ type: "text", text: JSON.stringify({ removed }) }] };
+  });
+  server.registerTool("get_reactions", {
+    description: "Get all reactions for a message.",
+    inputSchema: {
+      message_id: exports_external.coerce.number()
+    }
+  }, async (args) => {
+    const reactions = getReactions(args.message_id);
+    return { content: [{ type: "text", text: JSON.stringify(reactions) }] };
+  });
+  server.registerTool("get_reaction_summary", {
+    description: "Get emoji reaction counts and agent lists for a message.",
+    inputSchema: {
+      message_id: exports_external.coerce.number()
+    }
+  }, async (args) => {
+    const summary = getReactionSummary(args.message_id);
+    return { content: [{ type: "text", text: JSON.stringify(summary) }] };
+  });
+  server.registerTool("acquire_lock", {
+    description: "Acquire an advisory or exclusive lock on a resource. Returns conflict info if another agent holds the lock.",
+    inputSchema: {
+      resource_type: exports_external.string(),
+      resource_id: exports_external.string(),
+      lock_type: exports_external.enum(["advisory", "exclusive"]).optional(),
+      expiry_ms: exports_external.coerce.number().optional(),
+      from: exports_external.string().optional()
+    }
+  }, async (args) => {
+    const { resource_type, resource_id, lock_type, expiry_ms, from: fromParam } = args;
+    const agent = resolveIdentity(fromParam);
+    const result = acquireLock(resource_type, resource_id, agent, lock_type ?? "advisory", expiry_ms);
+    return { content: [{ type: "text", text: JSON.stringify(result) }] };
+  });
+  server.registerTool("release_lock", {
+    description: "Release a lock held by the agent on a resource.",
+    inputSchema: {
+      resource_type: exports_external.string(),
+      resource_id: exports_external.string(),
+      from: exports_external.string().optional()
+    }
+  }, async (args) => {
+    const { resource_type, resource_id, from: fromParam } = args;
+    const agent = resolveIdentity(fromParam);
+    const released = releaseLock(resource_type, resource_id, agent);
+    return { content: [{ type: "text", text: JSON.stringify({ released }) }] };
+  });
+  server.registerTool("check_lock", {
+    description: "Check if a resource is currently locked and who holds it.",
+    inputSchema: {
+      resource_type: exports_external.string(),
+      resource_id: exports_external.string()
+    }
+  }, async (args) => {
+    const lock = checkLock(args.resource_type, args.resource_id);
+    return { content: [{ type: "text", text: JSON.stringify(lock ?? { locked: false }) }] };
+  });
+  server.registerTool("list_locks", {
+    description: "List all active (non-expired) locks. Filter by resource_type or agent.",
+    inputSchema: {
+      resource_type: exports_external.string().optional(),
+      agent_id: exports_external.string().optional()
+    }
+  }, async (args) => {
+    const locks = listLocks({ resource_type: args.resource_type, agent_id: args.agent_id });
+    return { content: [{ type: "text", text: JSON.stringify(locks) }] };
+  });
+  server.registerTool("get_thread_replies", {
+    description: "Get all replies in a thread for a given parent message ID.",
+    inputSchema: {
+      message_id: exports_external.coerce.number()
+    }
+  }, async (args) => {
+    const replies = getThreadReplies(args.message_id);
+    return { content: [{ type: "text", text: JSON.stringify(replies) }] };
+  });
   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.",
     inputSchema: {
@@ -33437,6 +34307,24 @@ var init_mcp2 = __esm(() => {
       "pin_message",
       "unpin_message",
       "get_pinned_messages",
+      "build_graph",
+      "get_related",
+      "get_agent_network",
+      "graph_stats",
+      "get_summary",
+      "get_topics",
+      "trending_topics",
+      "get_session_activity",
+      "hot_sessions",
+      "add_reaction",
+      "remove_reaction",
+      "get_reactions",
+      "get_reaction_summary",
+      "acquire_lock",
+      "release_lock",
+      "check_lock",
+      "list_locks",
+      "get_thread_replies",
       "set_focus",
       "get_focus",
       "unfocus",
@@ -33486,6 +34374,24 @@ var init_mcp2 = __esm(() => {
       pin_message: "Pin a message. Required: id",
       unpin_message: "Unpin a message. Required: id",
       get_pinned_messages: "Get pinned messages. Optional: space?, session_id?, limit?",
+      build_graph: "Build/rebuild knowledge graph from messages, spaces, projects. Returns edge counts.",
+      get_related: "Find entities related to a given entity. Required: entity_type, entity_id",
+      get_agent_network: "Agent's communication network: contacts, spaces, projects. Required: agent",
+      graph_stats: "Knowledge graph stats: total edges, by relation type",
+      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?",
+      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?",
+      remove_reaction: "Remove emoji reaction from a message. Required: message_id, emoji. Optional: from?",
+      get_reactions: "Get all reactions for a message. Required: message_id",
+      get_reaction_summary: "Get emoji counts + agent lists for a message. Required: message_id",
+      acquire_lock: "Acquire advisory/exclusive lock on a resource. Required: resource_type, resource_id. Optional: lock_type?(advisory|exclusive), expiry_ms?, from?",
+      release_lock: "Release lock held by agent. Required: resource_type, resource_id. Optional: from?",
+      check_lock: "Check if resource is locked and who holds it. Required: resource_type, resource_id",
+      list_locks: "List active locks. Optional: resource_type?, agent_id?",
+      get_thread_replies: "Get all replies in a thread. 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?",
@@ -33944,6 +34850,43 @@ function startDashboardServer(port = 0, host) {
         const agents = listAgents({ online_only: onlineOnly });
         return jsonResponse(applyFields(agents, url2.searchParams.get("fields")));
       }
+      if (path === "/api/sessions/hot" && req.method === "GET") {
+        const limit = url2.searchParams.get("limit") ? parseInt(url2.searchParams.get("limit")) : undefined;
+        const min_score = url2.searchParams.get("min_score") ? parseInt(url2.searchParams.get("min_score")) : undefined;
+        const space = url2.searchParams.get("space") ?? undefined;
+        const project_id = url2.searchParams.get("project_id") ?? undefined;
+        const sessions = listHotSessions({ limit, min_score, space, project_id });
+        return jsonResponse(sessions);
+      }
+      if (path === "/api/graph" && req.method === "GET") {
+        const entityType = url2.searchParams.get("entity_type");
+        const entityId = url2.searchParams.get("entity_id");
+        if (entityType && entityId) {
+          return jsonResponse(getRelated(entityType, entityId));
+        }
+        return jsonResponse(getGraphStats());
+      }
+      const agentNetMatch = path.match(/^\/api\/graph\/agent\/(.+)$/);
+      if (agentNetMatch && req.method === "GET") {
+        return jsonResponse(getAgentNetwork(decodeURIComponent(agentNetMatch[1])));
+      }
+      if (path === "/api/reactions" && req.method === "GET") {
+        const messageIdStr = url2.searchParams.get("message_id");
+        if (!messageIdStr)
+          return jsonResponse({ error: "message_id required" }, 400);
+        const messageId = parseInt(messageIdStr);
+        if (isNaN(messageId))
+          return jsonResponse({ error: "message_id must be a number" }, 400);
+        const summary = url2.searchParams.get("summary") === "true";
+        const result = summary ? getReactionSummary(messageId) : getReactions(messageId);
+        return jsonResponse(result);
+      }
+      if (path === "/api/locks" && req.method === "GET") {
+        const resource_type = url2.searchParams.get("resource_type") ?? undefined;
+        const agent_id = url2.searchParams.get("agent_id") ?? undefined;
+        const locks = listLocks({ resource_type, agent_id });
+        return jsonResponse(locks);
+      }
       if (path === "/api/version" && req.method === "GET") {
         try {
           const pkg2 = await Promise.resolve().then(() => __toESM(require_package(), 1));
@@ -34024,6 +34967,10 @@ var init_serve = __esm(() => {
   init_projects();
   init_db();
   init_presence();
+  init_reactions();
+  init_hot();
+  init_graph();
+  init_locks();
   isDirectRun2 = import.meta.url === `file://${process.argv[1]}` || process.argv[1]?.endsWith("serve.ts") || process.argv[1]?.endsWith("serve.js");
   if (isDirectRun2) {
     const port = normalizePort(process.env.PORT, 0);
@@ -34055,6 +35002,11 @@ init_projects();
 init_db();
 init_identity();
 init_presence();
+init_reactions();
+init_hot();
+init_topics();
+init_summary();
+init_graph();
 init_terminal_markdown();
 import chalk3 from "chalk";
 import { render } from "ink";
@@ -35120,6 +36072,223 @@ program2.command("search").description("Search messages by content").argument("<
   }
   closeDb();
 });
+program2.command("since").description("Show all activity (DMs + spaces) since a duration ago").argument("<duration>", "Duration: e.g. 30m, 2h, 1d").option("--json", "Output as JSON").action((duration3, opts) => {
+  const match = duration3.match(/^(\d+)([mhd])$/);
+  if (!match) {
+    console.error(chalk3.red(`Invalid duration "${duration3}". Use format: 30m, 2h, 1d`));
+    process.exit(1);
+  }
+  const value = parseInt(match[1]);
+  const unit = match[2];
+  const msMap = { m: 60000, h: 3600000, d: 86400000 };
+  const since = new Date(Date.now() - value * msMap[unit]).toISOString().replace("T", "T").slice(0, 23);
+  const messages = readMessages({ since, order: "asc", limit: 200 });
+  if (opts.json) {
+    console.log(JSON.stringify(messages, null, 2));
+  } else {
+    if (messages.length === 0) {
+      console.log(chalk3.dim(`No activity in the last ${duration3}.`));
+    } else {
+      console.log(chalk3.bold(`Activity since ${duration3} ago (${messages.length} message(s)):
+`));
+      for (const msg of messages) {
+        const time3 = chalk3.dim(msg.created_at.slice(11, 19));
+        const from = chalk3.cyan(msg.from_agent);
+        const where = msg.space ? chalk3.magenta(`#${msg.space}`) : chalk3.yellow(`\u2192 ${msg.to_agent}`);
+        const priority = msg.priority !== "normal" ? chalk3.red(` [${msg.priority}]`) : "";
+        const unread = !msg.read_at ? chalk3.green(" \u2022") : "";
+        const content = renderContent(msg.content);
+        console.log(`${time3} ${from} ${where}${priority}${unread}`);
+        console.log(`       ${content}
+`);
+      }
+    }
+  }
+  closeDb();
+});
+var graph = program2.command("graph").description("Knowledge graph operations");
+graph.command("build").description("Build/rebuild knowledge graph from messages, spaces, projects").option("--json", "Output as JSON").action((opts) => {
+  const result = buildGraph();
+  if (opts.json) {
+    console.log(JSON.stringify(result, null, 2));
+  } else {
+    console.log(chalk3.green(`Graph built: ${result.edges_created} created, ${result.edges_updated} updated`));
+  }
+  closeDb();
+});
+graph.command("stats").description("Show knowledge graph statistics").option("--json", "Output as JSON").action((opts) => {
+  const stats = getGraphStats();
+  if (opts.json) {
+    console.log(JSON.stringify(stats, null, 2));
+  } else {
+    console.log(chalk3.bold(`Knowledge Graph: ${stats.total_edges} edges
+`));
+    for (const [relation, count] of Object.entries(stats.by_relation)) {
+      console.log(`  ${chalk3.cyan(relation.padEnd(20))} ${count}`);
+    }
+  }
+  closeDb();
+});
+graph.command("agent").description("Show an agent's communication network").argument("<name>", "Agent name").option("--json", "Output as JSON").action((name, opts) => {
+  const network = getAgentNetwork(name);
+  if (opts.json) {
+    console.log(JSON.stringify(network, null, 2));
+  } else {
+    console.log(chalk3.bold(`Network for ${chalk3.cyan(name)}
+`));
+    if (network.communicates_with.length > 0) {
+      console.log(chalk3.bold("  Communicates with:"));
+      for (const c of network.communicates_with) {
+        console.log(`    ${chalk3.cyan(c.agent.padEnd(20))} ${chalk3.dim(`${c.message_count} msgs`)}`);
+      }
+    }
+    if (network.spaces.length > 0) {
+      console.log(chalk3.bold("  Active spaces:"));
+      for (const s of network.spaces) {
+        console.log(`    ${chalk3.magenta("#" + s.space.padEnd(19))} ${chalk3.dim(`${s.message_count} msgs`)}`);
+      }
+    }
+    if (network.projects.length > 0) {
+      console.log(chalk3.bold("  Projects:") + " " + network.projects.join(", "));
+    }
+  }
+  closeDb();
+});
+program2.command("summary").description("Get a structured summary of a conversation").argument("<target>", "Session ID or space name").option("--json", "Output as JSON").action((target, opts) => {
+  const summary = getConversationSummary(target);
+  if (!summary) {
+    console.error(chalk3.red(`No messages found for "${target}"`));
+    process.exit(1);
+  }
+  if (opts.json) {
+    console.log(JSON.stringify(summary, null, 2));
+  } else {
+    console.log(chalk3.bold(`Summary: ${target}
+`));
+    console.log(`  ${chalk3.bold("Participants:")} ${summary.participants.join(", ")}`);
+    console.log(`  ${chalk3.bold("Messages:")} ${summary.message_count}`);
+    console.log(`  ${chalk3.bold("Date range:")} ${summary.date_range.first.slice(0, 16)} \u2192 ${summary.date_range.last.slice(0, 16)}`);
+    console.log(`  ${chalk3.bold("Replies:")} ${summary.activity.reply_count}  ${chalk3.bold("Reactions:")} ${summary.activity.reaction_count}`);
+    if (summary.topics.length > 0) {
+      console.log(`
+  ${chalk3.bold("Topics:")} ${summary.topics.slice(0, 5).map((t) => t.topic).join(", ")}`);
+    }
+    if (summary.key_messages.length > 0) {
+      console.log(`
+  ${chalk3.bold("Key messages:")}`);
+      for (const k of summary.key_messages.slice(0, 5)) {
+        console.log(`    [#${k.id}] ${chalk3.cyan(k.from)} (${chalk3.yellow(k.reason)}): ${k.content.slice(0, 80)}`);
+      }
+    }
+    if (summary.unresolved_blockers.length > 0) {
+      console.log(`
+  ${chalk3.red.bold("Unresolved blockers:")}`);
+      for (const b of summary.unresolved_blockers) {
+        console.log(`    ${chalk3.red("[BLOCKER]")} [#${b.id}] ${chalk3.cyan(b.from)}: ${b.content.slice(0, 80)}`);
+      }
+    }
+  }
+  closeDb();
+});
+program2.command("topics").description("Extract topics from a space, session, or trending globally").option("--space <name>", "Topics for a specific space").option("--session <id>", "Topics for a specific session").option("--hours <n>", "Trending topics in last N hours", parseInt).option("--json", "Output as JSON").action((opts) => {
+  let topics;
+  if (opts.space) {
+    topics = getSpaceTopics(opts.space);
+  } else if (opts.session) {
+    topics = getSessionTopics(opts.session);
+  } else {
+    topics = getTrendingTopics({ hours: opts.hours ?? 24 });
+  }
+  if (opts.json) {
+    console.log(JSON.stringify(topics, null, 2));
+  } else {
+    if (topics.length === 0) {
+      console.log(chalk3.dim("No topics found."));
+    } else {
+      const label = opts.space ? `#${opts.space}` : opts.session ? opts.session : `last ${opts.hours ?? 24}h`;
+      console.log(chalk3.bold(`Topics for ${label}
+`));
+      for (const t of topics) {
+        const bar = "\u2588".repeat(Math.min(Math.round(t.weight * 50), 30));
+        console.log(`  ${chalk3.cyan(t.topic.padEnd(20))} ${chalk3.dim(`\xD7${t.count}`)}  ${chalk3.green(bar)}`);
+      }
+    }
+  }
+  closeDb();
+});
+program2.command("hot").description("Show hot conversations ranked by activity").option("--limit <n>", "Max results", parseInt).option("--min-score <n>", "Minimum hotness score", parseInt).option("--space <name>", "Filter by space").option("--json", "Output as JSON").action((opts) => {
+  const sessions = listHotSessions({
+    limit: opts.limit ?? 10,
+    min_score: opts.minScore,
+    space: opts.space
+  });
+  if (opts.json) {
+    console.log(JSON.stringify(sessions, null, 2));
+  } else {
+    if (sessions.length === 0) {
+      console.log(chalk3.dim("No hot conversations."));
+    } else {
+      console.log(chalk3.bold(`Hot Conversations
+`));
+      for (const s of sessions) {
+        const score = s.hotness_score > 20 ? chalk3.red(`\uD83D\uDD25 ${s.hotness_score}`) : chalk3.yellow(`  ${s.hotness_score}`);
+        const where = s.space ? chalk3.magenta(`#${s.space}`) : chalk3.cyan(s.participants.join(", "));
+        const time3 = chalk3.dim(s.last_message_at.slice(11, 16));
+        const msgs = chalk3.dim(`${s.message_count} msgs`);
+        const agents = chalk3.dim(`${s.metrics.unique_agents} agents`);
+        console.log(`${score}  ${where}  ${time3}  ${msgs}  ${agents}`);
+      }
+    }
+  }
+  closeDb();
+});
+program2.command("context").description("One-shot session boot context for agents: online agents, unread DMs, spaces, recent activity").option("--json", "Output as JSON").action((opts) => {
+  const agent = resolveIdentity();
+  heartbeat(agent);
+  const db2 = getDb();
+  const onlineAgents = listAgents({ online_only: true });
+  const unreadDMs = readMessages({ to: agent, unread_only: true, limit: 5 });
+  const mySpaces = db2.prepare(`
+      SELECT s.name, s.description,
+        (SELECT COUNT(*) FROM messages m WHERE m.space = s.name AND m.read_at IS NULL) as unread
+      FROM spaces s
+      JOIN space_members sm ON sm.space = s.name
+      WHERE sm.agent = ?
+      ORDER BY s.name
+    `).all(agent);
+  const recentDMs = readMessages({ to: agent, limit: 3 });
+  const context = { agent, online_agents: onlineAgents, unread_dms: unreadDMs, spaces: mySpaces, recent_dms: recentDMs };
+  if (opts.json) {
+    console.log(JSON.stringify(context, null, 2));
+  } else {
+    console.log(chalk3.bold(`Context for ${chalk3.cyan(agent)}
+`));
+    if (onlineAgents.length > 0) {
+      const names = onlineAgents.map((a) => chalk3.green(a.agent)).join(", ");
+      console.log(`${chalk3.bold("Online agents:")} ${names}`);
+    } else {
+      console.log(`${chalk3.bold("Online agents:")} ${chalk3.dim("none")}`);
+    }
+    if (unreadDMs.length > 0) {
+      console.log(`${chalk3.bold("Unread DMs:")} ${chalk3.yellow(unreadDMs.length + " message(s)")}`);
+      for (const msg of unreadDMs.slice(0, 3)) {
+        console.log(`  ${chalk3.dim(msg.created_at.slice(11, 16))} ${chalk3.cyan(msg.from_agent)}: ${msg.content.slice(0, 80)}`);
+      }
+    } else {
+      console.log(`${chalk3.bold("Unread DMs:")} ${chalk3.dim("none")}`);
+    }
+    if (mySpaces.length > 0) {
+      console.log(`${chalk3.bold("My spaces:")}`);
+      for (const sp of mySpaces) {
+        const unread = sp.unread > 0 ? chalk3.yellow(` (${sp.unread} unread)`) : "";
+        console.log(`  ${chalk3.magenta("#" + sp.name)}${unread}`);
+      }
+    } else {
+      console.log(`${chalk3.bold("My spaces:")} ${chalk3.dim("none")}`);
+    }
+  }
+  closeDb();
+});
 program2.command("sessions").description("List conversation sessions").option("--agent <id>", "Filter sessions involving this agent").option("--json", "Output as JSON").action((opts) => {
   const sessions = listSessions(opts.agent);
   if (opts.json) {
@@ -35234,6 +36403,79 @@ program2.command("status").description("Show database stats").option("--json", "
   }
   closeDb();
 });
+program2.command("doctor").description("Check conversations setup and health").option("--json", "Output as JSON").action(async (opts) => {
+  const checks4 = [];
+  try {
+    const db2 = getDb();
+    db2.prepare("SELECT 1").get();
+    const dbPath = getDbPath();
+    checks4.push({ name: "Database", ok: true, message: `OK \u2014 ${dbPath}` });
+  } catch (e) {
+    checks4.push({ name: "Database", ok: false, message: `Cannot open DB: ${e.message}` });
+  }
+  try {
+    const db2 = getDb();
+    const mode = db2.prepare("PRAGMA journal_mode").get();
+    const isWal = mode.journal_mode === "wal";
+    checks4.push({ name: "WAL mode", ok: isWal, message: isWal ? "OK \u2014 WAL mode enabled" : `WARNING \u2014 journal_mode is ${mode.journal_mode}` });
+  } catch {
+    checks4.push({ name: "WAL mode", ok: false, message: "Could not check WAL mode" });
+  }
+  try {
+    const proc = Bun.spawn(["which", "conversations-mcp"], { stdout: "pipe", stderr: "pipe" });
+    const exit = await proc.exited;
+    const path = await new Response(proc.stdout).text();
+    checks4.push({ name: "MCP binary", ok: exit === 0, message: exit === 0 ? `OK \u2014 ${path.trim()}` : "conversations-mcp not found in PATH \u2014 run: bun install -g @hasna/conversations" });
+  } catch {
+    checks4.push({ name: "MCP binary", ok: false, message: "Could not check MCP binary" });
+  }
+  try {
+    const current = import__package2.default.version;
+    const res = await fetch("https://registry.npmjs.org/@hasna/conversations/latest");
+    const data = await res.json();
+    const latest = data.version;
+    const upToDate = current === latest;
+    checks4.push({ name: "npm version", ok: upToDate, message: upToDate ? `OK \u2014 v${current} (latest)` : `Update available: v${current} \u2192 v${latest} \u2014 run: bun install -g @hasna/conversations@latest` });
+  } catch {
+    checks4.push({ name: "npm version", ok: true, message: "Could not check npm registry (offline?)" });
+  }
+  const { homedir: homedir5 } = await import("os");
+  const { existsSync: existsSync2 } = await import("fs");
+  const { join: join6 } = await import("path");
+  const configPath = process.env.CONVERSATIONS_CONFIG_PATH ?? join6(homedir5(), ".conversations", "config.json");
+  if (existsSync2(configPath)) {
+    try {
+      const { readFileSync: readFileSync3 } = await import("fs");
+      JSON.parse(readFileSync3(configPath, "utf8"));
+      checks4.push({ name: "Webhook config", ok: true, message: `OK \u2014 ${configPath}` });
+    } catch (e) {
+      checks4.push({ name: "Webhook config", ok: false, message: `Invalid JSON at ${configPath}: ${e.message}` });
+    }
+  } else {
+    checks4.push({ name: "Webhook config", ok: true, message: "No webhook config (optional)" });
+  }
+  closeDb();
+  const allOk = checks4.every((c) => c.ok);
+  if (opts.json) {
+    console.log(JSON.stringify({ ok: allOk, checks: checks4 }, null, 2));
+  } else {
+    console.log(chalk3.bold(`Conversations Doctor
+`));
+    for (const check2 of checks4) {
+      const icon = check2.ok ? chalk3.green("\u2713") : chalk3.red("\u2717");
+      const label = chalk3.bold(check2.name.padEnd(16));
+      console.log(`  ${icon}  ${label}  ${check2.message}`);
+    }
+    console.log();
+    if (allOk) {
+      console.log(chalk3.green("All checks passed."));
+    } else {
+      const failed = checks4.filter((c) => !c.ok).length;
+      console.log(chalk3.red(`${failed} check(s) failed.`));
+      process.exit(1);
+    }
+  }
+});
 program2.command("update").description("Check for and install updates").option("--check", "Only check for updates, don't install").option("--json", "Output as JSON").action(async (opts) => {
   const pkg3 = await Promise.resolve().then(() => __toESM(require_package(), 1));
   const current = pkg3.version;
@@ -35760,6 +37002,64 @@ program2.command("unpin").description("Unpin a message").argument("<id>", "Messa
   }
   closeDb();
 });
+program2.command("pinned").description("List pinned messages").option("--space <name>", "Filter by space").option("--session <id>", "Filter by session ID").option("--limit <n>", "Max results", parseInt).option("--json", "Output as JSON").action((opts) => {
+  const messages = getPinnedMessages({ space: opts.space, session_id: opts.session, limit: opts.limit });
+  if (opts.json) {
+    console.log(JSON.stringify(messages, null, 2));
+  } else {
+    if (messages.length === 0) {
+      console.log(chalk3.dim("No pinned messages."));
+    } else {
+      console.log(chalk3.dim(`${messages.length} pinned message(s):
+`));
+      for (const msg of messages) {
+        const time3 = chalk3.dim(msg.created_at.slice(11, 19));
+        const from = chalk3.cyan(msg.from_agent);
+        const where = msg.space ? chalk3.magenta(`#${msg.space}`) : chalk3.yellow(msg.to_agent);
+        console.log(`${chalk3.yellow("\uD83D\uDCCC")} [#${msg.id}] ${time3} ${from} \u2192 ${where}: ${msg.content}`);
+      }
+    }
+  }
+  closeDb();
+});
+program2.command("react").description("Add an emoji reaction to a message").argument("<id>", "Message ID", parseInt).argument("<emoji>", "Emoji to react with").option("--from <agent>", "Agent identity override").option("--json", "Output as JSON").action((id, emoji3, opts) => {
+  const agent = resolveIdentity(opts.from);
+  const reaction = addReaction(id, agent, emoji3);
+  if (opts.json) {
+    console.log(JSON.stringify(reaction, null, 2));
+  } else {
+    console.log(chalk3.green(`${emoji3} reaction added to message #${id}`));
+  }
+  closeDb();
+});
+program2.command("unreact").description("Remove an emoji reaction from a message").argument("<id>", "Message ID", parseInt).argument("<emoji>", "Emoji to remove").option("--from <agent>", "Agent identity override").option("--json", "Output as JSON").action((id, emoji3, opts) => {
+  const agent = resolveIdentity(opts.from);
+  const removed = removeReaction(id, agent, emoji3);
+  if (opts.json) {
+    console.log(JSON.stringify({ removed }, null, 2));
+  } else {
+    if (removed) {
+      console.log(chalk3.green(`${emoji3} reaction removed from message #${id}`));
+    } else {
+      console.log(chalk3.dim(`No ${emoji3} reaction found on message #${id}`));
+    }
+  }
+  closeDb();
+});
+program2.command("reactions").description("Show emoji reactions on a message").argument("<id>", "Message ID", parseInt).option("--json", "Output as JSON").action((id, opts) => {
+  const summary = getReactionSummary(id);
+  if (opts.json) {
+    console.log(JSON.stringify(summary, null, 2));
+  } else {
+    if (summary.length === 0) {
+      console.log(chalk3.dim(`No reactions on message #${id}`));
+    } else {
+      const parts = summary.map((r) => `${r.emoji} ${r.count}`).join("  ");
+      console.log(`Message #${id}: ${parts}`);
+    }
+  }
+  closeDb();
+});
 var agents = program2.command("agents").description("Manage agents");
 agents.command("list").description("List all agents with their presence status").option("--online", "Only show online agents").option("--json", "Output as JSON").action((opts) => {
   const agent = resolveIdentity();