@doist/todoist-ai 8.7.0 → 8.7.2

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

@@ -0,0 +1,91 @@
+import { CurrentUser, Label, PersonalProject, Section, Task, WorkspaceProject } from '@doist/todoist-api-typescript';
+import { MappedTask } from '../tool-helpers';
+import { Priority } from './priorities';
+type TaskWithUserFacingPriority = Omit<Task, 'priority'> & {
+    priority: Priority;
+};
+/**
+ * Creates a mock Task with all required properties and sensible defaults.
+ * Pass only the properties you want to override for your specific test.
+ */
+export declare function createMockTask({ priority, ...overrides }?: Partial<TaskWithUserFacingPriority>): Task;
+/**
+ * Creates a mock Section with all required properties and sensible defaults.
+ * Pass only the properties you want to override for your specific test.
+ */
+export declare function createMockSection(overrides?: Partial<Section>): Section;
+/**
+ * Creates a mock PersonalProject with all required properties and sensible defaults.
+ * Pass only the properties you want to override for your specific test.
+ */
+export declare function createMockProject(overrides?: Partial<PersonalProject>): PersonalProject;
+/**
+ * Creates a mock WorkspaceProject with all required properties and sensible defaults.
+ * Pass only the properties you want to override for your specific test.
+ */
+export declare function createMockWorkspaceProject(overrides?: Partial<WorkspaceProject>): WorkspaceProject;
+/**
+ * Creates a mock Label with all required properties and sensible defaults.
+ * Pass only the properties you want to override for your specific test.
+ */
+export declare function createMockLabel(overrides?: Partial<Label>): Label;
+/**
+ * Creates a mock API response object with results and nextCursor.
+ */
+export declare function createMockApiResponse<T>(results: T[], nextCursor?: string | null): {
+    results: T[];
+    nextCursor: string | null;
+};
+/**
+ * Creates a simplified mapped task (matches mapTask output) for filter-based query tests.
+ */
+export declare function createMappedTask(overrides?: Partial<MappedTask>): MappedTask;
+/**
+ * Common error messages used across tests.
+ */
+export declare const TEST_ERRORS: {
+    readonly API_RATE_LIMIT: "API Error: Rate limit exceeded";
+    readonly API_UNAUTHORIZED: "API Error: Unauthorized";
+    readonly INVALID_CURSOR: "Invalid cursor format";
+    readonly INVALID_FILTER: "Invalid filter query";
+};
+/**
+ * Creates multiple test cases for parameterized testing.
+ */
+export declare function createTestCases<T, E = unknown>(cases: Array<{
+    name: string;
+    input: T;
+    expected?: E;
+}>): {
+    name: string;
+    input: T;
+    expected?: E;
+}[];
+/**
+ * Common mock IDs used across tests for consistency.
+ */
+export declare const TEST_IDS: {
+    readonly TASK_1: "8485093748";
+    readonly TASK_2: "8485093749";
+    readonly TASK_3: "8485093750";
+    readonly PROJECT_INBOX: "inbox-project-id";
+    readonly PROJECT_WORK: "work-project-id";
+    readonly PROJECT_TEST: "6cfCcrrCFg2xP94Q";
+    readonly PROJECT_WORKSPACE: "workspace-project-id";
+    readonly SECTION_1: "section-123";
+    readonly SECTION_2: "section-456";
+    readonly USER_ID: "713437";
+    readonly WORKSPACE_1: "workspace-123";
+};
+/**
+ * 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";
+/**
+ * Creates a mock CurrentUser with all required properties and sensible defaults.
+ * Pass only the properties you want to override for your specific test.
+ */
+export declare function createMockUser(overrides?: Partial<CurrentUser>): CurrentUser;
+export {};
+//# 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,EACR,WAAW,EACX,KAAK,EACL,eAAe,EACf,OAAO,EACP,IAAI,EACJ,gBAAgB,EACnB,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAA2B,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAA;AAErE,KAAK,0BAA0B,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,GAAG;IACvD,QAAQ,EAAE,QAAQ,CAAA;CACrB,CAAA;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAC3B,QAAe,EACf,GAAG,SAAS,EACf,GAAE,OAAO,CAAC,0BAA0B,CAAM,GAAG,IAAI,CA6BjD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,GAAE,OAAO,CAAC,OAAO,CAAM,GAAG,OAAO,CAgB3E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,GAAE,OAAO,CAAC,eAAe,CAAM,GAAG,eAAe,CAuB3F;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACtC,SAAS,GAAE,OAAO,CAAC,gBAAgB,CAAM,GAC1C,gBAAgB,CA4BlB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,GAAE,OAAO,CAAC,KAAK,CAAM,GAAG,KAAK,CASrE;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,CAoBhF;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;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;CAYX,CAAA;AAEV;;;GAGG;AACH,eAAO,MAAM,KAAK,EAAG,YAAqB,CAAA;AAE1C;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,WAAW,CAoChF"}

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

