vikunja-mcp-ng 0.4.0

package/dist/tools/tasks/attachments.js

@@ -0,0 +1,153 @@
+"use strict";
+/**
+ * Attachments read-side subcommands of `vikunja_tasks`.
+ *
+ * Complements `attach.ts`'s upload path (`PUT /tasks/{id}/attachments`) with:
+ *   - `list-attachments`:    `GET /tasks/{id}/attachments` (page/per_page).
+ *   - `get-attachment-info`: metadata for one attachment. The spec has no
+ *     single-attachment metadata endpoint — `GET
+ *     /tasks/{id}/attachments/{attachmentID}` returns the raw file bytes,
+ *     not JSON — so this is derived by fetching the list and finding the
+ *     matching id, the same fetch-list-and-filter shape `vikunja_webhooks`
+ *     uses for its `get` subcommand (no per-id GET exists there either).
+ *   - `delete-attachment`:   `DELETE /tasks/{id}/attachments/{attachmentID}`.
+ *   - `download-attachment`: per the OpenAPI spec, `GET
+ *     /tasks/{id}/attachments/{attachmentID}` produces
+ *     `application/octet-stream`. MCP has no binary/file-delivery channel
+ *     (see docs/API_NOTES.md's "MCP-Specific Limitations"), so this cannot
+ *     fetch and hand back the file itself. Honesty over pretending
+ *     (docs/ENDPOINT-PLAYBOOK.md §7): it returns the direct download URL and
+ *     the auth header the caller needs to fetch it themselves — the same
+ *     shape as `vikunja_download_user_export` in `src/tools/export.ts`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listAttachments = listAttachments;
+exports.getAttachmentInfo = getAttachmentInfo;
+exports.deleteAttachment = deleteAttachment;
+exports.downloadAttachment = downloadAttachment;
+const types_1 = require("../../types");
+const validation_1 = require("../../utils/validation");
+const response_factory_1 = require("../../utils/response-factory");
+const vikunja_rest_1 = require("../../utils/vikunja-rest");
+function requireTaskId(args, op) {
+    if (args.id === undefined || args.id === null) {
+        throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, `Task id is required for ${op}`);
+    }
+    (0, validation_1.validateId)(args.id, 'id');
+    return args.id;
+}
+function requireAttachmentId(args, op) {
+    if (args.attachmentId === undefined || args.attachmentId === null) {
+        throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, `attachmentId is required for ${op}`);
+    }
+    (0, validation_1.validateId)(args.attachmentId, 'attachmentId');
+    return args.attachmentId;
+}
+function buildPaginationQuery(args) {
+    if (args.page !== undefined)
+        (0, validation_1.validateId)(args.page, 'page');
+    if (args.perPage !== undefined)
+        (0, validation_1.validateId)(args.perPage, 'perPage');
+    const params = new URLSearchParams();
+    if (args.page !== undefined)
+        params.set('page', String(args.page));
+    if (args.perPage !== undefined)
+        params.set('per_page', String(args.perPage));
+    const qs = params.toString();
+    return qs ? `?${qs}` : '';
+}
+async function fetchAttachments(authManager, taskId, args) {
+    const items = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'GET', `/tasks/${taskId}/attachments${buildPaginationQuery(args)}`);
+    return Array.isArray(items) ? items : [];
+}
+function summarizeAttachment(attachment) {
+    return {
+        id: attachment.id ?? null,
+        filename: attachment.file?.name ?? null,
+        size: attachment.file?.size ?? null,
+        mime: attachment.file?.mime ?? null,
+        created: attachment.created ?? null,
+        createdBy: attachment.created_by
+            ? {
+                id: attachment.created_by.id ?? null,
+                username: attachment.created_by.username ?? null,
+                name: attachment.created_by.name ?? null,
+            }
+            : null,
+    };
+}
+/**
+ * Lists a task's attachments (`GET /tasks/{id}/attachments`).
+ */
+async function listAttachments(args, authManager) {
+    const taskId = requireTaskId(args, 'list-attachments operation');
+    const attachments = await fetchAttachments(authManager, taskId, args);
+    const response = (0, response_factory_1.createStandardResponse)('list-attachments', `Task ${taskId} has ${attachments.length} attachment(s)`, {
+        taskId,
+        attachments: attachments.map(summarizeAttachment),
+        count: attachments.length,
+    }, {
+        timestamp: new Date().toISOString(),
+        count: attachments.length,
+        ...(args.page !== undefined ? { page: args.page } : {}),
+        ...(args.perPage !== undefined ? { perPage: args.perPage } : {}),
+    }, args.sessionId);
+    return { content: [{ type: 'text', text: (0, response_factory_1.formatAorpAsMarkdown)(response) }] };
+}
+/**
+ * Retrieves metadata (file name, size, mime, created, author) for a single
+ * attachment. There is no dedicated single-attachment metadata endpoint in
+ * the spec, so this fetches the list and picks out the matching id.
+ */
+async function getAttachmentInfo(args, authManager) {
+    const taskId = requireTaskId(args, 'get-attachment-info operation');
+    const attachmentId = requireAttachmentId(args, 'get-attachment-info operation');
+    const attachments = await fetchAttachments(authManager, taskId, args);
+    const attachment = attachments.find((a) => a.id === attachmentId);
+    if (!attachment) {
+        throw new types_1.MCPError(types_1.ErrorCode.NOT_FOUND, `Attachment ${attachmentId} not found on task ${taskId}` +
+            (args.page !== undefined || args.perPage !== undefined
+                ? ' on the requested page — pass a different page/perPage to search elsewhere'
+                : ' on the default page — pass page/perPage to search further pages if the task has many attachments'));
+    }
+    const response = (0, response_factory_1.createStandardResponse)('get-attachment-info', `Retrieved metadata for attachment ${attachmentId} on task ${taskId}`, { taskId, ...summarizeAttachment(attachment) }, { timestamp: new Date().toISOString() }, args.sessionId);
+    return { content: [{ type: 'text', text: (0, response_factory_1.formatAorpAsMarkdown)(response) }] };
+}
+/**
+ * Deletes an attachment (`DELETE /tasks/{id}/attachments/{attachmentID}`).
+ */
+async function deleteAttachment(args, authManager) {
+    const taskId = requireTaskId(args, 'delete-attachment operation');
+    const attachmentId = requireAttachmentId(args, 'delete-attachment operation');
+    await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'DELETE', `/tasks/${taskId}/attachments/${attachmentId}`);
+    const response = (0, response_factory_1.createStandardResponse)('delete-attachment', `Deleted attachment ${attachmentId} from task ${taskId}`, { taskId, attachmentId, deleted: true }, { timestamp: new Date().toISOString(), affectedFields: ['attachments'] }, args.sessionId);
+    return { content: [{ type: 'text', text: (0, response_factory_1.formatAorpAsMarkdown)(response) }] };
+}
+/**
+ * Returns the direct download URL for an attachment plus auth guidance,
+ * instead of pretending this tool can deliver the binary file itself. See
+ * the module doc comment for why: `GET
+ * /tasks/{id}/attachments/{attachmentID}` returns
+ * `application/octet-stream`, and MCP has no binary content channel.
+ */
+function downloadAttachment(args, authManager) {
+    const taskId = requireTaskId(args, 'download-attachment operation');
+    const attachmentId = requireAttachmentId(args, 'download-attachment operation');
+    const session = authManager.getSession();
+    const baseUrl = (0, vikunja_rest_1.resolveBaseUrl)(session.apiUrl);
+    const query = args.previewSize ? `?preview_size=${encodeURIComponent(args.previewSize)}` : '';
+    const downloadUrl = `${baseUrl}/tasks/${taskId}/attachments/${attachmentId}${query}`;
+    const response = (0, response_factory_1.createStandardResponse)('download-attachment', 'This endpoint returns application/octet-stream (the raw file bytes) per the ' +
+        'Vikunja API spec, and the MCP protocol has no channel to deliver binary ' +
+        'content through this tool. Fetch downloadUrl yourself with an ' +
+        '`Authorization: Bearer <token>` header, using the same token this server ' +
+        'is configured with, to retrieve the file.', {
+        taskId,
+        attachmentId,
+        downloadUrl,
+        authHeader: 'Authorization: Bearer <your Vikunja API token>',
+        deliveredThroughThisTool: false,
+    }, { timestamp: new Date().toISOString() }, args.sessionId);
+    return { content: [{ type: 'text', text: (0, response_factory_1.formatAorpAsMarkdown)(response) }] };
+}
+//# sourceMappingURL=attachments.js.map

