vikunja-mcp-ng 0.4.0

package/dist/tools/tasks/constants.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * Constants for task operations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SORT_FIELD_ALIASES = exports.VALID_SORT_FIELDS = exports.REPEAT_MODE_MAP = exports.MAX_BULK_OPERATION_TASKS = exports.BULK_OPERATION_BATCH_SIZE = exports.AUTH_ERROR_MESSAGES = void 0;
+// Error message constants
+exports.AUTH_ERROR_MESSAGES = {
+    ASSIGNEE_CREATE: 'Assignee operations may have authentication issues with certain Vikunja API versions. ' +
+        'This is a known limitation. The task was created but assignees could not be added.',
+    ASSIGNEE_UPDATE: 'Assignee operations may have authentication issues with certain Vikunja API versions. ' +
+        'This is a known limitation. Other task fields were updated but assignees could not be changed.',
+    ASSIGNEE_ASSIGN: 'Assignee operations may have authentication issues with certain Vikunja API versions. ' +
+        'This is a known limitation that prevents assigning users to tasks.',
+    ASSIGNEE_REMOVE: 'Assignee removal operations may have authentication issues with certain Vikunja API versions. ' +
+        'This is a known limitation that prevents removing users from tasks.',
+    ASSIGNEE_REMOVE_PARTIAL: 'Assignee removal operations may have authentication issues with certain Vikunja API versions. ' +
+        'This is a known limitation. New assignees were added but old assignees could not be removed.',
+    ASSIGNEE_BULK_UPDATE: 'Assignee operations may have authentication issues with certain Vikunja API versions. ' +
+        'This is a known limitation that prevents bulk updating assignees.',
+    LABEL_CREATE: 'Label operations may have authentication issues with certain Vikunja API versions. ' +
+        'This is a known limitation. The task was created but labels could not be added.',
+    LABEL_UPDATE: 'Label operations may have authentication issues with certain Vikunja API versions. ' +
+        'This is a known limitation. Other task fields were updated but labels could not be changed.',
+};
+// Bulk operation constants
+exports.BULK_OPERATION_BATCH_SIZE = 10;
+exports.MAX_BULK_OPERATION_TASKS = 100;
+// Repeat mode mapping for bulk update API
+// Maps user-friendly string values to Vikunja API numeric codes
+exports.REPEAT_MODE_MAP = {
+    default: 0,
+    month: 1,
+    from_current: 2,
+};
+// Valid `sort_by` values for `GET /tasks`/`GET /projects/{id}/tasks`, per the
+// vendored OpenAPI spec (docs/vikunja-openapi.json, `sort_by` query param
+// description). An unrecognized value is silently ignored server-side rather
+// than erroring, so passing e.g. a misspelled or camelCase field name results
+// in tasks quietly coming back in default (id) order with no indication
+// anything was wrong — the same "free-form string that behaves like an enum"
+// class of ergonomics gap the post-#89 sweep's field/enum allowlist item
+// targets. Validated explicitly here so the caller gets an agent-friendly
+// error instead of a silent no-op.
+exports.VALID_SORT_FIELDS = [
+    'id',
+    'title',
+    'description',
+    'done',
+    'done_at',
+    'due_date',
+    'created_by_id',
+    'project_id',
+    'repeat_after',
+    'priority',
+    'start_date',
+    'end_date',
+    'hex_color',
+    'percent_done',
+    'uid',
+    'created',
+    'updated',
+    'relevance',
+];
+// This tool exposes task fields to callers in camelCase (dueDate, startDate,
+// etc. — see CreateTaskArgs/UpdateTaskArgs), so `sort` accepts the same
+// camelCase spelling and is translated to the API's snake_case field name
+// here, mirroring `FILTER_FIELD_TO_API_FIELD` in src/utils/filters.ts (added
+// for the exact same reason: sending `dueDate` verbatim as `sort_by` is not a
+// field Vikunja recognizes).
+exports.SORT_FIELD_ALIASES = {
+    doneAt: 'done_at',
+    dueDate: 'due_date',
+    createdById: 'created_by_id',
+    projectId: 'project_id',
+    repeatAfter: 'repeat_after',
+    startDate: 'start_date',
+    endDate: 'end_date',
+    hexColor: 'hex_color',
+    percentDone: 'percent_done',
+};
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/tools/tasks/constants.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,0BAA0B;AACb,QAAA,mBAAmB,GAAG;IACjC,eAAe,EACb,wFAAwF;QACxF,oFAAoF;IACtF,eAAe,EACb,wFAAwF;QACxF,gGAAgG;IAClG,eAAe,EACb,wFAAwF;QACxF,oEAAoE;IACtE,eAAe,EACb,gGAAgG;QAChG,qEAAqE;IACvE,uBAAuB,EACrB,gGAAgG;QAChG,8FAA8F;IAChG,oBAAoB,EAClB,wFAAwF;QACxF,mEAAmE;IACrE,YAAY,EACV,qFAAqF;QACrF,iFAAiF;IACnF,YAAY,EACV,qFAAqF;QACrF,6FAA6F;CAChG,CAAC;AAEF,2BAA2B;AACd,QAAA,yBAAyB,GAAG,EAAE,CAAC;AAC/B,QAAA,wBAAwB,GAAG,GAAG,CAAC;AAE5C,0CAA0C;AAC1C,gEAAgE;AACnD,QAAA,eAAe,GAA2B;IACrD,OAAO,EAAE,CAAC;IACV,KAAK,EAAE,CAAC;IACR,YAAY,EAAE,CAAC;CACP,CAAC;AAEX,8EAA8E;AAC9E,0EAA0E;AAC1E,6EAA6E;AAC7E,8EAA8E;AAC9E,wEAAwE;AACxE,6EAA6E;AAC7E,yEAAyE;AACzE,0EAA0E;AAC1E,mCAAmC;AACtB,QAAA,iBAAiB,GAAG;IAC/B,IAAI;IACJ,OAAO;IACP,aAAa;IACb,MAAM;IACN,SAAS;IACT,UAAU;IACV,eAAe;IACf,YAAY;IACZ,cAAc;IACd,UAAU;IACV,YAAY;IACZ,UAAU;IACV,WAAW;IACX,cAAc;IACd,KAAK;IACL,SAAS;IACT,SAAS;IACT,WAAW;CACH,CAAC;AAEX,6EAA6E;AAC7E,wEAAwE;AACxE,0EAA0E;AAC1E,6EAA6E;AAC7E,8EAA8E;AAC9E,6BAA6B;AAChB,QAAA,kBAAkB,GAA2B;IACxD,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,UAAU;IACnB,WAAW,EAAE,eAAe;IAC5B,SAAS,EAAE,YAAY;IACvB,WAAW,EAAE,cAAc;IAC3B,SAAS,EAAE,YAAY;IACvB,OAAO,EAAE,UAAU;IACnB,QAAQ,EAAE,WAAW;IACrB,WAAW,EAAE,cAAc;CACnB,CAAC"}

