@doist/todoist-ai 4.4.0 → 4.5.1

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

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.

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,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"}
+{"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;IACvB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B,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,CAiBhF;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

@@ -107,6 +107,8 @@ export function createMappedTask(overrides = {}) {
         parentId: null,
         labels: [],
         duration: null,
+        responsibleUid: null,
+        assignedByUid: null,
         ...overrides,
     };
 }

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

@@ -21,6 +21,8 @@ export declare const ToolNames: {
     readonly ADD_COMMENTS: "add-comments";
     readonly UPDATE_COMMENTS: "update-comments";
     readonly FIND_COMMENTS: "find-comments";
+    readonly FIND_PROJECT_COLLABORATORS: "find-project-collaborators";
+    readonly MANAGE_ASSIGNMENTS: "manage-assignments";
     readonly GET_OVERVIEW: "get-overview";
     readonly DELETE_OBJECT: "delete-object";
     readonly USER_INFO: "user-info";

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;;;;;;;;;;;;;;;;;;;CA4BZ,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;;;;;;;;;;;;;;;;;;;;;CAgCZ,CAAA;AAGV,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAA"}

package/dist/utils/tool-names.js

@@ -25,6 +25,9 @@ export const ToolNames = {
     ADD_COMMENTS: 'add-comments',
     UPDATE_COMMENTS: 'update-comments',
     FIND_COMMENTS: 'find-comments',
+    // Assignment and collaboration tools
+    FIND_PROJECT_COLLABORATORS: 'find-project-collaborators',
+    MANAGE_ASSIGNMENTS: 'manage-assignments',
     // General tools
     GET_OVERVIEW: 'get-overview',
     DELETE_OBJECT: 'delete-object',

package/dist/utils/user-resolver.d.ts

@@ -0,0 +1,39 @@
+import type { TodoistApi } from '@doist/todoist-api-typescript';
+export type ResolvedUser = {
+    userId: string;
+    displayName: string;
+};
+export type ProjectCollaborator = {
+    id: string;
+    name: string;
+    email: string;
+};
+export declare class UserResolver {
+    /**
+     * Resolve a user name or ID to a user ID by looking up collaborators across all shared projects.
+     * Supports exact name matches, partial matches, and email matches.
+     */
+    resolveUser(client: TodoistApi, nameOrId: string): Promise<ResolvedUser | null>;
+    /**
+     * Validate that a user is a collaborator on a specific project
+     */
+    validateProjectCollaborator(client: TodoistApi, projectId: string, userId: string): Promise<boolean>;
+    /**
+     * Get collaborators for a specific project
+     */
+    getProjectCollaborators(client: TodoistApi, projectId: string): Promise<ProjectCollaborator[]>;
+    /**
+     * Get all collaborators from all shared projects
+     */
+    private getAllCollaborators;
+    /**
+     * Clear all caches - useful for testing
+     */
+    clearCache(): void;
+}
+export declare const userResolver: UserResolver;
+export declare function resolveUserNameToId(client: TodoistApi, nameOrId: string): Promise<{
+    userId: string;
+    displayName: string;
+} | null>;
+//# sourceMappingURL=user-resolver.d.ts.map

package/dist/utils/user-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/user-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAA;AAE/D,MAAM,MAAM,YAAY,GAAG;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CAChB,CAAA;AAsBD,qBAAa,YAAY;IACrB;;;OAGG;IACG,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAoFrF;;OAEG;IACG,2BAA2B,CAC7B,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC;IASnB;;OAEG;IACG,uBAAuB,CACzB,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,mBAAmB,EAAE,CAAC;IA2BjC;;OAEG;YACW,mBAAmB;IAqDjC;;OAEG;IACH,UAAU,IAAI,IAAI;CAIrB;AAGD,eAAO,MAAM,YAAY,cAAqB,CAAA;AAG9C,wBAAsB,mBAAmB,CACrC,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAEzD"}

package/dist/utils/user-resolver.js

@@ -0,0 +1,179 @@
+// User resolution cache for performance with TTL
+const userResolutionCache = new Map();
+// Project collaborators cache
+const collaboratorsCache = new Map();
+const CACHE_TTL = 5 * 60 * 1000; // 5 minutes
+export class UserResolver {
+    /**
+     * Resolve a user name or ID to a user ID by looking up collaborators across all shared projects.
+     * Supports exact name matches, partial matches, and email matches.
+     */
+    async resolveUser(client, nameOrId) {
+        // Input validation
+        if (!nameOrId || nameOrId.trim().length === 0) {
+            return null;
+        }
+        const trimmedInput = nameOrId.trim();
+        // Check cache first
+        const cached = userResolutionCache.get(trimmedInput);
+        if (cached && Date.now() - cached.timestamp < CACHE_TTL) {
+            return cached.result;
+        }
+        // If it looks like a user ID already, return as-is
+        // Support numeric IDs and alphanumeric IDs but avoid obvious user names
+        if (/^[0-9]+$/.test(trimmedInput) ||
+            (/^[a-f0-9-]{8,}$/i.test(trimmedInput) && trimmedInput.includes('-')) ||
+            (/^[a-z0-9_]{6,}$/i.test(trimmedInput) &&
+                !/^[a-z]+[\s-]/.test(trimmedInput) &&
+                /[0-9_]/.test(trimmedInput))) {
+            const result = { userId: trimmedInput, displayName: trimmedInput };
+            userResolutionCache.set(trimmedInput, { result, timestamp: Date.now() });
+            return result;
+        }
+        try {
+            // Get all collaborators from shared projects
+            const allCollaborators = await this.getAllCollaborators(client);
+            if (allCollaborators.length === 0) {
+                const result = null; // No shared projects, can't resolve collaborators
+                userResolutionCache.set(trimmedInput, { result, timestamp: Date.now() });
+                return result;
+            }
+            const searchTerm = nameOrId.toLowerCase().trim();
+            // Try exact name match first
+            let match = allCollaborators.find((c) => c.name.toLowerCase() === searchTerm);
+            if (match) {
+                const result = { userId: match.id, displayName: match.name };
+                userResolutionCache.set(trimmedInput, { result, timestamp: Date.now() });
+                return result;
+            }
+            // Try exact email match
+            match = allCollaborators.find((c) => c.email.toLowerCase() === searchTerm);
+            if (match) {
+                const result = { userId: match.id, displayName: match.name };
+                userResolutionCache.set(trimmedInput, { result, timestamp: Date.now() });
+                return result;
+            }
+            // Try partial name match (contains)
+            match = allCollaborators.find((c) => c.name.toLowerCase().includes(searchTerm));
+            if (match) {
+                const result = { userId: match.id, displayName: match.name };
+                userResolutionCache.set(trimmedInput, { result, timestamp: Date.now() });
+                return result;
+            }
+            // Try partial email match
+            match = allCollaborators.find((c) => c.email.toLowerCase().includes(searchTerm));
+            if (match) {
+                const result = { userId: match.id, displayName: match.name };
+                userResolutionCache.set(trimmedInput, { result, timestamp: Date.now() });
+                return result;
+            }
+            // No match found
+            const result = null;
+            userResolutionCache.set(trimmedInput, { result, timestamp: Date.now() });
+            return result;
+        }
+        catch (_error) {
+            // If we can't fetch collaborators, return null instead of dangerous fallback
+            const result = null;
+            userResolutionCache.set(trimmedInput, { result, timestamp: Date.now() });
+            return result;
+        }
+    }
+    /**
+     * Validate that a user is a collaborator on a specific project
+     */
+    async validateProjectCollaborator(client, projectId, userId) {
+        try {
+            const collaborators = await this.getProjectCollaborators(client, projectId);
+            return collaborators.some((collaborator) => collaborator.id === userId);
+        }
+        catch (_error) {
+            return false;
+        }
+    }
+    /**
+     * Get collaborators for a specific project
+     */
+    async getProjectCollaborators(client, projectId) {
+        // Check cache first
+        const cacheKey = `project_${projectId}`;
+        const cached = collaboratorsCache.get(cacheKey);
+        if (cached && Date.now() - cached.timestamp < CACHE_TTL) {
+            return cached.result;
+        }
+        try {
+            const response = await client.getProjectCollaborators(projectId);
+            // API returns { results: [...], nextCursor: null } or just array
+            const collaborators = Array.isArray(response) ? response : response.results || [];
+            const validCollaborators = collaborators.filter((c) => c?.id && c.name && c.email);
+            collaboratorsCache.set(cacheKey, {
+                result: validCollaborators,
+                timestamp: Date.now(),
+            });
+            return validCollaborators;
+        }
+        catch (_error) {
+            // Return empty array on error, don't cache failed requests
+            return [];
+        }
+    }
+    /**
+     * Get all collaborators from all shared projects
+     */
+    async getAllCollaborators(client) {
+        // Check cache first
+        const cacheKey = 'all_collaborators';
+        const cached = collaboratorsCache.get(cacheKey);
+        if (cached && Date.now() - cached.timestamp < CACHE_TTL) {
+            return cached.result;
+        }
+        try {
+            // Get all projects to find shared ones
+            const { results: projects } = await client.getProjects({});
+            const sharedProjects = projects.filter((p) => p.isShared);
+            if (sharedProjects.length === 0) {
+                const result = [];
+                collaboratorsCache.set(cacheKey, { result, timestamp: Date.now() });
+                return result;
+            }
+            // Collect all collaborators from shared projects in parallel
+            const allCollaborators = [];
+            const seenIds = new Set();
+            const collaboratorPromises = sharedProjects.map((project) => this.getProjectCollaborators(client, project.id));
+            const collaboratorResults = await Promise.allSettled(collaboratorPromises);
+            for (const result of collaboratorResults) {
+                if (result.status === 'fulfilled') {
+                    for (const collaborator of result.value) {
+                        if (collaborator && !seenIds.has(collaborator.id)) {
+                            allCollaborators.push(collaborator);
+                            seenIds.add(collaborator.id);
+                        }
+                    }
+                }
+                // Skip failed projects, continue with others
+            }
+            collaboratorsCache.set(cacheKey, {
+                result: allCollaborators,
+                timestamp: Date.now(),
+            });
+            return allCollaborators;
+        }
+        catch (_error) {
+            // Return empty array on error, don't cache failed requests
+            return [];
+        }
+    }
+    /**
+     * Clear all caches - useful for testing
+     */
+    clearCache() {
+        userResolutionCache.clear();
+        collaboratorsCache.clear();
+    }
+}
+// Export singleton instance
+export const userResolver = new UserResolver();
+// Legacy function for backwards compatibility
+export async function resolveUserNameToId(client, nameOrId) {
+    return userResolver.resolveUser(client, nameOrId);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@doist/todoist-ai",
-    "version": "4.4.0",
+    "version": "4.5.1",
     "type": "module",
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",
@@ -51,20 +51,20 @@
         "zod": "^3.25.7"
     },
     "devDependencies": {
-        "@biomejs/biome": "1.9.4",
+        "@biomejs/biome": "2.2.4",
         "@types/express": "^5.0.2",
         "@types/jest": "30.0.0",
         "@types/morgan": "^1.9.9",
         "@types/node": "^22.15.17",
-        "concurrently": "^8.2.2",
-        "express": "^4.19.2",
+        "concurrently": "^9.0.0",
+        "express": "^5.0.0",
         "husky": "^9.1.7",
         "jest": "30.1.3",
         "lint-staged": "^16.0.0",
         "morgan": "^1.10.0",
         "nodemon": "^3.1.10",
         "rimraf": "^6.0.1",
-        "ts-jest": "29.4.1",
+        "ts-jest": "29.4.2",
         "typescript": "^5.8.3"
     },
     "lint-staged": {