@doist/todoist-ai 4.16.0 → 4.17.0

package/dist/tools/delete-object.js

@@ -1,79 +0,0 @@
-import { z } from 'zod';
-import { getToolOutput } from '../mcp-helpers.js';
-import { formatNextSteps } from '../utils/response-builders.js';
-import { ToolNames } from '../utils/tool-names.js';
-const { FIND_PROJECTS, GET_OVERVIEW, FIND_SECTIONS, FIND_TASKS, FIND_TASKS_BY_DATE, FIND_COMMENTS, } = ToolNames;
-const ArgsSchema = {
-    type: z
-        .enum(['project', 'section', 'task', 'comment'])
-        .describe('The type of entity to delete.'),
-    id: z.string().min(1).describe('The ID of the entity to delete.'),
-};
-const deleteObject = {
-    name: ToolNames.DELETE_OBJECT,
-    description: 'Delete a project, section, task, or comment by its ID.',
-    parameters: ArgsSchema,
-    async execute(args, client) {
-        switch (args.type) {
-            case 'project':
-                await client.deleteProject(args.id);
-                break;
-            case 'section':
-                await client.deleteSection(args.id);
-                break;
-            case 'task':
-                await client.deleteTask(args.id);
-                break;
-            case 'comment':
-                await client.deleteComment(args.id);
-                break;
-        }
-        const textContent = generateTextContent({
-            type: args.type,
-            id: args.id,
-        });
-        return getToolOutput({
-            textContent,
-            structuredContent: {
-                deletedEntity: {
-                    type: args.type,
-                    id: args.id,
-                },
-                success: true,
-            },
-        });
-    },
-};
-function generateTextContent({ type, id, }) {
-    const summary = `Deleted ${type}: id=${id}`;
-    // Recovery-focused next steps based on what was deleted
-    const nextSteps = [];
-    switch (type) {
-        case 'project':
-            // Help user understand impact and navigate remaining work
-            nextSteps.push(`Use ${FIND_PROJECTS} to see remaining projects`);
-            nextSteps.push('Note: All tasks and sections in this project were also deleted');
-            nextSteps.push(`Use ${GET_OVERVIEW} to review your updated project structure`);
-            break;
-        case 'section':
-            // Guide user to reorganize remaining sections and tasks
-            nextSteps.push(`Use ${FIND_SECTIONS} to see remaining sections in the project`);
-            nextSteps.push('Note: Tasks in this section were also deleted');
-            nextSteps.push(`Use ${FIND_TASKS} with projectId to see unorganized tasks`);
-            break;
-        case 'task':
-            // Help user stay focused on remaining work
-            nextSteps.push(`Use ${FIND_TASKS_BY_DATE} to see remaining tasks for today`);
-            nextSteps.push(`Use ${GET_OVERVIEW} to check if this affects any dependent tasks`);
-            nextSteps.push('Note: Any subtasks of this task were also deleted');
-            break;
-        case 'comment':
-            // Help user understand comment deletion impact
-            nextSteps.push(`Use ${FIND_COMMENTS} to see remaining comments on the task/project`);
-            nextSteps.push('Note: Comment attachments were also deleted');
-            break;
-    }
-    const next = formatNextSteps(nextSteps);
-    return `${summary}\n${next}`;
-}
-export { deleteObject };

package/dist/tools/fetch.js

