@doist/todoist-ai 4.1.0 → 4.4.0

package/dist/tools/find-tasks.js

@@ -2,6 +2,7 @@ import { z } from 'zod';
 import { getToolOutput } from '../mcp-helpers.js';
 import { getTasksByFilter, mapTask } 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 { FIND_COMPLETED_TASKS, ADD_TASKS } = ToolNames;
@@ -21,16 +22,18 @@ 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 findTasks = {
     name: ToolNames.FIND_TASKS,
     description: 'Find tasks by text search, or by project/section/parent container. At least one filter must be provided.',
     parameters: ArgsSchema,
     async execute(args, client) {
-        const { searchText, projectId, sectionId, parentId, limit, cursor } = args;
+        const { searchText, projectId, sectionId, parentId, limit, cursor, labels, labelsOperator, } = args;
         // Validate at least one filter is provided
-        if (!searchText && !projectId && !sectionId && !parentId) {
-            throw new Error('At least one filter must be provided: searchText, projectId, sectionId, or parentId');
+        const hasLabels = labels && labels.length > 0;
+        if (!searchText && !projectId && !sectionId && !parentId && !hasLabels) {
+            throw new Error('At least one filter must be provided: searchText, projectId, sectionId, parentId, or labels');
         }
         // If using container-based filtering, use direct API
         if (projectId || sectionId || parentId) {
@@ -47,10 +50,17 @@ const findTasks = {
             const { results, nextCursor } = await client.getTasks(taskParams);
             const mappedTasks = results.map(mapTask);
             // If also has searchText, filter the results
-            const finalTasks = searchText
+            let finalTasks = searchText
                 ? mappedTasks.filter((task) => task.content.toLowerCase().includes(searchText.toLowerCase()) ||
                     task.description?.toLowerCase().includes(searchText.toLowerCase()))
                 : mappedTasks;
+            // If labels have also been provided, filter the results for those
+            if (labels && labels.length > 0) {
+                finalTasks =
+                    labelsOperator === 'and'
+                        ? finalTasks.filter((task) => labels.every((label) => task.labels.includes(label)))
+                        : finalTasks.filter((task) => labels.some((label) => task.labels.includes(label)));
+            }
             const textContent = generateTextContent({
                 tasks: finalTasks,
                 args,
@@ -68,10 +78,26 @@ const findTasks = {
                 },
             });
         }
-        // Text-only search using filter query
+        // Handle search text and/or labels using filter query
+        let query = '';
+        // Add search text component
+        if (searchText) {
+            query = `search: ${searchText}`;
+        }
+        // Add labels component
+        const labelsFilter = generateLabelsFilter(labels, labelsOperator);
+        if (labelsFilter.length > 0) {
+            if (query.length > 0) {
+                query += ` & ${labelsFilter}`;
+            }
+            else {
+                query = labelsFilter;
+            }
+        }
+        // Execute filter query
         const result = await getTasksByFilter({
             client,
-            query: `search: ${searchText}`,
+            query,
             cursor: args.cursor,
             limit: args.limit,
         });
@@ -146,15 +172,43 @@ function generateTextContent({ tasks, args, nextCursor, isContainerSearch, }) {
             subject += ` matching "${args.searchText}"`;
             filterHints.push(`containing "${args.searchText}"`);
         }
+        // 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}`);
+        }
         // Container-specific zero result hints
         if (tasks.length === 0) {
             zeroReasonHints.push(...getContainerZeroReasonHints(args));
         }
     }
     else {
-        // Text-only search
-        subject = `Search results for "${args.searchText}"`;
-        filterHints.push(`matching "${args.searchText}"`);
+        // Text-only search or labels-only search
+        if (args.searchText) {
+            subject = `Search results for "${args.searchText}"`;
+            filterHints.push(`matching "${args.searchText}"`);
+        }
+        else if (args.labels && args.labels.length > 0) {
+            // Labels-only search
+            const labelText = args.labels
+                .map((label) => `@${label}`)
+                .join(args.labelsOperator === 'and' ? ' & ' : ' | ');
+            subject = `Tasks with labels: ${labelText}`;
+            filterHints.push(`labels: ${labelText}`);
+        }
+        else {
+            // Fallback (shouldn't happen given validation)
+            subject = 'Tasks';
+        }
+        // Add label filter information for text search with labels
+        if (args.searchText && args.labels && args.labels.length > 0) {
+            const labelText = args.labels
+                .map((label) => `@${label}`)
+                .join(args.labelsOperator === 'and' ? ' & ' : ' | ');
+            filterHints.push(`labels: ${labelText}`);
+        }
         if (tasks.length === 0) {
             zeroReasonHints.push('Try broader search terms');
             zeroReasonHints.push(`Check completed tasks with ${FIND_COMPLETED_TASKS}`);

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

@@ -1,4 +1,3 @@
-import type { Comment } from '@doist/todoist-api-typescript';
 import { z } from 'zod';
 declare const updateComments: {
     name: "update-comments";
@@ -26,7 +25,31 @@ declare const updateComments: {
             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;
             updatedCommentIds: string[];
             appliedOperations: {

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

@@ -1 +1 @@
-{"version":3,"file":"update-comments.d.ts","sourceRoot":"","sources":["../../src/tools/update-comments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAA;AAC5D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAiBvB,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BsB,CAAA;AA2D1C,OAAO,EAAE,cAAc,EAAE,CAAA"}
+{"version":3,"file":"update-comments.d.ts","sourceRoot":"","sources":["../../src/tools/update-comments.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAiBvB,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAyF88V,CAAC;4BAA6C,CAAC;4BAA6C,CAAC;2BAA4C,CAAC;gCAAiD,CAAC;+BAAgD,CAAC;yBAA2D,CAAC;8BAA+C,CAAC;+BAAgD,CAAC;uBAAwC,CAAC;yBAA0C,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;CA5Dt5W,CAAA;AA2D1C,OAAO,EAAE,cAAc,EAAE,CAAA"}

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

@@ -1,4 +1,3 @@
-import type { PersonalProject, WorkspaceProject } from '@doist/todoist-api-typescript';
 import { z } from 'zod';
 declare const updateProjects: {
     name: "update-projects";
@@ -34,7 +33,52 @@ declare const updateProjects: {
             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;
             updatedProjectIds: string[];
             appliedOperations: {

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

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

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

@@ -1,4 +1,3 @@
-import type { Section } from '@doist/todoist-api-typescript';
 import { z } from 'zod';
 declare const updateSections: {
     name: "update-sections";
@@ -26,7 +25,20 @@ declare const updateSections: {
             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;
             updatedSectionIds: string[];
         };

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

@@ -1 +1 @@
-{"version":3,"file":"update-sections.d.ts","sourceRoot":"","sources":["../../src/tools/update-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,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsBsB,CAAA;AAsD1C,OAAO,EAAE,cAAc,EAAE,CAAA"}
+{"version":3,"file":"update-sections.d.ts","sourceRoot":"","sources":["../../src/tools/update-sections.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAiBvB,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsBsB,CAAA;AAsD1C,OAAO,EAAE,cAAc,EAAE,CAAA"}

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

@@ -21,9 +21,9 @@ declare const updateTasks: {
             parentId?: string | undefined;
             projectId?: string | undefined;
             sectionId?: string | undefined;
+            duration?: string | undefined;
             priority?: number | undefined;
             dueString?: string | undefined;
-            duration?: string | undefined;
             order?: number | undefined;
         }, {
             id: string;
@@ -32,9 +32,9 @@ declare const updateTasks: {
             parentId?: string | undefined;
             projectId?: string | undefined;
             sectionId?: string | undefined;
+            duration?: string | undefined;
             priority?: number | undefined;
             dueString?: string | undefined;
-            duration?: string | undefined;
             order?: number | undefined;
         }>, "many">;
     };
@@ -46,9 +46,9 @@ declare const updateTasks: {
             parentId?: string | undefined;
             projectId?: string | undefined;
             sectionId?: string | undefined;
+            duration?: string | undefined;
             priority?: number | undefined;
             dueString?: string | undefined;
-            duration?: string | undefined;
             order?: number | undefined;
         }[];
     }, client: import("@doist/todoist-api-typescript").TodoistApi): Promise<{

package/dist/tools/user-info.d.ts

@@ -0,0 +1,44 @@
+import type { TodoistApi } from '@doist/todoist-api-typescript';
+type UserPlan = 'Todoist Free' | 'Todoist Pro' | 'Todoist Business';
+type UserInfoStructured = Record<string, unknown> & {
+    type: 'user_info';
+    userId: string;
+    fullName: string;
+    timezone: string;
+    currentLocalTime: string;
+    startDay: number;
+    startDayName: string;
+    weekStartDate: string;
+    weekEndDate: string;
+    currentWeekNumber: number;
+    completedToday: number;
+    dailyGoal: number;
+    weeklyGoal: number;
+    email: string;
+    plan: UserPlan;
+};
+declare const userInfo: {
+    name: "user-info";
+    description: string;
+    parameters: {};
+    execute(_args: {}, client: TodoistApi): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        structuredContent: UserInfoStructured;
+    } | {
+        content: ({
+            type: "text";
+            text: string;
+            mimeType?: undefined;
+        } | {
+            type: "text";
+            mimeType: string;
+            text: string;
+        })[];
+        structuredContent?: undefined;
+    }>;
+};
+export { userInfo, type UserInfoStructured };
+//# sourceMappingURL=user-info.d.ts.map

package/dist/tools/user-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-info.d.ts","sourceRoot":"","sources":["../../src/tools/user-info.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAA;AAO/D,KAAK,QAAQ,GAAG,cAAc,GAAG,aAAa,GAAG,kBAAkB,CAAA;AAEnE,KAAK,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAChD,IAAI,EAAE,WAAW,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,gBAAgB,EAAE,MAAM,CAAA;IACxB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,iBAAiB,EAAE,MAAM,CAAA;IACzB,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,QAAQ,CAAA;CACjB,CAAA;AAoJD,QAAA,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;CAa4B,CAAA;AAE1C,OAAO,EAAE,QAAQ,EAAE,KAAK,kBAAkB,EAAE,CAAA"}

package/dist/tools/user-info.js

@@ -0,0 +1,142 @@
+import { getToolOutput } from '../mcp-helpers.js';
+import { ToolNames } from '../utils/tool-names.js';
+const ArgsSchema = {};
+function getUserPlan(user) {
+    if (user.businessAccountId) {
+        return 'Todoist Business';
+    }
+    if (user.isPremium) {
+        return 'Todoist Pro';
+    }
+    return 'Todoist Free';
+}
+// Helper functions for date and time calculations
+function getWeekStartDate(date, startDay) {
+    const currentDay = date.getDay() || 7; // Convert Sunday (0) to 7 for ISO format
+    const daysFromStart = (currentDay - startDay + 7) % 7;
+    const weekStart = new Date(date);
+    weekStart.setDate(date.getDate() - daysFromStart);
+    return weekStart;
+}
+function getWeekEndDate(weekStart) {
+    const weekEnd = new Date(weekStart);
+    weekEnd.setDate(weekStart.getDate() + 6);
+    return weekEnd;
+}
+function getWeekNumber(date) {
+    const firstDayOfYear = new Date(date.getFullYear(), 0, 1);
+    const pastDaysOfYear = (date.getTime() - firstDayOfYear.getTime()) / 86400000;
+    return Math.ceil((pastDaysOfYear + firstDayOfYear.getDay() + 1) / 7);
+}
+function getDayName(dayNumber) {
+    const days = ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'];
+    // Convert ISO day number (1=Monday, 7=Sunday) to array index (0=Sunday, 6=Saturday)
+    const index = dayNumber === 7 ? 0 : dayNumber;
+    return days[index] ?? 'Unknown';
+}
+function formatDate(date) {
+    return date.toISOString().split('T')[0] ?? '';
+}
+function isValidTimezone(timezone) {
+    try {
+        // Test if the timezone is valid by attempting to format a date with it
+        new Intl.DateTimeFormat('en-US', { timeZone: timezone });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function getSafeTimezone(timezone) {
+    return isValidTimezone(timezone) ? timezone : 'UTC';
+}
+function formatLocalTime(date, timezone) {
+    const safeTimezone = getSafeTimezone(timezone);
+    return date.toLocaleString('en-US', {
+        timeZone: safeTimezone,
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+        hour12: false,
+    });
+}
+async function generateUserInfo(client) {
+    // Get user information from Todoist API
+    const user = await client.getUser();
+    // Parse timezone from user data and ensure it's valid
+    const rawTimezone = user.tzInfo?.timezone ?? 'UTC';
+    const timezone = getSafeTimezone(rawTimezone);
+    // Get current time in user's timezone
+    const now = new Date();
+    const localTime = formatLocalTime(now, timezone);
+    // Calculate week information based on user's start day
+    const startDay = user.startDay ?? 1; // Default to Monday if not set
+    const startDayName = getDayName(startDay);
+    // Determine user's plan
+    const plan = getUserPlan(user);
+    // Create a date object in user's timezone for accurate week calculations
+    const userDate = new Date(now.toLocaleString('en-US', { timeZone: timezone }));
+    const weekStart = getWeekStartDate(userDate, startDay);
+    const weekEnd = getWeekEndDate(weekStart);
+    const weekNumber = getWeekNumber(userDate);
+    // Generate markdown text content
+    const lines = [
+        '# User Information',
+        '',
+        `**User ID:** ${user.id}`,
+        `**Full Name:** ${user.fullName}`,
+        `**Email:** ${user.email}`,
+        `**Timezone:** ${timezone}`,
+        `**Current Local Time:** ${localTime}`,
+        '',
+        '## Week Settings',
+        `**Week Start Day:** ${startDayName} (${startDay})`,
+        `**Current Week:** Week ${weekNumber}`,
+        `**Week Start Date:** ${formatDate(weekStart)}`,
+        `**Week End Date:** ${formatDate(weekEnd)}`,
+        '',
+        '## Daily Progress',
+        `**Completed Today:** ${user.completedToday}`,
+        `**Daily Goal:** ${user.dailyGoal}`,
+        `**Weekly Goal:** ${user.weeklyGoal}`,
+        '',
+        '## Account Info',
+        `**Plan:** ${plan}`,
+    ];
+    const textContent = lines.join('\n');
+    // Generate structured content
+    const structuredContent = {
+        type: 'user_info',
+        userId: user.id,
+        fullName: user.fullName,
+        timezone: timezone,
+        currentLocalTime: localTime,
+        startDay: startDay,
+        startDayName: startDayName,
+        weekStartDate: formatDate(weekStart),
+        weekEndDate: formatDate(weekEnd),
+        currentWeekNumber: weekNumber,
+        completedToday: user.completedToday,
+        dailyGoal: user.dailyGoal,
+        weeklyGoal: user.weeklyGoal,
+        email: user.email,
+        plan: plan,
+    };
+    return { textContent, structuredContent };
+}
+const userInfo = {
+    name: ToolNames.USER_INFO,
+    description: 'Get comprehensive user information including user ID, full name, email, timezone with current local time, week start day preferences, current week dates, daily/weekly goal progress, and user plan (Free/Pro/Business).',
+    parameters: ArgsSchema,
+    async execute(_args, client) {
+        const result = await generateUserInfo(client);
+        return getToolOutput({
+            textContent: result.textContent,
+            structuredContent: result.structuredContent,
+        });
+    },
+};
+export { userInfo };

package/dist/utils/labels.d.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+declare const LABELS_OPERATORS: readonly ["and", "or"];
+type LabelsOperator = (typeof LABELS_OPERATORS)[number];
+export declare const LabelsSchema: {
+    labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    labelsOperator: z.ZodOptional<z.ZodEnum<["and", "or"]>>;
+};
+export declare function generateLabelsFilter(labels?: string[], labelsOperator?: LabelsOperator): string;
+export {};
+//# sourceMappingURL=labels.d.ts.map

package/dist/utils/labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../src/utils/labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,QAAA,MAAM,gBAAgB,wBAAyB,CAAA;AAC/C,KAAK,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEvD,eAAO,MAAM,YAAY;;;CAQxB,CAAA;AAED,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,MAAM,EAAO,EAAE,cAAc,GAAE,cAAqB,UAOhG"}

package/dist/utils/labels.js

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+const LABELS_OPERATORS = ['and', 'or'];
+export const LabelsSchema = {
+    labels: z.string().array().optional().describe('The labels to filter the tasks by'),
+    labelsOperator: z
+        .enum(LABELS_OPERATORS)
+        .optional()
+        .describe('The operator to use when filtering by labels. This will dictate whether a task has all labels, or some of them. Default is "or".'),
+};
+export function generateLabelsFilter(labels = [], labelsOperator = 'or') {
+    if (labels.length === 0)
+        return '';
+    const operator = labelsOperator === 'and' ? ' & ' : ' | ';
+    // Add @ prefix to labels for Todoist API query
+    const prefixedLabels = labels.map((label) => (label.startsWith('@') ? label : `@${label}`));
+    const labelStr = prefixedLabels.join(` ${operator} `);
+    return `(${labelStr})`;
+}

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

@@ -1 +1 @@
-{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/test-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAA;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAE9C;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,SAAS,EAAE,MAAM,GAAG,OAAO,CAAA;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B,CAAA;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,GAAE,OAAO,CAAC,IAAI,CAAM,GAAG,IAAI,CA8BlE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,GAAE,OAAO,CAAC,OAAO,CAAM,GAAG,OAAO,CAe3E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,GAAE,OAAO,CAAC,eAAe,CAAM,GAAG,eAAe,CAuB3F;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACnC,OAAO,EAAE,CAAC,EAAE,EACZ,UAAU,GAAE,MAAM,GAAG,IAAW,GACjC;IACC,OAAO,EAAE,CAAC,EAAE,CAAA;IACZ,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B,CAKA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,GAAE,OAAO,CAAC,UAAU,CAAM,GAAG,UAAU,CAehF;AAED;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;CAKd,CAAA;AAEV;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,EAC1C,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;CAAE,CAAC;UAAjC,MAAM;WAAS,CAAC;eAAa,CAAC;IAGtD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,CAqB9D;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACpC,MAAM,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,GACzC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuBzB;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;CAUX,CAAA;AAEV;;;GAGG;AACH,eAAO,MAAM,KAAK,EAAG,YAAqB,CAAA"}
+{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/test-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAA;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAE9C;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,SAAS,EAAE,MAAM,GAAG,OAAO,CAAA;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B,CAAA;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,GAAE,OAAO,CAAC,IAAI,CAAM,GAAG,IAAI,CA8BlE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,GAAE,OAAO,CAAC,OAAO,CAAM,GAAG,OAAO,CAgB3E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,GAAE,OAAO,CAAC,eAAe,CAAM,GAAG,eAAe,CAuB3F;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACnC,OAAO,EAAE,CAAC,EAAE,EACZ,UAAU,GAAE,MAAM,GAAG,IAAW,GACjC;IACC,OAAO,EAAE,CAAC,EAAE,CAAA;IACZ,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B,CAKA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,GAAE,OAAO,CAAC,UAAU,CAAM,GAAG,UAAU,CAehF;AAED;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;CAKd,CAAA;AAEV;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,EAC1C,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;CAAE,CAAC;UAAjC,MAAM;WAAS,CAAC;eAAa,CAAC;IAGtD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,CAqB9D;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACpC,MAAM,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,GACzC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuBzB;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;CAUX,CAAA;AAEV;;;GAGG;AACH,eAAO,MAAM,KAAK,EAAG,YAAqB,CAAA"}

package/dist/utils/test-helpers.js

@@ -50,6 +50,7 @@ export function createMockSection(overrides = {}) {
         isDeleted: false,
         isCollapsed: false,
         name: 'Test Section',
+        url: 'https://todoist.com/sections/section-123',
         ...overrides,
     };
 }

package/dist/utils/tool-names.d.ts

@@ -23,6 +23,7 @@ export declare const ToolNames: {
     readonly FIND_COMMENTS: "find-comments";
     readonly GET_OVERVIEW: "get-overview";
     readonly DELETE_OBJECT: "delete-object";
+    readonly USER_INFO: "user-info";
 };
 export type ToolName = (typeof ToolNames)[keyof typeof ToolNames];
 //# sourceMappingURL=tool-names.d.ts.map

package/dist/utils/tool-names.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-names.d.ts","sourceRoot":"","sources":["../../src/utils/tool-names.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;CA2BZ,CAAA;AAGV,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAA"}
+{"version":3,"file":"tool-names.d.ts","sourceRoot":"","sources":["../../src/utils/tool-names.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;CA4BZ,CAAA;AAGV,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAA"}

package/dist/utils/tool-names.js

@@ -28,4 +28,5 @@ export const ToolNames = {
     // General tools
     GET_OVERVIEW: 'get-overview',
     DELETE_OBJECT: 'delete-object',
+    USER_INFO: 'user-info',
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@doist/todoist-ai",
-    "version": "4.1.0",
+    "version": "4.4.0",
     "type": "module",
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",
@@ -44,7 +44,7 @@
         "prepare": "husky"
     },
     "dependencies": {
-        "@doist/todoist-api-typescript": "5.1.2",
+        "@doist/todoist-api-typescript": "5.4.0",
         "@modelcontextprotocol/sdk": "^1.11.1",
         "date-fns": "^4.1.0",
         "dotenv": "^16.5.0",
@@ -59,7 +59,7 @@
         "concurrently": "^8.2.2",
         "express": "^4.19.2",
         "husky": "^9.1.7",
-        "jest": "30.0.5",
+        "jest": "30.1.3",
         "lint-staged": "^16.0.0",
         "morgan": "^1.10.0",
         "nodemon": "^3.1.10",