@doist/todoist-ai 4.0.0 → 4.4.0

package/dist/tools/__tests__/user-info.test.js

@@ -0,0 +1,139 @@
+import { jest } from '@jest/globals';
+import { TEST_ERRORS, extractStructuredContent, extractTextContent, } from '../../utils/test-helpers.js';
+import { ToolNames } from '../../utils/tool-names.js';
+import { userInfo } from '../user-info.js';
+// Mock the Todoist API
+const mockTodoistApi = {
+    getUser: jest.fn(),
+};
+const { USER_INFO } = ToolNames;
+// Helper function to create a mock user with default values that can be overridden
+function createMockUser(overrides = {}) {
+    return {
+        id: '123',
+        fullName: 'Test User',
+        email: 'test@example.com',
+        isPremium: true,
+        completedToday: 12,
+        dailyGoal: 10,
+        weeklyGoal: 100,
+        startDay: 1, // Monday
+        tzInfo: {
+            timezone: 'Europe/Madrid',
+            gmtString: '+02:00',
+            hours: 2,
+            minutes: 0,
+            isDst: 1,
+        },
+        lang: 'en',
+        avatarBig: 'https://example.com/avatar.jpg',
+        avatarMedium: null,
+        avatarS640: null,
+        avatarSmall: null,
+        karma: 86394.0,
+        karmaTrend: 'up',
+        nextWeek: 1,
+        weekendStartDay: 6,
+        timeFormat: 0,
+        dateFormat: 0,
+        daysOff: [6, 7],
+        businessAccountId: null,
+        completedCount: 102920,
+        inboxProjectId: '6PVw8cMf7m8fWwRp',
+        startPage: 'overdue',
+        ...overrides,
+    };
+}
+describe(`${USER_INFO} tool`, () => {
+    beforeEach(() => {
+        jest.clearAllMocks();
+    });
+    it('should generate user info with all required fields', async () => {
+        const mockUser = createMockUser();
+        mockTodoistApi.getUser.mockResolvedValue(mockUser);
+        const result = await userInfo.execute({}, mockTodoistApi);
+        expect(mockTodoistApi.getUser).toHaveBeenCalledWith();
+        // Test text content contains expected information
+        const textContent = extractTextContent(result);
+        expect(textContent).toContain('User ID:** 123');
+        expect(textContent).toContain('Test User');
+        expect(textContent).toContain('test@example.com');
+        expect(textContent).toContain('Europe/Madrid');
+        expect(textContent).toContain('Monday (1)');
+        expect(textContent).toContain('Completed Today:** 12');
+        expect(textContent).toContain('Plan:** Todoist Pro');
+        // Test structured content
+        const structuredContent = extractStructuredContent(result);
+        expect(structuredContent).toEqual(expect.objectContaining({
+            type: 'user_info',
+            userId: '123',
+            fullName: 'Test User',
+            email: 'test@example.com',
+            timezone: 'Europe/Madrid',
+            startDay: 1,
+            startDayName: 'Monday',
+            completedToday: 12,
+            dailyGoal: 10,
+            weeklyGoal: 100,
+            plan: 'Todoist Pro',
+            currentLocalTime: expect.any(String),
+            weekStartDate: expect.any(String),
+            weekEndDate: expect.any(String),
+            currentWeekNumber: expect.any(Number),
+        }));
+        // Verify date formats
+        expect(structuredContent.weekStartDate).toMatch(/^\d{4}-\d{2}-\d{2}$/);
+        expect(structuredContent.weekEndDate).toMatch(/^\d{4}-\d{2}-\d{2}$/);
+        expect(structuredContent.currentLocalTime).toMatch(/^\d{2}\/\d{2}\/\d{4}, \d{2}:\d{2}:\d{2}$/);
+    });
+    it('should handle missing timezone info', async () => {
+        const mockUser = createMockUser({
+            isPremium: false,
+            tzInfo: {
+                timezone: 'UTC',
+                gmtString: '+00:00',
+                hours: 0,
+                minutes: 0,
+                isDst: 0,
+            },
+        });
+        mockTodoistApi.getUser.mockResolvedValue(mockUser);
+        const result = await userInfo.execute({}, mockTodoistApi);
+        const textContent = extractTextContent(result);
+        expect(textContent).toContain('UTC'); // Should default to UTC
+        expect(textContent).toContain('Monday (1)'); // Should default to Monday
+        expect(textContent).toContain('Plan:** Todoist Free');
+        const structuredContent = extractStructuredContent(result);
+        expect(structuredContent.timezone).toBe('UTC');
+        expect(structuredContent.startDay).toBe(1);
+        expect(structuredContent.startDayName).toBe('Monday');
+        expect(structuredContent.plan).toBe('Todoist Free');
+    });
+    it('should handle invalid timezone and fallback to UTC', async () => {
+        const mockUser = createMockUser({
+            startDay: 2, // Tuesday
+            tzInfo: {
+                timezone: 'Invalid/Timezone',
+                gmtString: '+05:30',
+                hours: 5,
+                minutes: 30,
+                isDst: 0,
+            },
+        });
+        mockTodoistApi.getUser.mockResolvedValue(mockUser);
+        const result = await userInfo.execute({}, mockTodoistApi);
+        const textContent = extractTextContent(result);
+        expect(textContent).toContain('UTC'); // Should fallback to UTC
+        expect(textContent).toContain('Tuesday (2)');
+        const structuredContent = extractStructuredContent(result);
+        expect(structuredContent.timezone).toBe('UTC'); // Should be UTC, not the invalid timezone
+        expect(structuredContent.startDay).toBe(2);
+        expect(structuredContent.startDayName).toBe('Tuesday');
+        expect(structuredContent.currentLocalTime).toMatch(/^\d{2}\/\d{2}\/\d{4}, \d{2}:\d{2}:\d{2}$/);
+    });
+    it('should propagate API errors', async () => {
+        const apiError = new Error(TEST_ERRORS.API_UNAUTHORIZED);
+        mockTodoistApi.getUser.mockRejectedValue(apiError);
+        await expect(userInfo.execute({}, mockTodoistApi)).rejects.toThrow(TEST_ERRORS.API_UNAUTHORIZED);
+    });
+});

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

