@doist/todoist-ai 0.1.0

package/dist/tools/projects-add-one.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+declare const projectsAddOne: {
+    name: string;
+    description: string;
+    parameters: {
+        name: z.ZodString;
+    };
+    execute(args: {
+        name: string;
+    }, client: import("@doist/todoist-api-typescript").TodoistApi): Promise<{
+        id: string;
+        name: string;
+        color: string;
+        isFavorite: boolean;
+        isShared: boolean;
+        parentId: string | null;
+        inboxProject: boolean;
+        viewStyle: string;
+    }>;
+};
+export { projectsAddOne };
+//# sourceMappingURL=projects-add-one.d.ts.map

package/dist/tools/projects-add-one.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects-add-one.d.ts","sourceRoot":"","sources":["../../src/tools/projects-add-one.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;CAQsB,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/tools/projects-add-one.js

@@ -0,0 +1,15 @@
+import { z } from "zod";
+import { mapProject } from "./shared.js";
+const ArgsSchema = {
+    name: z.string().min(1).describe("The name of the project to add."),
+};
+const projectsAddOne = {
+    name: "projects-add-one",
+    description: "Add a new project.",
+    parameters: ArgsSchema,
+    async execute(args, client) {
+        const project = await client.addProject({ name: args.name });
+        return mapProject(project);
+    },
+};
+export { projectsAddOne };

package/dist/tools/projects-delete-one.d.ts

@@ -0,0 +1,15 @@
+import { z } from "zod";
+declare const projectsDeleteOne: {
+    name: string;
+    description: string;
+    parameters: {
+        id: z.ZodString;
+    };
+    execute(args: {
+        id: string;
+    }, client: import("@doist/todoist-api-typescript").TodoistApi): Promise<{
+        success: boolean;
+    }>;
+};
+export { projectsDeleteOne };
+//# sourceMappingURL=projects-delete-one.d.ts.map

package/dist/tools/projects-delete-one.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects-delete-one.d.ts","sourceRoot":"","sources":["../../src/tools/projects-delete-one.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,QAAA,MAAM,iBAAiB;;;;;;;;;;;CAQmB,CAAC;AAE3C,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/tools/projects-delete-one.js

@@ -0,0 +1,14 @@
+import { z } from "zod";
+const ArgsSchema = {
+    id: z.string().min(1).describe("The ID of the project to delete."),
+};
+const projectsDeleteOne = {
+    name: "projects-delete-one",
+    description: "Delete a project by its ID.",
+    parameters: ArgsSchema,
+    async execute(args, client) {
+        await client.deleteProject(args.id);
+        return { success: true };
+    },
+};
+export { projectsDeleteOne };

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

@@ -0,0 +1,18 @@
+import { z } from "zod";
+declare const projectsList: {
+    name: string;
+    description: string;
+    parameters: {
+        limit: z.ZodDefault<z.ZodNumber>;
+        cursor: z.ZodOptional<z.ZodString>;
+    };
+    execute(args: {
+        limit: number;
+        cursor?: string | undefined;
+    }, client: import("@doist/todoist-api-typescript").TodoistApi): Promise<{
+        projects: import("@doist/todoist-api-typescript").Project[];
+        nextCursor: string | null;
+    }>;
+};
+export { projectsList };
+//# sourceMappingURL=projects-list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projects-list.d.ts","sourceRoot":"","sources":["../../src/tools/projects-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmBxB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;CAcwB,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/tools/projects-list.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+const ArgsSchema = {
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(50)
+        .describe("The maximum number of projects to return."),
+    cursor: z
+        .string()
+        .optional()
+        .describe("The cursor to get the next page of projects (cursor is obtained from the previous call to this tool, with the same parameters)."),
+};
+const projectsList = {
+    name: "projects-list",
+    description: "List all projects for the user.",
+    parameters: ArgsSchema,
+    async execute(args, client) {
+        const { results, nextCursor } = await client.getProjects({
+            limit: args.limit,
+            cursor: args.cursor ?? null,
+        });
+        return {
+            projects: results,
+            nextCursor,
+        };
+    },
+};
+export { projectsList };

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

