@doist/todoist-ai 1.1.0 → 2.0.1

package/dist/mcp-server.js

@@ -1,32 +1,20 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getMcpServer = getMcpServer;
-const todoist_api_typescript_1 = require("@doist/todoist-api-typescript");
-const mcp_1 = require("@modelcontextprotocol/sdk/server/mcp");
-const mcp_helpers_1 = require("./mcp-helpers");
-const projects_add_one_1 = require("./tools/projects-add-one");
-const projects_delete_one_1 = require("./tools/projects-delete-one");
-const projects_list_1 = require("./tools/projects-list");
-const projects_search_1 = require("./tools/projects-search");
-const projects_update_one_1 = require("./tools/projects-update-one");
-const sections_add_one_1 = require("./tools/sections-add-one");
-const sections_delete_one_1 = require("./tools/sections-delete-one");
-const sections_search_1 = require("./tools/sections-search");
-const sections_update_one_1 = require("./tools/sections-update-one");
-const subtasks_list_for_parent_task_1 = require("./tools/subtasks-list-for-parent-task");
-const account_overview_1 = require("./tools/account-overview");
-const project_overview_1 = require("./tools/project-overview");
-const tasks_add_multiple_1 = require("./tools/tasks-add-multiple");
-const tasks_complete_multiple_1 = require("./tools/tasks-complete-multiple");
-const tasks_delete_one_1 = require("./tools/tasks-delete-one");
-const tasks_list_by_date_1 = require("./tools/tasks-list-by-date");
-const tasks_list_completed_1 = require("./tools/tasks-list-completed");
-const tasks_list_for_project_1 = require("./tools/tasks-list-for-project");
-const tasks_list_for_section_1 = require("./tools/tasks-list-for-section");
-const tasks_list_overdue_1 = require("./tools/tasks-list-overdue");
-const tasks_organize_multiple_1 = require("./tools/tasks-organize-multiple");
-const tasks_search_1 = require("./tools/tasks-search");
-const tasks_update_one_1 = require("./tools/tasks-update-one");
+import { TodoistApi } from '@doist/todoist-api-typescript';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { registerTool } from './mcp-helpers.js';
+import { deleteOne } from './tools/delete-one.js';
+import { projectsList } from './tools/projects-list.js';
+import { projectsManage } from './tools/projects-manage.js';
+import { sectionsManage } from './tools/sections-manage.js';
+import { sectionsSearch } from './tools/sections-search.js';
+import { overview } from './tools/overview.js';
+import { tasksAddMultiple } from './tools/tasks-add-multiple.js';
+import { tasksCompleteMultiple } from './tools/tasks-complete-multiple.js';
+import { tasksListByDate } from './tools/tasks-list-by-date.js';
+import { tasksListCompleted } from './tools/tasks-list-completed.js';
+import { tasksListForContainer } from './tools/tasks-list-for-container.js';
+import { tasksOrganizeMultiple } from './tools/tasks-organize-multiple.js';
+import { tasksSearch } from './tools/tasks-search.js';
+import { tasksUpdateOne } from './tools/tasks-update-one.js';
 const instructions = `
 Tools to help you manage your todoist tasks.
 `;