package/dist/tools/tasks/crud/TaskCreationService.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Task Creation Service
+ * Handles task creation with label/assignee management and rollback logic
+ */
+import type { AuthManager } from '../../../auth/AuthManager';
+export interface CreateTaskArgs {
+    projectId?: number;
+    title?: string;
+    description?: string;
+    dueDate?: string;
+    startDate?: string;
+    endDate?: string;
+    priority?: number;
+    labels?: number[];
+    assignees?: number[];
+    repeatAfter?: number;
+    repeatMode?: 'day' | 'week' | 'month' | 'year';
+    sessionId?: string;
+}
+/**
+ * Creates a new task with comprehensive error handling and rollback support
+ */
+export declare function createTask(args: CreateTaskArgs, authManager: AuthManager): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=TaskCreationService.d.ts.map

package/dist/tools/tasks/crud/TaskCreationService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskCreationService.d.ts","sourceRoot":"","sources":["../../../../src/tools/tasks/crud/TaskCreationService.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAgB7D,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAE/C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAWD;;GAEG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,cAAc,EACpB,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,CA4M7D"}

package/dist/tools/tasks/crud/TaskCreationService.js

@@ -0,0 +1,274 @@
+"use strict";
+/**
+ * Task Creation Service
+ * Handles task creation with label/assignee management and rollback logic
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTask = createTask;
+const types_1 = require("../../../types");
+const vikunja_rest_1 = require("../../../utils/vikunja-rest");
+const logger_1 = require("../../../utils/logger");
+const auth_error_handler_1 = require("../../../utils/auth-error-handler");
+const retry_1 = require("../../../utils/retry");
+const error_handler_1 = require("../../../utils/error-handler");
+const validation_1 = require("../../../utils/validation");
+const constants_1 = require("../constants");
+const validation_2 = require("../validation");
+const TaskResponseFormatter_1 = require("./TaskResponseFormatter");
+const response_factory_1 = require("../../../utils/response-factory");
+/**
+ * Creates a new task with comprehensive error handling and rollback support
+ */
+async function createTask(args, authManager) {
+    try {
+        // Validate required fields
+        if (!args.projectId) {
+            throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'projectId is required to create a task');
+        }
+        (0, validation_2.validateId)(args.projectId, 'projectId');
+        if (!args.title) {
+            throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'title is required to create a task');
+        }
+        // Sanitize and validate user inputs for comprehensive security
+        const sanitizedTitle = (0, validation_1.sanitizeString)(args.title);
+        // Preserve empty strings as they are valid descriptions
+        const sanitizedDescription = args.description !== undefined ? (0, validation_1.sanitizeString)(args.description) : undefined;
+        // Validate optional date fields
+        if (args.dueDate) {
+            (0, validation_2.validateDateString)(args.dueDate, 'dueDate');
+        }
+        if (args.startDate) {
+            (0, validation_2.validateDateString)(args.startDate, 'startDate');
+        }
+        if (args.endDate) {
+            (0, validation_2.validateDateString)(args.endDate, 'endDate');
+        }
+        // Validate assignee IDs upfront
+        if (args.assignees && args.assignees.length > 0) {
+            args.assignees.forEach((id) => (0, validation_2.validateId)(id, 'assignee ID'));
+        }
+        // Validate label IDs upfront
+        if (args.labels && args.labels.length > 0) {
+            args.labels.forEach((id) => (0, validation_2.validateId)(id, 'label ID'));
+        }
+        // Build the initial task object with sanitized values
+        const newTask = {
+            title: sanitizedTitle,
+            project_id: args.projectId,
+        };
+        // Add optional fields with sanitized values
+        if (sanitizedDescription !== undefined)
+            newTask.description = sanitizedDescription;
+        if (args.dueDate !== undefined)
+            newTask.due_date = args.dueDate;
+        if (args.startDate !== undefined)
+            newTask.start_date = args.startDate;
+        if (args.endDate !== undefined)
+            newTask.end_date = args.endDate;
+        if (args.priority !== undefined)
+            newTask.priority = args.priority;
+        // Handle repeat configuration. The generated `models.Task.repeat_mode`
+        // type (0 | 1 | 2) matches the real API, unlike the legacy client's
+        // (incorrect) 'day' | 'week' | 'month' | 'year' typing — no bypass cast
+        // needed now that this goes through the generated type.
+        if (args.repeatAfter !== undefined || args.repeatMode !== undefined) {
+            const repeatConfig = (0, validation_2.convertRepeatConfiguration)(args.repeatAfter, args.repeatMode);
+            if (repeatConfig.repeat_after !== undefined)
+                newTask.repeat_after = repeatConfig.repeat_after;
+            if (repeatConfig.repeat_mode !== undefined) {
+                newTask.repeat_mode = repeatConfig.repeat_mode;
+            }
+        }
+        // Create the base task. PUT /projects/{id}/tasks per the OpenAPI spec
+        // (models.Task request/response body).
+        const createdTask = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'PUT', `/projects/${args.projectId}/tasks`, newTask);
+        // Labels/assignees require a task id — fail loudly instead of reporting success without them
+        const needsPostCreate = (args.labels !== undefined && args.labels.length > 0) ||
+            (args.assignees !== undefined && args.assignees.length > 0);
+        if (needsPostCreate && !createdTask.id) {
+            throw new types_1.MCPError(types_1.ErrorCode.API_ERROR, 'Task was created but Vikunja did not return a task id, so labels/assignees could not be applied');
+        }
+        // Track creation state for potential rollback
+        const creationState = {
+            createdTask,
+            labelsAdded: false,
+            assigneesAdded: false
+        };
+        if (needsPostCreate) {
+            try {
+                // Add labels if provided
+                if (args.labels && args.labels.length > 0 && createdTask.id) {
+                    await addLabelsToTask(authManager, createdTask.id, args.labels);
+                    creationState.labelsAdded = true;
+                }
+                // Add assignees if provided
+                if (args.assignees && args.assignees.length > 0 && createdTask.id) {
+                    await addAssigneesToTask(authManager, createdTask.id, args.assignees);
+                    creationState.assigneesAdded = true;
+                }
+            }
+            catch (updateError) {
+                // Attempt to clean up the partially created task
+                await rollbackTaskCreation(authManager, creationState, updateError);
+                // The rollback function will re-throw the original error with context
+            }
+        }
+        // Fetch the complete task with labels and assignees
+        const completeTask = createdTask.id
+            ? await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'GET', `/tasks/${createdTask.id}`)
+            : createdTask;
+        // Defense-in-depth (adapted from upstream PR #43): verify assignees actually
+        // persisted. Even with the additive per-user endpoint, some Vikunja API/auth
+        // combinations can report success without persisting — surface that instead
+        // of silently reporting success.
+        let assigneeWarning;
+        if (args.assignees && args.assignees.length > 0 && completeTask.id) {
+            const persistedIds = new Set((completeTask.assignees || []).map((a) => a.id));
+            const missingIds = args.assignees.filter((id) => !persistedIds.has(id));
+            if (missingIds.length > 0) {
+                assigneeWarning =
+                    `Warning: assignee(s) [${missingIds.join(', ')}] were not persisted. ` +
+                        `This is a known Vikunja API limitation with API token auth. Try using JWT authentication instead.`;
+            }
+        }
+        // Verify labels actually stuck — avoid silent success when the API no-ops
+        if (args.labels && args.labels.length > 0) {
+            const attachedIds = new Set((completeTask.labels || [])
+                .map((label) => label.id)
+                .filter((id) => typeof id === 'number'));
+            const missing = args.labels.filter((id) => !attachedIds.has(id));
+            if (missing.length > 0) {
+                await rollbackTaskCreation(authManager, creationState, new Error(`Labels were requested but not attached after create (missing label ids: ${missing.join(', ')})`));
+            }
+        }
+        const response = (0, TaskResponseFormatter_1.createTaskResponse)('create-task', assigneeWarning
+            ? `Task created, but assignees may not have been saved. ${assigneeWarning}`
+            : 'Task created successfully', { task: completeTask }, {
+            timestamp: new Date().toISOString(),
+            projectId: args.projectId,
+            // Reflect what was actually persisted, not merely what was requested:
+            // if label/assignee attachment fails the task creation is rolled back
+            // and this response is never reached, so these flags are only true
+            // once the corresponding step has genuinely succeeded.
+            labelsAdded: creationState.labelsAdded,
+            assigneesAdded: creationState.assigneesAdded,
+        }, undefined, // verbosity (ignored - using standard AORP)
+        undefined, // useOptimizedFormat (ignored - using standard AORP)
+        undefined, // useAorp (ignored - always using AORP)
+        undefined, // aorpConfig (using auto-generated)
+        args.sessionId);
+        logger_1.logger.debug('Tasks tool response', {
+            subcommand: 'create',
+            taskId: completeTask.id,
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: (0, response_factory_1.formatAorpAsMarkdown)(response.response),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        // Re-throw MCPError instances without modification
+        if (error instanceof types_1.MCPError) {
+            throw error;
+        }
+        // Handle fetch/connection errors with helpful guidance
+        if (error instanceof Error && (error.message.includes('fetch failed') ||
+            error.message.includes('ECONNREFUSED') ||
+            error.message.includes('ENOTFOUND'))) {
+            throw (0, error_handler_1.handleFetchError)(error, 'create task');
+        }
+        // Use standardized error transformation for all other errors
+        throw (0, error_handler_1.transformApiError)(error, 'Failed to create task');
+    }
+}
+/**
+ * Adds labels to a task via the additive per-label endpoint (PUT
+ * /tasks/{taskID}/labels, body { label_id }, models.LabelTask) — same as
+ * apply-label. The bulk endpoint can silently no-op on some Vikunja versions
+ * (GitHub #37).
+ *
+ * Intentionally does not use withRetry: that helper shares an "anonymous"
+ * circuit breaker across calls, so a later create would re-fire the first
+ * call's label set against the wrong task.
+ */
+async function addLabelsToTask(authManager, taskId, labelIds) {
+    try {
+        for (const labelId of labelIds) {
+            await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'PUT', `/tasks/${taskId}/labels`, {
+                label_id: labelId,
+            });
+        }
+    }
+    catch (labelError) {
+        // Check if it's an auth error
+        if ((0, auth_error_handler_1.isAuthenticationError)(labelError)) {
+            throw new types_1.MCPError(types_1.ErrorCode.API_ERROR, `${constants_1.AUTH_ERROR_MESSAGES.LABEL_CREATE} Task ID: ${taskId}`);
+        }
+        throw labelError;
+    }
+}
+/**
+ * Adds assignees to a task with retry logic for authentication errors, via the
+ * direct-REST additive single-assign endpoint.
+ */
+async function addAssigneesToTask(authManager, taskId, assigneeIds) {
+    try {
+        // Assign each user via the ADDITIVE single-assign endpoint (PUT
+        // /tasks/{taskID}/assignees, body { user_id }, models.TaskAssginee) rather
+        // than the bulk endpoint (POST .../assignees/bulk), which REPLACES the
+        // entire assignee list — a bulk call would silently unassign everyone
+        // (democratize-technology/vikunja-mcp#15). Sequential on purpose
+        // (post-#89 pattern sweep):
+        // concurrent per-user writes to the same task risk "database is locked"
+        // 500s on SQLite-backed instances, same class as the bulk-update
+        // assignee-restore fix.
+        for (const userId of assigneeIds) {
+            await (0, retry_1.withRetry)(() => (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'PUT', `/tasks/${taskId}/assignees`, { user_id: userId }), {
+                ...retry_1.RETRY_CONFIG.AUTH_ERRORS,
+                shouldRetry: (error) => (0, auth_error_handler_1.isAuthenticationError)(error)
+            });
+        }
+    }
+    catch (assigneeError) {
+        // Check if it's an auth error after retries
+        if ((0, auth_error_handler_1.isAuthenticationError)(assigneeError)) {
+            throw new types_1.MCPError(types_1.ErrorCode.API_ERROR, `${constants_1.AUTH_ERROR_MESSAGES.ASSIGNEE_CREATE} (Retried ${retry_1.RETRY_CONFIG.AUTH_ERRORS.maxRetries} times). Task ID: ${taskId}`);
+        }
+        throw assigneeError;
+    }
+}
+/**
+ * Attempts to roll back a partially created task and throws enhanced error context
+ */
+async function rollbackTaskCreation(authManager, creationState, originalError) {
+    // Attempt to clean up the partially created task
+    let rollbackSucceeded = false;
+    if (creationState.createdTask.id) {
+        try {
+            await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'DELETE', `/tasks/${creationState.createdTask.id}`);
+            rollbackSucceeded = true;
+        }
+        catch (deleteError) {
+            // Log the cleanup failure but throw the original error
+            logger_1.logger.error('Failed to clean up partially created task:', deleteError);
+        }
+    }
+    // Re-throw the original error with context
+    const errorMessage = `Failed to complete task creation: ${originalError instanceof Error ? originalError.message : String(originalError)}. ${rollbackSucceeded
+        ? 'Task was successfully rolled back.'
+        : 'Task rollback also failed - manual cleanup may be required.'}`;
+    throw new types_1.MCPError(types_1.ErrorCode.API_ERROR, errorMessage, {
+        vikunjaError: {
+            taskId: creationState.createdTask.id,
+            partiallyCreated: true,
+            labelsAdded: creationState.labelsAdded,
+            assigneesAdded: creationState.assigneesAdded,
+            rollbackSucceeded,
+        },
+    });
+}
+//# sourceMappingURL=TaskCreationService.js.map

