@doist/todoist-ai 3.0.0 → 4.0.0

package/dist/tools/__tests__/manage-sections.test.js

@@ -1,162 +0,0 @@
-import { jest } from '@jest/globals';
-import { TEST_IDS, createMockSection, extractStructuredContent, extractTextContent, } from '../../utils/test-helpers.js';
-import { ToolNames } from '../../utils/tool-names.js';
-import { manageSections } from '../manage-sections.js';
-// Mock the Todoist API
-const mockTodoistApi = {
-    addSection: jest.fn(),
-    updateSection: jest.fn(),
-};
-const { ADD_TASKS, MANAGE_SECTIONS, FIND_TASKS } = ToolNames;
-describe(`${MANAGE_SECTIONS} tool`, () => {
-    beforeEach(() => {
-        jest.clearAllMocks();
-    });
-    describe('creating a new section', () => {
-        it('should create a section and return result', async () => {
-            const mockApiResponse = createMockSection({
-                id: TEST_IDS.SECTION_1,
-                projectId: TEST_IDS.PROJECT_TEST,
-                name: 'test-abc123def456-section',
-            });
-            mockTodoistApi.addSection.mockResolvedValue(mockApiResponse);
-            const result = await manageSections.execute({ name: 'test-abc123def456-section', projectId: TEST_IDS.PROJECT_TEST }, mockTodoistApi);
-            expect(mockTodoistApi.addSection).toHaveBeenCalledWith({
-                name: 'test-abc123def456-section',
-                projectId: TEST_IDS.PROJECT_TEST,
-            });
-            const textContent = extractTextContent(result);
-            expect(textContent).toMatchSnapshot();
-            expect(textContent).toContain('Created section: test-abc123def456-section');
-            expect(textContent).toContain(`id=${TEST_IDS.SECTION_1}`);
-            expect(textContent).toContain(`Use ${FIND_TASKS} with sectionId`);
-            // Verify structured content
-            const structuredContent = extractStructuredContent(result);
-            expect(structuredContent).toEqual(expect.objectContaining({
-                section: expect.objectContaining({
-                    id: TEST_IDS.SECTION_1,
-                    name: 'test-abc123def456-section',
-                }),
-                operation: 'created',
-            }));
-        });
-        it('should handle different section properties from API', async () => {
-            const mockApiResponse = createMockSection({
-                id: TEST_IDS.SECTION_2,
-                projectId: 'project-789',
-                sectionOrder: 2,
-                name: 'My Section Name',
-            });
-            mockTodoistApi.addSection.mockResolvedValue(mockApiResponse);
-            const result = await manageSections.execute({ name: 'My Section Name', projectId: 'project-789' }, mockTodoistApi);
-            expect(mockTodoistApi.addSection).toHaveBeenCalledWith({
-                name: 'My Section Name',
-                projectId: 'project-789',
-            });
-            const textContent = extractTextContent(result);
-            expect(textContent).toMatchSnapshot();
-            expect(textContent).toContain('Created section: My Section Name');
-            expect(textContent).toContain(`id=${TEST_IDS.SECTION_2}`);
-            expect(textContent).toContain(`Use ${ADD_TASKS} with sectionId`);
-            // Verify structured content
-            const structuredContent = extractStructuredContent(result);
-            expect(structuredContent).toEqual(expect.objectContaining({
-                section: expect.objectContaining({
-                    id: TEST_IDS.SECTION_2,
-                    name: 'My Section Name',
-                }),
-                operation: 'created',
-            }));
-        });
-        it('should throw error when projectId is missing for new section', async () => {
-            await expect(manageSections.execute({ name: 'test-section' }, mockTodoistApi)).rejects.toThrow('Error: projectId is required when creating a new section (when id is not provided).');
-            expect(mockTodoistApi.addSection).not.toHaveBeenCalled();
-        });
-    });
-    describe('updating an existing section', () => {
-        it('should update a section when id is provided', async () => {
-            const mockApiResponse = {
-                id: 'existing-section-123',
-                projectId: '6cfCcrrCFg2xP94Q',
-                sectionOrder: 1,
-                userId: 'test-user',
-                addedAt: '2024-01-01T00:00:00Z',
-                updatedAt: '2024-01-01T00:00:00Z',
-                archivedAt: null,
-                isArchived: false,
-                isDeleted: false,
-                isCollapsed: false,
-                name: 'Updated Section Name',
-            };
-            mockTodoistApi.updateSection.mockResolvedValue(mockApiResponse);
-            const result = await manageSections.execute({ id: 'existing-section-123', name: 'Updated Section Name' }, mockTodoistApi);
-            expect(mockTodoistApi.updateSection).toHaveBeenCalledWith('existing-section-123', {
-                name: 'Updated Section Name',
-            });
-            const textContent = extractTextContent(result);
-            expect(textContent).toMatchSnapshot();
-            expect(textContent).toContain('Updated section: Updated Section Name');
-            expect(textContent).toContain('id=existing-section-123');
-            expect(textContent).toContain(`Use ${FIND_TASKS} with sectionId`);
-            // Verify structured content
-            const structuredContent = extractStructuredContent(result);
-            expect(structuredContent).toEqual(expect.objectContaining({
-                section: expect.objectContaining({
-                    id: 'existing-section-123',
-                    name: 'Updated Section Name',
-                }),
-                operation: 'updated',
-            }));
-        });
-        it('should update section without requiring projectId', async () => {
-            const mockApiResponse = {
-                id: 'section-update-test',
-                projectId: 'original-project-id',
-                sectionOrder: 3,
-                userId: 'test-user',
-                addedAt: '2024-01-01T00:00:00Z',
-                updatedAt: '2024-01-01T00:00:00Z',
-                archivedAt: null,
-                isArchived: false,
-                isDeleted: false,
-                isCollapsed: false,
-                name: 'Section New Name',
-            };
-            mockTodoistApi.updateSection.mockResolvedValue(mockApiResponse);
-            const result = await manageSections.execute({
-                id: 'section-update-test',
-                name: 'Section New Name',
-                // Note: projectId not provided for update
-            }, mockTodoistApi);
-            expect(mockTodoistApi.updateSection).toHaveBeenCalledWith('section-update-test', {
-                name: 'Section New Name',
-            });
-            const textContent = extractTextContent(result);
-            expect(textContent).toMatchSnapshot();
-            expect(textContent).toContain('Updated section: Section New Name');
-            expect(textContent).toContain('id=section-update-test');
-            expect(textContent).toContain(`Use ${FIND_TASKS} with sectionId`);
-            // Verify structured content
-            const structuredContent = extractStructuredContent(result);
-            expect(structuredContent).toEqual(expect.objectContaining({
-                section: expect.objectContaining({
-                    id: 'section-update-test',
-                    name: 'Section New Name',
-                }),
-                operation: 'updated',
-            }));
-        });
-    });
-    describe('error handling', () => {
-        it('should propagate API errors for section creation', async () => {
-            const apiError = new Error('API Error: Section name is required');
-            mockTodoistApi.addSection.mockRejectedValue(apiError);
-            await expect(manageSections.execute({ name: '', projectId: '6cfCcrrCFg2xP94Q' }, mockTodoistApi)).rejects.toThrow('API Error: Section name is required');
-        });
-        it('should propagate API errors for section updates', async () => {
-            const apiError = new Error('API Error: Section not found');
-            mockTodoistApi.updateSection.mockRejectedValue(apiError);
-            await expect(manageSections.execute({ id: 'non-existent-section', name: 'Updated Name' }, mockTodoistApi)).rejects.toThrow('API Error: Section not found');
-        });
-    });
-});

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

