@doist/todoist-ai 4.16.0 → 4.17.0

package/dist/utils/response-builders.js

@@ -1,210 +0,0 @@
-import { DisplayLimits } from './constants.js';
-import { formatPriorityForDisplay } from './priorities.js';
-import { ToolNames } from './tool-names.js';
-/**
- * Helper function to get date string in YYYY-MM-DD format
- */
-export function getDateString(date = new Date()) {
-    const parts = date.toISOString().split('T');
-    return parts[0] ?? '';
-}
-const { FIND_TASKS_BY_DATE, ADD_TASKS, UPDATE_TASKS, COMPLETE_TASKS, GET_OVERVIEW } = ToolNames;
-/**
- * Creates concise, actionable summaries for task operations instead of raw JSON
- */
-export function summarizeTaskOperation(action, tasks, options = {}) {
-    const { nextSteps, context, showDetails = false } = options;
-    const count = tasks.length;
-    const bits = [];
-    // Main action summary
-    const taskOrTasks = count === 1 ? 'task' : 'tasks';
-    const actionSummary = `${action} ${count} ${taskOrTasks}${context ? ` ${context}` : ''}.`;
-    bits.push(actionSummary);
-    // Task details preview (if requested or small batch)
-    const smallBatchLimit = 5;
-    if (showDetails || count <= smallBatchLimit) {
-        const previews = previewTasks(tasks, smallBatchLimit);
-        if (previews.length > 0) {
-            const moreInfo = count > smallBatchLimit ? `, +${count - smallBatchLimit} more` : '';
-            bits.push(`Tasks:\n${previews}${moreInfo}.`);
-        }
-    }
-    // Next steps guidance
-    if (nextSteps?.length) {
-        bits.push(formatNextSteps(nextSteps));
-    }
-    return bits.join('\n');
-}
-/**
- * Creates batch operation summaries with success/failure breakdown
- */
-export function summarizeBatch(params) {
-    const { action, success, total, successItems, failures, nextSteps } = params;
-    const bits = [];
-    // Main result summary
-    const successBit = `${action}: ${success}/${total} successful.`;
-    bits.push(successBit);
-    // Success items (if provided and reasonable count)
-    if (successItems?.length && successItems.length <= 5) {
-        bits.push(`Completed:\n${successItems.map((item) => `    ${item}`).join('\n')}.`);
-    }
-    // Failure details (if any)
-    if (failures?.length) {
-        const failureCount = failures.length;
-        const failureBit = `Failed (${failureCount}):\n${failures
-            .slice(0, DisplayLimits.MAX_FAILURES_SHOWN)
-            .map((f) => `    ${f.item} (Error: ${f.error}${f.code ? ` [${f.code}]` : ''})`)
-            .join('\n')}${failureCount > DisplayLimits.MAX_FAILURES_SHOWN ? `, +${failureCount - DisplayLimits.MAX_FAILURES_SHOWN} more` : ''}.`;
-        bits.push(failureBit);
-    }
-    // Next steps
-    if (nextSteps?.length) {
-        bits.push(formatNextSteps(nextSteps));
-    }
-    return bits.join('\n');
-}
-/**
- * Formats a single task-like object into a readable preview line
- */
-function formatTaskPreview(task) {
-    const content = task.content || task.title || 'Untitled';
-    const due = task.dueDate ? ` • due ${task.dueDate}` : '';
-    const priority = task.priority ? ` • ${formatPriorityForDisplay(task.priority)}` : '';
-    const project = task.projectName ? ` • ${task.projectName}` : '';
-    const id = task.id ? ` • id=${task.id}` : '';
-    return `    ${content}${due}${priority}${project}${id}`;
-}
-/**
- * Formats a single project-like object into a readable preview line
- */
-export function formatProjectPreview(project) {
-    const isInbox = project.inboxProject ? ' • Inbox' : '';
-    const isFavorite = project.isFavorite ? ' • ⭐' : '';
-    const isShared = project.isShared ? ' • Shared' : '';
-    const viewStyle = project.viewStyle && project.viewStyle !== 'list' ? ` • ${project.viewStyle}` : '';
-    const id = ` • id=${project.id}`;
-    return `    ${project.name}${isInbox}${isFavorite}${isShared}${viewStyle}${id}`;
-}
-/**
- * Creates preview lines for task lists
- */
-export function previewTasks(tasks, limit = 5) {
-    const previewTasks = tasks.slice(0, limit);
-    const lines = previewTasks.map(formatTaskPreview).join('\n');
-    // If we're showing fewer tasks than the total, add an indicator
-    if (tasks.length > limit) {
-        const remaining = tasks.length - limit;
-        return `${lines}\n    ... and ${remaining} more task${remaining === 1 ? '' : 's'}`;
-    }
-    return lines;
-}
-/**
- * Creates list summaries with counts, filters, and guidance
- */
-export function summarizeList({ subject, count, limit, nextCursor, filterHints, previewLines, zeroReasonHints, nextSteps, }) {
-    const bits = [];
-    // Header with count and pagination info
-    const header = `${subject}: ${count}${typeof limit === 'number' ? ` (limit ${limit})` : ''}${nextCursor ? ', more available' : ''}.`;
-    bits.push(header);
-    // Filter information
-    if (filterHints?.length) {
-        bits.push(`Filter: ${filterHints.join('; ')}.`);
-    }
-    // Preview of items
-    if (previewLines?.length) {
-        bits.push(`Preview:\n${previewLines}`);
-    }
-    // Help for empty results
-    if (!count && zeroReasonHints?.length) {
-        bits.push(`No results. ${zeroReasonHints.join('; ')}.`);
-    }
-    // Next steps guidance
-    if (nextSteps?.length || nextCursor) {
-        bits.push(formatNextSteps(nextSteps || [], nextCursor));
-    }
-    return bits.join('\n');
-}
-/**
- * Formats next steps array into a consistent "Next:" section
- * If nextCursor is provided, adds cursor instruction to the steps
- */
-export function formatNextSteps(nextSteps, nextCursor) {
-    const allSteps = [...nextSteps];
-    if (nextCursor) {
-        allSteps.push(`Pass cursor '${nextCursor}' to fetch more results.`);
-    }
-    return `Next:\n${allSteps.map((step) => `- ${step}`).join('\n')}`;
-}
-/**
- * Helper to generate contextual next steps based on task operations
- */
-export function generateTaskNextSteps(operation, tasks, context) {
-    const nextSteps = [];
-    const count = context?.count ?? tasks.length;
-    switch (operation.toLowerCase()) {
-        case 'added':
-            // Context-aware suggestions for newly added tasks
-            if (context?.hasToday) {
-                nextSteps.push(`Use ${FIND_TASKS_BY_DATE}('today') to review today's updated schedule`);
-            }
-            else if (context?.hasOverdue) {
-                nextSteps.push(`Use ${FIND_TASKS_BY_DATE}('today') to prioritize past-due items`);
-            }
-            else if (context?.projectName) {
-                nextSteps.push(`Use ${GET_OVERVIEW} with projectId to see ${context.projectName} structure`);
-            }
-            else {
-                nextSteps.push(`Use ${GET_OVERVIEW} to see your updated project organization`);
-            }
-            // Time-based suggestions
-            if (context?.timeOfDay === 'morning') {
-                nextSteps.push(`Use ${FIND_TASKS_BY_DATE}('today') to plan your day`);
-            }
-            break;
-        case 'updated':
-        case 'organized':
-            if (context?.hasToday) {
-                nextSteps.push(`Use ${FIND_TASKS_BY_DATE}('today') to see your prioritized schedule`);
-            }
-            else if (context?.hasHighPriority) {
-                nextSteps.push(`Use ${FIND_TASKS_BY_DATE} with filter to focus on high-priority items`);
-            }
-            else {
-                nextSteps.push(`Use ${GET_OVERVIEW} to see your updated project structure`);
-            }
-            break;
-        case 'completed':
-            if (context?.timeOfDay === 'evening') {
-                nextSteps.push(`Use ${FIND_TASKS_BY_DATE}('tomorrow') to plan upcoming work`);
-            }
-            else if (context?.hasOverdue) {
-                nextSteps.push(`Use ${FIND_TASKS_BY_DATE}('today') to tackle remaining past-due items`);
-            }
-            else {
-                nextSteps.push(`Use ${FIND_TASKS_BY_DATE}('today') to see remaining work`);
-            }
-            break;
-        case 'listed':
-            if (context?.isEmptyResult) {
-                nextSteps.push(`Use ${ADD_TASKS} to add tasks for this timeframe`);
-                nextSteps.push(`Use ${GET_OVERVIEW} with projectId to see tasks in other projects`);
-            }
-            else if (count > 0) {
-                // Tailor suggestions based on result size
-                if (count > DisplayLimits.BATCH_OPERATION_THRESHOLD) {
-                    nextSteps.push(`Use ${UPDATE_TASKS} to batch-update priorities or dates`);
-                    nextSteps.push('Consider breaking large tasks into subtasks');
-                }
-                else {
-                    nextSteps.push(`Use ${UPDATE_TASKS} to modify priorities or due dates`);
-                }
-                nextSteps.push(`Use ${COMPLETE_TASKS} to mark finished tasks`);
-                // Time-sensitive suggestions
-                if (context?.hasOverdue) {
-                    nextSteps.push('Focus on overdue items first to get back on track');
-                }
-            }
-            break;
-    }
-    return nextSteps;
-}

