@doist/todoist-ai 4.9.3 → 4.10.0

package/README.md

@@ -74,10 +74,17 @@ Then enable the server in Cursor settings if prompted.
 
 #### Claude Code (CLI)
 
+Firstly configure Claude so it has a new MCP available using this command:
+
 ```bash
 claude mcp add --transport http todoist https://ai.todoist.net/mcp
 ```
 
+Then launch `claude`, execute `/mcp`, then select the `todoist` MCP server.
+
+This will take you through a wizard to authenticate using your browser with Todoist. Once complete you will be able to use todoist in `claude`.
+
+
 #### Visual Studio Code
 
 1. Open Command Palette → MCP: Add Server
@@ -116,6 +123,10 @@ For our design philosophy, guidelines, and development patterns, see [docs/tool-
 
 For a complete list of available tools, see the [src/tools](src/tools) directory.
 
+#### OpenAI MCP Compatibility
+
+This server includes `search` and `fetch` tools that follow the [OpenAI MCP specification](https://platform.openai.com/docs/mcp), enabling seamless integration with OpenAI's MCP protocol. These tools return JSON-encoded results optimized for OpenAI's requirements while maintaining compatibility with the broader MCP ecosystem.
+
 ## Dependencies
 
 -   MCP server using the official [@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/typescript-sdk?tab=readme-ov-file#installation)

package/dist/index.d.ts

@@ -5,6 +5,7 @@ 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 { fetch } from './tools/fetch.js';
 import { findComments } from './tools/find-comments.js';
 import { findCompletedTasks } from './tools/find-completed-tasks.js';
 import { findProjectCollaborators } from './tools/find-project-collaborators.js';
@@ -14,6 +15,7 @@ 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 { search } from './tools/search.js';
 import { updateComments } from './tools/update-comments.js';
 import { updateProjects } from './tools/update-projects.js';
 import { updateSections } from './tools/update-sections.js';
@@ -673,8 +675,8 @@ declare const tools: {
         };
         execute(args: {
             limit: number;
-            cursor?: string | undefined;
             search?: string | undefined;
+            cursor?: string | undefined;
         }, client: import("@doist/todoist-api-typescript").TodoistApi): Promise<{
             content: {
                 type: "text";
@@ -696,8 +698,8 @@ declare const tools: {
                 hasMore: boolean;
                 appliedFilters: {
                     limit: number;
-                    cursor?: string | undefined;
                     search?: string | undefined;
+                    cursor?: string | undefined;
                 };
             };
         } | {
@@ -1257,7 +1259,39 @@ declare const tools: {
             structuredContent?: undefined;
         }>;
     };
+    search: {
+        name: "search";
+        description: string;
+        parameters: {
+            query: import("zod").ZodString;
+        };
+        execute(args: {
+            query: string;
+        }, client: import("@doist/todoist-api-typescript").TodoistApi): Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+            isError?: boolean;
+        }>;
+    };
+    fetch: {
+        name: "fetch";
+        description: string;
+        parameters: {
+            id: import("zod").ZodString;
+        };
+        execute(args: {
+            id: string;
+        }, client: import("@doist/todoist-api-typescript").TodoistApi): Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+            isError?: boolean;
+        }>;
+    };
 };
 export { tools, getMcpServer };
-export { addTasks, completeTasks, updateTasks, findTasks, findTasksByDate, findCompletedTasks, addProjects, updateProjects, findProjects, addSections, updateSections, findSections, addComments, updateComments, findComments, getOverview, deleteObject, userInfo, findProjectCollaborators, manageAssignments, };
+export { addTasks, completeTasks, updateTasks, findTasks, findTasksByDate, findCompletedTasks, addProjects, updateProjects, findProjects, addSections, updateSections, findSections, addComments, updateComments, findComments, getOverview, deleteObject, userInfo, findProjectCollaborators, manageAssignments, search, fetch, };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -10,6 +10,7 @@ import { addTasks } from './tools/add-tasks.js';
 import { completeTasks } from './tools/complete-tasks.js';
 // General tools
 import { deleteObject } from './tools/delete-object.js';
+import { fetch } from './tools/fetch.js';
 import { findComments } from './tools/find-comments.js';
 import { findCompletedTasks } from './tools/find-completed-tasks.js';
 // Assignment and collaboration tools
@@ -20,6 +21,7 @@ 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 { search } from './tools/search.js';
 import { updateComments } from './tools/update-comments.js';
 import { updateProjects } from './tools/update-projects.js';
 import { updateSections } from './tools/update-sections.js';
@@ -52,6 +54,9 @@ const tools = {
     // Assignment and collaboration tools
     findProjectCollaborators,
     manageAssignments,
+    // OpenAI MCP tools
+    search,
+    fetch,
 };
 export { tools, getMcpServer };
 export { 
@@ -66,4 +71,6 @@ addComments, updateComments, findComments,
 // General tools
 getOverview, deleteObject, userInfo, 
 // Assignment and collaboration tools
-findProjectCollaborators, manageAssignments, };
+findProjectCollaborators, manageAssignments, 
+// OpenAI MCP tools
+search, fetch, };

