@hasna/todos 0.9.26 → 0.9.28

package/dist/cli/index.js

@@ -8305,6 +8305,12 @@ function resolveTaskListId(agent, explicit) {
   return process.env[key] || process.env["TODOS_TASK_LIST_ID"] || getAgentTaskListId(normalized) || "default";
 }
 function formatTask(task) {
+  const id = task.short_id || task.id.slice(0, 8);
+  const assigned = task.assigned_to ? ` -> ${task.assigned_to}` : "";
+  const lock = task.locked_by ? ` [locked:${task.locked_by}]` : "";
+  return `${id} ${task.status.padEnd(11)} ${task.priority.padEnd(8)} ${task.title}${assigned}${lock}`;
+}
+function formatTaskDetail(task) {
   const parts = [
     `ID: ${task.id}`,
     `Title: ${task.title}`,
@@ -8385,8 +8391,7 @@ var init_mcp = __esm(() => {
       if (resolved.task_list_id)
         resolved.task_list_id = resolveId(resolved.task_list_id, "task_lists");
       const task = createTask(resolved);
-      return { content: [{ type: "text", text: `Task created:
-${formatTask(task)}` }] };
+      return { content: [{ type: "text", text: `created: ${formatTask(task)}` }] };
     } catch (e) {
       return { content: [{ type: "text", text: formatError(e) }], isError: true };
     }
@@ -8430,7 +8435,7 @@ ${text}` }] };
       return { content: [{ type: "text", text: formatError(e) }], isError: true };
     }
   });
-  server.tool("get_task", "Get full task details including dependencies, subtasks, and comments", {
+  server.tool("get_task", "Get full task details with relations", {
     id: exports_external.string().describe("Task ID (full or partial)")
   }, async ({ id }) => {
     try {
@@ -8438,7 +8443,7 @@ ${text}` }] };
       const task = getTaskWithRelations(resolvedId);
       if (!task)
         return { content: [{ type: "text", text: `Task not found: ${id}` }], isError: true };
-      const parts = [formatTask(task)];
+      const parts = [formatTaskDetail(task)];
       if (task.subtasks.length > 0) {
         parts.push(`
 Subtasks (${task.subtasks.length}):`);
@@ -8478,7 +8483,7 @@ Parent: ${task.parent.id.slice(0, 8)} | ${task.parent.title}`);
       return { content: [{ type: "text", text: formatError(e) }], isError: true };
     }
   });
-  server.tool("update_task", "Update task fields (requires version for optimistic locking)", {
+  server.tool("update_task", "Update task fields. Version required for optimistic locking.", {
     id: exports_external.string().describe("Task ID (full or partial)"),
     version: exports_external.number().describe("Current version (for optimistic locking)"),
     title: exports_external.string().optional().describe("New title"),
@@ -8494,8 +8499,7 @@ Parent: ${task.parent.id.slice(0, 8)} | ${task.parent.title}`);
     try {
       const resolvedId = resolveId(id);
       const task = updateTask(resolvedId, rest);
-      return { content: [{ type: "text", text: `Task updated:
-${formatTask(task)}` }] };
+      return { content: [{ type: "text", text: `updated: ${formatTask(task)}` }] };
     } catch (e) {
       return { content: [{ type: "text", text: formatError(e) }], isError: true };
     }
@@ -8516,28 +8520,26 @@ ${formatTask(task)}` }] };
       return { content: [{ type: "text", text: formatError(e) }], isError: true };
     }
   });
-  server.tool("start_task", "Claim a task, lock it, and set status to in_progress", {
+  server.tool("start_task", "Claim, lock, and set task status to in_progress.", {
     id: exports_external.string().describe("Task ID (full or partial)"),
     agent_id: exports_external.string().describe("Agent claiming the task")
   }, async ({ id, agent_id }) => {
     try {
       const resolvedId = resolveId(id);
       const task = startTask(resolvedId, agent_id);
-      return { content: [{ type: "text", text: `Task started:
-${formatTask(task)}` }] };
+      return { content: [{ type: "text", text: `started: ${formatTask(task)}` }] };
     } catch (e) {
       return { content: [{ type: "text", text: formatError(e) }], isError: true };
     }
   });
-  server.tool("complete_task", "Mark a task as completed and release lock", {
+  server.tool("complete_task", "Mark task completed and release lock.", {
     id: exports_external.string().describe("Task ID (full or partial)"),
     agent_id: exports_external.string().optional().describe("Agent completing the task")
   }, async ({ id, agent_id }) => {
     try {
       const resolvedId = resolveId(id);
       const task = completeTask(resolvedId, agent_id);
-      return { content: [{ type: "text", text: `Task completed:
-${formatTask(task)}` }] };
+      return { content: [{ type: "text", text: `completed: ${formatTask(task)}` }] };
     } catch (e) {
       return { content: [{ type: "text", text: formatError(e) }], isError: true };
     }
@@ -8569,7 +8571,7 @@ ${formatTask(task)}` }] };
       return { content: [{ type: "text", text: formatError(e) }], isError: true };
     }
   });
-  server.tool("add_dependency", "Add a dependency between tasks (task_id depends on depends_on)", {
+  server.tool("add_dependency", "Add a dependency: task_id depends on depends_on.", {
     task_id: exports_external.string().describe("Task that depends on another"),
     depends_on: exports_external.string().describe("Task that must complete first")
   }, async ({ task_id, depends_on }) => {
@@ -8760,7 +8762,7 @@ ${text}` }] };
       return { content: [{ type: "text", text: formatError(e) }], isError: true };
     }
   });
-  server.tool("search_tasks", "Full-text search across task titles, descriptions, and tags", {
+  server.tool("search_tasks", "Full-text search across task titles, descriptions, tags.", {
     query: exports_external.string().describe("Search query"),
     project_id: exports_external.string().optional().describe("Limit to project"),
     task_list_id: exports_external.string().optional().describe("Filter by task list")
@@ -8780,7 +8782,7 @@ ${text}` }] };
       return { content: [{ type: "text", text: formatError(e) }], isError: true };
     }
   });
