@doist/todoist-ai 0.1.0 → 0.1.2

package/dist/cjs/tools/sections-update-one.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sectionsUpdateOne = void 0;
+const zod_1 = require("zod");
+const ArgsSchema = {
+    id: zod_1.z.string().min(1).describe("The ID of the section to update."),
+    name: zod_1.z.string().min(1).describe("The new name for the section."),
+};
+const sectionsUpdateOne = {
+    name: "sections-update-one",
+    description: "Update a section's name by its ID.",
+    parameters: ArgsSchema,
+    async execute(args, client) {
+        const { id, name } = args;
+        const section = await client.updateSection(id, { name });
+        return section;
+    },
+};
+exports.sectionsUpdateOne = sectionsUpdateOne;

package/dist/cjs/tools/shared.js

@@ -0,0 +1,78 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTasksByFilter = getTasksByFilter;
+exports.mapTask = mapTask;
+exports.mapProject = mapProject;
+const todoist_api_typescript_1 = require("@doist/todoist-api-typescript");
+const zod_1 = __importDefault(require("zod"));
+/**
+ * Map a single Todoist task to a more structured format, for LLM consumption.
+ * @param task - The task to map.
+ * @returns The mapped task.
+ */
+function mapTask(task) {
+    return {
+        id: task.id,
+        content: (0, todoist_api_typescript_1.getSanitizedContent)(task.content),
+        description: (0, todoist_api_typescript_1.getSanitizedContent)(task.description),
+        dueDate: task.due?.date,
+        recurring: task.due?.isRecurring && task.due.string ? task.due.string : false,
+        priority: task.priority,
+        projectId: task.projectId,
+        sectionId: task.sectionId,
+        parentId: task.parentId,
+        labels: task.labels,
+    };
+}
+/**
+ * Map a single Todoist project to a more structured format, for LLM consumption.
+ * @param project - The project to map.
+ * @returns The mapped project.
+ */
+function mapProject(project) {
+    return {
+        id: project.id,
+        name: project.name,
+        color: project.color,
+        isFavorite: project.isFavorite,
+        isShared: project.isShared,
+        parentId: project.parentId ?? null,
+        inboxProject: project.isInboxProject ?? false,
+        viewStyle: project.viewStyle,
+    };
+}
+const ErrorSchema = zod_1.default.object({
+    httpStatusCode: zod_1.default.number(),
+    responseData: zod_1.default.object({
+        error: zod_1.default.string(),
+        errorCode: zod_1.default.number(),
+        errorTag: zod_1.default.string(),
+    }),
+});
+async function getTasksByFilter({ client, query, limit, cursor, }) {
+    try {
+        const { results, nextCursor } = await client.getTasksByFilter({
+            query,
+            cursor,
+            limit,
+        });
+        return {
+            tasks: results.map(mapTask),
+            nextCursor,
+        };
+    }
+    catch (error) {
+        const parsedError = ErrorSchema.safeParse(error);
+        if (!parsedError.success) {
+            throw error;
+        }
+        const { responseData } = parsedError.data;
+        if (responseData.errorTag === "INVALID_SEARCH_QUERY") {
+            throw new Error(`Invalid filter query: ${query}`);
+        }
+        throw new Error(`${responseData.error} (tag: ${responseData.errorTag}, code: ${responseData.errorCode})`);
+    }
+}

package/dist/cjs/tools/subtasks-list-for-parent-task.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.subtasksListForParentTask = void 0;
+const zod_1 = require("zod");
+const shared_js_1 = require("./shared.js");
+const ArgsSchema = {
+    parentId: zod_1.z
+        .string()
+        .min(1)
+        .describe("The ID of the parent task to get subtasks for."),
+    limit: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .default(10)
+        .describe("The maximum number of subtasks to return."),
+    cursor: zod_1.z
+        .string()
+        .optional()
+        .describe("The cursor to get the next page of subtasks (from previous call)."),
+};
+const subtasksListForParentTask = {
+    name: "subtasks-list-for-parent-task",
+    description: "List subtasks for a given parent task.",
+    parameters: ArgsSchema,
+    async execute(args, client) {
+        const { parentId, limit, cursor } = args;
+        const { results, nextCursor } = await client.getTasks({
+            parentId,
+            limit,
+            cursor: cursor ?? null,
+        });
+        return {
+            tasks: results.map(shared_js_1.mapTask),
+            nextCursor,
+        };
+    },
+};
+exports.subtasksListForParentTask = subtasksListForParentTask;

