@todoist/mcp 0.0.1 → 15.0.0

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

@@ -0,0 +1,135 @@
+import { TodoistApi } from '@doist/todoist-sdk';
+import { z } from 'zod';
+declare const updateTasks: {
+    name: "update-tasks";
+    description: string;
+    parameters: {
+        tasks: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            content: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            projectId: z.ZodOptional<z.ZodString>;
+            sectionId: z.ZodOptional<z.ZodString>;
+            parentId: z.ZodOptional<z.ZodString>;
+            order: z.ZodOptional<z.ZodNumber>;
+            priority: z.ZodOptional<z.ZodEnum<{
+                p1: "p1";
+                p2: "p2";
+                p3: "p3";
+                p4: "p4";
+            }>>;
+            dueString: z.ZodOptional<z.ZodPreprocess<z.ZodString, unknown>>;
+            replaceRecurrence: z.ZodOptional<z.ZodBoolean>;
+            deadlineDate: z.ZodOptional<z.ZodPreprocess<z.ZodString, unknown>>;
+            duration: z.ZodOptional<z.ZodString>;
+            responsibleUser: z.ZodOptional<z.ZodPreprocess<z.ZodString, unknown>>;
+            labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            isUncompletable: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    };
+    outputSchema: {
+        tasks: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            content: z.ZodString;
+            description: z.ZodString;
+            dueDate: z.ZodOptional<z.ZodString>;
+            recurring: z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>;
+            deadlineDate: z.ZodOptional<z.ZodString>;
+            priority: z.ZodEnum<{
+                p1: "p1";
+                p2: "p2";
+                p3: "p3";
+                p4: "p4";
+            }>;
+            projectId: z.ZodString;
+            sectionId: z.ZodOptional<z.ZodString>;
+            parentId: z.ZodOptional<z.ZodString>;
+            labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            duration: z.ZodOptional<z.ZodString>;
+            responsibleUid: z.ZodOptional<z.ZodString>;
+            isUncompletable: z.ZodOptional<z.ZodBoolean>;
+            assignedByUid: z.ZodOptional<z.ZodString>;
+            isDeleted: z.ZodOptional<z.ZodBoolean>;
+            checked: z.ZodBoolean;
+            completedAt: z.ZodOptional<z.ZodString>;
+            addedAt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        totalCount: z.ZodNumber;
+        updatedTaskIds: z.ZodArray<z.ZodString>;
+        failures: z.ZodArray<z.ZodObject<{
+            item: z.ZodString;
+            error: z.ZodString;
+            code: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        appliedOperations: z.ZodObject<{
+            updateCount: z.ZodNumber;
+            skippedCount: z.ZodNumber;
+            failureCount: z.ZodNumber;
+            redundantMovesSkipped: z.ZodNumber;
+        }, z.core.$strip>;
+    };
+    annotations: {
+        readOnlyHint: false;
+        destructiveHint: true;
+        idempotentHint: false;
+        openWorldHint: true;
+    };
+    execute(args: {
+        tasks: {
+            id: string;
+            content?: string | undefined;
+            description?: string | undefined;
+            projectId?: string | undefined;
+            sectionId?: string | undefined;
+            parentId?: string | undefined;
+            order?: number | undefined;
+            priority?: "p1" | "p2" | "p3" | "p4" | undefined;
+            dueString?: string | undefined;
+            replaceRecurrence?: boolean | undefined;
+            deadlineDate?: string | undefined;
+            duration?: string | undefined;
+            responsibleUser?: string | undefined;
+            labels?: string[] | undefined;
+            isUncompletable?: boolean | undefined;
+        }[];
+    }, client: TodoistApi): Promise<{
+        textContent: string;
+        structuredContent: {
+            tasks: {
+                id: string;
+                content: string;
+                description: string;
+                dueDate: string | undefined;
+                recurring: string | boolean;
+                deadlineDate: string | undefined;
+                priority: "p1" | "p2" | "p3" | "p4";
+                projectId: string;
+                sectionId: string | undefined;
+                parentId: string | undefined;
+                labels: string[];
+                duration: string | undefined;
+                responsibleUid: string | undefined;
+                assignedByUid: string | undefined;
+                isDeleted: true | undefined;
+                checked: boolean;
+                completedAt: string | undefined;
+                addedAt: string | undefined;
+            }[];
+            totalCount: number;
+            updatedTaskIds: string[];
+            failures: {
+                item: string;
+                error: string;
+                code?: string;
+            }[];
+            appliedOperations: {
+                updateCount: number;
+                skippedCount: number;
+                failureCount: number;
+                redundantMovesSkipped: number;
+            };
+        };
+    }>;
+};
+export { updateTasks };
+//# sourceMappingURL=update-tasks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-tasks.d.ts","sourceRoot":"","sources":["../../src/tools/update-tasks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIR,UAAU,EAEb,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAiMvB,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAiOW,MAAM;uBAAS,MAAM;uBAAS,MAAM;;;;;;;;;;CARD,CAAA;AA0f/D,OAAO,EAAE,WAAW,EAAE,CAAA"}

package/dist/tools/user-info.d.ts

@@ -0,0 +1,57 @@
+import { TodoistApi } from '@doist/todoist-sdk';
+import { z } from 'zod';
+type UserPlan = 'Todoist Free' | 'Todoist Pro' | 'Todoist Business';
+type UserInfoStructured = Record<string, unknown> & {
+    type: 'user_info';
+    userId: string;
+    fullName: string;
+    timezone: string;
+    currentLocalTime: string;
+    startDay: number;
+    startDayName: string;
+    weekStartDate: string;
+    weekEndDate: string;
+    currentWeekNumber: number;
+    completedToday: number;
+    dailyGoal: number;
+    weeklyGoal: number;
+    email: string;
+    plan: UserPlan;
+};
+declare const userInfo: {
+    name: "user-info";
+    description: string;
+    parameters: {};
+    outputSchema: {
+        type: z.ZodLiteral<"user_info">;
+        userId: z.ZodString;
+        fullName: z.ZodString;
+        timezone: z.ZodString;
+        currentLocalTime: z.ZodString;
+        startDay: z.ZodNumber;
+        startDayName: z.ZodString;
+        weekStartDate: z.ZodString;
+        weekEndDate: z.ZodString;
+        currentWeekNumber: z.ZodNumber;
+        completedToday: z.ZodNumber;
+        dailyGoal: z.ZodNumber;
+        weeklyGoal: z.ZodNumber;
+        email: z.ZodString;
+        plan: z.ZodEnum<{
+            "Todoist Free": "Todoist Free";
+            "Todoist Pro": "Todoist Pro";
+            "Todoist Business": "Todoist Business";
+        }>;
+    };
+    annotations: {
+        readOnlyHint: true;
+        destructiveHint: false;
+        idempotentHint: true;
+    };
+    execute(_args: Record<string, never>, client: TodoistApi): Promise<{
+        textContent: string;
+        structuredContent: UserInfoStructured;
+    }>;
+};
+export { type UserInfoStructured, userInfo };
+//# sourceMappingURL=user-info.d.ts.map

package/dist/tools/user-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-info.d.ts","sourceRoot":"","sources":["../../src/tools/user-info.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAyBvB,KAAK,QAAQ,GAAG,cAAc,GAAG,aAAa,GAAG,kBAAkB,CAAA;AAEnE,KAAK,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAChD,IAAI,EAAE,WAAW,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,gBAAgB,EAAE,MAAM,CAAA;IACxB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,iBAAiB,EAAE,MAAM,CAAA;IACzB,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,QAAQ,CAAA;CACjB,CAAA;AAgJD,QAAA,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAeiD,CAAA;AAE/D,OAAO,EAAE,KAAK,kBAAkB,EAAE,QAAQ,EAAE,CAAA"}

package/dist/tools/view-attachment.d.ts

@@ -0,0 +1,25 @@
+import { ContentBlock } from '@modelcontextprotocol/server';
+import { z } from 'zod';
+declare const viewAttachment: {
+    name: "view-attachment";
+    description: string;
+    parameters: {
+        fileUrl: z.ZodURL;
+    };
+    annotations: {
+        readOnlyHint: true;
+        destructiveHint: false;
+        idempotentHint: true;
+    };
+    execute({ fileUrl }: {
+        fileUrl: string;
+    }, client: import('@doist/todoist-sdk').TodoistApi): Promise<{
+        textContent: string;
+        contentItems?: undefined;
+    } | {
+        textContent: string;
+        contentItems: ContentBlock[];
+    }>;
+};
+export { viewAttachment };
+//# sourceMappingURL=view-attachment.d.ts.map

package/dist/tools/view-attachment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-attachment.d.ts","sourceRoot":"","sources":["../../src/tools/view-attachment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAoFvB,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;CAuEsB,CAAA;AAE1C,OAAO,EAAE,cAAc,EAAE,CAAA"}

package/dist/usage-tracking.d.ts

@@ -0,0 +1,36 @@
+import { CustomFetch, TodoistApi } from '@doist/todoist-sdk';
+declare const TODOIST_MCP_VERSION: string;
+type UsageTrackingConfig = {
+    enabled?: boolean;
+    platform?: string;
+    sessionId?: string;
+};
+type DefaultTransport = {
+    dispatcher: unknown;
+    fetch?: typeof fetch;
+};
+type DispatcherModule = {
+    getDefaultTransport: () => Promise<DefaultTransport | undefined>;
+};
+export declare function normalizeUsageLabel(label: string): string;
+export declare function runWithUsageTrackingContext<T>(label: string, fn: () => T): T;
+export declare function buildUsageTrackingHeaders({ label, platform, sessionId, }?: {
+    label?: string;
+    platform?: string;
+    sessionId?: string;
+}): Record<string, string>;
+export declare function resetDefaultDispatcherForTests(): Promise<void>;
+export declare function setDispatcherModuleLoaderForTests(loader: () => Promise<DispatcherModule>): void;
+export declare function resetDispatcherModuleLoaderForTests(): void;
+/**
+ * Sends a request the way the SDK sends its own: through its default dispatcher, which honours
+ * `HTTP_PROXY`, `HTTPS_PROXY` and `NO_PROXY`, with the `fetch` paired to it.
+ */
+export declare function fetchThroughSdkTransport(url: string | URL, init: RequestInit): Promise<Response>;
+export declare function createTrackedFetch(baseFetch?: typeof fetch, tracking?: UsageTrackingConfig): CustomFetch;
+export declare function createTodoistClient(apiKey: string, { baseUrl, tracking, }?: {
+    baseUrl?: string;
+    tracking?: UsageTrackingConfig;
+}): TodoistApi;
+export { TODOIST_MCP_VERSION };
+//# sourceMappingURL=usage-tracking.d.ts.map

package/dist/usage-tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-tracking.d.ts","sourceRoot":"","sources":["../src/usage-tracking.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,WAAW,EAA4B,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAK3F,QAAA,MAAM,mBAAmB,QAAsB,CAAA;AAI/C,KAAK,mBAAmB,GAAG;IACvB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,KAAK,gBAAgB,GAAG;IACpB,UAAU,EAAE,OAAO,CAAA;IACnB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CACvB,CAAA;AAED,KAAK,gBAAgB,GAAG;IACpB,mBAAmB,EAAE,MAAM,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAA;CACnE,CAAA;AAcD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAE5E;AAED,wBAAgB,yBAAyB,CAAC,EACtC,KAAK,EACL,QAAgB,EAChB,SAAwB,GAC3B,GAAE;IACC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CAChB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAW9B;AAkGD,wBAAsB,8BAA8B,IAAI,OAAO,CAAC,IAAI,CAAC,CAcpE;AAED,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAE/F;AAED,wBAAgB,mCAAmC,IAAI,IAAI,CAE1D;AAuBD;;;GAGG;AACH,wBAAsB,wBAAwB,CAC1C,GAAG,EAAE,MAAM,GAAG,GAAG,EACjB,IAAI,EAAE,WAAW,GAClB,OAAO,CAAC,QAAQ,CAAC,CAInB;AAcD,wBAAgB,kBAAkB,CAC9B,SAAS,GAAE,OAAO,KAAwB,EAC1C,QAAQ,GAAE,mBAAwB,GACnC,WAAW,CA+Bb;AAED,wBAAgB,mBAAmB,CAC/B,MAAM,EAAE,MAAM,EACd,EACI,OAAO,EACP,QAAQ,GACX,GAAE;IACC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,mBAAmB,CAAA;CAC5B,GACP,UAAU,CAUZ;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAA"}

package/dist/utils/assignment-validator.d.ts

@@ -0,0 +1,69 @@
+import { TodoistApi } from '@doist/todoist-sdk';
+import { ResolvedUser } from './user-resolver.js';
+export declare const AssignmentErrorType: {
+    readonly USER_NOT_FOUND: "USER_NOT_FOUND";
+    readonly USER_NOT_COLLABORATOR: "USER_NOT_COLLABORATOR";
+    readonly PROJECT_NOT_SHARED: "PROJECT_NOT_SHARED";
+    readonly TASK_NOT_ACCESSIBLE: "TASK_NOT_ACCESSIBLE";
+    readonly PERMISSION_DENIED: "PERMISSION_DENIED";
+    readonly PROJECT_NOT_FOUND: "PROJECT_NOT_FOUND";
+    readonly TASK_NOT_FOUND: "TASK_NOT_FOUND";
+};
+export type AssignmentErrorType = (typeof AssignmentErrorType)[keyof typeof AssignmentErrorType];
+export type ValidationError = {
+    type: AssignmentErrorType;
+    message: string;
+    suggestions?: string[];
+};
+export type ValidationResult = {
+    isValid: boolean;
+    resolvedUser?: ResolvedUser;
+    error?: ValidationError;
+    taskId?: string;
+    projectId?: string;
+};
+export type Assignment = {
+    taskId?: string;
+    projectId: string;
+    responsibleUid: string;
+};
+export declare class AssignmentValidator {
+    /**
+     * Validate a single assignment operation
+     */
+    validateAssignment(client: TodoistApi, assignment: Assignment): Promise<ValidationResult>;
+    /**
+     * Validate multiple assignment operations in bulk
+     */
+    validateBulkAssignment(client: TodoistApi, assignments: Assignment[]): Promise<ValidationResult[]>;
+    /**
+     * Validate assignment for task creation (no taskId required)
+     */
+    validateTaskCreationAssignment(client: TodoistApi, projectId: string, responsibleUid: string): Promise<ValidationResult>;
+    /**
+     * Validate assignment for task update
+     */
+    validateTaskUpdateAssignment(client: TodoistApi, taskId: string, responsibleUid: string | null): Promise<ValidationResult>;
+    /**
+     * Get detailed assignment eligibility information for troubleshooting
+     */
+    getAssignmentEligibility(client: TodoistApi, projectId: string, responsibleUid: string, taskIds?: string[]): Promise<{
+        canAssign: boolean;
+        projectInfo: {
+            name: string;
+            isShared: boolean;
+            collaboratorCount: number;
+        };
+        userInfo?: {
+            resolvedName: string;
+            isCollaborator: boolean;
+        };
+        taskInfo?: {
+            accessibleTasks: number;
+            inaccessibleTasks: number;
+        };
+        recommendations: string[];
+    }>;
+}
+export declare const assignmentValidator: AssignmentValidator;
+//# sourceMappingURL=assignment-validator.d.ts.map

package/dist/utils/assignment-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assignment-validator.d.ts","sourceRoot":"","sources":["../../src/utils/assignment-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAEpD,OAAO,EAAE,KAAK,YAAY,EAAgB,MAAM,oBAAoB,CAAA;AAEpE,eAAO,MAAM,mBAAmB;;;;;;;;CAQtB,CAAA;AAEV,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAA;AAEhG,MAAM,MAAM,eAAe,GAAG;IAC1B,IAAI,EAAE,mBAAmB,CAAA;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC3B,OAAO,EAAE,OAAO,CAAA;IAChB,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,KAAK,CAAC,EAAE,eAAe,CAAA;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;CACzB,CAAA;AAED,qBAAa,mBAAmB;IAC5B;;OAEG;IACG,kBAAkB,CACpB,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,UAAU,GACvB,OAAO,CAAC,gBAAgB,CAAC;IAqH5B;;OAEG;IACG,sBAAsB,CACxB,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,UAAU,EAAE,GAC1B,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAS9B;;OAEG;IACG,8BAA8B,CAChC,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,GACvB,OAAO,CAAC,gBAAgB,CAAC;IAO5B;;OAEG;IACG,4BAA4B,CAC9B,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,GAAG,IAAI,GAC9B,OAAO,CAAC,gBAAgB,CAAC;IAkC5B;;OAEG;IACG,wBAAwB,CAC1B,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC;QACP,SAAS,EAAE,OAAO,CAAA;QAClB,WAAW,EAAE;YACT,IAAI,EAAE,MAAM,CAAA;YACZ,QAAQ,EAAE,OAAO,CAAA;YACjB,iBAAiB,EAAE,MAAM,CAAA;SAC5B,CAAA;QACD,QAAQ,CAAC,EAAE;YACP,YAAY,EAAE,MAAM,CAAA;YACpB,cAAc,EAAE,OAAO,CAAA;SAC1B,CAAA;QACD,QAAQ,CAAC,EAAE;YACP,eAAe,EAAE,MAAM,CAAA;YACvB,iBAAiB,EAAE,MAAM,CAAA;SAC5B,CAAA;QACD,eAAe,EAAE,MAAM,EAAE,CAAA;KAC5B,CAAC;CAqFL;AAGD,eAAO,MAAM,mBAAmB,qBAA4B,CAAA"}

package/dist/utils/batch-failures.d.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import { FailureSchema } from './output-schemas.js';
+import { ToolName } from './tool-names.js';
+type BatchFailure = z.infer<typeof FailureSchema>;
+/**
+ * Records the items a batch tool could not act on.
+ *
+ * These failures are reported in the tool result rather than thrown, so the
+ * server answers 200 and logs nothing while the caller's items stay untouched.
+ * A whole batch can fail on an expired token or a dropped connection with no
+ * trace on this side, which leaves nothing to diagnose from afterwards.
+ *
+ * @param toolName - The tool that ran the batch, for the log prefix.
+ * @param total - How many items the caller asked for.
+ * @param failures - The items that failed, as reported in the result.
+ * @param options.redactItems - Set where `item` is the caller's own text rather
+ * than an identifier, e.g. a task title. That text can carry personal data and
+ * must not reach server logs; the error and its code carry the diagnosis anyway.
+ * Quoted text inside each error is always redacted, for the same reason.
+ */
+export declare function logBatchFailures(toolName: ToolName, total: number, failures: ReadonlyArray<BatchFailure>, options?: {
+    redactItems?: boolean;
+}): void;
+export {};
+//# sourceMappingURL=batch-failures.d.ts.map

package/dist/utils/batch-failures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-failures.d.ts","sourceRoot":"","sources":["../../src/utils/batch-failures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAE5B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE/C,KAAK,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AAWjD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAC5B,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,EACrC,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACxC,IAAI,CAkBN"}

package/dist/utils/children.d.ts

@@ -0,0 +1,68 @@
+import { TodoistApi } from '@doist/todoist-sdk';
+import { z } from 'zod';
+import { Project } from '../tool-helpers.js';
+declare const ChildTaskSchema: z.ZodObject<{
+    content: z.ZodString;
+    id: z.ZodString;
+    checked: z.ZodBoolean;
+    dueDate: z.ZodOptional<z.ZodString>;
+    hasChildren: z.ZodBoolean;
+}, z.core.$strip>;
+declare const ChildProjectSchema: z.ZodObject<{
+    name: z.ZodString;
+    id: z.ZodString;
+    hasChildren: z.ZodBoolean;
+}, z.core.$strip>;
+/**
+ * Output schema fragment for tools that can return an object's direct children.
+ * Spread it into the tool's own output schema.
+ */
+declare const ChildrenOutputSchema: {
+    childCount: z.ZodOptional<z.ZodNumber>;
+    children: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        content: z.ZodString;
+        id: z.ZodString;
+        checked: z.ZodBoolean;
+        dueDate: z.ZodOptional<z.ZodString>;
+        hasChildren: z.ZodBoolean;
+    }, z.core.$strip>, z.ZodObject<{
+        name: z.ZodString;
+        id: z.ZodString;
+        hasChildren: z.ZodBoolean;
+    }, z.core.$strip>]>>>;
+    hasMoreChildren: z.ZodOptional<z.ZodBoolean>;
+    childrenError: z.ZodOptional<z.ZodString>;
+};
+type ChildSummary = z.infer<typeof ChildTaskSchema> | z.infer<typeof ChildProjectSchema>;
+type ChildrenResult = {
+    childCount?: number;
+    children?: ChildSummary[];
+    hasMoreChildren?: boolean;
+    childrenError?: string;
+};
+/**
+ * Fetches the direct subtasks of a task, flagging which of them nest further.
+ *
+ * The API exposes no child count on a task, so each child needs its own probe.
+ * That keeps the cost proportional to the number of subtasks rather than to the
+ * size of the project, which matters because the common case is a task with none.
+ */
+declare function getTaskChildren(client: TodoistApi, taskId: string): Promise<ChildrenResult>;
+/**
+ * Fetches the direct sub-projects of a project, flagging which of them nest further.
+ *
+ * Projects cannot be filtered by parent server-side, so the hierarchy is derived
+ * from a single fetch of every active project.
+ */
+declare function getProjectChildren(client: TodoistApi, project: Project): Promise<ChildrenResult>;
+/**
+ * Runs a children lookup without letting its failure sink the fetch it belongs to.
+ * The error is reported rather than swallowed: a missing childCount would otherwise
+ * read as "no children", which is the exact mistake these fields exist to prevent.
+ */
+declare function resolveChildren(load: () => Promise<ChildrenResult>): Promise<ChildrenResult>;
+/** Renders a children result as a suffix for a tool's one-line text summary. */
+declare function formatChildrenSummary(label: string, result: ChildrenResult): string;
+export { ChildrenOutputSchema, formatChildrenSummary, getProjectChildren, getTaskChildren, resolveChildren, };
+export type { ChildrenResult };
+//# sourceMappingURL=children.d.ts.map

