@hasna/conversations 0.1.20 → 0.1.22

package/bin/index.js

@@ -2822,10 +2822,6 @@ function getProjectByName(name) {
 }
 function updateProject(id, updates) {
   const db2 = getDb();
-  const existing = db2.prepare("SELECT * FROM projects WHERE id = ?").get(id);
-  if (!existing) {
-    throw new Error(`Project not found: ${id}`);
-  }
   const sets = [];
   const params = [];
   if (updates.name !== undefined) {
@@ -2861,10 +2857,15 @@ function updateProject(id, updates) {
     params.push(JSON.stringify(updates.settings));
   }
   if (sets.length === 0) {
-    return parseProject(existing);
+    const row2 = db2.prepare("SELECT * FROM projects WHERE id = ?").get(id);
+    if (!row2)
+      throw new Error(`Project not found: ${id}`);
+    return parseProject(row2);
   }
   params.push(id);
   const row = db2.prepare(`UPDATE projects SET ${sets.join(", ")} WHERE id = ? RETURNING *`).get(...params);
+  if (!row)
+    throw new Error(`Project not found: ${id}`);
   return parseProject(row);
 }
 function deleteProject(id) {
@@ -3503,7 +3504,7 @@ var init_poll = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/conversations",
-    version: "0.1.20",
+    version: "0.1.22",
     description: "Real-time CLI messaging for AI agents",
     type: "module",
     bin: {
@@ -32474,89 +32475,66 @@ 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 {
-      content: [{ type: "text", text: JSON.stringify(msg, null, 2) }]
+      content: [{ type: "text", text: JSON.stringify(msg) }]
     };
   });
   server.registerTool("read_messages", {
-    title: "Read Messages",
-    description: "Read messages with filters, newest first.",
+    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) }]
+      content: [{ type: "text", text: JSON.stringify(messages) }]
     };
   });
   server.registerTool("list_sessions", {
-    title: "List Sessions",
-    description: "List sessions, optionally filtered by 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) }]
+      content: [{ type: "text", text: JSON.stringify(sessions) }]
     };
   });
   server.registerTool("reply", {
-    title: "Reply to Message",
-    description: "Reply to a message (same session, 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,22 +32550,21 @@ var init_mcp2 = __esm(() => {
       to,
       content,
       session_id: original.session_id,
-      priority,
       space
     });
     return {
-      content: [{ type: "text", text: JSON.stringify(msg, null, 2) }]
+      content: [{ type: "text", text: JSON.stringify(msg) }]
     };
   });
   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) {
@@ -32601,58 +32578,58 @@ var init_mcp2 = __esm(() => {
       };
     }
     return {
-      content: [{ type: "text", text: JSON.stringify({ marked_read: count }, null, 2) }]
+      content: [{ type: "text", text: JSON.stringify({ marked_read: count }) }]
     };
   });
   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) }]
+      content: [{ type: "text", text: JSON.stringify(messages) }]
     };
   });
   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 space. Auto-joined. Supports nesting and projects.",
+    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 });
       return {
-        content: [{ type: "text", text: JSON.stringify(sp, null, 2) }]
+        content: [{ type: "text", text: JSON.stringify(sp) }]
       };
     } catch (e) {
       if (e.message?.includes("UNIQUE constraint")) {
@@ -32668,14 +32645,14 @@ var init_mcp2 = __esm(() => {
     }
   });
   server.registerTool("list_spaces", {
-    title: "List Spaces",
-    description: "List spaces with member/message counts.",
+    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;
@@ -32688,20 +32665,20 @@ var init_mcp2 = __esm(() => {
       opts.include_archived = true;
     const spaces = listSpaces(opts);
     return {
-      content: [{ type: "text", text: JSON.stringify(spaces, null, 2) }]
+      content: [{ type: "text", text: JSON.stringify(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) {
@@ -32720,31 +32697,31 @@ var init_mcp2 = __esm(() => {
       blocking
     });
     return {
-      content: [{ type: "text", text: JSON.stringify(msg, null, 2) }]
+      content: [{ type: "text", text: JSON.stringify(msg) }]
     };
   });
   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) }]
+      content: [{ type: "text", text: JSON.stringify(messages) }]
     };
   });
   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) {
@@ -32754,33 +32731,33 @@ var init_mcp2 = __esm(() => {
       };
     }
     return {
-      content: [{ type: "text", text: JSON.stringify({ space, agent, joined: true }, null, 2) }]
+      content: [{ type: "text", text: JSON.stringify({ space, agent, joined: true }) }]
     };
   });
   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 {
-      content: [{ type: "text", text: JSON.stringify({ space, agent, left }, null, 2) }]
+      content: [{ type: "text", text: JSON.stringify({ space, agent, left }) }]
     };
   });
   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;