-  server.tool("sync", "Sync tasks with an agent task list (Claude uses native task list; others use JSON lists).", {
+  server.tool("sync", "Sync tasks with an agent task list.", {
     task_list_id: exports_external.string().optional().describe("Task list ID (required for Claude)"),
     agent: exports_external.string().optional().describe("Agent/provider name (default: claude)"),
     all_agents: exports_external.boolean().optional().describe("Sync across all configured agents"),
@@ -8828,7 +8830,7 @@ ${text}` }] };
       return { content: [{ type: "text", text: formatError(e) }], isError: true };
     }
   });
-  server.tool("register_agent", "Register an agent and get a short UUID. Idempotent: same name returns existing agent.", {
+  server.tool("register_agent", "Register an agent (idempotent by name).", {
     name: exports_external.string().describe("Agent name"),
     description: exports_external.string().optional().describe("Agent description")
   }, async ({ name, description }) => {
@@ -8988,7 +8990,7 @@ Slug: ${list.slug}`
       return { content: [{ type: "text", text: formatError(e) }], isError: true };
     }
   });
-  server.tool("delete_task_list", "Delete a task list. Tasks in this list keep their data but lose their list association.", {
+  server.tool("delete_task_list", "Delete a task list. Tasks lose association but keep data.", {
     id: exports_external.string().describe("Task list ID (full or partial)")
   }, async ({ id }) => {
     try {
@@ -9004,7 +9006,7 @@ Slug: ${list.slug}`
       return { content: [{ type: "text", text: formatError(e) }], isError: true };
     }
   });
-  server.tool("get_task_history", "Get change history for a task (audit log)", {
+  server.tool("get_task_history", "Get audit log for a task.", {
     task_id: exports_external.string().describe("Task ID (full or partial)")
   }, async ({ task_id }) => {
     try {
@@ -9021,7 +9023,7 @@ ${text}` }] };
       return { content: [{ type: "text", text: formatError(e) }], isError: true };
     }
   });
-  server.tool("get_recent_activity", "Get recent task changes across all tasks (audit log)", {
+  server.tool("get_recent_activity", "Get recent task changes across all tasks.", {
     limit: exports_external.number().optional().describe("Max entries (default 50)")
   }, async ({ limit }) => {
     try {
@@ -9037,7 +9039,7 @@ ${text}` }] };
       return { content: [{ type: "text", text: formatError(e) }], isError: true };
     }
   });
-  server.tool("create_webhook", "Register a webhook URL to receive task change notifications", {
+  server.tool("create_webhook", "Register a webhook to receive task change events.", {
     url: exports_external.string().describe("Webhook URL"),
     events: exports_external.array(exports_external.string()).optional().describe("Event types to subscribe to (empty = all)"),
     secret: exports_external.string().optional().describe("HMAC secret for signature verification")
@@ -9075,7 +9077,7 @@ ${text}` }] };
       return { content: [{ type: "text", text: formatError(e) }], isError: true };
     }
   });
-  server.tool("create_template", "Create a reusable task template", {
+  server.tool("create_template", "Create a reusable task template.", {
     name: exports_external.string().describe("Template name"),
     title_pattern: exports_external.string().describe("Title pattern for tasks created from this template"),
     description: exports_external.string().optional().describe("Default description"),
@@ -9106,7 +9108,7 @@ ${text}` }] };
       return { content: [{ type: "text", text: formatError(e) }], isError: true };
     }
   });
-  server.tool("create_task_from_template", "Create a task from a template with optional overrides", {
+  server.tool("create_task_from_template", "Create a task from a template with optional overrides.", {
     template_id: exports_external.string().describe("Template ID"),
     title: exports_external.string().optional().describe("Override title"),
     description: exports_external.string().optional().describe("Override description"),
@@ -9139,7 +9141,7 @@ ${task.id.slice(0, 8)} | ${task.priority} | ${task.title}` }] };
       return { content: [{ type: "text", text: formatError(e) }], isError: true };
     }
   });
-  server.tool("approve_task", "Approve a task that requires approval before completion", {
+  server.tool("approve_task", "Approve a task that requires approval.", {
     id: exports_external.string().describe("Task ID (full or partial)"),
     agent_id: exports_external.string().optional().describe("Agent approving the task")
   }, async ({ id, agent_id }) => {
@@ -9158,7 +9160,7 @@ ${task.id.slice(0, 8)} | ${task.priority} | ${task.title}` }] };
       return { content: [{ type: "text", text: formatError(e) }], isError: true };
     }
   });
-  server.tool("get_my_tasks", "Get your assigned tasks and stats. Auto-registers if needed.", {
+  server.tool("get_my_tasks", "Get assigned tasks and stats for an agent.", {
     agent_name: exports_external.string().describe("Your agent name")
   }, async ({ agent_name }) => {
     try {
@@ -9191,6 +9193,79 @@ In Progress:`);
       return { content: [{ type: "text", text: formatError(e) }], isError: true };
     }
   });