package/dist/cjs/tools/tasks-add-multiple.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tasksAddMultiple = void 0;
+const zod_1 = require("zod");
+const shared_js_1 = require("./shared.js");
+const TaskSchema = zod_1.z.object({
+    content: zod_1.z.string().min(1).describe("The content of the task to create."),
+    description: zod_1.z.string().optional().describe("The description of the task."),
+    priority: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .max(4)
+        .optional()
+        .describe("The priority of the task (1-4)."),
+    dueString: zod_1.z
+        .string()
+        .optional()
+        .describe("The due date for the task, in natural language."),
+});
+const ArgsSchema = {
+    projectId: zod_1.z
+        .string()
+        .optional()
+        .describe("The project ID to add the tasks to."),
+    sectionId: zod_1.z
+        .string()
+        .optional()
+        .describe("The section ID to add the tasks to."),
+    parentId: zod_1.z
+        .string()
+        .optional()
+        .describe("The parent task ID (for subtasks)."),
+    tasks: zod_1.z.array(TaskSchema).min(1).describe("The array of tasks to add."),
+};
+const tasksAddMultiple = {
+    name: "tasks-add-multiple",
+    description: "Add one or more tasks to a project, section, or parent.",
+    parameters: ArgsSchema,
+    async execute(args, client) {
+        const { projectId, sectionId, parentId, tasks } = args;
+        const newTasks = [];
+        for (const task of tasks) {
+            const taskArgs = { ...task, projectId, sectionId, parentId };
+            newTasks.push(await client.addTask(taskArgs));
+        }
+        return newTasks.map(shared_js_1.mapTask);
+    },
+};
+exports.tasksAddMultiple = tasksAddMultiple;

package/dist/cjs/tools/tasks-by-date-range.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tasksListByDate = void 0;
+const date_fns_1 = require("date-fns");
+const zod_1 = require("zod");
+const shared_js_1 = require("./shared.js");
+const ArgsSchema = {
+    startDate: zod_1.z
+        .string()
+        .regex(/^(\d{4}-\d{2}-\d{2}|today)$/)
+        .describe("The start date to get the tasks for. Format: YYYY-MM-DD or 'today'."),
+    daysCount: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .max(30)
+        .default(1)
+        .describe("The number of days to get the tasks for, starting from the start date."),
+    limit: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .default(10)
+        .describe("The maximum number of tasks to return."),
+    cursor: zod_1.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)."),
+};
+const tasksListByDate = {
+    name: "tasks-list-by-date",
+    description: "Get tasks by date range.",
+    parameters: ArgsSchema,
+    async execute(args, client) {
+        const startDate = args.startDate === "today"
+            ? (0, date_fns_1.formatISO)(new Date(), { representation: "date" })
+            : args.startDate;
+        const endDate = (0, date_fns_1.addDays)(startDate, args.daysCount + 1);
+        const endDateStr = (0, date_fns_1.formatISO)(endDate, { representation: "date" });
+        const query = `(due after: ${startDate} | due: ${startDate}) & due before: ${endDateStr}`;
+        return await (0, shared_js_1.getTasksByFilter)({
+            client,
+            query,
+            cursor: args.cursor,
+            limit: args.limit,
+        });
+    },
+};
+exports.tasksListByDate = tasksListByDate;

package/dist/cjs/tools/tasks-by-project.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tasksListForProject = void 0;
+const zod_1 = require("zod");
+const shared_js_1 = require("./shared.js");
+const ArgsSchema = {
+    projectId: zod_1.z
+        .string()
+        .min(1)
+        .describe("The ID of the project to get tasks for."),
+    limit: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .default(10)
+        .describe("The maximum number of tasks to return."),
+    cursor: zod_1.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)."),
+};
+const tasksListForProject = {
+    name: "tasks-list-for-project",
+    description: "Get tasks by project ID.",
+    parameters: ArgsSchema,
+    async execute(args, client) {
+        const { projectId, limit, cursor } = args;
+        const { results, nextCursor } = await client.getTasks({
+            projectId,
+            limit,
+            cursor: cursor ?? null,
+        });
+        return {
+            tasks: results.map(shared_js_1.mapTask),
+            nextCursor,
+        };
+    },
+};
+exports.tasksListForProject = tasksListForProject;

package/dist/cjs/tools/tasks-complete-multiple.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tasksCompleteMultiple = void 0;
+const zod_1 = require("zod");
+const ArgsSchema = {
+    ids: zod_1.z
+        .array(zod_1.z.string().min(1))
+        .min(1)
+        .describe("The IDs of the tasks to complete."),
+};
+const tasksCompleteMultiple = {
+    name: "tasks-complete-multiple",
+    description: "Complete one or more tasks by their IDs.",
+    parameters: ArgsSchema,
+    async execute(args, client) {
+        const completed = [];
+        for (const id of args.ids) {
+            try {
+                await client.closeTask(id);
+                completed.push(id);
+            }
+            catch {
+                // Ignore errors for individual tasks, continue with others
+            }
+        }
+        return { success: true, completed };
+    },
+};
+exports.tasksCompleteMultiple = tasksCompleteMultiple;