package/dist/utils/sanitize-data.js

@@ -1,37 +0,0 @@
-/**
- * Removes all null fields, empty objects, and empty arrays from an object recursively.
- * This ensures that data sent to agents doesn't include unnecessary empty values.
- *
- * @param obj - The object to sanitize
- * @returns A new object with all null fields, empty objects, and empty arrays removed
- */
-export function removeNullFields(obj) {
-    if (obj === null || obj === undefined) {
-        return obj;
-    }
-    if (Array.isArray(obj)) {
-        return obj.map((item) => removeNullFields(item));
-    }
-    if (typeof obj === 'object') {
-        const sanitized = {};
-        for (const [key, value] of Object.entries(obj)) {
-            if (value !== null) {
-                const cleanedValue = removeNullFields(value);
-                // Skip empty arrays
-                if (Array.isArray(cleanedValue) && cleanedValue.length === 0) {
-                    continue;
-                }
-                // Skip empty objects
-                if (cleanedValue !== null &&
-                    typeof cleanedValue === 'object' &&
-                    !Array.isArray(cleanedValue) &&
-                    Object.keys(cleanedValue).length === 0) {
-                    continue;
-                }
-                sanitized[key] = cleanedValue;
-            }
-        }
-        return sanitized;
-    }
-    return obj;
-}

