@hasna/todos 0.9.23 → 0.9.24

package/dist/mcp/index.js

@@ -6196,7 +6196,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 {
@@ -6244,7 +6244,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"),
@@ -6282,7 +6282,7 @@ server.tool("delete_task", "Delete a task permanently", {
     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 }) => {
@@ -6295,7 +6295,7 @@ ${formatTask(task)}` }] };
     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 }) => {
@@ -6335,7 +6335,7 @@ server.tool("unlock_task", "Release exclusive lock on a 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 }) => {
@@ -6526,7 +6526,7 @@ server.tool("delete_plan", "Delete a plan", {
     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")
@@ -6546,7 +6546,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"),
@@ -6594,7 +6594,7 @@ server.tool("sync", "Sync tasks with an agent task list (Claude uses native task
     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 }) => {
@@ -6754,7 +6754,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 {
@@ -6770,7 +6770,7 @@ server.tool("delete_task_list", "Delete a task list. Tasks in this list keep the
     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 {
@@ -6787,7 +6787,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 {
@@ -6803,7 +6803,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")
@@ -6841,7 +6841,7 @@ server.tool("delete_webhook", "Delete a webhook", {
     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"),
@@ -6872,7 +6872,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"),
@@ -6905,7 +6905,7 @@ server.tool("delete_template", "Delete a task template", { id: exports_external.
     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 }) => {
@@ -6924,7 +6924,7 @@ server.tool("approve_task", "Approve a task that requires approval before comple
     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 {
@@ -6957,6 +6957,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" }] };

package/package.json

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