@doist/todoist-ai 4.1.0 → 4.5.1

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;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

@@ -50,6 +50,7 @@ export function createMockSection(overrides = {}) {
         isDeleted: false,
         isCollapsed: false,
         name: 'Test Section',
+        url: 'https://todoist.com/sections/section-123',
         ...overrides,
     };
 }
@@ -106,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,8 +21,11 @@ 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";
 };
 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;;;;;;;;;;;;;;;;;;;;;CAgCZ,CAAA;AAGV,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAA"}

package/dist/utils/tool-names.js

@@ -25,7 +25,11 @@ 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',
+    USER_INFO: 'user-info',
 };

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.1.0",
+    "version": "4.5.1",
     "type": "module",
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",
@@ -44,27 +44,27 @@
         "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",
         "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.0.5",
+        "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": {