@@ -0,0 +1,55 @@
+/**
+ * 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 UNCOMPLETE_TASKS: "uncomplete-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 RESCHEDULE_TASKS: "reschedule-tasks";
+    readonly ADD_PROJECTS: "add-projects";
+    readonly UPDATE_PROJECTS: "update-projects";
+    readonly FIND_PROJECTS: "find-projects";
+    readonly PROJECT_MANAGEMENT: "project-management";
+    readonly PROJECT_MOVE: "project-move";
+    readonly ADD_SECTIONS: "add-sections";
+    readonly UPDATE_SECTIONS: "update-sections";
+    readonly FIND_SECTIONS: "find-sections";
+    readonly ADD_COMMENTS: "add-comments";
+    readonly UPDATE_COMMENTS: "update-comments";
+    readonly FIND_COMMENTS: "find-comments";
+    readonly ADD_REMINDERS: "add-reminders";
+    readonly UPDATE_REMINDERS: "update-reminders";
+    readonly FIND_REMINDERS: "find-reminders";
+    readonly VIEW_ATTACHMENT: "view-attachment";
+    readonly FIND_PROJECT_COLLABORATORS: "find-project-collaborators";
+    readonly MANAGE_ASSIGNMENTS: "manage-assignments";
+    readonly FIND_ACTIVITY: "find-activity";
+    readonly GET_PRODUCTIVITY_STATS: "get-productivity-stats";
+    readonly GET_PROJECT_HEALTH: "get-project-health";
+    readonly GET_PROJECT_ACTIVITY_STATS: "get-project-activity-stats";
+    readonly ANALYZE_PROJECT_HEALTH: "analyze-project-health";
+    readonly GET_WORKSPACE_INSIGHTS: "get-workspace-insights";
+    readonly GET_OVERVIEW: "get-overview";
+    readonly DELETE_OBJECT: "delete-object";
+    readonly FETCH_OBJECT: "fetch-object";
+    readonly REORDER_OBJECTS: "reorder-objects";
+    readonly USER_INFO: "user-info";
+    readonly ADD_LABELS: "add-labels";
+    readonly FIND_LABELS: "find-labels";
+    readonly FIND_FILTERS: "find-filters";
+    readonly ADD_FILTERS: "add-filters";
+    readonly UPDATE_FILTERS: "update-filters";
+    readonly LIST_WORKSPACES: "list-workspaces";
+    readonly SEARCH: "search";
+    readonly FETCH: "fetch";
+};
+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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwEZ,CAAA;AAGV,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAA"}

package/dist/utils/user-resolver.d.ts

@@ -0,0 +1,39 @@
+import { TodoistApi } from '@doist/todoist-api-typescript';
+export type ResolvedUser = {
+    userId: string;
+    displayName: string;
+    email: string;
+};
+export type ProjectCollaborator = {
+    id: string;
+    name: string;
+    email: string;
+};
+/** Keyword that resolves to the current authenticated user. */
+export declare const SELF_USER_KEYWORD: "me";
+export declare class UserResolver {
+    /**
+     * Resolve a user name or ID to a user ID by looking up collaborators across all shared projects.
+     * Supports exact name matches, partial matches, email matches, and the "me" keyword.
+     */
+    resolveUser(client: TodoistApi, nameOrId: string): Promise<ResolvedUser | null>;
+    /**
+     * Validate that a user is a collaborator on a specific project
+     */
+    validateProjectCollaborator(client: TodoistApi, projectId: string, userId: string): Promise<boolean>;
+    /**
+     * Get collaborators for a specific project
+     */
+    getProjectCollaborators(client: TodoistApi, projectId: string): Promise<ProjectCollaborator[]>;
+    /**
+     * Get all collaborators from all shared projects
+     */
+    private getAllCollaborators;
+    /**
+     * Clear all caches - useful for testing
+     */
+    clearCache(): void;
+}
+export declare const userResolver: UserResolver;
+export declare function resolveUserNameToId(client: TodoistApi, nameOrId: string): Promise<ResolvedUser | null>;
+//# sourceMappingURL=user-resolver.d.ts.map

