@hasna/todos 0.10.1 → 0.10.3

package/dist/lib/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;CAC1C;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;IACzC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAC1D,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC1C;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,EAItC,CAAC;AAWF,wBAAgB,UAAU,IAAI,WAAW,CAYxC;AAED,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,GAAG,IAAI,CAKzD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM/D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM7D;AAED,wBAAgB,mBAAmB,IAAI,gBAAgB,GAAG,IAAI,CAG7D;AAUD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAmBpE;AAED,wBAAgB,wBAAwB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,CAAC,qBAAqB,CAAC,CASrG"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;CAC1C;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;IACzC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAC1D,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC1C;AAWD,wBAAgB,UAAU,IAAI,WAAW,CAYxC;AAED,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,GAAG,IAAI,CAKzD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM/D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM7D;AAED,wBAAgB,mBAAmB,IAAI,gBAAgB,GAAG,IAAI,CAG7D;AAUD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAmB3E;AAED,wBAAgB,wBAAwB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,CAAC,qBAAqB,CAAC,CASrG"}

package/dist/mcp/index.js

@@ -150,6 +150,7 @@ function ensureSchema(db) {
     CREATE TABLE agents (
       id TEXT PRIMARY KEY, name TEXT NOT NULL UNIQUE, description TEXT,
       role TEXT DEFAULT 'agent', permissions TEXT DEFAULT '["*"]',
+      status TEXT NOT NULL DEFAULT 'active' CHECK(status IN ('active', 'archived')),
       metadata TEXT DEFAULT '{}',
       created_at TEXT NOT NULL DEFAULT (datetime('now')),
       last_seen_at TEXT NOT NULL DEFAULT (datetime('now'))
@@ -799,6 +800,11 @@ var init_database = __esm(() => {
     `
   ALTER TABLE agents ADD COLUMN capabilities TEXT DEFAULT '[]';
   INSERT OR IGNORE INTO _migrations (id) VALUES (29);
+  `,
+    `
+  ALTER TABLE agents ADD COLUMN status TEXT NOT NULL DEFAULT 'active' CHECK(status IN ('active', 'archived'));
+  CREATE INDEX IF NOT EXISTS idx_agents_status ON agents(status);
+  INSERT OR IGNORE INTO _migrations (id) VALUES (30);
   `
   ];
 });
@@ -953,6 +959,7 @@ var exports_agents = {};
 __export(exports_agents, {
   updateAgentActivity: () => updateAgentActivity,
   updateAgent: () => updateAgent,
+  unarchiveAgent: () => unarchiveAgent,
   registerAgent: () => registerAgent,
   matchCapabilities: () => matchCapabilities,
   listAgents: () => listAgents,
@@ -963,11 +970,12 @@ __export(exports_agents, {
   getAvailableNamesFromPool: () => getAvailableNamesFromPool,
   getAgentByName: () => getAgentByName,
   getAgent: () => getAgent,
-  deleteAgent: () => deleteAgent
+  deleteAgent: () => deleteAgent,
+  archiveAgent: () => archiveAgent
 });
 function getAvailableNamesFromPool(pool, db) {
   const cutoff = new Date(Date.now() - AGENT_ACTIVE_WINDOW_MS).toISOString();
-  const activeNames = new Set(db.query("SELECT name FROM agents WHERE last_seen_at > ?").all(cutoff).map((r) => r.name.toLowerCase()));
+  const activeNames = new Set(db.query("SELECT name FROM agents WHERE status = 'active' AND last_seen_at > ?").all(cutoff).map((r) => r.name.toLowerCase()));
   return pool.filter((name) => !activeNames.has(name.toLowerCase()));
 }
 function shortUuid() {
@@ -978,30 +986,13 @@ function rowToAgent(row) {
     ...row,
     permissions: JSON.parse(row.permissions || '["*"]'),
     capabilities: JSON.parse(row.capabilities || "[]"),
+    status: row.status || "active",
     metadata: JSON.parse(row.metadata || "{}")
   };
 }
 function registerAgent(input, db) {
   const d = db || getDatabase();
   const normalizedName = input.name.trim().toLowerCase();
-  if (input.pool && input.pool.length > 0) {
-    const poolLower = input.pool.map((n) => n.toLowerCase());
-    if (!poolLower.includes(normalizedName)) {
-      const available = getAvailableNamesFromPool(input.pool, d);
-      const suggestion = available.length > 0 ? available[0] : null;
-      return {
-        conflict: true,
-        pool_violation: true,
-        existing_id: "",
-        existing_name: normalizedName,
-        last_seen_at: "",
-        session_hint: null,
-        working_dir: input.working_dir || null,
-        suggestions: available.slice(0, 5),
-        message: `"${normalizedName}" is not in this project's agent pool [${input.pool.join(", ")}]. ${available.length > 0 ? `Try: ${available.slice(0, 3).join(", ")}` : "No names are currently available \u2014 wait for an active agent to go stale."}${suggestion ? ` Suggested: ${suggestion}` : ""}`
-      };
-    }
-  }
   const existing = getAgentByName(normalizedName, d);
   if (existing) {
     const lastSeenMs = new Date(existing.last_seen_at).getTime();
@@ -1022,7 +1013,7 @@ function registerAgent(input, db) {
         message: `Agent "${normalizedName}" is already active (last seen ${minutesAgo}m ago, session ${existing.session_id?.slice(0, 8)}\u2026, dir: ${existing.working_dir ?? "unknown"}). Are you that agent? If so, pass session_id="${existing.session_id}" to reclaim it. Otherwise choose a different name.${suggestions.length > 0 ? ` Available: ${suggestions.slice(0, 3).join(", ")}` : ""}`
       };
     }
-    const updates = ["last_seen_at = ?"];
+    const updates = ["last_seen_at = ?", "status = 'active'"];
     const params = [now()];
     if (input.session_id && !sameSession) {
       updates.push("session_id = ?");
@@ -1076,9 +1067,19 @@ function getAgentByName(name, db) {
   const row = d.query("SELECT * FROM agents WHERE LOWER(name) = ?").get(normalizedName);
   return row ? rowToAgent(row) : null;
 }
-function listAgents(db) {
-  const d = db || getDatabase();
-  return d.query("SELECT * FROM agents ORDER BY name").all().map(rowToAgent);
+function listAgents(opts, db) {
+  let d;
+  let includeArchived = false;
+  if (opts && typeof opts === "object" && "query" in opts) {
+    d = opts;
+  } else {
+    includeArchived = opts?.include_archived ?? false;
+    d = db || getDatabase();
+  }
+  if (includeArchived) {
+    return d.query("SELECT * FROM agents ORDER BY name").all().map(rowToAgent);
+  }
+  return d.query("SELECT * FROM agents WHERE status = 'active' ORDER BY name").all().map(rowToAgent);
 }
 function updateAgentActivity(id, db) {
   const d = db || getDatabase();
@@ -1137,7 +1138,17 @@ function updateAgent(id, input, db) {
 }
 function deleteAgent(id, db) {
   const d = db || getDatabase();
-  return d.run("DELETE FROM agents WHERE id = ?", [id]).changes > 0;
+  return d.run("UPDATE agents SET status = 'archived', last_seen_at = ? WHERE id = ?", [now(), id]).changes > 0;
+}
+function archiveAgent(id, db) {
+  const d = db || getDatabase();
+  d.run("UPDATE agents SET status = 'archived', last_seen_at = ? WHERE id = ?", [now(), id]);
+  return getAgent(id, d);
+}
+function unarchiveAgent(id, db) {
+  const d = db || getDatabase();
+  d.run("UPDATE agents SET status = 'active', last_seen_at = ? WHERE id = ?", [now(), id]);
+  return getAgent(id, d);
 }
 function getDirectReports(agentId, db) {
   const d = db || getDatabase();
@@ -6135,23 +6146,6 @@ function appendSyncConflict(metadata, conflict, limit = 5) {
 }
 
 // src/lib/config.ts
-var DEFAULT_AGENT_POOL = [
-  "maximus",
-  "cassius",
-  "aurelius",
-  "brutus",
-  "titus",
-  "nero",
-  "cicero",
-  "seneca",
-  "cato",
-  "julius",
-  "marcus",
-  "lucius",
-  "quintus",
-  "gaius",
-  "publius"
-];
 function getConfigPath() {
   return join3(process.env["HOME"] || HOME, ".todos", "config.json");
 }
@@ -6216,7 +6210,7 @@ function getAgentPoolForProject(workingDir) {
       return config.project_pools[bestKey];
     }
   }
-  return config.agent_pool || DEFAULT_AGENT_POOL;
+  return config.agent_pool || null;
 }
 function getCompletionGuardConfig(projectPath) {
   const config = loadConfig();
@@ -8253,13 +8247,15 @@ var MINIMAL_TOOLS = new Set([
   "add_comment",
   "get_next_task",
   "bootstrap",
-  "get_tasks_changed_since"
+  "get_tasks_changed_since",
+  "heartbeat"
 ]);
 var STANDARD_EXCLUDED = new Set([
   "get_org_chart",
   "set_reports_to",
   "rename_agent",
   "delete_agent",
+  "unarchive_agent",
   "create_webhook",
   "list_webhooks",
   "delete_webhook",
@@ -9228,8 +9224,8 @@ if (shouldRegisterTool("unfocus")) {
   });
 }
 if (shouldRegisterTool("register_agent")) {
-  server.tool("register_agent", "Register an agent. Name must be from the project's configured pool. Returns a conflict error with available name suggestions if the name is taken or not allowed.", {
-    name: exports_external.string().describe("Agent name \u2014 must be from the project's allowed pool (Roman names by default). Use suggest_agent_name first if unsure."),
+  server.tool("register_agent", "Register an agent. Any name is allowed \u2014 the configured pool is advisory, not enforced. Returns a conflict error if the name is held by a recently-active agent.", {
+    name: exports_external.string().describe("Agent name \u2014 any name is allowed. Use suggest_agent_name to see pool suggestions and avoid conflicts."),
     description: exports_external.string().optional(),
     capabilities: exports_external.array(exports_external.string()).optional().describe("Agent capabilities/skills for task routing (e.g. ['typescript', 'testing', 'devops'])"),
     session_id: exports_external.string().optional().describe("Unique ID for this coding session (e.g. process PID + timestamp, or env var). Used to detect name collisions across sessions. Store it and pass on every register_agent call."),
@@ -9237,17 +9233,19 @@ if (shouldRegisterTool("register_agent")) {
   }, async ({ name, description, capabilities, session_id, working_dir }) => {
     try {
       const pool = getAgentPoolForProject(working_dir);
-      const result = registerAgent({ name, description, capabilities, session_id, working_dir, pool });
+      const result = registerAgent({ name, description, capabilities, session_id, working_dir, pool: pool || undefined });
       if (isAgentConflict(result)) {
         const suggestLine = result.suggestions && result.suggestions.length > 0 ? `
 Available names: ${result.suggestions.join(", ")}` : "";
-        const hint = result.pool_violation ? `POOL_VIOLATION: ${result.message}${suggestLine}` : `CONFLICT: ${result.message}${suggestLine}`;
+        const hint = `CONFLICT: ${result.message}${suggestLine}`;
         return {
           content: [{ type: "text", text: hint }],
           isError: true
         };
       }
       const agent = result;
+      const poolLine = pool ? `
+Pool: [${pool.join(", ")}]` : "";
       return {
         content: [{
           type: "text",
@@ -9255,8 +9253,7 @@ Available names: ${result.suggestions.join(", ")}` : "";
 ID: ${agent.id}
 Name: ${agent.name}${agent.description ? `
 Description: ${agent.description}` : ""}
-Session: ${agent.session_id ?? "unbound"}
-Pool: [${pool.join(", ")}]
+Session: ${agent.session_id ?? "unbound"}${poolLine}
 Created: ${agent.created_at}
 Last seen: ${agent.last_seen_at}`
         }]
@@ -9267,21 +9264,32 @@ Last seen: ${agent.last_seen_at}`
   });
 }
 if (shouldRegisterTool("suggest_agent_name")) {
-  server.tool("suggest_agent_name", "Get available agent names for a project. Call this before register_agent to avoid conflicts.", {
-    working_dir: exports_external.string().optional().describe("Your working directory \u2014 used to look up the project's allowed name pool")
+  server.tool("suggest_agent_name", "Get available agent names for a project. Shows configured pool, active agents, and suggestions. If no pool is configured, any name is allowed.", {
+    working_dir: exports_external.string().optional().describe("Your working directory \u2014 used to look up the project's allowed name pool from config")
   }, async ({ working_dir }) => {
     try {
       const pool = getAgentPoolForProject(working_dir);
-      const available = getAvailableNamesFromPool(pool, getDatabase());
       const cutoff = new Date(Date.now() - 30 * 60 * 1000).toISOString();
-      const active = listAgents().filter((a) => a.last_seen_at > cutoff && pool.map((n) => n.toLowerCase()).includes(a.name));
+      const allActive = listAgents().filter((a) => a.last_seen_at > cutoff);
+      if (!pool) {
+        const lines2 = [
+          "No agent pool configured \u2014 any name is allowed.",
+          allActive.length > 0 ? `Active agents (avoid these names): ${allActive.map((a) => `${a.name} (seen ${Math.round((Date.now() - new Date(a.last_seen_at).getTime()) / 60000)}m ago)`).join(", ")}` : "No active agents.",
+          `
+To restrict names, configure agent_pool or project_pools in ~/.todos/config.json`
+        ];
+        return { content: [{ type: "text", text: lines2.join(`
+`) }] };
+      }
+      const available = getAvailableNamesFromPool(pool, getDatabase());
+      const activeInPool = allActive.filter((a) => pool.map((n) => n.toLowerCase()).includes(a.name));
       const lines = [
         `Project pool: ${pool.join(", ")}`,
         `Available now (${available.length}): ${available.length > 0 ? available.join(", ") : "none \u2014 all names in use"}`,
-        active.length > 0 ? `Active agents: ${active.map((a) => `${a.name} (seen ${Math.round((Date.now() - new Date(a.last_seen_at).getTime()) / 60000)}m ago)`).join(", ")}` : "Active agents: none",
+        activeInPool.length > 0 ? `Active agents: ${activeInPool.map((a) => `${a.name} (seen ${Math.round((Date.now() - new Date(a.last_seen_at).getTime()) / 60000)}m ago)`).join(", ")}` : "Active agents: none",
         available.length > 0 ? `
 Suggested: ${available[0]}` : `
-No names available yet. Wait for an active agent to go stale (30min timeout).`
+No names available. Wait for an active agent to go stale (30min timeout).`
       ];
       return { content: [{ type: "text", text: lines.join(`
 `) }] };
@@ -9291,14 +9299,17 @@ No names available yet. Wait for an active agent to go stale (30min timeout).`
   });
 }
 if (shouldRegisterTool("list_agents")) {
-  server.tool("list_agents", "List all registered agents", {}, async () => {
+  server.tool("list_agents", "List all registered agents. By default shows only active agents \u2014 set include_archived to see archived ones too.", {
+    include_archived: exports_external.boolean().optional().describe("Include archived agents in the list (default: false)")
+  }, async ({ include_archived }) => {
     try {
-      const agents = listAgents();
+      const agents = listAgents({ include_archived: include_archived ?? false });
       if (agents.length === 0) {
         return { content: [{ type: "text", text: "No agents registered." }] };
       }
       const text = agents.map((a) => {
-        return `${a.id} | ${a.name}${a.description ? ` - ${a.description}` : ""} (last seen: ${a.last_seen_at})`;
+        const statusTag = a.status === "archived" ? " [archived]" : "";
+        return `${a.id} | ${a.name}${statusTag}${a.description ? ` - ${a.description}` : ""} (last seen: ${a.last_seen_at})`;
       }).join(`
 `);
       return { content: [{ type: "text", text: `${agents.length} agent(s):
@@ -9366,7 +9377,7 @@ ID: ${updated.id}`
   });
 }
 if (shouldRegisterTool("delete_agent")) {
-  server.tool("delete_agent", "Delete an agent permanently. Resolve by id or name.", {
+  server.tool("delete_agent", "Archive an agent (soft delete). The agent is hidden from list_agents but preserved for task history. Use unarchive_agent to restore. Resolve by id or name.", {
     id: exports_external.string().optional(),
     name: exports_external.string().optional()
   }, async ({ id, name }) => {
@@ -9378,13 +9389,63 @@ if (shouldRegisterTool("delete_agent")) {
       if (!agent) {
         return { content: [{ type: "text", text: `Agent not found: ${id || name}` }], isError: true };
       }
-      const deleted = deleteAgent(agent.id);
+      const archived = archiveAgent(agent.id);
       return {
         content: [{
           type: "text",
-          text: deleted ? `Agent deleted: ${agent.name} (${agent.id})` : `Failed to delete agent: ${agent.name}`
+          text: archived ? `Agent archived: ${agent.name} (${agent.id}). Use unarchive_agent to restore.` : `Failed to archive agent: ${agent.name}`
         }],
-        isError: !deleted
+        isError: !archived
+      };
+    } catch (e) {
+      return { content: [{ type: "text", text: formatError(e) }], isError: true };
+    }
+  });
+}
+if (shouldRegisterTool("unarchive_agent")) {
+  server.tool("unarchive_agent", "Restore an archived agent back to active status. Resolve by id or name.", {
+    id: exports_external.string().optional(),
+    name: exports_external.string().optional()
+  }, async ({ id, name }) => {
+    try {
+      if (!id && !name) {
+        return { content: [{ type: "text", text: "Provide either id or name." }], isError: true };
+      }
+      const agent = id ? getAgent(id) : getAgentByName(name);
+      if (!agent) {
+        return { content: [{ type: "text", text: `Agent not found: ${id || name}` }], isError: true };
+      }
+      if (agent.status === "active") {
+        return { content: [{ type: "text", text: `Agent ${agent.name} is already active.` }] };
+      }
+      const restored = unarchiveAgent(agent.id);
+      return {
+        content: [{
+          type: "text",
+          text: restored ? `Agent restored: ${agent.name} (${agent.id}) is now active.` : `Failed to restore agent: ${agent.name}`
+        }],
+        isError: !restored
+      };
+    } catch (e) {
+      return { content: [{ type: "text", text: formatError(e) }], isError: true };
+    }
+  });
+}
+if (shouldRegisterTool("heartbeat")) {
+  server.tool("heartbeat", "Update your last_seen_at timestamp to signal you're still active. Call periodically during long tasks to prevent being marked stale.", {
+    agent_id: exports_external.string().describe("Your agent ID or name.")
+  }, async ({ agent_id }) => {
+    try {
+      const agent = getAgent(agent_id) || getAgentByName(agent_id);
+      if (!agent) {
+        return { content: [{ type: "text", text: `Agent not found: ${agent_id}` }], isError: true };
+      }
+      updateAgentActivity(agent.id);
+      return {
+        content: [{
+          type: "text",
+          text: `Heartbeat: ${agent.name} (${agent.id}) \u2014 last_seen_at updated to ${new Date().toISOString()}`
+        }]
       };
     } catch (e) {
       return { content: [{ type: "text", text: formatError(e) }], isError: true };
@@ -10487,6 +10548,8 @@ if (shouldRegisterTool("search_tools")) {
       "get_agent",
       "rename_agent",
       "delete_agent",
+      "unarchive_agent",
+      "heartbeat",
       "get_my_tasks",
       "get_org_chart",
       "set_reports_to",
@@ -10624,22 +10687,30 @@ if (shouldRegisterTool("describe_tools")) {
       delete_plan: `Delete a plan. Tasks in the plan are orphaned, not deleted.
   Params: id(string, req)
   Example: {id: 'a1b2c3d4'}`,
-      suggest_agent_name: `Get available agent names for your project before registering. Shows the pool, which names are active, and the best suggestion.
-  Params: working_dir(string \u2014 your working directory, used to look up project pool)
+      suggest_agent_name: `Check available agent names before registering. Shows active agents and, if a pool is configured, which pool names are free.
+  Params: working_dir(string \u2014 your working directory, used to look up project pool from config)
   Example: {working_dir: '/workspace/platform'}`,
-      register_agent: `Register an agent. Name must be from the project's pool (call suggest_agent_name first). Returns CONFLICT or POOL_VIOLATION with suggestions if name is taken or not allowed.
-  Params: name(string, req), description(string), session_id(string \u2014 unique per session, e.g. PID+timestamp), working_dir(string, req \u2014 used to determine project pool)
-  Example: {name: 'cassius', session_id: 'abc123-1741952000', working_dir: '/workspace/platform'}`,
-      list_agents: "List all registered agents with IDs, names, and last seen timestamps. No params.",
+      register_agent: `Register an agent. Any name is allowed \u2014 pool is advisory. Returns CONFLICT if name is held by a recently-active agent.
+  Params: name(string, req), description(string), capabilities(string[]), session_id(string \u2014 unique per session), working_dir(string \u2014 used to determine project pool)
+  Example: {name: 'my-agent', session_id: 'abc123-1741952000', working_dir: '/workspace/platform'}`,
+      list_agents: `List all registered agents (active by default). Set include_archived: true to see archived agents.
+  Params: include_archived(boolean, optional)
+  Example: {include_archived: true}`,
       get_agent: `Get agent details by ID or name. Provide one of id or name.
   Params: id(string), name(string)
   Example: {name: 'maximus'}`,
       rename_agent: `Rename an agent. Resolve by id or current name.
   Params: id(string), name(string \u2014 current name), new_name(string, req)
   Example: {name: 'old-name', new_name: 'new-name'}`,
-      delete_agent: `Delete an agent permanently. Resolve by id or name.
+      delete_agent: `Archive an agent (soft delete). Agent is preserved for task history but hidden from list_agents. Use unarchive_agent to restore.
+  Params: id(string), name(string)
+  Example: {name: 'maximus'}`,
+      unarchive_agent: `Restore an archived agent back to active status.
   Params: id(string), name(string)
   Example: {name: 'maximus'}`,
+      heartbeat: `Update last_seen_at timestamp to signal you're still active. Call periodically during long tasks.
+  Params: agent_id(string, req \u2014 your agent ID or name)
+  Example: {agent_id: 'maximus'}`,
       get_my_tasks: `Get all tasks assigned to/created by an agent, with stats (pending/active/done/rate).
   Params: agent_name(string, req)
   Example: {agent_name: 'maximus'}`,

package/dist/server/index.js

@@ -1,21 +1,6 @@
 #!/usr/bin/env bun
 // @bun
-var __create = Object.create;
-var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __toESM = (mod, isNodeMode, target) => {
-  target = mod != null ? __create(__getProtoOf(mod)) : {};
-  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
-  for (let key of __getOwnPropNames(mod))
-    if (!__hasOwnProp.call(to, key))
-      __defProp(to, key, {
-        get: () => mod[key],
-        enumerable: true
-      });
-  return to;
-};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
@@ -234,6 +219,7 @@ function ensureSchema(db) {
     CREATE TABLE agents (
       id TEXT PRIMARY KEY, name TEXT NOT NULL UNIQUE, description TEXT,
       role TEXT DEFAULT 'agent', permissions TEXT DEFAULT '["*"]',
+      status TEXT NOT NULL DEFAULT 'active' CHECK(status IN ('active', 'archived')),
       metadata TEXT DEFAULT '{}',
       created_at TEXT NOT NULL DEFAULT (datetime('now')),
       last_seen_at TEXT NOT NULL DEFAULT (datetime('now'))
@@ -863,6 +849,11 @@ var init_database = __esm(() => {
     `
   ALTER TABLE agents ADD COLUMN capabilities TEXT DEFAULT '[]';
   INSERT OR IGNORE INTO _migrations (id) VALUES (29);
+  `,
+    `
+  ALTER TABLE agents ADD COLUMN status TEXT NOT NULL DEFAULT 'active' CHECK(status IN ('active', 'archived'));
+  CREATE INDEX IF NOT EXISTS idx_agents_status ON agents(status);
+  INSERT OR IGNORE INTO _migrations (id) VALUES (30);
   `
   ];
 });
@@ -2477,6 +2468,7 @@ var exports_agents = {};
 __export(exports_agents, {
   updateAgentActivity: () => updateAgentActivity,
   updateAgent: () => updateAgent,
+  unarchiveAgent: () => unarchiveAgent,
   registerAgent: () => registerAgent,
   matchCapabilities: () => matchCapabilities,
   listAgents: () => listAgents,
@@ -2487,11 +2479,12 @@ __export(exports_agents, {
   getAvailableNamesFromPool: () => getAvailableNamesFromPool,
   getAgentByName: () => getAgentByName,
   getAgent: () => getAgent,
-  deleteAgent: () => deleteAgent
+  deleteAgent: () => deleteAgent,
+  archiveAgent: () => archiveAgent
 });
 function getAvailableNamesFromPool(pool, db) {
   const cutoff = new Date(Date.now() - AGENT_ACTIVE_WINDOW_MS).toISOString();
-  const activeNames = new Set(db.query("SELECT name FROM agents WHERE last_seen_at > ?").all(cutoff).map((r) => r.name.toLowerCase()));
+  const activeNames = new Set(db.query("SELECT name FROM agents WHERE status = 'active' AND last_seen_at > ?").all(cutoff).map((r) => r.name.toLowerCase()));
   return pool.filter((name) => !activeNames.has(name.toLowerCase()));
 }
 function shortUuid() {
@@ -2502,30 +2495,13 @@ function rowToAgent(row) {
     ...row,
     permissions: JSON.parse(row.permissions || '["*"]'),
     capabilities: JSON.parse(row.capabilities || "[]"),
+    status: row.status || "active",
     metadata: JSON.parse(row.metadata || "{}")
   };
 }
 function registerAgent(input, db) {
   const d = db || getDatabase();
   const normalizedName = input.name.trim().toLowerCase();
-  if (input.pool && input.pool.length > 0) {
-    const poolLower = input.pool.map((n) => n.toLowerCase());
-    if (!poolLower.includes(normalizedName)) {
-      const available = getAvailableNamesFromPool(input.pool, d);
-      const suggestion = available.length > 0 ? available[0] : null;
-      return {
-        conflict: true,
-        pool_violation: true,
-        existing_id: "",
-        existing_name: normalizedName,
-        last_seen_at: "",
-        session_hint: null,
-        working_dir: input.working_dir || null,
-        suggestions: available.slice(0, 5),
-        message: `"${normalizedName}" is not in this project's agent pool [${input.pool.join(", ")}]. ${available.length > 0 ? `Try: ${available.slice(0, 3).join(", ")}` : "No names are currently available \u2014 wait for an active agent to go stale."}${suggestion ? ` Suggested: ${suggestion}` : ""}`
-      };
-    }
-  }
   const existing = getAgentByName(normalizedName, d);
   if (existing) {
     const lastSeenMs = new Date(existing.last_seen_at).getTime();
@@ -2546,7 +2522,7 @@ function registerAgent(input, db) {
         message: `Agent "${normalizedName}" is already active (last seen ${minutesAgo}m ago, session ${existing.session_id?.slice(0, 8)}\u2026, dir: ${existing.working_dir ?? "unknown"}). Are you that agent? If so, pass session_id="${existing.session_id}" to reclaim it. Otherwise choose a different name.${suggestions.length > 0 ? ` Available: ${suggestions.slice(0, 3).join(", ")}` : ""}`
       };
     }
-    const updates = ["last_seen_at = ?"];
+    const updates = ["last_seen_at = ?", "status = 'active'"];
     const params = [now()];
     if (input.session_id && !sameSession) {
       updates.push("session_id = ?");
@@ -2600,9 +2576,19 @@ function getAgentByName(name, db) {
   const row = d.query("SELECT * FROM agents WHERE LOWER(name) = ?").get(normalizedName);
   return row ? rowToAgent(row) : null;
 }
-function listAgents(db) {
-  const d = db || getDatabase();
-  return d.query("SELECT * FROM agents ORDER BY name").all().map(rowToAgent);
+function listAgents(opts, db) {
+  let d;
+  let includeArchived = false;
+  if (opts && typeof opts === "object" && "query" in opts) {
+    d = opts;
+  } else {
+    includeArchived = opts?.include_archived ?? false;
+    d = db || getDatabase();
+  }
+  if (includeArchived) {
+    return d.query("SELECT * FROM agents ORDER BY name").all().map(rowToAgent);
+  }
+  return d.query("SELECT * FROM agents WHERE status = 'active' ORDER BY name").all().map(rowToAgent);
 }
 function updateAgentActivity(id, db) {
   const d = db || getDatabase();
@@ -2661,7 +2647,17 @@ function updateAgent(id, input, db) {
 }
 function deleteAgent(id, db) {
   const d = db || getDatabase();
-  return d.run("DELETE FROM agents WHERE id = ?", [id]).changes > 0;
+  return d.run("UPDATE agents SET status = 'archived', last_seen_at = ? WHERE id = ?", [now(), id]).changes > 0;
+}
+function archiveAgent(id, db) {
+  const d = db || getDatabase();
+  d.run("UPDATE agents SET status = 'archived', last_seen_at = ? WHERE id = ?", [now(), id]);
+  return getAgent(id, d);
+}
+function unarchiveAgent(id, db) {
+  const d = db || getDatabase();
+  d.run("UPDATE agents SET status = 'active', last_seen_at = ? WHERE id = ?", [now(), id]);
+  return getAgent(id, d);
 }
 function getDirectReports(agentId, db) {
   const d = db || getDatabase();
@@ -3807,6 +3803,7 @@ async function main() {
   if (port !== requestedPort) {
     console.log(`Port ${requestedPort} in use, using ${port}`);
   }
-  startServer(port);
+  const noOpen = process.argv.includes("--no-open") || process.env["TODOS_NO_OPEN"] === "true";
+  startServer(port, { open: !noOpen });
 }
 main();

package/dist/types/index.d.ts

@@ -92,6 +92,7 @@ export interface UpdatePlanInput {
     task_list_id?: string;
     agent_id?: string;
 }
+export type AgentStatus = "active" | "archived";
 export interface Agent {
     id: string;
     name: string;
@@ -103,6 +104,7 @@ export interface Agent {
     reports_to: string | null;
     org_id: string | null;
     capabilities: string[];
+    status: AgentStatus;
     metadata: Record<string, unknown>;
     created_at: string;
     last_seen_at: string;
@@ -120,6 +122,7 @@ export interface AgentRow {
     capabilities: string | null;
     reports_to: string | null;
     org_id: string | null;
+    status: string;
     metadata: string | null;
     created_at: string;
     last_seen_at: string;
@@ -151,7 +154,6 @@ export interface AgentConflictError {
     working_dir: string | null;
     message: string;
     suggestions?: string[];
-    pool_violation?: true;
 }
 export interface TaskList {
     id: string;