@@ -1,102 +0,0 @@
-import { getProjectUrl, getTaskUrl } from '@doist/todoist-api-typescript';
-import { z } from 'zod';
-import { getErrorOutput } from '../mcp-helpers.js';
-import { mapProject, mapTask } from '../tool-helpers.js';
-import { ToolNames } from '../utils/tool-names.js';
-const ArgsSchema = {
-    id: z
-        .string()
-        .min(1)
-        .describe('A unique identifier for the document in the format "task:{id}" or "project:{id}".'),
-};
-/**
- * OpenAI MCP fetch tool - retrieves the full contents of a task or project by ID.
- *
- * This tool follows the OpenAI MCP fetch tool specification:
- * @see https://platform.openai.com/docs/mcp#fetch-tool
- */
-const fetch = {
-    name: ToolNames.FETCH,
-    description: 'Fetch the full contents of a task or project by its ID. The ID should be in the format "task:{id}" or "project:{id}".',
-    parameters: ArgsSchema,
-    async execute(args, client) {
-        try {
-            const { id } = args;
-            // Parse the composite ID
-            const [type, objectId] = id.split(':', 2);
-            if (!objectId || (type !== 'task' && type !== 'project')) {
-                throw new Error('Invalid ID format. Expected "task:{id}" or "project:{id}". Example: "task:8485093748" or "project:6cfCcrrCFg2xP94Q"');
-            }
-            let result;
-            if (type === 'task') {
-                // Fetch task
-                const task = await client.getTask(objectId);
-                const mappedTask = mapTask(task);
-                // Build text content
-                const textParts = [mappedTask.content];
-                if (mappedTask.description) {
-                    textParts.push(`\n\nDescription: ${mappedTask.description}`);
-                }
-                if (mappedTask.dueDate) {
-                    textParts.push(`\nDue: ${mappedTask.dueDate}`);
-                }
-                if (mappedTask.labels.length > 0) {
-                    textParts.push(`\nLabels: ${mappedTask.labels.join(', ')}`);
-                }
-                result = {
-                    id: `task:${mappedTask.id}`,
-                    title: mappedTask.content,
-                    text: textParts.join(''),
-                    url: getTaskUrl(mappedTask.id),
-                    metadata: {
-                        priority: mappedTask.priority,
-                        projectId: mappedTask.projectId,
-                        sectionId: mappedTask.sectionId,
-                        parentId: mappedTask.parentId,
-                        recurring: mappedTask.recurring,
-                        duration: mappedTask.duration,
-                        responsibleUid: mappedTask.responsibleUid,
-                        assignedByUid: mappedTask.assignedByUid,
-                        checked: mappedTask.checked,
-                        completedAt: mappedTask.completedAt,
-                    },
-                };
-            }
-            else {
-                // Fetch project
-                const project = await client.getProject(objectId);
-                const mappedProject = mapProject(project);
-                // Build text content
-                const textParts = [mappedProject.name];
-                if (mappedProject.isShared) {
-                    textParts.push('\n\nShared project');
-                }
-                if (mappedProject.isFavorite) {
-                    textParts.push('\nFavorite: Yes');
-                }
-                result = {
-                    id: `project:${mappedProject.id}`,
-                    title: mappedProject.name,
-                    text: textParts.join(''),
-                    url: getProjectUrl(mappedProject.id),
-                    metadata: {
-                        color: mappedProject.color,
-                        isFavorite: mappedProject.isFavorite,
-                        isShared: mappedProject.isShared,
-                        parentId: mappedProject.parentId,
-                        inboxProject: mappedProject.inboxProject,
-                        viewStyle: mappedProject.viewStyle,
-                    },
-                };
-            }
-            // Return as JSON-encoded string in a text content item (OpenAI MCP spec)
-            const jsonText = JSON.stringify(result);
-            return { content: [{ type: 'text', text: jsonText }] };
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : 'An unknown error occurred';
-            return getErrorOutput(message);
-        }
-    },
-};
-export { fetch };

package/dist/tools/find-activity.js

