@doist/todoist-ai 2.2.2 → 3.0.0

package/dist/utils/constants.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Application-wide constants
+ *
+ * This module centralizes magic numbers and configuration values
+ * to improve maintainability and provide a single source of truth.
+ */
+export declare const ApiLimits: {
+    /** Default limit for task listings */
+    readonly TASKS_DEFAULT: 10;
+    /** Maximum limit for task search and list operations */
+    readonly TASKS_MAX: 50;
+    /** Default limit for completed tasks */
+    readonly COMPLETED_TASKS_DEFAULT: 50;
+    /** Maximum limit for completed tasks */
+    readonly COMPLETED_TASKS_MAX: 200;
+    /** Default limit for project listings */
+    readonly PROJECTS_DEFAULT: 50;
+    /** Maximum limit for project listings */
+    readonly PROJECTS_MAX: 100;
+    /** Batch size for fetching all tasks in a project */
+    readonly TASKS_BATCH_SIZE: 50;
+};
+export declare const DisplayLimits: {
+    /** Maximum number of failures to show in detailed error messages */
+    readonly MAX_FAILURES_SHOWN: 3;
+    /** Threshold for suggesting batch operations */
+    readonly BATCH_OPERATION_THRESHOLD: 10;
+};
+export declare const ResponseConfig: {
+    /** Maximum characters per line in text responses */
+    readonly MAX_LINE_LENGTH: 100;
+    /** Indentation for nested items */
+    readonly INDENT_SIZE: 2;
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/utils/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,eAAO,MAAM,SAAS;IAClB,sCAAsC;;IAEtC,wDAAwD;;IAExD,wCAAwC;;IAExC,wCAAwC;;IAExC,yCAAyC;;IAEzC,yCAAyC;;IAEzC,qDAAqD;;CAE/C,CAAA;AAGV,eAAO,MAAM,aAAa;IACtB,oEAAoE;;IAEpE,gDAAgD;;CAE1C,CAAA;AAGV,eAAO,MAAM,cAAc;IACvB,oDAAoD;;IAEpD,mCAAmC;;CAE7B,CAAA"}

package/dist/utils/constants.js

@@ -0,0 +1,37 @@
+/**
+ * Application-wide constants
+ *
+ * This module centralizes magic numbers and configuration values
+ * to improve maintainability and provide a single source of truth.
+ */
+// API Pagination Limits
+export const ApiLimits = {
+    /** Default limit for task listings */
+    TASKS_DEFAULT: 10,
+    /** Maximum limit for task search and list operations */
+    TASKS_MAX: 50,
+    /** Default limit for completed tasks */
+    COMPLETED_TASKS_DEFAULT: 50,
+    /** Maximum limit for completed tasks */
+    COMPLETED_TASKS_MAX: 200,
+    /** Default limit for project listings */
+    PROJECTS_DEFAULT: 50,
+    /** Maximum limit for project listings */
+    PROJECTS_MAX: 100,
+    /** Batch size for fetching all tasks in a project */
+    TASKS_BATCH_SIZE: 50,
+};
+// UI Display Limits
+export const DisplayLimits = {
+    /** Maximum number of failures to show in detailed error messages */
+    MAX_FAILURES_SHOWN: 3,
+    /** Threshold for suggesting batch operations */
+    BATCH_OPERATION_THRESHOLD: 10,
+};
+// Response Builder Configuration
+export const ResponseConfig = {
+    /** Maximum characters per line in text responses */
+    MAX_LINE_LENGTH: 100,
+    /** Indentation for nested items */
+    INDENT_SIZE: 2,
+};

package/dist/utils/response-builders.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Helper function to get date string in YYYY-MM-DD format
+ */
+export declare function getDateString(date?: Date): string;
+type TaskLike = {
+    id?: string;
+    content?: string;
+    title?: string;
+    dueDate?: string;
+    priority?: number;
+    projectName?: string;
+};
+type ProjectLike = {
+    id: string;
+    name: string;
+    color?: string;
+    isFavorite?: boolean;
+    isShared?: boolean;
+    parentId?: string | null;
+    inboxProject?: boolean;
+    viewStyle?: string;
+};
+type TaskOperationOptions = {
+    nextSteps?: string[];
+    context?: string;
+    showDetails?: boolean;
+};
+type BatchOperationParams = {
+    action: string;
+    success: number;
+    total: number;
+    successItems?: string[];
+    failures?: Array<{
+        item: string;
+        error: string;
+        code?: string;
+    }>;
+    nextSteps?: string[];
+};
+/**
+ * Creates concise, actionable summaries for task operations instead of raw JSON
+ */
+export declare function summarizeTaskOperation(action: string, tasks: TaskLike[], options?: TaskOperationOptions): string;
+/**
+ * Creates batch operation summaries with success/failure breakdown
+ */
+export declare function summarizeBatch(params: BatchOperationParams): string;
+/**
+ * Formats a single project-like object into a readable preview line
+ */
+export declare function formatProjectPreview(project: ProjectLike): string;
+/**
+ * Creates preview lines for task lists
+ */
+export declare function previewTasks(tasks: TaskLike[], limit?: number): string;
+interface SummarizeListParams {
+    subject: string;
+    count: number;
+    limit?: number;
+    nextCursor?: string;
+    filterHints?: string[];
+    previewLines?: string;
+    zeroReasonHints?: string[];
+    nextSteps?: string[];
+}
+/**
+ * Creates list summaries with counts, filters, and guidance
+ */
+export declare function summarizeList({ subject, count, limit, nextCursor, filterHints, previewLines, zeroReasonHints, nextSteps, }: SummarizeListParams): string;
+/**
+ * Formats next steps array into a consistent "Next:" section
+ * If nextCursor is provided, adds cursor instruction to the steps
+ */
+export declare function formatNextSteps(nextSteps: string[], nextCursor?: string): string;
+/**
+ * Helper to generate contextual next steps based on task operations
+ */
+export declare function generateTaskNextSteps(operation: 'added' | 'updated' | 'listed' | 'completed' | 'organized', tasks: TaskLike[], context?: {
+    hasToday?: boolean;
+    hasOverdue?: boolean;
+    hasHighPriority?: boolean;
+    projectName?: string;
+    count?: number;
+    timeOfDay?: 'morning' | 'afternoon' | 'evening';
+    isEmptyResult?: boolean;
+}): string[];
+export {};
+//# sourceMappingURL=response-builders.d.ts.map

package/dist/utils/response-builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-builders.d.ts","sourceRoot":"","sources":["../../src/utils/response-builders.ts"],"names":[],"mappings":"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"}

package/dist/utils/response-builders.js

@@ -0,0 +1,202 @@
+import { DisplayLimits } from './constants.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 && task.priority < 4 ? ` • P${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) {
+    return tasks.slice(0, limit).map(formatTaskPreview).join('\n');
+}
+/**
+ * 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}('overdue') 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}('overdue') 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/{tools → utils}/test-helpers.d.ts

@@ -1,4 +1,5 @@
 import type { PersonalProject, Section, Task } from '@doist/todoist-api-typescript';
+import { getToolOutput } from '../mcp-helpers';
 /**
  * Mapped task type matching the output of mapTask function.
  * Used for filter-based query test mocks.
@@ -63,6 +64,16 @@ export declare function createTestCases<T, E = unknown>(cases: Array<{
     input: T;
     expected?: E;
 }[];
+/**
+ * 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 declare function extractTextContent(toolOutput: unknown): string;
+/**
+ * Extracts the structured content from a tool output for testing.
+ * This handles both the new `structuredContent` field and legacy JSON-encoded content.
+ */
+export declare function extractStructuredContent(output: ReturnType<typeof getToolOutput>): Record<string, unknown>;
 /**
  * Common mock IDs used across tests for consistency.
  */