@@ -0,0 +1,29 @@
+import { z } from "zod";
+declare const projectsSearch: {
+    name: string;
+    description: string;
+    parameters: {
+        search: z.ZodOptional<z.ZodString>;
+        limit: z.ZodDefault<z.ZodNumber>;
+        cursor: z.ZodOptional<z.ZodString>;
+    };
+    execute(args: {
+        limit: number;
+        cursor?: string | undefined;
+        search?: string | undefined;
+    }, client: import("@doist/todoist-api-typescript").TodoistApi): Promise<{
+        projects: {
+            id: string;
+            name: string;
+            color: string;
+            isFavorite: boolean;
+            isShared: boolean;
+            parentId: string | null;
+            inboxProject: boolean;
+            viewStyle: string;
+        }[];
+        nextCursor: string | null;
+    }>;
+};
+export { projectsSearch };
+//# sourceMappingURL=projects-search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projects-search.d.ts","sourceRoot":"","sources":["../../src/tools/projects-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0BxB,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;CAoBsB,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/tools/projects-search.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import { mapProject } from "./shared.js";
+const ArgsSchema = {
+    search: z
+        .string()
+        .optional()
+        .describe("Search for a project by name (partial and case insensitive match). If omitted, all projects are returned."),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(50)
+        .describe("The maximum number of projects to return."),
+    cursor: z
+        .string()
+        .optional()
+        .describe("The cursor to get the next page of projects (cursor is obtained from the previous call to this tool, with the same parameters)."),
+};
+const projectsSearch = {
+    name: "projects-search",
+    description: "Search for projects by name or other criteria.",
+    parameters: ArgsSchema,
+    async execute(args, client) {
+        const { results, nextCursor } = await client.getProjects({
+            limit: args.limit,
+            cursor: args.cursor ?? null,
+        });
+        const searchLower = args.search ? args.search.toLowerCase() : undefined;
+        const filtered = searchLower
+            ? results.filter((project) => project.name.toLowerCase().includes(searchLower))
+            : results;
+        return {
+            projects: filtered.map(mapProject),
+            nextCursor,
+        };
+    },
+};
+export { projectsSearch };

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

@@ -0,0 +1,15 @@
+import { z } from "zod";
+declare const projectsUpdateOne: {
+    name: string;
+    description: string;
+    parameters: {
+        id: z.ZodString;
+        name: z.ZodString;
+    };
+    execute(args: {
+        name: string;
+        id: string;
+    }, client: import("@doist/todoist-api-typescript").TodoistApi): Promise<import("@doist/todoist-api-typescript").Project>;
+};
+export { projectsUpdateOne };
+//# sourceMappingURL=projects-update-one.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projects-update-one.d.ts","sourceRoot":"","sources":["../../src/tools/projects-update-one.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,QAAA,MAAM,iBAAiB;;;;;;;;;;;CASmB,CAAC;AAE3C,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

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

@@ -0,0 +1,16 @@
+import { z } from "zod";
+const ArgsSchema = {
+    id: z.string().min(1).describe("The ID of the project to update."),
+    name: z.string().min(1).describe("The new name for the project."),
+};
+const projectsUpdateOne = {
+    name: "projects-update-one",
+    description: "Update a project's name by its ID.",
+    parameters: ArgsSchema,
+    async execute(args, client) {
+        const { id, name } = args;
+        const project = await client.updateProject(id, { name });
+        return project;
+    },
+};
+export { projectsUpdateOne };

package/dist/tools/sections-add-one.d.ts

@@ -0,0 +1,15 @@
+import { z } from "zod";
+declare const sectionsAddOne: {
+    name: string;
+    description: string;
+    parameters: {
+        name: z.ZodString;
+        projectId: z.ZodString;
+    };
+    execute(args: {
+        name: string;
+        projectId: string;
+    }, client: import("@doist/todoist-api-typescript").TodoistApi): Promise<import("@doist/todoist-api-typescript").Section>;
+};
+export { sectionsAddOne };
+//# sourceMappingURL=sections-add-one.d.ts.map

package/dist/tools/sections-add-one.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sections-add-one.d.ts","sourceRoot":"","sources":["../../src/tools/sections-add-one.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,QAAA,MAAM,cAAc;;;;;;;;;;;CAWsB,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/tools/sections-add-one.js

@@ -0,0 +1,21 @@
+import { z } from "zod";
+const ArgsSchema = {
+    name: z.string().min(1).describe("The name of the section to add."),
+    projectId: z
+        .string()
+        .min(1)
+        .describe("The ID of the project to add the section to."),
+};
+const sectionsAddOne = {
+    name: "sections-add-one",
+    description: "Add a new section to a project.",
+    parameters: ArgsSchema,
+    async execute(args, client) {
+        const section = await client.addSection({
+            name: args.name,
+            projectId: args.projectId,
+        });
+        return section;
+    },
+};
+export { sectionsAddOne };