@@ -1,35 +0,0 @@
-import { z } from 'zod';
-declare const manageProjects: {
-    name: "manage-projects";
-    description: string;
-    parameters: {
-        id: z.ZodOptional<z.ZodString>;
-        name: z.ZodString;
-    };
-    execute(args: {
-        name: string;
-        id?: string | undefined;
-    }, client: import("@doist/todoist-api-typescript").TodoistApi): Promise<{
-        content: {
-            type: "text";
-            text: string;
-        }[];
-        structuredContent: {
-            project: import("@doist/todoist-api-typescript").PersonalProject | import("@doist/todoist-api-typescript").WorkspaceProject;
-            operation: string;
-        };
-    } | {
-        content: ({
-            type: "text";
-            text: string;
-            mimeType?: undefined;
-        } | {
-            type: "text";
-            mimeType: string;
-            text: string;
-        })[];
-        structuredContent?: undefined;
-    }>;
-};
-export { manageProjects };
-//# sourceMappingURL=manage-projects.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"manage-projects.d.ts","sourceRoot":"","sources":["../../src/tools/manage-projects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAmBvB,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCsB,CAAA;AA+B1C,OAAO,EAAE,cAAc,EAAE,CAAA"}

package/dist/tools/manage-projects.js

@@ -1,63 +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 { MANAGE_SECTIONS, ADD_TASKS, FIND_PROJECTS, FIND_TASKS, GET_OVERVIEW } = ToolNames;
-const ArgsSchema = {
-    id: z
-        .string()
-        .min(1)
-        .optional()
-        .describe('The ID of the project to update. If provided, updates the project. If omitted, creates a new project.'),
-    name: z.string().min(1).describe('The name of the project.'),
-};
-const manageProjects = {
-    name: ToolNames.MANAGE_PROJECTS,
-    description: 'Add a new project or update an existing project. If id is provided, updates the project. If id is omitted, creates a new project.',
-    parameters: ArgsSchema,
-    async execute(args, client) {
-        if (args.id) {
-            // Update existing project
-            const project = await client.updateProject(args.id, { name: args.name });
-            const textContent = generateTextContent({ project, operation: 'updated' });
-            return getToolOutput({
-                textContent,
-                structuredContent: {
-                    project,
-                    operation: 'updated',
-                },
-            });
-        }
-        // Create new project
-        const project = await client.addProject({ name: args.name });
-        const textContent = generateTextContent({ project, operation: 'created' });
-        return getToolOutput({
-            textContent,
-            structuredContent: {
-                project,
-                operation: 'created',
-            },
-        });
-    },
-};
-function generateTextContent({ project, operation, }) {
-    const action = operation === 'created' ? 'Created' : 'Updated';
-    const summary = `${action} project: ${project.name} • id=${project.id}`;
-    // Context-aware next steps based on operation
-    const nextSteps = [];
-    if (operation === 'created') {
-        // For new projects, suggest logical setup workflow
-        nextSteps.push(`Use ${MANAGE_SECTIONS} to organize this project with sections`);
-        nextSteps.push(`Use ${ADD_TASKS} to add your first tasks`);
-        nextSteps.push(`Use ${GET_OVERVIEW} with projectId to see updated project structure.`);
-    }
-    else {
-        // For updated projects, suggest review and management
-        nextSteps.push(`Use ${GET_OVERVIEW} with projectId=${project.id} to see project structure`);
-        nextSteps.push(`Use ${FIND_PROJECTS} to see all projects with updated name`);
-        nextSteps.push(`Use ${FIND_TASKS} with projectId=${project.id} to review existing tasks`);
-    }
-    const next = formatNextSteps(nextSteps);
-    return `${summary}\n${next}`;
-}
-export { manageProjects };

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