@@ -77,4 +88,9 @@ export declare const TEST_IDS: {
     readonly SECTION_2: "section-456";
     readonly USER_ID: "713437";
 };
+/**
+ * Fixed date for consistent test snapshots.
+ * Use this instead of new Date() in tests to avoid snapshot drift.
+ */
+export declare const TODAY: "2025-08-17";
 //# sourceMappingURL=test-helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/test-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAA;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAE9C;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,SAAS,EAAE,MAAM,GAAG,OAAO,CAAA;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B,CAAA;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,GAAE,OAAO,CAAC,IAAI,CAAM,GAAG,IAAI,CA8BlE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,GAAE,OAAO,CAAC,OAAO,CAAM,GAAG,OAAO,CAe3E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,GAAE,OAAO,CAAC,eAAe,CAAM,GAAG,eAAe,CAuB3F;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACnC,OAAO,EAAE,CAAC,EAAE,EACZ,UAAU,GAAE,MAAM,GAAG,IAAW,GACjC;IACC,OAAO,EAAE,CAAC,EAAE,CAAA;IACZ,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B,CAKA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,GAAE,OAAO,CAAC,UAAU,CAAM,GAAG,UAAU,CAehF;AAED;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;CAKd,CAAA;AAEV;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,EAC1C,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;CAAE,CAAC;UAAjC,MAAM;WAAS,CAAC;eAAa,CAAC;IAGtD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,CAqB9D;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACpC,MAAM,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,GACzC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuBzB;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;CAUX,CAAA;AAEV;;;GAGG;AACH,eAAO,MAAM,KAAK,EAAG,YAAqB,CAAA"}