package/dist/cjs/tools/tasks-delete-one.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tasksDeleteOne = void 0;
+const zod_1 = require("zod");
+const ArgsSchema = {
+    id: zod_1.z.string().min(1).describe("The ID of the task to delete."),
+};
+const tasksDeleteOne = {
+    name: "tasks-delete-one",
+    description: "Delete a task by its ID.",
+    parameters: ArgsSchema,
+    async execute(args, client) {
+        await client.deleteTask(args.id);
+        return { success: true };
+    },
+};
+exports.tasksDeleteOne = tasksDeleteOne;

package/dist/cjs/tools/tasks-list-for-section.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tasksListForSection = void 0;
+const zod_1 = require("zod");
+const shared_js_1 = require("./shared.js");
+const ArgsSchema = {
+    sectionId: zod_1.z
+        .string()
+        .min(1)
+        .describe("The ID of the section to get tasks for."),
+    limit: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .default(10)
+        .describe("The maximum number of tasks to return."),
+    cursor: zod_1.z
+        .string()
+        .optional()
+        .describe("The cursor to get the next page of tasks (from previous call)."),
+};
+const tasksListForSection = {
+    name: "tasks-list-for-section",
+    description: "List tasks for a given section.",
+    parameters: ArgsSchema,
+    async execute(args, client) {
+        const { sectionId, limit, cursor } = args;
+        const { results, nextCursor } = await client.getTasks({
+            sectionId,
+            limit,
+            cursor: cursor ?? null,
+        });
+        return {
+            tasks: results.map(shared_js_1.mapTask),
+            nextCursor,
+        };
+    },
+};
+exports.tasksListForSection = tasksListForSection;

package/dist/cjs/tools/tasks-list-overdue.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tasksListOverdue = void 0;
+const zod_1 = require("zod");
+const shared_js_1 = require("./shared.js");
+const ArgsSchema = {
+    limit: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .default(10)
+        .describe("The maximum number of overdue tasks to return."),
+    cursor: zod_1.z
+        .string()
+        .optional()
+        .describe("The cursor to get the next page of overdue tasks (cursor is obtained from the previous call to this tool, with the same parameters)."),
+};
+const tasksListOverdue = {
+    name: "tasks-list-overdue",
+    description: "Get overdue tasks.",
+    parameters: ArgsSchema,
+    async execute(args, client) {
+        return await (0, shared_js_1.getTasksByFilter)({
+            client,
+            query: "overdue",
+            cursor: args.cursor,
+            limit: args.limit,
+        });
+    },
+};
+exports.tasksListOverdue = tasksListOverdue;

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

@@ -0,0 +1,43 @@
+"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."),
+});
+const ArgsSchema = {
+    tasks: zod_1.z
+        .array(TaskUpdateSchema)
+        .min(1)
+        .describe("Array of task updates to apply."),
+};
+const tasksOrganizeMultiple = {
+    name: "tasks-organize-multiple",
+    description: "Organize multiple tasks (move, reorder, etc.) in bulk.",
+    parameters: ArgsSchema,
+    async execute(args, client) {
+        const results = [];
+        for (const update of args.tasks) {
+            const { id, ...updateArgs } = update;
+            results.push(await client.updateTask(id, updateArgs));
+        }
+        return results;
+    },
+};
+exports.tasksOrganizeMultiple = tasksOrganizeMultiple;

package/dist/cjs/tools/tasks-search.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tasksSearch = void 0;
+const zod_1 = require("zod");
+const shared_js_1 = require("./shared.js");
+const ArgsSchema = {
+    searchText: zod_1.z.string().min(1).describe("The text to search for in tasks."),
+    limit: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .default(10)
+        .describe("The maximum number of tasks to return."),
+    cursor: zod_1.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)."),
+};
+const tasksSearch = {
+    name: "tasks-search",
+    description: "Search tasks by text using Todoist's filter query.",
+    parameters: ArgsSchema,
+    async execute(args, client) {
+        return await (0, shared_js_1.getTasksByFilter)({
+            client,
+            query: `search: ${args.searchText}`,
+            cursor: args.cursor,
+            limit: args.limit,
+        });
+    },
+};
+exports.tasksSearch = tasksSearch;

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

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tasksUpdateOne = void 0;
+const zod_1 = require("zod");
+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
+        .number()
+        .int()
+        .min(1)
+        .max(4)
+        .optional()
+        .describe("The new priority of the task (1-4)."),
+    dueString: zod_1.z
+        .string()
+        .optional()
+        .describe("The new due date for the task, in natural language (e.g., 'tomorrow at 5pm')."),
+};
+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);
+    },
+};
+exports.tasksUpdateOne = tasksUpdateOne;