@doist/todoist-ai 4.1.0 → 4.5.1

package/dist/tools/find-tasks.js

@@ -2,14 +2,20 @@ import { z } from 'zod';
 import { getToolOutput } from '../mcp-helpers.js';
 import { getTasksByFilter, mapTask } from '../tool-helpers.js';
 import { ApiLimits } from '../utils/constants.js';
+import { generateLabelsFilter, LabelsSchema } from '../utils/labels.js';
 import { generateTaskNextSteps, getDateString, previewTasks, summarizeList, } from '../utils/response-builders.js';
 import { ToolNames } from '../utils/tool-names.js';
+import { resolveUserNameToId } from '../utils/user-resolver.js';
 const { FIND_COMPLETED_TASKS, ADD_TASKS } = ToolNames;
 const ArgsSchema = {
     searchText: z.string().optional().describe('The text to search for in tasks.'),
     projectId: z.string().optional().describe('Find tasks in this project.'),
     sectionId: z.string().optional().describe('Find tasks in this section.'),
     parentId: z.string().optional().describe('Find subtasks of this parent task.'),
+    responsibleUser: z
+        .string()
+        .optional()
+        .describe('Find tasks assigned to this user. Can be a user ID, name, or email address.'),
     limit: z
         .number()
         .int()
@@ -21,16 +27,36 @@ 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.',
+    description: 'Find tasks by text search, or by project/section/parent container/responsible user. 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, responsibleUser, 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 &&
+            !responsibleUser &&
+            !hasLabels) {
+            throw new Error('At least one filter must be provided: searchText, projectId, sectionId, parentId, responsibleUser, or labels');
+        }
+        // Resolve assignee name to user ID if provided
+        let resolvedAssigneeId = responsibleUser;
+        let assigneeDisplayName;
+        if (responsibleUser) {
+            const resolved = await resolveUserNameToId(client, responsibleUser);
+            if (resolved) {
+                resolvedAssigneeId = resolved.userId;
+                assigneeDisplayName = resolved.displayName;
+            }
+            else {
+                throw new Error(`Could not find user: "${responsibleUser}". Make sure the user is a collaborator on a shared project.`);
+            }
         }
         // If using container-based filtering, use direct API
         if (projectId || sectionId || parentId) {
@@ -46,47 +72,108 @@ const findTasks = {
                 taskParams.parentId = parentId;
             const { results, nextCursor } = await client.getTasks(taskParams);
             const mappedTasks = results.map(mapTask);
-            // If also has searchText, filter the results
-            const finalTasks = searchText
+            // Apply search text filter
+            let filteredTasks = searchText
                 ? mappedTasks.filter((task) => task.content.toLowerCase().includes(searchText.toLowerCase()) ||
                     task.description?.toLowerCase().includes(searchText.toLowerCase()))
                 : mappedTasks;
+            // Apply responsibleUid filter
+            if (resolvedAssigneeId) {
+                filteredTasks = filteredTasks.filter((task) => task.responsibleUid === resolvedAssigneeId);
+            }
+            // Apply label filter
+            if (labels && labels.length > 0) {
+                filteredTasks =
+                    labelsOperator === 'and'
+                        ? filteredTasks.filter((task) => labels.every((label) => task.labels.includes(label)))
+                        : filteredTasks.filter((task) => labels.some((label) => task.labels.includes(label)));
+            }
             const textContent = generateTextContent({
-                tasks: finalTasks,
+                tasks: filteredTasks,
                 args,
                 nextCursor,
                 isContainerSearch: true,
+                assigneeDisplayName,
             });
             return getToolOutput({
                 textContent,
                 structuredContent: {
-                    tasks: finalTasks,
+                    tasks: filteredTasks,
                     nextCursor,
-                    totalCount: finalTasks.length,
+                    totalCount: filteredTasks.length,
                     hasMore: Boolean(nextCursor),
                     appliedFilters: args,
                 },
             });
         }
-        // Text-only search using filter query
+        // If only responsibleUid is provided (without containers), use assignee filter
+        if (resolvedAssigneeId && !searchText && !hasLabels) {
+            const tasks = await client.getTasksByFilter({
+                query: `assigned to: ${assigneeDisplayName}`,
+                lang: 'en',
+                limit,
+                cursor: cursor ?? null,
+            });
+            const mappedTasks = tasks.results.map(mapTask);
+            const textContent = generateTextContent({
+                tasks: mappedTasks,
+                args,
+                nextCursor: tasks.nextCursor,
+                isContainerSearch: false,
+                assigneeDisplayName,
+            });
+            return getToolOutput({
+                textContent,
+                structuredContent: {
+                    tasks: mappedTasks,
+                    nextCursor: tasks.nextCursor,
+                    totalCount: mappedTasks.length,
+                    hasMore: Boolean(tasks.nextCursor),
+                    appliedFilters: args,
+                },
+            });
+        }
+        // Handle search text and/or labels using filter query (responsibleUid filtering done client-side)
+        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,
         });