+  server.tool("search_tools", "List tool names matching a query.", { query: exports_external.string().optional().describe("Keyword to filter tools") }, async ({ query }) => {
+    const all = [
+      "create_task",
+      "list_tasks",
+      "get_task",
+      "update_task",
+      "delete_task",
+      "start_task",
+      "complete_task",
+      "lock_task",
+      "unlock_task",
+      "approve_task",
+      "add_dependency",
+      "remove_dependency",
+      "add_comment",
+      "create_project",
+      "list_projects",
+      "create_plan",
+      "list_plans",
+      "get_plan",
+      "update_plan",
+      "delete_plan",
+      "register_agent",
+      "list_agents",
+      "get_agent",
+      "get_my_tasks",
+      "create_task_list",
+      "list_task_lists",
+      "get_task_list",
+      "update_task_list",
+      "delete_task_list",
+      "search_tasks",
+      "sync",
+      "get_task_history",
+      "get_recent_activity",
+      "create_webhook",
+      "list_webhooks",
+      "delete_webhook",
+      "create_template",
+      "list_templates",
+      "create_task_from_template",
+      "delete_template",
+      "search_tools",
+      "describe_tools"
+    ];
+    const q = query?.toLowerCase();
+    const matches = q ? all.filter((n) => n.includes(q)) : all;
+    return { content: [{ type: "text", text: matches.join(", ") }] };
+  });
+  server.tool("describe_tools", "Get descriptions for specific tools by name.", { names: exports_external.array(exports_external.string()).describe("Tool names from search_tools") }, async ({ names }) => {
+    const descriptions = {
+      create_task: "Create a task. Params: title(req), description, priority, project_id, plan_id, tags, assigned_to, estimated_minutes, requires_approval",
+      list_tasks: "List tasks. Params: status, priority, project_id, plan_id, assigned_to, tags, limit",
+      get_task: "Get full task details. Params: id",
+      update_task: "Update task fields. Params: id, version(req), title, description, status, priority, tags, assigned_to, due_at",
+      delete_task: "Delete a task. Params: id",
+      start_task: "Claim, lock, and start a task. Params: id",
+      complete_task: "Mark task completed. Params: id, agent_id",
+      approve_task: "Approve task requiring approval. Params: id, agent_id",
+      create_plan: "Create a plan. Params: name, description, project_id, task_list_id, agent_id, status",
+      list_plans: "List plans. Params: project_id",
+      get_plan: "Get plan with tasks. Params: id",
+      search_tasks: "Full-text search tasks. Params: query, project_id, task_list_id",
+      get_my_tasks: "Get your tasks and stats. Params: agent_name",
+      get_task_history: "Get task audit log. Params: task_id",
+      get_recent_activity: "Recent changes across all tasks. Params: limit",
+      create_template: "Create task template. Params: name, title_pattern, description, priority, tags",
+      create_task_from_template: "Create task from template. Params: template_id, title, priority, assigned_to"
+    };
+    const result = names.map((n) => `${n}: ${descriptions[n] || "See tool schema"}`).join(`
+`);
+    return { content: [{ type: "text", text: result }] };
+  });
   server.resource("tasks", "todos://tasks", { description: "All active tasks", mimeType: "application/json" }, async () => {
     const tasks = listTasks({ status: ["pending", "in_progress"] });
     return { contents: [{ uri: "todos://tasks", text: JSON.stringify(tasks, null, 2), mimeType: "application/json" }] };
@@ -9259,8 +9334,8 @@ function serveStaticFile(filePath) {
     headers: { "Content-Type": contentType }
   });
 }
