vikunja-mcp-ng 0.4.0

package/dist/tools/templates.js

@@ -0,0 +1,450 @@
+"use strict";
+/**
+ * Templates Tool
+ * Handles project template operations for Vikunja
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerTemplatesTool = registerTemplatesTool;
+const zod_1 = require("zod");
+const types_1 = require("../types");
+const storage_1 = require("../storage");
+// Imported directly from the module (not the `../storage` barrel) so that
+// tests mocking `../../src/storage` wholesale (to stub `storageManager`)
+// don't also need to stub these — they're a separate, self-contained
+// concern (see templateFileStore.ts's header).
+const templateFileStore_1 = require("../storage/templateFileStore");
+const config_1 = require("../config");
+const logger_1 = require("../utils/logger");
+const label_bulk_1 = require("../utils/label-bulk");
+const response_factory_1 = require("../utils/response-factory");
+const vikunja_rest_1 = require("../utils/vikunja-rest");
+const read_only_1 = require("../utils/read-only");
+/**
+ * Get session-scoped storage instance, hydrated from the templates
+ * persistence file (if configured) on first touch for that session.
+ */
+async function getSessionStorage(authManager) {
+    const session = authManager.getSession();
+    const sessionId = session.apiToken ? `${session.apiUrl}:${session.apiToken.substring(0, 8)}` : 'anonymous';
+    const storage = await storage_1.storageManager.getStorage(sessionId, session.userId, session.apiUrl);
+    const persistPath = getTemplatesPersistPath();
+    if (persistPath) {
+        await hydrateTemplatesFromDiskIfNeeded(storage, persistPath);
+    }
+    return storage;
+}
+/**
+ * Resolve the effective templates persistence path (env var wins over
+ * config — see docs/CONFIGURATION.md). Returns `undefined` when persistence
+ * isn't configured, in which case templates stay in-memory-only, exactly as
+ * before this file-backed persistence support was added.
+ */
+function getTemplatesPersistPath() {
+    const configuredPath = config_1.ConfigurationManager.getInstance().loadConfiguration().templates.persistPath;
+    return (0, templateFileStore_1.resolveTemplatesPersistPath)(configuredPath);
+}
+/**
+ * Templates already hydrated from disk in this process, keyed by
+ * `${persistPath}:${sessionId}` — hydration happens once per session per
+ * configured path, not on every call, so repeated tool invocations don't
+ * re-read the file or attempt to re-create already-loaded templates.
+ */
+const hydratedPersistenceKeys = new Set();
+async function hydrateTemplatesFromDiskIfNeeded(storage, persistPath) {
+    const sessionId = storage.getSession().id;
+    const key = `${persistPath}:${sessionId}`;
+    if (hydratedPersistenceKeys.has(key)) {
+        return;
+    }
+    hydratedPersistenceKeys.add(key);
+    const records = (0, templateFileStore_1.loadTemplatesFile)(persistPath);
+    for (const record of records) {
+        try {
+            const existing = await storage.findByName(record.name);
+            if (!existing) {
+                await storage.create({ name: record.name, filter: record.data, isGlobal: true });
+            }
+        }
+        catch (error) {
+            logger_1.logger.warn('Failed to hydrate a template from the persistence file, skipping it', {
+                persistPath,
+                templateId: record.id,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+}
+/**
+ * Write-through: persist the full current template set for this session to
+ * disk, atomically, when persistence is configured. A write failure is
+ * logged but never surfaced as a tool error — the in-memory mutation the
+ * caller just made already succeeded, and durability is a best-effort
+ * bonus, not a correctness requirement (per the "in memory by default"
+ * contract templates.ts documents).
+ */
+async function persistTemplatesIfConfigured(storage) {
+    const persistPath = getTemplatesPersistPath();
+    if (!persistPath) {
+        return;
+    }
+    try {
+        const all = await storage.list();
+        const records = all
+            .filter((filter) => filter.name.startsWith('template_'))
+            .map((filter) => ({ id: filter.name, name: filter.name, data: filter.filter }));
+        (0, templateFileStore_1.writeTemplatesFileAtomic)(persistPath, records);
+    }
+    catch (error) {
+        logger_1.logger.error('Failed to persist templates to disk', {
+            persistPath,
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+function registerTemplatesTool(server, authManager, _clientFactory) {
+    server.tool('vikunja_templates', (0, read_only_1.withReadOnlyNote)('vikunja_templates', 'Manage task templates for creating consistent tasks and project structures. ' +
+        'IMPORTANT: templates are never persisted to Vikunja itself. By default they ' +
+        "are session-only — kept in this server process's memory and lost on restart. " +
+        'Set the templates.persistPath config key (or VIKUNJA_MCP_TEMPLATES_FILE env ' +
+        'var, which wins) to make them durable across restarts via a JSON file on disk ' +
+        '— see docs/CONFIGURATION.md.'), {
+        subcommand: zod_1.z.enum(['create', 'list', 'get', 'update', 'delete', 'instantiate']),
+        // Template fields
+        id: zod_1.z.string().optional(),
+        projectId: zod_1.z.number().optional(),
+        name: zod_1.z.string().optional(),
+        description: zod_1.z.string().optional(),
+        tags: zod_1.z.array(zod_1.z.string()).optional(),
+        // Instantiation fields
+        projectName: zod_1.z.string().optional(),
+        parentProjectId: zod_1.z.number().optional(),
+        variables: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).optional(),
+    }, (0, read_only_1.getToolAnnotations)('vikunja_templates'), async (args) => {
+        try {
+            // Check authentication
+            if (!authManager.isAuthenticated()) {
+                throw new types_1.MCPError(types_1.ErrorCode.AUTH_REQUIRED, 'Authentication required. Please use vikunja_auth.connect first.');
+            }
+            (0, read_only_1.assertWriteAllowed)('vikunja_templates', args.subcommand);
+            const storage = await getSessionStorage(authManager);
+            switch (args.subcommand) {
+                case 'create': {
+                    if (!args.projectId || !args.name) {
+                        throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'projectId and name are required for creating a template');
+                    }
+                    try {
+                        // Get the source project
+                        const project = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'GET', `/projects/${args.projectId}`);
+                        // Get all tasks in the project. NOTE: `GET /projects/{id}/tasks` is
+                        // not present in the vendored OpenAPI spec (only `PUT` is documented
+                        // there) — this mirrors the legacy client's own `getProjectTasks`, which
+                        // calls this same undocumented-but-functional path. Preserved as-is
+                        // per this migration's "transport only, same behavior" scope; see
+                        // docs/API-COVERAGE.md's note on `GET /projects/{id}/tasks` for the
+                        // broader spec-drift context.
+                        const tasks = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'GET', `/projects/${args.projectId}/tasks`);
+                        // Validate hex color if present
+                        if (project.hex_color && !/^#[0-9A-Fa-f]{6}$/.test(project.hex_color)) {
+                            logger_1.logger.warn('Invalid hex color in source project, skipping', {
+                                projectId: args.projectId,
+                                color: project.hex_color,
+                            });
+                        }
+                        // Create template data
+                        const templateId = `template_${Date.now()}`;
+                        const templateData = {
+                            id: templateId,
+                            name: args.name,
+                            ...(args.description && { description: args.description }),
+                            created: new Date().toISOString(),
+                            tags: args.tags || [],
+                            projectData: {
+                                title: project.title ?? '',
+                                ...(project.description && { description: project.description }),
+                                ...(project.hex_color &&
+                                    /^#[0-9A-Fa-f]{6}$/.test(project.hex_color) && {
+                                    hex_color: project.hex_color,
+                                }),
+                            },
+                            tasks: tasks.map((task) => ({
+                                title: task.title ?? '',
+                                ...(task.description && { description: task.description }),
+                                ...(task.labels &&
+                                    task.labels.length > 0 && {
+                                    labels: task.labels
+                                        .map((l) => l.id)
+                                        .filter((id) => id !== undefined),
+                                }),
+                                ...(task.due_date && { due_date: task.due_date }),
+                                ...(task.priority !== undefined && { priority: task.priority }),
+                                ...(task.position !== undefined && { position: task.position }),
+                            })),
+                            variables: {},
+                        };
+                        // Save template as a saved filter
+                        await storage.create({
+                            name: templateId,
+                            filter: JSON.stringify(templateData),
+                            isGlobal: true,
+                        });
+                        await persistTemplatesIfConfigured(storage);
+                        const response = (0, types_1.createStandardResponse)('create-template', `Template "${args.name}" created successfully`, { template: templateData }, { sourceProjectId: args.projectId, taskCount: tasks.length });
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: (0, response_factory_1.formatAorpAsMarkdown)(response),
+                                },
+                            ],
+                        };
+                    }
+                    catch (error) {
+                        throw new types_1.MCPError(types_1.ErrorCode.API_ERROR, `Failed to create template: ${error instanceof Error ? error.message : 'Unknown error'}`);
+                    }
+                }
+                case 'list': {
+                    try {
+                        const savedFilters = await storage.list();
+                        // Convert saved filters back to templates
+                        const templates = savedFilters
+                            .filter((f) => f.name.startsWith('template_'))
+                            .map((f) => {
+                            try {
+                                return JSON.parse(f.filter);
+                            }
+                            catch {
+                                return null;
+                            }
+                        })
+                            .filter((t) => t !== null);
+                        const response = (0, types_1.createStandardResponse)('list-templates', `Retrieved ${templates.length} template${templates.length !== 1 ? 's' : ''}`, { templates }, { count: templates.length });
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: (0, response_factory_1.formatAorpAsMarkdown)(response),
+                                },
+                            ],
+                        };
+                    }
+                    catch (error) {
+                        throw new types_1.MCPError(types_1.ErrorCode.API_ERROR, `Failed to list templates: ${error instanceof Error ? error.message : 'Unknown error'}`);
+                    }
+                }
+                case 'get': {
+                    if (!args.id) {
+                        throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'Template ID is required');
+                    }
+                    try {
+                        const savedFilter = await storage.findByName(args.id);
+                        if (!savedFilter) {
+                            throw new types_1.MCPError(types_1.ErrorCode.NOT_FOUND, `Template with ID ${args.id} not found`);
+                        }
+                        const template = JSON.parse(savedFilter.filter);
+                        const response = (0, types_1.createStandardResponse)('get-template', `Retrieved template "${template.name}"`, { template });
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: (0, response_factory_1.formatAorpAsMarkdown)(response),
+                                },
+                            ],
+                        };
+                    }
+                    catch (error) {
+                        if (error instanceof types_1.MCPError)
+                            throw error;
+                        throw new types_1.MCPError(types_1.ErrorCode.API_ERROR, `Failed to get template: ${error instanceof Error ? error.message : 'Unknown error'}`);
+                    }
+                }
+                case 'update': {
+                    if (!args.id) {
+                        throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'Template ID is required');
+                    }
+                    try {
+                        const savedFilter = await storage.findByName(args.id);
+                        if (!savedFilter) {
+                            throw new types_1.MCPError(types_1.ErrorCode.NOT_FOUND, `Template with ID ${args.id} not found`);
+                        }
+                        const template = JSON.parse(savedFilter.filter);
+                        // Update template fields
+                        if (args.name !== undefined)
+                            template.name = args.name;
+                        if (args.description !== undefined)
+                            template.description = args.description;
+                        if (args.tags !== undefined)
+                            template.tags = args.tags;
+                        // Update the saved filter by finding it first
+                        const existingFilter = await storage.findByName(args.id);
+                        if (existingFilter) {
+                            await storage.update(existingFilter.id, {
+                                filter: JSON.stringify(template),
+                            });
+                            await persistTemplatesIfConfigured(storage);
+                        }
+                        const response = (0, types_1.createStandardResponse)('update-template', `Template "${template.name}" updated successfully`, { template });
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: (0, response_factory_1.formatAorpAsMarkdown)(response),
+                                },
+                            ],
+                        };
+                    }
+                    catch (error) {
+                        if (error instanceof types_1.MCPError)
+                            throw error;
+                        throw new types_1.MCPError(types_1.ErrorCode.API_ERROR, `Failed to update template: ${error instanceof Error ? error.message : 'Unknown error'}`);
+                    }
+                }
+                case 'delete': {
+                    if (!args.id) {
+                        throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'Template ID is required');
+                    }
+                    try {
+                        const savedFilter = await storage.findByName(args.id);
+                        if (!savedFilter) {
+                            throw new types_1.MCPError(types_1.ErrorCode.NOT_FOUND, `Template with ID ${args.id} not found`);
+                        }
+                        const template = JSON.parse(savedFilter.filter);
+                        await storage.delete(savedFilter.id);
+                        await persistTemplatesIfConfigured(storage);
+                        const response = (0, types_1.createStandardResponse)('delete-template', `Template "${template.name}" deleted successfully`, { deletedId: args.id });
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: (0, response_factory_1.formatAorpAsMarkdown)(response),
+                                },
+                            ],
+                        };
+                    }
+                    catch (error) {
+                        if (error instanceof types_1.MCPError)
+                            throw error;
+                        throw new types_1.MCPError(types_1.ErrorCode.API_ERROR, `Failed to delete template: ${error instanceof Error ? error.message : 'Unknown error'}`);
+                    }
+                }
+                case 'instantiate': {
+                    if (!args.id || !args.projectName) {
+                        throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'id and projectName are required for instantiating a template');
+                    }
+                    try {
+                        const savedFilter = await storage.findByName(args.id);
+                        if (!savedFilter) {
+                            throw new types_1.MCPError(types_1.ErrorCode.NOT_FOUND, `Template with ID ${args.id} not found`);
+                        }
+                        const template = JSON.parse(savedFilter.filter);
+                        // Create new project from template
+                        const projectData = {
+                            title: applyVariables(args.projectName, args.variables || {}),
+                            ...(template.projectData.description && {
+                                description: applyVariables(template.projectData.description, args.variables || {}),
+                            }),
+                            ...(args.parentProjectId && { parent_project_id: args.parentProjectId }),
+                        };
+                        if (template.projectData.hex_color) {
+                            projectData.hex_color = template.projectData.hex_color;
+                        }
+                        const newProject = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'PUT', '/projects', projectData);
+                        logger_1.logger.info('Created project from template', {
+                            projectId: newProject.id,
+                            templateId: args.id,
+                        });
+                        // Create tasks from template
+                        const createdTasks = [];
+                        for (const taskTemplate of template.tasks) {
+                            try {
+                                const taskData = {
+                                    title: applyVariables(taskTemplate.title, args.variables || {}),
+                                    project_id: newProject.id ?? 0,
+                                    ...(taskTemplate.description && {
+                                        description: applyVariables(taskTemplate.description, args.variables || {}),
+                                    }),
+                                    ...(taskTemplate.due_date && { due_date: taskTemplate.due_date }),
+                                    ...(taskTemplate.priority !== undefined && { priority: taskTemplate.priority }),
+                                    ...(taskTemplate.position !== undefined && { position: taskTemplate.position }),
+                                };
+                                const createdTask = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'PUT', `/projects/${newProject.id ?? 0}/tasks`, taskData);
+                                createdTasks.push(createdTask);
+                                // Add labels if any
+                                if (taskTemplate.labels && taskTemplate.labels.length > 0) {
+                                    try {
+                                        await (0, label_bulk_1.setTaskLabels)(authManager, createdTask.id ?? 0, taskTemplate.labels);
+                                    }
+                                    catch (labelError) {
+                                        logger_1.logger.warn('Failed to add labels to task', {
+                                            taskId: createdTask.id,
+                                            labels: taskTemplate.labels,
+                                            error: labelError,
+                                        });
+                                    }
+                                }
+                            }
+                            catch (taskError) {
+                                logger_1.logger.warn('Failed to create task from template', {
+                                    taskTitle: taskTemplate.title,
+                                    error: taskError,
+                                });
+                            }
+                        }
+                        const response = (0, types_1.createStandardResponse)('instantiate-template', `Project "${newProject.title}" created from template "${template.name}"`, {
+                            project: newProject,
+                            createdTasks: createdTasks.length,
+                            failedTasks: template.tasks.length - createdTasks.length,
+                        }, { templateId: args.id, templateName: template.name });
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: (0, response_factory_1.formatAorpAsMarkdown)(response),
+                                },
+                            ],
+                        };
+                    }
+                    catch (error) {
+                        if (error instanceof types_1.MCPError)
+                            throw error;
+                        throw new types_1.MCPError(types_1.ErrorCode.API_ERROR, `Failed to instantiate template: ${error instanceof Error ? error.message : 'Unknown error'}`);
+                    }
+                }
+                default:
+                    throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, `Unknown subcommand: ${String(args.subcommand)}`);
+            }
+        }
+        catch (error) {
+            if (error instanceof types_1.MCPError) {
+                throw error;
+            }
+            throw new types_1.MCPError(types_1.ErrorCode.INTERNAL_ERROR, `Unexpected error: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    });
+}
+/**
+ * Escape special regex characters in a string
+ */
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Apply variable substitution to a string
+ */
+function applyVariables(text, variables) {
+    if (!text)
+        return '';
+    let result = text;
+    // Apply custom variables
+    for (const [key, value] of Object.entries(variables)) {
+        const escaped = escapeRegex(key);
+        const pattern = new RegExp(`{{${escaped}}}`, 'g');
+        result = result.replace(pattern, value);
+    }
+    // Apply built-in variables
+    const today = new Date().toISOString().split('T')[0] || '';
+    const now = new Date().toISOString();
+    result = result.replace(/{{TODAY}}/g, today);
+    result = result.replace(/{{NOW}}/g, now);
+    return result;
+}
+//# sourceMappingURL=templates.js.map

package/dist/tools/templates.js.map

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

package/dist/tools/tokens.d.ts

@@ -0,0 +1,37 @@
+/**
+ * API Token Management Tool
+ *
+ * Manages the current user's Vikunja API tokens (`GET/PUT /tokens`,
+ * `DELETE /tokens/{tokenID}` per the OpenAPI spec). Reserved behind the
+ * deny-by-default `tokenManagement` module config key (see
+ * src/config/types.ts DANGEROUS_MODULE_KEYS) because it is credential-
+ * adjacent: an operator must explicitly opt in before an AI assistant can
+ * create or delete API tokens for the connected account.
+ *
+ * Per docs/VIKUNJA_API_ISSUES.md #2, user-scoped endpoints have historically
+ * rejected `tk_*` API tokens (JWT-only), and `/tokens` shares the same
+ * security scheme as those endpoints in the spec. This tool is still
+ * registered for API-token sessions (the tokenManagement config key is the
+ * only registration-time gate — see docs/ENDPOINT-PLAYBOOK.md and the Wave D
+ * item this shipped in), but a call made with an API-token session may be
+ * rejected by the server; the 401/403 branch below surfaces that plainly
+ * rather than pretending it always works.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AuthManager } from '../auth/AuthManager';
+import type { VikunjaClientFactory } from '../client/VikunjaClientFactory';
+/**
+ * `models.APIToken` per the OpenAPI spec. `token` (the actual secret key) is
+ * only ever present in the `create` response — list responses omit it.
+ */
+export interface ApiToken {
+    id?: number;
+    title?: string;
+    token?: string;
+    permissions?: Record<string, string[]>;
+    expires_at?: string;
+    owner_id?: number;
+    created?: string;
+}
+export declare function registerTokensTool(server: McpServer, authManager: AuthManager, _clientFactory?: VikunjaClientFactory): void;
+//# sourceMappingURL=tokens.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/tools/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;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;AAQ3E;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,WAAW,EACxB,cAAc,CAAC,EAAE,oBAAoB,GACpC,IAAI,CA6JN"}

package/dist/tools/tokens.js

@@ -0,0 +1,122 @@
+"use strict";
+/**
+ * API Token Management Tool
+ *
+ * Manages the current user's Vikunja API tokens (`GET/PUT /tokens`,
+ * `DELETE /tokens/{tokenID}` per the OpenAPI spec). Reserved behind the
+ * deny-by-default `tokenManagement` module config key (see
+ * src/config/types.ts DANGEROUS_MODULE_KEYS) because it is credential-
+ * adjacent: an operator must explicitly opt in before an AI assistant can
+ * create or delete API tokens for the connected account.
+ *
+ * Per docs/VIKUNJA_API_ISSUES.md #2, user-scoped endpoints have historically
+ * rejected `tk_*` API tokens (JWT-only), and `/tokens` shares the same
+ * security scheme as those endpoints in the spec. This tool is still
+ * registered for API-token sessions (the tokenManagement config key is the
+ * only registration-time gate — see docs/ENDPOINT-PLAYBOOK.md and the Wave D
+ * item this shipped in), but a call made with an API-token session may be
+ * rejected by the server; the 401/403 branch below surfaces that plainly
+ * rather than pretending it always works.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerTokensTool = registerTokensTool;
+const zod_1 = require("zod");
+const types_1 = require("../types");
+const logger_1 = require("../utils/logger");
+const validation_1 = require("../utils/validation");
+const response_factory_1 = require("../utils/response-factory");
+const vikunja_rest_1 = require("../utils/vikunja-rest");
+const read_only_1 = require("../utils/read-only");
+function registerTokensTool(server, authManager, _clientFactory) {
+    server.tool('vikunja_tokens', (0, read_only_1.withReadOnlyNote)('vikunja_tokens', "Manage the current user's Vikunja API tokens (list, create, delete). Reserved/deny-by-default: only registered when the 'tokenManagement' module config key is explicitly enabled, since it is credential-adjacent. A newly-created token's secret value is only ever returned once, in the 'create' response — it cannot be retrieved again afterwards."), {
+        subcommand: zod_1.z.enum(['list', 'create', 'delete']),
+        // list
+        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
+        title: zod_1.z.string().min(1).optional(),
+        permissions: zod_1.z
+            .record(zod_1.z.array(zod_1.z.string()))
+            .optional()
+            .describe('Map of resource group to allowed actions, e.g. {"tasks":["read_all","update"]}. Valid keys/values are documented via GET /routes on the Vikunja server.'),
+        expiresAt: zod_1.z.string().optional().describe('ISO 8601 date when the token should expire'),
+        ownerId: zod_1.z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Bot user id to create this token for; omitted defaults to the authenticated user"),
+        // delete
+        tokenId: zod_1.z.number().int().positive().optional(),
+    }, (0, read_only_1.getToolAnnotations)('vikunja_tokens'), 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_tokens', subcommand);
+        logger_1.logger.debug('Tokens tool called', { subcommand, args: { ...args, permissions: undefined } });
+        try {
+            switch (subcommand) {
+                case 'list': {
+                    const query = new URLSearchParams();
+                    if (args.page !== undefined)
+                        query.set('page', String(args.page));
+                    if (args.perPage !== undefined)
+                        query.set('per_page', String(args.perPage));
+                    if (args.search !== undefined)
+                        query.set('s', args.search);
+                    const qs = query.toString();
+                    const tokens = (await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'GET', `/tokens${qs ? `?${qs}` : ''}`)) ?? [];
+                    logger_1.logger.info('Listed API tokens', { count: tokens.length });
+                    const aorpResult = (0, response_factory_1.createAorpResponse)('list', `Retrieved ${tokens.length} API tokens`, { tokens }, { success: true, metadata: { count: tokens.length } });
+                    return { content: [{ type: 'text', text: aorpResult.content }] };
+                }
+                case 'create': {
+                    if (!args.title) {
+                        throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'title is required for creating an API token');
+                    }
+                    if (!args.permissions || Object.keys(args.permissions).length === 0) {
+                        throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'permissions is required for creating an API token (e.g. {"tasks":["read_all"]})');
+                    }
+                    const body = {
+                        title: args.title,
+                        permissions: args.permissions,
+                    };
+                    if (args.expiresAt !== undefined)
+                        body.expires_at = args.expiresAt;
+                    if (args.ownerId !== undefined)
+                        body.owner_id = args.ownerId;
+                    const token = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'PUT', '/tokens', body);
+                    logger_1.logger.info('Created API token', { tokenId: token.id, title: token.title });
+                    const aorpResult = (0, response_factory_1.createAorpResponse)('create', `API token '${token.title ?? args.title}' created successfully. Its secret value is shown only now and cannot be retrieved again — store it securely.`, { token }, { success: true, metadata: { count: 1 } });
+                    return { content: [{ type: 'text', text: aorpResult.content }] };
+                }
+                case 'delete': {
+                    const tokenId = (0, validation_1.validateAndConvertId)(args.tokenId, 'tokenId');
+                    await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'DELETE', `/tokens/${tokenId}`);
+                    logger_1.logger.info('Deleted API token', { tokenId });
+                    const aorpResult = (0, response_factory_1.createAorpResponse)('delete', `API token ${tokenId} deleted successfully`, { tokenId }, { success: true, metadata: { count: 1 } });
+                    return { content: [{ type: 'text', text: aorpResult.content }] };
+                }
+                default:
+                    throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, `Unknown subcommand: ${subcommand}`);
+            }
+        }
+        catch (error) {
+            logger_1.logger.error('Token operation failed', { error, subcommand });
+            if (error instanceof types_1.MCPError) {
+                const statusCode = error.details?.statusCode;
+                if (statusCode === 401 || statusCode === 403) {
+                    throw new types_1.MCPError(types_1.ErrorCode.API_ERROR, 'API token management was rejected by the server. Per docs/VIKUNJA_API_ISSUES.md, user-scoped endpoints have historically required JWT authentication (tk_* API tokens are rejected) — try reconnecting with a JWT via vikunja_auth.connect.');
+                }
+                throw error;
+            }
+            if (error instanceof Error) {
+                throw new types_1.MCPError(types_1.ErrorCode.API_ERROR, `Token operation failed: ${error.message}`);
+            }
+            throw new types_1.MCPError(types_1.ErrorCode.INTERNAL_ERROR, 'An unexpected error occurred during token operation');
+        }
+    });
+}
+//# sourceMappingURL=tokens.js.map