@doist/todoist-ai 2.2.2 → 4.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,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmBV,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,YAAY,GACf,CAAA"}

package/dist/index.js

@@ -1,33 +1,49 @@
 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 { 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';
+// 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
+    addProjects,
+    updateProjects,
+    findProjects,
+    // Section management tools
+    addSections,
+    updateSections,
+    findSections,
+    // 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
+addProjects, updateProjects, findProjects, 
+// Section management tools
+addSections, updateSections, findSections, 
+// General tools
+getOverview, deleteObject, };

package/dist/main.js

@@ -3,11 +3,12 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import dotenv from 'dotenv';
 import { getMcpServer } from './mcp-server.js';
 function main() {
+    const baseUrl = process.env.TODOIST_BASE_URL;
     const todoistApiKey = process.env.TODOIST_API_KEY;
     if (!todoistApiKey) {
         throw new Error('TODOIST_API_KEY is not set');
     }
-    const server = getMcpServer({ todoistApiKey });
+    const server = getMcpServer({ todoistApiKey, baseUrl });
     const transport = new StdioServerTransport();
     server
         .connect(transport)

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;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"}

package/dist/mcp-server.js

@@ -1,20 +1,28 @@
 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 { 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';
+// 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 +40,28 @@ 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(addProjects, server, todoist);
+    registerTool(updateProjects, server, todoist);
+    registerTool(findProjects, server, todoist);
+    // Section management tools
+    registerTool(addSections, server, todoist);
+    registerTool(updateSections, server, todoist);
+    registerTool(findSections, server, todoist);
+    // Comment management tools
+    registerTool(addComments, server, todoist);
+    registerTool(findComments, server, todoist);
+    registerTool(updateComments, server, todoist);
+    // General tools
+    registerTool(getOverview, server, todoist);
+    registerTool(deleteObject, server, todoist);
     return server;
 }
 export { getMcpServer };

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

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

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

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

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

@@ -0,0 +1,241 @@
+import { jest } from '@jest/globals';
+import { extractStructuredContent, extractTextContent } from '../../utils/test-helpers.js';
+import { ToolNames } from '../../utils/tool-names.js';
+import { addComments } from '../add-comments.js';
+// Mock the Todoist API
+const mockTodoistApi = {
+    addComment: jest.fn(),
+};
+const { ADD_COMMENTS } = ToolNames;
+const createMockComment = (overrides = {}) => ({
+    id: '12345',
+    content: 'Test comment content',
+    postedAt: '2024-01-01T12:00:00Z',
+    postedUid: 'user123',
+    taskId: 'task123',
+    projectId: undefined,
+    fileAttachment: null,
+    uidsToNotify: null,
+    reactions: null,
+    isDeleted: false,
+    ...overrides,
+});
+describe(`${ADD_COMMENTS} tool`, () => {
+    beforeEach(() => {
+        jest.clearAllMocks();
+    });
+    describe('adding comments to tasks', () => {
+        it('should add comment to task', async () => {
+            const mockComment = createMockComment({
+                id: '98765',
+                content: 'This is a task comment',
+                taskId: 'task456',
+            });
+            mockTodoistApi.addComment.mockResolvedValue(mockComment);
+            const result = await addComments.execute({ comments: [{ taskId: 'task456', content: 'This is a task comment' }] }, mockTodoistApi);
+            expect(mockTodoistApi.addComment).toHaveBeenCalledWith({
+                content: 'This is a task comment',
+                taskId: 'task456',
+            });
+            // Verify result is a concise summary
+            expect(extractTextContent(result)).toMatchSnapshot();
+            // Verify structured content
+            const structuredContent = extractStructuredContent(result);
+            expect(structuredContent).toEqual(expect.objectContaining({
+                comments: [
+                    expect.objectContaining({
+                        id: '98765',
+                        content: 'This is a task comment',
+                        taskId: 'task456',
+                    }),
+                ],
+                totalCount: 1,
+                addedCommentIds: ['98765'],
+            }));
+        });
+    });
+    describe('adding comments to projects', () => {
+        it('should add comment to project', async () => {
+            const mockComment = createMockComment({
+                id: '98767',
+                content: 'This is a project comment',
+                taskId: undefined,
+                projectId: 'project789',
+            });
+            mockTodoistApi.addComment.mockResolvedValue(mockComment);
+            const result = await addComments.execute({ comments: [{ projectId: 'project789', content: 'This is a project comment' }] }, mockTodoistApi);
+            expect(mockTodoistApi.addComment).toHaveBeenCalledWith({
+                content: 'This is a project comment',
+                projectId: 'project789',
+            });
+            // Verify result is a concise summary
+            expect(extractTextContent(result)).toMatchSnapshot();
+            // Verify structured content
+            const structuredContent = extractStructuredContent(result);
+            expect(structuredContent).toEqual(expect.objectContaining({
+                comments: [
+                    expect.objectContaining({
+                        id: '98767',
+                        content: 'This is a project comment',
+                        taskId: undefined,
+                        projectId: 'project789',
+                    }),
+                ],
+                totalCount: 1,
+                addedCommentIds: ['98767'],
+            }));
+        });
+    });
+    describe('bulk operations', () => {
+        it('should add multiple comments to different entities (task + project)', async () => {
+            const mockTaskComment = createMockComment({
+                id: '11111',
+                content: 'Task comment',
+                taskId: 'task123',
+                projectId: undefined,
+            });
+            const mockProjectComment = createMockComment({
+                id: '22222',
+                content: 'Project comment',
+                taskId: undefined,
+                projectId: 'project456',
+            });
+            mockTodoistApi.addComment
+                .mockResolvedValueOnce(mockTaskComment)
+                .mockResolvedValueOnce(mockProjectComment);
+            const result = await addComments.execute({
+                comments: [
+                    { taskId: 'task123', content: 'Task comment' },
+                    { projectId: 'project456', content: 'Project comment' },
+                ],
+            }, mockTodoistApi);
+            expect(mockTodoistApi.addComment).toHaveBeenCalledTimes(2);
+            expect(mockTodoistApi.addComment).toHaveBeenCalledWith({
+                content: 'Task comment',
+                taskId: 'task123',
+            });
+            expect(mockTodoistApi.addComment).toHaveBeenCalledWith({
+                content: 'Project comment',
+                projectId: 'project456',
+            });
+            // Verify result is a concise summary
+            expect(extractTextContent(result)).toMatchSnapshot();
+            const structuredContent = extractStructuredContent(result);
+            expect(structuredContent).toEqual(expect.objectContaining({
+                comments: [
+                    expect.objectContaining({
+                        id: '11111',
+                        content: 'Task comment',
+                        taskId: 'task123',
+                    }),
+                    expect.objectContaining({
+                        id: '22222',
+                        content: 'Project comment',
+                        projectId: 'project456',
+                    }),
+                ],
+                totalCount: 2,
+                addedCommentIds: ['11111', '22222'],
+            }));
+        });
+        it('should add multiple comments to different tasks', async () => {
+            const mockComment1 = createMockComment({
+                id: '33333',
+                content: 'First task comment',
+                taskId: 'task111',
+            });
+            const mockComment2 = createMockComment({
+                id: '44444',
+                content: 'Second task comment',
+                taskId: 'task222',
+            });
+            mockTodoistApi.addComment
+                .mockResolvedValueOnce(mockComment1)
+                .mockResolvedValueOnce(mockComment2);
+            const result = await addComments.execute({
+                comments: [
+                    { taskId: 'task111', content: 'First task comment' },
+                    { taskId: 'task222', content: 'Second task comment' },
+                ],
+            }, mockTodoistApi);
+            expect(mockTodoistApi.addComment).toHaveBeenCalledTimes(2);
+            // Verify result is a concise summary
+            expect(extractTextContent(result)).toMatchSnapshot();
+            const structuredContent = extractStructuredContent(result);
+            expect(structuredContent).toEqual(expect.objectContaining({
+                comments: expect.arrayContaining([
+                    expect.objectContaining({
+                        id: '33333',
+                        content: 'First task comment',
+                        taskId: 'task111',
+                    }),
+                    expect.objectContaining({
+                        id: '44444',
+                        content: 'Second task comment',
+                        taskId: 'task222',
+                    }),
+                ]),
+                totalCount: 2,
+                addedCommentIds: ['33333', '44444'],
+            }));
+        });
+        it('should add multiple comments to the same task', async () => {
+            const mockComment1 = createMockComment({
+                id: '55555',
+                content: 'First comment on same task',
+                taskId: 'task999',
+            });
+            const mockComment2 = createMockComment({
+                id: '66666',
+                content: 'Second comment on same task',
+                taskId: 'task999',
+            });
+            mockTodoistApi.addComment
+                .mockResolvedValueOnce(mockComment1)
+                .mockResolvedValueOnce(mockComment2);
+            const result = await addComments.execute({
+                comments: [
+                    { taskId: 'task999', content: 'First comment on same task' },
+                    { taskId: 'task999', content: 'Second comment on same task' },
+                ],
+            }, mockTodoistApi);
+            expect(mockTodoistApi.addComment).toHaveBeenCalledTimes(2);
+            expect(mockTodoistApi.addComment).toHaveBeenCalledWith({
+                content: 'First comment on same task',
+                taskId: 'task999',
+            });
+            expect(mockTodoistApi.addComment).toHaveBeenCalledWith({
+                content: 'Second comment on same task',
+                taskId: 'task999',
+            });
+            // Verify result is a concise summary
+            expect(extractTextContent(result)).toMatchSnapshot();
+            const structuredContent = extractStructuredContent(result);
+            expect(structuredContent).toEqual(expect.objectContaining({
+                comments: expect.arrayContaining([
+                    expect.objectContaining({
+                        id: '55555',
+                        content: 'First comment on same task',
+                        taskId: 'task999',
+                    }),
+                    expect.objectContaining({
+                        id: '66666',
+                        content: 'Second comment on same task',
+                        taskId: 'task999',
+                    }),
+                ]),
+                totalCount: 2,
+                addedCommentIds: ['55555', '66666'],
+            }));
+        });
+    });
+    describe('validation', () => {
+        it('should throw error when neither taskId nor projectId provided', async () => {
+            await expect(addComments.execute({ comments: [{ content: 'Test comment' }] }, mockTodoistApi)).rejects.toThrow('Comment 1: Either taskId or projectId must be provided.');
+        });
+        it('should throw error when both taskId and projectId provided', async () => {
+            const comment = { taskId: 'task123', projectId: 'project456', content: 'Test comment' };
+            await expect(addComments.execute({ comments: [comment] }, mockTodoistApi)).rejects.toThrow('Comment 1: Cannot provide both taskId and projectId. Choose one.');
+        });
+    });
+});

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

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

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

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