@doist/todoist-ai 4.1.0 → 4.5.1

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/assignment-validator.d.ts

@@ -0,0 +1,69 @@
+import type { TodoistApi } from '@doist/todoist-api-typescript';
+import { type ResolvedUser } from './user-resolver.js';
+export declare const AssignmentErrorType: {
+    readonly USER_NOT_FOUND: "USER_NOT_FOUND";
+    readonly USER_NOT_COLLABORATOR: "USER_NOT_COLLABORATOR";
+    readonly PROJECT_NOT_SHARED: "PROJECT_NOT_SHARED";
+    readonly TASK_NOT_ACCESSIBLE: "TASK_NOT_ACCESSIBLE";
+    readonly PERMISSION_DENIED: "PERMISSION_DENIED";
+    readonly PROJECT_NOT_FOUND: "PROJECT_NOT_FOUND";
+    readonly TASK_NOT_FOUND: "TASK_NOT_FOUND";
+};
+export type AssignmentErrorType = (typeof AssignmentErrorType)[keyof typeof AssignmentErrorType];
+export type ValidationError = {
+    type: AssignmentErrorType;
+    message: string;
+    suggestions?: string[];
+};
+export type ValidationResult = {
+    isValid: boolean;
+    resolvedUser?: ResolvedUser;
+    error?: ValidationError;
+    taskId?: string;
+    projectId?: string;
+};
+export type Assignment = {
+    taskId?: string;
+    projectId: string;
+    responsibleUid: string;
+};
+export declare class AssignmentValidator {
+    /**
+     * Validate a single assignment operation
+     */
+    validateAssignment(client: TodoistApi, assignment: Assignment): Promise<ValidationResult>;
+    /**
+     * Validate multiple assignment operations in bulk
+     */
+    validateBulkAssignment(client: TodoistApi, assignments: Assignment[]): Promise<ValidationResult[]>;
+    /**
+     * Validate assignment for task creation (no taskId required)
+     */
+    validateTaskCreationAssignment(client: TodoistApi, projectId: string, responsibleUid: string): Promise<ValidationResult>;
+    /**
+     * Validate assignment for task update
+     */
+    validateTaskUpdateAssignment(client: TodoistApi, taskId: string, responsibleUid: string | null): Promise<ValidationResult>;
+    /**
+     * Get detailed assignment eligibility information for troubleshooting
+     */
+    getAssignmentEligibility(client: TodoistApi, projectId: string, responsibleUid: string, taskIds?: string[]): Promise<{
+        canAssign: boolean;
+        projectInfo: {
+            name: string;
+            isShared: boolean;
+            collaboratorCount: number;
+        };
+        userInfo?: {
+            resolvedName: string;
+            isCollaborator: boolean;
+        };
+        taskInfo?: {
+            accessibleTasks: number;
+            inaccessibleTasks: number;
+        };
+        recommendations: string[];
+    }>;
+}
+export declare const assignmentValidator: AssignmentValidator;
+//# sourceMappingURL=assignment-validator.d.ts.map

package/dist/utils/assignment-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assignment-validator.d.ts","sourceRoot":"","sources":["../../src/utils/assignment-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAA;AAE/D,OAAO,EAAE,KAAK,YAAY,EAAgB,MAAM,oBAAoB,CAAA;AAEpE,eAAO,MAAM,mBAAmB;;;;;;;;CAQtB,CAAA;AAEV,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAA;AAEhG,MAAM,MAAM,eAAe,GAAG;IAC1B,IAAI,EAAE,mBAAmB,CAAA;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC3B,OAAO,EAAE,OAAO,CAAA;IAChB,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,KAAK,CAAC,EAAE,eAAe,CAAA;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;CACzB,CAAA;AAED,qBAAa,mBAAmB;IAC5B;;OAEG;IACG,kBAAkB,CACpB,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,UAAU,GACvB,OAAO,CAAC,gBAAgB,CAAC;IAqH5B;;OAEG;IACG,sBAAsB,CACxB,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,UAAU,EAAE,GAC1B,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAS9B;;OAEG;IACG,8BAA8B,CAChC,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,GACvB,OAAO,CAAC,gBAAgB,CAAC;IAO5B;;OAEG;IACG,4BAA4B,CAC9B,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,GAAG,IAAI,GAC9B,OAAO,CAAC,gBAAgB,CAAC;IAkC5B;;OAEG;IACG,wBAAwB,CAC1B,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC;QACP,SAAS,EAAE,OAAO,CAAA;QAClB,WAAW,EAAE;YACT,IAAI,EAAE,MAAM,CAAA;YACZ,QAAQ,EAAE,OAAO,CAAA;YACjB,iBAAiB,EAAE,MAAM,CAAA;SAC5B,CAAA;QACD,QAAQ,CAAC,EAAE;YACP,YAAY,EAAE,MAAM,CAAA;YACpB,cAAc,EAAE,OAAO,CAAA;SAC1B,CAAA;QACD,QAAQ,CAAC,EAAE;YACP,eAAe,EAAE,MAAM,CAAA;YACvB,iBAAiB,EAAE,MAAM,CAAA;SAC5B,CAAA;QACD,eAAe,EAAE,MAAM,EAAE,CAAA;KAC5B,CAAC;CAqFL;AAGD,eAAO,MAAM,mBAAmB,qBAA4B,CAAA"}