package/dist/utils/children.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"children.d.ts","sourceRoot":"","sources":["../../src/utils/children.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACrE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAA6C,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAI5F,QAAA,MAAM,eAAe;;;;;;iBAWnB,CAAA;AAEF,QAAA,MAAM,kBAAkB;;;;iBAMtB,CAAA;AAEF;;;GAGG;AACH,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;CAyBzB,CAAA;AAED,KAAK,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAExF,KAAK,cAAc,GAAG;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAA;IACzB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,aAAa,CAAC,EAAE,MAAM,CAAA;CACzB,CAAA;AAED;;;;;;GAMG;AACH,iBAAe,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA8B1F;AAED;;;;;GAKG;AACH,iBAAe,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CA4B/F;AAED;;;;GAIG;AACH,iBAAe,eAAe,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAM3F;AAED,gFAAgF;AAChF,iBAAS,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM,CAO5E;AAED,OAAO,EACH,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,eAAe,GAClB,CAAA;AACD,YAAY,EAAE,cAAc,EAAE,CAAA"}

package/dist/utils/colors.d.ts

@@ -0,0 +1,68 @@
+import { z } from 'zod';
+export declare const ColorSchema: z.ZodPreprocess<z.ZodOptional<z.ZodEnum<{
+    berry_red: "berry_red";
+    red: "red";
+    orange: "orange";
+    yellow: "yellow";
+    olive_green: "olive_green";
+    lime_green: "lime_green";
+    green: "green";
+    mint_green: "mint_green";
+    teal: "teal";
+    sky_blue: "sky_blue";
+    light_blue: "light_blue";
+    blue: "blue";
+    grape: "grape";
+    violet: "violet";
+    lavender: "lavender";
+    magenta: "magenta";
+    salmon: "salmon";
+    charcoal: "charcoal";
+    grey: "grey";
+    taupe: "taupe";
+}>>, unknown>;
+export declare const ColorKeySchema: z.ZodEnum<{
+    berry_red: "berry_red";
+    red: "red";
+    orange: "orange";
+    yellow: "yellow";
+    olive_green: "olive_green";
+    lime_green: "lime_green";
+    green: "green";
+    mint_green: "mint_green";
+    teal: "teal";
+    sky_blue: "sky_blue";
+    light_blue: "light_blue";
+    blue: "blue";
+    grape: "grape";
+    violet: "violet";
+    lavender: "lavender";
+    magenta: "magenta";
+    salmon: "salmon";
+    charcoal: "charcoal";
+    grey: "grey";
+    taupe: "taupe";
+}>;
+export declare const ColorOutputSchema: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
+    berry_red: "berry_red";
+    red: "red";
+    orange: "orange";
+    yellow: "yellow";
+    olive_green: "olive_green";
+    lime_green: "lime_green";
+    green: "green";
+    mint_green: "mint_green";
+    teal: "teal";
+    sky_blue: "sky_blue";
+    light_blue: "light_blue";
+    blue: "blue";
+    grape: "grape";
+    violet: "violet";
+    lavender: "lavender";
+    magenta: "magenta";
+    salmon: "salmon";
+    charcoal: "charcoal";
+    grey: "grey";
+    taupe: "taupe";
+}>>>;
+//# sourceMappingURL=colors.d.ts.map