@@ -1,221 +0,0 @@
-import { z } from 'zod';
-import { getToolOutput } from '../mcp-helpers.js';
-import { mapActivityEvent } from '../tool-helpers.js';
-import { ApiLimits } from '../utils/constants.js';
-import { summarizeList } from '../utils/response-builders.js';
-import { ToolNames } from '../utils/tool-names.js';
-const { FIND_TASKS, USER_INFO } = ToolNames;
-const ArgsSchema = {
-    objectType: z
-        .enum(['task', 'project', 'comment'])
-        .optional()
-        .describe('Type of object to filter by.'),
-    objectId: z
-        .string()
-        .optional()
-        .describe('Filter by specific object ID (task, project, or comment).'),
-    eventType: z
-        .enum([
-        'added',
-        'updated',
-        'deleted',
-        'completed',
-        'uncompleted',
-        'archived',
-        'unarchived',
-        'shared',
-        'left',
-    ])
-        .optional()
-        .describe('Type of event to filter by.'),
-    projectId: z.string().optional().describe('Filter events by parent project ID.'),
-    taskId: z.string().optional().describe('Filter events by parent task ID (for subtask events).'),
-    initiatorId: z.string().optional().describe('Filter by the user ID who initiated the event.'),
-    limit: z
-        .number()
-        .int()
-        .min(1)
-        .max(ApiLimits.ACTIVITY_MAX)
-        .default(ApiLimits.ACTIVITY_DEFAULT)
-        .describe('Maximum number of activity events to return.'),
-    cursor: z
-        .string()
-        .optional()
-        .describe('Pagination cursor for retrieving the next page of results.'),
-};
-const findActivity = {
-    name: ToolNames.FIND_ACTIVITY,
-    description: 'Retrieve recent activity logs to monitor and audit changes in Todoist. Shows events from all users by default (use initiatorId to filter by specific user). Track task completions, updates, deletions, project changes, and more with flexible filtering. Note: Date-based filtering is not supported by the Todoist API.',
-    parameters: ArgsSchema,
-    async execute(args, client) {
-        const { objectType, objectId, eventType, projectId, taskId, initiatorId, limit, cursor } = args;
-        // Build API arguments
-        const apiArgs = {
-            limit,
-            cursor: cursor ?? null,
-        };
-        // Add optional filters
-        if (objectType)
-            apiArgs.objectType = objectType;
-        if (objectId && objectId !== 'remove')
-            apiArgs.objectId = objectId;
-        if (eventType)
-            apiArgs.eventType = eventType;
-        if (projectId)
-            apiArgs.parentProjectId = projectId;
-        if (taskId)
-            apiArgs.parentItemId = taskId;
-        if (initiatorId)
-            apiArgs.initiatorId = initiatorId;
-        // Fetch activity logs from API
-        const { results, nextCursor } = await client.getActivityLogs(apiArgs);
-        const events = results.map(mapActivityEvent);
-        // Generate text content
-        const textContent = generateTextContent({
-            events,
-            args,
-            nextCursor,
-        });
-        return getToolOutput({
-            textContent,
-            structuredContent: {
-                events,
-                nextCursor,
-                totalCount: events.length,
-                hasMore: Boolean(nextCursor),
-                appliedFilters: args,
-            },
-        });
-    },
-};
-function generateTextContent({ events, args, nextCursor, }) {
-    // Generate subject description
-    let subject = 'Activity events';
-    // Build subject based on filters
-    const subjectParts = [];
-    if (args.eventType) {
-        subjectParts.push(`${args.eventType}`);
-    }
-    if (args.objectType) {
-        const objectLabel = args.objectType === 'task' ? 'tasks' : `${args.objectType}s`;
-        subjectParts.push(objectLabel);
-    }
-    if (subjectParts.length > 0) {
-        subject = `Activity: ${subjectParts.join(' ')}`;
-    }
-    // Generate filter hints
-    const filterHints = [];
-    if (args.objectId) {
-        filterHints.push(`object ID: ${args.objectId}`);
-    }
-    if (args.projectId) {
-        filterHints.push(`project: ${args.projectId}`);
-    }
-    if (args.taskId) {
-        filterHints.push(`task: ${args.taskId}`);
-    }
-    if (args.initiatorId) {
-        filterHints.push(`initiator: ${args.initiatorId}`);
-    }
-    // Generate helpful suggestions for empty results
-    const zeroReasonHints = [];
-    if (events.length === 0) {
-        zeroReasonHints.push('No activity events match the specified filters');
-        zeroReasonHints.push('Note: Activity logs only show recent events');
-        if (args.eventType) {
-            zeroReasonHints.push(`Try removing the eventType filter (${args.eventType})`);
-        }
-        if (args.objectType) {
-            zeroReasonHints.push(`Try removing the objectType filter (${args.objectType})`);
-        }
-        if (args.objectId || args.projectId || args.taskId) {
-            zeroReasonHints.push('Verify the object ID is correct');
-        }
-    }
-    // Generate contextual next steps
-    const nextSteps = [];
-    if (events.length > 0) {
-        // Suggest related tools based on what was found
-        const hasTaskEvents = events.some((e) => e.objectType === 'task' || e.objectType === 'item');
-        const hasCompletions = events.some((e) => e.eventType === 'completed');
-        if (hasTaskEvents) {
-            nextSteps.push(`Use ${FIND_TASKS} to view current task details`);
-        }
-        if (hasCompletions) {
-            nextSteps.push('Review completed tasks to track productivity');
-        }
-        if (args.initiatorId) {
-            nextSteps.push(`Use ${USER_INFO} to get details about the user`);
-        }
-        // Suggest narrowing down if too many results
-        if (events.length >= args.limit && !nextCursor) {
-            nextSteps.push('Add more specific filters to narrow down results');
-        }
-    }
-    return summarizeList({
-        subject,
-        count: events.length,
-        limit: args.limit,
-        nextCursor: nextCursor ?? undefined,
-        filterHints,
-        previewLines: previewActivityEvents(events, Math.min(events.length, args.limit)),
-        zeroReasonHints,
-        nextSteps,
-    });
-}
-/**
- * Formats activity events into readable preview lines
- */
-function previewActivityEvents(events, limit = 10) {
-    const previewEvents = events.slice(0, limit);
-    const lines = previewEvents.map(formatActivityEventPreview).join('\n');
-    // If we're showing fewer events than the total, add an indicator
-    if (events.length > limit) {
-        const remaining = events.length - limit;
-        return `${lines}\n    ... and ${remaining} more event${remaining === 1 ? '' : 's'}`;
-    }
-    return lines;
-}
-/**
- * Formats a single activity event into a readable preview line
- */
-function formatActivityEventPreview(event) {
-    const date = formatEventDate(event.eventDate);
-    const eventLabel = `${event.eventType} ${event.objectType}`;
-    // Extract useful content from extraData if available
-    let contentInfo = '';
-    if (event.extraData) {
-        const content = event.extraData.content || event.extraData.name || event.extraData.last_content;
-        if (content && typeof content === 'string') {
-            // Truncate long content
-            const truncated = content.length > 50 ? `${content.substring(0, 47)}...` : content;
-            contentInfo = ` • "${truncated}"`;
-        }
-    }
-    const objectId = event.objectId ? ` • id=${event.objectId}` : '';
-    const initiator = event.initiatorId ? ` • by=${event.initiatorId}` : ' • system';
-    const projectInfo = event.parentProjectId ? ` • project=${event.parentProjectId}` : '';
-    return `    [${date}] ${eventLabel}${contentInfo}${objectId}${initiator}${projectInfo}`;
-}
-/**
- * Formats an ISO date string to a more readable format
- */
-function formatEventDate(isoDate) {
-    try {
-        const date = new Date(isoDate);
-        // Format as: Oct 23, 14:30 (in UTC for deterministic snapshots)
-        const month = date.toLocaleDateString('en-US', { month: 'short', timeZone: 'UTC' });
-        const day = date.toLocaleDateString('en-US', { day: 'numeric', timeZone: 'UTC' });
-        const time = date.toLocaleTimeString('en-US', {
-            hour: '2-digit',
-            minute: '2-digit',
-            hour12: false,
-            timeZone: 'UTC',
-        });
-        return `${month} ${day}, ${time}`;
-    }
-    catch {
-        return isoDate;
-    }
-}
-export { findActivity };