package/dist/utils/user-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/user-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAA;AAE/D,MAAM,MAAM,YAAY,GAAG;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CAChB,CAAA;AAsBD,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,EAAG,IAAa,CAAA;AAE9C,qBAAa,YAAY;IACrB;;;OAGG;IACG,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IA+HrF;;OAEG;IACG,2BAA2B,CAC7B,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC;IASnB;;OAEG;IACG,uBAAuB,CACzB,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,mBAAmB,EAAE,CAAC;IA2BjC;;OAEG;YACW,mBAAmB;IAqDjC;;OAEG;IACH,UAAU,IAAI,IAAI;CAIrB;AAGD,eAAO,MAAM,YAAY,cAAqB,CAAA;AAG9C,wBAAsB,mBAAmB,CACrC,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAE9B"}

package/dist/utils/workspace-resolver.d.ts

@@ -0,0 +1,31 @@
+import { TodoistApi } from '@doist/todoist-api-typescript';
+export type ResolvedWorkspace = {
+    workspaceId: string;
+    workspaceName: string;
+};
+/**
+ * Check if a string looks like a workspace ID (purely numeric).
+ */
+export declare function looksLikeWorkspaceId(ref: string): boolean;
+export declare class WorkspaceResolver {
+    private cache;
+    private getWorkspaces;
+    /**
+     * Resolve a workspace name or ID to a workspace ID and name.
+     *
+     * Resolution order:
+     * 1. Exact ID match (always tried first for any input)
+     * 2. If input looks like an ID (numeric) but wasn't found, pass through as-is (API validates)
+     * 3. Exact case-insensitive name match
+     * 4. Unique partial case-insensitive name match
+     * 5. Multiple partial matches → throw ambiguous error
+     * 6. No match → throw not-found error
+     */
+    resolveWorkspace(client: TodoistApi, nameOrId: string): Promise<ResolvedWorkspace>;
+    /**
+     * Clear the workspace cache — useful for testing.
+     */
+    clearCache(): void;
+}
+export declare const workspaceResolver: WorkspaceResolver;
+//# sourceMappingURL=workspace-resolver.d.ts.map

package/dist/utils/workspace-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/workspace-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,+BAA+B,CAAA;AAE1E,MAAM,MAAM,iBAAiB,GAAG;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;CACxB,CAAA;AAID;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,KAAK,CAA8D;YAE7D,aAAa;IAU3B;;;;;;;;;;OAUG;IACG,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAsDxF;;OAEG;IACH,UAAU,IAAI,IAAI;CAGrB;AAGD,eAAO,MAAM,iBAAiB,mBAA0B,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@doist/todoist-ai",
-    "version": "8.7.0",
+    "version": "8.7.2",
     "type": "module",
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",
@@ -63,7 +63,7 @@
         "prepare": "husky"
     },
     "dependencies": {
-        "@doist/todoist-api-typescript": "7.8.0",
+        "@doist/todoist-api-typescript": "7.9.1",
         "@modelcontextprotocol/ext-apps": "1.2.2",
         "date-fns": "4.1.0",
         "dompurify": "3.3.3",