package/dist/tools/sections-delete-one.d.ts

@@ -0,0 +1,15 @@
+import { z } from "zod";
+declare const sectionsDeleteOne: {
+    name: string;
+    description: string;
+    parameters: {
+        id: z.ZodString;
+    };
+    execute(args: {
+        id: string;
+    }, client: import("@doist/todoist-api-typescript").TodoistApi): Promise<{
+        success: boolean;
+    }>;
+};
+export { sectionsDeleteOne };
+//# sourceMappingURL=sections-delete-one.d.ts.map

package/dist/tools/sections-delete-one.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sections-delete-one.d.ts","sourceRoot":"","sources":["../../src/tools/sections-delete-one.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,QAAA,MAAM,iBAAiB;;;;;;;;;;;CAQmB,CAAC;AAE3C,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/tools/sections-delete-one.js

@@ -0,0 +1,14 @@
+import { z } from "zod";
+const ArgsSchema = {
+    id: z.string().min(1).describe("The ID of the section to delete."),
+};
+const sectionsDeleteOne = {
+    name: "sections-delete-one",
+    description: "Delete a section by its ID.",
+    parameters: ArgsSchema,
+    async execute(args, client) {
+        await client.deleteSection(args.id);
+        return { success: true };
+    },
+};
+export { sectionsDeleteOne };

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

@@ -0,0 +1,18 @@
+import { z } from "zod";
+declare const sectionsSearch: {
+    name: string;
+    description: string;
+    parameters: {
+        projectId: z.ZodString;
+        search: z.ZodOptional<z.ZodString>;
+    };
+    execute(args: {
+        projectId: string;
+        search?: string | undefined;
+    }, client: import("@doist/todoist-api-typescript").TodoistApi): Promise<{
+        id: string;
+        name: string;
+    }[]>;
+};
+export { sectionsSearch };
+//# sourceMappingURL=sections-search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sections-search.d.ts","sourceRoot":"","sources":["../../src/tools/sections-search.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgBxB,QAAA,MAAM,cAAc;;;;;;;;;;;;;;CAmBsB,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/tools/sections-search.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+const ArgsSchema = {
+    projectId: z
+        .string()
+        .min(1)
+        .describe("The ID of the project to search sections in."),
+    search: z
+        .string()
+        .optional()
+        .describe("Search for a section by name (partial and case insensitive match). If omitted, all sections in the project are returned."),
+};
+const sectionsSearch = {
+    name: "sections-search",
+    description: "Search for sections by name or other criteria in a project.",
+    parameters: ArgsSchema,
+    async execute(args, client) {
+        const { results } = await client.getSections({
+            projectId: args.projectId,
+        });
+        const searchLower = args.search ? args.search.toLowerCase() : undefined;
+        const filtered = searchLower
+            ? results.filter((section) => section.name.toLowerCase().includes(searchLower))
+            : results;
+        return filtered.map((section) => ({
+            id: section.id,
+            name: section.name,
+        }));
+    },
+};
+export { sectionsSearch };

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

@@ -0,0 +1,15 @@
+import { z } from "zod";
+declare const sectionsUpdateOne: {
+    name: string;
+    description: string;
+    parameters: {
+        id: z.ZodString;
+        name: z.ZodString;
+    };
+    execute(args: {
+        name: string;
+        id: string;
+    }, client: import("@doist/todoist-api-typescript").TodoistApi): Promise<import("@doist/todoist-api-typescript").Section>;
+};
+export { sectionsUpdateOne };
+//# sourceMappingURL=sections-update-one.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sections-update-one.d.ts","sourceRoot":"","sources":["../../src/tools/sections-update-one.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,QAAA,MAAM,iBAAiB;;;;;;;;;;;CASmB,CAAC;AAE3C,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

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

@@ -0,0 +1,16 @@
+import { z } from "zod";
+const ArgsSchema = {
+    id: z.string().min(1).describe("The ID of the section to update."),
+    name: 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;
+    },
+};
+export { sectionsUpdateOne };

package/dist/tools/shared.d.ts