package/dist/utils/assignment-validator.js

@@ -0,0 +1,253 @@
+import { userResolver } from './user-resolver.js';
+export const AssignmentErrorType = {
+    USER_NOT_FOUND: 'USER_NOT_FOUND',
+    USER_NOT_COLLABORATOR: 'USER_NOT_COLLABORATOR',
+    PROJECT_NOT_SHARED: 'PROJECT_NOT_SHARED',
+    TASK_NOT_ACCESSIBLE: 'TASK_NOT_ACCESSIBLE',
+    PERMISSION_DENIED: 'PERMISSION_DENIED',
+    PROJECT_NOT_FOUND: 'PROJECT_NOT_FOUND',
+    TASK_NOT_FOUND: 'TASK_NOT_FOUND',
+};
+export class AssignmentValidator {
+    /**
+     * Validate a single assignment operation
+     */
+    async validateAssignment(client, assignment) {
+        const { taskId, projectId, responsibleUid } = assignment;
+        // First, resolve the user
+        const resolvedUser = await userResolver.resolveUser(client, responsibleUid);
+        if (!resolvedUser) {
+            return {
+                isValid: false,
+                taskId,
+                projectId,
+                error: {
+                    type: AssignmentErrorType.USER_NOT_FOUND,
+                    message: `User "${responsibleUid}" not found`,
+                    suggestions: [
+                        'Check the spelling of the user name or email',
+                        'Ensure the user is a collaborator on at least one shared project',
+                        "Try using the user's full email address",
+                    ],
+                },
+            };
+        }
+        // Validate the project exists and is accessible
+        try {
+            const targetProject = await client.getProject(projectId);
+            // Check if project is shared (required for assignments)
+            if (!targetProject.isShared) {
+                return {
+                    isValid: false,
+                    taskId,
+                    projectId,
+                    resolvedUser,
+                    error: {
+                        type: AssignmentErrorType.PROJECT_NOT_SHARED,
+                        message: `Project "${targetProject.name}" is not shared`,
+                        suggestions: [
+                            'Share the project with collaborators before assigning tasks',
+                            'Only shared projects support task assignments',
+                        ],
+                    },
+                };
+            }
+            // Validate the user is a collaborator on this specific project
+            const isCollaborator = await userResolver.validateProjectCollaborator(client, projectId, resolvedUser.userId);
+            if (!isCollaborator) {
+                return {
+                    isValid: false,
+                    taskId,
+                    projectId,
+                    resolvedUser,
+                    error: {
+                        type: AssignmentErrorType.USER_NOT_COLLABORATOR,
+                        message: `User "${resolvedUser.displayName}" is not a collaborator on project "${targetProject.name}"`,
+                        suggestions: [
+                            'Invite the user to collaborate on this project first',
+                            'Check if the user has been removed from the project',
+                            'Verify you have permission to see project collaborators',
+                        ],
+                    },
+                };
+            }
+            // If taskId is provided, validate the task exists and is accessible
+            if (taskId) {
+                try {
+                    await client.getTask(taskId);
+                }
+                catch (_error) {
+                    return {
+                        isValid: false,
+                        taskId,
+                        projectId,
+                        resolvedUser,
+                        error: {
+                            type: AssignmentErrorType.TASK_NOT_FOUND,
+                            message: `Task "${taskId}" not found or not accessible`,
+                            suggestions: [
+                                'Verify the task ID is correct',
+                                'Check if the task has been deleted',
+                                'Ensure you have access to the task',
+                            ],
+                        },
+                    };
+                }
+            }
+            return {
+                isValid: true,
+                taskId,
+                projectId,
+                resolvedUser,
+            };
+        }
+        catch (_error) {
+            return {
+                isValid: false,
+                taskId,
+                projectId,
+                resolvedUser,
+                error: {
+                    type: AssignmentErrorType.PERMISSION_DENIED,
+                    message: 'Permission denied or API error occurred',
+                    suggestions: [
+                        'Check your API permissions',
+                        'Verify you have access to the project',
+                        'Try again later if this is a temporary API issue',
+                    ],
+                },
+            };
+        }
+    }
+    /**
+     * Validate multiple assignment operations in bulk
+     */
+    async validateBulkAssignment(client, assignments) {
+        // Process assignments in parallel for better performance
+        const validationPromises = assignments.map((assignment) => this.validateAssignment(client, assignment));
+        return Promise.all(validationPromises);
+    }
+    /**
+     * Validate assignment for task creation (no taskId required)
+     */
+    async validateTaskCreationAssignment(client, projectId, responsibleUid) {
+        return this.validateAssignment(client, {
+            projectId,
+            responsibleUid,
+        });
+    }
+    /**
+     * Validate assignment for task update
+     */
+    async validateTaskUpdateAssignment(client, taskId, responsibleUid) {
+        // If responsibleUid is null, it's an unassignment - always valid
+        if (responsibleUid === null) {
+            return {
+                isValid: true,
+                taskId,
+            };
+        }
+        // Get the task to find its project
+        try {
+            const task = await client.getTask(taskId);
+            return this.validateAssignment(client, {
+                taskId,
+                projectId: task.projectId,
+                responsibleUid,
+            });
+        }
+        catch (_error) {
+            return {
+                isValid: false,
+                taskId,
+                error: {
+                    type: AssignmentErrorType.TASK_NOT_FOUND,
+                    message: `Task "${taskId}" not found or not accessible`,
+                    suggestions: [
+                        'Verify the task ID is correct',
+                        'Check if the task has been deleted',
+                        'Ensure you have access to the task',
+                    ],
+                },
+            };
+        }
+    }
+    /**
+     * Get detailed assignment eligibility information for troubleshooting
+     */
+    async getAssignmentEligibility(client, projectId, responsibleUid, taskIds) {
+        const recommendations = [];
+        let canAssign = false;
+        // Get project information
+        let project;
+        try {
+            project = await client.getProject(projectId);
+        }
+        catch {
+            return {
+                canAssign: false,
+                projectInfo: {
+                    name: 'Unknown',
+                    isShared: false,
+                    collaboratorCount: 0,
+                },
+                recommendations: ['Project not found or not accessible'],
+            };
+        }
+        const collaborators = await userResolver.getProjectCollaborators(client, projectId);
+        const projectInfo = {
+            name: project.name,
+            isShared: project.isShared,
+            collaboratorCount: collaborators.length,
+        };
+        if (!project.isShared) {
+            recommendations.push('Share this project to enable task assignments');
+            return { canAssign: false, projectInfo, recommendations };
+        }
+        // Resolve user
+        const resolvedUser = await userResolver.resolveUser(client, responsibleUid);
+        if (!resolvedUser) {
+            recommendations.push('User not found - check spelling or invite to a shared project');
+            return { canAssign: false, projectInfo, recommendations };
+        }
+        const isCollaborator = collaborators.some((c) => c.id === resolvedUser.userId);
+        const userInfo = {
+            resolvedName: resolvedUser.displayName,
+            isCollaborator,
+        };
+        if (!isCollaborator) {
+            recommendations.push(`Invite ${resolvedUser.displayName} to collaborate on project "${project.name}"`);
+            return { canAssign: false, projectInfo, userInfo, recommendations };
+        }
+        // Check task accessibility if provided
+        let taskInfo;
+        if (taskIds && taskIds.length > 0) {
+            let accessible = 0;
+            let inaccessible = 0;
+            for (const taskId of taskIds) {
+                try {
+                    await client.getTask(taskId);
+                    accessible++;
+                }
+                catch {
+                    inaccessible++;
+                }
+            }
+            taskInfo = { accessibleTasks: accessible, inaccessibleTasks: inaccessible };
+            if (inaccessible > 0) {
+                recommendations.push(`${inaccessible} task(s) are not accessible`);
+            }
+        }
+        canAssign = true;
+        recommendations.push(`Ready to assign tasks to ${resolvedUser.displayName}`);
+        return {
+            canAssign,
+            projectInfo,
+            userInfo,
+            taskInfo,
+            recommendations,
+        };
+    }
+}
+// Export singleton instance
+export const assignmentValidator = new AssignmentValidator();

