@doist/todoist-ai 0.1.0 → 0.1.2

package/README.md

@@ -19,7 +19,7 @@ npm install @doist/todoist-ai
 Here's an example using [Vercel's AI SDK](https://ai-sdk.dev/docs/ai-sdk-core/generating-text#streamtext).
 
 ```js
-import { tasksListByDate, tasksAddMultiple } from "@doist/todoist-ai/tools";
+import { tasksListByDate, tasksAddMultiple } from "@doist/todoist-ai";
 import { streamText } from "ai";
 
 const result = streamText({

package/dist/cjs/index.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectOverview = exports.accountOverview = exports.subtasksListForParentTask = exports.tasksListForSection = exports.tasksOrganizeMultiple = exports.tasksUpdateOne = exports.tasksAddMultiple = exports.tasksSearch = exports.tasksListOverdue = exports.tasksListForProject = exports.tasksCompleteMultiple = exports.tasksDeleteOne = exports.tasksListByDate = exports.sectionsDeleteOne = exports.sectionsUpdateOne = exports.sectionsAddOne = exports.sectionsSearch = exports.projectsDeleteOne = exports.projectsUpdateOne = exports.projectsAddOne = exports.projectsSearch = exports.projectsList = exports.getMcpServer = exports.tools = void 0;
+const mcp_server_js_1 = require("./mcp-server.js");
+Object.defineProperty(exports, "getMcpServer", { enumerable: true, get: function () { return mcp_server_js_1.getMcpServer; } });
+const projects_add_one_js_1 = require("./tools/projects-add-one.js");
+Object.defineProperty(exports, "projectsAddOne", { enumerable: true, get: function () { return projects_add_one_js_1.projectsAddOne; } });
+const projects_delete_one_js_1 = require("./tools/projects-delete-one.js");
+Object.defineProperty(exports, "projectsDeleteOne", { enumerable: true, get: function () { return projects_delete_one_js_1.projectsDeleteOne; } });
+const projects_list_js_1 = require("./tools/projects-list.js");
+Object.defineProperty(exports, "projectsList", { enumerable: true, get: function () { return projects_list_js_1.projectsList; } });
+const projects_search_js_1 = require("./tools/projects-search.js");
+Object.defineProperty(exports, "projectsSearch", { enumerable: true, get: function () { return projects_search_js_1.projectsSearch; } });
+const projects_update_one_js_1 = require("./tools/projects-update-one.js");
+Object.defineProperty(exports, "projectsUpdateOne", { enumerable: true, get: function () { return projects_update_one_js_1.projectsUpdateOne; } });
+const sections_add_one_js_1 = require("./tools/sections-add-one.js");
+Object.defineProperty(exports, "sectionsAddOne", { enumerable: true, get: function () { return sections_add_one_js_1.sectionsAddOne; } });
+const sections_delete_one_js_1 = require("./tools/sections-delete-one.js");
+Object.defineProperty(exports, "sectionsDeleteOne", { enumerable: true, get: function () { return sections_delete_one_js_1.sectionsDeleteOne; } });
+const sections_search_js_1 = require("./tools/sections-search.js");
+Object.defineProperty(exports, "sectionsSearch", { enumerable: true, get: function () { return sections_search_js_1.sectionsSearch; } });
+const sections_update_one_js_1 = require("./tools/sections-update-one.js");
+Object.defineProperty(exports, "sectionsUpdateOne", { enumerable: true, get: function () { return sections_update_one_js_1.sectionsUpdateOne; } });
+const tasks_add_multiple_js_1 = require("./tools/tasks-add-multiple.js");
+Object.defineProperty(exports, "tasksAddMultiple", { enumerable: true, get: function () { return tasks_add_multiple_js_1.tasksAddMultiple; } });
+const tasks_by_date_range_js_1 = require("./tools/tasks-by-date-range.js");
+Object.defineProperty(exports, "tasksListByDate", { enumerable: true, get: function () { return tasks_by_date_range_js_1.tasksListByDate; } });
+const tasks_by_project_js_1 = require("./tools/tasks-by-project.js");
+Object.defineProperty(exports, "tasksListForProject", { enumerable: true, get: function () { return tasks_by_project_js_1.tasksListForProject; } });
+const tasks_complete_multiple_js_1 = require("./tools/tasks-complete-multiple.js");
+Object.defineProperty(exports, "tasksCompleteMultiple", { enumerable: true, get: function () { return tasks_complete_multiple_js_1.tasksCompleteMultiple; } });
+const tasks_delete_one_js_1 = require("./tools/tasks-delete-one.js");
+Object.defineProperty(exports, "tasksDeleteOne", { enumerable: true, get: function () { return tasks_delete_one_js_1.tasksDeleteOne; } });
+const tasks_list_for_section_js_1 = require("./tools/tasks-list-for-section.js");
+Object.defineProperty(exports, "tasksListForSection", { enumerable: true, get: function () { return tasks_list_for_section_js_1.tasksListForSection; } });
+const tasks_list_overdue_js_1 = require("./tools/tasks-list-overdue.js");
+Object.defineProperty(exports, "tasksListOverdue", { enumerable: true, get: function () { return tasks_list_overdue_js_1.tasksListOverdue; } });
+const tasks_organize_multiple_js_1 = require("./tools/tasks-organize-multiple.js");
+Object.defineProperty(exports, "tasksOrganizeMultiple", { enumerable: true, get: function () { return tasks_organize_multiple_js_1.tasksOrganizeMultiple; } });
+const tasks_search_js_1 = require("./tools/tasks-search.js");
+Object.defineProperty(exports, "tasksSearch", { enumerable: true, get: function () { return tasks_search_js_1.tasksSearch; } });
+const tasks_update_one_js_1 = require("./tools/tasks-update-one.js");
+Object.defineProperty(exports, "tasksUpdateOne", { enumerable: true, get: function () { return tasks_update_one_js_1.tasksUpdateOne; } });
+const subtasks_list_for_parent_task_js_1 = require("./tools/subtasks-list-for-parent-task.js");
+Object.defineProperty(exports, "subtasksListForParentTask", { enumerable: true, get: function () { return subtasks_list_for_parent_task_js_1.subtasksListForParentTask; } });
+const account_overview_js_1 = require("./tools/account-overview.js");
+Object.defineProperty(exports, "accountOverview", { enumerable: true, get: function () { return account_overview_js_1.accountOverview; } });
+const project_overview_js_1 = require("./tools/project-overview.js");
+Object.defineProperty(exports, "projectOverview", { enumerable: true, get: function () { return project_overview_js_1.projectOverview; } });
+const tools = {
+    projectsList: projects_list_js_1.projectsList,
+    projectsSearch: projects_search_js_1.projectsSearch,
+    projectsAddOne: projects_add_one_js_1.projectsAddOne,
+    projectsUpdateOne: projects_update_one_js_1.projectsUpdateOne,
+    projectsDeleteOne: projects_delete_one_js_1.projectsDeleteOne,
+    sectionsSearch: sections_search_js_1.sectionsSearch,
+    sectionsAddOne: sections_add_one_js_1.sectionsAddOne,
+    sectionsUpdateOne: sections_update_one_js_1.sectionsUpdateOne,
+    sectionsDeleteOne: sections_delete_one_js_1.sectionsDeleteOne,
+    tasksListByDate: tasks_by_date_range_js_1.tasksListByDate,
+    tasksDeleteOne: tasks_delete_one_js_1.tasksDeleteOne,
+    tasksCompleteMultiple: tasks_complete_multiple_js_1.tasksCompleteMultiple,
+    tasksListForProject: tasks_by_project_js_1.tasksListForProject,
+    tasksListOverdue: tasks_list_overdue_js_1.tasksListOverdue,
+    tasksSearch: tasks_search_js_1.tasksSearch,
+    tasksAddMultiple: tasks_add_multiple_js_1.tasksAddMultiple,
+    tasksUpdateOne: tasks_update_one_js_1.tasksUpdateOne,
+    tasksOrganizeMultiple: tasks_organize_multiple_js_1.tasksOrganizeMultiple,
+    tasksListForSection: tasks_list_for_section_js_1.tasksListForSection,
+    subtasksListForParentTask: subtasks_list_for_parent_task_js_1.subtasksListForParentTask,
+    accountOverview: account_overview_js_1.accountOverview,
+    projectOverview: project_overview_js_1.projectOverview,
+};
+exports.tools = tools;

package/dist/cjs/main.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const dotenv_1 = __importDefault(require("dotenv"));
+const mcp_server_js_1 = require("./mcp-server.js");
+function main() {
+    const todoistApiKey = process.env.TODOIST_API_KEY;
+    if (!todoistApiKey) {
+        throw new Error("TODOIST_API_KEY is not set");
+    }
+    const server = (0, mcp_server_js_1.getMcpServer)({ todoistApiKey });
+    const transport = new stdio_js_1.StdioServerTransport();
+    server
+        .connect(transport)
+        .then(() => {
+        // We use console.error because standard I/O is being used for the MCP server communication.
+        console.error("Server started");
+    })
+        .catch((error) => {
+        console.error("Error starting the Todoist MCP server:", error);
+        process.exit(1);
+    });
+}
+dotenv_1.default.config();
+main();

package/dist/cjs/mcp-helpers.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerTool = registerTool;
+function textContent(text) {
+    return {
+        content: [{ type: "text", text }],
+    };
+}
+function jsonContent(data) {
+    return {
+        content: [
+            {
+                type: "text",
+                mimeType: "application/json",
+                text: JSON.stringify(data, null, 2),
+            },
+        ],
+    };
+}
+function textOrJsonContent(data) {
+    return typeof data === "string" ? textContent(data) : jsonContent(data);
+}
+function errorContent(error) {
+    return {
+        ...textContent(error),
+        isError: true,
+    };
+}
+/**
+ * Register a Todoist tool in an MCP server.
+ * @param tool - The tool to register.
+ * @param server - The server to register the tool on.
+ * @param client - The Todoist API client to use to execute the tool.
+ */
+function registerTool(tool, server, client) {
+    // @ts-ignore I give up
+    const cb = async (args, _context) => {
+        try {
+            const result = await tool.execute(args, client);
+            return textOrJsonContent(result);
+        }
+        catch (error) {
+            console.error(`Error executing tool ${tool.name}:`, {
+                args,
+                error,
+            });
+            const message = error instanceof Error
+                ? error.message
+                : "An unknown error occurred";
+            return errorContent(message);
+        }
+    };
+    server.tool(tool.name, tool.description, tool.parameters, cb);
+}

package/dist/cjs/mcp-server.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMcpServer = getMcpServer;
+const todoist_api_typescript_1 = require("@doist/todoist-api-typescript");
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const mcp_helpers_js_1 = require("./mcp-helpers.js");
+const projects_add_one_js_1 = require("./tools/projects-add-one.js");
+const projects_delete_one_js_1 = require("./tools/projects-delete-one.js");
+const projects_list_js_1 = require("./tools/projects-list.js");
+const projects_search_js_1 = require("./tools/projects-search.js");
+const projects_update_one_js_1 = require("./tools/projects-update-one.js");
+const sections_add_one_js_1 = require("./tools/sections-add-one.js");
+const sections_delete_one_js_1 = require("./tools/sections-delete-one.js");
+const sections_search_js_1 = require("./tools/sections-search.js");
+const sections_update_one_js_1 = require("./tools/sections-update-one.js");
+const subtasks_list_for_parent_task_js_1 = require("./tools/subtasks-list-for-parent-task.js");
+const account_overview_js_1 = require("./tools/account-overview.js");
+const project_overview_js_1 = require("./tools/project-overview.js");
+const tasks_add_multiple_js_1 = require("./tools/tasks-add-multiple.js");
+const tasks_by_date_range_js_1 = require("./tools/tasks-by-date-range.js");
+const tasks_by_project_js_1 = require("./tools/tasks-by-project.js");
+const tasks_complete_multiple_js_1 = require("./tools/tasks-complete-multiple.js");
+const tasks_delete_one_js_1 = require("./tools/tasks-delete-one.js");
+const tasks_list_for_section_js_1 = require("./tools/tasks-list-for-section.js");
+const tasks_list_overdue_js_1 = require("./tools/tasks-list-overdue.js");
+const tasks_organize_multiple_js_1 = require("./tools/tasks-organize-multiple.js");
+const tasks_search_js_1 = require("./tools/tasks-search.js");
+const tasks_update_one_js_1 = require("./tools/tasks-update-one.js");
+const instructions = `
+Tools to help you manage your todoist tasks.
+`;
+/**
+ * Create the MCP server.
+ * @param todoistApiKey - The API key for the todoist account.
+ * @returns the MCP server.
+ */
+function getMcpServer({ todoistApiKey }) {
+    const server = new mcp_js_1.McpServer({ name: "todoist-mcp-server", version: "0.1.0" }, {
+        capabilities: {
+            tools: { listChanged: true },
+        },
+        instructions,
+    });
+    const todoist = new todoist_api_typescript_1.TodoistApi(todoistApiKey);
+    (0, mcp_helpers_js_1.registerTool)(tasks_by_date_range_js_1.tasksListByDate, server, todoist);
+    (0, mcp_helpers_js_1.registerTool)(tasks_list_overdue_js_1.tasksListOverdue, server, todoist);
+    (0, mcp_helpers_js_1.registerTool)(tasks_by_project_js_1.tasksListForProject, server, todoist);
+    (0, mcp_helpers_js_1.registerTool)(tasks_search_js_1.tasksSearch, server, todoist);
+    (0, mcp_helpers_js_1.registerTool)(projects_list_js_1.projectsList, server, todoist);
+    (0, mcp_helpers_js_1.registerTool)(tasks_add_multiple_js_1.tasksAddMultiple, server, todoist);
+    (0, mcp_helpers_js_1.registerTool)(tasks_update_one_js_1.tasksUpdateOne, server, todoist);
+    (0, mcp_helpers_js_1.registerTool)(tasks_delete_one_js_1.tasksDeleteOne, server, todoist);
+    (0, mcp_helpers_js_1.registerTool)(tasks_complete_multiple_js_1.tasksCompleteMultiple, server, todoist);
+    (0, mcp_helpers_js_1.registerTool)(projects_add_one_js_1.projectsAddOne, server, todoist);
+    (0, mcp_helpers_js_1.registerTool)(projects_update_one_js_1.projectsUpdateOne, server, todoist);
+    (0, mcp_helpers_js_1.registerTool)(sections_add_one_js_1.sectionsAddOne, server, todoist);
+    (0, mcp_helpers_js_1.registerTool)(sections_update_one_js_1.sectionsUpdateOne, server, todoist);
+    (0, mcp_helpers_js_1.registerTool)(tasks_organize_multiple_js_1.tasksOrganizeMultiple, server, todoist);
+    (0, mcp_helpers_js_1.registerTool)(subtasks_list_for_parent_task_js_1.subtasksListForParentTask, server, todoist);
+    (0, mcp_helpers_js_1.registerTool)(tasks_list_for_section_js_1.tasksListForSection, server, todoist);
+    (0, mcp_helpers_js_1.registerTool)(projects_delete_one_js_1.projectsDeleteOne, server, todoist);
+    (0, mcp_helpers_js_1.registerTool)(projects_search_js_1.projectsSearch, server, todoist);
+    (0, mcp_helpers_js_1.registerTool)(sections_delete_one_js_1.sectionsDeleteOne, server, todoist);
+    (0, mcp_helpers_js_1.registerTool)(sections_search_js_1.sectionsSearch, server, todoist);
+    (0, mcp_helpers_js_1.registerTool)(account_overview_js_1.accountOverview, server, todoist);
+    (0, mcp_helpers_js_1.registerTool)(project_overview_js_1.projectOverview, server, todoist);
+    return server;
+}

package/dist/cjs/todoist-tool.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/tools/account-overview.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.accountOverview = void 0;
+const ArgsSchema = {};
+function buildProjectTree(projects) {
+    // Sort projects by childOrder, then build a tree
+    const byId = {};
+    for (const p of projects) {
+        byId[p.id] = {
+            ...p,
+            children: [],
+            childOrder: p.childOrder ?? 0,
+        };
+    }
+    const roots = [];
+    for (const p of projects) {
+        const current = byId[p.id];
+        if (!current)
+            continue;
+        if (p.parentId) {
+            const parent = byId[p.parentId];
+            if (parent) {
+                parent.children.push(current);
+            }
+            else {
+                roots.push(current);
+            }
+        }
+        else {
+            roots.push(current);
+        }
+    }
+    function sortTree(nodes) {
+        nodes.sort((a, b) => a.childOrder - b.childOrder);
+        for (const n of nodes) {
+            sortTree(n.children);
+        }
+    }
+    sortTree(roots);
+    return roots;
+}
+async function getSectionsByProject(client, projectIds) {
+    const result = {};
+    await Promise.all(projectIds.map(async (projectId) => {
+        const { results } = await client.getSections({ projectId });
+        result[projectId] = results;
+    }));
+    return result;
+}
+function renderProjectMarkdown(project, sectionsByProject, indent = "") {
+    const lines = [];
+    lines.push(`${indent}- Project: ${project.name} (id=${project.id})`);
+    const sections = sectionsByProject[project.id] || [];
+    for (const section of sections) {
+        lines.push(`${indent}  - Section: ${section.name} (id=${section.id})`);
+    }
+    for (const child of project.children) {
+        lines.push(...renderProjectMarkdown(child, sectionsByProject, `${indent}  `));
+    }
+    return lines;
+}
+const accountOverview = {
+    name: "account-overview",
+    description: "Get a Markdown overview of all projects (with hierarchy and sections) and the inbox project. Useful in almost any context before engaging with Todoist further.",
+    parameters: ArgsSchema,
+    async execute(_args, client) {
+        const { results: projects } = await client.getProjects({});
+        const inbox = projects.find((p) => p.isInboxProject === true);
+        const nonInbox = projects.filter((p) => p.isInboxProject !== true);
+        const tree = buildProjectTree(nonInbox);
+        const allProjectIds = projects.map((p) => p.id);
+        const sectionsByProject = await getSectionsByProject(client, allProjectIds);
+        const lines = ["# Personal Projects", ""];
+        if (inbox) {
+            lines.push(`- Inbox Project: ${inbox.name} (id=${inbox.id})`);
+            for (const section of sectionsByProject[inbox.id] || []) {
+                lines.push(`  - Section: ${section.name} (id=${section.id})`);
+            }
+        }
+        if (tree.length) {
+            for (const project of tree) {
+                lines.push(...renderProjectMarkdown(project, sectionsByProject));
+            }
+        }
+        else {
+            lines.push("_No projects found._");
+        }
+        lines.push("");
+        // Add explanation about nesting if there are nested projects
+        const hasNested = tree.some((p) => p.children.length > 0);
+        if (hasNested) {
+            lines.push("_Note: Indentation indicates that a project is a sub-project of the one above it. This allows for organizing projects hierarchically, with parent projects containing related sub-projects._", "");
+        }
+        return lines.join("\n");
+    },
+};
+exports.accountOverview = accountOverview;

package/dist/cjs/tools/project-overview.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectOverview = 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 an overview for."),
+};
+function buildTaskTree(tasks) {
+    const byId = {};
+    for (const task of tasks) {
+        byId[task.id] = { ...task, children: [] };
+    }
+    const roots = [];
+    for (const task of tasks) {
+        const node = byId[task.id];
+        if (!node)
+            continue;
+        if (!task.parentId) {
+            roots.push(node);
+            continue;
+        }
+        const parent = byId[task.parentId];
+        if (parent) {
+            parent.children.push(node);
+        }
+        else {
+            roots.push(node);
+        }
+    }
+    return roots;
+}
+function renderTaskTreeMarkdown(tasks, indent = "") {
+    const lines = [];
+    for (const task of tasks) {
+        const idPart = `id=${task.id}`;
+        const duePart = task.dueDate ? `; due=${task.dueDate}` : "";
+        const contentPart = `; content=${task.content}`;
+        lines.push(`${indent}- ${idPart}${duePart}${contentPart}`);
+        if (task.children.length > 0) {
+            lines.push(...renderTaskTreeMarkdown(task.children, `${indent}  `));
+        }
+    }
+    return lines;
+}
+async function getAllTasksForProject(client, projectId) {
+    let allTasks = [];
+    let cursor = undefined;
+    do {
+        const { results, nextCursor } = await client.getTasks({
+            projectId,
+            limit: 50,
+            cursor: cursor ?? undefined,
+        });
+        allTasks = allTasks.concat(results.map(shared_js_1.mapTask));
+        cursor = nextCursor ?? undefined;
+    } while (cursor);
+    return allTasks;
+}
+async function getProjectSections(client, projectId) {
+    const { results } = await client.getSections({ projectId });
+    return results;
+}
+const projectOverview = {
+    name: "project-overview",
+    description: "Get a Markdown overview of a single project, including its sections and all tasks. Tasks are grouped by section, with tasks not in any section listed first. Each task is listed as '- id=TASKID; due=YYYY-MM-DD; content=TASK CONTENT' (omit due if not present). Subtasks are nested as indented list items.",
+    parameters: ArgsSchema,
+    async execute(args, client) {
+        const { projectId } = args;
+        const project = await client.getProject(projectId);
+        const sections = await getProjectSections(client, projectId);
+        const allTasks = await getAllTasksForProject(client, projectId);
+        // Group tasks by sectionId
+        const tasksBySection = {};
+        for (const section of sections) {
+            tasksBySection[section.id] = [];
+        }
+        const tasksWithoutSection = [];
+        for (const task of allTasks) {
+            if (task.sectionId && tasksBySection[task.sectionId]) {
+                // biome-ignore lint/style/noNonNullAssertion: the "if" above ensures that it is defined
+                tasksBySection[task.sectionId].push(task);
+            }
+            else {
+                tasksWithoutSection.push(task);
+            }
+        }
+        const lines = [`# ${project.name}`];
+        if (tasksWithoutSection.length > 0) {
+            lines.push("");
+            const tree = buildTaskTree(tasksWithoutSection);
+            lines.push(...renderTaskTreeMarkdown(tree));
+        }
+        for (const section of sections) {
+            lines.push("");
+            lines.push(`## ${section.name}`);
+            const sectionTasks = tasksBySection[section.id];
+            if (!sectionTasks?.length) {
+                continue;
+            }
+            const tree = buildTaskTree(sectionTasks);
+            lines.push(...renderTaskTreeMarkdown(tree));
+        }
+        return lines.join("\n");
+    },
+};
+exports.projectOverview = projectOverview;

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

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectsAddOne = void 0;
+const zod_1 = require("zod");
+const shared_js_1 = require("./shared.js");
+const ArgsSchema = {
+    name: zod_1.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 (0, shared_js_1.mapProject)(project);
+    },
+};
+exports.projectsAddOne = projectsAddOne;

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

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectsDeleteOne = void 0;
+const zod_1 = require("zod");
+const ArgsSchema = {
+    id: zod_1.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 };
+    },
+};
+exports.projectsDeleteOne = projectsDeleteOne;

