vikunja-mcp-ng 0.4.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAK3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAG3D,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,yBAAyB,EACzB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,yBAAyB,EACzB,yBAAyB,EACzB,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB,EACjB,wBAAwB,GACzB,CAAC;AA2BF;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,WAAW,EACxB,aAAa,CAAC,EAAE,oBAAoB,GACnC,IAAI,CAqIN"}

package/dist/tools/index.js

@@ -0,0 +1,217 @@
+"use strict";
+/**
+ * Tool Registration
+ * Registers all Vikunja tools with the MCP server using conditional registration
+ *
+ * Registration Strategy:
+ * - Core tools (auth, tasks): Always registered
+ * - Client-dependent tools: Only registered when clientFactory is available
+ * - JWT-restricted tools (users, export): Only registered with JWT authentication
+ *
+ * This approach ensures tool availability matches authentication capabilities
+ * and prevents API errors from unsupported token types.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerUserDeletionTool = exports.registerAdminTool = exports.registerCaldavTokensTool = exports.registerTokensTool = exports.registerReactionsTool = exports.registerSubscriptionsTool = exports.registerNotificationsTool = exports.registerExportTool = exports.registerBatchImportTool = exports.registerWebhooksTool = exports.registerTemplatesTool = exports.registerFiltersTool = exports.registerUsersTool = exports.registerTeamsTool = exports.registerLabelsTool = exports.registerProjectsTool = exports.registerTaskRelationsTool = exports.registerTaskLabelsTool = exports.registerTaskRemindersTool = exports.registerTaskCommentsTool = exports.registerTaskAssigneesTool = exports.registerTaskBulkTool = exports.registerTasksTool = exports.registerAuthTool = void 0;
+exports.registerTools = registerTools;
+const config_1 = require("../config");
+const logger_1 = require("../utils/logger");
+const auth_1 = require("./auth");
+Object.defineProperty(exports, "registerAuthTool", { enumerable: true, get: function () { return auth_1.registerAuthTool; } });
+const tasks_1 = require("./tasks");
+Object.defineProperty(exports, "registerTasksTool", { enumerable: true, get: function () { return tasks_1.registerTasksTool; } });
+const task_bulk_1 = require("./task-bulk");
+Object.defineProperty(exports, "registerTaskBulkTool", { enumerable: true, get: function () { return task_bulk_1.registerTaskBulkTool; } });
+const task_assignees_1 = require("./task-assignees");
+Object.defineProperty(exports, "registerTaskAssigneesTool", { enumerable: true, get: function () { return task_assignees_1.registerTaskAssigneesTool; } });
+const task_comments_1 = require("./task-comments");
+Object.defineProperty(exports, "registerTaskCommentsTool", { enumerable: true, get: function () { return task_comments_1.registerTaskCommentsTool; } });
+const task_reminders_1 = require("./task-reminders");
+Object.defineProperty(exports, "registerTaskRemindersTool", { enumerable: true, get: function () { return task_reminders_1.registerTaskRemindersTool; } });
+const task_labels_1 = require("./task-labels");
+Object.defineProperty(exports, "registerTaskLabelsTool", { enumerable: true, get: function () { return task_labels_1.registerTaskLabelsTool; } });
+const task_relations_1 = require("./task-relations");
+Object.defineProperty(exports, "registerTaskRelationsTool", { enumerable: true, get: function () { return task_relations_1.registerTaskRelationsTool; } });
+const index_1 = require("./projects/index");
+Object.defineProperty(exports, "registerProjectsTool", { enumerable: true, get: function () { return index_1.registerProjectsTool; } });
+const labels_1 = require("./labels");
+Object.defineProperty(exports, "registerLabelsTool", { enumerable: true, get: function () { return labels_1.registerLabelsTool; } });
+const teams_1 = require("./teams");
+Object.defineProperty(exports, "registerTeamsTool", { enumerable: true, get: function () { return teams_1.registerTeamsTool; } });
+const users_1 = require("./users");
+Object.defineProperty(exports, "registerUsersTool", { enumerable: true, get: function () { return users_1.registerUsersTool; } });
+const filters_1 = require("./filters");
+Object.defineProperty(exports, "registerFiltersTool", { enumerable: true, get: function () { return filters_1.registerFiltersTool; } });
+const templates_1 = require("./templates");
+Object.defineProperty(exports, "registerTemplatesTool", { enumerable: true, get: function () { return templates_1.registerTemplatesTool; } });
+const webhooks_1 = require("./webhooks");
+Object.defineProperty(exports, "registerWebhooksTool", { enumerable: true, get: function () { return webhooks_1.registerWebhooksTool; } });
+const batch_import_1 = require("./batch-import");
+Object.defineProperty(exports, "registerBatchImportTool", { enumerable: true, get: function () { return batch_import_1.registerBatchImportTool; } });
+const export_1 = require("./export");
+Object.defineProperty(exports, "registerExportTool", { enumerable: true, get: function () { return export_1.registerExportTool; } });
+const notifications_1 = require("./notifications");
+Object.defineProperty(exports, "registerNotificationsTool", { enumerable: true, get: function () { return notifications_1.registerNotificationsTool; } });
+const subscriptions_1 = require("./subscriptions");
+Object.defineProperty(exports, "registerSubscriptionsTool", { enumerable: true, get: function () { return subscriptions_1.registerSubscriptionsTool; } });
+const reactions_1 = require("./reactions");
+Object.defineProperty(exports, "registerReactionsTool", { enumerable: true, get: function () { return reactions_1.registerReactionsTool; } });
+const tokens_1 = require("./tokens");
+Object.defineProperty(exports, "registerTokensTool", { enumerable: true, get: function () { return tokens_1.registerTokensTool; } });
+const caldav_tokens_1 = require("./caldav-tokens");
+Object.defineProperty(exports, "registerCaldavTokensTool", { enumerable: true, get: function () { return caldav_tokens_1.registerCaldavTokensTool; } });
+const admin_1 = require("./admin");
+Object.defineProperty(exports, "registerAdminTool", { enumerable: true, get: function () { return admin_1.registerAdminTool; } });
+const user_deletion_1 = require("./user-deletion");
+Object.defineProperty(exports, "registerUserDeletionTool", { enumerable: true, get: function () { return user_deletion_1.registerUserDeletionTool; } });
+/**
+ * Resolve the module gating configuration, failing safe rather than fatal.
+ *
+ * `ConfigurationManager.loadConfiguration()` fails fast (throws) on a
+ * malformed config file or a `_FILE`/plain env var conflict — appropriate for
+ * a direct, single-shot config load. Tool registration, however, can be
+ * retried (see the fallback registration paths in `src/index.ts`), and a
+ * config error must not spiral into a repeated-throw/unhandled-rejection
+ * crash loop there. So here we load once, log clearly on failure, and fall
+ * back to the schema's built-in module defaults so the server still starts
+ * with sane (default-on / dangerous-off) gating rather than not starting at all.
+ */
+function resolveModulesConfig() {
+    try {
+        return config_1.ConfigurationManager.getInstance().loadConfiguration().modules;
+    }
+    catch (error) {
+        logger_1.logger.error('Failed to load module gating configuration; falling back to defaults ' +
+            '(ordinary modules ON, dangerous modules OFF):', error);
+        return config_1.ModulesConfigSchema.parse({});
+    }
+}
+/**
+ * Module-gated tool registration.
+ *
+ * Every module toggle (see `src/config/types.ts` ModulesConfigSchema) is
+ * resolved once up front and applied here, at registration time: a disabled
+ * module's tools are simply never registered, so they are invisible to the
+ * MCP client rather than merely rejecting calls. Module config can only
+ * NARROW what authentication already allows — the JWT-only gating below for
+ * `users`/`export` is applied in addition to (never instead of) the module
+ * check, so no config setting can grant access auth doesn't already permit.
+ */
+function registerTools(server, authManager, clientFactory) {
+    // Register tools with conditional availability based on dependencies, module
+    // gating configuration, and authentication.
+    const modules = resolveModulesConfig();
+    (0, auth_1.registerAuthTool)(server, authManager);
+    // Register the comprehensive tasks tool and its granular counterparts,
+    // gated together behind the single "tasks" module toggle.
+    //
+    // NOTE: `vikunja_task_crud` (create/get/update/delete/list) previously
+    // registered here as a second entry point onto the exact same
+    // `src/tools/tasks/crud/*` functions `vikunja_tasks` already exposes via
+    // its `create`/`get`/`update`/`delete`/`list` subcommands. It was removed
+    // as redundant tool surface (Wave D hygiene, item D8) — see
+    // docs/API-COVERAGE.md's Tasks CRUD finding. `vikunja_tasks` is the
+    // supported replacement; no capability was lost.
+    if ((0, config_1.isModuleEnabled)(modules.tasks)) {
+        (0, tasks_1.registerTasksTool)(server, authManager, clientFactory);
+        (0, task_bulk_1.registerTaskBulkTool)(server, authManager, clientFactory);
+        (0, task_assignees_1.registerTaskAssigneesTool)(server, authManager, clientFactory);
+        (0, task_comments_1.registerTaskCommentsTool)(server, authManager, clientFactory);
+        (0, task_reminders_1.registerTaskRemindersTool)(server, authManager, clientFactory);
+        (0, task_labels_1.registerTaskLabelsTool)(server, authManager, clientFactory);
+        (0, task_relations_1.registerTaskRelationsTool)(server, authManager, clientFactory);
+    }
+    // Only register tools that require clientFactory if it's available
+    if (clientFactory) {
+        if ((0, config_1.isModuleEnabled)(modules.projects)) {
+            // `backgrounds` gates only three subcommands *within* this tool
+            // (remove-background/set-unsplash-background/search-unsplash — G7,
+            // opt-in cosmetic module, deny-by-default) rather than the whole
+            // tool; the resolved flag is passed down so registerProjectsTool
+            // builds its subcommand enum accordingly. See that function's doc
+            // comment and src/config/types.ts's `backgrounds` key.
+            (0, index_1.registerProjectsTool)(server, authManager, clientFactory, (0, config_1.isModuleEnabled)(modules.backgrounds));
+        }
+        if ((0, config_1.isModuleEnabled)(modules.labels)) {
+            (0, labels_1.registerLabelsTool)(server, authManager, clientFactory);
+        }
+        if ((0, config_1.isModuleEnabled)(modules.teams)) {
+            (0, teams_1.registerTeamsTool)(server, authManager, clientFactory);
+        }
+        // Register filters tool (needs auth manager for session-scoped storage)
+        if ((0, config_1.isModuleEnabled)(modules.filters)) {
+            (0, filters_1.registerFiltersTool)(server, authManager, clientFactory);
+        }
+        // Register templates tool
+        if ((0, config_1.isModuleEnabled)(modules.templates)) {
+            (0, templates_1.registerTemplatesTool)(server, authManager, clientFactory);
+        }
+        // Register webhooks tool
+        if ((0, config_1.isModuleEnabled)(modules.webhooks)) {
+            (0, webhooks_1.registerWebhooksTool)(server, authManager, clientFactory);
+        }
+        // Register batch import tool
+        if ((0, config_1.isModuleEnabled)(modules.batchImport)) {
+            (0, batch_import_1.registerBatchImportTool)(server, authManager, clientFactory);
+        }
+        // Register notifications tool
+        if ((0, config_1.isModuleEnabled)(modules.notifications)) {
+            (0, notifications_1.registerNotificationsTool)(server, authManager, clientFactory);
+        }
+        // Register subscriptions tool
+        if ((0, config_1.isModuleEnabled)(modules.subscriptions)) {
+            (0, subscriptions_1.registerSubscriptionsTool)(server, authManager, clientFactory);
+        }
+        // Register reactions tool
+        if ((0, config_1.isModuleEnabled)(modules.reactions)) {
+            (0, reactions_1.registerReactionsTool)(server, authManager, clientFactory);
+        }
+        // Register API-token-management tool. Reserved/deny-by-default (see
+        // DANGEROUS_MODULE_KEYS in src/config/types.ts) — only gated by the
+        // 'tokenManagement' config key, no auth-type restriction (unlike
+        // users/export/admin): the underlying /tokens endpoints may reject
+        // API-token sessions server-side (see src/tools/tokens.ts's doc
+        // comment), but that is a runtime concern for the tool to report, not a
+        // registration-time gate.
+        if ((0, config_1.isModuleEnabled)(modules.tokenManagement)) {
+            (0, tokens_1.registerTokensTool)(server, authManager, clientFactory);
+        }
+        // Register user and export tools conditionally (preserving backward compatibility)
+        // NOTE: The permission infrastructure is available for future migration.
+        // Module config can only narrow this JWT-only gate, never expand it.
+        const jwtAuthenticated = authManager.isAuthenticated() && authManager.getAuthType() === 'jwt';
+        if (jwtAuthenticated && (0, config_1.isModuleEnabled)(modules.users)) {
+            (0, users_1.registerUsersTool)(server, authManager, clientFactory);
+        }
+        if (jwtAuthenticated && (0, config_1.isModuleEnabled)(modules.export)) {
+            (0, export_1.registerExportTool)(server, authManager, clientFactory);
+        }
+        // Register CalDAV token management tool. Reserved/deny-by-default AND
+        // JWT-only: both the 'caldavTokens' module config key and JWT auth must
+        // allow it (config can only narrow what auth permits, never expand it —
+        // same composition as users/export/admin). Unlike 'tokenManagement'
+        // (vikunja_tokens, which registers for either session type), the
+        // underlying /user/settings/token/caldav* endpoints are JWT-only per
+        // the vendored OpenAPI spec, so the JWT gate is enforced here at
+        // registration time rather than left to the server to reject at
+        // runtime — see src/tools/caldav-tokens.ts.
+        if (jwtAuthenticated && (0, config_1.isModuleEnabled)(modules.caldavTokens)) {
+            (0, caldav_tokens_1.registerCaldavTokensTool)(server, authManager, clientFactory);
+        }
+        // Register instance-admin tool. Reserved/deny-by-default AND JWT-only:
+        // both the 'admin' module config key and JWT auth must allow it (config
+        // can only narrow what auth permits, never expand it — same composition
+        // as users/export above).
+        if (jwtAuthenticated && (0, config_1.isModuleEnabled)(modules.admin)) {
+            (0, admin_1.registerAdminTool)(server, authManager, clientFactory);
+        }
+        // Register user self-deletion tool. Reserved/deny-by-default AND
+        // JWT-only, same composition as admin/users/export above: both the
+        // 'userDeletion' module config key and JWT auth must allow it. This is
+        // the reserved DANGEROUS_MODULE_KEYS slot finally getting a tool.
+        if (jwtAuthenticated && (0, config_1.isModuleEnabled)(modules.userDeletion)) {
+            (0, user_deletion_1.registerUserDeletionTool)(server, authManager, clientFactory);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

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

package/dist/tools/labels.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Labels Tool
+ * Handles label operations for Vikunja
+ *
+ * Migrated off the legacy client (Wave D domain migration, tracking issue #28)
+ * onto `vikunjaRestRequest` + types generated from the vendored OpenAPI
+ * spec. See docs/ENDPOINT-PLAYBOOK.md §6.
+ *
+ * Endpoints (verified against docs/vikunja-openapi.json):
+ *   - GET    /labels       list
+ *   - PUT    /labels       create
+ *   - GET    /labels/{id}  get
+ *   - PUT    /labels/{id}  update (models.Label — not full-model-replace;
+ *                          the label service's `Update` handler only applies
+ *                          fields present on the incoming struct)
+ *   - DELETE /labels/{id}  delete
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AuthManager } from '../auth/AuthManager';
+import type { VikunjaClientFactory } from '../client/VikunjaClientFactory';
+export declare function registerLabelsTool(server: McpServer, authManager: AuthManager, _clientFactory?: VikunjaClientFactory): void;
+//# sourceMappingURL=labels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../src/tools/labels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAoC3E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,CAAC,EAAE,oBAAoB,GAAG,IAAI,CA2N3H"}

package/dist/tools/labels.js

@@ -0,0 +1,206 @@
+"use strict";
+/**
+ * Labels Tool
+ * Handles label operations for Vikunja
+ *
+ * Migrated off the legacy client (Wave D domain migration, tracking issue #28)
+ * onto `vikunjaRestRequest` + types generated from the vendored OpenAPI
+ * spec. See docs/ENDPOINT-PLAYBOOK.md §6.
+ *
+ * Endpoints (verified against docs/vikunja-openapi.json):
+ *   - GET    /labels       list
+ *   - PUT    /labels       create
+ *   - GET    /labels/{id}  get
+ *   - PUT    /labels/{id}  update (models.Label — not full-model-replace;
+ *                          the label service's `Update` handler only applies
+ *                          fields present on the incoming struct)
+ *   - DELETE /labels/{id}  delete
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerLabelsTool = registerLabelsTool;
+const zod_1 = require("zod");
+const types_1 = require("../types");
+const validation_1 = require("../utils/validation");
+const error_handler_1 = require("../utils/error-handler");
+const vikunja_rest_1 = require("../utils/vikunja-rest");
+const response_factory_1 = require("../utils/response-factory");
+const read_only_1 = require("../utils/read-only");
+// Use shared validateAndConvertId from utils/validation
+/**
+ * Re-throws a REST-layer 404 (`vikunjaRestRequest` throws `MCPError` with
+ * `details.statusCode`, not a bare `.statusCode` property) as a friendly
+ * "Label with ID X not found" — matching the message the legacy-client-backed
+ * implementation produced via its own thrown `.statusCode`-bearing errors.
+ * Everything else is rethrown/wrapped unchanged by the caller's
+ * `wrapToolError` fallback.
+ */
+function rethrowLabelNotFound(error, id) {
+    if (error instanceof types_1.MCPError && error.details?.statusCode === 404) {
+        throw new types_1.MCPError(types_1.ErrorCode.NOT_FOUND, `Label with ID ${id} not found`);
+    }
+    throw error;
+}
+function registerLabelsTool(server, authManager, _clientFactory) {
+    server.tool('vikunja_labels', (0, read_only_1.withReadOnlyNote)('vikunja_labels', 'Manage task labels with full CRUD operations for organizing and categorizing tasks'), {
+        // Operation type
+        subcommand: zod_1.z.enum(['list', 'get', 'create', 'update', 'delete']),
+        // Common parameters
+        id: zod_1.z.number().int().positive().optional(),
+        // List parameters
+        page: zod_1.z.number().int().positive().optional(),
+        perPage: zod_1.z.number().int().positive().max(100).optional(),
+        search: zod_1.z.string().optional(),
+        // Create/Update parameters
+        title: zod_1.z.string().min(1).optional(),
+        description: zod_1.z.string().optional(),
+        hexColor: zod_1.z
+            .string()
+            .regex(/^#[0-9A-Fa-f]{6}$/, 'Invalid hex color format')
+            .optional(),
+    }, (0, read_only_1.getToolAnnotations)('vikunja_labels'), async (args) => {
+        if (!authManager.isAuthenticated()) {
+            throw new types_1.MCPError(types_1.ErrorCode.AUTH_REQUIRED, 'Authentication required. Please use vikunja_auth.connect first.');
+        }
+        const subcommand = args.subcommand;
+        (0, read_only_1.assertWriteAllowed)('vikunja_labels', subcommand);
+        try {
+            switch (subcommand) {
+                case 'list': {
+                    const params = new URLSearchParams();
+                    if (args.page)
+                        params.set('page', String(args.page));
+                    if (args.perPage)
+                        params.set('per_page', String(args.perPage));
+                    if (args.search)
+                        params.set('s', args.search);
+                    const query = params.toString();
+                    const labelsResult = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'GET', `/labels${query ? `?${query}` : ''}`);
+                    // Handle null/undefined response from API
+                    const labels = labelsResult ?? [];
+                    const paramsMetadata = {};
+                    if (args.page)
+                        paramsMetadata.page = args.page;
+                    if (args.perPage)
+                        paramsMetadata.per_page = args.perPage;
+                    if (args.search)
+                        paramsMetadata.s = args.search;
+                    const response = (0, types_1.createStandardResponse)('list-labels', `Retrieved ${labels.length} label${labels.length !== 1 ? 's' : ''}`, { labels: labels }, { count: labels.length, params: paramsMetadata });
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: (0, response_factory_1.formatAorpAsMarkdown)(response),
+                            },
+                        ],
+                    };
+                }
+                case 'get': {
+                    if (args.id === undefined) {
+                        throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'Label ID is required');
+                    }
+                    (0, validation_1.validateAndConvertId)(args.id, 'id');
+                    let label;
+                    try {
+                        label = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'GET', `/labels/${args.id}`);
+                    }
+                    catch (error) {
+                        rethrowLabelNotFound(error, args.id);
+                    }
+                    const response = (0, types_1.createStandardResponse)('get-label', `Retrieved label "${label.title}"`, { label });
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: (0, response_factory_1.formatAorpAsMarkdown)(response),
+                            },
+                        ],
+                    };
+                }
+                case 'create': {
+                    if (!args.title) {
+                        throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'Title is required');
+                    }
+                    const labelData = {
+                        title: args.title,
+                    };
+                    if (args.description)
+                        labelData.description = args.description;
+                    if (args.hexColor)
+                        labelData.hex_color = args.hexColor;
+                    const label = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'PUT', '/labels', labelData);
+                    const response = (0, types_1.createStandardResponse)('create-label', `Label "${label.title}" created successfully`, { label }, { affectedFields: Object.keys(labelData).filter(key => typeof key === 'string') });
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: (0, response_factory_1.formatAorpAsMarkdown)(response),
+                            },
+                        ],
+                    };
+                }
+                case 'update': {
+                    if (args.id === undefined) {
+                        throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'Label ID is required');
+                    }
+                    (0, validation_1.validateAndConvertId)(args.id, 'id');
+                    if (!args.title && args.description === undefined && !args.hexColor) {
+                        throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'At least one field to update is required');
+                    }
+                    const updates = {};
+                    if (args.title)
+                        updates.title = args.title;
+                    if (args.description !== undefined)
+                        updates.description = args.description;
+                    if (args.hexColor)
+                        updates.hex_color = args.hexColor;
+                    let label;
+                    try {
+                        label = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'PUT', `/labels/${args.id}`, updates);
+                    }
+                    catch (error) {
+                        rethrowLabelNotFound(error, args.id);
+                    }
+                    const response = (0, types_1.createStandardResponse)('update-label', `Label "${label.title}" updated successfully`, { label }, { affectedFields: Object.keys(updates).filter(key => typeof key === 'string') });
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: (0, response_factory_1.formatAorpAsMarkdown)(response),
+                            },
+                        ],
+                    };
+                }
+                case 'delete': {
+                    if (args.id === undefined) {
+                        throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'Label ID is required');
+                    }
+                    (0, validation_1.validateAndConvertId)(args.id, 'id');
+                    let result;
+                    try {
+                        result = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'DELETE', `/labels/${args.id}`);
+                    }
+                    catch (error) {
+                        rethrowLabelNotFound(error, args.id);
+                    }
+                    const response = (0, types_1.createStandardResponse)('delete-label', `Label deleted successfully`, {
+                        result,
+                    });
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: (0, response_factory_1.formatAorpAsMarkdown)(response),
+                            },
+                        ],
+                    };
+                }
+                default:
+                    throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, `Invalid subcommand: ${String(subcommand)}`);
+            }
+        }
+        catch (error) {
+            throw (0, error_handler_1.wrapToolError)(error, 'vikunja_labels', `${subcommand} label`, args.id);
+        }
+    });
+}
+//# sourceMappingURL=labels.js.map

package/dist/tools/labels.js.map

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

package/dist/tools/notifications.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Notifications Tool
+ *
+ * Wraps Vikunja's `/notifications` endpoints (see docs/vikunja-openapi.json):
+ *   - GET  /notifications        -> list, with page/per_page pagination
+ *   - POST /notifications        -> mark every notification read
+ *   - POST /notifications/{id}   -> toggle a single notification's read state
+ *
+ * All calls go through `vikunjaRestRequest` (direct-REST rule, see
+ * docs/ENDPOINT-PLAYBOOK.md §3) — legacy client has no notifications support
+ * to migrate away from, so this is a pure new call site.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AuthManager } from '../auth/AuthManager';
+import type { VikunjaClientFactory } from '../client/VikunjaClientFactory';
+export declare function registerNotificationsTool(server: McpServer, authManager: AuthManager, _clientFactory?: VikunjaClientFactory): void;
+//# sourceMappingURL=notifications.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../src/tools/notifications.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAqF3E,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,WAAW,EACxB,cAAc,CAAC,EAAE,oBAAoB,GACpC,IAAI,CA4KN"}