@@ -32791,7 +32768,7 @@ var init_mcp2 = __esm(() => {
     try {
       const sp = updateSpace(name, updates);
       return {
-        content: [{ type: "text", text: JSON.stringify(sp, null, 2) }]
+        content: [{ type: "text", text: JSON.stringify(sp) }]
       };
     } catch (e) {
       return {
@@ -32801,16 +32778,15 @@ 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 {
       const sp = archiveSpace(name);
       return {
-        content: [{ type: "text", text: JSON.stringify(sp, null, 2) }]
+        content: [{ type: "text", text: JSON.stringify(sp) }]
       };
     } catch (e) {
       return {
@@ -32820,16 +32796,15 @@ 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 {
       const sp = unarchiveSpace(name);
       return {
-        content: [{ type: "text", text: JSON.stringify(sp, null, 2) }]
+        content: [{ type: "text", text: JSON.stringify(sp) }]
       };
     } catch (e) {
       return {
@@ -32839,19 +32814,19 @@ var init_mcp2 = __esm(() => {
     }
   });
   server.registerTool("create_project", {
-    title: "Create Project",
-    description: "Create a project for 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) {
@@ -32898,7 +32873,7 @@ var init_mcp2 = __esm(() => {
         settings: parsedSettings
       });
       return {
-        content: [{ type: "text", text: JSON.stringify(project, null, 2) }]
+        content: [{ type: "text", text: JSON.stringify(project) }]
       };
     } catch (e) {
       if (e.message?.includes("UNIQUE constraint")) {
@@ -32914,22 +32889,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) }]
+      content: [{ type: "text", text: JSON.stringify(projects) }]
     };
   });
   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);
@@ -32943,24 +32917,24 @@ var init_mcp2 = __esm(() => {
       };
     }
     return {
-      content: [{ type: "text", text: JSON.stringify(project, null, 2) }]
+      content: [{ type: "text", text: JSON.stringify(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;
@@ -33005,7 +32979,7 @@ var init_mcp2 = __esm(() => {
     try {
       const project = updateProject(id, updates);
       return {
-        content: [{ type: "text", text: JSON.stringify(project, null, 2) }]
+        content: [{ type: "text", text: JSON.stringify(project) }]
       };
     } catch (e) {
       return {
@@ -33015,10 +32989,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 {
@@ -33030,7 +33003,7 @@ var init_mcp2 = __esm(() => {
         };
       }
       return {
-        content: [{ type: "text", text: JSON.stringify({ id, deleted: true }, null, 2) }]
+        content: [{ type: "text", text: JSON.stringify({ id, deleted: true }) }]
       };
     } catch (e) {
       return {
@@ -33040,13 +33013,13 @@ var init_mcp2 = __esm(() => {
     }
   });
   server.registerTool("delete_message", {
-    title: "Delete Message",
-    description: "Delete a message. Sender only.",
+    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) {
@@ -33056,18 +33029,18 @@ var init_mcp2 = __esm(() => {
       };
     }
     return {
-      content: [{ type: "text", text: JSON.stringify({ deleted: true }, null, 2) }]
+      content: [{ type: "text", text: JSON.stringify({ deleted: true }) }]
     };
   });
   server.registerTool("edit_message", {
-    title: "Edit Message",
-    description: "Edit a message's content. Sender only.",
+    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) {
@@ -33077,14 +33050,13 @@ var init_mcp2 = __esm(() => {
       };
     }
     return {
-      content: [{ type: "text", text: JSON.stringify(msg, null, 2) }]
+      content: [{ type: "text", text: JSON.stringify(msg) }]
     };
   });
   server.registerTool("pin_message", {
-    title: "Pin Message",
-    description: "Pin a message in a space or session.",
+    description: "Pin a message.",
     inputSchema: {
-      id: exports_external.number().describe("Message ID to pin")
+      id: exports_external.number()
     }
   }, async ({ id }) => {
     const msg = pinMessage(id);
@@ -33095,14 +33067,13 @@ var init_mcp2 = __esm(() => {
       };
     }
     return {
-      content: [{ type: "text", text: JSON.stringify(msg, null, 2) }]
+      content: [{ type: "text", text: JSON.stringify(msg) }]
     };
   });
   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);
@@ -33113,70 +33084,70 @@ var init_mcp2 = __esm(() => {
       };
     }
     return {
-      content: [{ type: "text", text: JSON.stringify(msg, null, 2) }]
+      content: [{ type: "text", text: JSON.stringify(msg) }]
     };
   });
   server.registerTool("get_pinned_messages", {
-    title: "Get Pinned Messages",
-    description: "Get pinned messages, 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) }]
+      content: [{ type: "text", text: JSON.stringify(messages) }]
     };
   });
   server.registerTool("heartbeat", {
-    title: "Heartbeat",
-    description: "Send heartbeat. Optionally set agent 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 {
-      content: [{ type: "text", text: JSON.stringify({ agent, status: status || "online", heartbeat: true }, null, 2) }]
+      content: [{ type: "text", text: JSON.stringify({ agent, status: status || "online", heartbeat: true }) }]
     };
   });
   server.registerTool("list_agents", {
-    title: "List Agents",
     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) }]
+      content: [{ type: "text", text: JSON.stringify(agents) }]
     };
   });
   server.registerTool("get_blockers", {
-    title: "Get Blockers",
-    description: "Check for unread blocking messages. Must acknowledge.",
+    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 {
-      content: [{ type: "text", text: JSON.stringify(blockers, null, 2) }]
+      content: [{ type: "text", text: JSON.stringify(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);
@@ -33187,17 +33158,17 @@ var init_mcp2 = __esm(() => {
       };
     }
     return {
-      content: [{ type: "text", text: JSON.stringify({ agent, removed: true }, null, 2) }]
+      content: [{ type: "text", text: JSON.stringify({ agent, removed: true }) }]
     };
   });
   server.registerTool("rename_agent", {
-    title: "Rename Agent",
-    description: "Rename an agent in the presence list.",
+    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) {
@@ -33215,7 +33186,7 @@ var init_mcp2 = __esm(() => {
         };
       }
       return {
-        content: [{ type: "text", text: JSON.stringify({ old_name: oldName, new_name: newName, renamed: true }, null, 2) }]
+        content: [{ type: "text", text: JSON.stringify({ old_name: oldName, new_name: newName, renamed: true }) }]
       };
     } catch (e) {
       return {
@@ -33225,12 +33196,12 @@ var init_mcp2 = __esm(() => {
     }
   });
   server.registerTool("search_tools", {
-    title: "Search Tools",
-    description: "List tool names, optionally filtered by keyword.",
+    description: "List tool names by keyword.",
     inputSchema: {
-      query: exports_external.string().optional().describe("Keyword filter")
+      query: exports_external.string().optional()
     }
-  }, async ({ query }) => {
+  }, async (args) => {
+    const { query } = args;
     const all = [
       "send_message",
       "read_messages",
@@ -33271,26 +33242,45 @@ var init_mcp2 = __esm(() => {
     return { content: [{ type: "text", text: matches.join(", ") }] };
   });
   server.registerTool("describe_tools", {
-    title: "Describe Tools",
-    description: "Get descriptions for specific tools by name.",
+    description: "Get descriptions for tools by name.",
     inputSchema: {
-      names: exports_external.array(exports_external.string()).describe("Tool names from search_tools")
+      names: exports_external.array(exports_external.string())
     }
   }, async ({ names }) => {
     const descriptions = {
-      send_message: "Send DM to agent. Params: to, content, from?, priority?",
-      read_messages: "Read messages. Params: space?, from?, to?, unread_only?, limit?",
-      list_sessions: "List sessions. Params: agent?",
-      reply: "Reply to message. Params: id, content, from?",
-      send_to_space: "Send message to space. Params: space, content, from?",
-      read_space: "Read space messages. Params: space, limit?, since?",
-      join_space: "Join a space. Params: space, from?",
-      create_space: "Create space. Params: name, description?, parent_id?",
-      list_spaces: "List spaces with counts. No required params.",
-      heartbeat: "Send heartbeat. Params: from?, status?",
-      list_agents: "List agents with presence. No required params.",
-      get_blockers: "Check for blocking messages. Params: name?",
-      search_messages: "Search messages. Params: query, space?, limit?"
+      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(`
 `);
@@ -33331,6 +33321,33 @@ function securityHeaders(base) {
   }
   return headers;
 }
+function applyFields(data, fields) {
+  if (!fields)
+    return data;
+  const keys = fields.split(",").map((s) => s.trim()).filter(Boolean);
+  if (!keys.length)
+    return data;
+  if (Array.isArray(data)) {
+    return data.map((item) => {
+      if (item && typeof item === "object") {
+        const out = {};
+        for (const k of keys)
+          if (k in item)
+            out[k] = item[k];
+        return out;
+      }
+      return item;
+    });
+  }
+  if (data && typeof data === "object") {
+    const out = {};
+    for (const k of keys)
+      if (k in data)
+        out[k] = data[k];
+    return out;
+  }
+  return data;
+}
 function jsonResponse(data, status = 200) {
   return new Response(JSON.stringify(data), {
     status,
@@ -33403,8 +33420,9 @@ function startDashboardServer(port = 0, host) {
         const space = url2.searchParams.get("space") || undefined;
         const from = url2.searchParams.get("from") || undefined;
         const to = url2.searchParams.get("to") || undefined;
-        const messages = readMessages({ session_id: session, space, from, to, limit, order: "desc" });
-        return jsonResponse(messages);
+        const compact = url2.searchParams.get("compact") === "true";
+        const messages = readMessages({ session_id: session, space, from, to, limit, order: "desc", compact });
+        return jsonResponse(applyFields(messages, url2.searchParams.get("fields")));
       }
       if (path === "/api/messages" && req.method === "POST") {
         if (!isSameOrigin(req)) {
@@ -33549,7 +33567,7 @@ function startDashboardServer(port = 0, host) {
       }
       if (path === "/api/sessions") {
         const agent = url2.searchParams.get("agent") || undefined;
-        return jsonResponse(listSessions(agent));
+        return jsonResponse(applyFields(listSessions(agent), url2.searchParams.get("fields")));
       }
       if (path === "/api/spaces" && req.method === "GET") {
         const projectId = url2.searchParams.get("project_id") || undefined;
@@ -33559,7 +33577,7 @@ function startDashboardServer(port = 0, host) {
           listOpts.project_id = projectId;
         if (includeArchived)
           listOpts.include_archived = true;
-        return jsonResponse(listSpaces(Object.keys(listOpts).length > 0 ? listOpts : undefined));
+        return jsonResponse(applyFields(listSpaces(Object.keys(listOpts).length > 0 ? listOpts : undefined), url2.searchParams.get("fields")));
       }
       if (path === "/api/spaces" && req.method === "POST") {
         if (!isSameOrigin(req)) {
@@ -33638,7 +33656,7 @@ function startDashboardServer(port = 0, host) {
       }
       if (path === "/api/projects" && req.method === "GET") {
         const status = url2.searchParams.get("status");
-        return jsonResponse(listProjects(status ? { status } : undefined));
+        return jsonResponse(applyFields(listProjects(status ? { status } : undefined), url2.searchParams.get("fields")));
       }
       if (path === "/api/projects" && req.method === "POST") {
         if (!isSameOrigin(req)) {
@@ -33708,7 +33726,7 @@ function startDashboardServer(port = 0, host) {
       if (path === "/api/agents" && req.method === "GET") {
         const onlineOnly = url2.searchParams.get("online_only") === "true";
         const agents = listAgents({ online_only: onlineOnly });
-        return jsonResponse(agents);
+        return jsonResponse(applyFields(agents, url2.searchParams.get("fields")));
       }
       if (path === "/api/version" && req.method === "GET") {
         try {