package/dist/cjs/tools/projects-list.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectsList = void 0;
+const zod_1 = require("zod");
+const ArgsSchema = {
+    limit: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(50)
+        .describe("The maximum number of projects to return."),
+    cursor: zod_1.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,
+        };
+    },
+};
+exports.projectsList = projectsList;

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

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectsSearch = void 0;
+const zod_1 = require("zod");
+const shared_js_1 = require("./shared.js");
+const ArgsSchema = {
+    search: zod_1.z
+        .string()
+        .optional()
+        .describe("Search for a project by name (partial and case insensitive match). If omitted, all projects are returned."),
+    limit: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(50)
+        .describe("The maximum number of projects to return."),
+    cursor: zod_1.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(shared_js_1.mapProject),
+            nextCursor,
+        };
+    },
+};
+exports.projectsSearch = projectsSearch;

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

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectsUpdateOne = void 0;
+const zod_1 = require("zod");
+const ArgsSchema = {
+    id: zod_1.z.string().min(1).describe("The ID of the project to update."),
+    name: zod_1.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;
+    },
+};
+exports.projectsUpdateOne = projectsUpdateOne;

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

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sectionsAddOne = void 0;
+const zod_1 = require("zod");
+const ArgsSchema = {
+    name: zod_1.z.string().min(1).describe("The name of the section to add."),
+    projectId: zod_1.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;
+    },
+};
+exports.sectionsAddOne = sectionsAddOne;

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

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sectionsDeleteOne = void 0;
+const zod_1 = require("zod");
+const ArgsSchema = {
+    id: zod_1.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 };
+    },
+};
+exports.sectionsDeleteOne = sectionsDeleteOne;

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

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sectionsSearch = void 0;
+const zod_1 = require("zod");
+const ArgsSchema = {
+    projectId: zod_1.z
+        .string()
+        .min(1)
+        .describe("The ID of the project to search sections in."),
+    search: zod_1.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,
+        }));
+    },
+};
+exports.sectionsSearch = sectionsSearch;