package/dist/tools/tasks/crud/TaskCreationService.js.map

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

package/dist/tools/tasks/crud/TaskDeletionService.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Task Deletion Service
+ * Handles task deletion with graceful error handling and response formatting
+ */
+import type { AuthManager } from '../../../auth/AuthManager';
+export interface DeleteTaskArgs {
+    id?: number;
+    sessionId?: string;
+}
+/**
+ * Deletes a task with graceful error handling and informative response
+ */
+export declare function deleteTask(args: DeleteTaskArgs, authManager: AuthManager): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=TaskDeletionService.d.ts.map

package/dist/tools/tasks/crud/TaskDeletionService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskDeletionService.d.ts","sourceRoot":"","sources":["../../../../src/tools/tasks/crud/TaskDeletionService.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAW7D,MAAM,WAAW,cAAc;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,cAAc,EACpB,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,CAoE7D"}

package/dist/tools/tasks/crud/TaskDeletionService.js

@@ -0,0 +1,96 @@
+"use strict";
+/**
+ * Task Deletion Service
+ * Handles task deletion with graceful error handling and response formatting
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deleteTask = deleteTask;
+const types_1 = require("../../../types");
+const vikunja_rest_1 = require("../../../utils/vikunja-rest");
+const validation_1 = require("../validation");
+const error_handler_1 = require("../../../utils/error-handler");
+const TaskResponseFormatter_1 = require("./TaskResponseFormatter");
+const response_factory_1 = require("../../../utils/response-factory");
+/**
+ * Deletes a task with graceful error handling and informative response
+ */
+async function deleteTask(args, authManager) {
+    try {
+        if (!args.id) {
+            throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'Task id is required for delete operation');
+        }
+        (0, validation_1.validateId)(args.id, 'id');
+        // Try to get task before deletion for response, but handle failure gracefully
+        const deletionContext = await gatherDeletionContext(authManager, args.id);
+        // Perform the deletion
+        await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'DELETE', `/tasks/${args.id}`);
+        const response = (0, TaskResponseFormatter_1.createTaskResponse)('delete-task', deletionContext.taskToDelete
+            ? `Task "${deletionContext.taskToDelete.title}" deleted successfully`
+            : `Task ${args.id} deleted successfully`, (deletionContext.taskToDelete
+            ? { task: deletionContext.taskToDelete }
+            : { deletedTaskId: args.id }), {
+            timestamp: new Date().toISOString(),
+            taskId: args.id,
+            ...(deletionContext.taskToDelete?.title && { taskTitle: deletionContext.taskToDelete.title }),
+        }, undefined, // verbosity (ignored)
+        undefined, // useOptimizedFormat (ignored)
+        undefined, // useAorp (ignored)
+        undefined, // aorpConfig (using auto-generated)
+        args.sessionId);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: (0, response_factory_1.formatAorpAsMarkdown)(response.response),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        // A REST 404 is translated to the same friendly "not found" message the
+        // pre-migration legacy client error path produced via handleStatusCodeError
+        // (which keys off a bare `.statusCode` property). vikunjaRestRequest
+        // always throws MCPError with the status nested under `.details`.
+        if (error instanceof types_1.MCPError) {
+            if (error.details?.statusCode === 404 && args.id) {
+                throw new types_1.MCPError(types_1.ErrorCode.NOT_FOUND, `Task with ID ${args.id} not found`);
+            }
+            throw error;
+        }
+        // Handle fetch/connection errors with helpful guidance
+        if (error instanceof Error && (error.message.includes('fetch failed') ||
+            error.message.includes('ECONNREFUSED') ||
+            error.message.includes('ENOTFOUND'))) {
+            throw (0, error_handler_1.handleFetchError)(error, 'delete task');
+        }
+        // Use standardized error transformation for all other errors
+        if (args.id) {
+            throw (0, error_handler_1.handleStatusCodeError)(error, 'delete task', args.id, `Task with ID ${args.id} not found`);
+        }
+        throw (0, error_handler_1.transformApiError)(error, 'Failed to delete task');
+    }
+}
+/**
+ * Gathers information about the task before deletion for better response messaging
+ * Handles cases where the task might not exist or be accessible
+ */
+async function gatherDeletionContext(authManager, taskId) {
+    let taskToDelete;
+    let retrievalSuccess = false;
+    try {
+        taskToDelete = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'GET', `/tasks/${taskId}`);
+        retrievalSuccess = true;
+    }
+    catch {
+        // If we can't get the task, proceed with deletion anyway
+        // This handles cases where the task exists but isn't accessible due to permissions
+        // or the task is already deleted/inconsistent state
+        taskToDelete = undefined;
+        retrievalSuccess = false;
+    }
+    return {
+        taskToDelete,
+        retrievalSuccess
+    };
+}
+//# sourceMappingURL=TaskDeletionService.js.map