package/dist/tools/tasks/attachments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.js","sourceRoot":"","sources":["../../../src/tools/tasks/attachments.ts"],"names":[],"mappings":"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"}

package/dist/tools/tasks/buckets.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Task Kanban bucket operations
+ *
+ * Implements `set-bucket`, which moves a task into a Kanban bucket (column)
+ * of its project's Kanban view. This is the operation behind a "move card to
+ * the Doing column" workflow.
+ *
+ * legacy client does not expose the Kanban view endpoints, so this calls the
+ * Vikunja REST API directly via the shared `vikunja-rest` helper.
+ */
+import type { AuthManager } from '../../auth/AuthManager';
+export interface SetTaskBucketArgs {
+    /** Id of the task to move. */
+    id?: number;
+    /** Id of the destination Kanban bucket. */
+    bucketId?: number;
+    /** Optional Kanban view id. Auto-resolved from the project when omitted. */
+    viewId?: number;
+    /** Optional project id. Auto-resolved from the task when omitted. */
+    projectId?: number;
+    /** Session id for response tracking. */
+    sessionId?: string;
+}
+/**
+ * Moves a task into a Kanban bucket.
+ *
+ * Resolution order when optional ids are omitted:
+ *  - projectId: fetched from the task itself
+ *  - viewId: resolved to the project's Kanban view
+ *
+ * @param args - Task id, destination bucket id, and optional view/project ids
+ * @param authManager - Active auth manager holding session credentials
+ * @returns MCP response describing the move
+ */
+export declare function setTaskBucket(args: SetTaskBucketArgs, authManager: AuthManager): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=buckets.d.ts.map