package/dist/utils/duration-parser.d.ts

@@ -9,9 +9,9 @@
  * - "1.5h" (decimal hours)
  * - Supports optional spaces: "2h 30m"
  */
-interface ParsedDuration {
+type ParsedDuration = {
     minutes: number;
-}
+};
 export declare class DurationParseError extends Error {
     constructor(input: string, reason: string);
 }

package/dist/utils/duration-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"duration-parser.d.ts","sourceRoot":"","sources":["../../src/utils/duration-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,UAAU,cAAc;IACpB,OAAO,EAAE,MAAM,CAAA;CAClB;AAED,qBAAa,kBAAmB,SAAQ,KAAK;gBAC7B,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAI5C;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAgEjE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAetD"}
+{"version":3,"file":"duration-parser.d.ts","sourceRoot":"","sources":["../../src/utils/duration-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,KAAK,cAAc,GAAG;IAClB,OAAO,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,qBAAa,kBAAmB,SAAQ,KAAK;gBAC7B,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAI5C;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAgEjE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAetD"}

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/priorities.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+declare const PRIORITY_VALUES: readonly ["p1", "p2", "p3", "p4"];
+type Priority = (typeof PRIORITY_VALUES)[number];
+export declare const PrioritySchema: z.ZodEnum<["p1", "p2", "p3", "p4"]>;
+export declare function convertPriorityToNumber(priority: Priority): number;
+export declare function convertNumberToPriority(priority: number): Priority | undefined;
+export {};
+//# sourceMappingURL=priorities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"priorities.d.ts","sourceRoot":"","sources":["../../src/utils/priorities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,QAAA,MAAM,eAAe,mCAAoC,CAAA;AACzD,KAAK,QAAQ,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAA;AAEhD,eAAO,MAAM,cAAc,qCAEzB,CAAA;AAEF,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAIlE;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAI9E"}

package/dist/utils/priorities.js

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+const PRIORITY_VALUES = ['p1', 'p2', 'p3', 'p4'];
+export const PrioritySchema = z.enum(PRIORITY_VALUES, {
+    description: 'Task priority: p1 (highest), p2 (high), p3 (medium), p4 (lowest/default)',
+});
+export function convertPriorityToNumber(priority) {
+    // Todoist API uses inverse mapping: p1=4 (highest), p2=3, p3=2, p4=1 (lowest)
+    const priorityMap = { p1: 4, p2: 3, p3: 2, p4: 1 };
+    return priorityMap[priority];
+}
+export function convertNumberToPriority(priority) {
+    // Convert Todoist API numbers back to our enum
+    const numberMap = { 4: 'p1', 3: 'p2', 2: 'p3', 1: 'p4' };
+    return numberMap[priority];
+}

package/dist/utils/response-builders.d.ts

@@ -53,7 +53,7 @@ export declare function formatProjectPreview(project: ProjectLike): string;
  * Creates preview lines for task lists
  */
 export declare function previewTasks(tasks: TaskLike[], limit?: number): string;
-interface SummarizeListParams {
+type SummarizeListParams = {
     subject: string;
     count: number;
     limit?: number;
@@ -62,7 +62,7 @@ interface SummarizeListParams {
     previewLines?: string;
     zeroReasonHints?: string[];
     nextSteps?: string[];
-}
+};
 /**
  * Creates list summaries with counts, filters, and guidance
  */

package/dist/utils/response-builders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"response-builders.d.ts","sourceRoot":"","sources":["../../src/utils/response-builders.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM,CAG7D;AAID,KAAK,QAAQ,GAAG;IACZ,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,KAAK,WAAW,GAAG;IACf,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,KAAK,oBAAoB,GAAG;IACxB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,OAAO,CAAA;CACxB,CAAA;AAED,KAAK,oBAAoB,GAAG;IACxB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,QAAQ,CAAC,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAA;QACZ,KAAK,EAAE,MAAM,CAAA;QACb,IAAI,CAAC,EAAE,MAAM,CAAA;KAChB,CAAC,CAAA;IACF,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB,CAAA;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAClC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,QAAQ,EAAE,EACjB,OAAO,GAAE,oBAAyB,GACnC,MAAM,CA0BR;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CA+BnE;AAcD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAQjE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,KAAK,SAAI,GAAG,MAAM,CAEjE;AAED,UAAU,mBAAmB;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAC1B,OAAO,EACP,KAAK,EACL,KAAK,EACL,UAAU,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,SAAS,GACZ,EAAE,mBAAmB,GAAG,MAAM,CA8B9B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAMhF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACjC,SAAS,EAAE,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,EACrE,KAAK,EAAE,QAAQ,EAAE,EACjB,OAAO,CAAC,EAAE;IACN,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,CAAA;IAC/C,aAAa,CAAC,EAAE,OAAO,CAAA;CAC1B,GACF,MAAM,EAAE,CA6EV"}
+{"version":3,"file":"response-builders.d.ts","sourceRoot":"","sources":["../../src/utils/response-builders.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM,CAG7D;AAID,KAAK,QAAQ,GAAG;IACZ,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,KAAK,WAAW,GAAG;IACf,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,KAAK,oBAAoB,GAAG;IACxB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,OAAO,CAAA;CACxB,CAAA;AAED,KAAK,oBAAoB,GAAG;IACxB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,QAAQ,CAAC,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAA;QACZ,KAAK,EAAE,MAAM,CAAA;QACb,IAAI,CAAC,EAAE,MAAM,CAAA;KAChB,CAAC,CAAA;IACF,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB,CAAA;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAClC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,QAAQ,EAAE,EACjB,OAAO,GAAE,oBAAyB,GACnC,MAAM,CA0BR;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CA+BnE;AAcD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAQjE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,KAAK,SAAI,GAAG,MAAM,CAWjE;AAED,KAAK,mBAAmB,GAAG;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB,CAAA;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAC1B,OAAO,EACP,KAAK,EACL,KAAK,EACL,UAAU,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,SAAS,GACZ,EAAE,mBAAmB,GAAG,MAAM,CA8B9B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAMhF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACjC,SAAS,EAAE,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,EACrE,KAAK,EAAE,QAAQ,EAAE,EACjB,OAAO,CAAC,EAAE;IACN,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,CAAA;IAC/C,aAAa,CAAC,EAAE,OAAO,CAAA;CAC1B,GACF,MAAM,EAAE,CA6EV"}

package/dist/utils/response-builders.js

@@ -88,7 +88,14 @@ export function formatProjectPreview(project) {
  * Creates preview lines for task lists
  */
 export function previewTasks(tasks, limit = 5) {
-    return tasks.slice(0, limit).map(formatTaskPreview).join('\n');
+    const previewTasks = tasks.slice(0, limit);
+    const lines = previewTasks.map(formatTaskPreview).join('\n');
+    // If we're showing fewer tasks than the total, add an indicator
+    if (tasks.length > limit) {
+        const remaining = tasks.length - limit;
+        return `${lines}\n    ... and ${remaining} more task${remaining === 1 ? '' : 's'}`;
+    }
+    return lines;
 }
 /**
  * Creates list summaries with counts, filters, and guidance

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

@@ -16,6 +16,8 @@ export type MappedTask = {
     parentId: string | null;
     labels: string[];
     duration: string | null;
+    responsibleUid: string | null;
+    assignedByUid: string | null;
 };
 /**
  * Creates a mock Task with all required properties and sensible defaults.