+        // Always filter by responsibleUid client-side (API doesn't reliably support responsibleUid filtering)
+        let tasks = result.tasks;
+        if (resolvedAssigneeId) {
+            tasks = result.tasks.filter((task) => task.responsibleUid === resolvedAssigneeId);
+        }
         const textContent = generateTextContent({
-            tasks: result.tasks,
+            tasks,
             args,
             nextCursor: result.nextCursor,
             isContainerSearch: false,
+            assigneeDisplayName,
         });
         return getToolOutput({
             textContent,
             structuredContent: {
-                tasks: result.tasks,
+                tasks,
                 nextCursor: result.nextCursor,
-                totalCount: result.tasks.length,
+                totalCount: tasks.length,
                 hasMore: Boolean(result.nextCursor),
                 appliedFilters: args,
             },
@@ -119,9 +206,9 @@ function getContainerZeroReasonHints(args) {
     }
     return [];
 }
-function generateTextContent({ tasks, args, nextCursor, isContainerSearch, }) {
+function generateTextContent({ tasks, args, nextCursor, isContainerSearch, assigneeDisplayName, }) {
     // Generate subject and filter descriptions based on search type
-    let subject;
+    let subject = 'Tasks';
     const filterHints = [];
     const zeroReasonHints = [];
     if (isContainerSearch) {
@@ -146,19 +233,81 @@ function generateTextContent({ tasks, args, nextCursor, isContainerSearch, }) {
             subject += ` matching "${args.searchText}"`;
             filterHints.push(`containing "${args.searchText}"`);
         }
+        // Add responsibleUid filter if present
+        if (args.responsibleUser) {
+            const displayName = assigneeDisplayName || args.responsibleUser;
+            subject += ` assigned to ${displayName}`;
+            filterHints.push(`assigned to ${displayName}`);
+        }
+        // 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, responsibleUid, or labels search
+        const displayName = assigneeDisplayName || args.responsibleUser;
+        // Build subject based on filters
+        const subjectParts = [];
+        if (args.searchText) {
+            subjectParts.push(`"${args.searchText}"`);
+        }
+        if (args.responsibleUser) {
+            subjectParts.push(`assigned to ${displayName}`);
+        }
+        if (args.labels && args.labels.length > 0) {
+            const labelText = args.labels
+                .map((label) => `@${label}`)
+                .join(args.labelsOperator === 'and' ? ' & ' : ' | ');
+            subjectParts.push(`with labels: ${labelText}`);
+        }
+        if (args.searchText) {
+            subject = `Search results for ${subjectParts.join(' ')}`;
+            filterHints.push(`matching "${args.searchText}"`);
+        }
+        else if (args.responsibleUser && (!args.labels || args.labels.length === 0)) {
+            subject = `Tasks assigned to ${displayName}`;
+        }
+        else if (args.labels && args.labels.length > 0 && !args.responsibleUser) {
+            const labelText = args.labels
+                .map((label) => `@${label}`)
+                .join(args.labelsOperator === 'and' ? ' & ' : ' | ');
+            subject = `Tasks with labels: ${labelText}`;
+        }
+        else {
+            subject = `Tasks ${subjectParts.join(' ')}`;
+        }
+        // Add filter hints
+        if (args.responsibleUser) {
+            filterHints.push(`assigned to ${displayName}`);
+        }
+        if (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}`);
-            zeroReasonHints.push('Verify spelling and try partial words');
+            if (args.responsibleUser) {
+                const displayName = assigneeDisplayName || args.responsibleUser;
+                zeroReasonHints.push(`No tasks assigned to ${displayName}`);
+                zeroReasonHints.push('Check if the user name is correct');
+                zeroReasonHints.push(`Check completed tasks with ${FIND_COMPLETED_TASKS}`);
+            }
+            if (args.searchText) {
+                zeroReasonHints.push('Try broader search terms');
+                zeroReasonHints.push('Verify spelling and try partial words');
+                if (!args.responsibleUser) {
+                    zeroReasonHints.push(`Check completed tasks with ${FIND_COMPLETED_TASKS}`);
+                }
+            }
         }
     }
     // Generate contextual next steps
@@ -174,7 +323,7 @@ function generateTextContent({ tasks, args, nextCursor, isContainerSearch, }) {
         limit: args.limit,
         nextCursor: nextCursor ?? undefined,
         filterHints,
-        previewLines: previewTasks(tasks),
+        previewLines: previewTasks(tasks, Math.min(tasks.length, args.limit)),
         zeroReasonHints,
         nextSteps,
     });

package/dist/tools/get-overview.d.ts

@@ -20,7 +20,7 @@ type AccountOverviewStructured = Record<string, unknown> & {
     totalSections: number;
     hasNestedProjects: boolean;
 };
-interface ProjectOverviewStructured extends Record<string, unknown> {
+type ProjectOverviewStructured = Record<string, unknown> & {
     type: 'project_overview';
     project: {
         id: string;
@@ -35,7 +35,7 @@ interface ProjectOverviewStructured extends Record<string, unknown> {
         totalSections: number;
         tasksWithoutSection: number;
     };
-}
+};
 declare const getOverview: {
     name: "get-overview";
     description: string;

package/dist/tools/get-overview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-overview.d.ts","sourceRoot":"","sources":["../../src/tools/get-overview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAA;AACxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAmC,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAgI7E,KAAK,gBAAgB,GAAG;IACpB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,QAAQ,EAAE,gBAAgB,EAAE,CAAA;CAC/B,CAAA;AAED,KAAK,yBAAyB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACvD,IAAI,EAAE,kBAAkB,CAAA;IACxB,KAAK,EAAE;QACH,EAAE,EAAE,MAAM,CAAA;QACV,IAAI,EAAE,MAAM,CAAA;QACZ,QAAQ,EAAE,OAAO,EAAE,CAAA;KACtB,GAAG,IAAI,CAAA;IACR,QAAQ,EAAE,gBAAgB,EAAE,CAAA;IAC5B,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,iBAAiB,EAAE,OAAO,CAAA;CAC7B,CAAA;AAED,UAAU,yBAA0B,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC/D,IAAI,EAAE,kBAAkB,CAAA;IACxB,OAAO,EAAE;QACL,EAAE,EAAE,MAAM,CAAA;QACV,IAAI,EAAE,MAAM,CAAA;KACf,CAAA;IACD,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,OAAO,OAAO,CAAC,GAAG;QAAE,QAAQ,EAAE,KAAK,EAAE,CAAA;KAAE,CAAC,CAAA;IAChE,KAAK,EAAE;QACH,UAAU,EAAE,MAAM,CAAA;QAClB,aAAa,EAAE,MAAM,CAAA;QACrB,mBAAmB,EAAE,MAAM,CAAA;KAC9B,CAAA;CACJ;AA6JD,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;CAeyB,CAAA;AAE1C,OAAO,EAAE,WAAW,EAAE,KAAK,yBAAyB,EAAE,KAAK,yBAAyB,EAAE,CAAA"}
+{"version":3,"file":"get-overview.d.ts","sourceRoot":"","sources":["../../src/tools/get-overview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAA;AACxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAqB,OAAO,EAAgB,MAAM,oBAAoB,CAAA;AAgI7E,KAAK,gBAAgB,GAAG;IACpB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,QAAQ,EAAE,gBAAgB,EAAE,CAAA;CAC/B,CAAA;AAED,KAAK,yBAAyB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACvD,IAAI,EAAE,kBAAkB,CAAA;IACxB,KAAK,EAAE;QACH,EAAE,EAAE,MAAM,CAAA;QACV,IAAI,EAAE,MAAM,CAAA;QACZ,QAAQ,EAAE,OAAO,EAAE,CAAA;KACtB,GAAG,IAAI,CAAA;IACR,QAAQ,EAAE,gBAAgB,EAAE,CAAA;IAC5B,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,iBAAiB,EAAE,OAAO,CAAA;CAC7B,CAAA;AAED,KAAK,yBAAyB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACvD,IAAI,EAAE,kBAAkB,CAAA;IACxB,OAAO,EAAE;QACL,EAAE,EAAE,MAAM,CAAA;QACV,IAAI,EAAE,MAAM,CAAA;KACf,CAAA;IACD,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,OAAO,OAAO,CAAC,GAAG;QAAE,QAAQ,EAAE,KAAK,EAAE,CAAA;KAAE,CAAC,CAAA;IAChE,KAAK,EAAE;QACH,UAAU,EAAE,MAAM,CAAA;QAClB,aAAa,EAAE,MAAM,CAAA;QACrB,mBAAmB,EAAE,MAAM,CAAA;KAC9B,CAAA;CACJ,CAAA;AA6JD,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;CAeyB,CAAA;AAE1C,OAAO,EAAE,WAAW,EAAE,KAAK,yBAAyB,EAAE,KAAK,yBAAyB,EAAE,CAAA"}

package/dist/tools/get-overview.js

@@ -115,7 +115,7 @@ function buildProjectStructure(project, sectionsByProject) {
 }
 async function getAllTasksForProject(client, projectId) {
     let allTasks = [];
-    let cursor = undefined;
+    let cursor;
     do {
         const { results, nextCursor } = await client.getTasks({
             projectId,

package/dist/tools/manage-assignments.d.ts

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+export type OperationResult = {
+    taskId: string;
+    success: boolean;
+    error?: string;
+    originalAssigneeId?: string | null;
+    newAssigneeId?: string | null;
+};
+declare const manageAssignments: {
+    name: "manage-assignments";
+    description: string;
+    parameters: {
+        operation: z.ZodEnum<["assign", "unassign", "reassign"]>;
+        taskIds: z.ZodArray<z.ZodString, "many">;
+        responsibleUser: z.ZodOptional<z.ZodString>;
+        fromAssigneeUser: z.ZodOptional<z.ZodString>;
+        dryRun: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    };
+    execute(args: {
+        operation: "assign" | "unassign" | "reassign";
+        taskIds: string[];
+        dryRun: boolean;
+        responsibleUser?: string | undefined;
+        fromAssigneeUser?: string | undefined;
+    }, client: import("@doist/todoist-api-typescript").TodoistApi): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        structuredContent: {
+            operation: "assign" | "unassign" | "reassign";
+            results: OperationResult[];
+            totalRequested: number;
+            successful: number;
+            failed: number;
+            dryRun: boolean;
+        };
+    } | {
+        content: ({
+            type: "text";
+            text: string;
+            mimeType?: undefined;
+        } | {
+            type: "text";
+            mimeType: string;
+            text: string;
+        })[];
+        structuredContent?: undefined;
+    }>;
+};
+export { manageAssignments };
+//# sourceMappingURL=manage-assignments.d.ts.map

package/dist/tools/manage-assignments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manage-assignments.d.ts","sourceRoot":"","sources":["../../src/tools/manage-assignments.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA4CvB,MAAM,MAAM,eAAe,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAChC,CAAA;AAED,QAAA,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoRmB,CAAA;AAuF1C,OAAO,EAAE,iBAAiB,EAAE,CAAA"}