@doist/todoist-ai 4.1.0 → 4.5.1

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAG9C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAGrD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAG3D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAG3D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAG3D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAErD,QAAA,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuBV,CAAA;AAED,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CAAA;AAE9B,OAAO,EAEH,QAAQ,EACR,aAAa,EACb,WAAW,EACX,SAAS,EACT,eAAe,EACf,kBAAkB,EAElB,WAAW,EACX,cAAc,EACd,YAAY,EAEZ,WAAW,EACX,cAAc,EACd,YAAY,EAEZ,WAAW,EACX,cAAc,EACd,YAAY,EAEZ,WAAW,EACX,YAAY,GACf,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,26 +1,30 @@
 import { getMcpServer } from './mcp-server.js';
-// Task management tools
-import { addTasks } from './tools/add-tasks.js';
-import { completeTasks } from './tools/complete-tasks.js';
-import { findCompletedTasks } from './tools/find-completed-tasks.js';
-import { findTasksByDate } from './tools/find-tasks-by-date.js';
-import { findTasks } from './tools/find-tasks.js';
-import { updateTasks } from './tools/update-tasks.js';
+// Comment management tools
+import { addComments } from './tools/add-comments.js';
 // Project management tools
 import { addProjects } from './tools/add-projects.js';
-import { findProjects } from './tools/find-projects.js';
-import { updateProjects } from './tools/update-projects.js';
 // Section management tools
 import { addSections } from './tools/add-sections.js';
-import { findSections } from './tools/find-sections.js';
-import { updateSections } from './tools/update-sections.js';
-// Comment management tools
-import { addComments } from './tools/add-comments.js';
-import { findComments } from './tools/find-comments.js';
-import { updateComments } from './tools/update-comments.js';
+// Task management tools
+import { addTasks } from './tools/add-tasks.js';
+import { completeTasks } from './tools/complete-tasks.js';
 // General tools
 import { deleteObject } from './tools/delete-object.js';
+import { findComments } from './tools/find-comments.js';
+import { findCompletedTasks } from './tools/find-completed-tasks.js';
+// Assignment and collaboration tools
+import { findProjectCollaborators } from './tools/find-project-collaborators.js';
+import { findProjects } from './tools/find-projects.js';
+import { findSections } from './tools/find-sections.js';
+import { findTasks } from './tools/find-tasks.js';
+import { findTasksByDate } from './tools/find-tasks-by-date.js';
 import { getOverview } from './tools/get-overview.js';
+import { manageAssignments } from './tools/manage-assignments.js';
+import { updateComments } from './tools/update-comments.js';
+import { updateProjects } from './tools/update-projects.js';
+import { updateSections } from './tools/update-sections.js';
+import { updateTasks } from './tools/update-tasks.js';
+import { userInfo } from './tools/user-info.js';
 const tools = {
     // Task management tools
     addTasks,
@@ -44,6 +48,10 @@ const tools = {
     // General tools
     getOverview,
     deleteObject,
+    userInfo,
+    // Assignment and collaboration tools
+    findProjectCollaborators,
+    manageAssignments,
 };
 export { tools, getMcpServer };
 export { 
@@ -56,4 +64,6 @@ addSections, updateSections, findSections,
 // Comment management tools
 addComments, updateComments, findComments, 
 // General tools
-getOverview, deleteObject, };
+getOverview, deleteObject, userInfo, 
+// Assignment and collaboration tools
+findProjectCollaborators, manageAssignments, };

