@doist/todoist-ai 2.0.0 → 2.1.0

package/dist/tools/tasks-list-completed.d.ts

@@ -20,9 +20,9 @@ declare const tasksListCompleted: {
         until: string;
         parentId?: string | undefined;
         workspaceId?: string | undefined;
-        cursor?: string | undefined;
         projectId?: string | undefined;
         sectionId?: string | undefined;
+        cursor?: string | undefined;
     }, client: import("@doist/todoist-api-typescript").TodoistApi): Promise<{
         tasks: {
             id: string;
@@ -35,6 +35,7 @@ declare const tasksListCompleted: {
             sectionId: string | null;
             parentId: string | null;
             labels: string[];
+            duration: string | null;
         }[];
         nextCursor: string | null;
     }>;

package/dist/tools/tasks-list-completed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tasks-list-completed.d.ts","sourceRoot":"","sources":["../../src/tools/tasks-list-completed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAwCvB,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAekB,CAAA;AAE1C,OAAO,EAAE,kBAAkB,EAAE,CAAA"}
+{"version":3,"file":"tasks-list-completed.d.ts","sourceRoot":"","sources":["../../src/tools/tasks-list-completed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAwCvB,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAekB,CAAA;AAE1C,OAAO,EAAE,kBAAkB,EAAE,CAAA"}

package/dist/tools/tasks-list-completed.js

@@ -1,35 +1,32 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.tasksListCompleted = void 0;
-const zod_1 = require("zod");
-const tool_helpers_1 = require("../tool-helpers");
+import { z } from 'zod';
+import { mapTask } from '../tool-helpers.js';
 const ArgsSchema = {
-    getBy: zod_1.z
+    getBy: z
         .enum(['completion', 'due'])
         .default('completion')
         .describe('The method to use to get the tasks: "completion" to get tasks by completion date (ie, when the task was actually completed), "due" to get tasks by due date (ie, when the task was due to be completed by).'),
-    since: zod_1.z
+    since: z
         .string()
         .date()
         .regex(/^\d{4}-\d{2}-\d{2}$/)
         .describe('The start date to get the tasks for. Format: YYYY-MM-DD.'),
-    until: zod_1.z
+    until: z
         .string()
         .date()
         .regex(/^\d{4}-\d{2}-\d{2}$/)
         .describe('The start date to get the tasks for. Format: YYYY-MM-DD.'),
-    workspaceId: zod_1.z.string().optional().describe('The ID of the workspace to get the tasks for.'),
-    projectId: zod_1.z.string().optional().describe('The ID of the project to get the tasks for.'),
-    sectionId: zod_1.z.string().optional().describe('The ID of the section to get the tasks for.'),
-    parentId: zod_1.z.string().optional().describe('The ID of the parent task to get the tasks for.'),
-    limit: zod_1.z
+    workspaceId: z.string().optional().describe('The ID of the workspace to get the tasks for.'),
+    projectId: z.string().optional().describe('The ID of the project to get the tasks for.'),
+    sectionId: z.string().optional().describe('The ID of the section to get the tasks for.'),
+    parentId: z.string().optional().describe('The ID of the parent task to get the tasks for.'),
+    limit: z
         .number()
         .int()
         .min(1)
         .max(200)
         .default(50)
         .describe('The maximum number of tasks to return. Default is 50, maximum is 200.'),
-    cursor: zod_1.z
+    cursor: z
         .string()
         .optional()
         .describe('The cursor to get the next page of tasks (cursor is obtained from the previous call to this tool, with the same parameters).'),
@@ -44,9 +41,9 @@ const tasksListCompleted = {
             ? await client.getCompletedTasksByCompletionDate(rest)
             : await client.getCompletedTasksByDueDate(rest);
         return {
-            tasks: items.map(tool_helpers_1.mapTask),
+            tasks: items.map(mapTask),
             nextCursor,
         };
     },
 };
-exports.tasksListCompleted = tasksListCompleted;
+export { tasksListCompleted };

package/dist/tools/tasks-list-for-container.d.ts

@@ -25,6 +25,7 @@ declare const tasksListForContainer: {
             sectionId: string | null;
             parentId: string | null;
             labels: string[];
+            duration: string | null;
         }[];
         nextCursor: string | null;
     }>;

package/dist/tools/tasks-list-for-container.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tasks-list-for-container.d.ts","sourceRoot":"","sources":["../../src/tools/tasks-list-for-container.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAwBvB,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+Be,CAAA;AAE1C,OAAO,EAAE,qBAAqB,EAAE,CAAA"}
+{"version":3,"file":"tasks-list-for-container.d.ts","sourceRoot":"","sources":["../../src/tools/tasks-list-for-container.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAwBvB,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+Be,CAAA;AAE1C,OAAO,EAAE,qBAAqB,EAAE,CAAA"}

package/dist/tools/tasks-list-for-container.js

@@ -1,21 +1,18 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.tasksListForContainer = void 0;
-const zod_1 = require("zod");
-const tool_helpers_1 = require("../tool-helpers");
+import { z } from 'zod';
+import { mapTask } from '../tool-helpers.js';
 const ArgsSchema = {
-    type: zod_1.z
+    type: z
         .enum(['project', 'section', 'parent'])
         .describe('The type of container to get tasks for.'),
-    id: zod_1.z.string().min(1).describe('The ID of the container to get tasks for.'),
-    limit: zod_1.z
+    id: z.string().min(1).describe('The ID of the container to get tasks for.'),
+    limit: z
         .number()
         .int()
         .min(1)
         .max(50)
         .default(10)
         .describe('The maximum number of tasks to return.'),
-    cursor: zod_1.z
+    cursor: z
         .string()
         .optional()
         .describe('The cursor to get the next page of tasks (cursor is obtained from the previous call to this tool, with the same parameters).'),
@@ -43,9 +40,9 @@ const tasksListForContainer = {
         }
         const { results, nextCursor } = await client.getTasks(taskParams);
         return {
-            tasks: results.map(tool_helpers_1.mapTask),
+            tasks: results.map(mapTask),
             nextCursor,
         };
     },
 };
-exports.tasksListForContainer = tasksListForContainer;
+export { tasksListForContainer };

package/dist/tools/tasks-organize-multiple.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tasks-organize-multiple.d.ts","sourceRoot":"","sources":["../../src/tools/tasks-organize-multiple.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAevB,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAYe,CAAA;AAE1C,OAAO,EAAE,qBAAqB,EAAE,CAAA"}
+{"version":3,"file":"tasks-organize-multiple.d.ts","sourceRoot":"","sources":["../../src/tools/tasks-organize-multiple.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAgBvB,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwBe,CAAA;AAE1C,OAAO,EAAE,qBAAqB,EAAE,CAAA"}

package/dist/tools/tasks-organize-multiple.js

@@ -1,16 +1,14 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.tasksOrganizeMultiple = void 0;
-const zod_1 = require("zod");
-const TaskUpdateSchema = zod_1.z.object({
-    id: zod_1.z.string().min(1).describe('The ID of the task to update.'),
-    projectId: zod_1.z.string().optional().describe('The new project ID for the task.'),
-    sectionId: zod_1.z.string().optional().describe('The new section ID for the task.'),
-    parentId: zod_1.z.string().optional().describe('The new parent task ID (for subtasks).'),
-    order: zod_1.z.number().optional().describe('The new order of the task within its parent/section.'),
+import { z } from 'zod';
+import { createMoveTaskArgs } from '../tool-helpers.js';
+const TaskUpdateSchema = z.object({
+    id: z.string().min(1).describe('The ID of the task to update.'),
+    projectId: z.string().optional().describe('The new project ID for the task.'),
+    sectionId: z.string().optional().describe('The new section ID for the task.'),
+    parentId: z.string().optional().describe('The new parent task ID (for subtasks).'),
+    order: z.number().optional().describe('The new order of the task within its parent/section.'),
 });
 const ArgsSchema = {
-    tasks: zod_1.z.array(TaskUpdateSchema).min(1).describe('Array of task updates to apply.'),
+    tasks: z.array(TaskUpdateSchema).min(1).describe('Array of task updates to apply.'),
 };
 const tasksOrganizeMultiple = {
     name: 'tasks-organize-multiple',
@@ -18,11 +16,19 @@ const tasksOrganizeMultiple = {
     parameters: ArgsSchema,
     async execute(args, client) {
         const results = [];
+        // Process each task individually for move operations
         for (const update of args.tasks) {
-            const { id, ...updateArgs } = update;
-            results.push(await client.updateTask(id, updateArgs));
+            const { id, projectId, sectionId, parentId } = update;
+            if (!projectId && !sectionId && !parentId) {
+                continue;
+            }
+            // Create and validate move arguments using helper
+            const moveArgs = createMoveTaskArgs(id, projectId, sectionId, parentId);
+            // Move each task individually to avoid bulk operation issues
+            const movedTasks = await client.moveTasks([id], moveArgs);
+            results.push(...movedTasks);
         }
         return results;
     },
 };
-exports.tasksOrganizeMultiple = tasksOrganizeMultiple;
+export { tasksOrganizeMultiple };

package/dist/tools/tasks-search.d.ts

@@ -23,6 +23,7 @@ declare const tasksSearch: {
             sectionId: string | null;
             parentId: string | null;
             labels: string[];
+            duration: string | null;
         }[];
         nextCursor: string | null;
     }>;

package/dist/tools/tasks-search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tasks-search.d.ts","sourceRoot":"","sources":["../../src/tools/tasks-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAqBvB,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;CAYyB,CAAA;AAE1C,OAAO,EAAE,WAAW,EAAE,CAAA"}
+{"version":3,"file":"tasks-search.d.ts","sourceRoot":"","sources":["../../src/tools/tasks-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAqBvB,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAYyB,CAAA;AAE1C,OAAO,EAAE,WAAW,EAAE,CAAA"}

package/dist/tools/tasks-search.js

@@ -1,18 +1,15 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.tasksSearch = void 0;
-const zod_1 = require("zod");
-const tool_helpers_1 = require("../tool-helpers");
+import { z } from 'zod';
+import { getTasksByFilter } from '../tool-helpers.js';
 const ArgsSchema = {
-    searchText: zod_1.z.string().min(1).describe('The text to search for in tasks.'),
-    limit: zod_1.z
+    searchText: z.string().min(1).describe('The text to search for in tasks.'),
+    limit: z
         .number()
         .int()
         .min(1)
         .max(50)
         .default(10)
         .describe('The maximum number of tasks to return.'),
-    cursor: zod_1.z
+    cursor: z
         .string()
         .optional()
         .describe('The cursor to get the next page of tasks (cursor is obtained from the previous call to this tool, with the same parameters).'),
@@ -22,7 +19,7 @@ const tasksSearch = {
     description: "Search tasks by text using Todoist's filter query.",
     parameters: ArgsSchema,
     async execute(args, client) {
-        return await (0, tool_helpers_1.getTasksByFilter)({
+        return await getTasksByFilter({
             client,
             query: `search: ${args.searchText}`,
             cursor: args.cursor,
@@ -30,4 +27,4 @@ const tasksSearch = {
         });
     },
 };
-exports.tasksSearch = tasksSearch;
+export { tasksSearch };

package/dist/tools/tasks-update-one.d.ts

@@ -11,6 +11,7 @@ declare const tasksUpdateOne: {
         parentId: z.ZodOptional<z.ZodString>;
         priority: z.ZodOptional<z.ZodNumber>;
         dueString: z.ZodOptional<z.ZodString>;
+        duration: z.ZodOptional<z.ZodString>;
     };
     execute(args: {
         id: string;
@@ -18,10 +19,11 @@ declare const tasksUpdateOne: {
         description?: string | undefined;
         parentId?: string | undefined;
         projectId?: string | undefined;
+        sectionId?: string | undefined;
         priority?: number | undefined;
         dueString?: string | undefined;
-        sectionId?: string | undefined;
-    }, client: import("@doist/todoist-api-typescript").TodoistApi): Promise<import("@doist/todoist-api-typescript").Task>;
+        duration?: string | undefined;
+    }, client: import("@doist/todoist-api-typescript").TodoistApi): Promise<import("@doist/todoist-api-typescript").Task | undefined>;
 };
 export { tasksUpdateOne };
 //# sourceMappingURL=tasks-update-one.d.ts.map

package/dist/tools/tasks-update-one.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tasks-update-one.d.ts","sourceRoot":"","sources":["../../src/tools/tasks-update-one.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAuBvB,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;CAQsB,CAAA;AAE1C,OAAO,EAAE,cAAc,EAAE,CAAA"}
+{"version":3,"file":"tasks-update-one.d.ts","sourceRoot":"","sources":["../../src/tools/tasks-update-one.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA+BvB,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;CA+CsB,CAAA;AAE1C,OAAO,EAAE,cAAc,EAAE,CAAA"}

package/dist/tools/tasks-update-one.js

@@ -1,33 +1,63 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.tasksUpdateOne = void 0;
-const zod_1 = require("zod");
+import { z } from 'zod';
+import { createMoveTaskArgs } from '../tool-helpers.js';
+import { DurationParseError, parseDuration } from '../utils/duration-parser.js';
 const ArgsSchema = {
-    id: zod_1.z.string().min(1).describe('The ID of the task to update.'),
-    content: zod_1.z.string().optional().describe('The new content of the task.'),
-    description: zod_1.z.string().optional().describe('The new description of the task.'),
-    projectId: zod_1.z.string().optional().describe('The new project ID for the task.'),
-    sectionId: zod_1.z.string().optional().describe('The new section ID for the task.'),
-    parentId: zod_1.z.string().optional().describe('The new parent task ID (for subtasks).'),
-    priority: zod_1.z
+    id: z.string().min(1).describe('The ID of the task to update.'),
+    content: z.string().optional().describe('The new content of the task.'),
+    description: z.string().optional().describe('The new description of the task.'),
+    projectId: z.string().optional().describe('The new project ID for the task.'),
+    sectionId: z.string().optional().describe('The new section ID for the task.'),
+    parentId: z.string().optional().describe('The new parent task ID (for subtasks).'),
+    priority: z
         .number()
         .int()
         .min(1)
         .max(4)
         .optional()
         .describe('The new priority of the task (1-4).'),
-    dueString: zod_1.z
+    dueString: z
         .string()
         .optional()
         .describe("The new due date for the task, in natural language (e.g., 'tomorrow at 5pm')."),
+    duration: z
+        .string()
+        .optional()
+        .describe('The duration of the task. Use format: "2h" (hours), "90m" (minutes), "2h30m" (combined), or "1.5h" (decimal hours). Max 24h.'),
 };
 const tasksUpdateOne = {
     name: 'tasks-update-one',
     description: 'Update an existing task with new values.',
     parameters: ArgsSchema,
     async execute(args, client) {
-        const { id, ...updateArgs } = args;
-        return await client.updateTask(id, updateArgs);
+        const { id, projectId, sectionId, parentId, duration: durationStr, ...otherUpdateArgs } = args;
+        let updateArgs = { ...otherUpdateArgs };
+        // Parse duration if provided
+        if (durationStr) {
+            try {
+                const { minutes } = parseDuration(durationStr);
+                updateArgs = {
+                    ...updateArgs,
+                    duration: minutes,
+                    durationUnit: 'minute',
+                };
+            }
+            catch (error) {
+                if (error instanceof DurationParseError) {
+                    throw new Error(`Task ${id}: ${error.message}`);
+                }
+                throw error;
+            }
+        }
+        // If no move parameters are provided, use updateTask without moveTasks
+        if (!projectId && !sectionId && !parentId) {
+            return await client.updateTask(id, updateArgs);
+        }
+        const moveArgs = createMoveTaskArgs(id, projectId, sectionId, parentId);
+        const movedTasks = await client.moveTasks([id], moveArgs);
+        if (Object.keys(updateArgs).length > 0) {
+            return await client.updateTask(id, updateArgs);
+        }
+        return movedTasks[0];
     },
 };
-exports.tasksUpdateOne = tasksUpdateOne;
+export { tasksUpdateOne };

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

@@ -0,0 +1,80 @@
+import type { PersonalProject, Section, Task } from '@doist/todoist-api-typescript';
+/**
+ * Mapped task type matching the output of mapTask function.
+ * Used for filter-based query test mocks.
+ */
+export type MappedTask = {
+    id: string;
+    content: string;
+    description: string;
+    dueDate: string | undefined;
+    recurring: string | boolean;
+    priority: number;
+    projectId: string;
+    sectionId: string | null;
+    parentId: string | null;
+    labels: string[];
+    duration: string | null;
+};
+/**
+ * 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(overrides?: Partial<Task>): 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 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 SECTION_1: "section-123";
+    readonly SECTION_2: "section-456";
+    readonly USER_ID: "713437";
+};
+//# sourceMappingURL=test-helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../../src/tools/test-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAA;AAEnF;;;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;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;CAUX,CAAA"}

package/dist/tools/test-helpers.js

@@ -0,0 +1,140 @@
+/**
+ * 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',
+        ...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,
+        priority: 1,
+        projectId: TEST_IDS.PROJECT_TEST,
+        sectionId: null,
+        parentId: null,
+        labels: [],
+        duration: 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;
+}
+/**
+ * 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',
+};

package/dist/utils/duration-parser.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Duration parser utility for converting human-readable duration strings
+ * to minutes using a restricted, language-neutral syntax.
+ *
+ * Supported formats:
+ * - "2h" (hours only)
+ * - "90m" (minutes only)
+ * - "2h30m" (hours + minutes)
+ * - "1.5h" (decimal hours)
+ * - Supports optional spaces: "2h 30m"
+ */
+interface ParsedDuration {
+    minutes: number;
+}
+export declare class DurationParseError extends Error {
+    constructor(input: string, reason: string);
+}
+/**
+ * Parses duration string in restricted syntax to minutes.
+ * Max duration: 1440 minutes (24 hours)
+ *
+ * @param durationStr - Duration string like "2h30m", "45m", "1.5h"
+ * @returns Parsed duration in minutes
+ * @throws DurationParseError for invalid formats
+ */
+export declare function parseDuration(durationStr: string): ParsedDuration;
+/**
+ * Formats minutes back to a human-readable duration string.
+ * Used when returning task data to LLMs.
+ *
+ * @param minutes - Duration in minutes
+ * @returns Formatted duration string like "2h30m" or "45m"
+ */
+export declare function formatDuration(minutes: number): string;
+export {};
+//# sourceMappingURL=duration-parser.d.ts.map

package/dist/utils/duration-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration-parser.d.ts","sourceRoot":"","sources":["../../src/utils/duration-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,UAAU,cAAc;IACpB,OAAO,EAAE,MAAM,CAAA;CAClB;AAED,qBAAa,kBAAmB,SAAQ,KAAK;gBAC7B,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAI5C;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAgEjE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAetD"}