package/dist/tools/find-comments.js

@@ -1,148 +0,0 @@
-import { z } from 'zod';
-import { getToolOutput } from '../mcp-helpers.js';
-import { ApiLimits } from '../utils/constants.js';
-import { formatNextSteps } from '../utils/response-builders.js';
-import { ToolNames } from '../utils/tool-names.js';
-const { ADD_COMMENTS, UPDATE_COMMENTS, DELETE_OBJECT } = ToolNames;
-const ArgsSchema = {
-    taskId: z.string().optional().describe('Find comments for a specific task.'),
-    projectId: z
-        .string()
-        .optional()
-        .describe('Find comments for a specific project. Project ID should be an ID string, or the text "inbox", for inbox tasks.'),
-    commentId: z.string().optional().describe('Get a specific comment by ID.'),
-    cursor: z.string().optional().describe('Pagination cursor for retrieving more results.'),
-    limit: z
-        .number()
-        .int()
-        .min(1)
-        .max(ApiLimits.COMMENTS_MAX)
-        .optional()
-        .describe('Maximum number of comments to return'),
-};
-const findComments = {
-    name: ToolNames.FIND_COMMENTS,
-    description: 'Find comments by task, project, or get a specific comment by ID. Exactly one of taskId, projectId, or commentId must be provided.',
-    parameters: ArgsSchema,
-    async execute(args, client) {
-        // Validate that exactly one search parameter is provided
-        const searchParams = [args.taskId, args.projectId, args.commentId].filter(Boolean);
-        if (searchParams.length === 0) {
-            throw new Error('Must provide exactly one of: taskId, projectId, or commentId.');
-        }
-        if (searchParams.length > 1) {
-            throw new Error('Cannot provide multiple search parameters. Choose one of: taskId, projectId, or commentId.');
-        }
-        // Resolve "inbox" to actual inbox project ID if needed
-        const resolvedProjectId = args.projectId === 'inbox' ? (await client.getUser()).inboxProjectId : args.projectId;
-        let comments;
-        let hasMore = false;
-        let nextCursor = null;
-        if (args.commentId) {
-            // Get single comment
-            const comment = await client.getComment(args.commentId);
-            comments = [comment];
-        }
-        else if (args.taskId) {
-            // Get comments by task
-            const response = await client.getComments({
-                taskId: args.taskId,
-                cursor: args.cursor || null,
-                limit: args.limit || ApiLimits.COMMENTS_DEFAULT,
-            });
-            comments = response.results;
-            hasMore = response.nextCursor !== null;
-            nextCursor = response.nextCursor;
-        }
-        else if (resolvedProjectId) {
-            // Get comments by project
-            const response = await client.getComments({
-                projectId: resolvedProjectId,
-                cursor: args.cursor || null,
-                limit: args.limit || ApiLimits.COMMENTS_DEFAULT,
-            });
-            comments = response.results;
-            hasMore = response.nextCursor !== null;
-            nextCursor = response.nextCursor;
-        }
-        else {
-            // This should never happen due to validation, but TypeScript needs it
-            throw new Error('Invalid state: no search parameter provided');
-        }
-        const textContent = generateTextContent({
-            comments,
-            searchType: args.commentId ? 'single' : args.taskId ? 'task' : 'project',
-            searchId: args.commentId || args.taskId || args.projectId || '',
-            hasMore,
-            nextCursor,
-        });
-        return getToolOutput({
-            textContent,
-            structuredContent: {
-                comments,
-                searchType: args.commentId ? 'single' : args.taskId ? 'task' : 'project',
-                searchId: args.commentId || args.taskId || args.projectId || '',
-                hasMore,
-                nextCursor,
-                totalCount: comments.length,
-            },
-        });
-    },
-};
-function generateTextContent({ comments, searchType, searchId, hasMore, nextCursor, }) {
-    if (comments.length === 0) {
-        return `No comments found for ${searchType}${searchType !== 'single' ? ` ${searchId}` : ''}`;
-    }
-    // Build summary
-    let summary;
-    if (searchType === 'single') {
-        const comment = comments[0];
-        if (!comment) {
-            return 'Comment not found';
-        }
-        const hasAttachment = comment.fileAttachment !== null;
-        const attachmentInfo = hasAttachment
-            ? ` • Has attachment: ${comment.fileAttachment?.fileName || 'file'}`
-            : '';
-        summary = `Found comment${attachmentInfo} • id=${comment.id}`;
-    }
-    else {
-        const attachmentCount = comments.filter((c) => c.fileAttachment !== null).length;
-        const attachmentInfo = attachmentCount > 0 ? ` (${attachmentCount} with attachments)` : '';
-        const commentsLabel = comments.length === 1 ? 'comment' : 'comments';
-        summary = `Found ${comments.length} ${commentsLabel} for ${searchType} ${searchId}${attachmentInfo}`;
-        if (hasMore) {
-            summary += ' • More available';
-        }
-    }
-    // Context-aware next steps
-    const nextSteps = [];
-    if (searchType === 'single') {
-        const comment = comments[0];
-        if (comment) {
-            nextSteps.push(`Use ${UPDATE_COMMENTS} with id=${comment.id} to edit content`);
-            nextSteps.push(`Use ${DELETE_OBJECT} with type=comment id=${comment.id} to remove`);
-            // Suggest viewing related comments
-            if (comment.taskId) {
-                nextSteps.push(`Use ${ToolNames.FIND_COMMENTS} with taskId=${comment.taskId} to see all task comments`);
-            }
-            else if (comment.projectId) {
-                nextSteps.push(`Use ${ToolNames.FIND_COMMENTS} with projectId=${comment.projectId} to see all project comments`);
-            }
-        }
-    }
-    else {
-        // Multiple comments
-        nextSteps.push(`Use ${ADD_COMMENTS} with ${searchType}Id=${searchId} to add new comment`);
-        if (comments.length > 0) {
-            nextSteps.push(`Use ${ToolNames.FIND_COMMENTS} with commentId to view specific comment details`);
-        }
-        // Pagination
-        if (hasMore && nextCursor) {
-            nextSteps.push(`Use ${ToolNames.FIND_COMMENTS} with cursor="${nextCursor}" to get more results`);
-        }
-    }
-    const next = formatNextSteps(nextSteps);
-    return `${summary}\n${next}`;
-}
-export { findComments };