package/dist/utils/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/utils/colors.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAmBvB,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;aAEO,CAAA;AAG/B,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;EAAoB,CAAA;AAQ/C,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;IAAgD,CAAA"}

package/dist/utils/comment-recipients.d.ts

@@ -0,0 +1,35 @@
+import { Task, TodoistApi } from '@doist/todoist-sdk';
+/** Value that tells `add-comments` to post without notifying anyone. */
+export declare const NO_NOTIFY_KEYWORD = "none";
+export type CommentTarget = {
+    taskId: string;
+    projectId?: never;
+} | {
+    projectId: string;
+    taskId?: never;
+};
+/** Whether a `notifyUsers` list is the explicit "notify nobody" opt-out. */
+export declare function isNoNotifyList(notifyUsers: string[]): boolean;
+/**
+ * Work out who Todoist's own clients would notify about a new comment.
+ *
+ * The API notifies exactly the people it is handed and derives nobody itself,
+ * so a comment posted without recipients notifies no one — and, because a reply
+ * takes its recipients from the comment before it, silences the next comment in
+ * the thread too. Mirroring the clients here keeps that chain intact:
+ *
+ * - replying to an existing thread notifies the previous comment's participants
+ * - the first comment on a task notifies its assignee, assigner and creator
+ * - the first comment on a project notifies nobody, as a project has no assignee
+ *
+ * The comment's own author is never a recipient.
+ *
+ * @param client - Todoist API client
+ * @param target - The task or project being commented on
+ * @param currentUserId - The authenticated user, excluded from the result
+ * @param getTask - Reads the task being commented on, so a caller that also
+ * needs it can share the one request
+ * @returns User IDs to notify, deduplicated
+ */
+export declare function getDefaultCommentRecipients(client: TodoistApi, target: CommentTarget, currentUserId: string, getTask?: (taskId: string) => Promise<Task>): Promise<string[]>;
+//# sourceMappingURL=comment-recipients.d.ts.map

