@hasna/conversations 0.1.19 → 0.1.21

package/bin/mcp.js

@@ -29777,7 +29777,7 @@ function renameAgent(oldName, newName) {
 // package.json
 var package_default = {
   name: "@hasna/conversations",
-  version: "0.1.19",
+  version: "0.1.21",
   description: "Real-time CLI messaging for AI agents",
   type: "module",
   bin: {
@@ -29860,43 +29860,22 @@ var server = new McpServer({
   version: 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 {
@@ -29904,45 +29883,43 @@ server.registerTool("send_message", {
   };
 });
 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 {
@@ -29958,7 +29935,6 @@ server.registerTool("reply", {
     to,
     content,
     session_id: original.session_id,
-    priority,
     space
   });
   return {
@@ -29966,14 +29942,14 @@ server.registerTool("reply", {
   };
 });
 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) {
@@ -29991,49 +29967,49 @@ server.registerTool("mark_read", {
   };
 });
 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 });
@@ -30054,14 +30030,14 @@ server.registerTool("create_space", {
   }
 });
 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;
@@ -30078,16 +30054,16 @@ server.registerTool("list_spaces", {
   };
 });
 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) {
@@ -30110,27 +30086,27 @@ server.registerTool("send_to_space", {
   };
 });
 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) {
@@ -30144,13 +30120,13 @@ server.registerTool("join_space", {
   };
 });
 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 {
@@ -30158,15 +30134,15 @@ server.registerTool("leave_space", {
   };
 });
 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;
@@ -30187,10 +30163,9 @@ server.registerTool("update_space", {
   }
 });
 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 {
@@ -30206,10 +30181,9 @@ server.registerTool("archive_space", {
   }
 });
 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 {
@@ -30225,19 +30199,19 @@ server.registerTool("unarchive_space", {
   }
 });
 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) {
@@ -30300,22 +30274,21 @@ server.registerTool("create_project", {
   }
 });
 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);
@@ -30333,20 +30306,20 @@ server.registerTool("get_project", {
   };
 });
 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;
@@ -30401,10 +30374,9 @@ server.registerTool("update_project", {
   }
 });
 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 {
@@ -30426,13 +30398,13 @@ server.registerTool("delete_project", {
   }
 });
 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) {
@@ -30446,14 +30418,14 @@ server.registerTool("delete_message", {
   };
 });
 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) {
@@ -30467,10 +30439,9 @@ server.registerTool("edit_message", {
   };
 });
 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);
@@ -30485,10 +30456,9 @@ server.registerTool("pin_message", {
   };
 });
 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);
@@ -30503,27 +30473,27 @@ server.registerTool("unpin_message", {
   };
 });
 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 {
@@ -30531,24 +30501,24 @@ server.registerTool("heartbeat", {
   };
 });
 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 {
@@ -30556,13 +30526,13 @@ server.registerTool("get_blockers", {
   };
 });
 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);
@@ -30577,13 +30547,13 @@ server.registerTool("remove_agent", {
   };
 });
 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) {
@@ -30610,6 +30580,97 @@ server.registerTool("rename_agent", {
     };
   }
 });
+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 }] };
+});
 async function startMcpServer() {
   const transport = new StdioServerTransport;
   await server.connect(transport);