@hasna/conversations 0.1.19 → 0.1.21

package/bin/index.js

@@ -3503,7 +3503,7 @@ var init_poll = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/conversations",
-    version: "0.1.19",
+    version: "0.1.21",
     description: "Real-time CLI messaging for AI agents",
     type: "module",
     bin: {
@@ -32474,43 +32474,22 @@ var init_mcp2 = __esm(() => {
     version: import__package.default.version
   });
   server.registerTool("send_message", {
-    title: "Send Message",
-    description: "Send a direct message to another agent.",
+    description: "Send a DM to an agent.",
     inputSchema: {
-      from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
-      to: exports_external.string().describe("Recipient agent ID"),
-      content: exports_external.string().describe("Message content"),
-      session_id: exports_external.string().optional().describe("Session ID (auto-generated if omitted)"),
-      priority: exports_external.enum(["low", "normal", "high", "urgent"]).optional().describe("Message priority"),
-      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"),
-      blocking: exports_external.boolean().optional().describe("Blocking message \u2014 recipients must acknowledge before continuing")
-    }
-  }, async ({ from: fromParam, to, content, session_id, priority, working_dir, repository, branch, metadata, blocking }) => {
+      to: exports_external.string(),
+      content: exports_external.string(),
+      from: exports_external.string().optional(),
+      priority: exports_external.string().optional(),
+      blocking: exports_external.boolean().optional()
+    }
+  }, async (args) => {
+    const { from: fromParam, to, content, priority, blocking } = args;
     const from = resolveIdentity(fromParam);
-    let parsedMetadata;
-    if (metadata) {
-      try {
-        parsedMetadata = JSON.parse(metadata);
-      } catch {
-        return {
-          content: [{ type: "text", text: "invalid JSON" }],
-          isError: true
-        };
-      }
-    }
     const msg = sendMessage({
       from,
       to,
       content,
-      session_id,
       priority,
-      working_dir,
-      repository,
-      branch,
-      metadata: parsedMetadata,
       blocking
     });
     return {
@@ -32518,45 +32497,43 @@ var init_mcp2 = __esm(() => {
     };
   });
   server.registerTool("read_messages", {
-    title: "Read Messages",
-    description: "Read messages with optional filters. Returns messages sorted by time.",
+    description: "Read DMs with optional filters.",
     inputSchema: {
-      session_id: exports_external.string().optional().describe("Filter by session ID"),
-      from: exports_external.string().optional().describe("Filter by sender"),
-      to: exports_external.string().optional().describe("Filter by recipient"),
-      space: exports_external.string().optional().describe("Filter by space name"),
-      since: exports_external.string().optional().describe("ISO timestamp lower bound"),
-      limit: exports_external.number().optional().describe("Max messages to return (default 20)"),
-      unread_only: exports_external.boolean().optional().describe("Only unread messages")
-    }
-  }, async (opts) => {
-    const messages = readMessages(opts);
+      session_id: exports_external.string().optional(),
+      from: exports_external.string().optional(),
+      to: exports_external.string().optional(),
+      space: exports_external.string().optional(),
+      since: exports_external.string().optional(),
+      limit: exports_external.number().optional(),
+      unread_only: exports_external.boolean().optional()
+    }
+  }, async (args) => {
+    const messages = readMessages(args);
     return {
       content: [{ type: "text", text: JSON.stringify(messages, null, 2) }]
     };
   });
   server.registerTool("list_sessions", {
-    title: "List Sessions",
-    description: "List conversation sessions, optionally filtered to a specific agent.",
+    description: "List all sessions by agent.",
     inputSchema: {
-      agent: exports_external.string().optional().describe("Filter sessions involving this agent")
+      agent: exports_external.string().optional()
     }
-  }, async ({ agent }) => {
+  }, async (args) => {
+    const { agent } = args;
     const sessions = listSessions(agent);
     return {
       content: [{ type: "text", text: JSON.stringify(sessions, null, 2) }]
     };
   });
   server.registerTool("reply", {
-    title: "Reply to Message",
-    description: "Reply to a message by ID. Uses the same session and sends to the original sender.",
+    description: "Reply to a message by ID.",
     inputSchema: {
-      from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
-      message_id: exports_external.number().describe("ID of the message to reply to"),
-      content: exports_external.string().describe("Reply content"),
-      priority: exports_external.enum(["low", "normal", "high", "urgent"]).optional().describe("Message priority")
+      message_id: exports_external.number(),
+      content: exports_external.string(),
+      from: exports_external.string().optional()
     }
-  }, async ({ from: fromParam, message_id, content, priority }) => {
+  }, async (args) => {
+    const { from: fromParam, message_id, content } = args;
     const original = getMessageById(message_id);
     if (!original) {
       return {
@@ -32572,7 +32549,6 @@ var init_mcp2 = __esm(() => {
       to,
       content,
       session_id: original.session_id,
-      priority,
       space
     });
     return {
@@ -32580,14 +32556,14 @@ var init_mcp2 = __esm(() => {
     };
   });
   server.registerTool("mark_read", {
-    title: "Mark Read",
-    description: "Mark messages as read. Provide IDs or set 'all' to true.",
+    description: "Mark messages read by IDs or all.",
     inputSchema: {
-      from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
-      ids: exports_external.array(exports_external.number()).optional().describe("Message IDs to mark as read"),
-      all: exports_external.boolean().optional().describe("Mark all unread messages as read")
+      from: exports_external.string().optional(),
+      ids: exports_external.array(exports_external.number()).optional(),
+      all: exports_external.boolean().optional()
     }
-  }, async ({ from: fromParam, ids, all }) => {
+  }, async (args) => {
+    const { from: fromParam, ids, all } = args;
     const agent = resolveIdentity(fromParam);
     let count;
     if (all) {
@@ -32605,49 +32581,49 @@ var init_mcp2 = __esm(() => {
     };
   });
   server.registerTool("search_messages", {
-    title: "Search Messages",
-    description: "Full-text search across message content, newest first.",
+    description: "Full-text search across messages.",
     inputSchema: {
-      query: exports_external.string().describe("Search query"),
-      space: exports_external.string().optional().describe("Filter by space"),
-      from: exports_external.string().optional().describe("Filter by sender"),
-      to: exports_external.string().optional().describe("Filter by recipient"),
-      limit: exports_external.number().optional().describe("Max results (default 20)")
-    }
-  }, async ({ query, space, from, to, limit }) => {
+      query: exports_external.string(),
+      space: exports_external.string().optional(),
+      from: exports_external.string().optional(),
+      to: exports_external.string().optional(),
+      limit: exports_external.number().optional()
+    }
+  }, async (args) => {
+    const { query, space, from, to, limit } = args;
     const messages = searchMessages({ query, space, from, to, limit });
     return {
       content: [{ type: "text", text: JSON.stringify(messages, null, 2) }]
     };
   });
   server.registerTool("export_messages", {
-    title: "Export Messages",
-    description: "Export messages as JSON or CSV with optional filters.",
+    description: "Export messages as JSON or CSV.",
     inputSchema: {
-      space: exports_external.string().optional().describe("Filter by space"),
-      session_id: exports_external.string().optional().describe("Filter by session ID"),
-      from: exports_external.string().optional().describe("Filter by sender"),
-      since: exports_external.string().optional().describe("ISO date lower bound"),
-      until: exports_external.string().optional().describe("ISO date upper bound"),
-      format: exports_external.enum(["json", "csv"]).optional().describe("Output format (default: json)")
-    }
-  }, async ({ space, session_id, from, since, until, format }) => {
+      space: exports_external.string().optional(),
+      session_id: exports_external.string().optional(),
+      from: exports_external.string().optional(),
+      since: exports_external.string().optional(),
+      until: exports_external.string().optional(),
+      format: exports_external.string().optional()
+    }
+  }, async (args) => {
+    const { space, session_id, from, since, until, format } = args;
     const result = exportMessages({ space, session_id, from, since, until, format });
     return {
       content: [{ type: "text", text: result }]
     };
   });
   server.registerTool("create_space", {
-    title: "Create Space",
-    description: "Create a new space. Creator is auto-joined. Supports nesting (max 3 levels) and project association.",
+    description: "Create a space and auto-join.",
     inputSchema: {
-      from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
-      name: exports_external.string().describe("Space name"),
-      description: exports_external.string().optional().describe("Space description"),
-      parent_id: exports_external.string().optional().describe("Parent space name (max 3 levels deep)"),
-      project_id: exports_external.string().optional().describe("Project ID to associate with")
-    }
-  }, async ({ from: fromParam, name, description, parent_id, project_id }) => {
+      name: exports_external.string(),
+      from: exports_external.string().optional(),
+      description: exports_external.string().optional(),
+      parent_id: exports_external.string().optional(),
+      project_id: exports_external.string().optional()
+    }
+  }, async (args) => {
+    const { from: fromParam, name, description, parent_id, project_id } = args;
     const agent = resolveIdentity(fromParam);
     try {
       const sp = createSpace(name, agent, { description, parent_id, project_id });
@@ -32668,14 +32644,14 @@ var init_mcp2 = __esm(() => {
     }
   });
   server.registerTool("list_spaces", {
-    title: "List Spaces",
-    description: "List spaces with member/message counts. Archived spaces excluded by default.",
+    description: "List spaces with counts.",
     inputSchema: {
-      project_id: exports_external.string().optional().describe("Filter by project ID"),
-      parent_id: exports_external.string().optional().describe("Filter by parent space. Use 'null' for top-level only."),
-      include_archived: exports_external.boolean().optional().describe("Include archived spaces")
+      project_id: exports_external.string().optional(),
+      parent_id: exports_external.string().optional(),
+      include_archived: exports_external.boolean().optional()
     }
-  }, async ({ project_id, parent_id, include_archived }) => {
+  }, async (args) => {
+    const { project_id, parent_id, include_archived } = args;
     const opts = {};
     if (project_id)
       opts.project_id = project_id;
@@ -32692,16 +32668,16 @@ var init_mcp2 = __esm(() => {
     };
   });
   server.registerTool("send_to_space", {
-    title: "Send to Space",
-    description: "Send a message to a space. All members can see it.",
+    description: "Post a message to a space.",
     inputSchema: {
-      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"),
-      blocking: exports_external.boolean().optional().describe("Blocking message \u2014 all space members must acknowledge")
-    }
-  }, async ({ from: fromParam, space, content, priority, blocking }) => {
+      space: exports_external.string(),
+      content: exports_external.string(),
+      from: exports_external.string().optional(),
+      priority: exports_external.string().optional(),
+      blocking: exports_external.boolean().optional()
+    }
+  }, async (args) => {
+    const { from: fromParam, space, content, priority, blocking } = args;
     const from = resolveIdentity(fromParam);
     const sp = getSpace(space);
     if (!sp) {
@@ -32724,27 +32700,27 @@ var init_mcp2 = __esm(() => {
     };
   });
   server.registerTool("read_space", {
-    title: "Read Space",
     description: "Read messages from a space.",
     inputSchema: {
-      space: exports_external.string().describe("Space name"),
-      since: exports_external.string().optional().describe("ISO timestamp lower bound"),
-      limit: exports_external.number().optional().describe("Max messages to return")
+      space: exports_external.string(),
+      since: exports_external.string().optional(),
+      limit: exports_external.number().optional()
     }
-  }, async ({ space, since, limit }) => {
+  }, async (args) => {
+    const { space, since, limit } = args;
     const messages = readMessages({ space, since, limit });
     return {
       content: [{ type: "text", text: JSON.stringify(messages, null, 2) }]
     };
   });
   server.registerTool("join_space", {
-    title: "Join Space",
-    description: "Join a space to receive messages.",
+    description: "Join a space as a member.",
     inputSchema: {
-      from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
-      space: exports_external.string().describe("Space name to join")
+      space: exports_external.string(),
+      from: exports_external.string().optional()
     }
-  }, async ({ from: fromParam, space }) => {
+  }, async (args) => {
+    const { from: fromParam, space } = args;
     const agent = resolveIdentity(fromParam);
     const ok = joinSpace(space, agent);
     if (!ok) {
@@ -32758,13 +32734,13 @@ var init_mcp2 = __esm(() => {
     };
   });
   server.registerTool("leave_space", {
-    title: "Leave Space",
     description: "Leave a space.",
     inputSchema: {
-      from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
-      space: exports_external.string().describe("Space name to leave")
+      space: exports_external.string(),
+      from: exports_external.string().optional()
     }
-  }, async ({ from: fromParam, space }) => {
+  }, async (args) => {
+    const { from: fromParam, space } = args;
     const agent = resolveIdentity(fromParam);
     const left = leaveSpace(space, agent);
     return {
@@ -32772,15 +32748,15 @@ var init_mcp2 = __esm(() => {
     };
   });
   server.registerTool("update_space", {
-    title: "Update Space",
-    description: "Update a space's description, parent, or project.",
+    description: "Update space description or parent.",
     inputSchema: {
-      name: exports_external.string().describe("Space name"),
-      description: exports_external.string().optional().describe("New description"),
-      parent_id: exports_external.string().optional().describe("New parent space (use 'null' to remove)"),
-      project_id: exports_external.string().optional().describe("New project ID (use 'null' to remove)")
+      name: exports_external.string(),
+      description: exports_external.string().optional(),
+      parent_id: exports_external.string().optional(),
+      project_id: exports_external.string().optional()
     }
-  }, async ({ name, description, parent_id, project_id }) => {
+  }, async (args) => {
+    const { name, description, parent_id, project_id } = args;
     const updates = {};
     if (description !== undefined)
       updates.description = description;
@@ -32801,10 +32777,9 @@ var init_mcp2 = __esm(() => {
     }
   });
   server.registerTool("archive_space", {
-    title: "Archive Space",
-    description: "Archive a space. Hidden from list by default.",
+    description: "Archive a space.",
     inputSchema: {
-      name: exports_external.string().describe("Space name to archive")
+      name: exports_external.string()
     }
   }, async ({ name }) => {
     try {
@@ -32820,10 +32795,9 @@ var init_mcp2 = __esm(() => {
     }
   });
   server.registerTool("unarchive_space", {
-    title: "Unarchive Space",
-    description: "Unarchive a previously archived space.",
+    description: "Unarchive a space.",
     inputSchema: {
-      name: exports_external.string().describe("Space name to unarchive")
+      name: exports_external.string()
     }
   }, async ({ name }) => {
     try {
@@ -32839,19 +32813,19 @@ var init_mcp2 = __esm(() => {
     }
   });
   server.registerTool("create_project", {
-    title: "Create Project",
-    description: "Create a new project to organize spaces and agent collaboration.",
+    description: "Create a project for agent collaboration.",
     inputSchema: {
-      from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
-      name: exports_external.string().describe("Project name (unique)"),
-      description: exports_external.string().optional().describe("Project description"),
-      path: exports_external.string().optional().describe("Absolute path on disk"),
-      repository: exports_external.string().optional().describe("Repository URL"),
-      tags: exports_external.string().optional().describe("JSON array of tags"),
-      metadata: exports_external.string().optional().describe("JSON metadata"),
-      settings: exports_external.string().optional().describe("JSON settings")
-    }
-  }, async ({ from: fromParam, name, description, path, repository, tags, metadata, settings }) => {
+      name: exports_external.string(),
+      from: exports_external.string().optional(),
+      description: exports_external.string().optional(),
+      path: exports_external.string().optional(),
+      repository: exports_external.string().optional(),
+      tags: exports_external.string().optional(),
+      metadata: exports_external.string().optional(),
+      settings: exports_external.string().optional()
+    }
+  }, async (args) => {
+    const { from: fromParam, name, description, path, repository, tags, metadata, settings } = args;
     const agent = resolveIdentity(fromParam);
     let parsedTags;
     if (tags) {
@@ -32914,22 +32888,21 @@ var init_mcp2 = __esm(() => {
     }
   });
   server.registerTool("list_projects", {
-    title: "List Projects",
-    description: "List all registered projects.",
+    description: "List all projects.",
     inputSchema: {
-      status: exports_external.enum(["active", "archived"]).optional().describe("Filter by status")
+      status: exports_external.string().optional()
     }
-  }, async ({ status }) => {
+  }, async (args) => {
+    const { status } = args;
     const projects = listProjects(status ? { status } : undefined);
     return {
       content: [{ type: "text", text: JSON.stringify(projects, null, 2) }]
     };
   });
   server.registerTool("get_project", {
-    title: "Get Project",
-    description: "Get full details of a project by ID or name.",
+    description: "Get a project by ID or name.",
     inputSchema: {
-      id: exports_external.string().describe("Project ID (UUID) or name")
+      id: exports_external.string()
     }
   }, async ({ id }) => {
     let project = getProject(id);
@@ -32947,20 +32920,20 @@ var init_mcp2 = __esm(() => {
     };
   });
   server.registerTool("update_project", {
-    title: "Update Project",
-    description: "Update a project's fields.",
+    description: "Update project fields by ID.",
     inputSchema: {
-      id: exports_external.string().describe("Project ID (UUID)"),
-      name: exports_external.string().optional().describe("New name"),
-      description: exports_external.string().optional().describe("New description"),
-      path: exports_external.string().optional().describe("New path"),
-      status: exports_external.enum(["active", "archived"]).optional().describe("New status"),
-      repository: exports_external.string().optional().describe("New repository URL"),
-      tags: exports_external.string().optional().describe("JSON array of tags"),
-      metadata: exports_external.string().optional().describe("JSON metadata"),
-      settings: exports_external.string().optional().describe("JSON settings")
-    }
-  }, async ({ id, name, description, path, status, repository, tags, metadata, settings }) => {
+      id: exports_external.string(),
+      name: exports_external.string().optional(),
+      description: exports_external.string().optional(),
+      path: exports_external.string().optional(),
+      status: exports_external.string().optional(),
+      repository: exports_external.string().optional(),
+      tags: exports_external.string().optional(),
+      metadata: exports_external.string().optional(),
+      settings: exports_external.string().optional()
+    }
+  }, async (args) => {
+    const { id, name, description, path, status, repository, tags, metadata, settings } = args;
     const updates = {};
     if (name !== undefined)
       updates.name = name;
@@ -33015,10 +32988,9 @@ var init_mcp2 = __esm(() => {
     }
   });
   server.registerTool("delete_project", {
-    title: "Delete Project",
-    description: "Delete a project permanently. Fails if spaces reference it.",
+    description: "Delete a project permanently.",
     inputSchema: {
-      id: exports_external.string().describe("Project ID (UUID)")
+      id: exports_external.string()
     }
   }, async ({ id }) => {
     try {
@@ -33040,13 +33012,13 @@ var init_mcp2 = __esm(() => {
     }
   });
   server.registerTool("delete_message", {
-    title: "Delete Message",
-    description: "Delete a message. Only the sender can delete their own messages.",
+    description: "Delete a message (sender only).",
     inputSchema: {
-      from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
-      id: exports_external.number().describe("Message ID to delete")
+      id: exports_external.number(),
+      from: exports_external.string().optional()
     }
-  }, async ({ from: fromParam, id }) => {
+  }, async (args) => {
+    const { from: fromParam, id } = args;
     const agent = resolveIdentity(fromParam);
     const deleted = deleteMessage(id, agent);
     if (!deleted) {
@@ -33060,14 +33032,14 @@ var init_mcp2 = __esm(() => {
     };
   });
   server.registerTool("edit_message", {
-    title: "Edit Message",
-    description: "Edit a message's content. Only the sender can edit their own messages.",
+    description: "Edit message content (sender only).",
     inputSchema: {
-      from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
-      id: exports_external.number().describe("Message ID to edit"),
-      content: exports_external.string().describe("New message content")
+      id: exports_external.number(),
+      content: exports_external.string(),
+      from: exports_external.string().optional()
     }
-  }, async ({ from: fromParam, id, content }) => {
+  }, async (args) => {
+    const { from: fromParam, id, content } = args;
     const agent = resolveIdentity(fromParam);
     const msg = editMessage(id, agent, content);
     if (!msg) {
@@ -33081,10 +33053,9 @@ var init_mcp2 = __esm(() => {
     };
   });
   server.registerTool("pin_message", {
-    title: "Pin Message",
-    description: "Pin a message. Retrieve pinned messages with get_pinned_messages.",
+    description: "Pin a message.",
     inputSchema: {
-      id: exports_external.number().describe("Message ID to pin")
+      id: exports_external.number()
     }
   }, async ({ id }) => {
     const msg = pinMessage(id);
@@ -33099,10 +33070,9 @@ var init_mcp2 = __esm(() => {
     };
   });
   server.registerTool("unpin_message", {
-    title: "Unpin Message",
-    description: "Unpin a previously pinned message.",
+    description: "Unpin a message.",
     inputSchema: {
-      id: exports_external.number().describe("Message ID to unpin")
+      id: exports_external.number()
     }
   }, async ({ id }) => {
     const msg = unpinMessage(id);
@@ -33117,27 +33087,27 @@ var init_mcp2 = __esm(() => {
     };
   });
   server.registerTool("get_pinned_messages", {
-    title: "Get Pinned Messages",
-    description: "Retrieve pinned messages, optionally filtered by space or session.",
+    description: "Get pinned messages by space or session.",
     inputSchema: {
-      space: exports_external.string().optional().describe("Filter by space"),
-      session_id: exports_external.string().optional().describe("Filter by session ID"),
-      limit: exports_external.number().optional().describe("Max messages to return")
+      space: exports_external.string().optional(),
+      session_id: exports_external.string().optional(),
+      limit: exports_external.number().optional()
     }
-  }, async ({ space, session_id, limit }) => {
+  }, async (args) => {
+    const { space, session_id, limit } = args;
     const messages = getPinnedMessages({ space, session_id, limit });
     return {
       content: [{ type: "text", text: JSON.stringify(messages, null, 2) }]
     };
   });
   server.registerTool("heartbeat", {
-    title: "Heartbeat",
-    description: "Send a heartbeat to indicate agent is alive. Optionally set a status.",
+    description: "Send presence heartbeat.",
     inputSchema: {
-      from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
-      status: exports_external.string().optional().describe("Agent status (e.g. 'online', 'busy', 'idle'). Defaults to 'online'.")
+      from: exports_external.string().optional(),
+      status: exports_external.string().optional()
     }
-  }, async ({ from: fromParam, status }) => {
+  }, async (args) => {
+    const { from: fromParam, status } = args;
     const agent = resolveIdentity(fromParam);
     heartbeat(agent, status);
     return {
@@ -33145,24 +33115,24 @@ var init_mcp2 = __esm(() => {
     };
   });
   server.registerTool("list_agents", {
-    title: "List Agents",
-    description: "List agents with presence status (name, status, last_seen, online).",
+    description: "List agents with presence status.",
     inputSchema: {
-      online_only: exports_external.boolean().optional().describe("Only return agents online within last 60s")
+      online_only: exports_external.boolean().optional()
     }
-  }, async ({ online_only }) => {
+  }, async (args) => {
+    const { online_only } = args;
     const agents = listAgents({ online_only });
     return {
       content: [{ type: "text", text: JSON.stringify(agents, null, 2) }]
     };
   });
   server.registerTool("get_blockers", {
-    title: "Get Blockers",
-    description: "Check for unread blocking messages targeting you. Must acknowledge before continuing.",
+    description: "Check for unread blocking messages.",
     inputSchema: {
-      from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var.")
+      from: exports_external.string().optional()
     }
-  }, async ({ from: fromParam }) => {
+  }, async (args) => {
+    const { from: fromParam } = args;
     const agent = resolveIdentity(fromParam);
     const blockers = getUnreadBlockers(agent);
     return {
@@ -33170,13 +33140,13 @@ var init_mcp2 = __esm(() => {
     };
   });
   server.registerTool("remove_agent", {
-    title: "Remove Agent",
-    description: "Remove an agent from the presence list.",
+    description: "Remove an agent from presence.",
     inputSchema: {
-      from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
-      agent: exports_external.string().optional().describe("Agent to remove (defaults to yourself)")
+      from: exports_external.string().optional(),
+      agent: exports_external.string().optional()
     }
-  }, async ({ from: fromParam, agent: targetAgent }) => {
+  }, async (args) => {
+    const { from: fromParam, agent: targetAgent } = args;
     const self = resolveIdentity(fromParam);
     const agent = targetAgent?.trim() || self;
     const removed = removePresence(agent);
@@ -33191,13 +33161,13 @@ var init_mcp2 = __esm(() => {
     };
   });
   server.registerTool("rename_agent", {
-    title: "Rename Agent",
-    description: "Rename an agent in the presence list. Defaults to renaming yourself.",
+    description: "Rename your agent in presence.",
     inputSchema: {
-      from: exports_external.string().optional().describe("Your current agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
-      new_name: exports_external.string().describe("The new name for the agent")
+      new_name: exports_external.string(),
+      from: exports_external.string().optional()
     }
-  }, async ({ from: fromParam, new_name }) => {
+  }, async (args) => {
+    const { from: fromParam, new_name } = args;
     const oldName = resolveIdentity(fromParam);
     const newName = new_name.trim();
     if (!newName) {
@@ -33224,6 +33194,97 @@ var init_mcp2 = __esm(() => {
       };
     }
   });
+  server.registerTool("search_tools", {
+    description: "List tool names by keyword.",
+    inputSchema: {
+      query: exports_external.string().optional()
+    }
+  }, async (args) => {
+    const { query } = args;
+    const all = [
+      "send_message",
+      "read_messages",
+      "list_sessions",
+      "reply",
+      "mark_read",
+      "search_messages",
+      "export_messages",
+      "create_space",
+      "list_spaces",
+      "send_to_space",
+      "read_space",
+      "join_space",
+      "leave_space",
+      "update_space",
+      "archive_space",
+      "unarchive_space",
+      "create_project",
+      "list_projects",
+      "get_project",
+      "update_project",
+      "delete_project",
+      "delete_message",
+      "edit_message",
+      "pin_message",
+      "unpin_message",
+      "get_pinned_messages",
+      "heartbeat",
+      "list_agents",
+      "get_blockers",
+      "remove_agent",
+      "rename_agent",
+      "search_tools",
+      "describe_tools"
+    ];
+    const q = query?.toLowerCase();
+    const matches = q ? all.filter((n) => n.includes(q)) : all;
+    return { content: [{ type: "text", text: matches.join(", ") }] };
+  });
+  server.registerTool("describe_tools", {
+    description: "Get descriptions for tools by name.",
+    inputSchema: {
+      names: exports_external.array(exports_external.string())
+    }
+  }, async ({ names }) => {
+    const descriptions = {
+      send_message: "Send DM to agent. Required: to, content. Optional: from?, priority?(low|normal|high|urgent), blocking?",
+      read_messages: "Read messages with filters. Optional: session_id?, from?, to?, space?, since?(ISO), limit?, unread_only?",
+      list_sessions: "List all DM sessions. Optional: agent?(filter by participant)",
+      reply: "Reply to a message in same session. Required: message_id, content. Optional: from?",
+      mark_read: "Mark messages as read. Optional: from?, ids?(array), all?(bool \u2014 mark all unread)",
+      search_messages: "Full-text search messages. Required: query. Optional: space?, from?, to?, limit?",
+      export_messages: "Export messages as JSON or CSV. Optional: space?, session_id?, from?, since?, until?, format?(json|csv)",
+      create_space: "Create space and auto-join. Required: name. Optional: from?, description?, parent_id?(max 3 levels), project_id?",
+      list_spaces: "List spaces with member/message counts. Optional: project_id?, parent_id?(use 'null' for top-level), include_archived?",
+      send_to_space: "Post message to space. Required: space, content. Optional: from?, priority?(low|normal|high|urgent), blocking?",
+      read_space: "Read messages in a space. Required: space. Optional: since?(ISO), limit?",
+      join_space: "Join a space. Required: space. Optional: from?",
+      leave_space: "Leave a space. Required: space. Optional: from?",
+      update_space: "Update space fields. Required: name. Optional: description?, parent_id?(use 'null' to remove), project_id?(use 'null' to remove)",
+      archive_space: "Archive a space (hidden from default list). Required: name",
+      unarchive_space: "Restore archived space. Required: name",
+      create_project: "Create a project. Required: name. Optional: from?, description?, path?, repository?, tags?(JSON array), metadata?(JSON), settings?(JSON)",
+      list_projects: "List projects. Optional: status?(active|archived)",
+      get_project: "Get project by UUID or name. Required: id",
+      update_project: "Update project fields. Required: id. Optional: name?, description?, path?, status?(active|archived), repository?, tags?(JSON), metadata?(JSON), settings?(JSON)",
+      delete_project: "Delete project (fails if spaces reference it). Required: id",
+      delete_message: "Delete a message (sender only). Required: id. Optional: from?",
+      edit_message: "Edit message content (sender only). Required: id, content. Optional: from?",
+      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?",
+      heartbeat: "Register/refresh agent presence. Optional: from?, status?(online|busy|idle, default: online)",
+      list_agents: "List agents with presence timestamps. Optional: online_only?(only agents seen in last 60s)",
+      get_blockers: "Get unread blocking messages for agent. Optional: from?",
+      remove_agent: "Remove agent from presence list. Optional: from?, agent?(defaults to self)",
+      rename_agent: "Rename agent in presence list. Required: new_name. Optional: from?",
+      search_tools: "Search tool names by keyword. Optional: query?",
+      describe_tools: "Get full descriptions for tools. Required: names(array of tool names)"
+    };
+    const result = names.map((n) => `${n}: ${descriptions[n] || "See tool schema"}`).join(`
+`);
+    return { content: [{ type: "text", text: result }] };
+  });
   isDirectRun = import.meta.url === `file://${process.argv[1]}` || process.argv[1]?.endsWith("mcp.js") || process.argv[1]?.endsWith("mcp.ts");
   if (isDirectRun) {
     startMcpServer().catch((error48) => {