package/dist/utils/sanitize-data.test.d.ts

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

package/dist/utils/sanitize-data.test.d.ts.map

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

package/dist/utils/sanitize-data.test.js

@@ -1,93 +0,0 @@
-import { removeNullFields } from './sanitize-data.js';
-describe('removeNullFields', () => {
-    it('should remove null fields from objects including nested objects', () => {
-        const input = {
-            name: 'John',
-            age: null,
-            email: 'john@example.com',
-            phone: null,
-            address: {
-                street: '123 Main St',
-                city: null,
-                country: 'USA',
-            },
-        };
-        const result = removeNullFields(input);
-        expect(result).toEqual({
-            name: 'John',
-            email: 'john@example.com',
-            address: {
-                street: '123 Main St',
-                country: 'USA',
-            },
-        });
-    });
-    it('should handle arrays with null values', () => {
-        const input = {
-            items: [
-                { id: 1, value: 'test' },
-                { id: 2, value: null },
-                { id: 3, value: 'another' },
-            ],
-        };
-        const result = removeNullFields(input);
-        expect(result).toEqual({
-            items: [{ id: 1, value: 'test' }, { id: 2 }, { id: 3, value: 'another' }],
-        });
-    });
-    it('should handle null objects', () => {
-        const result = removeNullFields(null);
-        expect(result).toBeNull();
-    });
-    it('should remove empty objects and empty arrays', () => {
-        const input = {
-            something: 'hello',
-            another: {},
-            yetAnother: [],
-        };
-        const result = removeNullFields(input);
-        expect(result).toEqual({
-            something: 'hello',
-        });
-    });
-    it('should remove empty objects and empty arrays in nested structures', () => {
-        const input = {
-            name: 'Test',
-            metadata: {},
-            tags: [],
-            nested: {
-                data: 'value',
-                emptyObj: {},
-                emptyArr: [],
-                deepNested: {
-                    anotherEmpty: {},
-                },
-            },
-            items: [
-                { id: 1, data: 'test', empty: {} },
-                { id: 2, list: [] },
-            ],
-        };
-        const result = removeNullFields(input);
-        expect(result).toEqual({
-            name: 'Test',
-            nested: {
-                data: 'value',
-            },
-            items: [{ id: 1, data: 'test' }, { id: 2 }],
-        });
-    });
-    it('should keep arrays with values and objects with properties', () => {
-        const input = {
-            emptyArray: [],
-            arrayWithValues: [1, 2, 3],
-            emptyObject: {},
-            objectWithProps: { key: 'value' },
-        };
-        const result = removeNullFields(input);
-        expect(result).toEqual({
-            arrayWithValues: [1, 2, 3],
-            objectWithProps: { key: 'value' },
-        });
-    });
-});