@@ -37,35 +25,27 @@ Tools to help you manage your todoist tasks.
  * @returns the MCP server.
  */
 function getMcpServer({ todoistApiKey, baseUrl }) {
-    const server = new mcp_1.McpServer({ name: 'todoist-mcp-server', version: '0.1.0' }, {
+    const server = new McpServer({ name: 'todoist-mcp-server', version: '0.1.0' }, {
         capabilities: {
             tools: { listChanged: true },
         },
         instructions,
     });
-    const todoist = new todoist_api_typescript_1.TodoistApi(todoistApiKey, baseUrl);
-    (0, mcp_helpers_1.registerTool)(tasks_list_completed_1.tasksListCompleted, server, todoist);
-    (0, mcp_helpers_1.registerTool)(tasks_list_by_date_1.tasksListByDate, server, todoist);
-    (0, mcp_helpers_1.registerTool)(tasks_list_overdue_1.tasksListOverdue, server, todoist);
-    (0, mcp_helpers_1.registerTool)(tasks_list_for_project_1.tasksListForProject, server, todoist);
-    (0, mcp_helpers_1.registerTool)(tasks_search_1.tasksSearch, server, todoist);
-    (0, mcp_helpers_1.registerTool)(projects_list_1.projectsList, server, todoist);
-    (0, mcp_helpers_1.registerTool)(tasks_add_multiple_1.tasksAddMultiple, server, todoist);
-    (0, mcp_helpers_1.registerTool)(tasks_update_one_1.tasksUpdateOne, server, todoist);
-    (0, mcp_helpers_1.registerTool)(tasks_delete_one_1.tasksDeleteOne, server, todoist);
-    (0, mcp_helpers_1.registerTool)(tasks_complete_multiple_1.tasksCompleteMultiple, server, todoist);
-    (0, mcp_helpers_1.registerTool)(projects_add_one_1.projectsAddOne, server, todoist);
-    (0, mcp_helpers_1.registerTool)(projects_update_one_1.projectsUpdateOne, server, todoist);
-    (0, mcp_helpers_1.registerTool)(sections_add_one_1.sectionsAddOne, server, todoist);
-    (0, mcp_helpers_1.registerTool)(sections_update_one_1.sectionsUpdateOne, server, todoist);
-    (0, mcp_helpers_1.registerTool)(tasks_organize_multiple_1.tasksOrganizeMultiple, server, todoist);
-    (0, mcp_helpers_1.registerTool)(subtasks_list_for_parent_task_1.subtasksListForParentTask, server, todoist);
-    (0, mcp_helpers_1.registerTool)(tasks_list_for_section_1.tasksListForSection, server, todoist);
-    (0, mcp_helpers_1.registerTool)(projects_delete_one_1.projectsDeleteOne, server, todoist);
-    (0, mcp_helpers_1.registerTool)(projects_search_1.projectsSearch, server, todoist);
-    (0, mcp_helpers_1.registerTool)(sections_delete_one_1.sectionsDeleteOne, server, todoist);
-    (0, mcp_helpers_1.registerTool)(sections_search_1.sectionsSearch, server, todoist);
-    (0, mcp_helpers_1.registerTool)(account_overview_1.accountOverview, server, todoist);
-    (0, mcp_helpers_1.registerTool)(project_overview_1.projectOverview, server, todoist);
+    const todoist = new TodoistApi(todoistApiKey, baseUrl);
+    registerTool(tasksListCompleted, server, todoist);
+    registerTool(tasksListByDate, server, todoist);
+    registerTool(tasksSearch, server, todoist);
+    registerTool(projectsList, server, todoist);
+    registerTool(tasksAddMultiple, server, todoist);
+    registerTool(tasksUpdateOne, server, todoist);
+    registerTool(deleteOne, server, todoist);
+    registerTool(tasksCompleteMultiple, server, todoist);
+    registerTool(projectsManage, server, todoist);
+    registerTool(sectionsManage, server, todoist);
+    registerTool(tasksOrganizeMultiple, server, todoist);
+    registerTool(sectionsSearch, server, todoist);
+    registerTool(overview, server, todoist);
+    registerTool(tasksListForContainer, server, todoist);
     return server;
 }
+export { getMcpServer };

package/dist/todoist-tool.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/dist/{tools/shared.d.ts → tool-helpers.d.ts}

@@ -1,7 +1,17 @@
-import { type PersonalProject, type Task, type TodoistApi, type WorkspaceProject } from '@doist/todoist-api-typescript';
+import { type MoveTaskArgs, type PersonalProject, type Task, type TodoistApi, type WorkspaceProject } from '@doist/todoist-api-typescript';
 export type Project = PersonalProject | WorkspaceProject;
 export declare function isPersonalProject(project: Project): project is PersonalProject;
 export declare function isWorkspaceProject(project: Project): project is WorkspaceProject;
+/**
+ * Creates a MoveTaskArgs object from move parameters, validating that exactly one is provided.
+ * @param taskId - The task ID (used for error messages)
+ * @param projectId - Optional project ID to move to
+ * @param sectionId - Optional section ID to move to
+ * @param parentId - Optional parent ID to move to
+ * @returns MoveTaskArgs object with exactly one destination
+ * @throws Error if multiple move parameters are provided or none are provided
+ */
+export declare function createMoveTaskArgs(taskId: string, projectId?: string, sectionId?: string, parentId?: string): MoveTaskArgs;
 /**
  * Map a single Todoist task to a more structured format, for LLM consumption.
  * @param task - The task to map.
@@ -55,4 +65,4 @@ declare function getTasksByFilter({ client, query, limit, cursor, }: {
     nextCursor: string | null;
 }>;
 export { getTasksByFilter, mapTask, mapProject };
-//# sourceMappingURL=shared.d.ts.map
+//# sourceMappingURL=tool-helpers.d.ts.map

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

@@ -0,0 +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;AAGtC,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;;;;;;;;;;;EAa1B;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/{tools/shared.js → tool-helpers.js}

@@ -1,21 +1,39 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isPersonalProject = isPersonalProject;
-exports.isWorkspaceProject = isWorkspaceProject;
-exports.getTasksByFilter = getTasksByFilter;
-exports.mapTask = mapTask;
-exports.mapProject = mapProject;
-const todoist_api_typescript_1 = require("@doist/todoist-api-typescript");
-const zod_1 = __importDefault(require("zod"));
-function isPersonalProject(project) {
+import { getSanitizedContent, } from '@doist/todoist-api-typescript';
+import z from 'zod';
+export function isPersonalProject(project) {
     return 'inboxProject' in project;
 }
-function isWorkspaceProject(project) {
+export function isWorkspaceProject(project) {
     return 'accessLevel' in project;
 }
+/**
+ * Creates a MoveTaskArgs object from move parameters, validating that exactly one is provided.
+ * @param taskId - The task ID (used for error messages)
+ * @param projectId - Optional project ID to move to
+ * @param sectionId - Optional section ID to move to
+ * @param parentId - Optional parent ID to move to
+ * @returns MoveTaskArgs object with exactly one destination
+ * @throws Error if multiple move parameters are provided or none are provided
+ */
+export function createMoveTaskArgs(taskId, projectId, sectionId, parentId) {
+    // Validate that only one move parameter is provided (RequireExactlyOne constraint)
+    const moveParams = [projectId, sectionId, parentId].filter(Boolean);
+    if (moveParams.length > 1) {
+        throw new Error(`Task ${taskId}: Only one of projectId, sectionId, or parentId can be specified at a time. The Todoist API requires exactly one destination for move operations.`);
+    }
+    if (moveParams.length === 0) {
+        throw new Error(`Task ${taskId}: At least one of projectId, sectionId, or parentId must be provided for move operations.`);
+    }
+    // Build moveArgs with the single defined value
+    if (projectId)
+        return { projectId };
+    if (sectionId)
+        return { sectionId };
+    if (parentId)
+        return { parentId };
+    // This should never be reached due to the validation above
+    throw new Error('Unexpected error: No valid move parameter found');
+}
 /**
  * Map a single Todoist task to a more structured format, for LLM consumption.
  * @param task - The task to map.
@@ -24,8 +42,8 @@ function isWorkspaceProject(project) {
 function mapTask(task) {
     return {
         id: task.id,
-        content: (0, todoist_api_typescript_1.getSanitizedContent)(task.content),
-        description: (0, todoist_api_typescript_1.getSanitizedContent)(task.description),
+        content: getSanitizedContent(task.content),
+        description: getSanitizedContent(task.description),
         dueDate: task.due?.date,
         recurring: task.due?.isRecurring && task.due.string ? task.due.string : false,
         priority: task.priority,
@@ -52,12 +70,12 @@ function mapProject(project) {
         viewStyle: project.viewStyle,
     };
 }
-const ErrorSchema = zod_1.default.object({
-    httpStatusCode: zod_1.default.number(),
-    responseData: zod_1.default.object({
-        error: zod_1.default.string(),
-        errorCode: zod_1.default.number(),
-        errorTag: zod_1.default.string(),
+const ErrorSchema = z.object({
+    httpStatusCode: z.number(),
+    responseData: z.object({
+        error: z.string(),
+        errorCode: z.number(),
+        errorTag: z.string(),
     }),
 });
 async function getTasksByFilter({ client, query, limit, cursor, }) {
@@ -84,3 +102,4 @@ async function getTasksByFilter({ client, query, limit, cursor, }) {
         throw new Error(`${responseData.error} (tag: ${responseData.errorTag}, code: ${responseData.errorCode})`);
     }
 }
+export { getTasksByFilter, mapTask, mapProject };

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

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

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

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

package/dist/{tools/shared.test.js → tool-helpers.test.js}

@@ -1,6 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const shared_1 = require("./shared");
+import { createMoveTaskArgs, isPersonalProject, isWorkspaceProject, mapProject, mapTask, } from './tool-helpers.js';
 describe('shared utilities', () => {
     describe('mapTask', () => {
         it('should map a basic task correctly', () => {
@@ -21,8 +19,7 @@ describe('shared utilities', () => {
                     timezone: 'UTC',
                 },
             };
-            const result = (0, shared_1.mapTask)(mockTask);
-            expect(result).toEqual({
+            expect(mapTask(mockTask)).toEqual({
                 id: '123',
                 content: 'Test task',
                 description: 'Test description',
@@ -53,7 +50,7 @@ describe('shared utilities', () => {
                     timezone: 'UTC',
                 },
             };
-            const result = (0, shared_1.mapTask)(mockTask);
+            const result = mapTask(mockTask);
             expect(result.recurring).toBe('every day');
         });
     });
@@ -69,8 +66,7 @@ describe('shared utilities', () => {
                 inboxProject: false,
                 viewStyle: 'list',
             };
-            const result = (0, shared_1.mapProject)(mockPersonalProject);
-            expect(result).toEqual({
+            expect(mapProject(mockPersonalProject)).toEqual({
                 id: 'proj-1',
                 name: 'Personal Project',
                 color: 'blue',
@@ -90,8 +86,7 @@ describe('shared utilities', () => {
                 isShared: true,
                 viewStyle: 'board',
             };
-            const result = (0, shared_1.mapProject)(mockWorkspaceProject);
-            expect(result).toEqual({
+            expect(mapProject(mockWorkspaceProject)).toEqual({
                 id: 'proj-2',
                 name: 'Workspace Project',
                 color: 'red',
@@ -115,8 +110,8 @@ describe('shared utilities', () => {
                 inboxProject: true,
                 viewStyle: 'list',
             };
-            expect((0, shared_1.isPersonalProject)(personalProject)).toBe(true);
-            expect((0, shared_1.isWorkspaceProject)(personalProject)).toBe(false);
+            expect(isPersonalProject(personalProject)).toBe(true);
+            expect(isWorkspaceProject(personalProject)).toBe(false);
         });
         it('should correctly identify workspace projects', () => {
             const workspaceProject = {
@@ -128,8 +123,34 @@ describe('shared utilities', () => {
                 viewStyle: 'board',
                 accessLevel: 'admin',
             };
-            expect((0, shared_1.isWorkspaceProject)(workspaceProject)).toBe(true);
-            expect((0, shared_1.isPersonalProject)(workspaceProject)).toBe(false);
+            expect(isWorkspaceProject(workspaceProject)).toBe(true);
+            expect(isPersonalProject(workspaceProject)).toBe(false);
+        });
+    });
+    describe('createMoveTaskArgs', () => {
+        it('should create MoveTaskArgs for projectId', () => {
+            const result = createMoveTaskArgs('task-1', 'project-123');
+            expect(result).toEqual({ projectId: 'project-123' });
+        });
+        it('should create MoveTaskArgs for sectionId', () => {
+            const result = createMoveTaskArgs('task-1', undefined, 'section-456');
+            expect(result).toEqual({ sectionId: 'section-456' });
+        });
+        it('should create MoveTaskArgs for parentId', () => {
+            const result = createMoveTaskArgs('task-1', undefined, undefined, 'parent-789');
+            expect(result).toEqual({ parentId: 'parent-789' });
+        });
+        it('should throw error when multiple move parameters are provided', () => {
+            expect(() => createMoveTaskArgs('task-1', 'project-123', 'section-456')).toThrow('Task task-1: Only one of projectId, sectionId, or parentId can be specified at a time');
+        });
+        it('should throw error when all three move parameters are provided', () => {
+            expect(() => createMoveTaskArgs('task-1', 'project-123', 'section-456', 'parent-789')).toThrow('Task task-1: Only one of projectId, sectionId, or parentId can be specified at a time');
+        });
+        it('should throw error when no move parameters are provided', () => {
+            expect(() => createMoveTaskArgs('task-1')).toThrow('Task task-1: At least one of projectId, sectionId, or parentId must be provided');
+        });
+        it('should throw error when empty strings are provided', () => {
+            expect(() => createMoveTaskArgs('task-1', '', '', '')).toThrow('Task task-1: At least one of projectId, sectionId, or parentId must be provided');
         });
     });
 });

package/dist/tools/__tests__/delete-one.test.d.ts

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

package/dist/tools/__tests__/delete-one.test.d.ts.map

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

package/dist/tools/__tests__/delete-one.test.js

@@ -0,0 +1,90 @@
+import { jest } from '@jest/globals';
+import { deleteOne } from '../delete-one.js';
+// Mock the Todoist API
+const mockTodoistApi = {
+    deleteProject: jest.fn(),
+    deleteSection: jest.fn(),
+    deleteTask: jest.fn(),
+};
+describe('delete-one tool', () => {
+    beforeEach(() => {
+        jest.clearAllMocks();
+    });
+    describe('deleting projects', () => {
+        it('should delete a project by ID', async () => {
+            mockTodoistApi.deleteProject.mockResolvedValue(true);
+            const result = await deleteOne.execute({ type: 'project', id: '6cfCcrrCFg2xP94Q' }, mockTodoistApi);
+            // Verify API was called correctly
+            expect(mockTodoistApi.deleteProject).toHaveBeenCalledWith('6cfCcrrCFg2xP94Q');
+            expect(mockTodoistApi.deleteSection).not.toHaveBeenCalled();
+            expect(mockTodoistApi.deleteTask).not.toHaveBeenCalled();
+            // Verify success response
+            expect(result).toEqual({ success: true });
+        });
+        it('should propagate project deletion errors', async () => {
+            const apiError = new Error('API Error: Cannot delete project with tasks');
+            mockTodoistApi.deleteProject.mockRejectedValue(apiError);
+            await expect(deleteOne.execute({ type: 'project', id: 'project-with-tasks' }, mockTodoistApi)).rejects.toThrow('API Error: Cannot delete project with tasks');
+        });
+    });
+    describe('deleting sections', () => {
+        it('should delete a section by ID', async () => {
+            mockTodoistApi.deleteSection.mockResolvedValue(true);
+            const result = await deleteOne.execute({ type: 'section', id: 'section-123' }, mockTodoistApi);
+            // Verify API was called correctly
+            expect(mockTodoistApi.deleteSection).toHaveBeenCalledWith('section-123');
+            expect(mockTodoistApi.deleteProject).not.toHaveBeenCalled();
+            expect(mockTodoistApi.deleteTask).not.toHaveBeenCalled();
+            // Verify success response
+            expect(result).toEqual({ success: true });
+        });
+        it('should propagate section deletion errors', async () => {
+            const apiError = new Error('API Error: Section not found');
+            mockTodoistApi.deleteSection.mockRejectedValue(apiError);
+            await expect(deleteOne.execute({ type: 'section', id: 'non-existent-section' }, mockTodoistApi)).rejects.toThrow('API Error: Section not found');
+        });
+    });
+    describe('deleting tasks', () => {
+        it('should delete a task by ID', async () => {
+            mockTodoistApi.deleteTask.mockResolvedValue(true);
+            const result = await deleteOne.execute({ type: 'task', id: '8485093748' }, mockTodoistApi);
+            // Verify API was called correctly
+            expect(mockTodoistApi.deleteTask).toHaveBeenCalledWith('8485093748');
+            expect(mockTodoistApi.deleteProject).not.toHaveBeenCalled();
+            expect(mockTodoistApi.deleteSection).not.toHaveBeenCalled();
+            // Verify success response
+            expect(result).toEqual({ success: true });
+        });
+        it('should propagate task deletion errors', async () => {
+            const apiError = new Error('API Error: Task not found');
+            mockTodoistApi.deleteTask.mockRejectedValue(apiError);
+            await expect(deleteOne.execute({ type: 'task', id: 'non-existent-task' }, mockTodoistApi)).rejects.toThrow('API Error: Task not found');
+        });
+        it('should handle permission errors', async () => {
+            const apiError = new Error('API Error: Insufficient permissions to delete task');
+            mockTodoistApi.deleteTask.mockRejectedValue(apiError);
+            await expect(deleteOne.execute({ type: 'task', id: 'restricted-task' }, mockTodoistApi)).rejects.toThrow('API Error: Insufficient permissions to delete task');
+        });
+    });
+    describe('type validation', () => {
+        it('should handle all supported entity types', async () => {
+            // Test all three supported types work correctly
+            mockTodoistApi.deleteProject.mockResolvedValue(true);
+            mockTodoistApi.deleteSection.mockResolvedValue(true);
+            mockTodoistApi.deleteTask.mockResolvedValue(true);
+            // Delete project
+            await deleteOne.execute({ type: 'project', id: 'proj-1' }, mockTodoistApi);
+            expect(mockTodoistApi.deleteProject).toHaveBeenCalledWith('proj-1');
+            // Delete section
+            await deleteOne.execute({ type: 'section', id: 'sect-1' }, mockTodoistApi);
+            expect(mockTodoistApi.deleteSection).toHaveBeenCalledWith('sect-1');
+            // Delete task
+            await deleteOne.execute({ type: 'task', id: 'task-1' }, mockTodoistApi);
+            expect(mockTodoistApi.deleteTask).toHaveBeenCalledWith('task-1');
+            // Verify each API method was called exactly once
+            expect(mockTodoistApi.deleteProject).toHaveBeenCalledTimes(1);
+            expect(mockTodoistApi.deleteSection).toHaveBeenCalledTimes(1);
+            expect(mockTodoistApi.deleteTask).toHaveBeenCalledTimes(1);
+        });
+    });
+});

package/dist/tools/__tests__/overview.test.d.ts

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

package/dist/tools/__tests__/overview.test.d.ts.map

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

package/dist/tools/__tests__/overview.test.js

@@ -0,0 +1,163 @@
+import { jest } from '@jest/globals';
+import { overview } from '../overview.js';
+import { TEST_ERRORS, TEST_IDS, createMockProject, createMockSection, createMockTask, } from '../test-helpers.js';
+// Mock the Todoist API
+const mockTodoistApi = {
+    getProjects: jest.fn(),
+    getProject: jest.fn(),
+    getSections: jest.fn(),
+    getTasks: jest.fn(),
+};
+describe('overview tool', () => {
+    beforeEach(() => {
+        jest.clearAllMocks();
+    });
+    describe('account overview (no projectId)', () => {
+        it('should generate account overview with projects and sections', async () => {
+            const mockProjects = [
+                createMockProject({
+                    id: TEST_IDS.PROJECT_INBOX,
+                    name: 'Inbox',
+                    color: 'grey',
+                    inboxProject: true,
+                    childOrder: 0,
+                }),
+                createMockProject({
+                    id: TEST_IDS.PROJECT_TEST,
+                    name: 'test-abc123def456-project',
+                    childOrder: 1,
+                }),
+            ];
+            const mockSections = [
+                createMockSection({
+                    id: TEST_IDS.SECTION_1,
+                    projectId: TEST_IDS.PROJECT_TEST,
+                    name: 'test-section',
+                }),
+            ];
+            mockTodoistApi.getProjects.mockResolvedValue({
+                results: mockProjects,
+                nextCursor: null,
+            });
+            mockTodoistApi.getSections.mockImplementation(({ projectId }) => {
+                if (projectId === TEST_IDS.PROJECT_TEST) {
+                    return Promise.resolve({ results: mockSections, nextCursor: null });
+                }
+                return Promise.resolve({ results: [], nextCursor: null });
+            });
+            const result = await overview.execute({}, mockTodoistApi);
+            expect(mockTodoistApi.getProjects).toHaveBeenCalledWith({});
+            expect(mockTodoistApi.getSections).toHaveBeenCalledTimes(2); // Once for each project
+            // Use snapshot testing for complex markdown output
+            expect(result).toMatchSnapshot();
+        });
+        it('should handle empty projects list', async () => {
+            mockTodoistApi.getProjects.mockResolvedValue({ results: [], nextCursor: null });
+            expect(await overview.execute({}, mockTodoistApi)).toMatchSnapshot();
+        });
+    });
+    describe('project overview (with projectId)', () => {
+        it('should generate detailed project overview with tasks', async () => {
+            const mockProject = createMockProject({
+                id: TEST_IDS.PROJECT_TEST,
+                name: 'test-abc123def456-project',
+            });
+            const mockSections = [
+                createMockSection({
+                    id: TEST_IDS.SECTION_1,
+                    projectId: TEST_IDS.PROJECT_TEST,
+                    name: 'To Do',
+                }),
+                createMockSection({
+                    id: TEST_IDS.SECTION_2,
+                    projectId: TEST_IDS.PROJECT_TEST,
+                    sectionOrder: 2,
+                    name: 'In Progress',
+                }),
+            ];
+            const mockTasks = [
+                createMockTask({
+                    id: TEST_IDS.TASK_1,
+                    content: 'Task without section',
+                    projectId: TEST_IDS.PROJECT_TEST,
+                    deadline: {
+                        date: '2025-08-15',
+                        lang: 'en',
+                    },
+                    responsibleUid: TEST_IDS.USER_ID,
+                    assignedByUid: TEST_IDS.USER_ID,
+                }),
+                createMockTask({
+                    id: TEST_IDS.TASK_2,
+                    content: 'Task in To Do section',
+                    description: 'Important task',
+                    labels: ['work'],
+                    priority: 2,
+                    projectId: TEST_IDS.PROJECT_TEST,
+                    sectionId: TEST_IDS.SECTION_1,
+                }),
+                createMockTask({
+                    id: TEST_IDS.TASK_3,
+                    content: 'Subtask of important task',
+                    childOrder: 2,
+                    projectId: TEST_IDS.PROJECT_TEST,
+                    sectionId: TEST_IDS.SECTION_1,
+                    parentId: TEST_IDS.TASK_2,
+                }),
+            ];
+            mockTodoistApi.getProject.mockResolvedValue(mockProject);
+            mockTodoistApi.getSections.mockResolvedValue({
+                results: mockSections,
+                nextCursor: null,
+            });
+            mockTodoistApi.getTasks.mockResolvedValue({
+                results: mockTasks,
+                nextCursor: null,
+            });
+            const result = await overview.execute({ projectId: TEST_IDS.PROJECT_TEST }, mockTodoistApi);
+            expect(mockTodoistApi.getProject).toHaveBeenCalledWith(TEST_IDS.PROJECT_TEST);
+            expect(mockTodoistApi.getSections).toHaveBeenCalledWith({
+                projectId: TEST_IDS.PROJECT_TEST,
+            });
+            expect(mockTodoistApi.getTasks).toHaveBeenCalledWith({
+                projectId: TEST_IDS.PROJECT_TEST,
+                limit: 50,
+                cursor: undefined,
+            });
+            // Use snapshot testing for complex markdown output
+            expect(result).toMatchSnapshot();
+        });
+        it('should handle project with no tasks', async () => {
+            const mockProject = createMockProject({
+                id: 'empty-project-id',
+                name: 'Empty Project',
+                color: 'blue',
+            });
+            mockTodoistApi.getProject.mockResolvedValue(mockProject);
+            mockTodoistApi.getSections.mockResolvedValue({ results: [], nextCursor: null });
+            mockTodoistApi.getTasks.mockResolvedValue({ results: [], nextCursor: null });
+            const result = await overview.execute({ projectId: 'empty-project-id' }, mockTodoistApi);
+            expect(result).toMatchSnapshot();
+        });
+    });
+    describe('error handling', () => {
+        it.each([
+            {
+                scenario: 'project retrieval',
+                error: 'API Error: Project not found',
+                params: { projectId: 'non-existent-project' },
+                mockMethod: 'getProject',
+            },
+            {
+                scenario: 'projects list',
+                error: TEST_ERRORS.API_UNAUTHORIZED,
+                params: {},
+                mockMethod: 'getProjects',
+            },
+        ])('should propagate API errors for $scenario', async ({ error, params, mockMethod }) => {
+            const apiError = new Error(error);
+            mockTodoistApi[mockMethod].mockRejectedValue(apiError);
+            await expect(overview.execute(params, mockTodoistApi)).rejects.toThrow(error);
+        });
+    });
+});

package/dist/tools/__tests__/projects-list.test.d.ts

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

package/dist/tools/__tests__/projects-list.test.d.ts.map

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