@doist/todoist-ai 4.15.1 → 4.16.1

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@doist/todoist-ai",
-    "version": "4.15.1",
+    "version": "4.16.1",
     "type": "module",
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",
@@ -27,11 +27,13 @@
         "tools"
     ],
     "scripts": {
-        "test": "jest",
-        "build": "rimraf dist && npx tsc --project tsconfig.json",
+        "test": "vitest run",
+        "test:watch": "vitest",
+        "test:coverage": "vitest run --coverage",
+        "build": "vite build",
         "postbuild": "chmod +x dist/main.js",
         "start": "npm run build && npx @modelcontextprotocol/inspector node dist/main.js",
-        "dev": "concurrently \"npx tsc --watch\" \"npx @modelcontextprotocol/inspector npx nodemon --quiet --watch dist --ext js --exec node dist/main.js\"",
+        "dev": "concurrently \"vite build --watch\" \"npx @modelcontextprotocol/inspector npx nodemon --quiet --watch dist --ext js --exec node dist/main.js\"",
         "setup": "cp .env.example .env && npm install && npm run build",
         "test:executable": "npm run build && node scripts/test-executable.cjs",
         "type-check": "npx tsc --noEmit",
@@ -46,28 +48,28 @@
         "prepare": "husky"
     },
     "dependencies": {
+        "@doist/todoist-api-typescript": "6.0.0",
         "@modelcontextprotocol/sdk": "^1.11.1",
         "date-fns": "^4.1.0",
-        "@doist/todoist-api-typescript": "5.9.0",
         "dotenv": "^17.0.0",
         "zod": "^3.25.7"
     },
     "devDependencies": {
         "@biomejs/biome": "2.3.2",
         "@types/express": "^5.0.2",
-        "@types/jest": "30.0.0",
         "@types/morgan": "^1.9.9",
         "@types/node": "^22.15.17",
         "concurrently": "^9.0.0",
         "express": "^5.0.0",
         "husky": "^9.1.7",
-        "jest": "30.2.0",
         "lint-staged": "^16.0.0",
         "morgan": "^1.10.0",
         "nodemon": "^3.1.10",
         "rimraf": "^6.0.1",
-        "ts-jest": "29.4.5",
-        "typescript": "^5.8.3"
+        "typescript": "^5.8.3",
+        "vite": "7.1.10",
+        "vite-plugin-dts": "4.5.4",
+        "vitest": "3.2.4"
     },
     "lint-staged": {
         "*": [

package/dist/filter-helpers.js

@@ -1,79 +0,0 @@
-import { resolveUserNameToId } from './utils/user-resolver.js';
-export const RESPONSIBLE_USER_FILTERING = ['assigned', 'unassignedOrMe', 'all'];
-/**
- * Resolves a responsible user name/email to user ID and email.
- * @param client - Todoist API client
- * @param responsibleUser - User identifier (can be user ID, name, or email)
- * @returns Object with userId and email, or undefined if not provided
- * @throws Error if user cannot be found
- */
-export async function resolveResponsibleUser(client, responsibleUser) {
-    if (!responsibleUser) {
-        return undefined;
-    }
-    const resolved = await resolveUserNameToId(client, responsibleUser);
-    if (!resolved) {
-        throw new Error(`Could not find user: "${responsibleUser}". Make sure the user is a collaborator on a shared project.`);
-    }
-    return { userId: resolved.userId, email: resolved.email };
-}
-/**
- * Appends a filter component to a query string with proper ' & ' separator.
- * @param query - The existing query string
- * @param filterComponent - The filter component to append
- * @returns The updated query string
- */
-export function appendToQuery(query, filterComponent) {
-    if (filterComponent.length === 0) {
-        return query;
-    }
-    if (query.length === 0) {
-        return filterComponent;
-    }
-    return `${query} & ${filterComponent}`;
-}
-/**
- * Builds a query filter string for responsible user filtering that can be appended to a Todoist filter query.
- * @param resolvedAssigneeId - The resolved assignee ID (if provided)
- * @param assigneeEmail - The assignee email (if provided)
- * @param responsibleUserFiltering - The filtering mode ('assigned', 'unassignedOrMe', 'all')
- * @returns Query filter string (e.g., "assigned to: email@example.com" or "!assigned to: others")
- */
-export function buildResponsibleUserQueryFilter({ resolvedAssigneeId, assigneeEmail, responsibleUserFiltering = 'unassignedOrMe', }) {
-    if (resolvedAssigneeId && assigneeEmail) {
-        // If specific user is provided, filter by that user
-        return `assigned to: ${assigneeEmail}`;
-    }
-    // Otherwise use the filtering mode
-    if (responsibleUserFiltering === 'unassignedOrMe') {
-        // Exclude tasks assigned to others (keeps unassigned + assigned to me)
-        return '!assigned to: others';
-    }
-    if (responsibleUserFiltering === 'assigned') {
-        // Only tasks assigned to others
-        return 'assigned to: others';
-    }
-    // For 'all', don't add any assignment filter
-    return '';
-}
-/**
- * Filters tasks based on responsible user logic:
- * - If resolvedAssigneeId is provided: returns only tasks assigned to that user
- * - If no resolvedAssigneeId: returns only unassigned tasks or tasks assigned to current user
- * @param tasks - Array of tasks to filter (must have responsibleUid property)
- * @param resolvedAssigneeId - The resolved assignee ID to filter by (optional)
- * @param currentUserId - The current authenticated user's ID
- * @returns Filtered array of tasks
- */
-export function filterTasksByResponsibleUser({ tasks, resolvedAssigneeId, currentUserId, responsibleUserFiltering = 'unassignedOrMe', }) {
-    if (resolvedAssigneeId) {
-        // If responsibleUser provided, only return tasks assigned to that user
-        return tasks.filter((task) => task.responsibleUid === resolvedAssigneeId);
-    }
-    else {
-        // If no responsibleUser, only return unassigned tasks or tasks assigned to current user
-        return responsibleUserFiltering === 'unassignedOrMe'
-            ? tasks.filter((task) => !task.responsibleUid || task.responsibleUid === currentUserId)
-            : tasks;
-    }
-}

package/dist/mcp-helpers.js

@@ -1,71 +0,0 @@
-import { removeNullFields } from './utils/sanitize-data.js';
-/**
- * Wether to return the structured content directly, vs. in the `content` part of the output.
- *
- * The `structuredContent` part of the output is relatively new in the spec, and it's not yet
- * supported by all clients. This flag controls wether we return the structured content using this
- * new feature of the MCP protocol or not.
- *
- * If `false`, the `structuredContent` will be returned as stringified JSON in one of the `content`
- * parts.
- *
- * Eventually we should be able to remove this, and change the code to always work with the
- * structured content returned directly, once most or all MCP clients support it.
- */
-const USE_STRUCTURED_CONTENT = process.env.USE_STRUCTURED_CONTENT === 'true' || process.env.NODE_ENV === 'test';
-/**
- * Get the output payload for a tool, in the correct format expected by MCP client apps.
- *
- * @param textContent - The text content to return.
- * @param structuredContent - The structured content to return.
- * @returns The output payload.
- * @see USE_STRUCTURED_CONTENT - Wether to use the structured content feature of the MCP protocol.
- */
-function getToolOutput({ textContent, structuredContent, }) {
-    // Remove null fields from structured content before returning
-    const sanitizedContent = removeNullFields(structuredContent);
-    if (USE_STRUCTURED_CONTENT) {
-        return {
-            content: [{ type: 'text', text: textContent }],
-            structuredContent: sanitizedContent,
-        };
-    }
-    const json = JSON.stringify(sanitizedContent);
-    return {
-        content: [
-            { type: 'text', text: textContent },
-            { type: 'text', mimeType: 'application/json', text: json },
-        ],
-    };
-}
-function getErrorOutput(error) {
-    return {
-        content: [{ type: 'text', text: error }],
-        isError: true,
-    };
-}
-/**
- * Register a Todoist tool in an MCP server.
- * @param tool - The tool to register.
- * @param server - The server to register the tool on.
- * @param client - The Todoist API client to use to execute the tool.
- */
-function registerTool(tool, server, client) {
-    // @ts-expect-error I give up
-    const cb = async (args, _context) => {
-        try {
-            const result = await tool.execute(args, client);
-            return result;
-        }
-        catch (error) {
-            console.error(`Error executing tool ${tool.name}:`, {
-                args,
-                error,
-            });
-            const message = error instanceof Error ? error.message : 'An unknown error occurred';
-            return getErrorOutput(message);
-        }
-    };
-    server.tool(tool.name, tool.description, tool.parameters, cb);
-}
-export { registerTool, getErrorOutput, getToolOutput };

package/dist/mcp-server.js

@@ -1,142 +0,0 @@
-import { TodoistApi } from '@doist/todoist-api-typescript';
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { registerTool } from './mcp-helpers.js';
-import { addComments } from './tools/add-comments.js';
-import { addProjects } from './tools/add-projects.js';
-import { addSections } from './tools/add-sections.js';
-import { addTasks } from './tools/add-tasks.js';
-import { completeTasks } from './tools/complete-tasks.js';
-import { deleteObject } from './tools/delete-object.js';
-import { fetch } from './tools/fetch.js';
-import { findActivity } from './tools/find-activity.js';
-import { findComments } from './tools/find-comments.js';
-import { findCompletedTasks } from './tools/find-completed-tasks.js';
-import { findProjectCollaborators } from './tools/find-project-collaborators.js';
-import { findProjects } from './tools/find-projects.js';
-import { findSections } from './tools/find-sections.js';
-import { findTasks } from './tools/find-tasks.js';
-import { findTasksByDate } from './tools/find-tasks-by-date.js';
-import { getOverview } from './tools/get-overview.js';
-import { manageAssignments } from './tools/manage-assignments.js';
-import { search } from './tools/search.js';
-import { updateComments } from './tools/update-comments.js';
-import { updateProjects } from './tools/update-projects.js';
-import { updateSections } from './tools/update-sections.js';
-import { updateTasks } from './tools/update-tasks.js';
-import { userInfo } from './tools/user-info.js';
-const instructions = `
-## Todoist Task and Project Management Tools
-
-You have access to comprehensive Todoist management tools for personal productivity and team collaboration. Use these tools to help users manage tasks, projects, sections, comments, and assignments effectively.
-
-### Core Capabilities:
-- Create, update, complete, and search tasks with rich metadata (priorities, due dates, durations, assignments)
-- Manage projects and sections with flexible organization
-- Handle comments and collaboration features
-- Bulk assignment operations for team workflows
-- Get overviews and insights about workload and progress
-
-### Tool Usage Guidelines:
-
-**Task Management:**
-- **add-tasks**: Create tasks with content, description, priority (p1=highest, p2=high, p3=medium, p4=lowest/default), dueString (natural language like "tomorrow", "next Friday", "2024-12-25"), deadlineDate (ISO 8601 format like "2025-12-31" for immovable constraints), duration (formats like "2h", "90m", "2h30m"), and assignments to project collaborators
-- **update-tasks**: Modify existing tasks - get task IDs from search results first, only include fields that need changes. Supports deadlineDate (ISO 8601 format like "2025-12-31") updates and removals (use "remove" to clear)
-- **complete-tasks**: Mark tasks as done using task IDs
-- **find-tasks**: Search by text, project/section/parent container, responsible user, or labels. Requires at least one search parameter
-- **find-tasks-by-date**: Get tasks by date range (startDate: YYYY-MM-DD or 'today' which includes overdue tasks) or specific day counts
-- **find-completed-tasks**: View completed tasks by completion date or original due date (returns all collaborators unless filtered)
-
-**Project & Organization:**
-- **add-projects/update-projects/find-projects**: Manage project lifecycle with names, favorites, and view styles (list/board/calendar)
-- **add-sections/update-sections/find-sections**: Organize tasks within projects using sections
-- **get-overview**: Get comprehensive Markdown overview of entire account or specific project with task hierarchies
-
-**Collaboration & Comments:**
-- **add-comments/update-comments/find-comments**: Manage task and project discussions
-- **find-project-collaborators**: Find team members by name or email for assignments
-- **manage-assignments**: Bulk assign/unassign/reassign up to 50 tasks with atomic operations and dry-run validation
-
-**Activity & Audit:**
-- **find-activity**: Retrieve recent activity logs to monitor and audit changes. Shows events from all users by default; use initiatorId to filter by specific user. Filter by object type (task/project/comment), event type (added/updated/deleted/completed/uncompleted/archived/unarchived/shared/left), and specific objects (objectId, projectId, taskId). Useful for tracking who did what and when. Note: Date-based filtering is not supported.
-
-**General Operations:**
-- **delete-object**: Remove projects, sections, tasks, or comments by type and ID
-- **user-info**: Get user details including timezone, goals, and plan information
-
-### Best Practices:
-
-1. **Task Creation**: Write clear, actionable task titles. Use natural language for due dates ("tomorrow", "next Monday"). Set appropriate priorities and include detailed descriptions when needed.
-
-2. **Search Strategy**: Use specific search queries combining multiple filters for precise results. When searching for tasks, start with broader queries and narrow down as needed.
-
-3. **Assignments**: Always validate project collaborators exist before assigning tasks. Use find-project-collaborators to verify user access.
-
-4. **Bulk Operations**: When working with multiple items, prefer bulk tools (complete-tasks, manage-assignments) over individual operations for better performance.
-
-5. **Date Handling**: All dates respect user timezone settings. Use 'today' keyword for dynamic date filtering (includes overdue tasks).
-
-6. **Labels**: Use label filtering with AND/OR operators for advanced task organization. Most search tools support labels parameter.
-
-7. **Pagination**: Large result sets use cursor-based pagination. Use limit parameter to control result size (default varies by tool).
-
-8. **Error Handling**: All tools provide detailed error messages and next-step suggestions. Pay attention to validation feedback for corrective actions.
-
-### Common Workflows:
-
-- **Daily Planning**: Use find-tasks-by-date with 'today' and get-overview for project status
-- **Team Assignment**: find-project-collaborators → add-tasks with responsibleUser → manage-assignments for bulk changes  
-- **Task Search**: find-tasks with multiple filters → update-tasks or complete-tasks based on results
-- **Project Organization**: add-projects → add-sections → add-tasks with projectId and sectionId
-- **Progress Reviews**: find-completed-tasks with date ranges → get-overview for project summaries
-- **Activity Auditing**: find-activity with event/object filters to track changes, monitor team activity, or investigate specific actions
-
-Always provide clear, actionable task titles and descriptions. Use the overview tools to give users context about their workload and project status.
-`;
-/**
- * Create the MCP server.
- * @param todoistApiKey - The API key for the todoist account.
- * @param baseUrl - The base URL for the todoist API.
- * @returns the MCP server.
- */
-function getMcpServer({ todoistApiKey, baseUrl }) {
-    const server = new McpServer({ name: 'todoist-mcp-server', version: '0.1.0' }, {
-        capabilities: {
-            tools: { listChanged: true },
-        },
-        instructions,
-    });
-    const todoist = new TodoistApi(todoistApiKey, baseUrl);
-    // Task management tools
-    registerTool(addTasks, server, todoist);
-    registerTool(completeTasks, server, todoist);
-    registerTool(updateTasks, server, todoist);
-    registerTool(findTasks, server, todoist);
-    registerTool(findTasksByDate, server, todoist);
-    registerTool(findCompletedTasks, server, todoist);
-    // Project management tools
-    registerTool(addProjects, server, todoist);
-    registerTool(updateProjects, server, todoist);
-    registerTool(findProjects, server, todoist);
-    // Section management tools
-    registerTool(addSections, server, todoist);
-    registerTool(updateSections, server, todoist);
-    registerTool(findSections, server, todoist);
-    // Comment management tools
-    registerTool(addComments, server, todoist);
-    registerTool(findComments, server, todoist);
-    registerTool(updateComments, server, todoist);
-    // Activity and audit tools
-    registerTool(findActivity, server, todoist);
-    // General tools
-    registerTool(getOverview, server, todoist);
-    registerTool(deleteObject, server, todoist);
-    registerTool(userInfo, server, todoist);
-    // Assignment and collaboration tools
-    registerTool(findProjectCollaborators, server, todoist);
-    registerTool(manageAssignments, server, todoist);
-    // OpenAI MCP tools
-    registerTool(search, server, todoist);
-    registerTool(fetch, server, todoist);
-    return server;
-}
-export { getMcpServer };

package/dist/todoist-tool.js

@@ -1 +0,0 @@
-export {};

package/dist/tool-helpers.js

@@ -1,125 +0,0 @@
-import z from 'zod';
-import { formatDuration } from './utils/duration-parser.js';
-// Re-export filter helpers for backward compatibility
-export { appendToQuery, buildResponsibleUserQueryFilter, filterTasksByResponsibleUser, RESPONSIBLE_USER_FILTERING, resolveResponsibleUser, } from './filter-helpers.js';
-export function isPersonalProject(project) {
-    return 'inboxProject' in project;
-}
-export function isWorkspaceProject(project) {
-    return 'accessLevel' in project;
-}
-/**
- * Creates a MoveTaskArgs object from move parameters, validating that exactly one is provided.
- * @param taskId - The task ID (used for error messages)
- * @param projectId - Optional project ID to move to
- * @param sectionId - Optional section ID to move to
- * @param parentId - Optional parent ID to move to
- * @returns MoveTaskArgs object with exactly one destination
- * @throws Error if multiple move parameters are provided or none are provided
- */
-export function createMoveTaskArgs(taskId, projectId, sectionId, parentId) {
-    // Validate that only one move parameter is provided (RequireExactlyOne constraint)
-    const moveParams = [projectId, sectionId, parentId].filter(Boolean);
-    if (moveParams.length > 1) {
-        throw new Error(`Task ${taskId}: Only one of projectId, sectionId, or parentId can be specified at a time. The Todoist API requires exactly one destination for move operations.`);
-    }
-    if (moveParams.length === 0) {
-        throw new Error(`Task ${taskId}: At least one of projectId, sectionId, or parentId must be provided for move operations.`);
-    }
-    // Build moveArgs with the single defined value
-    if (projectId)
-        return { projectId };
-    if (sectionId)
-        return { sectionId };
-    if (parentId)
-        return { parentId };
-    // This should never be reached due to the validation above
-    throw new Error('Unexpected error: No valid move parameter found');
-}
-/**
- * Map a single Todoist task to a more structured format, for LLM consumption.
- * @param task - The task to map.
- * @returns The mapped task.
- */
-function mapTask(task) {
-    return {
-        id: task.id,
-        content: task.content,
-        description: task.description,
-        dueDate: task.due?.date,
-        recurring: task.due?.isRecurring && task.due.string ? task.due.string : false,
-        deadlineDate: task.deadline?.date,
-        priority: task.priority,
-        projectId: task.projectId,
-        sectionId: task.sectionId,
-        parentId: task.parentId,
-        labels: task.labels,
-        duration: task.duration ? formatDuration(task.duration.amount) : null,
-        responsibleUid: task.responsibleUid,
-        assignedByUid: task.assignedByUid,
-        checked: task.checked,
-        completedAt: task.completedAt,
-    };
-}
-/**
- * Map a single Todoist project to a more structured format, for LLM consumption.
- * @param project - The project to map.
- * @returns The mapped project.
- */
-function mapProject(project) {
-    return {
-        id: project.id,
-        name: project.name,
-        color: project.color,
-        isFavorite: project.isFavorite,
-        isShared: project.isShared,
-        parentId: isPersonalProject(project) ? (project.parentId ?? null) : null,
-        inboxProject: isPersonalProject(project) ? (project.inboxProject ?? false) : false,
-        viewStyle: project.viewStyle,
-    };
-}
-/**
- * Map a single Todoist activity event to a more structured format, for LLM consumption.
- * @param event - The activity event to map.
- * @returns The mapped activity event.
- */
-function mapActivityEvent(event) {
-    return {
-        id: event.id,
-        objectType: event.objectType,
-        objectId: event.objectId,
-        eventType: event.eventType,
-        eventDate: event.eventDate,
-        parentProjectId: event.parentProjectId,
-        parentItemId: event.parentItemId,
-        initiatorId: event.initiatorId,
-        extraData: event.extraData,
-    };
-}
-const ErrorSchema = z.object({
-    httpStatusCode: z.number(),
-    responseData: z.object({
-        error: z.string(),
-        errorCode: z.number(),
-        errorTag: z.string(),
-    }),
-});
-async function getTasksByFilter({ client, query, limit, cursor, }) {
-    try {
-        const { results, nextCursor } = await client.getTasksByFilter({ query, cursor, limit });
-        const tasks = results.map(mapTask);
-        return { tasks, nextCursor };
-    }
-    catch (error) {
-        const parsedError = ErrorSchema.safeParse(error);
-        if (!parsedError.success) {
-            throw error;
-        }
-        const { responseData } = parsedError.data;
-        if (responseData.errorTag === 'INVALID_SEARCH_QUERY') {
-            throw new Error(`Invalid filter query: ${query}`);
-        }
-        throw new Error(`${responseData.error} (tag: ${responseData.errorTag}, code: ${responseData.errorCode})`);
-    }
-}
-export { getTasksByFilter, mapActivityEvent, mapProject, mapTask };

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

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=tool-helpers.test.d.ts.map

package/dist/tool-helpers.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tool-helpers.test.d.ts","sourceRoot":"","sources":["../src/tool-helpers.test.ts"],"names":[],"mappings":""}