@@ -0,0 +1,55 @@
+import { type Project, type Task, type TodoistApi } from "@doist/todoist-api-typescript";
+/**
+ * Map a single Todoist task to a more structured format, for LLM consumption.
+ * @param task - The task to map.
+ * @returns The mapped task.
+ */
+declare function mapTask(task: Task): {
+    id: string;
+    content: string;
+    description: string;
+    dueDate: string | undefined;
+    recurring: string | boolean;
+    priority: number;
+    projectId: string;
+    sectionId: string | null;
+    parentId: string | null;
+    labels: string[];
+};
+/**
+ * Map a single Todoist project to a more structured format, for LLM consumption.
+ * @param project - The project to map.
+ * @returns The mapped project.
+ */
+declare function mapProject(project: Project): {
+    id: string;
+    name: string;
+    color: string;
+    isFavorite: boolean;
+    isShared: boolean;
+    parentId: string | null;
+    inboxProject: boolean;
+    viewStyle: string;
+};
+declare function getTasksByFilter({ client, query, limit, cursor, }: {
+    client: TodoistApi;
+    query: string;
+    limit: number | undefined;
+    cursor: string | undefined;
+}): Promise<{
+    tasks: {
+        id: string;
+        content: string;
+        description: string;
+        dueDate: string | undefined;
+        recurring: string | boolean;
+        priority: number;
+        projectId: string;
+        sectionId: string | null;
+        parentId: string | null;
+        labels: string[];
+    }[];
+    nextCursor: string | null;
+}>;
+export { getTasksByFilter, mapTask, mapProject };
+//# sourceMappingURL=shared.d.ts.map

package/dist/tools/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/tools/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,OAAO,EACZ,KAAK,IAAI,EACT,KAAK,UAAU,EAEf,MAAM,+BAA+B,CAAC;AAGvC;;;;GAIG;AACH,iBAAS,OAAO,CAAC,IAAI,EAAE,IAAI;;;;;;;;;;;EAc1B;AAED;;;;GAIG;AACH,iBAAS,UAAU,CAAC,OAAO,EAAE,OAAO;;;;;;;;;EAWnC;AAWD,iBAAe,gBAAgB,CAAC,EAC/B,MAAM,EACN,KAAK,EACL,KAAK,EACL,MAAM,GACN,EAAE;IACF,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;;;;;;;;;;;;;;GAyBA;AAED,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/tools/shared.js

@@ -0,0 +1,71 @@
+import { getSanitizedContent, } from "@doist/todoist-api-typescript";
+import z from "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: getSanitizedContent(task.content),
+        description: 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 = z.object({
+    httpStatusCode: z.number(),
+    responseData: z.object({
+        error: z.string(),
+        errorCode: z.number(),
+        errorTag: z.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})`);
+    }
+}
+export { getTasksByFilter, mapTask, mapProject };

package/dist/tools/subtasks-list-for-parent-task.d.ts

@@ -0,0 +1,31 @@
+import { z } from "zod";
+declare const subtasksListForParentTask: {
+    name: string;
+    description: string;
+    parameters: {
+        parentId: z.ZodString;
+        limit: z.ZodDefault<z.ZodNumber>;
+        cursor: z.ZodOptional<z.ZodString>;
+    };
+    execute(args: {
+        limit: number;
+        parentId: string;
+        cursor?: string | undefined;
+    }, client: import("@doist/todoist-api-typescript").TodoistApi): Promise<{
+        tasks: {
+            id: string;
+            content: string;
+            description: string;
+            dueDate: string | undefined;
+            recurring: string | boolean;
+            priority: number;
+            projectId: string;
+            sectionId: string | null;
+            parentId: string | null;
+            labels: string[];
+        }[];
+        nextCursor: string | null;
+    }>;
+};
+export { subtasksListForParentTask };
+//# sourceMappingURL=subtasks-list-for-parent-task.d.ts.map

package/dist/tools/subtasks-list-for-parent-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtasks-list-for-parent-task.d.ts","sourceRoot":"","sources":["../../src/tools/subtasks-list-for-parent-task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAwBxB,QAAA,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgBW,CAAC;AAE3C,OAAO,EAAE,yBAAyB,EAAE,CAAC"}

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

@@ -0,0 +1,37 @@
+import { z } from "zod";
+import { mapTask } from "./shared.js";
+const ArgsSchema = {
+    parentId: z
+        .string()
+        .min(1)
+        .describe("The ID of the parent task to get subtasks for."),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .default(10)
+        .describe("The maximum number of subtasks to return."),
+    cursor: 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(mapTask),
+            nextCursor,
+        };
+    },
+};
+export { subtasksListForParentTask };