package/dist/tools/tasks/crud/TaskDeletionService.js.map

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

package/dist/tools/tasks/crud/TaskReadService.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Task Read Service
+ * Handles task retrieval operations with comprehensive error handling
+ */
+import type { AuthManager } from '../../../auth/AuthManager';
+export interface GetTaskArgs {
+    id?: number;
+    sessionId?: string;
+}
+/**
+ * Retrieves a task by ID with comprehensive error handling
+ */
+export declare function getTask(args: GetTaskArgs, authManager: AuthManager): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=TaskReadService.d.ts.map

package/dist/tools/tasks/crud/TaskReadService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskReadService.d.ts","sourceRoot":"","sources":["../../../../src/tools/tasks/crud/TaskReadService.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAU7D,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,OAAO,CAC3B,IAAI,EAAE,WAAW,EACjB,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,CA6D7D"}

package/dist/tools/tasks/crud/TaskReadService.js

@@ -0,0 +1,66 @@
+"use strict";
+/**
+ * Task Read Service
+ * Handles task retrieval operations with comprehensive error handling
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTask = getTask;
+const index_1 = require("../../../index");
+const vikunja_rest_1 = require("../../../utils/vikunja-rest");
+const validation_1 = require("../validation");
+const TaskResponseFormatter_1 = require("./TaskResponseFormatter");
+const response_factory_1 = require("../../../utils/response-factory");
+/**
+ * Retrieves a task by ID with comprehensive error handling
+ */
+async function getTask(args, authManager) {
+    try {
+        if (!args.id) {
+            throw new index_1.MCPError(index_1.ErrorCode.VALIDATION_ERROR, 'Task id is required for get operation');
+        }
+        (0, validation_1.validateId)(args.id, 'id');
+        const task = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'GET', `/tasks/${args.id}`);
+        const response = (0, TaskResponseFormatter_1.createTaskResponse)('get-task', `Retrieved task "${task.title}"`, { task }, {
+            timestamp: new Date().toISOString(),
+            taskId: args.id,
+        }, undefined, // verbosity (ignored)
+        undefined, // useOptimizedFormat (ignored)
+        undefined, // useAorp (ignored)
+        undefined, // aorpConfig (using auto-generated)
+        args.sessionId);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: (0, response_factory_1.formatAorpAsMarkdown)(response.response),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        // A REST 404 is translated to the same friendly "not found" message the
+        // pre-migration legacy client error path produced via handleStatusCodeError
+        // (which keys off a bare `.statusCode` property). vikunjaRestRequest
+        // always throws MCPError with the status nested under `.details`, so that
+        // 404 case is intercepted here, before the generic MCPError passthrough
+        // below would otherwise re-throw the raw REST error message unchanged.
+        if (error instanceof index_1.MCPError) {
+            if (error.details?.statusCode === 404 && args.id) {
+                throw new index_1.MCPError(index_1.ErrorCode.NOT_FOUND, `Task with ID ${args.id} not found`);
+            }
+            throw error;
+        }
+        // Handle fetch/connection errors with helpful guidance
+        if (error instanceof Error && (error.message.includes('fetch failed') ||
+            error.message.includes('ECONNREFUSED') ||
+            error.message.includes('ENOTFOUND'))) {
+            throw (0, index_1.handleFetchError)(error, 'get task');
+        }
+        // Use standardized error transformation for all other errors
+        if (args.id) {
+            throw (0, index_1.handleStatusCodeError)(error, 'get task', args.id, `Task with ID ${args.id} not found`);
+        }
+        throw (0, index_1.transformApiError)(error, 'Failed to get task');
+    }
+}
+//# sourceMappingURL=TaskReadService.js.map