package/dist/tools/tasks/buckets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buckets.d.ts","sourceRoot":"","sources":["../../../src/tools/tasks/buckets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAM1D,MAAM,WAAW,iBAAiB;IAChC,8BAA8B;IAC9B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAQD;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,iBAAiB,EACvB,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAsE7D"}

package/dist/tools/tasks/buckets.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * Task Kanban bucket operations
+ *
+ * Implements `set-bucket`, which moves a task into a Kanban bucket (column)
+ * of its project's Kanban view. This is the operation behind a "move card to
+ * the Doing column" workflow.
+ *
+ * legacy client does not expose the Kanban view endpoints, so this calls the
+ * Vikunja REST API directly via the shared `vikunja-rest` helper.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setTaskBucket = setTaskBucket;
+const types_1 = require("../../types");
+const validation_1 = require("../../utils/validation");
+const response_factory_1 = require("../../utils/response-factory");
+const vikunja_rest_1 = require("../../utils/vikunja-rest");
+/**
+ * Moves a task into a Kanban bucket.
+ *
+ * Resolution order when optional ids are omitted:
+ *  - projectId: fetched from the task itself
+ *  - viewId: resolved to the project's Kanban view
+ *
+ * @param args - Task id, destination bucket id, and optional view/project ids
+ * @param authManager - Active auth manager holding session credentials
+ * @returns MCP response describing the move
+ */
+async function setTaskBucket(args, authManager) {
+    if (!args.id) {
+        throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'Task id is required for set-bucket operation');
+    }
+    if (args.bucketId === undefined || args.bucketId === null) {
+        throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'bucketId is required for set-bucket operation');
+    }
+    (0, validation_1.validateId)(args.id, 'id');
+    (0, validation_1.validateId)(args.bucketId, 'bucketId');
+    if (args.viewId !== undefined)
+        (0, validation_1.validateId)(args.viewId, 'viewId');
+    if (args.projectId !== undefined)
+        (0, validation_1.validateId)(args.projectId, 'projectId');
+    // Resolve the project id from the task when the caller did not supply it.
+    let projectId = args.projectId;
+    if (projectId === undefined) {
+        const task = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'GET', `/tasks/${args.id}`);
+        if (!task || typeof task.project_id !== 'number') {
+            throw new types_1.MCPError(types_1.ErrorCode.NOT_FOUND, `Could not resolve the project of task ${args.id}`);
+        }
+        projectId = task.project_id;
+    }
+    // Resolve the Kanban view id when the caller did not supply it.
+    const viewId = args.viewId !== undefined ? args.viewId : await (0, vikunja_rest_1.resolveKanbanViewId)(authManager, projectId);
+    // Place the task into the bucket. Vikunja's bucket-task endpoint expects the
+    // TaskBucket payload; bucket_id is also part of the URL but is sent in the
+    // body as the API model requires it.
+    await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'POST', `/projects/${projectId}/views/${viewId}/buckets/${args.bucketId}/tasks`, { task_id: args.id, bucket_id: args.bucketId });
+    const response = (0, response_factory_1.createStandardResponse)('set-task-bucket', `Task ${args.id} moved to bucket ${args.bucketId}`, {
+        taskId: args.id,
+        bucketId: args.bucketId,
+        viewId,
+        projectId,
+    }, {
+        timestamp: new Date().toISOString(),
+        affectedFields: ['bucket_id'],
+    }, args.sessionId);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: (0, response_factory_1.formatAorpAsMarkdown)(response),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=buckets.js.map