package/dist/utils/test-helpers.js

@@ -1,237 +0,0 @@
-/**
- * Creates a mock Task with all required properties and sensible defaults.
- * Pass only the properties you want to override for your specific test.
- */
-export function createMockTask(overrides = {}) {
-    return {
-        id: '8485093748',
-        content: 'Test task content',
-        description: '',
-        completedAt: null,
-        labels: [],
-        childOrder: 1,
-        priority: 1,
-        projectId: '6cfCcrrCFg2xP94Q',
-        sectionId: null,
-        parentId: null,
-        url: 'https://todoist.com/showTask?id=8485093748',
-        // Use correct property names from Task schema
-        noteCount: 0,
-        addedByUid: '713437',
-        addedAt: '2025-08-13T22:09:56.123456Z',
-        deadline: null,
-        responsibleUid: null,
-        assignedByUid: null,
-        isCollapsed: false,
-        isDeleted: false,
-        duration: null,
-        checked: false,
-        updatedAt: '2025-08-13T22:09:56.123456Z',
-        due: null,
-        dayOrder: 0,
-        userId: '713437',
-        ...overrides,
-    };
-}
-/**
- * Creates a mock Section with all required properties and sensible defaults.
- * Pass only the properties you want to override for your specific test.
- */
-export function createMockSection(overrides = {}) {
-    return {
-        id: '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: 'Test Section',
-        url: 'https://todoist.com/sections/section-123',
-        ...overrides,
-    };
-}
-/**
- * Creates a mock PersonalProject with all required properties and sensible defaults.
- * Pass only the properties you want to override for your specific test.
- */
-export function createMockProject(overrides = {}) {
-    return {
-        id: '6cfCcrrCFg2xP94Q',
-        name: 'Test Project',
-        color: 'charcoal',
-        isFavorite: false,
-        isShared: false,
-        parentId: null,
-        inboxProject: false,
-        viewStyle: 'list',
-        url: 'https://todoist.com/projects/6cfCcrrCFg2xP94Q',
-        isDeleted: false,
-        updatedAt: '2025-08-13T22:09:55.841800Z',
-        createdAt: '2025-08-13T22:09:55.841785Z',
-        childOrder: 1,
-        defaultOrder: 0,
-        description: '',
-        isCollapsed: false,
-        canAssignTasks: false,
-        isFrozen: false,
-        isArchived: false,
-        ...overrides,
-    };
-}
-/**
- * Creates a mock API response object with results and nextCursor.
- */
-export function createMockApiResponse(results, nextCursor = null) {
-    return {
-        results,
-        nextCursor,
-    };
-}
-/**
- * Creates a simplified mapped task (matches mapTask output) for filter-based query tests.
- */
-export function createMappedTask(overrides = {}) {
-    return {
-        id: TEST_IDS.TASK_1,
-        content: 'Test task content',
-        description: '',
-        dueDate: undefined,
-        recurring: false,
-        deadlineDate: undefined,
-        priority: 1,
-        projectId: TEST_IDS.PROJECT_TEST,
-        sectionId: null,
-        parentId: null,
-        labels: [],
-        duration: null,
-        responsibleUid: null,
-        assignedByUid: null,
-        checked: false,
-        completedAt: null,
-        ...overrides,
-    };
-}
-/**
- * Common error messages used across tests.
- */
-export const TEST_ERRORS = {
-    API_RATE_LIMIT: 'API Error: Rate limit exceeded',
-    API_UNAUTHORIZED: 'API Error: Unauthorized',
-    INVALID_CURSOR: 'Invalid cursor format',
-    INVALID_FILTER: 'Invalid filter query',
-};
-/**
- * Creates multiple test cases for parameterized testing.
- */
-export function createTestCases(cases) {
-    return cases;
-}
-/**
- * Extracts the text content from a tool output for snapshot testing.
- * This allows tests to match against just the text content while tools return structured output.
- */
-export function extractTextContent(toolOutput) {
-    if (typeof toolOutput === 'string') {
-        return toolOutput;
-    }
-    if (typeof toolOutput === 'object' && toolOutput !== null && 'content' in toolOutput) {
-        const output = toolOutput;
-        if (Array.isArray(output.content) &&
-            output.content[0] &&
-            typeof output.content[0] === 'object' &&
-            output.content[0] !== null &&
-            'type' in output.content[0] &&
-            'text' in output.content[0] &&
-            output.content[0].type === 'text') {
-            return output.content[0].text;
-        }
-    }
-    throw new Error('Expected tool output to have text content');
-}
-/**
- * Extracts the structured content from a tool output for testing.
- * This handles both the new `structuredContent` field and legacy JSON-encoded content.
- */
-export function extractStructuredContent(output) {
-    // Check for new structuredContent field first
-    if ('structuredContent' in output && typeof output.structuredContent === 'object') {
-        return output.structuredContent;
-    }
-    // Fall back to checking for JSON content in the content array
-    if ('content' in output && Array.isArray(output.content)) {
-        for (const item of output.content) {
-            if (typeof item === 'object' &&
-                item !== null &&
-                'type' in item &&
-                'text' in item &&
-                item.type === 'text' &&
-                item.mimeType === 'application/json') {
-                return JSON.parse(item.text);
-            }
-        }
-    }
-    throw new Error('Expected tool output to have structured content');
-}
-/**
- * Common mock IDs used across tests for consistency.
- */
-export const TEST_IDS = {
-    TASK_1: '8485093748',
-    TASK_2: '8485093749',
-    TASK_3: '8485093750',
-    PROJECT_INBOX: 'inbox-project-id',
-    PROJECT_WORK: 'work-project-id',
-    PROJECT_TEST: '6cfCcrrCFg2xP94Q',
-    SECTION_1: 'section-123',
-    SECTION_2: 'section-456',
-    USER_ID: '713437',
-};
-/**
- * Fixed date for consistent test snapshots.
- * Use this instead of new Date() in tests to avoid snapshot drift.
- */
-export const TODAY = '2025-08-17';
-/**
- * Creates a mock CurrentUser with all required properties and sensible defaults.
- * Pass only the properties you want to override for your specific test.
- */
-export function createMockUser(overrides = {}) {
-    return {
-        id: TEST_IDS.USER_ID,
-        email: 'test@example.com',
-        fullName: 'Test User',
-        businessAccountId: null,
-        isPremium: false,
-        dateFormat: 0,
-        timeFormat: 0,
-        weeklyGoal: 5,
-        dailyGoal: 5,
-        completedCount: 0,
-        completedToday: 0,
-        daysOff: [],
-        inboxProjectId: TEST_IDS.PROJECT_INBOX,
-        karma: 0,
-        karmaTrend: 'up',
-        lang: 'en',
-        nextWeek: 1,
-        startDay: 1,
-        startPage: 'today',
-        weekendStartDay: 6,
-        tzInfo: {
-            timezone: 'UTC',
-            gmtString: '+00:00',
-            hours: 0,
-            minutes: 0,
-            isDst: 0,
-        },
-        avatarBig: null,
-        avatarMedium: null,
-        avatarS640: null,
-        avatarSmall: null,
-        ...overrides,
-    };
-}