package/dist/{tools → utils}/test-helpers.js

@@ -124,6 +124,52 @@ export const TEST_ERRORS = {
 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.
  */
@@ -138,3 +184,8 @@ export const TEST_IDS = {
     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';

package/dist/utils/tool-names.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 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 declare const ToolNames: {
+    readonly ADD_TASKS: "add-tasks";
+    readonly COMPLETE_TASKS: "complete-tasks";
+    readonly UPDATE_TASKS: "update-tasks";
+    readonly FIND_TASKS: "find-tasks";
+    readonly FIND_TASKS_BY_DATE: "find-tasks-by-date";
+    readonly FIND_COMPLETED_TASKS: "find-completed-tasks";
+    readonly FIND_PROJECTS: "find-projects";
+    readonly MANAGE_PROJECTS: "manage-projects";
+    readonly FIND_SECTIONS: "find-sections";
+    readonly MANAGE_SECTIONS: "manage-sections";
+    readonly GET_OVERVIEW: "get-overview";
+    readonly DELETE_OBJECT: "delete-object";
+};
+export type ToolName = (typeof ToolNames)[keyof typeof ToolNames];
+//# sourceMappingURL=tool-names.d.ts.map

package/dist/utils/tool-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-names.d.ts","sourceRoot":"","sources":["../../src/utils/tool-names.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;CAoBZ,CAAA;AAGV,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAA"}

package/dist/utils/tool-names.js

@@ -0,0 +1,25 @@
+/**
+ * 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
+    FIND_PROJECTS: 'find-projects',
+    MANAGE_PROJECTS: 'manage-projects',
+    // Section management tools
+    FIND_SECTIONS: 'find-sections',
+    MANAGE_SECTIONS: 'manage-sections',
+    // General tools
+    GET_OVERVIEW: 'get-overview',
+    DELETE_OBJECT: 'delete-object',
+};

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@doist/todoist-ai",
-    "version": "2.2.2",
+    "version": "3.0.0",
     "type": "module",
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",

package/dist/tools/__tests__/delete-one.test.d.ts

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

package/dist/tools/__tests__/delete-one.test.d.ts.map

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

package/dist/tools/__tests__/overview.test.d.ts

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

package/dist/tools/__tests__/overview.test.d.ts.map

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

package/dist/tools/__tests__/projects-list.test.d.ts

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

package/dist/tools/__tests__/projects-list.test.d.ts.map

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

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

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

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

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

package/dist/tools/__tests__/sections-manage.test.d.ts

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

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

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