package/dist/tools/tasks/buckets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buckets.js","sourceRoot":"","sources":["../../../src/tools/tasks/buckets.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;AAsCH,sCAyEC;AA5GD,uCAAkD;AAClD,uDAAoD;AACpD,mEAA4F;AAC5F,2DAAmF;AAqBnF;;;;;;;;;;GAUG;AACI,KAAK,UAAU,aAAa,CACjC,IAAuB,EACvB,WAAwB;IAExB,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,MAAM,IAAI,gBAAQ,CAAC,iBAAS,CAAC,gBAAgB,EAAE,8CAA8C,CAAC,CAAC;IACjG,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC1D,MAAM,IAAI,gBAAQ,CAChB,iBAAS,CAAC,gBAAgB,EAC1B,+CAA+C,CAChD,CAAC;IACJ,CAAC;IACD,IAAA,uBAAU,EAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC1B,IAAA,uBAAU,EAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACtC,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;QAAE,IAAA,uBAAU,EAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjE,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;QAAE,IAAA,uBAAU,EAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAE1E,0EAA0E;IAC1E,IAAI,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IAC/B,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,IAAA,iCAAkB,EACnC,WAAW,EACX,KAAK,EACL,UAAU,IAAI,CAAC,EAAE,EAAE,CACpB,CAAC;QACF,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YACjD,MAAM,IAAI,gBAAQ,CAChB,iBAAS,CAAC,SAAS,EACnB,yCAAyC,IAAI,CAAC,EAAE,EAAE,CACnD,CAAC;QACJ,CAAC;QACD,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC;IAC9B,CAAC;IAED,gEAAgE;IAChE,MAAM,MAAM,GACV,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,IAAA,kCAAmB,EAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAE9F,6EAA6E;IAC7E,2EAA2E;IAC3E,qCAAqC;IACrC,MAAM,IAAA,iCAAkB,EACtB,WAAW,EACX,MAAM,EACN,aAAa,SAAS,UAAU,MAAM,YAAY,IAAI,CAAC,QAAQ,QAAQ,EACvE,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,CAC/C,CAAC;IAEF,MAAM,QAAQ,GAAG,IAAA,yCAAsB,EACrC,iBAAiB,EACjB,QAAQ,IAAI,CAAC,EAAE,oBAAoB,IAAI,CAAC,QAAQ,EAAE,EAClD;QACE,MAAM,EAAE,IAAI,CAAC,EAAE;QACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM;QACN,SAAS;KACV,EACD;QACE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,cAAc,EAAE,CAAC,WAAW,CAAC;KAC9B,EACD,IAAI,CAAC,SAAS,CACf,CAAC;IAEF,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAA,uCAAoB,EAAC,QAAQ,CAAC;aACrC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/tasks/bulk/BatchProcessorFactory.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Factory for creating and managing batch processors for bulk operations
+ */
+import { BatchProcessor, type BatchResult } from '../../../utils/performance/batch-processor';
+/**
+ * Factory for selecting appropriate batch processor based on operation type
+ */
+export declare const batchProcessorFactory: {
+    /**
+     * Get the appropriate batch processor for an operation type
+     */
+    getProcessor(operationType: string): BatchProcessor;
+    /**
+     * Process items in batches using the appropriate processor
+     */
+    processBatches<T>(items: number[], processor: (item: number, index: number) => Promise<T>, operationType: string): Promise<BatchResult<T>>;
+    /**
+     * Get the create batch processor specifically
+     */
+    getCreateProcessor(): BatchProcessor;
+    /**
+     * Get the update batch processor specifically
+     */
+    getUpdateProcessor(): BatchProcessor;
+    /**
+     * Get the delete batch processor specifically
+     */
+    getDeleteProcessor(): BatchProcessor;
+};
+//# sourceMappingURL=BatchProcessorFactory.d.ts.map