package/dist/utils/tool-names.js

@@ -1,40 +0,0 @@
-/**
- * Centralized tool names module
- *
- * This module provides a single source of truth for all tool names used throughout the codebase.
- * Each tool should import its own name from this module to avoid hardcoded strings.
- * This prevents outdated references when tool names change.
- */
-export const ToolNames = {
-    // Task management tools
-    ADD_TASKS: 'add-tasks',
-    COMPLETE_TASKS: 'complete-tasks',
-    UPDATE_TASKS: 'update-tasks',
-    FIND_TASKS: 'find-tasks',
-    FIND_TASKS_BY_DATE: 'find-tasks-by-date',
-    FIND_COMPLETED_TASKS: 'find-completed-tasks',
-    // Project management tools
-    ADD_PROJECTS: 'add-projects',
-    UPDATE_PROJECTS: 'update-projects',
-    FIND_PROJECTS: 'find-projects',
-    // Section management tools
-    ADD_SECTIONS: 'add-sections',
-    UPDATE_SECTIONS: 'update-sections',
-    FIND_SECTIONS: 'find-sections',
-    // Comment management tools
-    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',
-    // Activity and audit tools
-    FIND_ACTIVITY: 'find-activity',
-    // General tools
-    GET_OVERVIEW: 'get-overview',
-    DELETE_OBJECT: 'delete-object',
-    USER_INFO: 'user-info',
-    // OpenAI MCP tools
-    SEARCH: 'search',
-    FETCH: 'fetch',
-};