package/dist/tools/tasks/crud/TaskReadService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskReadService.js","sourceRoot":"","sources":["../../../../src/tools/tasks/crud/TaskReadService.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAqBH,0BAgEC;AAnFD,0CAAiH;AAEjH,8DAAiE;AACjE,8CAA2C;AAC3C,mEAA6D;AAC7D,sEAAuE;AAWvE;;GAEG;AACI,KAAK,UAAU,OAAO,CAC3B,IAAiB,EACjB,WAAwB;IAExB,IAAI,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,IAAI,gBAAQ,CAAC,iBAAS,CAAC,gBAAgB,EAAE,uCAAuC,CAAC,CAAC;QAC1F,CAAC;QACD,IAAA,uBAAU,EAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAE1B,MAAM,IAAI,GAAG,MAAM,IAAA,iCAAkB,EAAc,WAAW,EAAE,KAAK,EAAE,UAAU,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAE5F,MAAM,QAAQ,GAAG,IAAA,0CAAkB,EACjC,UAAU,EACV,mBAAmB,IAAI,CAAC,KAAK,GAAG,EAChC,EAAE,IAAI,EAAyD,EAC/D;YACE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,MAAM,EAAE,IAAI,CAAC,EAAE;SAChB,EACD,SAAS,EAAE,sBAAsB;QACjC,SAAS,EAAE,+BAA+B;QAC1C,SAAS,EAAE,oBAAoB;QAC/B,SAAS,EAAE,oCAAoC;QAC/C,IAAI,CAAC,SAAS,CACf,CAAC;QAEF,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAA,uCAAoB,EAAC,QAAQ,CAAC,QAAQ,CAAC;iBAC9C;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,wEAAwE;QACxE,4EAA4E;QAC5E,qEAAqE;QACrE,0EAA0E;QAC1E,wEAAwE;QACxE,uEAAuE;QACvE,IAAI,KAAK,YAAY,gBAAQ,EAAE,CAAC;YAC9B,IAAI,KAAK,CAAC,OAAO,EAAE,UAAU,KAAK,GAAG,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;gBACjD,MAAM,IAAI,gBAAQ,CAAC,iBAAS,CAAC,SAAS,EAAE,gBAAgB,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC;YAC/E,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QAED,uDAAuD;QACvD,IAAI,KAAK,YAAY,KAAK,IAAI,CAC5B,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;YACtC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;YACtC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CACpC,EAAE,CAAC;YACF,MAAM,IAAA,wBAAgB,EAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAC5C,CAAC;QAED,6DAA6D;QAC7D,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAA,6BAAqB,EAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE,gBAAgB,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC;QAC/F,CAAC;QACD,MAAM,IAAA,yBAAiB,EAAC,KAAK,EAAE,oBAAoB,CAAC,CAAC;IACvD,CAAC;AACH,CAAC"}