package/dist/tools/tasks/bulk/BatchProcessorFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BatchProcessorFactory.d.ts","sourceRoot":"","sources":["../../../../src/tools/tasks/bulk/BatchProcessorFactory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,4CAA4C,CAAC;AAwB9F;;GAEG;AACH,eAAO,MAAM,qBAAqB;IAChC;;OAEG;gCACyB,MAAM,GAAG,cAAc;IAUnD;;OAEG;mBACkB,CAAC,SACb,MAAM,EAAE,aACJ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,iBACvC,MAAM,GACpB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAK1B;;OAEG;0BACmB,cAAc;IAIpC;;OAEG;0BACmB,cAAc;IAIpC;;OAEG;0BACmB,cAAc;CAGrC,CAAC"}

package/dist/tools/tasks/bulk/BatchProcessorFactory.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * Factory for creating and managing batch processors for bulk operations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.batchProcessorFactory = void 0;
+const batch_processor_1 = require("../../../utils/performance/batch-processor");
+// Batch processors with optimized settings for different operation types
+const updateBatchProcessor = new batch_processor_1.BatchProcessor({
+    maxConcurrency: 5,
+    batchSize: 10,
+    enableMetrics: true,
+    batchDelay: 0,
+});
+const deleteBatchProcessor = new batch_processor_1.BatchProcessor({
+    maxConcurrency: 3,
+    batchSize: 5,
+    enableMetrics: true,
+    batchDelay: 100,
+});
+const createBatchProcessor = new batch_processor_1.BatchProcessor({
+    maxConcurrency: 8,
+    batchSize: 15,
+    enableMetrics: true,
+    batchDelay: 0,
+});
+/**
+ * Factory for selecting appropriate batch processor based on operation type
+ */
+exports.batchProcessorFactory = {
+    /**
+     * Get the appropriate batch processor for an operation type
+     */
+    getProcessor(operationType) {
+        if (operationType.includes('delete')) {
+            return deleteBatchProcessor;
+        }
+        if (operationType.includes('create')) {
+            return createBatchProcessor;
+        }
+        return updateBatchProcessor;
+    },
+    /**
+     * Process items in batches using the appropriate processor
+     */
+    async processBatches(items, processor, operationType) {
+        const batchProcessor = this.getProcessor(operationType);
+        return await batchProcessor.processBatches(items, processor);
+    },
+    /**
+     * Get the create batch processor specifically
+     */
+    getCreateProcessor() {
+        return createBatchProcessor;
+    },
+    /**
+     * Get the update batch processor specifically
+     */
+    getUpdateProcessor() {
+        return updateBatchProcessor;
+    },
+    /**
+     * Get the delete batch processor specifically
+     */
+    getDeleteProcessor() {
+        return deleteBatchProcessor;
+    }
+};
+//# sourceMappingURL=BatchProcessorFactory.js.map

package/dist/tools/tasks/bulk/BatchProcessorFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BatchProcessorFactory.js","sourceRoot":"","sources":["../../../../src/tools/tasks/bulk/BatchProcessorFactory.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,gFAA8F;AAE9F,yEAAyE;AACzE,MAAM,oBAAoB,GAAG,IAAI,gCAAc,CAAC;IAC9C,cAAc,EAAE,CAAC;IACjB,SAAS,EAAE,EAAE;IACb,aAAa,EAAE,IAAI;IACnB,UAAU,EAAE,CAAC;CACd,CAAC,CAAC;AAEH,MAAM,oBAAoB,GAAG,IAAI,gCAAc,CAAC;IAC9C,cAAc,EAAE,CAAC;IACjB,SAAS,EAAE,CAAC;IACZ,aAAa,EAAE,IAAI;IACnB,UAAU,EAAE,GAAG;CAChB,CAAC,CAAC;AAEH,MAAM,oBAAoB,GAAG,IAAI,gCAAc,CAAC;IAC9C,cAAc,EAAE,CAAC;IACjB,SAAS,EAAE,EAAE;IACb,aAAa,EAAE,IAAI;IACnB,UAAU,EAAE,CAAC;CACd,CAAC,CAAC;AAEH;;GAEG;AACU,QAAA,qBAAqB,GAAG;IACnC;;OAEG;IACH,YAAY,CAAC,aAAqB;QAChC,IAAI,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrC,OAAO,oBAAoB,CAAC;QAC9B,CAAC;QACD,IAAI,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrC,OAAO,oBAAoB,CAAC;QAC9B,CAAC;QACD,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAClB,KAAe,EACf,SAAsD,EACtD,aAAqB;QAErB,MAAM,cAAc,GAAG,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;QACxD,OAAO,MAAM,cAAc,CAAC,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,oBAAoB,CAAC;IAC9B,CAAC;CACF,CAAC"}

