@hasna/conversations 0.1.5 → 0.1.6

package/bin/mcp.js

@@ -4,6 +4,7 @@ var __create = Object.create;
 var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __toESM = (mod, isNodeMode, target) => {
   target = mod != null ? __create(__getProtoOf(mod)) : {};
@@ -16,6 +17,20 @@ var __toESM = (mod, isNodeMode, target) => {
       });
   return to;
 };
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
 var __export = (target, all) => {
   for (var name in all)
@@ -26,6 +41,7 @@ var __export = (target, all) => {
       set: (newValue) => all[name] = () => newValue
     });
 };
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 
 // node_modules/ajv/dist/compile/codegen/code.js
 var require_code = __commonJS((exports) => {
@@ -6499,6 +6515,165 @@ var require_dist = __commonJS((exports, module) => {
   exports.default = formatsPlugin;
 });
 
+// src/lib/db.ts
+var exports_db = {};
+__export(exports_db, {
+  getDbPath: () => getDbPath,
+  getDb: () => getDb,
+  closeDb: () => closeDb
+});
+import { Database } from "bun:sqlite";
+import { mkdirSync } from "fs";
+import { join, dirname } from "path";
+import { homedir } from "os";
+function getDbPath() {
+  if (process.env.CONVERSATIONS_DB_PATH)
+    return process.env.CONVERSATIONS_DB_PATH;
+  return join(homedir(), ".conversations", "messages.db");
+}
+function getDb() {
+  if (db)
+    return db;
+  const dbPath = getDbPath();
+  mkdirSync(dirname(dbPath), { recursive: true });
+  db = new Database(dbPath, { create: true });
+  db.exec("PRAGMA journal_mode = WAL");
+  db.exec("PRAGMA busy_timeout = 5000");
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS messages (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      session_id TEXT NOT NULL,
+      from_agent TEXT NOT NULL,
+      to_agent TEXT NOT NULL,
+      space TEXT,
+      content TEXT NOT NULL,
+      priority TEXT NOT NULL DEFAULT 'normal',
+      working_dir TEXT,
+      repository TEXT,
+      branch TEXT,
+      metadata TEXT,
+      created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
+      read_at TEXT
+    )
+  `);
+  db.exec("CREATE INDEX IF NOT EXISTS idx_messages_session ON messages(session_id)");
+  db.exec("CREATE INDEX IF NOT EXISTS idx_messages_to ON messages(to_agent)");
+  db.exec("CREATE INDEX IF NOT EXISTS idx_messages_created ON messages(created_at)");
+  db.exec("CREATE INDEX IF NOT EXISTS idx_messages_space ON messages(space)");
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS projects (
+      id TEXT PRIMARY KEY,
+      name TEXT NOT NULL UNIQUE,
+      description TEXT,
+      path TEXT,
+      created_by TEXT NOT NULL,
+      created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
+      metadata TEXT,
+      tags TEXT,
+      status TEXT NOT NULL DEFAULT 'active',
+      repository TEXT,
+      settings TEXT
+    )
+  `);
+  db.exec("CREATE INDEX IF NOT EXISTS idx_projects_name ON projects(name)");
+  db.exec("CREATE INDEX IF NOT EXISTS idx_projects_status ON projects(status)");
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS spaces (
+      name TEXT PRIMARY KEY,
+      description TEXT,
+      parent_id TEXT REFERENCES spaces(name),
+      project_id TEXT REFERENCES projects(id),
+      created_by TEXT NOT NULL,
+      created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
+      archived_at TEXT
+    )
+  `);
+  db.exec("CREATE INDEX IF NOT EXISTS idx_spaces_parent ON spaces(parent_id)");
+  db.exec("CREATE INDEX IF NOT EXISTS idx_spaces_project ON spaces(project_id)");
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS space_members (
+      space TEXT NOT NULL REFERENCES spaces(name),
+      agent TEXT NOT NULL,
+      joined_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
+      PRIMARY KEY (space, agent)
+    )
+  `);
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS agent_presence (
+      agent TEXT PRIMARY KEY,
+      status TEXT NOT NULL DEFAULT 'online',
+      last_seen_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
+      metadata TEXT
+    )
+  `);
+  const existingTables = db.prepare("SELECT name FROM sqlite_master WHERE type='table'").all();
+  const tableNames = existingTables.map((t) => t.name);
+  if (tableNames.includes("channels") && tableNames.includes("spaces")) {
+    const spaceCount = db.prepare("SELECT COUNT(*) as c FROM spaces").get().c;
+    const channelCount = db.prepare("SELECT COUNT(*) as c FROM channels").get().c;
+    if (channelCount > 0 && spaceCount === 0) {
+      db.exec("BEGIN");
+      try {
+        db.exec(`
+          INSERT OR IGNORE INTO spaces (name, description, created_by, created_at)
+          SELECT name, description, created_by, created_at FROM channels
+        `);
+        if (tableNames.includes("channel_members")) {
+          db.exec(`
+            INSERT OR IGNORE INTO space_members (space, agent, joined_at)
+            SELECT channel, agent, joined_at FROM channel_members
+          `);
+        }
+        db.exec("COMMIT");
+      } catch (e) {
+        db.exec("ROLLBACK");
+        throw e;
+      }
+    }
+    db.exec("DROP TABLE IF EXISTS channel_members");
+    db.exec("DROP TABLE IF EXISTS channels");
+  }
+  const msgCols = db.prepare("PRAGMA table_info(messages)").all();
+  const colNames = msgCols.map((c) => c.name);
+  if (colNames.includes("channel") && !colNames.includes("space")) {
+    db.exec("ALTER TABLE messages ADD COLUMN space TEXT");
+    db.exec("CREATE INDEX IF NOT EXISTS idx_messages_space ON messages(space)");
+    db.exec("UPDATE messages SET space = channel WHERE channel IS NOT NULL");
+    db.exec(`
+      UPDATE messages
+      SET session_id = 'space:' || substr(session_id, 9)
+      WHERE session_id LIKE 'channel:%'
+    `);
+  }
+  const spaceCols = db.prepare("PRAGMA table_info(spaces)").all();
+  const spaceColNames = spaceCols.map((c) => c.name);
+  if (!spaceColNames.includes("archived_at")) {
+    db.exec("ALTER TABLE spaces ADD COLUMN archived_at TEXT");
+  }
+  const msgCols2 = db.prepare("PRAGMA table_info(messages)").all();
+  const colNames2 = msgCols2.map((c) => c.name);
+  if (!colNames2.includes("edited_at")) {
+    db.exec("ALTER TABLE messages ADD COLUMN edited_at TEXT");
+  }
+  if (!colNames2.includes("pinned_at")) {
+    db.exec("ALTER TABLE messages ADD COLUMN pinned_at TEXT");
+    db.exec("CREATE INDEX IF NOT EXISTS idx_messages_pinned ON messages(pinned_at)");
+  }
+  if (!colNames2.includes("blocking")) {
+    db.exec("ALTER TABLE messages ADD COLUMN blocking INTEGER NOT NULL DEFAULT 0");
+    db.exec("CREATE INDEX IF NOT EXISTS idx_messages_blocking ON messages(blocking)");
+  }
+  return db;
+}
+function closeDb() {
+  if (db) {
+    db.close();
+    db = null;
+  }
+}
+var db = null;
+var init_db = () => {};
+
 // node_modules/zod/v3/helpers/util.js
 var util;
 (function(util2) {
@@ -28316,149 +28491,8 @@ class StdioServerTransport {
   }
 }
 
-// src/lib/db.ts
-import { Database } from "bun:sqlite";
-import { mkdirSync } from "fs";
-import { join, dirname } from "path";
-import { homedir } from "os";
-var db = null;
-function getDbPath() {
-  if (process.env.CONVERSATIONS_DB_PATH)
-    return process.env.CONVERSATIONS_DB_PATH;
-  return join(homedir(), ".conversations", "messages.db");
-}
-function getDb() {
-  if (db)
-    return db;
-  const dbPath = getDbPath();
-  mkdirSync(dirname(dbPath), { recursive: true });
-  db = new Database(dbPath, { create: true });
-  db.exec("PRAGMA journal_mode = WAL");
-  db.exec("PRAGMA busy_timeout = 5000");
-  db.exec(`
-    CREATE TABLE IF NOT EXISTS messages (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      session_id TEXT NOT NULL,
-      from_agent TEXT NOT NULL,
-      to_agent TEXT NOT NULL,
-      space TEXT,
-      content TEXT NOT NULL,
-      priority TEXT NOT NULL DEFAULT 'normal',
-      working_dir TEXT,
-      repository TEXT,
-      branch TEXT,
-      metadata TEXT,
-      created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
-      read_at TEXT
-    )
-  `);
-  db.exec("CREATE INDEX IF NOT EXISTS idx_messages_session ON messages(session_id)");
-  db.exec("CREATE INDEX IF NOT EXISTS idx_messages_to ON messages(to_agent)");
-  db.exec("CREATE INDEX IF NOT EXISTS idx_messages_created ON messages(created_at)");
-  db.exec("CREATE INDEX IF NOT EXISTS idx_messages_space ON messages(space)");
-  db.exec(`
-    CREATE TABLE IF NOT EXISTS projects (
-      id TEXT PRIMARY KEY,
-      name TEXT NOT NULL UNIQUE,
-      description TEXT,
-      path TEXT,
-      created_by TEXT NOT NULL,
-      created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
-      metadata TEXT,
-      tags TEXT,
-      status TEXT NOT NULL DEFAULT 'active',
-      repository TEXT,
-      settings TEXT
-    )
-  `);
-  db.exec("CREATE INDEX IF NOT EXISTS idx_projects_name ON projects(name)");
-  db.exec("CREATE INDEX IF NOT EXISTS idx_projects_status ON projects(status)");
-  db.exec(`
-    CREATE TABLE IF NOT EXISTS spaces (
-      name TEXT PRIMARY KEY,
-      description TEXT,
-      parent_id TEXT REFERENCES spaces(name),
-      project_id TEXT REFERENCES projects(id),
-      created_by TEXT NOT NULL,
-      created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
-      archived_at TEXT
-    )
-  `);
-  db.exec("CREATE INDEX IF NOT EXISTS idx_spaces_parent ON spaces(parent_id)");
-  db.exec("CREATE INDEX IF NOT EXISTS idx_spaces_project ON spaces(project_id)");
-  db.exec(`
-    CREATE TABLE IF NOT EXISTS space_members (
-      space TEXT NOT NULL REFERENCES spaces(name),
-      agent TEXT NOT NULL,
-      joined_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
-      PRIMARY KEY (space, agent)
-    )
-  `);
-  db.exec(`
-    CREATE TABLE IF NOT EXISTS agent_presence (
-      agent TEXT PRIMARY KEY,
-      status TEXT NOT NULL DEFAULT 'online',
-      last_seen_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
-      metadata TEXT
-    )
-  `);
-  const existingTables = db.prepare("SELECT name FROM sqlite_master WHERE type='table'").all();
-  const tableNames = existingTables.map((t) => t.name);
-  if (tableNames.includes("channels") && tableNames.includes("spaces")) {
-    const spaceCount = db.prepare("SELECT COUNT(*) as c FROM spaces").get().c;
-    const channelCount = db.prepare("SELECT COUNT(*) as c FROM channels").get().c;
-    if (channelCount > 0 && spaceCount === 0) {
-      db.exec("BEGIN");
-      try {
-        db.exec(`
-          INSERT OR IGNORE INTO spaces (name, description, created_by, created_at)
-          SELECT name, description, created_by, created_at FROM channels
-        `);
-        if (tableNames.includes("channel_members")) {
-          db.exec(`
-            INSERT OR IGNORE INTO space_members (space, agent, joined_at)
-            SELECT channel, agent, joined_at FROM channel_members
-          `);
-        }
-        db.exec("COMMIT");
-      } catch (e) {
-        db.exec("ROLLBACK");
-        throw e;
-      }
-    }
-    db.exec("DROP TABLE IF EXISTS channel_members");
-    db.exec("DROP TABLE IF EXISTS channels");
-  }
-  const msgCols = db.prepare("PRAGMA table_info(messages)").all();
-  const colNames = msgCols.map((c) => c.name);
-  if (colNames.includes("channel") && !colNames.includes("space")) {
-    db.exec("ALTER TABLE messages ADD COLUMN space TEXT");
-    db.exec("CREATE INDEX IF NOT EXISTS idx_messages_space ON messages(space)");
-    db.exec("UPDATE messages SET space = channel WHERE channel IS NOT NULL");
-    db.exec(`
-      UPDATE messages
-      SET session_id = 'space:' || substr(session_id, 9)
-      WHERE session_id LIKE 'channel:%'
-    `);
-  }
-  const spaceCols = db.prepare("PRAGMA table_info(spaces)").all();
-  const spaceColNames = spaceCols.map((c) => c.name);
-  if (!spaceColNames.includes("archived_at")) {
-    db.exec("ALTER TABLE spaces ADD COLUMN archived_at TEXT");
-  }
-  const msgCols2 = db.prepare("PRAGMA table_info(messages)").all();
-  const colNames2 = msgCols2.map((c) => c.name);
-  if (!colNames2.includes("edited_at")) {
-    db.exec("ALTER TABLE messages ADD COLUMN edited_at TEXT");
-  }
-  if (!colNames2.includes("pinned_at")) {
-    db.exec("ALTER TABLE messages ADD COLUMN pinned_at TEXT");
-    db.exec("CREATE INDEX IF NOT EXISTS idx_messages_pinned ON messages(pinned_at)");
-  }
-  return db;
-}
-
 // src/lib/messages.ts
+init_db();
 import { randomUUID } from "crypto";
 function parseMessage(row) {
   let metadata = null;
@@ -28471,7 +28505,8 @@ function parseMessage(row) {
   }
   return {
     ...row,
-    metadata
+    metadata,
+    blocking: !!row.blocking
   };
 }
 function sendMessage(opts) {
@@ -28480,12 +28515,13 @@ function sendMessage(opts) {
   const sessionId = explicitSession ?? (opts.space ? `space:${opts.space}` : `${[opts.from, opts.to].sort().join("-")}-${randomUUID().slice(0, 8)}`);
   const metadata = opts.metadata ? JSON.stringify(opts.metadata) : null;
   const normalizedPriority = opts.priority === "low" || opts.priority === "normal" || opts.priority === "high" || opts.priority === "urgent" ? opts.priority : "normal";
+  const blocking = opts.blocking ? 1 : 0;
   const stmt = db2.prepare(`
-    INSERT INTO messages (session_id, from_agent, to_agent, space, content, priority, working_dir, repository, branch, metadata)
-    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    INSERT INTO messages (session_id, from_agent, to_agent, space, content, priority, working_dir, repository, branch, metadata, blocking)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
     RETURNING *
   `);
-  const row = stmt.get(sessionId, opts.from, opts.to, opts.space || null, opts.content, normalizedPriority, opts.working_dir || null, opts.repository || null, opts.branch || null, metadata);
+  const row = stmt.get(sessionId, opts.from, opts.to, opts.space || null, opts.content, normalizedPriority, opts.working_dir || null, opts.repository || null, opts.branch || null, metadata, blocking);
   return parseMessage(row);
 }
 function readMessages(opts = {}) {
@@ -28642,6 +28678,19 @@ function getPinnedMessages(opts) {
   const rows = db2.prepare(`SELECT * FROM messages ${where} ORDER BY pinned_at DESC, id DESC ${limit}`).all(...params);
   return rows.map(parseMessage);
 }
+function getUnreadBlockers(agent) {
+  const db2 = getDb();
+  const rows = db2.prepare(`
+    SELECT * FROM messages
+    WHERE blocking = 1 AND read_at IS NULL
+    AND (
+      to_agent = ?
+      OR space IN (SELECT space FROM space_members WHERE agent = ?)
+    )
+    ORDER BY created_at ASC, id ASC
+  `).all(agent, agent);
+  return rows.map(parseMessage);
+}
 function searchMessages(opts) {
   const db2 = getDb();
   const conditions = ["content LIKE ?"];
@@ -28665,6 +28714,7 @@ function searchMessages(opts) {
 }
 
 // src/lib/sessions.ts
+init_db();
 function listSessions(agent) {
   const db2 = getDb();
   const agentFilter = agent ? "WHERE from_agent = ? OR to_agent = ?" : "";
@@ -28695,6 +28745,7 @@ function listSessions(agent) {
 }
 
 // src/lib/spaces.ts
+init_db();
 function getSpaceDepth(spaceName) {
   const db2 = getDb();
   let depth = 0;
@@ -28868,6 +28919,7 @@ function unarchiveSpace(name) {
 }
 
 // src/lib/projects.ts
+init_db();
 import { randomUUID as randomUUID2 } from "crypto";
 function parseProject(row) {
   let metadata = null;
@@ -29389,6 +29441,16 @@ var AGENT_NAMES = [
 // src/lib/identity.ts
 var AGENT_ID_FILE = join2(homedir2(), ".conversations", "agent-id");
 var cachedAutoName = null;
+function isNameTaken(name) {
+  try {
+    const { getDb: getDb2 } = (init_db(), __toCommonJS(exports_db));
+    const db2 = getDb2();
+    const row = db2.prepare("SELECT agent FROM agent_presence WHERE agent = ?").get(name);
+    return !!row;
+  } catch {
+    return false;
+  }
+}
 function getAutoName() {
   if (cachedAutoName)
     return cachedAutoName;
@@ -29399,7 +29461,14 @@ function getAutoName() {
       return name2;
     }
   } catch {}
-  const name = AGENT_NAMES[Math.floor(Math.random() * AGENT_NAMES.length)];
+  const shuffled = [...AGENT_NAMES].sort(() => Math.random() - 0.5);
+  let name = shuffled[0];
+  for (const candidate of shuffled) {
+    if (!isNameTaken(candidate)) {
+      name = candidate;
+      break;
+    }
+  }
   cachedAutoName = name;
   try {
     mkdirSync2(dirname2(AGENT_ID_FILE), { recursive: true });
@@ -29419,6 +29488,7 @@ function resolveIdentity(explicit) {
 }
 
 // src/lib/presence.ts
+init_db();
 var ONLINE_THRESHOLD_SECONDS = 60;
 function parsePresence(row) {
   let metadata = null;
@@ -29484,12 +29554,13 @@ function renameAgent(oldName, newName) {
 // package.json
 var package_default = {
   name: "@hasna/conversations",
-  version: "0.1.5",
+  version: "0.1.6",
   description: "Real-time CLI messaging for AI agents",
   type: "module",
   bin: {
     conversations: "bin/index.js",
-    "conversations-mcp": "bin/mcp.js"
+    "conversations-mcp": "bin/mcp.js",
+    "conversations-hook": "bin/hook.js"
   },
   exports: {
     ".": {
@@ -29507,7 +29578,7 @@ var package_default = {
   main: "./dist/index.js",
   types: "./dist/index.d.ts",
   scripts: {
-    build: "bun build ./src/cli/index.tsx --outdir ./bin --target bun --external ink --external react --external chalk && bun build ./src/mcp/index.ts --outfile ./bin/mcp.js --target bun && bun build ./src/index.ts --outdir ./dist --target bun && tsc --emitDeclarationOnly --declaration --outDir dist",
+    build: "bun build ./src/cli/index.tsx --outdir ./bin --target bun --external ink --external react --external chalk && bun build ./src/mcp/index.ts --outfile ./bin/mcp.js --target bun && bun build ./src/hooks/blocker-hook.ts --outfile ./bin/hook.js --target bun && bun build ./src/index.ts --outdir ./dist --target bun && tsc --emitDeclarationOnly --declaration --outDir dist",
     "build:dashboard": "cd dashboard && bun install && bun run build",
     test: "bun test",
     dev: "bun run ./src/cli/index.tsx",
@@ -29573,9 +29644,10 @@ server.registerTool("send_message", {
     working_dir: exports_external.string().optional().describe("Working directory context"),
     repository: exports_external.string().optional().describe("Repository context"),
     branch: exports_external.string().optional().describe("Branch context"),
-    metadata: exports_external.string().optional().describe("JSON metadata string")
+    metadata: exports_external.string().optional().describe("JSON metadata string"),
+    blocking: exports_external.boolean().optional().describe("Send as a blocking message. Recipients must acknowledge before continuing.")
   }
-}, async ({ from: fromParam, to, content, session_id, priority, working_dir, repository, branch, metadata }) => {
+}, async ({ from: fromParam, to, content, session_id, priority, working_dir, repository, branch, metadata, blocking }) => {
   const from = resolveIdentity(fromParam);
   let parsedMetadata;
   if (metadata) {
@@ -29597,7 +29669,8 @@ server.registerTool("send_message", {
     working_dir,
     repository,
     branch,
-    metadata: parsedMetadata
+    metadata: parsedMetadata,
+    blocking
   });
   return {
     content: [{ type: "text", text: JSON.stringify(msg, null, 2) }]
@@ -29784,9 +29857,10 @@ server.registerTool("send_to_space", {
     from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
     space: exports_external.string().describe("Space name"),
     content: exports_external.string().describe("Message content"),
-    priority: exports_external.enum(["low", "normal", "high", "urgent"]).optional().describe("Message priority")
+    priority: exports_external.enum(["low", "normal", "high", "urgent"]).optional().describe("Message priority"),
+    blocking: exports_external.boolean().optional().describe("Send as a blocking message. All space members must acknowledge.")
   }
-}, async ({ from: fromParam, space, content, priority }) => {
+}, async ({ from: fromParam, space, content, priority, blocking }) => {
   const from = resolveIdentity(fromParam);
   const sp = getSpace(space);
   if (!sp) {
@@ -29801,7 +29875,8 @@ server.registerTool("send_to_space", {
     content,
     space,
     session_id: `space:${space}`,
-    priority
+    priority,
+    blocking
   });
   return {
     content: [{ type: "text", text: JSON.stringify(msg, null, 2) }]
@@ -30240,6 +30315,19 @@ server.registerTool("list_agents", {
     content: [{ type: "text", text: JSON.stringify(agents, null, 2) }]
   };
 });
+server.registerTool("get_blockers", {
+  title: "Get Blockers",
+  description: "Check for unread blocking messages targeting you. Returns messages that must be acknowledged before continuing.",
+  inputSchema: {
+    from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var.")
+  }
+}, async ({ from: fromParam }) => {
+  const agent = resolveIdentity(fromParam);
+  const blockers = getUnreadBlockers(agent);
+  return {
+    content: [{ type: "text", text: JSON.stringify(blockers, null, 2) }]
+  };
+});
 server.registerTool("remove_agent", {
   title: "Remove Agent",
   description: "Remove an agent from the presence list. Only the agent itself should remove its own presence.",

package/dist/hooks/blocker-hook.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+export {};

package/dist/index.d.ts

@@ -9,12 +9,12 @@
  * Or use the interactive TUI:
  *   conversations
  */
-export { sendMessage, readMessages, markRead, markSessionRead, markSpaceRead, markAllRead, getMessageById, searchMessages, exportMessages, deleteMessage, editMessage, pinMessage, unpinMessage, getPinnedMessages, } from "./lib/messages.js";
+export { sendMessage, readMessages, markRead, markSessionRead, markSpaceRead, markAllRead, getMessageById, searchMessages, exportMessages, deleteMessage, editMessage, pinMessage, unpinMessage, getPinnedMessages, getUnreadBlockers, } from "./lib/messages.js";
 export { listSessions, getSession, } from "./lib/sessions.js";
 export { createSpace, updateSpace, archiveSpace, unarchiveSpace, listSpaces, getSpace, joinSpace, leaveSpace, getSpaceMembers, isSpaceMember, getSpaceDepth, } from "./lib/spaces.js";
 export { createProject, listProjects, getProject, getProjectByName, updateProject, deleteProject, } from "./lib/projects.js";
 export { getDb, getDbPath, closeDb, } from "./lib/db.js";
 export { startPolling, useSpaceMessages, } from "./lib/poll.js";
 export { resolveIdentity, requireIdentity, } from "./lib/identity.js";
-export { heartbeat, getPresence, listAgents, removePresence, } from "./lib/presence.js";
+export { heartbeat, getPresence, listAgents, removePresence, renameAgent, } from "./lib/presence.js";
 export type { Message, Session, Space, SpaceInfo, SpaceMember, Project, ProjectInfo, Priority, SendMessageOptions, ReadMessagesOptions, SearchMessagesOptions, AgentPresence, } from "./types.js";