@@ -1 +0,0 @@
-{"version":3,"file":"manage-sections.d.ts","sourceRoot":"","sources":["../../src/tools/manage-sections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAA;AAC5D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA0BvB,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0CsB,CAAA;AAuC1C,OAAO,EAAE,cAAc,EAAE,CAAA"}

package/dist/tools/manage-sections.js

@@ -1,78 +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 { ADD_TASKS, FIND_TASKS, GET_OVERVIEW, FIND_SECTIONS } = ToolNames;
-const ArgsSchema = {
-    id: z
-        .string()
-        .min(1)
-        .optional()
-        .describe('The ID of the section to update. If provided, updates the section. If omitted, creates a new section.'),
-    name: z.string().min(1).describe('The name of the section.'),
-    projectId: z
-        .string()
-        .min(1)
-        .optional()
-        .describe('The ID of the project to add the section to. Required when creating a new section (when id is not provided).'),
-};
-const manageSections = {
-    name: ToolNames.MANAGE_SECTIONS,
-    description: 'Add a new section to a project or update an existing section. If id is provided, updates the section. If id is omitted, creates a new section (requires projectId).',
-    parameters: ArgsSchema,
-    async execute(args, client) {
-        if (args.id) {
-            // Update existing section
-            const section = await client.updateSection(args.id, { name: args.name });
-            const textContent = generateTextContent({ section, operation: 'updated' });
-            return getToolOutput({
-                textContent,
-                structuredContent: {
-                    section,
-                    operation: 'updated',
-                },
-            });
-        }
-        // Create new section - projectId is required
-        if (!args.projectId) {
-            throw new Error('Error: projectId is required when creating a new section (when id is not provided).');
-        }
-        const section = await client.addSection({
-            name: args.name,
-            projectId: args.projectId,
-        });
-        const textContent = generateTextContent({ section, operation: 'created' });
-        return getToolOutput({
-            textContent,
-            structuredContent: {
-                section,
-                operation: 'created',
-            },
-        });
-    },
-};
-function generateTextContent({ section, operation, }) {
-    const action = operation === 'created' ? 'Created' : 'Updated';
-    const summary = `${action} section: ${section.name} • id=${section.id}`;
-    // Workflow-aware next steps based on operation and section context
-    const nextSteps = [];
-    if (operation === 'created') {
-        // For new sections, suggest immediate setup workflow
-        nextSteps.push(`Use ${ADD_TASKS} with sectionId=${section.id} to add your first tasks`);
-        nextSteps.push(`Use ${FIND_TASKS} with sectionId=${section.id} to verify setup`);
-        // Suggest related organization
-        if (section.projectId) {
-            nextSteps.push(`Use ${GET_OVERVIEW} with projectId=${section.projectId} to see project organization`);
-        }
-    }
-    else {
-        // For updated sections, suggest review and management
-        nextSteps.push(`Use ${FIND_TASKS} with sectionId=${section.id} to see existing tasks`);
-        nextSteps.push(`Use ${FIND_SECTIONS} to see all sections in this project`);
-        // Suggest task updates if section was renamed
-        nextSteps.push('Consider updating task descriptions if section purpose changed');
-    }
-    const next = formatNextSteps(nextSteps);
-    return `${summary}\n${next}`;
-}
-export { manageSections };