@hasna/todos 0.9.73 → 0.9.75

package/dist/mcp/index.js

@@ -1,6 +1,23 @@
 #!/usr/bin/env bun
 // @bun
 var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
@@ -181,6 +198,18 @@ function ensureSchema(db) {
       metadata TEXT DEFAULT '{}',
       created_at TEXT NOT NULL DEFAULT (datetime('now'))
     )`);
+  ensureTable("project_sources", `
+    CREATE TABLE project_sources (
+      id TEXT PRIMARY KEY,
+      project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+      type TEXT NOT NULL,
+      name TEXT NOT NULL,
+      uri TEXT NOT NULL,
+      description TEXT,
+      metadata TEXT DEFAULT '{}',
+      created_at TEXT NOT NULL DEFAULT (datetime('now')),
+      updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+    )`);
   ensureColumn("projects", "task_list_id", "TEXT");
   ensureColumn("projects", "task_prefix", "TEXT");
   ensureColumn("projects", "task_counter", "INTEGER NOT NULL DEFAULT 0");
@@ -194,6 +223,9 @@ function ensureSchema(db) {
   ensureColumn("tasks", "approved_at", "TEXT");
   ensureColumn("tasks", "recurrence_rule", "TEXT");
   ensureColumn("tasks", "recurrence_parent_id", "TEXT REFERENCES tasks(id) ON DELETE SET NULL");
+  ensureColumn("tasks", "confidence", "REAL");
+  ensureColumn("tasks", "reason", "TEXT");
+  ensureColumn("tasks", "spawned_from_session", "TEXT");
   ensureColumn("agents", "role", "TEXT DEFAULT 'agent'");
   ensureColumn("agents", "permissions", `TEXT DEFAULT '["*"]'`);
   ensureColumn("agents", "reports_to", "TEXT");
@@ -222,6 +254,8 @@ function ensureSchema(db) {
   ensureIndex("CREATE INDEX IF NOT EXISTS idx_task_history_agent ON task_history(agent_id)");
   ensureIndex("CREATE INDEX IF NOT EXISTS idx_tasks_recurrence_parent ON tasks(recurrence_parent_id)");
   ensureIndex("CREATE INDEX IF NOT EXISTS idx_tasks_recurrence_rule ON tasks(recurrence_rule) WHERE recurrence_rule IS NOT NULL");
+  ensureIndex("CREATE INDEX IF NOT EXISTS idx_project_sources_project ON project_sources(project_id)");
+  ensureIndex("CREATE INDEX IF NOT EXISTS idx_project_sources_type ON project_sources(type)");
 }
 function backfillTaskTags(db) {
   try {
@@ -590,6 +624,45 @@ var init_database = __esm(() => {
   ALTER TABLE agents ADD COLUMN session_id TEXT;
   ALTER TABLE agents ADD COLUMN working_dir TEXT;
   INSERT OR IGNORE INTO _migrations (id) VALUES (17);
+  `,
+    `
+  ALTER TABLE tasks ADD COLUMN confidence REAL;
+  INSERT OR IGNORE INTO _migrations (id) VALUES (18);
+  `,
+    `
+  ALTER TABLE tasks ADD COLUMN reason TEXT;
+  ALTER TABLE tasks ADD COLUMN spawned_from_session TEXT;
+  INSERT OR IGNORE INTO _migrations (id) VALUES (19);
+  `,
+    `
+  CREATE TABLE IF NOT EXISTS handoffs (
+    id TEXT PRIMARY KEY,
+    agent_id TEXT,
+    project_id TEXT REFERENCES projects(id) ON DELETE SET NULL,
+    summary TEXT NOT NULL,
+    completed TEXT,
+    in_progress TEXT,
+    blockers TEXT,
+    next_steps TEXT,
+    created_at TEXT NOT NULL
+  );
+  INSERT OR IGNORE INTO _migrations (id) VALUES (20);
+  `,
+    `
+  CREATE TABLE IF NOT EXISTS project_sources (
+    id TEXT PRIMARY KEY,
+    project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+    type TEXT NOT NULL,
+    name TEXT NOT NULL,
+    uri TEXT NOT NULL,
+    description TEXT,
+    metadata TEXT DEFAULT '{}',
+    created_at TEXT NOT NULL DEFAULT (datetime('now')),
+    updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+  CREATE INDEX IF NOT EXISTS idx_project_sources_project ON project_sources(project_id);
+  CREATE INDEX IF NOT EXISTS idx_project_sources_type ON project_sources(type);
+  INSERT OR IGNORE INTO _migrations (id) VALUES (21);
   `
   ];
 });