package/dist/utils/comment-recipients.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-recipients.d.ts","sourceRoot":"","sources":["../../src/utils/comment-recipients.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgC,IAAI,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAExF,wEAAwE;AACxE,eAAO,MAAM,iBAAiB,SAAS,CAAA;AAEvC,MAAM,MAAM,aAAa,GACnB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,KAAK,CAAA;CAAE,GACrC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,KAAK,CAAA;CAAE,CAAA;AAE3C,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAE7D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,2BAA2B,CAC7C,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,aAAa,EACrB,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAsC,GAChF,OAAO,CAAC,MAAM,EAAE,CAAC,CAgBnB"}

package/dist/utils/concurrency.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Wraps a task so it only runs once a slot is free.
+ */
+type Limiter = <T>(fn: () => Promise<T>) => Promise<T>;
+type TrackedLimiter = Limiter & {
+    /** Whether no task is running or waiting for this limiter. */
+    isIdle: () => boolean;
+};
+/**
+ * A FIFO semaphore. Tasks beyond `maxConcurrent` queue and start as slots free up.
+ *
+ * Deliberately applied at the tool layer rather than inside the SDK's
+ * `customFetch`: the SDK installs its request-timeout `AbortSignal` *before*
+ * calling `customFetch`, so gating there would charge queue time against the
+ * request timeout and fail long-queued requests that never actually ran.
+ *
+ * That same property is why queued tasks need their own deadline. A task's request
+ * timeout only starts once it reaches the front of the queue, so without one a task
+ * can wait indefinitely — long past the point its caller gave up — and then still
+ * issue its request. `queueTimeoutMs` bounds the wait instead, failing the task with
+ * a reason that says the request was never sent.
+ */
+declare function createLimiter(maxConcurrent: number, { queueTimeoutMs }?: {
+    queueTimeoutMs?: number;
+}): TrackedLimiter;
+/** Records the account key so each limited operation can resolve its current pair. */
+declare function registerClientLimiters(client: object, apiKey: string): void;
+declare function getMoveLimiter(client: object): Limiter;
+declare function getWriteLimiter(client: object): Limiter;
+/** Test-only: drops all registered limiters so cases start from a clean slate. */
+declare function resetLimitersForTesting({ maxAccountLimiters, }?: {
+    maxAccountLimiters?: number;
+}): void;
+export { createLimiter, getMoveLimiter, getWriteLimiter, type Limiter, registerClientLimiters, resetLimitersForTesting, };
+//# sourceMappingURL=concurrency.d.ts.map

package/dist/utils/concurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.d.ts","sourceRoot":"","sources":["../../src/utils/concurrency.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,KAAK,OAAO,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;AAEtD,KAAK,cAAc,GAAG,OAAO,GAAG;IAC5B,8DAA8D;IAC9D,MAAM,EAAE,MAAM,OAAO,CAAA;CACxB,CAAA;AAeD;;;;;;;;;;;;;GAaG;AACH,iBAAS,aAAa,CAClB,aAAa,EAAE,MAAM,EACrB,EAAE,cAAgD,EAAE,GAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAO,GACvF,cAAc,CAgEhB;AAoKD,sFAAsF;AACtF,iBAAS,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAGpE;AAuBD,iBAAS,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,iBAAS,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED,kFAAkF;AAClF,iBAAS,uBAAuB,CAAC,EAC7B,kBAAyC,GAC5C,GAAE;IAAE,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,IAAI,CAM7C;AAED,OAAO,EACH,aAAa,EACb,cAAc,EACd,eAAe,EACf,KAAK,OAAO,EACZ,sBAAsB,EACtB,uBAAuB,GAC1B,CAAA"}