package/dist/tools/tasks/bulk/BulkOperationErrorHandler.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Error handling and fallback logic for bulk operations
+ */
+import type { Task, VikunjaClient } from 'node-vikunja';
+import type { BulkUpdateArgs } from './BulkOperationValidator';
+import type { BatchResult } from '../../../utils/performance/batch-processor';
+/**
+ * Handles fallback logic when bulk APIs fail
+ */
+export declare const bulkOperationErrorHandler: {
+    /**
+     * Handle bulk update fallback when main API fails
+     */
+    handleBulkUpdateFallback(args: BulkUpdateArgs, taskIds: number[], bulkError: Error): Promise<{
+        content: Array<{
+            type: "text";
+            text: string;
+        }>;
+    }>;
+    /**
+     * Update a single task as part of fallback logic
+     */
+    updateIndividualTask(client: VikunjaClient, taskId: number, args: BulkUpdateArgs): Promise<Task>;
+    /**
+     * Handle fields that require separate API calls (assignees, labels)
+     */
+    handleSpecialFields(client: VikunjaClient, taskId: number, args: BulkUpdateArgs, _updatedTask: Task): Promise<void>;
+    /**
+     * Handle assignee updates with proper error handling
+     */
+    handleAssigneeUpdate(client: VikunjaClient, taskId: number, newAssigneeIds: number[]): Promise<void>;
+    /**
+     * Process update results and handle various failure scenarios
+     */
+    processUpdateResults(args: BulkUpdateArgs, taskIds: number[], updateResult: BatchResult<Task>): Promise<{
+        content: Array<{
+            type: "text";
+            text: string;
+        }>;
+    }>;
+    /**
+     * Handle various types of update failures
+     */
+    handleUpdateFailures(args: BulkUpdateArgs, failures: Array<{
+        index: number;
+        error: unknown;
+        originalItem: unknown;
+    }>, successCount: number): void;
+};
+//# sourceMappingURL=BulkOperationErrorHandler.d.ts.map

package/dist/tools/tasks/bulk/BulkOperationErrorHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BulkOperationErrorHandler.d.ts","sourceRoot":"","sources":["../../../../src/tools/tasks/bulk/BulkOperationErrorHandler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAQxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,yBAAyB;IACpC;;OAEG;mCAEK,cAAc,WACX,MAAM,EAAE,aACN,KAAK,GACf,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAqB9D;;OAEG;iCAEO,aAAa,UACb,MAAM,QACR,cAAc,GACnB,OAAO,CAAC,IAAI,CAAC;IAgBhB;;OAEG;gCAEO,aAAa,UACb,MAAM,QACR,cAAc,gBACN,IAAI,GACjB,OAAO,CAAC,IAAI,CAAC;IAkBhB;;OAEG;iCAEO,aAAa,UACb,MAAM,kBACE,MAAM,EAAE,GACvB,OAAO,CAAC,IAAI,CAAC;IAwDhB;;OAEG;+BAEK,cAAc,WACX,MAAM,EAAE,gBACH,WAAW,CAAC,IAAI,CAAC,GAC9B,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IA0D9D;;OAEG;+BAEK,cAAc,YACV,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,OAAO,CAAA;KAAE,CAAC,gBAC3D,MAAM,GACnB,IAAI;CAqCR,CAAC"}

package/dist/tools/tasks/bulk/BulkOperationErrorHandler.js