-function taskToSummary(task) {
-  return {
+function taskToSummary(task, fields) {
+  const full = {
     id: task.id,
     short_id: task.short_id,
     title: task.title,
@@ -9280,6 +9355,9 @@ function taskToSummary(task) {
     completed_at: task.completed_at,
     due_at: task.due_at
   };
+  if (!fields || fields.length === 0)
+    return full;
+  return Object.fromEntries(fields.map((f) => [f, full[f] ?? null]));
 }
 async function startServer(port, options) {
   const shouldOpen = options?.open ?? true;
@@ -9362,12 +9440,14 @@ Dashboard not found at: ${dashboardDir}`);
         const status = url.searchParams.get("status") || undefined;
         const projectId = url.searchParams.get("project_id") || undefined;
         const limitParam = url.searchParams.get("limit");
+        const fieldsParam = url.searchParams.get("fields");
+        const fields = fieldsParam ? fieldsParam.split(",").map((f) => f.trim()).filter(Boolean) : undefined;
         const tasks = listTasks({
           status,
           project_id: projectId,
           limit: limitParam ? parseInt(limitParam, 10) : undefined
         });
-        return json(tasks.map(taskToSummary), 200, port);
+        return json(tasks.map((t) => taskToSummary(t, fields)), 200, port);
       }
       if (path === "/api/tasks" && method === "POST") {
         try {
@@ -9391,7 +9471,7 @@ Dashboard not found at: ${dashboardDir}`);
         const status = url.searchParams.get("status") || undefined;
         const projectId = url.searchParams.get("project_id") || undefined;
         const tasks = listTasks({ status, project_id: projectId, limit: 1e4 });
-        const summaries = tasks.map(taskToSummary);
+        const summaries = tasks.map((t) => taskToSummary(t));
         if (format === "csv") {
           const headers = ["id", "short_id", "title", "status", "priority", "project_id", "assigned_to", "agent_id", "created_at", "updated_at", "completed_at", "due_at"];
           const rows = summaries.map((t) => headers.map((h) => {
@@ -9517,8 +9597,8 @@ Dashboard not found at: ${dashboardDir}`);
         const completed = allTasks.filter((t) => t.status === "completed");
         return json({
           agent,
-          pending_tasks: pending.map(taskToSummary),
-          in_progress_tasks: inProgress.map(taskToSummary),
+          pending_tasks: pending.map((t) => taskToSummary(t)),
+          in_progress_tasks: inProgress.map((t) => taskToSummary(t)),
           stats: {
             total: allTasks.length,
             pending: pending.length,
@@ -9535,7 +9615,7 @@ Dashboard not found at: ${dashboardDir}`);
         const queue = pending.filter((t) => t.assigned_to === agentId || t.agent_id === agentId || !t.assigned_to && !t.locked_by);
         const order = { critical: 0, high: 1, medium: 2, low: 3 };
         queue.sort((a, b) => (order[a.priority] ?? 4) - (order[b.priority] ?? 4) || new Date(a.created_at).getTime() - new Date(b.created_at).getTime());
-        return json(queue.map(taskToSummary), 200, port);
+        return json(queue.map((t) => taskToSummary(t)), 200, port);
       }
       if (path === "/api/tasks/claim" && method === "POST") {
         try {
@@ -9751,7 +9831,7 @@ Dashboard not found at: ${dashboardDir}`);
           if (!plan)
             return json({ error: "Plan not found" }, 404, port);
           const tasks = listTasks({ plan_id: id });
-          return json({ ...plan, tasks: tasks.map(taskToSummary) }, 200, port);
+          return json({ ...plan, tasks: tasks.map((t) => taskToSummary(t)) }, 200, port);
         }
         if (method === "PATCH") {
           try {
@@ -11043,7 +11123,7 @@ program2.command("add <title>").description("Create a new task").option("-d, --d
     console.log(formatTaskLine(task));
   }
 });
-program2.command("list").description("List tasks").option("-s, --status <status>", "Filter by status").option("-p, --priority <priority>", "Filter by priority").option("--assigned <agent>", "Filter by assigned agent").option("--tags <tags>", "Filter by tags (comma-separated)").option("--tag <tags>", "Filter by tags (alias for --tags)").option("-a, --all", "Show all tasks (including completed/cancelled)").option("--list <id>", "Filter by task list ID").option("--task-list <id>", "Filter by task list ID (alias for --list)").option("--project-name <name>", "Filter by project name").option("--agent-name <name>", "Filter by agent name/assigned").option("--sort <field>", "Sort by: updated, created, priority, status").action((opts) => {
+program2.command("list").description("List tasks").option("-s, --status <status>", "Filter by status").option("-p, --priority <priority>", "Filter by priority").option("--assigned <agent>", "Filter by assigned agent").option("--tags <tags>", "Filter by tags (comma-separated)").option("--tag <tags>", "Filter by tags (alias for --tags)").option("-a, --all", "Show all tasks (including completed/cancelled)").option("--list <id>", "Filter by task list ID").option("--task-list <id>", "Filter by task list ID (alias for --list)").option("--project-name <name>", "Filter by project name").option("--agent-name <name>", "Filter by agent name/assigned").option("--sort <field>", "Sort by: updated, created, priority, status").option("--format <fmt>", "Output format: table (default), compact, csv, json").action((opts) => {
   const globalOpts = program2.opts();
   opts.tags = opts.tags || opts.tag;
   opts.list = opts.list || opts.taskList;
@@ -11099,12 +11179,40 @@ program2.command("list").description("List tasks").option("-s, --status <status>
       return 0;
     });
   }
-  if (globalOpts.json) {
+  const fmt = opts.format || (globalOpts.json ? "json" : "table");
+  if (fmt === "json") {
     output(tasks, true);
     return;
   }
   if (tasks.length === 0) {
-    console.log(chalk.dim("No tasks found."));
+    if (fmt === "compact" || fmt === "csv")
+      process.stdout.write("");
+    else
+      console.log(chalk.dim("No tasks found."));
+    return;
+  }
+  if (fmt === "csv") {
+    const headers = "id,short_id,title,status,priority,assigned_to,updated_at";
+    const rows = tasks.map((t) => [
+      t.id,
+      t.short_id || "",
+      t.title.replace(/,/g, ";"),
+      t.status,
+      t.priority,
+      t.assigned_to || "",
+      t.updated_at
+    ].join(","));
+    console.log([headers, ...rows].join(`
+`));
+    return;
+  }
+  if (fmt === "compact") {
+    for (const t of tasks) {
+      const id = t.short_id || t.id.slice(0, 8);
+      const assigned = t.assigned_to ? ` ${t.assigned_to}` : "";
+      process.stdout.write(`${id} ${t.status} ${t.priority} ${t.title}${assigned}
+`);
+    }
     return;
   }
   console.log(chalk.bold(`${tasks.length} task(s):

package/dist/mcp/index.js

@@ -6129,22 +6129,22 @@ function formatTaskDetail(task) {
 `);
 }
 server.tool("create_task", "Create a new task", {
-  title: exports_external.string().describe("Task title"),
-  description: exports_external.string().optional().describe("Task description"),
-  project_id: exports_external.string().optional().describe("Project ID"),
-  parent_id: exports_external.string().optional().describe("Parent task ID (for subtasks)"),
-  priority: exports_external.enum(["low", "medium", "high", "critical"]).optional().describe("Task priority"),
-  status: exports_external.enum(["pending", "in_progress", "completed", "failed", "cancelled"]).optional().describe("Initial status"),
-  agent_id: exports_external.string().optional().describe("Creator agent ID"),
-  assigned_to: exports_external.string().optional().describe("Assigned agent ID"),
-  session_id: exports_external.string().optional().describe("Session ID"),
-  working_dir: exports_external.string().optional().describe("Working directory context"),
-  plan_id: exports_external.string().optional().describe("Plan ID to assign task to"),
-  task_list_id: exports_external.string().optional().describe("Task list ID to assign task to"),
-  tags: exports_external.array(exports_external.string()).optional().describe("Task tags"),
-  metadata: exports_external.record(exports_external.unknown()).optional().describe("Arbitrary metadata"),
-  estimated_minutes: exports_external.number().optional().describe("Estimated time in minutes"),
-  requires_approval: exports_external.boolean().optional().describe("Require approval before completion")
+  title: exports_external.string(),
+  description: exports_external.string().optional(),
+  project_id: exports_external.string().optional(),
+  parent_id: exports_external.string().optional(),
+  priority: exports_external.enum(["low", "medium", "high", "critical"]).optional(),
+  status: exports_external.enum(["pending", "in_progress", "completed", "failed", "cancelled"]).optional(),
+  agent_id: exports_external.string().optional(),
+  assigned_to: exports_external.string().optional(),
+  session_id: exports_external.string().optional(),
+  working_dir: exports_external.string().optional(),
+  plan_id: exports_external.string().optional(),
+  task_list_id: exports_external.string().optional(),
+  tags: exports_external.array(exports_external.string()).optional(),
+  metadata: exports_external.record(exports_external.unknown()).optional(),
+  estimated_minutes: exports_external.number().optional(),
+  requires_approval: exports_external.boolean().optional()
 }, async (params) => {
   try {
     const resolved = { ...params };
@@ -6163,19 +6163,19 @@ server.tool("create_task", "Create a new task", {
   }
 });
 server.tool("list_tasks", "List tasks with optional filters", {
-  project_id: exports_external.string().optional().describe("Filter by project"),
+  project_id: exports_external.string().optional(),
   status: exports_external.union([
     exports_external.enum(["pending", "in_progress", "completed", "failed", "cancelled"]),
     exports_external.array(exports_external.enum(["pending", "in_progress", "completed", "failed", "cancelled"]))
-  ]).optional().describe("Filter by status"),
+  ]).optional(),
   priority: exports_external.union([
     exports_external.enum(["low", "medium", "high", "critical"]),
     exports_external.array(exports_external.enum(["low", "medium", "high", "critical"]))
-  ]).optional().describe("Filter by priority"),
-  assigned_to: exports_external.string().optional().describe("Filter by assigned agent"),
-  tags: exports_external.array(exports_external.string()).optional().describe("Filter by tags (any match)"),
-  plan_id: exports_external.string().optional().describe("Filter by plan"),
-  task_list_id: exports_external.string().optional().describe("Filter by task list")
+  ]).optional(),
+  assigned_to: exports_external.string().optional(),
+  tags: exports_external.array(exports_external.string()).optional(),
+  plan_id: exports_external.string().optional(),
+  task_list_id: exports_external.string().optional()
 }, async (params) => {
   try {
     const resolved = { ...params };
@@ -6202,7 +6202,7 @@ ${text}` }] };
   }
 });
 server.tool("get_task", "Get full task details with relations", {
-  id: exports_external.string().describe("Task ID (full or partial)")
+  id: exports_external.string()
 }, async ({ id }) => {
   try {
     const resolvedId = resolveId(id);
@@ -6250,17 +6250,17 @@ Parent: ${task.parent.id.slice(0, 8)} | ${task.parent.title}`);
   }
 });
 server.tool("update_task", "Update task fields. Version required for optimistic locking.", {
-  id: exports_external.string().describe("Task ID (full or partial)"),
-  version: exports_external.number().describe("Current version (for optimistic locking)"),
-  title: exports_external.string().optional().describe("New title"),
-  description: exports_external.string().optional().describe("New description"),
-  status: exports_external.enum(["pending", "in_progress", "completed", "failed", "cancelled"]).optional().describe("New status"),
-  priority: exports_external.enum(["low", "medium", "high", "critical"]).optional().describe("New priority"),
-  assigned_to: exports_external.string().optional().describe("Assign to agent"),
-  tags: exports_external.array(exports_external.string()).optional().describe("New tags"),
-  metadata: exports_external.record(exports_external.unknown()).optional().describe("New metadata"),
-  plan_id: exports_external.string().optional().describe("Plan ID to assign task to"),
-  task_list_id: exports_external.string().optional().describe("Task list ID")
+  id: exports_external.string(),
+  version: exports_external.number(),
+  title: exports_external.string().optional(),
+  description: exports_external.string().optional(),
+  status: exports_external.enum(["pending", "in_progress", "completed", "failed", "cancelled"]).optional(),
+  priority: exports_external.enum(["low", "medium", "high", "critical"]).optional(),
+  assigned_to: exports_external.string().optional(),
+  tags: exports_external.array(exports_external.string()).optional(),
+  metadata: exports_external.record(exports_external.unknown()).optional(),
+  plan_id: exports_external.string().optional(),
+  task_list_id: exports_external.string().optional()
 }, async ({ id, ...rest }) => {
   try {
     const resolvedId = resolveId(id);
@@ -6271,7 +6271,7 @@ server.tool("update_task", "Update task fields. Version required for optimistic
   }
 });
 server.tool("delete_task", "Delete a task permanently", {
-  id: exports_external.string().describe("Task ID (full or partial)")
+  id: exports_external.string()
 }, async ({ id }) => {
   try {
     const resolvedId = resolveId(id);
@@ -6287,8 +6287,8 @@ server.tool("delete_task", "Delete a task permanently", {
   }
 });
 server.tool("start_task", "Claim, lock, and set task status to in_progress.", {
-  id: exports_external.string().describe("Task ID (full or partial)"),
-  agent_id: exports_external.string().describe("Agent claiming the task")
+  id: exports_external.string(),
+  agent_id: exports_external.string()
 }, async ({ id, agent_id }) => {
   try {
     const resolvedId = resolveId(id);
@@ -6299,8 +6299,8 @@ server.tool("start_task", "Claim, lock, and set task status to in_progress.", {
   }
 });
 server.tool("complete_task", "Mark task completed and release lock.", {
-  id: exports_external.string().describe("Task ID (full or partial)"),
-  agent_id: exports_external.string().optional().describe("Agent completing the task")
+  id: exports_external.string(),
+  agent_id: exports_external.string().optional()
 }, async ({ id, agent_id }) => {
   try {
     const resolvedId = resolveId(id);
@@ -6311,8 +6311,8 @@ server.tool("complete_task", "Mark task completed and release lock.", {
   }
 });
 server.tool("lock_task", "Acquire exclusive lock on a task", {
-  id: exports_external.string().describe("Task ID (full or partial)"),
-  agent_id: exports_external.string().describe("Agent acquiring lock")
+  id: exports_external.string(),
+  agent_id: exports_external.string()
 }, async ({ id, agent_id }) => {
   try {
     const resolvedId = resolveId(id);
@@ -6326,8 +6326,8 @@ server.tool("lock_task", "Acquire exclusive lock on a task", {
   }
 });
 server.tool("unlock_task", "Release exclusive lock on a task", {
-  id: exports_external.string().describe("Task ID (full or partial)"),
-  agent_id: exports_external.string().optional().describe("Agent releasing lock (omit to force)")
+  id: exports_external.string(),
+  agent_id: exports_external.string().optional()
 }, async ({ id, agent_id }) => {
   try {
     const resolvedId = resolveId(id);
@@ -6338,8 +6338,8 @@ server.tool("unlock_task", "Release exclusive lock on a task", {
   }
 });
 server.tool("add_dependency", "Add a dependency: task_id depends on depends_on.", {
-  task_id: exports_external.string().describe("Task that depends on another"),
-  depends_on: exports_external.string().describe("Task that must complete first")
+  task_id: exports_external.string(),
+  depends_on: exports_external.string()
 }, async ({ task_id, depends_on }) => {
   try {
     const resolvedTaskId = resolveId(task_id);
@@ -6351,8 +6351,8 @@ server.tool("add_dependency", "Add a dependency: task_id depends on depends_on."
   }
 });
 server.tool("remove_dependency", "Remove a dependency between tasks", {
-  task_id: exports_external.string().describe("Task ID"),
-  depends_on: exports_external.string().describe("Dependency to remove")
+  task_id: exports_external.string(),
+  depends_on: exports_external.string()
 }, async ({ task_id, depends_on }) => {
   try {
     const resolvedTaskId = resolveId(task_id);
@@ -6369,10 +6369,10 @@ server.tool("remove_dependency", "Remove a dependency between tasks", {
   }
 });
 server.tool("add_comment", "Add a comment/note to a task", {
-  task_id: exports_external.string().describe("Task ID (full or partial)"),
-  content: exports_external.string().describe("Comment content"),
-  agent_id: exports_external.string().optional().describe("Agent adding comment"),
-  session_id: exports_external.string().optional().describe("Session ID")
+  task_id: exports_external.string(),
+  content: exports_external.string(),
+  agent_id: exports_external.string().optional(),
+  session_id: exports_external.string().optional()
 }, async ({ task_id, ...rest }) => {
   try {
     const resolvedId = resolveId(task_id);
@@ -6400,10 +6400,10 @@ ${text}` }] };
   }
 });
 server.tool("create_project", "Register a new project", {
-  name: exports_external.string().describe("Project name"),
-  path: exports_external.string().describe("Absolute path to project"),
-  description: exports_external.string().optional().describe("Project description"),
-  task_list_id: exports_external.string().optional().describe("Custom task list ID for Claude Code sync (defaults to todos-<slugified-name>)")
+  name: exports_external.string(),
+  path: exports_external.string(),
+  description: exports_external.string().optional(),
+  task_list_id: exports_external.string().optional()
 }, async (params) => {
   try {
     const project = createProject(params);
@@ -6419,12 +6419,12 @@ server.tool("create_project", "Register a new project", {
   }
 });
 server.tool("create_plan", "Create a new plan", {
-  name: exports_external.string().describe("Plan name"),
-  project_id: exports_external.string().optional().describe("Project ID"),
-  description: exports_external.string().optional().describe("Plan description"),
-  status: exports_external.enum(["active", "completed", "archived"]).optional().describe("Plan status"),
-  task_list_id: exports_external.string().optional().describe("Task list ID"),
-  agent_id: exports_external.string().optional().describe("Owner agent ID")
+  name: exports_external.string(),
+  project_id: exports_external.string().optional(),
+  description: exports_external.string().optional(),
+  status: exports_external.enum(["active", "completed", "archived"]).optional(),
+  task_list_id: exports_external.string().optional(),
+  agent_id: exports_external.string().optional()
 }, async (params) => {
   try {
     const resolved = { ...params };
@@ -6444,7 +6444,7 @@ server.tool("create_plan", "Create a new plan", {
   }
 });
 server.tool("list_plans", "List plans with optional project filter", {
-  project_id: exports_external.string().optional().describe("Filter by project")
+  project_id: exports_external.string().optional()
 }, async ({ project_id }) => {
   try {
     const resolvedProjectId = project_id ? resolveId(project_id, "projects") : undefined;
@@ -6464,7 +6464,7 @@ ${text}` }] };
   }
 });
 server.tool("get_plan", "Get plan details", {
-  id: exports_external.string().describe("Plan ID (full or partial)")
+  id: exports_external.string()
 }, async ({ id }) => {
   try {
     const resolvedId = resolveId(id, "plans");
@@ -6489,12 +6489,12 @@ server.tool("get_plan", "Get plan details", {
   }
 });
 server.tool("update_plan", "Update a plan", {
-  id: exports_external.string().describe("Plan ID (full or partial)"),
-  name: exports_external.string().optional().describe("New name"),
-  description: exports_external.string().optional().describe("New description"),
-  status: exports_external.enum(["active", "completed", "archived"]).optional().describe("New status"),
-  task_list_id: exports_external.string().optional().describe("Task list ID"),
-  agent_id: exports_external.string().optional().describe("Owner agent ID")
+  id: exports_external.string(),
+  name: exports_external.string().optional(),
+  description: exports_external.string().optional(),
+  status: exports_external.enum(["active", "completed", "archived"]).optional(),
+  task_list_id: exports_external.string().optional(),
+  agent_id: exports_external.string().optional()
 }, async ({ id, ...rest }) => {
   try {
     const resolvedId = resolveId(id, "plans");
@@ -6513,7 +6513,7 @@ server.tool("update_plan", "Update a plan", {
   }
 });
 server.tool("delete_plan", "Delete a plan", {
-  id: exports_external.string().describe("Plan ID (full or partial)")
+  id: exports_external.string()
 }, async ({ id }) => {
   try {
     const resolvedId = resolveId(id, "plans");
@@ -6529,9 +6529,9 @@ server.tool("delete_plan", "Delete a plan", {
   }
 });
 server.tool("search_tasks", "Full-text search across task titles, descriptions, tags.", {
-  query: exports_external.string().describe("Search query"),
-  project_id: exports_external.string().optional().describe("Limit to project"),
-  task_list_id: exports_external.string().optional().describe("Filter by task list")
+  query: exports_external.string(),
+  project_id: exports_external.string().optional(),
+  task_list_id: exports_external.string().optional()
 }, async ({ query, project_id, task_list_id }) => {
   try {
     const resolvedProjectId = project_id ? resolveId(project_id, "projects") : undefined;
@@ -6549,12 +6549,12 @@ ${text}` }] };
   }
 });
 server.tool("sync", "Sync tasks with an agent task list.", {
-  task_list_id: exports_external.string().optional().describe("Task list ID (required for Claude)"),
-  agent: exports_external.string().optional().describe("Agent/provider name (default: claude)"),
-  all_agents: exports_external.boolean().optional().describe("Sync across all configured agents"),
-  project_id: exports_external.string().optional().describe("Project ID \u2014 its task_list_id will be used for Claude if task_list_id is not provided"),
-  direction: exports_external.enum(["push", "pull", "both"]).optional().describe("Sync direction: push (SQLite->agent), pull (agent->SQLite), or both (default)"),
-  prefer: exports_external.enum(["local", "remote"]).optional().describe("Conflict strategy")
+  task_list_id: exports_external.string().optional(),
+  agent: exports_external.string().optional(),
+  all_agents: exports_external.boolean().optional(),
+  project_id: exports_external.string().optional(),
+  direction: exports_external.enum(["push", "pull", "both"]).optional(),
+  prefer: exports_external.enum(["local", "remote"]).optional()
 }, async ({ task_list_id, agent, all_agents, project_id, direction, prefer }) => {
   try {
     const resolvedProjectId = project_id ? resolveId(project_id, "projects") : undefined;
@@ -6597,8 +6597,8 @@ server.tool("sync", "Sync tasks with an agent task list.", {
   }
 });
 server.tool("register_agent", "Register an agent (idempotent by name).", {
-  name: exports_external.string().describe("Agent name"),
-  description: exports_external.string().optional().describe("Agent description")
+  name: exports_external.string(),
+  description: exports_external.string().optional()
 }, async ({ name, description }) => {
   try {
     const agent = registerAgent({ name, description });
@@ -6634,8 +6634,8 @@ ${text}` }] };
   }
 });
 server.tool("get_agent", "Get agent details by ID or name", {
-  id: exports_external.string().optional().describe("Agent ID"),
-  name: exports_external.string().optional().describe("Agent name")
+  id: exports_external.string().optional(),
+  name: exports_external.string().optional()
 }, async ({ id, name }) => {
   try {
     if (!id && !name) {
@@ -6662,10 +6662,10 @@ server.tool("get_agent", "Get agent details by ID or name", {
   }
 });
 server.tool("create_task_list", "Create a new task list", {
-  name: exports_external.string().describe("Task list name"),
-  slug: exports_external.string().optional().describe("URL-friendly slug (auto-generated from name if omitted)"),
-  project_id: exports_external.string().optional().describe("Project ID to associate with"),
-  description: exports_external.string().optional().describe("Task list description")
+  name: exports_external.string(),
+  slug: exports_external.string().optional(),
+  project_id: exports_external.string().optional(),
+  description: exports_external.string().optional()
 }, async (params) => {
   try {
     const resolved = { ...params };
@@ -6688,7 +6688,7 @@ Description: ${list.description}` : ""}`
   }
 });
 server.tool("list_task_lists", "List task lists, optionally filtered by project", {
-  project_id: exports_external.string().optional().describe("Filter by project")
+  project_id: exports_external.string().optional()
 }, async ({ project_id }) => {
   try {
     const resolvedProjectId = project_id ? resolveId(project_id, "projects") : undefined;
@@ -6708,7 +6708,7 @@ ${text}` }] };
   }
 });
 server.tool("get_task_list", "Get task list details", {
-  id: exports_external.string().describe("Task list ID (full or partial)")
+  id: exports_external.string()
 }, async ({ id }) => {
   try {
     const resolvedId = resolveId(id, "task_lists");
@@ -6736,9 +6736,9 @@ server.tool("get_task_list", "Get task list details", {
   }
 });
 server.tool("update_task_list", "Update a task list", {
-  id: exports_external.string().describe("Task list ID (full or partial)"),
-  name: exports_external.string().optional().describe("New name"),
-  description: exports_external.string().optional().describe("New description")
+  id: exports_external.string(),
+  name: exports_external.string().optional(),
+  description: exports_external.string().optional()
 }, async ({ id, ...rest }) => {
   try {
     const resolvedId = resolveId(id, "task_lists");
@@ -6757,7 +6757,7 @@ Slug: ${list.slug}`
   }
 });
 server.tool("delete_task_list", "Delete a task list. Tasks lose association but keep data.", {
-  id: exports_external.string().describe("Task list ID (full or partial)")
+  id: exports_external.string()
 }, async ({ id }) => {
   try {
     const resolvedId = resolveId(id, "task_lists");
@@ -6773,7 +6773,7 @@ server.tool("delete_task_list", "Delete a task list. Tasks lose association but
   }
 });
 server.tool("get_task_history", "Get audit log for a task.", {
-  task_id: exports_external.string().describe("Task ID (full or partial)")
+  task_id: exports_external.string()
 }, async ({ task_id }) => {
   try {
     const resolvedId = resolveId(task_id);
@@ -6790,7 +6790,7 @@ ${text}` }] };
   }
 });
 server.tool("get_recent_activity", "Get recent task changes across all tasks.", {
-  limit: exports_external.number().optional().describe("Max entries (default 50)")
+  limit: exports_external.number().optional()
 }, async ({ limit }) => {
   try {
     const { getRecentActivity: getRecentActivity2 } = await Promise.resolve().then(() => (init_audit(), exports_audit));
@@ -6806,9 +6806,9 @@ ${text}` }] };
   }
 });
 server.tool("create_webhook", "Register a webhook to receive task change events.", {
-  url: exports_external.string().describe("Webhook URL"),
-  events: exports_external.array(exports_external.string()).optional().describe("Event types to subscribe to (empty = all)"),
-  secret: exports_external.string().optional().describe("HMAC secret for signature verification")
+  url: exports_external.string(),
+  events: exports_external.array(exports_external.string()).optional(),
+  secret: exports_external.string().optional()
 }, async (params) => {
   try {
     const { createWebhook: createWebhook2 } = await Promise.resolve().then(() => (init_webhooks(), exports_webhooks));
@@ -6833,7 +6833,7 @@ ${text}` }] };
   }
 });
 server.tool("delete_webhook", "Delete a webhook", {
-  id: exports_external.string().describe("Webhook ID")
+  id: exports_external.string()
 }, async ({ id }) => {
   try {
     const { deleteWebhook: deleteWebhook2 } = await Promise.resolve().then(() => (init_webhooks(), exports_webhooks));
@@ -6844,13 +6844,13 @@ server.tool("delete_webhook", "Delete a webhook", {
   }
 });
 server.tool("create_template", "Create a reusable task template.", {
-  name: exports_external.string().describe("Template name"),
-  title_pattern: exports_external.string().describe("Title pattern for tasks created from this template"),
-  description: exports_external.string().optional().describe("Default description"),
-  priority: exports_external.enum(["low", "medium", "high", "critical"]).optional().describe("Default priority"),
-  tags: exports_external.array(exports_external.string()).optional().describe("Default tags"),
-  project_id: exports_external.string().optional().describe("Default project"),
-  plan_id: exports_external.string().optional().describe("Default plan")
+  name: exports_external.string(),
+  title_pattern: exports_external.string(),
+  description: exports_external.string().optional(),
+  priority: exports_external.enum(["low", "medium", "high", "critical"]).optional(),
+  tags: exports_external.array(exports_external.string()).optional(),
+  project_id: exports_external.string().optional(),
+  plan_id: exports_external.string().optional()
 }, async (params) => {
   try {
     const { createTemplate: createTemplate2 } = await Promise.resolve().then(() => (init_templates(), exports_templates));
@@ -6875,12 +6875,12 @@ ${text}` }] };
   }
 });
 server.tool("create_task_from_template", "Create a task from a template with optional overrides.", {
-  template_id: exports_external.string().describe("Template ID"),
-  title: exports_external.string().optional().describe("Override title"),
-  description: exports_external.string().optional().describe("Override description"),
-  priority: exports_external.enum(["low", "medium", "high", "critical"]).optional().describe("Override priority"),
-  assigned_to: exports_external.string().optional().describe("Assign to agent"),
-  project_id: exports_external.string().optional().describe("Override project")
+  template_id: exports_external.string(),
+  title: exports_external.string().optional(),
+  description: exports_external.string().optional(),
+  priority: exports_external.enum(["low", "medium", "high", "critical"]).optional(),
+  assigned_to: exports_external.string().optional(),
+  project_id: exports_external.string().optional()
 }, async (params) => {
   try {
     const { taskFromTemplate: taskFromTemplate2 } = await Promise.resolve().then(() => (init_templates(), exports_templates));
@@ -6898,7 +6898,7 @@ ${task.id.slice(0, 8)} | ${task.priority} | ${task.title}` }] };
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
-server.tool("delete_template", "Delete a task template", { id: exports_external.string().describe("Template ID") }, async ({ id }) => {
+server.tool("delete_template", "Delete a task template", { id: exports_external.string() }, async ({ id }) => {
   try {
     const { deleteTemplate: deleteTemplate2 } = await Promise.resolve().then(() => (init_templates(), exports_templates));
     const deleted = deleteTemplate2(id);
@@ -6908,8 +6908,8 @@ server.tool("delete_template", "Delete a task template", { id: exports_external.
   }
 });
 server.tool("approve_task", "Approve a task that requires approval.", {
-  id: exports_external.string().describe("Task ID (full or partial)"),
-  agent_id: exports_external.string().optional().describe("Agent approving the task")
+  id: exports_external.string(),
+  agent_id: exports_external.string().optional()
 }, async ({ id, agent_id }) => {
   try {
     const resolvedId = resolveId(id);
@@ -6927,7 +6927,7 @@ server.tool("approve_task", "Approve a task that requires approval.", {
   }
 });
 server.tool("get_my_tasks", "Get assigned tasks and stats for an agent.", {
-  agent_name: exports_external.string().describe("Your agent name")
+  agent_name: exports_external.string()
 }, async ({ agent_name }) => {
   try {
     const agent = registerAgent({ name: agent_name });
@@ -6959,7 +6959,7 @@ In Progress:`);
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
-server.tool("search_tools", "List tool names matching a query.", { query: exports_external.string().optional().describe("Keyword to filter tools") }, async ({ query }) => {
+server.tool("search_tools", "List tool names matching a query.", { query: exports_external.string().optional() }, async ({ query }) => {
   const all = [
     "create_task",
     "list_tasks",
@@ -7008,7 +7008,7 @@ server.tool("search_tools", "List tool names matching a query.", { query: export
   const matches = q ? all.filter((n) => n.includes(q)) : all;
   return { content: [{ type: "text", text: matches.join(", ") }] };
 });
-server.tool("describe_tools", "Get descriptions for specific tools by name.", { names: exports_external.array(exports_external.string()).describe("Tool names from search_tools") }, async ({ names }) => {
+server.tool("describe_tools", "Get descriptions for specific tools by name.", { names: exports_external.array(exports_external.string()) }, async ({ names }) => {
   const descriptions = {
     create_task: "Create a task. Params: title(req), description, priority, project_id, plan_id, tags, assigned_to, estimated_minutes, requires_approval",
     list_tasks: "List tasks. Params: status, priority, project_id, plan_id, assigned_to, tags, limit",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/todos",
-  "version": "0.9.26",
+  "version": "0.9.28",
   "description": "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
   "type": "module",
   "main": "dist/index.js",