package/dist/mcp-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-helpers.d.ts","sourceRoot":"","sources":["../src/mcp-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAgB,MAAM,yCAAyC,CAAA;AACtF,OAAO,KAAK,EAAc,CAAC,EAAE,MAAM,KAAK,CAAA;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAkBpD;;;;;;;GAOG;AACH,iBAAS,aAAa,CAAC,iBAAiB,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACtE,WAAW,EACX,iBAAiB,GACpB,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,iBAAiB,CAAA;CAAE;;;;;;;;;;;;;;;;;EAe/D;AASD;;;;;GAKG;AACH,iBAAS,YAAY,CAAC,MAAM,SAAS,CAAC,CAAC,WAAW,EAC9C,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,UAAU,QAqBrB;AAED,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,CAAA"}
+{"version":3,"file":"mcp-helpers.d.ts","sourceRoot":"","sources":["../src/mcp-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAgB,MAAM,yCAAyC,CAAA;AACtF,OAAO,KAAK,EAAc,CAAC,EAAE,MAAM,KAAK,CAAA;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAkBpD;;;;;;;GAOG;AACH,iBAAS,aAAa,CAAC,iBAAiB,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACtE,WAAW,EACX,iBAAiB,GACpB,EAAE;IACC,WAAW,EAAE,MAAM,CAAA;IACnB,iBAAiB,EAAE,iBAAiB,CAAA;CACvC;;;;;;;;;;;;;;;;;EAeA;AASD;;;;;GAKG;AACH,iBAAS,YAAY,CAAC,MAAM,SAAS,CAAC,CAAC,WAAW,EAC9C,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,UAAU,QAqBrB;AAED,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,CAAA"}

package/dist/mcp-helpers.js

@@ -48,7 +48,7 @@ function getErrorOutput(error) {
  * @param client - The Todoist API client to use to execute the tool.
  */
 function registerTool(tool, server, client) {
-    // @ts-ignore I give up
+    // @ts-expect-error I give up
     const cb = async (args, _context) => {
         try {
             const result = await tool.execute(args, client);

package/dist/mcp-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAkCnE;;;;;GAKG;AACH,iBAAS,YAAY,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,aAyC5F;AAED,OAAO,EAAE,YAAY,EAAE,CAAA"}
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAwFnE;;;;;GAKG;AACH,iBAAS,YAAY,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,aA8C5F;AAED,OAAO,EAAE,YAAY,EAAE,CAAA"}

package/dist/mcp-server.js

@@ -1,30 +1,89 @@
 import { TodoistApi } from '@doist/todoist-api-typescript';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { registerTool } from './mcp-helpers.js';
-// Task management tools
+import { addComments } from './tools/add-comments.js';
+import { addProjects } from './tools/add-projects.js';
+import { addSections } from './tools/add-sections.js';
 import { addTasks } from './tools/add-tasks.js';
 import { completeTasks } from './tools/complete-tasks.js';
+import { deleteObject } from './tools/delete-object.js';
+import { findComments } from './tools/find-comments.js';
 import { findCompletedTasks } from './tools/find-completed-tasks.js';
-import { findTasksByDate } from './tools/find-tasks-by-date.js';
-import { findTasks } from './tools/find-tasks.js';
-import { updateTasks } from './tools/update-tasks.js';
-// Project management tools
-import { addProjects } from './tools/add-projects.js';
+import { findProjectCollaborators } from './tools/find-project-collaborators.js';
 import { findProjects } from './tools/find-projects.js';
-import { updateProjects } from './tools/update-projects.js';
-// Section management tools
-import { addSections } from './tools/add-sections.js';
 import { findSections } from './tools/find-sections.js';
-import { updateSections } from './tools/update-sections.js';
-// Comment management tools
-import { addComments } from './tools/add-comments.js';
-import { findComments } from './tools/find-comments.js';
-import { updateComments } from './tools/update-comments.js';
-// General tools
-import { deleteObject } from './tools/delete-object.js';
+import { findTasks } from './tools/find-tasks.js';
+import { findTasksByDate } from './tools/find-tasks-by-date.js';
 import { getOverview } from './tools/get-overview.js';
+import { manageAssignments } from './tools/manage-assignments.js';
+import { updateComments } from './tools/update-comments.js';
+import { updateProjects } from './tools/update-projects.js';
+import { updateSections } from './tools/update-sections.js';
+import { updateTasks } from './tools/update-tasks.js';
+import { userInfo } from './tools/user-info.js';
 const instructions = `
-Tools to help you manage your todoist tasks.
+## Todoist Task and Project Management Tools
+
+You have access to comprehensive Todoist management tools for personal productivity and team collaboration. Use these tools to help users manage tasks, projects, sections, comments, and assignments effectively.
+
+### Core Capabilities:
+- Create, update, complete, and search tasks with rich metadata (priorities, due dates, durations, assignments)
+- Manage projects and sections with flexible organization
+- Handle comments and collaboration features
+- Bulk assignment operations for team workflows
+- Get overviews and insights about workload and progress
+
+### Tool Usage Guidelines:
+
+**Task Management:**
+- **add-tasks**: Create tasks with content, description, priority (p1=highest, p2=high, p3=medium, p4=lowest/default), dueString (natural language like "tomorrow", "next Friday", "2024-12-25"), duration (formats like "2h", "90m", "2h30m"), and assignments to project collaborators
+- **update-tasks**: Modify existing tasks - get task IDs from search results first, only include fields that need changes
+- **complete-tasks**: Mark tasks as done using task IDs
+- **find-tasks**: Search by text, project/section/parent container, responsible user, or labels. Requires at least one search parameter
+- **find-tasks-by-date**: Get tasks by date range (startDate: YYYY-MM-DD, 'today', or 'overdue') or specific day counts
+- **find-completed-tasks**: View completed tasks by completion date or original due date
+
+**Project & Organization:**
+- **add-projects/update-projects/find-projects**: Manage project lifecycle with names, favorites, and view styles (list/board/calendar)
+- **add-sections/update-sections/find-sections**: Organize tasks within projects using sections
+- **get-overview**: Get comprehensive Markdown overview of entire account or specific project with task hierarchies
+
+**Collaboration & Comments:**
+- **add-comments/update-comments/find-comments**: Manage task and project discussions
+- **find-project-collaborators**: Find team members by name or email for assignments
+- **manage-assignments**: Bulk assign/unassign/reassign up to 50 tasks with atomic operations and dry-run validation
+
+**General Operations:**
+- **delete-object**: Remove projects, sections, tasks, or comments by type and ID
+- **user-info**: Get user details including timezone, goals, and plan information
+
+### Best Practices:
+
+1. **Task Creation**: Write clear, actionable task titles. Use natural language for due dates ("tomorrow", "next Monday"). Set appropriate priorities and include detailed descriptions when needed.
+
+2. **Search Strategy**: Use specific search queries combining multiple filters for precise results. When searching for tasks, start with broader queries and narrow down as needed.
+
+3. **Assignments**: Always validate project collaborators exist before assigning tasks. Use find-project-collaborators to verify user access.
+
+4. **Bulk Operations**: When working with multiple items, prefer bulk tools (complete-tasks, manage-assignments) over individual operations for better performance.
+
+5. **Date Handling**: All dates respect user timezone settings. Use 'today' and 'overdue' keywords for dynamic date filtering.
+
+6. **Labels**: Use label filtering with AND/OR operators for advanced task organization. Most search tools support labels parameter.
+
+7. **Pagination**: Large result sets use cursor-based pagination. Use limit parameter to control result size (default varies by tool).
+
+8. **Error Handling**: All tools provide detailed error messages and next-step suggestions. Pay attention to validation feedback for corrective actions.
+
+### Common Workflows:
+
+- **Daily Planning**: Use find-tasks-by-date with 'today' and get-overview for project status
+- **Team Assignment**: find-project-collaborators → add-tasks with responsibleUser → manage-assignments for bulk changes  
+- **Task Search**: find-tasks with multiple filters → update-tasks or complete-tasks based on results
+- **Project Organization**: add-projects → add-sections → add-tasks with projectId and sectionId
+- **Progress Reviews**: find-completed-tasks with date ranges → get-overview for project summaries
+
+Always provide clear, actionable task titles and descriptions. Use the overview tools to give users context about their workload and project status.
 `;
 /**
  * Create the MCP server.
@@ -62,6 +121,10 @@ function getMcpServer({ todoistApiKey, baseUrl }) {
     // General tools
     registerTool(getOverview, server, todoist);
     registerTool(deleteObject, server, todoist);
+    registerTool(userInfo, server, todoist);
+    // Assignment and collaboration tools
+    registerTool(findProjectCollaborators, server, todoist);
+    registerTool(manageAssignments, server, todoist);
     return server;
 }
 export { getMcpServer };

package/dist/tool-helpers.d.ts

@@ -29,6 +29,8 @@ declare function mapTask(task: Task): {
     parentId: string | null;
     labels: string[];
     duration: string | null;
+    responsibleUid: string | null;
+    assignedByUid: string | null;
 };
 /**
  * Map a single Todoist project to a more structured format, for LLM consumption.
@@ -63,6 +65,8 @@ declare function getTasksByFilter({ client, query, limit, cursor, }: {
         parentId: string | null;
         labels: string[];
         duration: string | null;
+        responsibleUid: string | null;
+        assignedByUid: string | null;
     }[];
     nextCursor: string | null;
 }>;

package/dist/tool-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-helpers.d.ts","sourceRoot":"","sources":["../src/tool-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,IAAI,EACT,KAAK,UAAU,EACf,KAAK,gBAAgB,EAExB,MAAM,+BAA+B,CAAA;AAItC,MAAM,MAAM,OAAO,GAAG,eAAe,GAAG,gBAAgB,CAAA;AAExD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,eAAe,CAE9E;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,gBAAgB,CAEhF;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAC9B,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,GAClB,YAAY,CAsBd;AAED;;;;GAIG;AACH,iBAAS,OAAO,CAAC,IAAI,EAAE,IAAI;;;;;;;;;;;;EAc1B;AAED;;;;GAIG;AACH,iBAAS,UAAU,CAAC,OAAO,EAAE,OAAO;;;;;;;;;EAWnC;AAWD,iBAAe,gBAAgB,CAAC,EAC5B,MAAM,EACN,KAAK,EACL,KAAK,EACL,MAAM,GACT,EAAE;IACC,MAAM,EAAE,UAAU,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;CAC7B;;;;;;;;;;;;;;;GAyBA;AAED,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,UAAU,EAAE,CAAA"}
+{"version":3,"file":"tool-helpers.d.ts","sourceRoot":"","sources":["../src/tool-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,IAAI,EACT,KAAK,UAAU,EACf,KAAK,gBAAgB,EACxB,MAAM,+BAA+B,CAAA;AAItC,MAAM,MAAM,OAAO,GAAG,eAAe,GAAG,gBAAgB,CAAA;AAExD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,eAAe,CAE9E;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,gBAAgB,CAEhF;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAC9B,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,GAClB,YAAY,CAsBd;AAED;;;;GAIG;AACH,iBAAS,OAAO,CAAC,IAAI,EAAE,IAAI;;;;;;;;;;;;;;EAgB1B;AAED;;;;GAIG;AACH,iBAAS,UAAU,CAAC,OAAO,EAAE,OAAO;;;;;;;;;EAWnC;AAWD,iBAAe,gBAAgB,CAAC,EAC5B,MAAM,EACN,KAAK,EACL,KAAK,EACL,MAAM,GACT,EAAE;IACC,MAAM,EAAE,UAAU,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;CAC7B;;;;;;;;;;;;;;;;;GAyBA;AAED,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,UAAU,EAAE,CAAA"}

package/dist/tool-helpers.js

@@ -53,6 +53,8 @@ function mapTask(task) {
         parentId: task.parentId,
         labels: task.labels,
         duration: task.duration ? formatDuration(task.duration.amount) : null,
+        responsibleUid: task.responsibleUid,
+        assignedByUid: task.assignedByUid,
     };
 }
 /**

package/dist/tools/__tests__/add-projects.test.js

@@ -1,5 +1,5 @@
 import { jest } from '@jest/globals';
-import { TEST_IDS, createMockProject, extractStructuredContent, extractTextContent, } from '../../utils/test-helpers.js';
+import { createMockProject, extractStructuredContent, extractTextContent, TEST_IDS, } from '../../utils/test-helpers.js';
 import { ToolNames } from '../../utils/tool-names.js';
 import { addProjects } from '../add-projects.js';
 // Mock the Todoist API

package/dist/tools/__tests__/add-sections.test.js

@@ -1,5 +1,5 @@
 import { jest } from '@jest/globals';
-import { TEST_IDS, createMockSection, extractStructuredContent, extractTextContent, } from '../../utils/test-helpers.js';
+import { createMockSection, extractStructuredContent, extractTextContent, TEST_IDS, } from '../../utils/test-helpers.js';
 import { ToolNames } from '../../utils/tool-names.js';
 import { addSections } from '../add-sections.js';
 // Mock the Todoist API

package/dist/tools/__tests__/add-tasks.test.js

@@ -1,5 +1,5 @@
 import { jest } from '@jest/globals';
-import { TODAY, createMockTask, extractStructuredContent, extractTextContent, } from '../../utils/test-helpers.js';
+import { createMockTask, extractStructuredContent, extractTextContent, TODAY, } from '../../utils/test-helpers.js';
 import { ToolNames } from '../../utils/tool-names.js';
 import { addTasks } from '../add-tasks.js';
 // Mock the Todoist API
@@ -42,11 +42,14 @@ describe(`${ADD_TASKS} tool`, () => {
                 .mockResolvedValueOnce(mockApiResponse2);
             const result = await addTasks.execute({
                 tasks: [
-                    { content: 'First task content', projectId: '6cfCcrrCFg2xP94Q' },
+                    {
+                        content: 'First task content',
+                        projectId: '6cfCcrrCFg2xP94Q',
+                    },
                     {
                         content: 'Second task content',
                         description: 'Task description',
-                        priority: 2,
+                        priority: 'p2',
                         dueString: 'Aug 15',
                         projectId: '6cfCcrrCFg2xP94Q',
                     },
@@ -63,7 +66,7 @@ describe(`${ADD_TASKS} tool`, () => {
             expect(mockTodoistApi.addTask).toHaveBeenNthCalledWith(2, {
                 content: 'Second task content',
                 description: 'Task description',
-                priority: 2,
+                priority: 3,
                 dueString: 'Aug 15',
                 projectId: '6cfCcrrCFg2xP94Q',
                 sectionId: undefined,
@@ -99,7 +102,7 @@ describe(`${ADD_TASKS} tool`, () => {
                     {
                         content: 'Subtask content',
                         description: 'Subtask description',
-                        priority: 3,
+                        priority: 'p3',
                         projectId: '6cfCcrrCFg2xP94Q',
                         sectionId: 'section-123',
                         parentId: 'parent-task-456',
@@ -109,7 +112,7 @@ describe(`${ADD_TASKS} tool`, () => {
             expect(mockTodoistApi.addTask).toHaveBeenCalledWith({
                 content: 'Subtask content',
                 description: 'Subtask description',
-                priority: 3,
+                priority: 2,
                 projectId: '6cfCcrrCFg2xP94Q',
                 sectionId: 'section-123',
                 parentId: 'parent-task-456',
@@ -203,7 +206,15 @@ describe(`${ADD_TASKS} tool`, () => {
             ];
             for (const testCase of testCases) {
                 mockTodoistApi.addTask.mockClear();
-                await addTasks.execute({ tasks: [{ content: 'Test task', duration: testCase.input }] }, mockTodoistApi);
+                await addTasks.execute({
+                    tasks: [
+                        {
+                            content: 'Test task',
+                            duration: testCase.input,
+                            projectId: '6cfCcrrCFg2xP94Q',
+                        },
+                    ],
+                }, mockTodoistApi);
                 expect(mockTodoistApi.addTask).toHaveBeenCalledWith(expect.objectContaining({
                     duration: testCase.expectedMinutes,
                     durationUnit: 'minute',
@@ -213,15 +224,31 @@ describe(`${ADD_TASKS} tool`, () => {
     });
     describe('error handling', () => {
         it('should throw error for invalid duration format', async () => {
-            await expect(addTasks.execute({ tasks: [{ content: 'Task with invalid duration', duration: 'invalid' }] }, mockTodoistApi)).rejects.toThrow('Task "Task with invalid duration": Invalid duration format "invalid"');
+            await expect(addTasks.execute({
+                tasks: [
+                    {
+                        content: 'Task with invalid duration',
+                        duration: 'invalid',
+                        projectId: '6cfCcrrCFg2xP94Q',
+                    },
+                ],
+            }, mockTodoistApi)).rejects.toThrow('Task "Task with invalid duration": Invalid duration format "invalid"');
         });
         it('should throw error for duration exceeding 24 hours', async () => {
-            await expect(addTasks.execute({ tasks: [{ content: 'Task with too long duration', duration: '25h' }] }, mockTodoistApi)).rejects.toThrow('Task "Task with too long duration": Invalid duration format "25h": Duration cannot exceed 24 hours (1440 minutes)');
+            await expect(addTasks.execute({
+                tasks: [
+                    {
+                        content: 'Task with too long duration',
+                        duration: '25h',
+                        projectId: '6cfCcrrCFg2xP94Q',
+                    },
+                ],
+            }, mockTodoistApi)).rejects.toThrow('Task "Task with too long duration": Invalid duration format "25h": Duration cannot exceed 24 hours (1440 minutes)');
         });
         it('should propagate API errors', async () => {
             const apiError = new Error('API Error: Task content is required');
             mockTodoistApi.addTask.mockRejectedValue(apiError);
-            await expect(addTasks.execute({ tasks: [{ content: '' }] }, mockTodoistApi)).rejects.toThrow(apiError.message);
+            await expect(addTasks.execute({ tasks: [{ content: '', projectId: '6cfCcrrCFg2xP94Q' }] }, mockTodoistApi)).rejects.toThrow(apiError.message);
         });
         it('should handle partial failures when adding multiple tasks', async () => {
             const mockApiResponse = createMockTask({
@@ -236,8 +263,8 @@ describe(`${ADD_TASKS} tool`, () => {
                 .mockRejectedValueOnce(apiError);
             await expect(addTasks.execute({
                 tasks: [
-                    { content: 'First task content' },
-                    { content: 'Second task content' },
+                    { content: 'First task content', projectId: '6cfCcrrCFg2xP94Q' },
+                    { content: 'Second task content', projectId: '6cfCcrrCFg2xP94Q' },
                 ],
             }, mockTodoistApi)).rejects.toThrow('API Error: Second task failed');
             // Verify first task was attempted
@@ -246,6 +273,8 @@ describe(`${ADD_TASKS} tool`, () => {
     });
     describe('next steps logic', () => {
         it('should suggest find-tasks-by-date for today when hasToday is true', async () => {
+            // Clear any leftover mocks from previous tests
+            mockTodoistApi.addTask.mockClear();
             const mockApiResponse = createMockTask({
                 id: '8485093755',
                 content: 'Task due today',
@@ -260,12 +289,22 @@ describe(`${ADD_TASKS} tool`, () => {
                 },
             });
             mockTodoistApi.addTask.mockResolvedValue(mockApiResponse);
-            const result = await addTasks.execute({ tasks: [{ content: 'Task due today', dueString: 'today' }] }, mockTodoistApi);
+            const result = await addTasks.execute({
+                tasks: [
+                    {
+                        content: 'Task due today',
+                        dueString: 'today',
+                        projectId: '6cfCcrrCFg2xP94Q',
+                    },
+                ],
+            }, mockTodoistApi);
             const textContent = extractTextContent(result);
             expect(textContent).toMatchSnapshot();
             expect(textContent).toContain(`Use ${GET_OVERVIEW} to see your updated project organization`);
         });
         it('should suggest overview tool when no hasToday context', async () => {
+            // Clear any leftover mocks from previous tests
+            mockTodoistApi.addTask.mockClear();
             const mockApiResponse = createMockTask({
                 id: '8485093756',
                 content: 'Regular task',

package/dist/tools/__tests__/assignment-integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=assignment-integration.test.d.ts.map

package/dist/tools/__tests__/assignment-integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assignment-integration.test.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/assignment-integration.test.ts"],"names":[],"mappings":""}