@hasna/conversations 0.0.8 → 0.1.0

package/dist/index.js

@@ -1853,7 +1853,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,
@@ -1867,27 +1867,106 @@ 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 channels (
+    CREATE TABLE IF NOT EXISTS projects (
+      id TEXT PRIMARY KEY,
+      name TEXT NOT NULL UNIQUE,
+      description TEXT,
+      path TEXT,
+      created_by TEXT NOT NULL,
+      created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
+      metadata TEXT,
+      tags TEXT,
+      status TEXT NOT NULL DEFAULT 'active',
+      repository TEXT,
+      settings TEXT
+    )
+  `);
+  db.exec("CREATE INDEX IF NOT EXISTS idx_projects_name ON projects(name)");
+  db.exec("CREATE INDEX IF NOT EXISTS idx_projects_status ON projects(status)");
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS spaces (
       name TEXT PRIMARY KEY,
       description TEXT,
+      parent_id TEXT REFERENCES spaces(name),
+      project_id TEXT REFERENCES projects(id),
       created_by TEXT NOT NULL,
-      created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now'))
+      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;
 }
 function closeDb() {
@@ -1900,21 +1979,31 @@ function closeDb() {
 // 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 = {}) {
@@ -1933,20 +2022,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) {
@@ -1964,10 +2058,10 @@ function markSessionRead(sessionId, reader) {
   const result = stmt.run(sessionId, reader);
   return result.changes;
 }
-function markChannelRead(channelName, reader) {
+function markSpaceRead(spaceName, reader) {
   const db2 = getDb();
-  const stmt = db2.prepare(`UPDATE messages SET read_at = strftime('%Y-%m-%dT%H:%M:%f', 'now') WHERE channel = ? AND from_agent != ? AND read_at IS NULL`);
-  const result = stmt.run(channelName, reader);
+  const stmt = db2.prepare(`UPDATE messages SET read_at = strftime('%Y-%m-%dT%H:%M:%f', 'now') WHERE space = ? AND from_agent != ? AND read_at IS NULL`);
+  const result = stmt.run(spaceName, reader);
   return result.changes;
 }
 function getMessageById(id) {
@@ -1975,6 +2069,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) {
   const db2 = getDb();
@@ -2029,85 +2247,395 @@ function getSession(sessionId) {
     unread_count: row.unread_count
   };
 }
-// src/lib/channels.ts
-function createChannel(name, createdBy, description) {
+// src/lib/spaces.ts
+function getSpaceDepth(spaceName) {
   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);
+  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();
+  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 getChannelMembers(channelName) {
+function getSpaceMembers(spaceName) {
+  const db2 = getDb();
+  return db2.prepare("SELECT space, agent, joined_at FROM space_members WHERE space = ? ORDER BY joined_at ASC").all(spaceName);
+}
+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();
-  return db2.prepare("SELECT channel, agent, joined_at FROM channel_members WHERE channel = ? ORDER BY joined_at ASC").all(channelName);
+  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 isChannelMember(channelName, agent) {
+function unarchiveSpace(name) {
   const db2 = getDb();
-  const row = db2.prepare("SELECT 1 FROM channel_members WHERE channel = ? AND agent = ?").get(channelName, agent);
+  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;
+}
+function isSpaceMember(spaceName, agent) {
+  const db2 = getDb();
+  const row = db2.prepare("SELECT 1 FROM space_members WHERE space = ? AND agent = ?").get(spaceName, agent);
   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/poll.ts
 var import_react = __toESM(require_react(), 1);
 function startPolling(opts) {
   const interval = opts.interval_ms ?? 200;
-  let lastSeen = new Date().toISOString();
   let stopped = false;
-  const poll = () => {
-    if (stopped)
-      return;
-    const messages = readMessages({
+  let inFlight = false;
+  let lastSeenId = 0;
+  const seedLastSeen = () => {
+    const latest = readMessages({
       session_id: opts.session_id,
       to: opts.to_agent,
-      channel: opts.channel,
-      since: lastSeen
+      space: opts.space,
+      order: "desc",
+      limit: 1
     });
-    if (messages.length > 0) {
-      lastSeen = messages[messages.length - 1].created_at;
-      opts.on_messages(messages);
+    if (latest.length > 0) {
+      lastSeenId = latest[0].id;
     }
   };
+  const poll = () => {
+    if (stopped || inFlight)
+      return;
+    inFlight = true;
+    try {
+      const messages = readMessages({
+        session_id: opts.session_id,
+        to: opts.to_agent,
+        space: opts.space,
+        since_id: lastSeenId,
+        order: "asc"
+      });
+      if (messages.length > 0) {
+        lastSeenId = messages[messages.length - 1].id;
+        try {
+          opts.on_messages(messages);
+        } catch (error) {
+          console.error("Polling callback error:", error);
+        }
+      }
+    } finally {
+      inFlight = false;
+    }
+  };
+  seedLastSeen();
   const timer = setInterval(poll, interval);
   return {
     stop: () => {
@@ -2116,62 +2644,141 @@ function startPolling(opts) {
     }
   };
 }
-function useChannelMessages(channelName) {
+function useSpaceMessages(spaceName) {
   const [messages, setMessages] = import_react.useState([]);
-  const initialLoad = import_react.useRef(false);
   import_react.useEffect(() => {
-    if (!initialLoad.current) {
-      const existing = readMessages({ channel: channelName });
-      setMessages(existing);
-      initialLoad.current = true;
-    }
+    const existing = readMessages({ space: spaceName });
+    setMessages(existing);
     const { stop } = startPolling({
-      channel: channelName,
+      space: spaceName,
       interval_ms: 200,
       on_messages: (newMessages) => {
         setMessages((prev) => [...prev, ...newMessages]);
       }
     });
     return stop;
-  }, [channelName]);
+  }, [spaceName]);
   return messages;
 }
 // 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";
 }
 function requireIdentity(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;
   throw new Error("Agent identity required. Set CONVERSATIONS_AGENT_ID env var or pass --from flag.");
 }
+// 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 getPresence(agent) {
+  const db2 = getDb();
+  const row = db2.prepare("SELECT * FROM agent_presence WHERE agent = ?").get(agent);
+  return row ? parsePresence(row) : null;
+}
+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);
+}
+function removePresence(agent) {
+  const db2 = getDb();
+  const result = db2.prepare("DELETE FROM agent_presence WHERE agent = ?").run(agent);
+  return result.changes > 0;
+}
 export {
-  useChannelMessages,
+  useSpaceMessages,
+  updateSpace,
+  updateProject,
+  unpinMessage,
+  unarchiveSpace,
   startPolling,
   sendMessage,
+  searchMessages,
   resolveIdentity,
   requireIdentity,
+  removePresence,
   readMessages,
+  pinMessage,
+  markSpaceRead,
   markSessionRead,
   markRead,
-  markChannelRead,
+  markAllRead,
+  listSpaces,
   listSessions,
-  listChannels,
-  leaveChannel,
-  joinChannel,
-  isChannelMember,
+  listProjects,
+  listAgents,
+  leaveSpace,
+  joinSpace,
+  isSpaceMember,
+  heartbeat,
+  getSpaceMembers,
+  getSpaceDepth,
+  getSpace,
   getSession,
+  getProjectByName,
+  getProject,
+  getPresence,
+  getPinnedMessages,
   getMessageById,
   getDbPath,
   getDb,
-  getChannelMembers,
-  getChannel,
-  createChannel,
-  closeDb
+  exportMessages,
+  editMessage,
+  deleteProject,
+  deleteMessage,
+  createSpace,
+  createProject,
+  closeDb,
+  archiveSpace
 };