@hasna/conversations 0.0.8 → 0.1.1

package/bin/mcp.js

@@ -6286,7 +6286,7 @@ var require_formats = __commonJS((exports) => {
   }
   var TIME = /^(\d\d):(\d\d):(\d\d(?:\.\d+)?)(z|([+-])(\d\d)(?::?(\d\d))?)?$/i;
   function getTime(strictTimeZone) {
-    return function time3(str) {
+    return function time(str) {
       const matches = TIME.exec(str);
       if (!matches)
         return false;
@@ -28341,7 +28341,7 @@ function getDb() {
       session_id TEXT NOT NULL,
       from_agent TEXT NOT NULL,
       to_agent TEXT NOT NULL,
-      channel TEXT,
+      space TEXT,
       content TEXT NOT NULL,
       priority TEXT NOT NULL DEFAULT 'normal',
       working_dir TEXT,
@@ -28355,48 +28355,137 @@ function getDb() {
   db.exec("CREATE INDEX IF NOT EXISTS idx_messages_session ON messages(session_id)");
   db.exec("CREATE INDEX IF NOT EXISTS idx_messages_to ON messages(to_agent)");
   db.exec("CREATE INDEX IF NOT EXISTS idx_messages_created ON messages(created_at)");
-  db.exec("CREATE INDEX IF NOT EXISTS idx_messages_channel ON messages(channel)");
-  const cols = db.prepare("PRAGMA table_info(messages)").all();
-  if (!cols.some((c) => c.name === "channel")) {
-    db.exec("ALTER TABLE messages ADD COLUMN channel TEXT");
-  }
+  db.exec("CREATE INDEX IF NOT EXISTS idx_messages_space ON messages(space)");
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS projects (
+      id TEXT PRIMARY KEY,
+      name TEXT NOT NULL UNIQUE,
+      description TEXT,
+      path TEXT,
+      created_by TEXT NOT NULL,
+      created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
+      metadata TEXT,
+      tags TEXT,
+      status TEXT NOT NULL DEFAULT 'active',
+      repository TEXT,
+      settings TEXT
+    )
+  `);
+  db.exec("CREATE INDEX IF NOT EXISTS idx_projects_name ON projects(name)");
+  db.exec("CREATE INDEX IF NOT EXISTS idx_projects_status ON projects(status)");
   db.exec(`
-    CREATE TABLE IF NOT EXISTS channels (
+    CREATE TABLE IF NOT EXISTS spaces (
       name TEXT PRIMARY KEY,
       description TEXT,
+      parent_id TEXT REFERENCES spaces(name),
+      project_id TEXT REFERENCES projects(id),
       created_by TEXT NOT NULL,
-      created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now'))
+      created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
+      archived_at TEXT
     )
   `);
+  db.exec("CREATE INDEX IF NOT EXISTS idx_spaces_parent ON spaces(parent_id)");
+  db.exec("CREATE INDEX IF NOT EXISTS idx_spaces_project ON spaces(project_id)");
   db.exec(`
-    CREATE TABLE IF NOT EXISTS channel_members (
-      channel TEXT NOT NULL REFERENCES channels(name),
+    CREATE TABLE IF NOT EXISTS space_members (
+      space TEXT NOT NULL REFERENCES spaces(name),
       agent TEXT NOT NULL,
       joined_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
-      PRIMARY KEY (channel, agent)
+      PRIMARY KEY (space, agent)
     )
   `);
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS agent_presence (
+      agent TEXT PRIMARY KEY,
+      status TEXT NOT NULL DEFAULT 'online',
+      last_seen_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
+      metadata TEXT
+    )
+  `);
+  const existingTables = db.prepare("SELECT name FROM sqlite_master WHERE type='table'").all();
+  const tableNames = existingTables.map((t) => t.name);
+  if (tableNames.includes("channels") && tableNames.includes("spaces")) {
+    const spaceCount = db.prepare("SELECT COUNT(*) as c FROM spaces").get().c;
+    const channelCount = db.prepare("SELECT COUNT(*) as c FROM channels").get().c;
+    if (channelCount > 0 && spaceCount === 0) {
+      db.exec("BEGIN");
+      try {
+        db.exec(`
+          INSERT OR IGNORE INTO spaces (name, description, created_by, created_at)
+          SELECT name, description, created_by, created_at FROM channels
+        `);
+        if (tableNames.includes("channel_members")) {
+          db.exec(`
+            INSERT OR IGNORE INTO space_members (space, agent, joined_at)
+            SELECT channel, agent, joined_at FROM channel_members
+          `);
+        }
+        db.exec("COMMIT");
+      } catch (e) {
+        db.exec("ROLLBACK");
+        throw e;
+      }
+    }
+    db.exec("DROP TABLE IF EXISTS channel_members");
+    db.exec("DROP TABLE IF EXISTS channels");
+  }
+  const msgCols = db.prepare("PRAGMA table_info(messages)").all();
+  const colNames = msgCols.map((c) => c.name);
+  if (colNames.includes("channel") && !colNames.includes("space")) {
+    db.exec("ALTER TABLE messages ADD COLUMN space TEXT");
+    db.exec("CREATE INDEX IF NOT EXISTS idx_messages_space ON messages(space)");
+    db.exec("UPDATE messages SET space = channel WHERE channel IS NOT NULL");
+    db.exec(`
+      UPDATE messages
+      SET session_id = 'space:' || substr(session_id, 9)
+      WHERE session_id LIKE 'channel:%'
+    `);
+  }
+  const spaceCols = db.prepare("PRAGMA table_info(spaces)").all();
+  const spaceColNames = spaceCols.map((c) => c.name);
+  if (!spaceColNames.includes("archived_at")) {
+    db.exec("ALTER TABLE spaces ADD COLUMN archived_at TEXT");
+  }
+  const msgCols2 = db.prepare("PRAGMA table_info(messages)").all();
+  const colNames2 = msgCols2.map((c) => c.name);
+  if (!colNames2.includes("edited_at")) {
+    db.exec("ALTER TABLE messages ADD COLUMN edited_at TEXT");
+  }
+  if (!colNames2.includes("pinned_at")) {
+    db.exec("ALTER TABLE messages ADD COLUMN pinned_at TEXT");
+    db.exec("CREATE INDEX IF NOT EXISTS idx_messages_pinned ON messages(pinned_at)");
+  }
   return db;
 }
 
 // src/lib/messages.ts
 import { randomUUID } from "crypto";
 function parseMessage(row) {
+  let metadata = null;
+  if (row.metadata) {
+    try {
+      metadata = JSON.parse(row.metadata);
+    } catch {
+      metadata = null;
+    }
+  }
   return {
     ...row,
-    metadata: row.metadata ? JSON.parse(row.metadata) : null
+    metadata
   };
 }
 function sendMessage(opts) {
   const db2 = getDb();
-  const sessionId = opts.session_id || `${[opts.from, opts.to].sort().join("-")}-${randomUUID().slice(0, 8)}`;
+  const explicitSession = opts.session_id && opts.session_id.trim().length > 0 ? opts.session_id : undefined;
+  const sessionId = explicitSession ?? (opts.space ? `space:${opts.space}` : `${[opts.from, opts.to].sort().join("-")}-${randomUUID().slice(0, 8)}`);
   const metadata = opts.metadata ? JSON.stringify(opts.metadata) : null;
+  const normalizedPriority = opts.priority === "low" || opts.priority === "normal" || opts.priority === "high" || opts.priority === "urgent" ? opts.priority : "normal";
   const stmt = db2.prepare(`
-    INSERT INTO messages (session_id, from_agent, to_agent, channel, content, priority, working_dir, repository, branch, metadata)
+    INSERT INTO messages (session_id, from_agent, to_agent, space, content, priority, working_dir, repository, branch, metadata)
     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
     RETURNING *
   `);
-  const row = stmt.get(sessionId, opts.from, opts.to, opts.channel || null, opts.content, opts.priority || "normal", opts.working_dir || null, opts.repository || null, opts.branch || null, metadata);
+  const row = stmt.get(sessionId, opts.from, opts.to, opts.space || null, opts.content, normalizedPriority, opts.working_dir || null, opts.repository || null, opts.branch || null, metadata);
   return parseMessage(row);
 }
 function readMessages(opts = {}) {
@@ -28415,20 +28504,25 @@ function readMessages(opts = {}) {
     conditions.push("to_agent = ?");
     params.push(opts.to);
   }
-  if (opts.channel) {
-    conditions.push("channel = ?");
-    params.push(opts.channel);
+  if (opts.space) {
+    conditions.push("space = ?");
+    params.push(opts.space);
   }
   if (opts.since) {
     conditions.push("created_at > ?");
     params.push(opts.since);
   }
+  if (opts.since_id !== undefined) {
+    conditions.push("id > ?");
+    params.push(opts.since_id);
+  }
   if (opts.unread_only) {
     conditions.push("read_at IS NULL");
   }
   const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-  const limit = opts.limit ? `LIMIT ${opts.limit}` : "";
-  const rows = db2.prepare(`SELECT * FROM messages ${where} ORDER BY created_at ASC ${limit}`).all(...params);
+  const limit = Number.isFinite(opts.limit) && opts.limit > 0 ? `LIMIT ${Math.floor(opts.limit)}` : "";
+  const order = opts.order?.toLowerCase() === "desc" ? "DESC" : "ASC";
+  const rows = db2.prepare(`SELECT * FROM messages ${where} ORDER BY created_at ${order}, id ${order} ${limit}`).all(...params);
   return rows.map(parseMessage);
 }
 function markRead(ids, reader) {
@@ -28445,6 +28539,130 @@ function getMessageById(id) {
   const row = db2.prepare("SELECT * FROM messages WHERE id = ?").get(id);
   return row ? parseMessage(row) : null;
 }
+function markAllRead(agent) {
+  const db2 = getDb();
+  const stmt = db2.prepare(`UPDATE messages SET read_at = strftime('%Y-%m-%dT%H:%M:%f', 'now') WHERE to_agent = ? AND read_at IS NULL`);
+  const result = stmt.run(agent);
+  return result.changes;
+}
+function escapeCsvField(value) {
+  if (value === null || value === undefined)
+    return "";
+  const str = String(value);
+  if (str.includes(",") || str.includes('"') || str.includes(`
+`) || str.includes("\r")) {
+    return `"${str.replace(/"/g, '""')}"`;
+  }
+  return str;
+}
+function exportMessages(opts) {
+  const db2 = getDb();
+  const conditions = [];
+  const params = [];
+  if (opts?.space) {
+    conditions.push("space = ?");
+    params.push(opts.space);
+  }
+  if (opts?.session_id) {
+    conditions.push("session_id = ?");
+    params.push(opts.session_id);
+  }
+  if (opts?.from) {
+    conditions.push("from_agent = ?");
+    params.push(opts.from);
+  }
+  if (opts?.since) {
+    conditions.push("created_at >= ?");
+    params.push(opts.since);
+  }
+  if (opts?.until) {
+    conditions.push("created_at <= ?");
+    params.push(opts.until);
+  }
+  const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+  const rows = db2.prepare(`SELECT * FROM messages ${where} ORDER BY created_at ASC, id ASC`).all(...params);
+  const messages = rows.map(parseMessage);
+  const format = opts?.format ?? "json";
+  if (format === "csv") {
+    const headers = "id,session_id,from_agent,to_agent,space,content,priority,created_at,read_at";
+    const lines = messages.map((m) => [
+      String(m.id),
+      escapeCsvField(m.session_id),
+      escapeCsvField(m.from_agent),
+      escapeCsvField(m.to_agent),
+      escapeCsvField(m.space),
+      escapeCsvField(m.content),
+      escapeCsvField(m.priority),
+      escapeCsvField(m.created_at),
+      escapeCsvField(m.read_at)
+    ].join(","));
+    return [headers, ...lines].join(`
+`);
+  }
+  return JSON.stringify(messages, null, 2);
+}
+function deleteMessage(id, agent) {
+  const db2 = getDb();
+  const stmt = db2.prepare("DELETE FROM messages WHERE id = ? AND from_agent = ?");
+  const result = stmt.run(id, agent);
+  return result.changes > 0;
+}
+function editMessage(id, agent, newContent) {
+  const db2 = getDb();
+  const stmt = db2.prepare(`UPDATE messages SET content = ?, edited_at = strftime('%Y-%m-%dT%H:%M:%f', 'now') WHERE id = ? AND from_agent = ? RETURNING *`);
+  const row = stmt.get(newContent, id, agent);
+  return row ? parseMessage(row) : null;
+}
+function pinMessage(id) {
+  const db2 = getDb();
+  const stmt = db2.prepare(`UPDATE messages SET pinned_at = strftime('%Y-%m-%dT%H:%M:%f', 'now') WHERE id = ? RETURNING *`);
+  const row = stmt.get(id);
+  return row ? parseMessage(row) : null;
+}
+function unpinMessage(id) {
+  const db2 = getDb();
+  const stmt = db2.prepare(`UPDATE messages SET pinned_at = NULL WHERE id = ? RETURNING *`);
+  const row = stmt.get(id);
+  return row ? parseMessage(row) : null;
+}
+function getPinnedMessages(opts) {
+  const db2 = getDb();
+  const conditions = ["pinned_at IS NOT NULL"];
+  const params = [];
+  if (opts?.space) {
+    conditions.push("space = ?");
+    params.push(opts.space);
+  }
+  if (opts?.session_id) {
+    conditions.push("session_id = ?");
+    params.push(opts.session_id);
+  }
+  const where = `WHERE ${conditions.join(" AND ")}`;
+  const limit = Number.isFinite(opts?.limit) && opts.limit > 0 ? `LIMIT ${Math.floor(opts.limit)}` : "";
+  const rows = db2.prepare(`SELECT * FROM messages ${where} ORDER BY pinned_at DESC, id DESC ${limit}`).all(...params);
+  return rows.map(parseMessage);
+}
+function searchMessages(opts) {
+  const db2 = getDb();
+  const conditions = ["content LIKE ?"];
+  const params = [`%${opts.query}%`];
+  if (opts.space) {
+    conditions.push("space = ?");
+    params.push(opts.space);
+  }
+  if (opts.from) {
+    conditions.push("from_agent = ?");
+    params.push(opts.from);
+  }
+  if (opts.to) {
+    conditions.push("to_agent = ?");
+    params.push(opts.to);
+  }
+  const limit = Number.isFinite(opts.limit) && opts.limit > 0 ? Math.floor(opts.limit) : 50;
+  const where = `WHERE ${conditions.join(" AND ")}`;
+  const rows = db2.prepare(`SELECT * FROM messages ${where} ORDER BY created_at DESC, id DESC LIMIT ${limit}`).all(...params);
+  return rows.map(parseMessage);
+}
 
 // src/lib/sessions.ts
 function listSessions(agent) {
@@ -28476,70 +28694,407 @@ function listSessions(agent) {
   });
 }
 
-// src/lib/channels.ts
-function createChannel(name, createdBy, description) {
+// src/lib/spaces.ts
+function getSpaceDepth(spaceName) {
+  const db2 = getDb();
+  let depth = 0;
+  let current = spaceName;
+  for (let i = 0;i < 10; i++) {
+    const row = db2.prepare("SELECT parent_id FROM spaces WHERE name = ?").get(current);
+    if (!row || !row.parent_id)
+      break;
+    depth++;
+    current = row.parent_id;
+  }
+  return depth;
+}
+function createSpace(name, createdBy, options) {
   const db2 = getDb();
-  const row = db2.prepare("INSERT INTO channels (name, description, created_by) VALUES (?, ?, ?) RETURNING *").get(name, description || null, createdBy);
-  db2.prepare("INSERT OR IGNORE INTO channel_members (channel, agent) VALUES (?, ?)").run(name, createdBy);
+  if (options?.parent_id) {
+    const parentExists = db2.prepare("SELECT name FROM spaces WHERE name = ?").get(options.parent_id);
+    if (!parentExists) {
+      throw new Error(`Parent space not found: ${options.parent_id}`);
+    }
+    const parentDepth = getSpaceDepth(options.parent_id);
+    if (parentDepth >= 2) {
+      throw new Error("Maximum space nesting depth is 3 levels");
+    }
+  }
+  if (options?.project_id) {
+    const projectExists = db2.prepare("SELECT id FROM projects WHERE id = ?").get(options.project_id);
+    if (!projectExists) {
+      throw new Error(`Project not found: ${options.project_id}`);
+    }
+  }
+  const row = db2.prepare("INSERT INTO spaces (name, description, parent_id, project_id, created_by) VALUES (?, ?, ?, ?, ?) RETURNING *").get(name, options?.description || null, options?.parent_id || null, options?.project_id || null, createdBy);
+  db2.prepare("INSERT OR IGNORE INTO space_members (space, agent) VALUES (?, ?)").run(name, createdBy);
   return row;
 }
-function listChannels() {
+function listSpaces(options) {
   const db2 = getDb();
+  const conditions = [];
+  const params = [];
+  if (options?.project_id) {
+    conditions.push("s.project_id = ?");
+    params.push(options.project_id);
+  }
+  if (options?.parent_id !== undefined) {
+    if (options.parent_id === null) {
+      conditions.push("s.parent_id IS NULL");
+    } else {
+      conditions.push("s.parent_id = ?");
+      params.push(options.parent_id);
+    }
+  }
+  if (!options?.include_archived) {
+    conditions.push("s.archived_at IS NULL");
+  }
+  const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
   const rows = db2.prepare(`
     SELECT
-      c.name,
-      c.description,
-      c.created_by,
-      c.created_at,
-      (SELECT COUNT(*) FROM channel_members WHERE channel = c.name) AS member_count,
-      (SELECT COUNT(*) FROM messages WHERE channel = c.name) AS message_count
-    FROM channels c
-    ORDER BY c.name ASC
-  `).all();
+      s.name,
+      s.description,
+      s.parent_id,
+      s.project_id,
+      s.created_by,
+      s.created_at,
+      s.archived_at,
+      (SELECT COUNT(*) FROM space_members WHERE space = s.name) AS member_count,
+      (SELECT COUNT(*) FROM messages WHERE space = s.name) AS message_count
+    FROM spaces s
+    ${where}
+    ORDER BY s.name ASC
+  `).all(...params);
   return rows;
 }
-function getChannel(name) {
+function getSpace(name) {
   const db2 = getDb();
   const row = db2.prepare(`
     SELECT
-      c.name,
-      c.description,
-      c.created_by,
-      c.created_at,
-      (SELECT COUNT(*) FROM channel_members WHERE channel = c.name) AS member_count,
-      (SELECT COUNT(*) FROM messages WHERE channel = c.name) AS message_count
-    FROM channels c
-    WHERE c.name = ?
+      s.name,
+      s.description,
+      s.parent_id,
+      s.project_id,
+      s.created_by,
+      s.created_at,
+      s.archived_at,
+      (SELECT COUNT(*) FROM space_members WHERE space = s.name) AS member_count,
+      (SELECT COUNT(*) FROM messages WHERE space = s.name) AS message_count
+    FROM spaces s
+    WHERE s.name = ?
   `).get(name);
   return row;
 }
-function joinChannel(channelName, agent) {
+function joinSpace(spaceName, agent) {
   const db2 = getDb();
-  const channel = db2.prepare("SELECT name FROM channels WHERE name = ?").get(channelName);
-  if (!channel)
+  const space = db2.prepare("SELECT name FROM spaces WHERE name = ?").get(spaceName);
+  if (!space)
     return false;
-  db2.prepare("INSERT OR IGNORE INTO channel_members (channel, agent) VALUES (?, ?)").run(channelName, agent);
+  db2.prepare("INSERT OR IGNORE INTO space_members (space, agent) VALUES (?, ?)").run(spaceName, agent);
   return true;
 }
-function leaveChannel(channelName, agent) {
+function leaveSpace(spaceName, agent) {
   const db2 = getDb();
-  const result = db2.prepare("DELETE FROM channel_members WHERE channel = ? AND agent = ?").run(channelName, agent);
+  const result = db2.prepare("DELETE FROM space_members WHERE space = ? AND agent = ?").run(spaceName, agent);
+  return result.changes > 0;
+}
+function updateSpace(name, updates) {
+  const db2 = getDb();
+  const existing = db2.prepare("SELECT * FROM spaces WHERE name = ?").get(name);
+  if (!existing) {
+    throw new Error(`Space not found: ${name}`);
+  }
+  if (updates.parent_id !== undefined && updates.parent_id !== existing.parent_id) {
+    if (updates.parent_id !== null) {
+      const parentExists = db2.prepare("SELECT name FROM spaces WHERE name = ?").get(updates.parent_id);
+      if (!parentExists) {
+        throw new Error(`Parent space not found: ${updates.parent_id}`);
+      }
+      const parentDepth = getSpaceDepth(updates.parent_id);
+      if (parentDepth >= 2) {
+        throw new Error("Maximum space nesting depth is 3 levels");
+      }
+      if (updates.parent_id === name) {
+        throw new Error("A space cannot be its own parent");
+      }
+    }
+  }
+  if (updates.project_id !== undefined && updates.project_id !== existing.project_id) {
+    if (updates.project_id !== null) {
+      const projectExists = db2.prepare("SELECT id FROM projects WHERE id = ?").get(updates.project_id);
+      if (!projectExists) {
+        throw new Error(`Project not found: ${updates.project_id}`);
+      }
+    }
+  }
+  const sets = [];
+  const params = [];
+  if (updates.description !== undefined) {
+    sets.push("description = ?");
+    params.push(updates.description);
+  }
+  if (updates.parent_id !== undefined) {
+    sets.push("parent_id = ?");
+    params.push(updates.parent_id);
+  }
+  if (updates.project_id !== undefined) {
+    sets.push("project_id = ?");
+    params.push(updates.project_id);
+  }
+  if (sets.length === 0) {
+    return existing;
+  }
+  params.push(name);
+  const row = db2.prepare(`UPDATE spaces SET ${sets.join(", ")} WHERE name = ? RETURNING *`).get(...params);
+  return row;
+}
+function archiveSpace(name) {
+  const db2 = getDb();
+  const existing = db2.prepare("SELECT * FROM spaces WHERE name = ?").get(name);
+  if (!existing) {
+    throw new Error(`Space not found: ${name}`);
+  }
+  const row = db2.prepare("UPDATE spaces SET archived_at = strftime('%Y-%m-%dT%H:%M:%f', 'now') WHERE name = ? RETURNING *").get(name);
+  return row;
+}
+function unarchiveSpace(name) {
+  const db2 = getDb();
+  const existing = db2.prepare("SELECT * FROM spaces WHERE name = ?").get(name);
+  if (!existing) {
+    throw new Error(`Space not found: ${name}`);
+  }
+  const row = db2.prepare("UPDATE spaces SET archived_at = NULL WHERE name = ? RETURNING *").get(name);
+  return row;
+}
+
+// src/lib/projects.ts
+import { randomUUID as randomUUID2 } from "crypto";
+function parseProject(row) {
+  let metadata = null;
+  if (row.metadata) {
+    try {
+      metadata = JSON.parse(row.metadata);
+    } catch {
+      metadata = null;
+    }
+  }
+  let tags = [];
+  if (row.tags) {
+    try {
+      tags = JSON.parse(row.tags);
+    } catch {
+      tags = [];
+    }
+  }
+  let settings = null;
+  if (row.settings) {
+    try {
+      settings = JSON.parse(row.settings);
+    } catch {
+      settings = null;
+    }
+  }
+  return {
+    id: row.id,
+    name: row.name,
+    description: row.description || null,
+    path: row.path || null,
+    created_by: row.created_by,
+    created_at: row.created_at,
+    metadata,
+    tags,
+    status: row.status || "active",
+    repository: row.repository || null,
+    settings
+  };
+}
+function createProject(opts) {
+  const db2 = getDb();
+  const id = randomUUID2();
+  const metadata = opts.metadata ? JSON.stringify(opts.metadata) : null;
+  const tags = opts.tags ? JSON.stringify(opts.tags) : null;
+  const settings = opts.settings ? JSON.stringify(opts.settings) : null;
+  const row = db2.prepare(`
+    INSERT INTO projects (id, name, description, path, created_by, metadata, tags, repository, settings)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+    RETURNING *
+  `).get(id, opts.name, opts.description || null, opts.path || null, opts.created_by, metadata, tags, opts.repository || null, settings);
+  return parseProject(row);
+}
+function listProjects(opts) {
+  const db2 = getDb();
+  const conditions = [];
+  const params = [];
+  if (opts?.status) {
+    conditions.push("p.status = ?");
+    params.push(opts.status);
+  }
+  const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+  const rows = db2.prepare(`
+    SELECT
+      p.*,
+      (SELECT COUNT(*) FROM spaces WHERE project_id = p.id) AS space_count
+    FROM projects p
+    ${where}
+    ORDER BY p.name ASC
+  `).all(...params);
+  return rows.map((row) => ({
+    ...parseProject(row),
+    space_count: row.space_count
+  }));
+}
+function getProject(id) {
+  const db2 = getDb();
+  const row = db2.prepare(`
+    SELECT
+      p.*,
+      (SELECT COUNT(*) FROM spaces WHERE project_id = p.id) AS space_count
+    FROM projects p
+    WHERE p.id = ?
+  `).get(id);
+  if (!row)
+    return null;
+  return {
+    ...parseProject(row),
+    space_count: row.space_count
+  };
+}
+function getProjectByName(name) {
+  const db2 = getDb();
+  const row = db2.prepare(`
+    SELECT
+      p.*,
+      (SELECT COUNT(*) FROM spaces WHERE project_id = p.id) AS space_count
+    FROM projects p
+    WHERE p.name = ?
+  `).get(name);
+  if (!row)
+    return null;
+  return {
+    ...parseProject(row),
+    space_count: row.space_count
+  };
+}
+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) {
+    sets.push("name = ?");
+    params.push(updates.name);
+  }
+  if (updates.description !== undefined) {
+    sets.push("description = ?");
+    params.push(updates.description);
+  }
+  if (updates.path !== undefined) {
+    sets.push("path = ?");
+    params.push(updates.path);
+  }
+  if (updates.metadata !== undefined) {
+    sets.push("metadata = ?");
+    params.push(JSON.stringify(updates.metadata));
+  }
+  if (updates.tags !== undefined) {
+    sets.push("tags = ?");
+    params.push(JSON.stringify(updates.tags));
+  }
+  if (updates.status !== undefined) {
+    sets.push("status = ?");
+    params.push(updates.status);
+  }
+  if (updates.repository !== undefined) {
+    sets.push("repository = ?");
+    params.push(updates.repository);
+  }
+  if (updates.settings !== undefined) {
+    sets.push("settings = ?");
+    params.push(JSON.stringify(updates.settings));
+  }
+  if (sets.length === 0) {
+    return parseProject(existing);
+  }
+  params.push(id);
+  const row = db2.prepare(`UPDATE projects SET ${sets.join(", ")} WHERE id = ? RETURNING *`).get(...params);
+  return parseProject(row);
+}
+function deleteProject(id) {
+  const db2 = getDb();
+  const spaceCount = db2.prepare("SELECT COUNT(*) as c FROM spaces WHERE project_id = ?").get(id).c;
+  if (spaceCount > 0) {
+    throw new Error(`Cannot delete project: ${spaceCount} space(s) still reference it`);
+  }
+  const result = db2.prepare("DELETE FROM projects WHERE id = ?").run(id);
   return result.changes > 0;
 }
 
 // src/lib/identity.ts
 function resolveIdentity(explicit) {
-  if (explicit)
-    return explicit;
-  if (process.env.CONVERSATIONS_AGENT_ID)
-    return process.env.CONVERSATIONS_AGENT_ID;
+  const explicitValue = explicit?.trim();
+  if (explicitValue)
+    return explicitValue;
+  const envValue = process.env.CONVERSATIONS_AGENT_ID?.trim();
+  if (envValue)
+    return envValue;
   return "user";
 }
 
+// src/lib/presence.ts
+var ONLINE_THRESHOLD_SECONDS = 60;
+function parsePresence(row) {
+  let metadata = null;
+  if (row.metadata) {
+    try {
+      metadata = JSON.parse(row.metadata);
+    } catch {
+      metadata = null;
+    }
+  }
+  const lastSeenAt = row.last_seen_at;
+  const lastSeenMs = new Date(lastSeenAt + "Z").getTime();
+  const nowMs = Date.now();
+  const online = nowMs - lastSeenMs < ONLINE_THRESHOLD_SECONDS * 1000;
+  return {
+    agent: row.agent,
+    status: row.status,
+    last_seen_at: lastSeenAt,
+    online,
+    metadata
+  };
+}
+function heartbeat(agent, status, metadata) {
+  const db2 = getDb();
+  const metadataJson = metadata ? JSON.stringify(metadata) : null;
+  const resolvedStatus = status || "online";
+  db2.prepare(`
+    INSERT INTO agent_presence (agent, status, last_seen_at, metadata)
+    VALUES (?, ?, strftime('%Y-%m-%dT%H:%M:%f', 'now'), ?)
+    ON CONFLICT(agent) DO UPDATE SET
+      status = excluded.status,
+      last_seen_at = excluded.last_seen_at,
+      metadata = excluded.metadata
+  `).run(agent, resolvedStatus, metadataJson);
+}
+function listAgents(opts) {
+  const db2 = getDb();
+  let query = "SELECT * FROM agent_presence";
+  const params = [];
+  if (opts?.online_only) {
+    query += " WHERE last_seen_at > strftime('%Y-%m-%dT%H:%M:%f', 'now', '-60 seconds')";
+  }
+  query += " ORDER BY last_seen_at DESC";
+  const rows = db2.prepare(query).all(...params);
+  return rows.map(parsePresence);
+}
+
 // src/mcp/index.ts
 var server = new McpServer({
   name: "conversations",
-  version: "0.0.8"
+  version: "0.1.0"
 });
 server.registerTool("send_message", {
   title: "Send Message",
@@ -28556,7 +29111,17 @@ server.registerTool("send_message", {
   }
 }, async ({ to, content, session_id, priority, working_dir, repository, branch, metadata }) => {
   const from = resolveIdentity();
-  const parsedMetadata = metadata ? JSON.parse(metadata) : undefined;
+  let parsedMetadata;
+  if (metadata) {
+    try {
+      parsedMetadata = JSON.parse(metadata);
+    } catch {
+      return {
+        content: [{ type: "text", text: "Invalid metadata JSON." }],
+        isError: true
+      };
+    }
+  }
   const msg = sendMessage({
     from,
     to,
@@ -28579,7 +29144,7 @@ server.registerTool("read_messages", {
     session_id: exports_external.string().optional().describe("Filter by session ID"),
     from: exports_external.string().optional().describe("Filter by sender agent ID"),
     to: exports_external.string().optional().describe("Filter by recipient agent ID"),
-    channel: exports_external.string().optional().describe("Filter by channel name"),
+    space: exports_external.string().optional().describe("Filter by space name"),
     since: exports_external.string().optional().describe("Messages after this ISO timestamp"),
     limit: exports_external.number().optional().describe("Max messages to return"),
     unread_only: exports_external.boolean().optional().describe("Only return unread messages")
@@ -28619,12 +29184,15 @@ server.registerTool("reply", {
     };
   }
   const from = resolveIdentity();
+  const space = original.space || (original.session_id?.startsWith("space:") ? original.session_id.slice(6) : undefined);
+  const to = space ? space : original.from_agent === from ? original.to_agent : original.from_agent;
   const msg = sendMessage({
     from,
-    to: original.from_agent,
+    to,
     content,
     session_id: original.session_id,
-    priority
+    priority,
+    space
   });
   return {
     content: [{ type: "text", text: JSON.stringify(msg, null, 2) }]
@@ -28632,123 +29200,568 @@ server.registerTool("reply", {
 });
 server.registerTool("mark_read", {
   title: "Mark Read",
-  description: "Mark message IDs as read for the current agent.",
+  description: "Mark message IDs as read for the current agent. Set 'all' to true to mark all unread messages as read.",
   inputSchema: {
-    ids: exports_external.array(exports_external.number()).describe("Message IDs to mark as read")
+    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")
   }
-}, async ({ ids }) => {
+}, async ({ ids, all }) => {
   const agent = resolveIdentity();
-  const count = markRead(ids, agent);
+  let count;
+  if (all) {
+    count = markAllRead(agent);
+  } else if (ids && ids.length > 0) {
+    count = markRead(ids, agent);
+  } else {
+    return {
+      content: [{ type: "text", text: "Provide message IDs or set 'all' to true." }],
+      isError: true
+    };
+  }
   return {
     content: [{ type: "text", text: JSON.stringify({ marked_read: count }, null, 2) }]
   };
 });
-server.registerTool("create_channel", {
-  title: "Create Channel",
-  description: "Create a new channel. The creator is auto-joined.",
+server.registerTool("search_messages", {
+  title: "Search Messages",
+  description: "Full-text search across message content. Returns matching messages ordered by newest first.",
   inputSchema: {
-    name: exports_external.string().describe("Channel name (e.g. 'deployments', 'code-review')"),
-    description: exports_external.string().optional().describe("Channel description")
+    query: exports_external.string().describe("Search query string"),
+    space: exports_external.string().optional().describe("Filter by space name"),
+    from: exports_external.string().optional().describe("Filter by sender agent ID"),
+    to: exports_external.string().optional().describe("Filter by recipient agent ID"),
+    limit: exports_external.number().optional().describe("Max results to return (default 50)")
   }
-}, async ({ name, description }) => {
+}, async ({ query, space, from, to, limit }) => {
+  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.",
+  inputSchema: {
+    space: exports_external.string().optional().describe("Filter by space name"),
+    session_id: exports_external.string().optional().describe("Filter by session ID"),
+    from: exports_external.string().optional().describe("Filter by sender agent ID"),
+    since: exports_external.string().optional().describe("Messages after this ISO date"),
+    until: exports_external.string().optional().describe("Messages before this ISO date"),
+    format: exports_external.enum(["json", "csv"]).optional().describe("Output format (default: json)")
+  }
+}, async ({ space, session_id, from, since, until, format }) => {
+  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. The creator is auto-joined. Spaces can be nested (max 3 levels) and associated with a project.",
+  inputSchema: {
+    name: exports_external.string().describe("Space name (e.g. 'deployments', 'code-review')"),
+    description: exports_external.string().optional().describe("Space description"),
+    parent_id: exports_external.string().optional().describe("Parent space name for nesting (max 3 levels deep)"),
+    project_id: exports_external.string().optional().describe("Project ID to associate this space with")
+  }
+}, async ({ name, description, parent_id, project_id }) => {
   const agent = resolveIdentity();
   try {
-    const ch = createChannel(name, agent, description);
+    const sp = createSpace(name, agent, { description, parent_id, project_id });
     return {
-      content: [{ type: "text", text: JSON.stringify(ch, null, 2) }]
+      content: [{ type: "text", text: JSON.stringify(sp, null, 2) }]
     };
   } catch (e) {
     if (e.message?.includes("UNIQUE constraint")) {
       return {
-        content: [{ type: "text", text: `Channel #${name} already exists` }],
+        content: [{ type: "text", text: `Space #${name} already exists` }],
         isError: true
       };
     }
-    throw e;
+    return {
+      content: [{ type: "text", text: e.message }],
+      isError: true
+    };
   }
 });
-server.registerTool("list_channels", {
-  title: "List Channels",
-  description: "List all available channels with member and message counts."
-}, async () => {
-  const channels = listChannels();
+server.registerTool("list_spaces", {
+  title: "List Spaces",
+  description: "List all available spaces with member and message counts. Can filter by project or parent. Archived spaces are excluded by default.",
+  inputSchema: {
+    project_id: exports_external.string().optional().describe("Filter by project ID"),
+    parent_id: exports_external.string().optional().describe("Filter by parent space name. Use 'null' for top-level only."),
+    include_archived: exports_external.boolean().optional().describe("Include archived spaces (default: false)")
+  }
+}, async ({ project_id, parent_id, include_archived }) => {
+  const opts = {};
+  if (project_id)
+    opts.project_id = project_id;
+  if (parent_id === "null") {
+    opts.parent_id = null;
+  } else if (parent_id) {
+    opts.parent_id = parent_id;
+  }
+  if (include_archived)
+    opts.include_archived = true;
+  const spaces = listSpaces(opts);
   return {
-    content: [{ type: "text", text: JSON.stringify(channels, null, 2) }]
+    content: [{ type: "text", text: JSON.stringify(spaces, null, 2) }]
   };
 });
-server.registerTool("send_to_channel", {
-  title: "Send to Channel",
-  description: "Send a message to a channel. All members can see it.",
+server.registerTool("send_to_space", {
+  title: "Send to Space",
+  description: "Send a message to a space. All members can see it.",
   inputSchema: {
-    channel: exports_external.string().describe("Channel name"),
+    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")
   }
-}, async ({ channel, content, priority }) => {
+}, async ({ space, content, priority }) => {
   const from = resolveIdentity();
-  const ch = getChannel(channel);
-  if (!ch) {
+  const sp = getSpace(space);
+  if (!sp) {
     return {
-      content: [{ type: "text", text: `Channel #${channel} not found` }],
+      content: [{ type: "text", text: `Space #${space} not found` }],
       isError: true
     };
   }
   const msg = sendMessage({
     from,
-    to: channel,
+    to: space,
     content,
-    channel,
-    session_id: `channel:${channel}`,
+    space,
+    session_id: `space:${space}`,
     priority
   });
   return {
     content: [{ type: "text", text: JSON.stringify(msg, null, 2) }]
   };
 });
-server.registerTool("read_channel", {
-  title: "Read Channel",
-  description: "Read messages from a channel.",
+server.registerTool("read_space", {
+  title: "Read Space",
+  description: "Read messages from a space.",
   inputSchema: {
-    channel: exports_external.string().describe("Channel name"),
+    space: exports_external.string().describe("Space name"),
     since: exports_external.string().optional().describe("Messages after this ISO timestamp"),
     limit: exports_external.number().optional().describe("Max messages to return")
   }
-}, async ({ channel, since, limit }) => {
-  const messages = readMessages({ channel, since, limit });
+}, async ({ space, since, limit }) => {
+  const messages = readMessages({ space, since, limit });
   return {
     content: [{ type: "text", text: JSON.stringify(messages, null, 2) }]
   };
 });
-server.registerTool("join_channel", {
-  title: "Join Channel",
-  description: "Join a channel to receive messages.",
+server.registerTool("join_space", {
+  title: "Join Space",
+  description: "Join a space to receive messages.",
   inputSchema: {
-    channel: exports_external.string().describe("Channel name to join")
+    space: exports_external.string().describe("Space name to join")
   }
-}, async ({ channel }) => {
+}, async ({ space }) => {
   const agent = resolveIdentity();
-  const ok = joinChannel(channel, agent);
+  const ok = joinSpace(space, agent);
   if (!ok) {
     return {
-      content: [{ type: "text", text: `Channel #${channel} not found` }],
+      content: [{ type: "text", text: `Space #${space} not found` }],
+      isError: true
+    };
+  }
+  return {
+    content: [{ type: "text", text: JSON.stringify({ space, agent, joined: true }, null, 2) }]
+  };
+});
+server.registerTool("leave_space", {
+  title: "Leave Space",
+  description: "Leave a space.",
+  inputSchema: {
+    space: exports_external.string().describe("Space name to leave")
+  }
+}, async ({ space }) => {
+  const agent = resolveIdentity();
+  const left = leaveSpace(space, agent);
+  return {
+    content: [{ type: "text", text: JSON.stringify({ space, agent, left }, null, 2) }]
+  };
+});
+server.registerTool("update_space", {
+  title: "Update Space",
+  description: "Update a space's description, parent, or project association.",
+  inputSchema: {
+    name: exports_external.string().describe("Space name to update"),
+    description: exports_external.string().optional().describe("New description"),
+    parent_id: exports_external.string().optional().describe("New parent space name (use 'null' to remove parent)"),
+    project_id: exports_external.string().optional().describe("New project ID (use 'null' to remove project)")
+  }
+}, async ({ name, description, parent_id, project_id }) => {
+  const updates = {};
+  if (description !== undefined)
+    updates.description = description;
+  if (parent_id !== undefined)
+    updates.parent_id = parent_id === "null" ? null : parent_id;
+  if (project_id !== undefined)
+    updates.project_id = project_id === "null" ? null : project_id;
+  try {
+    const sp = updateSpace(name, updates);
+    return {
+      content: [{ type: "text", text: JSON.stringify(sp, null, 2) }]
+    };
+  } catch (e) {
+    return {
+      content: [{ type: "text", text: e.message }],
+      isError: true
+    };
+  }
+});
+server.registerTool("archive_space", {
+  title: "Archive Space",
+  description: "Archive a space. Archived spaces are hidden from list by default.",
+  inputSchema: {
+    name: exports_external.string().describe("Space name to archive")
+  }
+}, async ({ name }) => {
+  try {
+    const sp = archiveSpace(name);
+    return {
+      content: [{ type: "text", text: JSON.stringify(sp, null, 2) }]
+    };
+  } catch (e) {
+    return {
+      content: [{ type: "text", text: e.message }],
+      isError: true
+    };
+  }
+});
+server.registerTool("unarchive_space", {
+  title: "Unarchive Space",
+  description: "Unarchive a previously archived space.",
+  inputSchema: {
+    name: exports_external.string().describe("Space name to unarchive")
+  }
+}, async ({ name }) => {
+  try {
+    const sp = unarchiveSpace(name);
+    return {
+      content: [{ type: "text", text: JSON.stringify(sp, null, 2) }]
+    };
+  } catch (e) {
+    return {
+      content: [{ type: "text", text: e.message }],
+      isError: true
+    };
+  }
+});
+server.registerTool("create_project", {
+  title: "Create Project",
+  description: "Create a new project. Projects organize spaces and provide context for agent collaboration.",
+  inputSchema: {
+    name: exports_external.string().describe("Project name (unique)"),
+    description: exports_external.string().optional().describe("Project description"),
+    path: exports_external.string().optional().describe("Absolute path to project on disk"),
+    repository: exports_external.string().optional().describe("Repository URL"),
+    tags: exports_external.string().optional().describe(`JSON array of tags (e.g. '["backend", "api"]')`),
+    metadata: exports_external.string().optional().describe("JSON metadata string"),
+    settings: exports_external.string().optional().describe("JSON settings string")
+  }
+}, async ({ name, description, path, repository, tags, metadata, settings }) => {
+  const agent = resolveIdentity();
+  let parsedTags;
+  if (tags) {
+    try {
+      parsedTags = JSON.parse(tags);
+    } catch {
+      return {
+        content: [{ type: "text", text: "Invalid tags JSON. Expected array of strings." }],
+        isError: true
+      };
+    }
+  }
+  let parsedMetadata;
+  if (metadata) {
+    try {
+      parsedMetadata = JSON.parse(metadata);
+    } catch {
+      return {
+        content: [{ type: "text", text: "Invalid metadata JSON." }],
+        isError: true
+      };
+    }
+  }
+  let parsedSettings;
+  if (settings) {
+    try {
+      parsedSettings = JSON.parse(settings);
+    } catch {
+      return {
+        content: [{ type: "text", text: "Invalid settings JSON." }],
+        isError: true
+      };
+    }
+  }
+  try {
+    const project = createProject({
+      name,
+      created_by: agent,
+      description,
+      path,
+      repository,
+      tags: parsedTags,
+      metadata: parsedMetadata,
+      settings: parsedSettings
+    });
+    return {
+      content: [{ type: "text", text: JSON.stringify(project, null, 2) }]
+    };
+  } catch (e) {
+    if (e.message?.includes("UNIQUE constraint")) {
+      return {
+        content: [{ type: "text", text: `Project "${name}" already exists` }],
+        isError: true
+      };
+    }
+    return {
+      content: [{ type: "text", text: e.message }],
+      isError: true
+    };
+  }
+});
+server.registerTool("list_projects", {
+  title: "List Projects",
+  description: "List all registered projects.",
+  inputSchema: {
+    status: exports_external.enum(["active", "archived"]).optional().describe("Filter by project status")
+  }
+}, async ({ status }) => {
+  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.",
+  inputSchema: {
+    id: exports_external.string().describe("Project ID (UUID) or name")
+  }
+}, async ({ id }) => {
+  let project = getProject(id);
+  if (!project) {
+    project = getProjectByName(id);
+  }
+  if (!project) {
+    return {
+      content: [{ type: "text", text: `Project "${id}" not found` }],
+      isError: true
+    };
+  }
+  return {
+    content: [{ type: "text", text: JSON.stringify(project, null, 2) }]
+  };
+});
+server.registerTool("update_project", {
+  title: "Update Project",
+  description: "Update a project's fields.",
+  inputSchema: {
+    id: exports_external.string().describe("Project ID (UUID)"),
+    name: exports_external.string().optional().describe("New project 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 string"),
+    settings: exports_external.string().optional().describe("JSON settings string")
+  }
+}, async ({ id, name, description, path, status, repository, tags, metadata, settings }) => {
+  const updates = {};
+  if (name !== undefined)
+    updates.name = name;
+  if (description !== undefined)
+    updates.description = description;
+  if (path !== undefined)
+    updates.path = path;
+  if (status !== undefined)
+    updates.status = status;
+  if (repository !== undefined)
+    updates.repository = repository;
+  if (tags) {
+    try {
+      updates.tags = JSON.parse(tags);
+    } catch {
+      return {
+        content: [{ type: "text", text: "Invalid tags JSON." }],
+        isError: true
+      };
+    }
+  }
+  if (metadata) {
+    try {
+      updates.metadata = JSON.parse(metadata);
+    } catch {
+      return {
+        content: [{ type: "text", text: "Invalid metadata JSON." }],
+        isError: true
+      };
+    }
+  }
+  if (settings) {
+    try {
+      updates.settings = JSON.parse(settings);
+    } catch {
+      return {
+        content: [{ type: "text", text: "Invalid settings JSON." }],
+        isError: true
+      };
+    }
+  }
+  try {
+    const project = updateProject(id, updates);
+    return {
+      content: [{ type: "text", text: JSON.stringify(project, null, 2) }]
+    };
+  } catch (e) {
+    return {
+      content: [{ type: "text", text: e.message }],
+      isError: true
+    };
+  }
+});
+server.registerTool("delete_project", {
+  title: "Delete Project",
+  description: "Delete a project permanently. Fails if spaces still reference it.",
+  inputSchema: {
+    id: exports_external.string().describe("Project ID (UUID)")
+  }
+}, async ({ id }) => {
+  try {
+    const deleted = deleteProject(id);
+    if (!deleted) {
+      return {
+        content: [{ type: "text", text: `Project "${id}" not found` }],
+        isError: true
+      };
+    }
+    return {
+      content: [{ type: "text", text: JSON.stringify({ id, deleted: true }, null, 2) }]
+    };
+  } catch (e) {
+    return {
+      content: [{ type: "text", text: e.message }],
       isError: true
     };
   }
+});
+server.registerTool("delete_message", {
+  title: "Delete Message",
+  description: "Delete a message. Only the sender can delete their own messages. The agent is auto-resolved.",
+  inputSchema: {
+    id: exports_external.number().describe("Message ID to delete")
+  }
+}, async ({ id }) => {
+  const agent = resolveIdentity();
+  const deleted = deleteMessage(id, agent);
+  if (!deleted) {
+    return {
+      content: [{ type: "text", text: `Message #${id} not found or not your message` }],
+      isError: true
+    };
+  }
+  return {
+    content: [{ type: "text", text: JSON.stringify({ deleted: true }, null, 2) }]
+  };
+});
+server.registerTool("edit_message", {
+  title: "Edit Message",
+  description: "Edit a message's content. Only the sender can edit their own messages. The agent is auto-resolved.",
+  inputSchema: {
+    id: exports_external.number().describe("Message ID to edit"),
+    content: exports_external.string().describe("New message content")
+  }
+}, async ({ id, content }) => {
+  const agent = resolveIdentity();
+  const msg = editMessage(id, agent, content);
+  if (!msg) {
+    return {
+      content: [{ type: "text", text: `Message #${id} not found or not your message` }],
+      isError: true
+    };
+  }
+  return {
+    content: [{ type: "text", text: JSON.stringify(msg, null, 2) }]
+  };
+});
+server.registerTool("pin_message", {
+  title: "Pin Message",
+  description: "Pin a message. Pinned messages can be retrieved with get_pinned_messages.",
+  inputSchema: {
+    id: exports_external.number().describe("Message ID to pin")
+  }
+}, async ({ id }) => {
+  const msg = pinMessage(id);
+  if (!msg) {
+    return {
+      content: [{ type: "text", text: `Message #${id} not found` }],
+      isError: true
+    };
+  }
+  return {
+    content: [{ type: "text", text: JSON.stringify(msg, null, 2) }]
+  };
+});
+server.registerTool("unpin_message", {
+  title: "Unpin Message",
+  description: "Unpin a previously pinned message.",
+  inputSchema: {
+    id: exports_external.number().describe("Message ID to unpin")
+  }
+}, async ({ id }) => {
+  const msg = unpinMessage(id);
+  if (!msg) {
+    return {
+      content: [{ type: "text", text: `Message #${id} not found` }],
+      isError: true
+    };
+  }
+  return {
+    content: [{ type: "text", text: JSON.stringify(msg, null, 2) }]
+  };
+});
+server.registerTool("get_pinned_messages", {
+  title: "Get Pinned Messages",
+  description: "Retrieve pinned messages, optionally filtered by space or session.",
+  inputSchema: {
+    space: exports_external.string().optional().describe("Filter by space name"),
+    session_id: exports_external.string().optional().describe("Filter by session ID"),
+    limit: exports_external.number().optional().describe("Max messages to return")
+  }
+}, async ({ space, session_id, limit }) => {
+  const messages = getPinnedMessages({ space, session_id, limit });
   return {
-    content: [{ type: "text", text: JSON.stringify({ channel, agent, joined: true }, null, 2) }]
+    content: [{ type: "text", text: JSON.stringify(messages, null, 2) }]
   };
 });
-server.registerTool("leave_channel", {
-  title: "Leave Channel",
-  description: "Leave a channel.",
+server.registerTool("heartbeat", {
+  title: "Heartbeat",
+  description: "Send a heartbeat to indicate agent is alive. Auto-resolves agent from CONVERSATIONS_AGENT_ID env var. Optionally set a status.",
   inputSchema: {
-    channel: exports_external.string().describe("Channel name to leave")
+    status: exports_external.string().optional().describe("Agent status (e.g. 'online', 'busy', 'idle'). Defaults to 'online'.")
   }
-}, async ({ channel }) => {
+}, async ({ status }) => {
   const agent = resolveIdentity();
-  const left = leaveChannel(channel, agent);
+  heartbeat(agent, status);
+  return {
+    content: [{ type: "text", text: JSON.stringify({ agent, status: status || "online", heartbeat: true }, null, 2) }]
+  };
+});
+server.registerTool("list_agents", {
+  title: "List Agents",
+  description: "List all agents with their presence status. Returns agent name, status, last seen time, and whether they are online.",
+  inputSchema: {
+    online_only: exports_external.boolean().optional().describe("Only return agents that are currently online (seen within last 60 seconds)")
+  }
+}, async ({ online_only }) => {
+  const agents = listAgents({ online_only });
   return {
-    content: [{ type: "text", text: JSON.stringify({ channel, agent, left }, null, 2) }]
+    content: [{ type: "text", text: JSON.stringify(agents, null, 2) }]
   };
 });
 async function startMcpServer() {