@doist/todoist-ai 2.2.1 → 3.0.0

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;AAE9C,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAE3D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAE3D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAA;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAA;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAA;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAE5D,QAAA,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAeV,CAAA;AAED,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CAAA;AAE9B,OAAO,EACH,YAAY,EACZ,cAAc,EACd,SAAS,EACT,cAAc,EACd,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,QAAQ,GACX,CAAA"}
+{"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,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAG3D,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiBV,CAAA;AAED,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CAAA;AAE9B,OAAO,EAEH,QAAQ,EACR,aAAa,EACb,WAAW,EACX,SAAS,EACT,eAAe,EACf,kBAAkB,EAElB,YAAY,EACZ,cAAc,EAEd,YAAY,EACZ,cAAc,EAEd,WAAW,EACX,YAAY,GACf,CAAA"}

package/dist/index.js

@@ -1,33 +1,45 @@
 import { getMcpServer } from './mcp-server.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';
+// 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';
+// Project management tools
+import { findProjects } from './tools/find-projects.js';
+import { manageProjects } from './tools/manage-projects.js';
+// Section management tools
+import { findSections } from './tools/find-sections.js';
+import { manageSections } from './tools/manage-sections.js';
+// General tools
+import { deleteObject } from './tools/delete-object.js';
+import { getOverview } from './tools/get-overview.js';
 const tools = {
-    projectsList,
-    projectsManage,
-    deleteOne,
-    sectionsSearch,
-    sectionsManage,
-    tasksListByDate,
-    tasksListCompleted,
-    tasksListForContainer,
-    tasksCompleteMultiple,
-    tasksSearch,
-    tasksAddMultiple,
-    tasksUpdateOne,
-    tasksOrganizeMultiple,
-    overview,
+    // Task management tools
+    addTasks,
+    completeTasks,
+    updateTasks,
+    findTasks,
+    findTasksByDate,
+    findCompletedTasks,
+    // Project management tools
+    findProjects,
+    manageProjects,
+    // Section management tools
+    findSections,
+    manageSections,
+    // General tools
+    getOverview,
+    deleteObject,
 };
 export { tools, getMcpServer };
-export { projectsList, projectsManage, deleteOne, sectionsSearch, sectionsManage, tasksListByDate, tasksListForContainer, tasksListCompleted, tasksCompleteMultiple, tasksSearch, tasksAddMultiple, tasksUpdateOne, tasksOrganizeMultiple, overview, };
+export { 
+// Task management tools
+addTasks, completeTasks, updateTasks, findTasks, findTasksByDate, findCompletedTasks, 
+// Project management tools
+findProjects, manageProjects, 
+// Section management tools
+findSections, manageSections, 
+// General tools
+getOverview, deleteObject, };

package/dist/mcp-helpers.d.ts

@@ -2,12 +2,34 @@ import type { TodoistApi } from '@doist/todoist-api-typescript';
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { z } from 'zod';
 import type { TodoistTool } from './todoist-tool.js';