@@ -1,4 +1,3 @@
-import type { Comment } from '@doist/todoist-api-typescript';
 import { z } from 'zod';
 declare const addComments: {
     name: "add-comments";
@@ -30,7 +29,31 @@ declare const addComments: {
             text: string;
         }[];
         structuredContent: {
-            comments: Comment[];
+            comments: {
+                taskId: string | undefined;
+                id: string;
+                content: string;
+                postedAt: string;
+                fileAttachment: {
+                    resourceType: string;
+                    fileName?: string | null | undefined;
+                    fileSize?: number | null | undefined;
+                    fileType?: string | null | undefined;
+                    fileUrl?: string | null | undefined;
+                    fileDuration?: number | null | undefined;
+                    uploadState?: "pending" | "completed" | null | undefined;
+                    image?: string | null | undefined;
+                    imageWidth?: number | null | undefined;
+                    imageHeight?: number | null | undefined;
+                    url?: string | null | undefined;
+                    title?: string | null | undefined;
+                } | null;
+                postedUid: string;
+                uidsToNotify: string[] | null;
+                reactions: Record<string, string[]> | null;
+                isDeleted: boolean;
+                projectId?: string | undefined;
+            }[];
             totalCount: number;
             addedCommentIds: string[];
         };

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

@@ -1 +1 @@
-{"version":3,"file":"add-comments.d.ts","sourceRoot":"","sources":["../../src/tools/add-comments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,OAAO,EAAE,MAAM,+BAA+B,CAAA;AAC5E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAkBvB,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0CyB,CAAA;AA6C1C,OAAO,EAAE,WAAW,EAAE,CAAA"}
+{"version":3,"file":"add-comments.d.ts","sourceRoot":"","sources":["../../src/tools/add-comments.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAkBvB,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAwFggV,CAAC;4BAA6C,CAAC;4BAA6C,CAAC;2BAA4C,CAAC;gCAAiD,CAAC;+BAAgD,CAAC;yBAA2D,CAAC;8BAA+C,CAAC;+BAAgD,CAAC;uBAAwC,CAAC;yBAA0C,CAAC;;;;;;;;;;;;;;;;;;;;;;;CA9Cr8V,CAAA;AA6C1C,OAAO,EAAE,WAAW,EAAE,CAAA"}

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

@@ -1,4 +1,3 @@
-import type { PersonalProject, WorkspaceProject } from '@doist/todoist-api-typescript';
 import { z } from 'zod';
 declare const addProjects: {
     name: "add-projects";
@@ -30,7 +29,52 @@ declare const addProjects: {
             text: string;
         }[];
         structuredContent: {
-            projects: (PersonalProject | WorkspaceProject)[];
+            projects: ({
+                url: string;
+                id: string;
+                canAssignTasks: boolean;
+                childOrder: number;
+                color: string;
+                createdAt: string | null;
+                isArchived: boolean;
+                isDeleted: boolean;
+                isFavorite: boolean;
+                isFrozen: boolean;
+                name: string;
+                updatedAt: string | null;
+                viewStyle: string;
+                defaultOrder: number;
+                description: string;
+                isCollapsed: boolean;
+                isShared: boolean;
+                parentId: string | null;
+                inboxProject: boolean;
+            } | {
+                url: string;
+                id: string;
+                canAssignTasks: boolean;
+                childOrder: number;
+                color: string;
+                createdAt: string | null;
+                isArchived: boolean;
+                isDeleted: boolean;
+                isFavorite: boolean;
+                isFrozen: boolean;
+                name: string;
+                updatedAt: string | null;
+                viewStyle: string;
+                defaultOrder: number;
+                description: string;
+                isCollapsed: boolean;
+                isShared: boolean;
+                collaboratorRoleDefault: string;
+                folderId: string | null;
+                isInviteOnly: boolean | null;
+                isLinkSharingEnabled: boolean;
+                role: string | null;
+                status: string;
+                workspaceId: string;
+            })[];
             totalCount: number;
         };
     } | {

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

@@ -1 +1 @@
-{"version":3,"file":"add-projects.d.ts","sourceRoot":"","sources":["../../src/tools/add-projects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AACtF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAwBvB,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgByB,CAAA;AAmC1C,OAAO,EAAE,WAAW,EAAE,CAAA"}
+{"version":3,"file":"add-projects.d.ts","sourceRoot":"","sources":["../../src/tools/add-projects.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAwBvB,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgByB,CAAA;AAmC1C,OAAO,EAAE,WAAW,EAAE,CAAA"}

package/dist/tools/add-sections.d.ts

@@ -1,4 +1,3 @@
-import type { Section } from '@doist/todoist-api-typescript';
 import { z } from 'zod';
 declare const addSections: {
     name: "add-sections";
@@ -26,7 +25,20 @@ declare const addSections: {
             text: string;
         }[];
         structuredContent: {
-            sections: Section[];
+            sections: {
+                url: string;
+                id: string;
+                userId: string;
+                projectId: string;
+                addedAt: string;
+                updatedAt: string;
+                archivedAt: string | null;
+                name: string;
+                sectionOrder: number;
+                isArchived: boolean;
+                isDeleted: boolean;
+                isCollapsed: boolean;
+            }[];
             totalCount: number;
         };
     } | {

package/dist/tools/add-sections.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add-sections.d.ts","sourceRoot":"","sources":["../../src/tools/add-sections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAA;AAC5D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAiBvB,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgByB,CAAA;AAiD1C,OAAO,EAAE,WAAW,EAAE,CAAA"}
+{"version":3,"file":"add-sections.d.ts","sourceRoot":"","sources":["../../src/tools/add-sections.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAiBvB,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgByB,CAAA;AAiD1C,OAAO,EAAE,WAAW,EAAE,CAAA"}

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

@@ -19,18 +19,18 @@ declare const addTasks: {
             parentId?: string | undefined;
             projectId?: string | undefined;
             sectionId?: string | undefined;
+            duration?: string | undefined;
             priority?: number | undefined;
             dueString?: string | undefined;
-            duration?: string | undefined;
         }, {
             content: string;
             description?: string | undefined;
             parentId?: string | undefined;
             projectId?: string | undefined;
             sectionId?: string | undefined;
+            duration?: string | undefined;
             priority?: number | undefined;
             dueString?: string | undefined;
-            duration?: string | undefined;
         }>, "many">;
     };
     execute({ tasks }: {
@@ -40,9 +40,9 @@ declare const addTasks: {
             parentId?: string | undefined;
             projectId?: string | undefined;
             sectionId?: string | undefined;
+            duration?: string | undefined;
             priority?: number | undefined;
             dueString?: string | undefined;
-            duration?: string | undefined;
         }[];
     }, client: TodoistApi): Promise<{
         content: {

package/dist/tools/find-comments.d.ts

@@ -1,4 +1,3 @@
-import type { Comment } from '@doist/todoist-api-typescript';
 import { z } from 'zod';
 declare const findComments: {
     name: "find-comments";
@@ -22,7 +21,31 @@ declare const findComments: {
             text: string;
         }[];
         structuredContent: {
-            comments: Comment[];
+            comments: {
+                taskId: string | undefined;
+                id: string;
+                content: string;
+                postedAt: string;
+                fileAttachment: {
+                    resourceType: string;
+                    fileName?: string | null | undefined;
+                    fileSize?: number | null | undefined;
+                    fileType?: string | null | undefined;
+                    fileUrl?: string | null | undefined;
+                    fileDuration?: number | null | undefined;
+                    uploadState?: "pending" | "completed" | null | undefined;
+                    image?: string | null | undefined;
+                    imageWidth?: number | null | undefined;
+                    imageHeight?: number | null | undefined;
+                    url?: string | null | undefined;
+                    title?: string | null | undefined;
+                } | null;
+                postedUid: string;
+                uidsToNotify: string[] | null;
+                reactions: Record<string, string[]> | null;
+                isDeleted: boolean;
+                projectId?: string | undefined;
+            }[];
             searchType: string;
             searchId: string;
             hasMore: boolean;

package/dist/tools/find-comments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"find-comments.d.ts","sourceRoot":"","sources":["../../src/tools/find-comments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAA;AAC5D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAuBvB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsEwB,CAAA;AAoF1C,OAAO,EAAE,YAAY,EAAE,CAAA"}
+{"version":3,"file":"find-comments.d.ts","sourceRoot":"","sources":["../../src/tools/find-comments.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAuBvB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BA2J++P,CAAC;4BAA6C,CAAC;4BAA6C,CAAC;2BAA4C,CAAC;gCAAiD,CAAC;+BAAgD,CAAC;yBAA2D,CAAC;8BAA+C,CAAC;+BAAgD,CAAC;uBAAwC,CAAC;yBAA0C,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;CArFr7Q,CAAA;AAoF1C,OAAO,EAAE,YAAY,EAAE,CAAA"}

package/dist/tools/find-completed-tasks.d.ts

@@ -3,6 +3,8 @@ declare const findCompletedTasks: {
     name: "find-completed-tasks";
     description: string;
     parameters: {
+        labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        labelsOperator: z.ZodOptional<z.ZodEnum<["and", "or"]>>;
         getBy: z.ZodDefault<z.ZodEnum<["completion", "due"]>>;
         since: z.ZodString;
         until: z.ZodString;
@@ -15,14 +17,16 @@ declare const findCompletedTasks: {
     };
     execute(args: {
         limit: number;
-        getBy: "completion" | "due";
+        getBy: "due" | "completion";
         since: string;
         until: string;
         parentId?: string | undefined;
         workspaceId?: string | undefined;
         projectId?: string | undefined;
         sectionId?: string | undefined;
+        labels?: string[] | undefined;
         cursor?: string | undefined;
+        labelsOperator?: "and" | "or" | undefined;
     }, client: import("@doist/todoist-api-typescript").TodoistApi): Promise<{
         content: {
             type: "text";
@@ -47,14 +51,16 @@ declare const findCompletedTasks: {
             hasMore: boolean;
             appliedFilters: {
                 limit: number;
-                getBy: "completion" | "due";
+                getBy: "due" | "completion";
                 since: string;
                 until: string;
                 parentId?: string | undefined;
                 workspaceId?: string | undefined;
                 projectId?: string | undefined;
                 sectionId?: string | undefined;
+                labels?: string[] | undefined;
                 cursor?: string | undefined;
+                labelsOperator?: "and" | "or" | undefined;
             };
         };
     } | {

package/dist/tools/find-completed-tasks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"find-completed-tasks.d.ts","sourceRoot":"","sources":["../../src/tools/find-completed-tasks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA8CvB,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BkB,CAAA;AA2D1C,OAAO,EAAE,kBAAkB,EAAE,CAAA"}
+{"version":3,"file":"find-completed-tasks.d.ts","sourceRoot":"","sources":["../../src/tools/find-completed-tasks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAiDvB,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCkB,CAAA;AAmE1C,OAAO,EAAE,kBAAkB,EAAE,CAAA"}

package/dist/tools/find-completed-tasks.js

@@ -2,6 +2,7 @@ import { z } from 'zod';
 import { getToolOutput } from '../mcp-helpers.js';
 import { mapTask } from '../tool-helpers.js';
 import { ApiLimits } from '../utils/constants.js';
+import { LabelsSchema, generateLabelsFilter } from '../utils/labels.js';
 import { previewTasks, summarizeList } from '../utils/response-builders.js';
 import { ToolNames } from '../utils/tool-names.js';
 const { FIND_TASKS_BY_DATE, GET_OVERVIEW } = ToolNames;
@@ -35,16 +36,24 @@ const ArgsSchema = {
         .string()
         .optional()
         .describe('The cursor to get the next page of tasks (cursor is obtained from the previous call to this tool, with the same parameters).'),
+    ...LabelsSchema,
 };
 const findCompletedTasks = {
     name: ToolNames.FIND_COMPLETED_TASKS,
     description: 'Get completed tasks.',
     parameters: ArgsSchema,
     async execute(args, client) {
-        const { getBy, ...rest } = args;
+        const { getBy, labels, labelsOperator, ...rest } = args;
+        const labelsFilter = generateLabelsFilter(labels, labelsOperator);
         const { items, nextCursor } = getBy === 'completion'
-            ? await client.getCompletedTasksByCompletionDate(rest)
-            : await client.getCompletedTasksByDueDate(rest);
+            ? await client.getCompletedTasksByCompletionDate({
+                ...rest,
+                ...(labelsFilter ? { filterQuery: labelsFilter, filterLang: 'en' } : {}),
+            })
+            : await client.getCompletedTasksByDueDate({
+                ...rest,
+                ...(labelsFilter ? { filterQuery: labelsFilter, filterLang: 'en' } : {}),
+            });
         const mappedTasks = items.map(mapTask);
         const textContent = generateTextContent({
             tasks: mappedTasks,
@@ -78,6 +87,13 @@ function generateTextContent({ tasks, args, nextCursor, }) {
         filterHints.push(`parent: ${args.parentId}`);
     if (args.workspaceId)
         filterHints.push(`workspace: ${args.workspaceId}`);
+    // Add label filter information
+    if (args.labels && args.labels.length > 0) {
+        const labelText = args.labels
+            .map((label) => `@${label}`)
+            .join(args.labelsOperator === 'and' ? ' & ' : ' | ');
+        filterHints.push(`labels: ${labelText}`);
+    }
     // Generate helpful suggestions for empty results
     const zeroReasonHints = [];
     if (tasks.length === 0) {

package/dist/tools/find-tasks-by-date.d.ts

@@ -3,6 +3,8 @@ declare const findTasksByDate: {
     name: "find-tasks-by-date";
     description: string;
     parameters: {
+        labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        labelsOperator: z.ZodOptional<z.ZodEnum<["and", "or"]>>;
         startDate: z.ZodString;
         daysCount: z.ZodDefault<z.ZodNumber>;
         limit: z.ZodDefault<z.ZodNumber>;
@@ -12,7 +14,9 @@ declare const findTasksByDate: {
         limit: number;
         startDate: string;
         daysCount: number;
+        labels?: string[] | undefined;
         cursor?: string | undefined;
+        labelsOperator?: "and" | "or" | undefined;
     }, client: import("@doist/todoist-api-typescript").TodoistApi): Promise<{
         content: {
             type: "text";
@@ -39,7 +43,9 @@ declare const findTasksByDate: {
                 limit: number;
                 startDate: string;
                 daysCount: number;
+                labels?: string[] | undefined;
                 cursor?: string | undefined;
+                labelsOperator?: "and" | "or" | undefined;
             };
         };
     } | {

package/dist/tools/find-tasks-by-date.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"find-tasks-by-date.d.ts","sourceRoot":"","sources":["../../src/tools/find-tasks-by-date.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA4CvB,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4CqB,CAAA;AAiE1C,OAAO,EAAE,eAAe,EAAE,CAAA"}
+{"version":3,"file":"find-tasks-by-date.d.ts","sourceRoot":"","sources":["../../src/tools/find-tasks-by-date.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA8CvB,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoDqB,CAAA;AAyE1C,OAAO,EAAE,eAAe,EAAE,CAAA"}

package/dist/tools/find-tasks-by-date.js

@@ -3,6 +3,7 @@ import { z } from 'zod';
 import { getToolOutput } from '../mcp-helpers.js';
 import { getTasksByFilter } from '../tool-helpers.js';
 import { ApiLimits } from '../utils/constants.js';
+import { LabelsSchema, generateLabelsFilter } from '../utils/labels.js';
 import { generateTaskNextSteps, getDateString, previewTasks, summarizeList, } from '../utils/response-builders.js';
 import { ToolNames } from '../utils/tool-names.js';
 const ArgsSchema = {
@@ -28,13 +29,14 @@ const ArgsSchema = {
         .string()
         .optional()
         .describe('The cursor to get the next page of tasks (cursor is obtained from the previous call to this tool, with the same parameters).'),
+    ...LabelsSchema,
 };
 const findTasksByDate = {
     name: ToolNames.FIND_TASKS_BY_DATE,
     description: "Get tasks by date range or overdue tasks. Use startDate 'overdue' for overdue tasks, or provide a date/date range.",
     parameters: ArgsSchema,
     async execute(args, client) {
-        let query;
+        let query = '';
         if (args.startDate === 'overdue') {
             query = 'overdue';
         }
@@ -46,6 +48,14 @@ const findTasksByDate = {
             const endDateStr = formatISO(endDate, { representation: 'date' });
             query = `(due after: ${startDate} | due: ${startDate}) & due before: ${endDateStr}`;
         }
+        const labelsFilter = generateLabelsFilter(args.labels, args.labelsOperator);
+        if (labelsFilter.length > 0) {
+            // If there is already a query, we need to append the & operator first
+            if (query.length > 0)
+                query += ' & ';
+            // Add the labels to the filter
+            query += `(${labelsFilter})`;
+        }
         const result = await getTasksByFilter({
             client,
             query,
@@ -81,6 +91,13 @@ function generateTextContent({ tasks, args, nextCursor, }) {
     else {
         filterHints.push(`${args.startDate}${args.daysCount > 1 ? ` to ${getDateString(addDays(args.startDate, args.daysCount))}` : ''}`);
     }
+    // Add label filter information
+    if (args.labels && args.labels.length > 0) {
+        const labelText = args.labels
+            .map((label) => `@${label}`)
+            .join(args.labelsOperator === 'and' ? ' & ' : ' | ');
+        filterHints.push(`labels: ${labelText}`);
+    }
     // Generate subject description
     const subject = args.startDate === 'overdue'
         ? 'Overdue tasks'

package/dist/tools/find-tasks.d.ts

@@ -3,6 +3,8 @@ declare const findTasks: {
     name: "find-tasks";
     description: string;
     parameters: {
+        labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        labelsOperator: z.ZodOptional<z.ZodEnum<["and", "or"]>>;
         searchText: z.ZodOptional<z.ZodString>;
         projectId: z.ZodOptional<z.ZodString>;
         sectionId: z.ZodOptional<z.ZodString>;
@@ -15,7 +17,9 @@ declare const findTasks: {
         parentId?: string | undefined;
         projectId?: string | undefined;
         sectionId?: string | undefined;
+        labels?: string[] | undefined;
         cursor?: string | undefined;
+        labelsOperator?: "and" | "or" | undefined;
         searchText?: string | undefined;
     }, client: import("@doist/todoist-api-typescript").TodoistApi): Promise<{
         content: {
@@ -44,7 +48,9 @@ declare const findTasks: {
                 parentId?: string | undefined;
                 projectId?: string | undefined;
                 sectionId?: string | undefined;
+                labels?: string[] | undefined;
                 cursor?: string | undefined;
+                labelsOperator?: "and" | "or" | undefined;
                 searchText?: string | undefined;
             };
         };

package/dist/tools/find-tasks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"find-tasks.d.ts","sourceRoot":"","sources":["../../src/tools/find-tasks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAoCvB,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmF2B,CAAA;AAyG1C,OAAO,EAAE,SAAS,EAAE,CAAA"}
+{"version":3,"file":"find-tasks.d.ts","sourceRoot":"","sources":["../../src/tools/find-tasks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAsCvB,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2H2B,CAAA;AAqI1C,OAAO,EAAE,SAAS,EAAE,CAAA"}