@@ -0,0 +1,183 @@
+"use strict";
+/**
+ * Error handling and fallback logic for bulk operations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bulkOperationErrorHandler = void 0;
+const types_1 = require("../../../types");
+const client_1 = require("../../../client");
+const logger_1 = require("../../../utils/logger");
+const response_factory_1 = require("../../../utils/response-factory");
+const auth_error_handler_1 = require("../../../utils/auth-error-handler");
+const retry_1 = require("../../../utils/retry");
+const index_1 = require("./index");
+const constants_1 = require("../constants");
+const validation_1 = require("../validation");
+/**
+ * Handles fallback logic when bulk APIs fail
+ */
+exports.bulkOperationErrorHandler = {
+    /**
+     * Handle bulk update fallback when main API fails
+     */
+    async handleBulkUpdateFallback(args, taskIds, bulkError) {
+        logger_1.logger.warn('Bulk update API failed, falling back to individual updates', {
+            error: bulkError instanceof Error ? bulkError.message : String(bulkError),
+            field: args.field,
+        });
+        const client = await (0, client_1.getClientFromContext)();
+        // Perform bulk update using individual task updates as fallback
+        const updateResult = await index_1.BatchProcessorFactory.processBatches(taskIds, async (taskId) => {
+            return await this.updateIndividualTask(client, taskId, args);
+        }, 'bulk_update_individual_fallback');
+        // Process results and handle failures
+        return await this.processUpdateResults(args, taskIds, updateResult);
+    },
+    /**
+     * Update a single task as part of fallback logic
+     */
+    async updateIndividualTask(client, taskId, args) {
+        // Fetch current task to preserve required fields
+        const currentTask = await client.tasks.getTask(taskId);
+        // Apply field update using shared utility
+        const updateData = (0, validation_1.applyFieldUpdate)({ ...currentTask }, args.field, args.value);
+        // Update the task
+        const updatedTask = await client.tasks.updateTask(taskId, updateData);
+        // Handle special fields that require separate API calls
+        await this.handleSpecialFields(client, taskId, args, updatedTask);
+        return updatedTask;
+    },
+    /**
+     * Handle fields that require separate API calls (assignees, labels)
+     */
+    async handleSpecialFields(client, taskId, args, _updatedTask) {
+        if (args.field === 'assignees' && Array.isArray(args.value)) {
+            await this.handleAssigneeUpdate(client, taskId, args.value);
+        }
+        if (args.field === 'labels' && Array.isArray(args.value)) {
+            await (0, retry_1.withRetry)(() => client.tasks.updateTaskLabels(taskId, {
+                label_ids: args.value,
+            }), {
+                ...retry_1.RETRY_CONFIG.AUTH_ERRORS,
+                shouldRetry: (error) => (0, auth_error_handler_1.isAuthenticationError)(error)
+            });
+        }
+    },
+    /**
+     * Handle assignee updates with proper error handling
+     */
+    async handleAssigneeUpdate(client, taskId, newAssigneeIds) {
+        try {
+            // Replace all assignees with the new list
+            const currentTaskWithAssignees = await client.tasks.getTask(taskId);
+            const currentAssigneeIds = currentTaskWithAssignees.assignees?.map((a) => a.id) || [];
+            // Add new assignees first to avoid leaving task unassigned.
+            // Use the ADDITIVE single-assign endpoint per user: node-vikunja's
+            // bulkAssignUsersToTask sends `{ user_ids }` to Vikunja's bulk endpoint,
+            // which expects `{ assignees }` and REPLACES the whole list, silently
+            // unassigning everyone on the field mismatch (upstream issue #15).
+            if (newAssigneeIds.length > 0) {
+                await Promise.all(newAssigneeIds.map((userId) => (0, retry_1.withRetry)(() => client.tasks.assignUserToTask(taskId, userId), {
+                    ...retry_1.RETRY_CONFIG.AUTH_ERRORS,
+                    shouldRetry: (error) => (0, auth_error_handler_1.isAuthenticationError)(error)
+                })));
+            }
+            // Remove old assignees only after new ones are successfully added
+            for (const userId of currentAssigneeIds) {
+                try {
+                    await (0, retry_1.withRetry)(() => client.tasks.removeUserFromTask(taskId, userId), {
+                        ...retry_1.RETRY_CONFIG.AUTH_ERRORS,
+                        shouldRetry: (error) => (0, auth_error_handler_1.isAuthenticationError)(error)
+                    });
+                }
+                catch (removeError) {
+                    if ((0, auth_error_handler_1.isAuthenticationError)(removeError)) {
+                        throw new types_1.MCPError(types_1.ErrorCode.API_ERROR, `${constants_1.AUTH_ERROR_MESSAGES.ASSIGNEE_REMOVE_PARTIAL} (Retried ${retry_1.RETRY_CONFIG.AUTH_ERRORS.maxRetries} times)`);
+                    }
+                    throw removeError;
+                }
+            }
+        }
+        catch (assigneeError) {
+            if ((0, auth_error_handler_1.isAuthenticationError)(assigneeError)) {
+                throw new types_1.MCPError(types_1.ErrorCode.API_ERROR, `${constants_1.AUTH_ERROR_MESSAGES.ASSIGNEE_BULK_UPDATE} (Retried ${retry_1.RETRY_CONFIG.AUTH_ERRORS.maxRetries} times)`);
+            }
+            throw assigneeError;
+        }
+    },
+    /**
+     * Process update results and handle various failure scenarios
+     */
+    async processUpdateResults(args, taskIds, updateResult) {
+        const failures = updateResult.failed;
+        const successCount = updateResult.successful.length;
+        if (failures.length > 0) {
+            this.handleUpdateFailures(args, failures, successCount);
+        }
+        // Use successful tasks from the update operation, or fetch fresh if needed
+        let updatedTasks = updateResult.successful;
+        let failedFetches = 0;
+        if (updatedTasks.length < successCount) {
+            const fetchResult = await index_1.BatchProcessorFactory.processBatches(taskIds, async (taskId) => {
+                const client = await (0, client_1.getClientFromContext)();
+                return await client.tasks.getTask(taskId);
+            }, 'bulk_update_final_fetch');
+            updatedTasks = fetchResult.successful;
+            failedFetches = fetchResult.failed.length;
+        }
+        const response = (0, types_1.createStandardResponse)('update-task', `Successfully updated ${taskIds.length} tasks${failedFetches > 0 ? ` (${failedFetches} tasks could not be fetched after update)` : ''}`, { tasks: updatedTasks }, {
+            timestamp: new Date().toISOString(),
+            affectedFields: args.field ? [args.field] : [],
+            count: taskIds.length,
+            ...(failedFetches > 0 && { fetchErrors: failedFetches }),
+            performanceMetrics: {
+                totalDuration: updateResult.metrics.totalDuration,
+                operationsPerSecond: updateResult.metrics.operationsPerSecond,
+                apiCallsUsed: updateResult.metrics.successfulOperations + updateResult.metrics.failedOperations,
+            },
+        });
+        logger_1.logger.info('Bulk update completed', {
+            taskCount: taskIds.length,
+            field: args.field,
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: (0, response_factory_1.formatAorpAsMarkdown)(response), // createStandardResponse returns AORP object, format as markdown
+                },
+            ],
+        };
+    },
+    /**
+     * Handle various types of update failures
+     */
+    handleUpdateFailures(args, failures, successCount) {
+        const failedIds = failures.map((f) => f.originalItem);
+        // Check if all failures are due to assignee auth errors
+        if (args.field === 'assignees') {
+            const authFailures = failures.filter((f) => {
+                const error = f.error;
+                return (error instanceof types_1.MCPError &&
+                    error.message.includes('Assignee operations may have authentication issues'));
+            });
+            if (authFailures.length === failures.length) {
+                throw new types_1.MCPError(types_1.ErrorCode.API_ERROR, 'Assignee operations may have authentication issues with certain Vikunja API versions. ' +
+                    'This is a known limitation that prevents bulk updating assignees.');
+            }
+        }
+        // If some succeeded, report partial success
+        if (successCount > 0) {
+            logger_1.logger.warn('Bulk update partially failed', {
+                successCount,
+                failedCount: failures.length,
+                failedIds,
+            });
+        }
+        else {
+            // All failed
+            throw new types_1.MCPError(types_1.ErrorCode.API_ERROR, `Bulk update failed. Could not update any tasks. Failed IDs: ${failedIds.join(', ')}`);
+        }
+    }
+};
+//# sourceMappingURL=BulkOperationErrorHandler.js.map