@@ -921,6 +994,77 @@ var init_agents = __esm(() => {
   AGENT_ACTIVE_WINDOW_MS = 30 * 60 * 1000;
 });
 
+// src/db/handoffs.ts
+var exports_handoffs = {};
+__export(exports_handoffs, {
+  listHandoffs: () => listHandoffs,
+  getLatestHandoff: () => getLatestHandoff,
+  createHandoff: () => createHandoff
+});
+function createHandoff(input, db) {
+  const d = db || getDatabase();
+  const id = uuid();
+  const timestamp = now();
+  d.run(`INSERT INTO handoffs (id, agent_id, project_id, summary, completed, in_progress, blockers, next_steps, created_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+    id,
+    input.agent_id || null,
+    input.project_id || null,
+    input.summary,
+    input.completed ? JSON.stringify(input.completed) : null,
+    input.in_progress ? JSON.stringify(input.in_progress) : null,
+    input.blockers ? JSON.stringify(input.blockers) : null,
+    input.next_steps ? JSON.stringify(input.next_steps) : null,
+    timestamp
+  ]);
+  return {
+    id,
+    agent_id: input.agent_id || null,
+    project_id: input.project_id || null,
+    summary: input.summary,
+    completed: input.completed || null,
+    in_progress: input.in_progress || null,
+    blockers: input.blockers || null,
+    next_steps: input.next_steps || null,
+    created_at: timestamp
+  };
+}
+function rowToHandoff(row) {
+  return {
+    ...row,
+    completed: row.completed ? JSON.parse(row.completed) : null,
+    in_progress: row.in_progress ? JSON.parse(row.in_progress) : null,
+    blockers: row.blockers ? JSON.parse(row.blockers) : null,
+    next_steps: row.next_steps ? JSON.parse(row.next_steps) : null
+  };
+}
+function listHandoffs(projectId, limit = 10, db) {
+  const d = db || getDatabase();
+  if (projectId) {
+    return d.query("SELECT * FROM handoffs WHERE project_id = ? ORDER BY rowid DESC LIMIT ?").all(projectId, limit).map(rowToHandoff);
+  }
+  return d.query("SELECT * FROM handoffs ORDER BY rowid DESC LIMIT ?").all(limit).map(rowToHandoff);
+}
+function getLatestHandoff(agentId, projectId, db) {
+  const d = db || getDatabase();
+  let query = "SELECT * FROM handoffs WHERE 1=1";
+  const params = [];
+  if (agentId) {
+    query += " AND agent_id = ?";
+    params.push(agentId);
+  }
+  if (projectId) {
+    query += " AND project_id = ?";
+    params.push(projectId);
+  }
+  query += " ORDER BY rowid DESC LIMIT 1";
+  const row = d.query(query).get(...params);
+  return row ? rowToHandoff(row) : null;
+}
+var init_handoffs = __esm(() => {
+  init_database();
+});
+
 // src/mcp/index.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -5055,6 +5199,40 @@ function listProjects(db) {
   const d = db || getDatabase();
   return d.query("SELECT * FROM projects ORDER BY name").all();
 }
+function rowToSource(row) {
+  return {
+    ...row,
+    metadata: row.metadata ? JSON.parse(row.metadata) : {}
+  };
+}
+function addProjectSource(input, db) {
+  const d = db || getDatabase();
+  const id = uuid();
+  const timestamp = now();
+  d.run(`INSERT INTO project_sources (id, project_id, type, name, uri, description, metadata, created_at, updated_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+    id,
+    input.project_id,
+    input.type,
+    input.name,
+    input.uri,
+    input.description || null,
+    JSON.stringify(input.metadata || {}),
+    timestamp,
+    timestamp
+  ]);
+  return rowToSource(d.query("SELECT * FROM project_sources WHERE id = ?").get(id));
+}
+function removeProjectSource(id, db) {
+  const d = db || getDatabase();
+  const result = d.run("DELETE FROM project_sources WHERE id = ?", [id]);
+  return result.changes > 0;
+}
+function listProjectSources(projectId, db) {
+  const d = db || getDatabase();
+  const rows = d.query("SELECT * FROM project_sources WHERE project_id = ? ORDER BY name").all(projectId);
+  return rows.map(rowToSource);
+}
 function nextTaskShortId(projectId, db) {
   const d = db || getDatabase();
   const project = getProject(projectId, d);
@@ -5349,8 +5527,8 @@ function createTask(input, db) {
   const tags = input.tags || [];
   const shortId = input.project_id ? nextTaskShortId(input.project_id, d) : null;
   const title = shortId ? `${shortId}: ${input.title}` : input.title;
-  d.run(`INSERT INTO tasks (id, short_id, project_id, parent_id, plan_id, task_list_id, title, description, status, priority, agent_id, assigned_to, session_id, working_dir, tags, metadata, version, created_at, updated_at, due_at, estimated_minutes, requires_approval, approved_by, approved_at, recurrence_rule, recurrence_parent_id, spawns_template_id)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+  d.run(`INSERT INTO tasks (id, short_id, project_id, parent_id, plan_id, task_list_id, title, description, status, priority, agent_id, assigned_to, session_id, working_dir, tags, metadata, version, created_at, updated_at, due_at, estimated_minutes, requires_approval, approved_by, approved_at, recurrence_rule, recurrence_parent_id, spawns_template_id, reason, spawned_from_session)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
     id,
     shortId,
     input.project_id || null,
@@ -5376,7 +5554,9 @@ function createTask(input, db) {
     null,
     input.recurrence_rule || null,
     input.recurrence_parent_id || null,
-    input.spawns_template_id || null
+    input.spawns_template_id || null,
+    input.reason || null,
+    input.spawned_from_session || null
   ]);
   if (tags.length > 0) {
     insertTaskTags(id, tags, d);
@@ -5733,13 +5913,21 @@ function completeTask(id, agentId, db, options) {
   checkCompletionGuard(task, agentId || null, d);
   const evidence = options ? { files_changed: options.files_changed, test_results: options.test_results, commit_hash: options.commit_hash, notes: options.notes, attachment_ids: options.attachment_ids } : undefined;
   const hasEvidence = evidence && (evidence.files_changed || evidence.test_results || evidence.commit_hash || evidence.notes || evidence.attachment_ids);
-  if (hasEvidence) {
-    const meta2 = { ...task.metadata, _evidence: evidence };
+  const completionMeta = {};
+  if (hasEvidence)
+    completionMeta._evidence = evidence;
+  if (options?.confidence !== undefined) {
+    completionMeta._completion = { confidence: options.confidence };
+  }
+  const hasMeta = Object.keys(completionMeta).length > 0;
+  if (hasMeta) {
+    const meta2 = { ...task.metadata, ...completionMeta };
     d.run("UPDATE tasks SET metadata = ? WHERE id = ?", [JSON.stringify(meta2), id]);
   }
   const timestamp = now();
-  d.run(`UPDATE tasks SET status = 'completed', locked_by = NULL, locked_at = NULL, completed_at = ?, version = version + 1, updated_at = ?
-     WHERE id = ?`, [timestamp, timestamp, id]);
+  const confidence = options?.confidence !== undefined ? options.confidence : null;
+  d.run(`UPDATE tasks SET status = 'completed', locked_by = NULL, locked_at = NULL, completed_at = ?, confidence = ?, version = version + 1, updated_at = ?
+     WHERE id = ?`, [timestamp, confidence, timestamp, id]);
   logTaskChange(id, "complete", "status", task.status, "completed", agentId || null, d);
   dispatchWebhook("task.completed", { id, agent_id: agentId, title: task.title, completed_at: timestamp }, d).catch(() => {});
   let spawnedTask = null;
@@ -5758,14 +5946,14 @@ function completeTask(id, agentId, db, options) {
       spawnedFromTemplate = createTask(input, d);
     } catch {}
   }
-  const meta = hasEvidence ? { ...task.metadata, _evidence: evidence } : task.metadata;
+  const meta = hasMeta ? { ...task.metadata, ...completionMeta } : task.metadata;
   if (spawnedTask) {
     meta._next_recurrence = { id: spawnedTask.id, short_id: spawnedTask.short_id, due_at: spawnedTask.due_at };
   }
   if (spawnedFromTemplate) {
     meta._spawned_task = { id: spawnedFromTemplate.id, short_id: spawnedFromTemplate.short_id, title: spawnedFromTemplate.title };
   }
-  return { ...task, status: "completed", locked_by: null, locked_at: null, completed_at: timestamp, version: task.version + 1, updated_at: timestamp, metadata: meta };
+  return { ...task, status: "completed", locked_by: null, locked_at: null, completed_at: timestamp, confidence, version: task.version + 1, updated_at: timestamp, metadata: meta };
 }
 function lockTask(id, agentId, db) {
   const d = db || getDatabase();
@@ -6212,6 +6400,20 @@ function setTaskPriority(id, priority, _agentId, db) {
   }
   throw new Error(`Failed to set priority after 3 attempts`);
 }
+function redistributeStaleTasks(agentId, options, db) {
+  const d = db || getDatabase();
+  const maxAge = options?.max_age_minutes ?? 60;
+  const stale = getStaleTasks(maxAge, options?.project_id ? { project_id: options.project_id } : undefined, d);
+  const limited = options?.limit ? stale.slice(0, options.limit) : stale;
+  const timestamp = now();
+  const released = [];
+  for (const t of limited) {
+    d.run(`UPDATE tasks SET locked_by = NULL, locked_at = NULL, status = 'pending', version = version + 1, updated_at = ? WHERE id = ?`, [timestamp, t.id]);
+    released.push({ ...t, locked_by: null, locked_at: null, status: "pending" });
+  }
+  const claimed = released.length > 0 ? claimNextTask(agentId, options?.project_id ? { project_id: options.project_id } : undefined, d) : null;
+  return { released, claimed };
+}
 function wouldCreateCycle(taskId, dependsOn, db) {
   const visited = new Set;
   const queue = [dependsOn];
@@ -7268,7 +7470,9 @@ if (shouldRegisterTool("create_task")) {
     estimated_minutes: exports_external.number().optional(),
     requires_approval: exports_external.boolean().optional(),
     recurrence_rule: exports_external.string().optional(),
-    spawns_template_id: exports_external.string().optional().describe("Template ID to auto-create as next task when this task is completed (pipeline/handoff chains)")
+    spawns_template_id: exports_external.string().optional().describe("Template ID to auto-create as next task when this task is completed (pipeline/handoff chains)"),
+    reason: exports_external.string().optional().describe("Why this task exists \u2014 context for agents picking it up"),
+    spawned_from_session: exports_external.string().optional().describe("Session ID that created this task (for tracing task lineage)")
   }, async (params) => {
     try {
       const resolved = { ...params };
@@ -7483,12 +7687,13 @@ if (shouldRegisterTool("complete_task")) {
     test_results: exports_external.string().optional().describe("Summary of test results"),
     commit_hash: exports_external.string().optional().describe("Git commit hash associated with this completion"),
     notes: exports_external.string().optional().describe("Notes about the completion"),
-    attachment_ids: exports_external.array(exports_external.string()).optional().describe("IDs of attachments uploaded via @hasna/attachments to link as evidence")
-  }, async ({ id, agent_id, skip_recurrence, files_changed, test_results, commit_hash, notes, attachment_ids }) => {
+    attachment_ids: exports_external.array(exports_external.string()).optional().describe("IDs of attachments uploaded via @hasna/attachments to link as evidence"),
+    confidence: exports_external.number().min(0).max(1).optional().describe("Agent's confidence 0.0-1.0 that the task is fully complete. Default: 1.0. Low confidence (<0.7) is flagged as a signal for review.")
+  }, async ({ id, agent_id, skip_recurrence, files_changed, test_results, commit_hash, notes, attachment_ids, confidence }) => {
     try {
       const resolvedId = resolveId(id);
       const evidence = files_changed || test_results || commit_hash || notes || attachment_ids ? { files_changed, test_results, commit_hash, notes, attachment_ids } : undefined;
-      const task = completeTask(resolvedId, agent_id, undefined, { skip_recurrence, ...evidence });
+      const task = completeTask(resolvedId, agent_id, undefined, { skip_recurrence, confidence, ...evidence });
       let text = `completed: ${formatTask(task)}`;
       if (task.metadata._next_recurrence) {
         const next = task.metadata._next_recurrence;
@@ -7640,6 +7845,65 @@ if (shouldRegisterTool("create_project")) {
     }
   });
 }
+if (shouldRegisterTool("add_project_source")) {
+  server.tool("add_project_source", "Add a data source to a project (S3 bucket, Google Drive folder, local path, GitHub repo, Notion page, etc.). Sources are revealed to agents when they load the project.", {
+    project_id: exports_external.string().describe("Project ID"),
+    type: exports_external.string().describe("Source type: 's3', 'gdrive', 'local', 'github', 'notion', 'http', or any custom label"),
+    name: exports_external.string().describe("Human-readable label for this source"),
+    uri: exports_external.string().describe("The source URI (bucket path, folder URL, local path, repo URL, etc.)"),
+    description: exports_external.string().optional().describe("What this source contains or how agents should use it"),
+    metadata: exports_external.record(exports_external.unknown()).optional().describe("Extra config (e.g. region, access role, subfolder)")
+  }, async (params) => {
+    try {
+      const resolvedProjectId = resolveId(params.project_id, "projects");
+      const source = addProjectSource({ ...params, project_id: resolvedProjectId });
+      return {
+        content: [{
+          type: "text",
+          text: `Source added: ${source.id.slice(0, 8)} | [${source.type}] ${source.name} \u2192 ${source.uri}`
+        }]
+      };
+    } catch (e) {
+      return { content: [{ type: "text", text: formatError(e) }], isError: true };
+    }
+  });
+}
+if (shouldRegisterTool("remove_project_source")) {
+  server.tool("remove_project_source", "Remove a data source from a project by source ID.", {
+    source_id: exports_external.string().describe("Source ID to remove")
+  }, async ({ source_id }) => {
+    try {
+      const db = getDatabase();
+      const row = db.query("SELECT * FROM project_sources WHERE id LIKE ?").get(`${source_id}%`);
+      if (!row)
+        return { content: [{ type: "text", text: `Source not found: ${source_id}` }], isError: true };
+      removeProjectSource(row.id);
+      return { content: [{ type: "text", text: `Source removed: ${row.name}` }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: formatError(e) }], isError: true };
+    }
+  });
+}
+if (shouldRegisterTool("list_project_sources")) {
+  server.tool("list_project_sources", "List all data sources attached to a project.", {
+    project_id: exports_external.string().describe("Project ID")
+  }, async ({ project_id }) => {
+    try {
+      const resolvedId = resolveId(project_id, "projects");
+      const sources = listProjectSources(resolvedId);
+      if (sources.length === 0) {
+        return { content: [{ type: "text", text: "No sources configured for this project." }] };
+      }
+      const lines = sources.map((s) => `${s.id.slice(0, 8)} | [${s.type}] ${s.name} \u2192 ${s.uri}${s.description ? `
+  ${s.description}` : ""}`);
+      return { content: [{ type: "text", text: `${sources.length} source(s):
+${lines.join(`
+`)}` }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: formatError(e) }], isError: true };
+    }
+  });
+}
 if (shouldRegisterTool("create_plan")) {
   server.tool("create_plan", "Create a plan to group related tasks.", {
     name: exports_external.string(),
@@ -8956,6 +9220,42 @@ if (shouldRegisterTool("bootstrap")) {
           lines.push(`Other agents active: ${others.slice(0, 3).map((w) => `${w.short_id || w.id.slice(0, 8)} (${w.assigned_to || "?"})`).join(", ")}`);
         }
       }
+      if (project_id) {
+        const resolvedId = resolveId(project_id, "projects");
+        const sources = listProjectSources(resolvedId);
+        if (sources.length > 0) {
+          lines.push("");
+          lines.push(`## Data Sources`);
+          for (const s of sources) {
+            lines.push(`[${s.type}] ${s.name}: ${s.uri}${s.description ? ` \u2014 ${s.description}` : ""}`);
+          }
+        }
+      }
+      lines.push(`
+as_of: ${new Date().toISOString()}`);
+      return { content: [{ type: "text", text: lines.join(`
+`) }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: formatError(e) }], isError: true };
+    }
+  });
+}
+if (shouldRegisterTool("redistribute_stale_tasks")) {
+  server.tool("redistribute_stale_tasks", "Release stale in-progress tasks and optionally claim the best one. Work-stealing for multi-agent.", {
+    agent_id: exports_external.string().describe("Agent ID claiming the next task after releasing stale ones"),
+    max_age_minutes: exports_external.number().optional().describe("Tasks idle longer than this (default: 60) are released"),
+    project_id: exports_external.string().optional().describe("Limit to a specific project"),
+    limit: exports_external.number().optional().describe("Max number of stale tasks to release")
+  }, async ({ agent_id, max_age_minutes, project_id, limit }) => {
+    try {
+      const resolvedProjectId = project_id ? resolveId(project_id, "projects") : undefined;
+      const result = redistributeStaleTasks(agent_id, { max_age_minutes, project_id: resolvedProjectId, limit });
+      const lines = [`Released ${result.released.length} stale task(s).`];
+      for (const t of result.released)
+        lines.push(`  ${formatTask(t)}`);
+      if (result.claimed)
+        lines.push(`
+Claimed: ${formatTask(result.claimed)}`);
       return { content: [{ type: "text", text: lines.join(`
 `) }] };
     } catch (e) {
@@ -8983,6 +9283,9 @@ if (shouldRegisterTool("search_tools")) {
       "log_progress",
       "create_project",
       "list_projects",
+      "add_project_source",
+      "remove_project_source",
+      "list_project_sources",
       "create_plan",
       "list_plans",
       "get_plan",
@@ -9030,6 +9333,7 @@ if (shouldRegisterTool("search_tools")) {
       "decompose_task",
       "set_task_status",
       "set_task_priority",
+      "redistribute_stale_tasks",
       "search_tools",
       "describe_tools"
     ].filter((name) => shouldRegisterTool(name));
@@ -9090,6 +9394,15 @@ if (shouldRegisterTool("describe_tools")) {
   Params: name(string, req), path(string, req \u2014 unique absolute path), description(string), task_list_id(string)
   Example: {name: 'my-app', path: '/Users/dev/my-app'}`,
       list_projects: "List all registered projects. No params.",
+      add_project_source: `Add a data source to a project (S3, GDrive, local path, GitHub, Notion, HTTP, etc.).
+  Params: project_id(string, req), type(string, req \u2014 e.g. 's3','gdrive','local','github','notion','http'), name(string, req), uri(string, req), description(string), metadata(object)
+  Example: {project_id: 'a1b2c3d4', type: 's3', name: 'Assets bucket', uri: 's3://my-bucket/assets/', description: 'Project media files'}`,
+      remove_project_source: `Remove a data source from a project.
+  Params: source_id(string, req \u2014 source ID or prefix)
+  Example: {source_id: 'abc12345'}`,
+      list_project_sources: `List all data sources for a project.
+  Params: project_id(string, req)
+  Example: {project_id: 'a1b2c3d4'}`,
       create_plan: `Create a plan to group related tasks.
   Params: name(string, req), project_id(string), description(string), status(active|completed|archived, default:active), task_list_id(string), agent_id(string)
   Example: {name: 'Sprint 1', project_id: 'a1b2c3d4'}`,
@@ -9217,6 +9530,9 @@ if (shouldRegisterTool("describe_tools")) {
       set_task_priority: `Set task priority without needing version. Auto-retries on conflict (up to 3 attempts). Use instead of update_task when you only need to change priority.
   Params: id(string, req), priority(low|medium|high|critical, req)
   Example: {id: 'a1b2c3d4', priority: 'high'}`,
+      redistribute_stale_tasks: `Release stale in-progress tasks and optionally claim the best one. Multi-agent work-stealing.
+  Params: agent_id(string, req), max_age_minutes(number, default:60), project_id(string, optional), limit(number, optional)
+  Example: {agent_id: 'a1b2c3d4', max_age_minutes: 30}`,
       search_tools: `List all tool names or filter by substring.
   Params: query(string, optional)
   Example: {query: 'task'}`,
@@ -9247,6 +9563,62 @@ server.resource("agents", "todos://agents", { description: "All registered agent
   const agents = listAgents();
   return { contents: [{ uri: "todos://agents", text: JSON.stringify(agents, null, 2), mimeType: "application/json" }] };
 });
+if (shouldRegisterTool("create_handoff")) {
+  server.tool("create_handoff", "Create a session handoff note for agent coordination.", {
+    agent_id: exports_external.string().optional().describe("Agent creating the handoff"),
+    project_id: exports_external.string().optional().describe("Project ID"),
+    summary: exports_external.string().describe("What was accomplished this session"),
+    completed: exports_external.array(exports_external.string()).optional().describe("Items completed"),
+    in_progress: exports_external.array(exports_external.string()).optional().describe("Items still in progress"),
+    blockers: exports_external.array(exports_external.string()).optional().describe("Blocking issues"),
+    next_steps: exports_external.array(exports_external.string()).optional().describe("Recommended next actions")
+  }, async ({ agent_id, project_id, summary, completed, in_progress, blockers, next_steps }) => {
+    try {
+      const { createHandoff: createHandoff2 } = (init_handoffs(), __toCommonJS(exports_handoffs));
+      const handoff = createHandoff2({
+        agent_id,
+        project_id: project_id ? resolveId(project_id, "projects") : undefined,
+        summary,
+        completed,
+        in_progress,
+        blockers,
+        next_steps
+      });
+      return { content: [{ type: "text", text: `Handoff created: ${handoff.id.slice(0, 8)} by ${handoff.agent_id || "unknown"}` }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: formatError(e) }], isError: true };
+    }
+  });
+}
+if (shouldRegisterTool("get_latest_handoff")) {
+  server.tool("get_latest_handoff", "Get the most recent handoff for an agent or project.", {
+    agent_id: exports_external.string().optional().describe("Filter by agent"),
+    project_id: exports_external.string().optional().describe("Filter by project")
+  }, async ({ agent_id, project_id }) => {
+    try {
+      const { getLatestHandoff: getLatestHandoff2 } = (init_handoffs(), __toCommonJS(exports_handoffs));
+      const handoff = getLatestHandoff2(agent_id, project_id ? resolveId(project_id, "projects") : undefined);
+      if (!handoff)
+        return { content: [{ type: "text", text: "No handoffs found." }] };
+      const lines = [
+        `${handoff.created_at.slice(0, 16)} ${handoff.agent_id || "unknown"}`,
+        handoff.summary
+      ];
+      if (handoff.completed?.length)
+        lines.push(`Done: ${handoff.completed.join(", ")}`);
+      if (handoff.in_progress?.length)
+        lines.push(`In progress: ${handoff.in_progress.join(", ")}`);
+      if (handoff.blockers?.length)
+        lines.push(`Blocked: ${handoff.blockers.join(", ")}`);
+      if (handoff.next_steps?.length)
+        lines.push(`Next: ${handoff.next_steps.join(", ")}`);
+      return { content: [{ type: "text", text: lines.join(`
+`) }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: formatError(e) }], isError: true };
+    }
+  });
+}
 server.resource("task-lists", "todos://task-lists", { description: "All task lists", mimeType: "application/json" }, async () => {
   const lists = listTaskLists();
   return { contents: [{ uri: "todos://task-lists", text: JSON.stringify(lists, null, 2), mimeType: "application/json" }] };