package/dist/mcp-helpers.d.ts

@@ -31,6 +31,13 @@ declare function getToolOutput<StructuredContent extends Record<string, unknown>
     })[];
     structuredContent?: undefined;
 };
+declare function getErrorOutput(error: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+};
 /**
  * Register a Todoist tool in an MCP server.
  * @param tool - The tool to register.
@@ -38,5 +45,5 @@ declare function getToolOutput<StructuredContent extends Record<string, unknown>
  * @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, getToolOutput };
+export { registerTool, getErrorOutput, 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;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"}
+{"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;AAmBpD;;;;;;;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;;;;;;;;;;;;;;;;;EAkBA;AAED,iBAAS,cAAc,CAAC,KAAK,EAAE,MAAM;;;;;;EAKpC;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,cAAc,EAAE,aAAa,EAAE,CAAA"}

package/dist/mcp-helpers.js

@@ -1,3 +1,4 @@
+import { removeNullFields } from './utils/sanitize-data.js';
 /**
  * Wether to return the structured content directly, vs. in the `content` part of the output.
  *
@@ -21,13 +22,15 @@ const USE_STRUCTURED_CONTENT = process.env.USE_STRUCTURED_CONTENT === 'true' ||
  * @see USE_STRUCTURED_CONTENT - Wether to use the structured content feature of the MCP protocol.
  */
 function getToolOutput({ textContent, structuredContent, }) {
+    // Remove null fields from structured content before returning
+    const sanitizedContent = removeNullFields(structuredContent);
     if (USE_STRUCTURED_CONTENT) {
         return {
             content: [{ type: 'text', text: textContent }],
-            structuredContent,
+            structuredContent: sanitizedContent,
         };
     }
-    const json = JSON.stringify(structuredContent);
+    const json = JSON.stringify(sanitizedContent);
     return {
         content: [
             { type: 'text', text: textContent },
@@ -65,4 +68,4 @@ function registerTool(tool, server, client) {
     };
     server.tool(tool.name, tool.description, tool.parameters, cb);
 }
-export { registerTool, getToolOutput };
+export { registerTool, getErrorOutput, 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;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"}
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AA0FnE;;;;;GAKG;AACH,iBAAS,YAAY,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,aAkD5F;AAED,OAAO,EAAE,YAAY,EAAE,CAAA"}

package/dist/mcp-server.js

@@ -7,6 +7,7 @@ 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 { fetch } from './tools/fetch.js';
 import { findComments } from './tools/find-comments.js';
 import { findCompletedTasks } from './tools/find-completed-tasks.js';
 import { findProjectCollaborators } from './tools/find-project-collaborators.js';
@@ -16,6 +17,7 @@ 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 { search } from './tools/search.js';
 import { updateComments } from './tools/update-comments.js';
 import { updateProjects } from './tools/update-projects.js';
 import { updateSections } from './tools/update-sections.js';
@@ -125,6 +127,9 @@ function getMcpServer({ todoistApiKey, baseUrl }) {
     // Assignment and collaboration tools
     registerTool(findProjectCollaborators, server, todoist);
     registerTool(manageAssignments, server, todoist);
+    // OpenAI MCP tools
+    registerTool(search, server, todoist);
+    registerTool(fetch, server, todoist);
     return server;
 }
 export { getMcpServer };

package/dist/tool-helpers.d.ts

@@ -89,5 +89,12 @@ declare function getTasksByFilter({ client, query, limit, cursor, }: {
     }[];
     nextCursor: string | null;
 }>;
-export { getTasksByFilter, mapTask, mapProject };
+/**
+ * Build a Todoist URL for a task or project.
+ * @param type - The type of object ('task' or 'project')
+ * @param id - The ID of the object
+ * @returns The URL string
+ */
+declare function buildTodoistUrl(type: 'task' | 'project', id: string): string;
+export { getTasksByFilter, mapTask, mapProject, buildTodoistUrl };
 //# sourceMappingURL=tool-helpers.d.ts.map

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,KAAK,EACR,YAAY,EACZ,eAAe,EACf,IAAI,EACJ,UAAU,EACV,gBAAgB,EACnB,MAAM,+BAA+B,CAAA;AAItC,eAAO,MAAM,0BAA0B,gDAAiD,CAAA;AACxF,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAA;AAElF,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,4BAA4B,CAAC,CAAC,SAAS;IAAE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAAE,EACtF,KAAK,EACL,kBAAkB,EAClB,aAAa,EACb,wBAA2C,GAC9C,EAAE;IACC,KAAK,EAAE,CAAC,EAAE,CAAA;IACV,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC,aAAa,EAAE,MAAM,CAAA;IACrB,wBAAwB,CAAC,EAAE,wBAAwB,CAAA;CACtD,GAAG,CAAC,EAAE,CAUN;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"}
+{"version":3,"file":"tool-helpers.d.ts","sourceRoot":"","sources":["../src/tool-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,YAAY,EACZ,eAAe,EACf,IAAI,EACJ,UAAU,EACV,gBAAgB,EACnB,MAAM,+BAA+B,CAAA;AAItC,eAAO,MAAM,0BAA0B,gDAAiD,CAAA;AACxF,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAA;AAElF,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,4BAA4B,CAAC,CAAC,SAAS;IAAE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAAE,EACtF,KAAK,EACL,kBAAkB,EAClB,aAAa,EACb,wBAA2C,GAC9C,EAAE;IACC,KAAK,EAAE,CAAC,EAAE,CAAA;IACV,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC,aAAa,EAAE,MAAM,CAAA;IACrB,wBAAwB,CAAC,EAAE,wBAAwB,CAAA;CACtD,GAAG,CAAC,EAAE,CAUN;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;;;;;;;;;;;;;;;;;GAkBA;AAED;;;;;GAKG;AACH,iBAAS,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,CAAA"}

package/dist/tool-helpers.js

@@ -105,15 +105,9 @@ const ErrorSchema = z.object({
 });
 async function getTasksByFilter({ client, query, limit, cursor, }) {
     try {
-        const { results, nextCursor } = await client.getTasksByFilter({
-            query,
-            cursor,
-            limit,
-        });
-        return {
-            tasks: results.map(mapTask),
-            nextCursor,
-        };
+        const { results, nextCursor } = await client.getTasksByFilter({ query, cursor, limit });
+        const tasks = results.map(mapTask);
+        return { tasks, nextCursor };
     }
     catch (error) {
         const parsedError = ErrorSchema.safeParse(error);
@@ -127,4 +121,13 @@ async function getTasksByFilter({ client, query, limit, cursor, }) {
         throw new Error(`${responseData.error} (tag: ${responseData.errorTag}, code: ${responseData.errorCode})`);
     }
 }
-export { getTasksByFilter, mapTask, mapProject };
+/**
+ * Build a Todoist URL for a task or project.
+ * @param type - The type of object ('task' or 'project')
+ * @param id - The ID of the object
+ * @returns The URL string
+ */
+function buildTodoistUrl(type, id) {
+    return `https://app.todoist.com/app/${type}/${id}`;
+}
+export { getTasksByFilter, mapTask, mapProject, buildTodoistUrl };

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

@@ -143,7 +143,11 @@ describe(`${ADD_PROJECTS} tool`, () => {
             // Verify structured content
             const structuredContent = extractStructuredContent(result);
             expect(structuredContent).toEqual(expect.objectContaining({
-                projects: mockProjects,
+                projects: expect.arrayContaining([
+                    expect.objectContaining({ id: 'project-1', name: 'First Project' }),
+                    expect.objectContaining({ id: 'project-2', name: 'Second Project' }),
+                    expect.objectContaining({ id: 'project-3', name: 'Third Project' }),
+                ]),
                 totalCount: 3,
             }));
         });

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

@@ -122,7 +122,11 @@ describe(`${ADD_SECTIONS} tool`, () => {
             // Verify structured content
             const structuredContent = extractStructuredContent(result);
             expect(structuredContent).toEqual(expect.objectContaining({
-                sections: mockSections,
+                sections: expect.arrayContaining([
+                    expect.objectContaining({ id: 'section-1', name: 'First Section' }),
+                    expect.objectContaining({ id: 'section-2', name: 'Second Section' }),
+                    expect.objectContaining({ id: 'section-3', name: 'Third Section' }),
+                ]),
                 totalCount: 3,
             }));
         });

package/dist/tools/__tests__/assignment-integration.test.js

@@ -311,7 +311,7 @@ describe('Assignment Integration Tests', () => {
                 projectId: 'project-123',
             }, mockTodoistApi);
             expect(extractTextContent(result)).toContain('is not shared and has no collaborators');
-            expect(extractStructuredContent(result).collaborators).toHaveLength(0);
+            expect(extractStructuredContent(result).collaborators).toBeUndefined(); // Empty arrays are removed
         });
         it('should handle project not found', async () => {
             mockTodoistApi.getProject.mockRejectedValueOnce(new Error('Project not found'));

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

@@ -24,13 +24,13 @@ describe(`${COMPLETE_TASKS} tool`, () => {
             expect(extractTextContent(result)).toMatchSnapshot();
             // Verify structured content
             const { structuredContent } = result;
-            expect(structuredContent).toEqual(expect.objectContaining({
+            expect(structuredContent).toEqual({
                 completed: ['task-1', 'task-2', 'task-3'],
-                failures: [],
+                // failures array is removed when empty
                 totalRequested: 3,
                 successCount: 3,
                 failureCount: 0,
-            }));
+            });
         });
         it('should complete single task', async () => {
             mockTodoistApi.closeTask.mockResolvedValue(true);
@@ -40,13 +40,13 @@ describe(`${COMPLETE_TASKS} tool`, () => {
             expect(extractTextContent(result)).toMatchSnapshot();
             // Verify structured content
             const { structuredContent } = result;
-            expect(structuredContent).toEqual(expect.objectContaining({
+            expect(structuredContent).toEqual({
                 completed: ['8485093748'],
-                failures: [],
+                // failures array is removed when empty
                 totalRequested: 1,
                 successCount: 1,
                 failureCount: 0,
-            }));
+            });
         });
         it('should handle partial failures gracefully', async () => {
             // Mock first and third tasks to succeed, second to fail

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

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

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

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