-declare function errorContent(error: string): {
-    isError: boolean;
+/**
+ * Get the output payload for a tool, in the correct format expected by MCP client apps.
+ *
+ * @param textContent - The text content to return.
+ * @param structuredContent - The structured content to return.
+ * @returns The output payload.
+ * @see USE_STRUCTURED_CONTENT - Wether to use the structured content feature of the MCP protocol.
+ */
+declare function getToolOutput<StructuredContent extends Record<string, unknown>>({ textContent, structuredContent, }: {
+    textContent: string;
+    structuredContent: StructuredContent;
+}): {
     content: {
         type: "text";
         text: string;
     }[];
+    structuredContent: StructuredContent;
+} | {
+    content: ({
+        type: "text";
+        text: string;
+        mimeType?: undefined;
+    } | {
+        type: "text";
+        mimeType: string;
+        text: string;
+    })[];
+    structuredContent?: undefined;
 };
 /**
  * Register a Todoist tool in an MCP server.
@@ -16,5 +38,5 @@ declare function errorContent(error: string): {
  * @param client - The Todoist API client to use to execute the tool.
  */
 declare function registerTool<Params extends z.ZodRawShape>(tool: TodoistTool<Params>, server: McpServer, client: TodoistApi): void;
-export { registerTool, errorContent };
+export { registerTool, getToolOutput };
 //# sourceMappingURL=mcp-helpers.d.ts.map

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;AAwBpD,iBAAS,YAAY,CAAC,KAAK,EAAE,MAAM;;;;;;EAKlC;AAED;;;;;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,YAAY,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;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"}

package/dist/mcp-helpers.js

@@ -1,25 +1,43 @@
-function textContent(text) {
-    return {
-        content: [{ type: 'text', text }],
-    };
-}
-function jsonContent(data) {
+/**
+ * Wether to return the structured content directly, vs. in the `content` part of the output.
+ *
+ * The `structuredContent` part of the output is relatively new in the spec, and it's not yet
+ * supported by all clients. This flag controls wether we return the structured content using this
+ * new feature of the MCP protocol or not.
+ *
+ * If `false`, the `structuredContent` will be returned as stringified JSON in one of the `content`
+ * parts.
+ *
+ * Eventually we should be able to remove this, and change the code to always work with the
+ * structured content returned directly, once most or all MCP clients support it.
+ */
+const USE_STRUCTURED_CONTENT = process.env.USE_STRUCTURED_CONTENT === 'true' || process.env.NODE_ENV === 'test';
+/**
+ * Get the output payload for a tool, in the correct format expected by MCP client apps.
+ *
+ * @param textContent - The text content to return.
+ * @param structuredContent - The structured content to return.
+ * @returns The output payload.
+ * @see USE_STRUCTURED_CONTENT - Wether to use the structured content feature of the MCP protocol.
+ */
+function getToolOutput({ textContent, structuredContent, }) {
+    if (USE_STRUCTURED_CONTENT) {
+        return {
+            content: [{ type: 'text', text: textContent }],
+            structuredContent,
+        };
+    }
+    const json = JSON.stringify(structuredContent);
     return {
         content: [
-            {
-                type: 'text',
-                mimeType: 'application/json',
-                text: JSON.stringify(data, null, 2),
-            },
+            { type: 'text', text: textContent },
+            { type: 'text', mimeType: 'application/json', text: json },
         ],
     };
 }
-function textOrJsonContent(data) {
-    return typeof data === 'string' ? textContent(data) : jsonContent(data);
-}
-function errorContent(error) {
+function getErrorOutput(error) {
     return {
-        ...textContent(error),
+        content: [{ type: 'text', text: error }],
         isError: true,
     };
 }
@@ -34,7 +52,7 @@ function registerTool(tool, server, client) {
     const cb = async (args, _context) => {
         try {
             const result = await tool.execute(args, client);
-            return textOrJsonContent(result);
+            return result;
         }
         catch (error) {
             console.error(`Error executing tool ${tool.name}:`, {
@@ -42,9 +60,9 @@ function registerTool(tool, server, client) {
                 error,
             });
             const message = error instanceof Error ? error.message : 'An unknown error occurred';
-            return errorContent(message);
+            return getErrorOutput(message);
         }
     };
     server.tool(tool.name, tool.description, tool.parameters, cb);
 }
-export { registerTool, errorContent };
+export { registerTool, getToolOutput };

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;AAwBnE;;;;;GAKG;AACH,iBAAS,YAAY,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,aA6B5F;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;AA2BnE;;;;;GAKG;AACH,iBAAS,YAAY,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,aAkC5F;AAED,OAAO,EAAE,YAAY,EAAE,CAAA"}

package/dist/mcp-server.js

@@ -1,20 +1,22 @@
 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';
+// 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';
+// Project management tools
+import { findProjects } from './tools/find-projects.js';
+import { manageProjects } from './tools/manage-projects.js';
+// Section management tools
+import { findSections } from './tools/find-sections.js';
+import { manageSections } from './tools/manage-sections.js';
+// General tools
+import { deleteObject } from './tools/delete-object.js';
+import { getOverview } from './tools/get-overview.js';
 const instructions = `
 Tools to help you manage your todoist tasks.
 `;
@@ -32,20 +34,22 @@ function getMcpServer({ todoistApiKey, baseUrl }) {
         instructions,
     });
     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);
+    // Task management tools
+    registerTool(addTasks, server, todoist);
+    registerTool(completeTasks, server, todoist);
+    registerTool(updateTasks, server, todoist);
+    registerTool(findTasks, server, todoist);
+    registerTool(findTasksByDate, server, todoist);
+    registerTool(findCompletedTasks, server, todoist);
+    // Project management tools
+    registerTool(findProjects, server, todoist);
+    registerTool(manageProjects, server, todoist);
+    // Section management tools
+    registerTool(findSections, server, todoist);
+    registerTool(manageSections, server, todoist);
+    // General tools
+    registerTool(getOverview, server, todoist);
+    registerTool(deleteObject, server, todoist);
     return server;
 }
 export { getMcpServer };

package/dist/tools/__tests__/add-tasks.test.d.ts

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

package/dist/tools/__tests__/add-tasks.test.d.ts.map

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

package/dist/tools/__tests__/{tasks-add-multiple.test.js → add-tasks.test.js}

@@ -1,11 +1,13 @@
 import { jest } from '@jest/globals';
-import { tasksAddMultiple } from '../tasks-add-multiple.js';
-import { createMockTask } from '../test-helpers.js';
+import { TODAY, createMockTask, extractStructuredContent, extractTextContent, } from '../../utils/test-helpers.js';
+import { ToolNames } from '../../utils/tool-names.js';
+import { addTasks } from '../add-tasks.js';
 // Mock the Todoist API
 const mockTodoistApi = {
     addTask: jest.fn(),
 };
-describe('tasks-add-multiple tool', () => {
+const { ADD_TASKS, GET_OVERVIEW } = ToolNames;
+describe(`${ADD_TASKS} tool`, () => {
     beforeEach(() => {
         jest.clearAllMocks();
     });
@@ -38,7 +40,7 @@ describe('tasks-add-multiple tool', () => {
             mockTodoistApi.addTask
                 .mockResolvedValueOnce(mockApiResponse1)
                 .mockResolvedValueOnce(mockApiResponse2);
-            const result = await tasksAddMultiple.execute({
+            const result = await addTasks.execute({
                 projectId: '6cfCcrrCFg2xP94Q',
                 tasks: [
                     { content: 'First task content' },
@@ -67,23 +69,18 @@ describe('tasks-add-multiple tool', () => {
                 sectionId: undefined,
                 parentId: undefined,
             });
-            // Verify result is properly mapped
-            expect(result).toEqual([
-                expect.objectContaining({
-                    id: '8485093748',
-                    content: 'First task content',
-                    description: '',
-                    labels: [],
-                }),
-                expect.objectContaining({
-                    id: '8485093749',
-                    content: 'Second task content',
-                    description: 'Task description',
-                    dueDate: '2025-08-15',
-                    priority: 2,
-                    labels: ['work', 'urgent'],
-                }),
-            ]);
+            // Verify result is a concise summary
+            expect(extractTextContent(result)).toMatchSnapshot();
+            // Verify structured content
+            const structuredContent = extractStructuredContent(result);
+            expect(structuredContent.tasks).toHaveLength(2);
+            expect(structuredContent).toEqual(expect.objectContaining({
+                totalCount: 2,
+                tasks: expect.arrayContaining([
+                    expect.objectContaining({ id: '8485093748' }),
+                    expect.objectContaining({ id: '8485093749' }),
+                ]),
+            }));
         });
         it('should handle tasks with section and parent IDs', async () => {
             const mockApiResponse = createMockTask({
@@ -97,7 +94,7 @@ describe('tasks-add-multiple tool', () => {
                 addedAt: '2025-08-13T22:09:58.123456Z',
             });
             mockTodoistApi.addTask.mockResolvedValue(mockApiResponse);
-            const result = await tasksAddMultiple.execute({
+            const result = await addTasks.execute({
                 projectId: '6cfCcrrCFg2xP94Q',
                 sectionId: 'section-123',
                 parentId: 'parent-task-456',
@@ -117,17 +114,14 @@ describe('tasks-add-multiple tool', () => {
                 sectionId: 'section-123',
                 parentId: 'parent-task-456',
             });
-            expect(result).toEqual([
-                expect.objectContaining({
-                    id: '8485093750',
-                    content: 'Subtask content',
-                    description: 'Subtask description',
-                    priority: 3,
-                    sectionId: 'section-123',
-                    parentId: 'parent-task-456',
-                    labels: [],
-                }),
-            ]);
+            // Verify result is a concise summary
+            expect(extractTextContent(result)).toMatchSnapshot();
+            // Verify structured content
+            const structuredContent = extractStructuredContent(result);
+            expect(structuredContent).toEqual(expect.objectContaining({
+                totalCount: 1,
+                tasks: expect.arrayContaining([expect.objectContaining({ id: '8485093750' })]),
+            }));
         });
         it('should add tasks with duration', async () => {
             const mockApiResponse1 = createMockTask({
@@ -147,17 +141,11 @@ describe('tasks-add-multiple tool', () => {
             mockTodoistApi.addTask
                 .mockResolvedValueOnce(mockApiResponse1)
                 .mockResolvedValueOnce(mockApiResponse2);
-            const result = await tasksAddMultiple.execute({
+            const result = await addTasks.execute({
                 projectId: '6cfCcrrCFg2xP94Q',
                 tasks: [
-                    {
-                        content: 'Task with 2 hour duration',
-                        duration: '2h',
-                    },
-                    {
-                        content: 'Task with 45 minute duration',
-                        duration: '45m',
-                    },
+                    { content: 'Task with 2 hour duration', duration: '2h' },
+                    { content: 'Task with 45 minute duration', duration: '45m' },
                 ],
             }, mockTodoistApi);
             // Verify API was called with parsed duration
@@ -177,19 +165,18 @@ describe('tasks-add-multiple tool', () => {
                 duration: 45,
                 durationUnit: 'minute',
             });
-            // Verify result includes formatted duration
-            expect(result).toEqual([
-                expect.objectContaining({
-                    id: '8485093752',
-                    content: 'Task with 2 hour duration',
-                    duration: '2h',
-                }),
-                expect.objectContaining({
-                    id: '8485093753',
-                    content: 'Task with 45 minute duration',
-                    duration: '45m',
-                }),
-            ]);
+            // Verify result is a concise summary
+            expect(extractTextContent(result)).toMatchSnapshot();
+            // Verify structured content
+            const structuredContent = extractStructuredContent(result);
+            expect(structuredContent.tasks).toHaveLength(2);
+            expect(structuredContent).toEqual(expect.objectContaining({
+                totalCount: 2,
+                tasks: expect.arrayContaining([
+                    expect.objectContaining({ id: '8485093752' }),
+                    expect.objectContaining({ id: '8485093753' }),
+                ]),
+            }));
         });
         it('should handle various duration formats', async () => {
             const mockApiResponse = createMockTask({
@@ -209,14 +196,7 @@ describe('tasks-add-multiple tool', () => {
             ];
             for (const testCase of testCases) {
                 mockTodoistApi.addTask.mockClear();
-                await tasksAddMultiple.execute({
-                    tasks: [
-                        {
-                            content: 'Test task',
-                            duration: testCase.input,
-                        },
-                    ],
-                }, mockTodoistApi);
+                await addTasks.execute({ tasks: [{ content: 'Test task', duration: testCase.input }] }, mockTodoistApi);
                 expect(mockTodoistApi.addTask).toHaveBeenCalledWith(expect.objectContaining({
                     duration: testCase.expectedMinutes,
                     durationUnit: 'minute',
@@ -226,29 +206,15 @@ describe('tasks-add-multiple tool', () => {
     });
     describe('error handling', () => {
         it('should throw error for invalid duration format', async () => {
-            await expect(tasksAddMultiple.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' }] }, mockTodoistApi)).rejects.toThrow('Task "Task with invalid duration": Invalid duration format "invalid"');
         });
         it('should throw error for duration exceeding 24 hours', async () => {
-            await expect(tasksAddMultiple.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' }] }, 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(tasksAddMultiple.execute({ tasks: [{ content: '' }] }, mockTodoistApi)).rejects.toThrow(apiError.message);
+            await expect(addTasks.execute({ tasks: [{ content: '' }] }, mockTodoistApi)).rejects.toThrow(apiError.message);
         });
         it('should handle partial failures when adding multiple tasks', async () => {
             const mockApiResponse = createMockTask({
@@ -261,7 +227,7 @@ describe('tasks-add-multiple tool', () => {
             mockTodoistApi.addTask
                 .mockResolvedValueOnce(mockApiResponse)
                 .mockRejectedValueOnce(apiError);
-            await expect(tasksAddMultiple.execute({
+            await expect(addTasks.execute({
                 tasks: [
                     { content: 'First task content' },
                     { content: 'Second task content' },
@@ -271,4 +237,42 @@ describe('tasks-add-multiple tool', () => {
             expect(mockTodoistApi.addTask).toHaveBeenCalledTimes(2);
         });
     });
+    describe('next steps logic', () => {
+        it('should suggest find-tasks-by-date for today when hasToday is true', async () => {
+            const mockApiResponse = createMockTask({
+                id: '8485093755',
+                content: 'Task due today',
+                url: 'https://todoist.com/showTask?id=8485093755',
+                addedAt: '2025-08-13T22:09:56.123456Z',
+                due: {
+                    date: TODAY,
+                    isRecurring: false,
+                    lang: 'en',
+                    string: 'today',
+                    timezone: null,
+                },
+            });
+            mockTodoistApi.addTask.mockResolvedValue(mockApiResponse);
+            const result = await addTasks.execute({ tasks: [{ content: 'Task due today', dueString: 'today' }] }, 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 () => {
+            const mockApiResponse = createMockTask({
+                id: '8485093756',
+                content: 'Regular task',
+                url: 'https://todoist.com/showTask?id=8485093756',
+                addedAt: '2025-08-13T22:09:56.123456Z',
+            });
+            mockTodoistApi.addTask.mockResolvedValue(mockApiResponse);
+            const result = await addTasks.execute({
+                projectId: '6cfCcrrCFg2xP94Q',
+                tasks: [{ content: 'Regular task' }],
+            }, mockTodoistApi);
+            const textContent = extractTextContent(result);
+            expect(textContent).toMatchSnapshot();
+            expect(textContent).toContain(`Use ${GET_OVERVIEW} to see your updated project organization`);
+        });
+    });
 });

package/dist/tools/__tests__/complete-tasks.test.d.ts

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

package/dist/tools/__tests__/complete-tasks.test.d.ts.map

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