vikunja-mcp-ng 0.4.0

package/dist/tools/notifications.js

@@ -0,0 +1,171 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerNotificationsTool = registerNotificationsTool;
+const zod_1 = require("zod");
+const types_1 = require("../types");
+const client_1 = require("../client");
+const logger_1 = require("../utils/logger");
+const read_only_1 = require("../utils/read-only");
+const validation_1 = require("../utils/validation");
+const response_factory_1 = require("../utils/response-factory");
+const vikunja_rest_1 = require("../utils/vikunja-rest");
+/**
+ * Best-effort, zero-extra-request enrichment: some notification kinds (e.g.
+ * task assignment, task comments) embed a `{ task: { id, title } }` shape in
+ * their untyped `notification` payload in practice, but this is NOT
+ * documented in the OpenAPI spec (see `VikunjaNotification` doc comment
+ * above) — so this is purely a defensive, best-effort extraction over data
+ * already in hand from the `list` response, never a new API call, and it
+ * silently returns `undefined` (rather than throwing) whenever the shape
+ * doesn't match. This is what backs the `list` subcommand's optional
+ * `relatedTask` convenience field.
+ */
+function extractRelatedTask(content) {
+    if (!content || typeof content !== 'object') {
+        return undefined;
+    }
+    const task = content.task;
+    if (!task || typeof task !== 'object') {
+        return undefined;
+    }
+    const id = task.id;
+    const title = task.title;
+    if (typeof id === 'number' && typeof title === 'string') {
+        return { id, title };
+    }
+    return undefined;
+}
+/**
+ * Ensures a notification ends up marked READ, working around
+ * `POST /notifications/{id}` being a pure toggle in the API (per the spec:
+ * "Marks a notification as either read or unread", no request body to pick
+ * which). A blind single POST would silently mark an already-read
+ * notification unread again on a repeat call — this makes `mark-read`
+ * idempotent (verify-then-apply, docs/ENDPOINT-PLAYBOOK.md §1) by checking
+ * the response and, if the toggle landed on "unread", toggling once more.
+ * At most 2 requests; typically 1.
+ */
+async function ensureNotificationRead(authManager, notificationId) {
+    let notification = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'POST', `/notifications/${notificationId}`);
+    if (!notification?.read_at) {
+        notification = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'POST', `/notifications/${notificationId}`);
+    }
+    return notification;
+}
+function registerNotificationsTool(server, authManager, _clientFactory) {
+    server.tool('vikunja_notifications', (0, read_only_1.withReadOnlyNote)('vikunja_notifications', "Manage the current user's Vikunja notifications: list (with optional " +
+        "unread filtering and pagination), mark a single notification read " +
+        "(idempotent — safe to call repeatedly), and mark all notifications " +
+        "read at once."), {
+        subcommand: zod_1.z.enum(['list', 'mark-read', 'mark-all-read']),
+        // list parameters
+        unreadOnly: zod_1.z.boolean().optional(),
+        page: zod_1.z.number().int().positive().optional(),
+        perPage: zod_1.z.number().int().positive().optional(),
+        // mark-read parameter
+        notificationId: zod_1.z.number().int().positive().optional(),
+    }, (0, read_only_1.getToolAnnotations)('vikunja_notifications'), async (args) => {
+        if (!authManager.isAuthenticated()) {
+            throw new types_1.MCPError(types_1.ErrorCode.AUTH_REQUIRED, 'Authentication required. Please use vikunja_auth.connect first.');
+        }
+        await (0, client_1.getAuthManagerFromContext)(); // Ensure the session is initialized
+        const subcommand = args.subcommand;
+        (0, read_only_1.assertWriteAllowed)('vikunja_notifications', subcommand);
+        logger_1.logger.debug('Notifications tool called', { subcommand, args });
+        try {
+            switch (subcommand) {
+                case 'list': {
+                    const query = [];
+                    if (args.page !== undefined) {
+                        query.push(`page=${encodeURIComponent(String(args.page))}`);
+                    }
+                    if (args.perPage !== undefined) {
+                        query.push(`per_page=${encodeURIComponent(String(args.perPage))}`);
+                    }
+                    const qs = query.length > 0 ? `?${query.join('&')}` : '';
+                    const allNotifications = (await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'GET', `/notifications${qs}`)) ?? [];
+                    // The spec's page/per_page are the only server-side filters
+                    // documented for this endpoint — there is no server-side
+                    // unread filter, so `unreadOnly` is applied client-side over the
+                    // fetched page.
+                    const notifications = args.unreadOnly
+                        ? allNotifications.filter((n) => !n.read_at)
+                        : allNotifications;
+                    // Read-composite (docs/ENDPOINT-PLAYBOOK.md §1): attach a
+                    // best-effort relatedTask summary with zero extra requests,
+                    // see extractRelatedTask() doc comment for why this is
+                    // heuristic rather than spec-guaranteed.
+                    const enriched = notifications.map((n) => {
+                        const relatedTask = extractRelatedTask(n.notification);
+                        return relatedTask ? { ...n, relatedTask } : n;
+                    });
+                    logger_1.logger.info('Listed notifications', {
+                        count: enriched.length,
+                        unreadOnly: !!args.unreadOnly,
+                    });
+                    const aorpResult = (0, response_factory_1.createAorpResponse)('list', `Retrieved ${enriched.length} notification(s)`, { notifications: enriched }, {
+                        success: true,
+                        metadata: {
+                            count: enriched.length,
+                        },
+                    });
+                    return {
+                        content: [{ type: 'text', text: aorpResult.content }],
+                    };
+                }
+                case 'mark-read': {
+                    const notificationId = (0, validation_1.validateAndConvertId)(args.notificationId, 'notificationId');
+                    const notification = await ensureNotificationRead(authManager, notificationId);
+                    logger_1.logger.info('Marked notification read', { notificationId });
+                    const aorpResult = (0, response_factory_1.createAorpResponse)('mark-read', `Notification ${notificationId} marked as read`, { notification }, {
+                        success: true,
+                        metadata: { count: 1 },
+                    });
+                    return {
+                        content: [{ type: 'text', text: aorpResult.content }],
+                    };
+                }
+                case 'mark-all-read': {
+                    const result = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'POST', '/notifications');
+                    logger_1.logger.info('Marked all notifications read');
+                    const aorpResult = (0, response_factory_1.createAorpResponse)('mark-all-read', result?.message ?? 'All notifications marked as read', {}, { success: true });
+                    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('Notifications operation failed', { error, subcommand, args });
+            if (error instanceof types_1.MCPError) {
+                // Link shares cannot have notifications — the spec documents a
+                // dedicated 403 for this case; surface it plainly rather than the
+                // generic HTTP error text.
+                const statusCode = error.details?.statusCode;
+                if (statusCode === 403) {
+                    throw new types_1.MCPError(types_1.ErrorCode.PERMISSION_DENIED, 'Link shares cannot have notifications. Authenticate as a full user to use vikunja_notifications.');
+                }
+                throw error;
+            }
+            if (error instanceof Error) {
+                throw new types_1.MCPError(types_1.ErrorCode.API_ERROR, `Notifications operation failed: ${error.message}`);
+            }
+            throw new types_1.MCPError(types_1.ErrorCode.INTERNAL_ERROR, 'An unexpected error occurred during a notifications operation');
+        }
+    });
+}
+//# sourceMappingURL=notifications.js.map

package/dist/tools/notifications.js.map

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

package/dist/tools/projects/backgrounds.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Project backgrounds — JSON-only subset (G7, docs/ENDPOINT-TAIL-RETRIAGE.md)
+ *
+ * Gated behind the opt-in, deny-by-default `backgrounds` module config key
+ * (`src/config/types.ts` — see the comment there for why this is "opt-in
+ * cosmetic", the deliberate opposite of every other default-on domain
+ * module). `registerProjectsTool` (`./index.ts`) only includes these three
+ * subcommands in `vikunja_projects`'s subcommand enum when the module is
+ * enabled, so — matching every other module's contract — they are genuinely
+ * absent from the tool's schema when disabled, not merely rejected at
+ * dispatch.
+ *
+ * Endpoints implemented (verified against docs/vikunja-openapi.json):
+ *   - DELETE /projects/{id}/background           -> models.Project
+ *   - POST   /projects/{id}/backgrounds/unsplash  -> models.Project
+ *   - GET    /backgrounds/unsplash/search         -> background.Image[]
+ *
+ * Deliberately parked (binary image bytes — no MCP content channel for
+ * them; see docs/ENDPOINT-TAIL-RETRIAGE.md and docs/ROADMAP.md §4):
+ *   - PUT  /projects/{id}/backgrounds/upload
+ *   - GET  /projects/{id}/background (the image bytes themselves)
+ *   - GET  /backgrounds/unsplash/image/{image}(/thumb)
+ *
+ * `POST /projects/{id}/backgrounds/unsplash`'s request body is typed as
+ * `background.Image` in the spec (id/url/thumb/blur_hash/info), but the
+ * server only needs the photo `id` — the endpoint description confirms it
+ * "sets a photo from unsplash as project background" by ID, not by echoing
+ * back full image metadata the caller has no independent way to know. So
+ * this module only accepts/sends `id`, matching G7's own scoping note
+ * ("likely the unsplash photo id").
+ *
+ * Unsplash search/set only work when the connected Vikunja server has an
+ * Unsplash provider configured (an admin-side API key). When it doesn't,
+ * the server errors — `wrapUnsplashProviderError` recognizes that shape and
+ * rewrites it into a friendly, actionable message instead of surfacing the
+ * server's raw error text.
+ */
+import type { AuthManager } from '../../auth/AuthManager';
+export type McpResponse = {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+};
+export interface RemoveBackgroundArgs {
+    /** Project id to remove the background from. */
+    id?: number;
+    sessionId?: string;
+}
+export interface SetUnsplashBackgroundArgs {
+    /** Project id to set the background on. */
+    id?: number;
+    /** The unsplash photo id (`background.Image.id` from `search-unsplash`). */
+    unsplashImageId?: string;
+    sessionId?: string;
+}
+export interface SearchUnsplashArgs {
+    /** Search term (maps to the API's `s` query param). */
+    unsplashQuery?: string;
+    /** Page number, 1-based (maps to the API's `p` query param). */
+    page?: number;
+    sessionId?: string;
+}
+/**
+ * Removes a project's background, regardless of which provider set it.
+ * Per the spec, this does not error if the project has no background set.
+ */
+export declare function removeProjectBackground(args: RemoveBackgroundArgs, authManager: AuthManager): Promise<McpResponse>;
+/**
+ * Sets an unsplash photo (by its unsplash photo id, from `search-unsplash`)
+ * as a project's background.
+ */
+export declare function setUnsplashBackground(args: SetUnsplashBackgroundArgs, authManager: AuthManager): Promise<McpResponse>;
+/**
+ * Searches unsplash for candidate background photos. Only works when the
+ * connected Vikunja server has an Unsplash provider configured — see
+ * `wrapUnsplashError`.
+ */
+export declare function searchUnsplashBackgrounds(args: SearchUnsplashArgs, authManager: AuthManager): Promise<McpResponse>;
+//# sourceMappingURL=backgrounds.d.ts.map

package/dist/tools/projects/backgrounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backgrounds.d.ts","sourceRoot":"","sources":["../../../src/tools/projects/backgrounds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAY1D,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,2CAA2C;IAC3C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAuCD;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,oBAAoB,EAC1B,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,WAAW,CAAC,CA6BtB;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,yBAAyB,EAC/B,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,WAAW,CAAC,CAmCtB;AAED;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,kBAAkB,EACxB,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,WAAW,CAAC,CAoCtB"}

package/dist/tools/projects/backgrounds.js

@@ -0,0 +1,154 @@
+"use strict";
+/**
+ * Project backgrounds — JSON-only subset (G7, docs/ENDPOINT-TAIL-RETRIAGE.md)
+ *
+ * Gated behind the opt-in, deny-by-default `backgrounds` module config key
+ * (`src/config/types.ts` — see the comment there for why this is "opt-in
+ * cosmetic", the deliberate opposite of every other default-on domain
+ * module). `registerProjectsTool` (`./index.ts`) only includes these three
+ * subcommands in `vikunja_projects`'s subcommand enum when the module is
+ * enabled, so — matching every other module's contract — they are genuinely
+ * absent from the tool's schema when disabled, not merely rejected at
+ * dispatch.
+ *
+ * Endpoints implemented (verified against docs/vikunja-openapi.json):
+ *   - DELETE /projects/{id}/background           -> models.Project
+ *   - POST   /projects/{id}/backgrounds/unsplash  -> models.Project
+ *   - GET    /backgrounds/unsplash/search         -> background.Image[]
+ *
+ * Deliberately parked (binary image bytes — no MCP content channel for
+ * them; see docs/ENDPOINT-TAIL-RETRIAGE.md and docs/ROADMAP.md §4):
+ *   - PUT  /projects/{id}/backgrounds/upload
+ *   - GET  /projects/{id}/background (the image bytes themselves)
+ *   - GET  /backgrounds/unsplash/image/{image}(/thumb)
+ *
+ * `POST /projects/{id}/backgrounds/unsplash`'s request body is typed as
+ * `background.Image` in the spec (id/url/thumb/blur_hash/info), but the
+ * server only needs the photo `id` — the endpoint description confirms it
+ * "sets a photo from unsplash as project background" by ID, not by echoing
+ * back full image metadata the caller has no independent way to know. So
+ * this module only accepts/sends `id`, matching G7's own scoping note
+ * ("likely the unsplash photo id").
+ *
+ * Unsplash search/set only work when the connected Vikunja server has an
+ * Unsplash provider configured (an admin-side API key). When it doesn't,
+ * the server errors — `wrapUnsplashProviderError` recognizes that shape and
+ * rewrites it into a friendly, actionable message instead of surfacing the
+ * server's raw error text.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeProjectBackground = removeProjectBackground;
+exports.setUnsplashBackground = setUnsplashBackground;
+exports.searchUnsplashBackgrounds = searchUnsplashBackgrounds;
+const types_1 = require("../../types");
+const validation_1 = require("../../utils/validation");
+const error_handler_1 = require("../../utils/error-handler");
+const response_factory_1 = require("../../utils/response-factory");
+const vikunja_rest_1 = require("../../utils/vikunja-rest");
+/**
+ * Recognizes the shape of a server error that indicates the Unsplash
+ * provider isn't configured (no admin-side API key / feature disabled) so
+ * it can be rewritten into a friendly, actionable message rather than
+ * surfaced as an opaque server error. Deliberately conservative — only
+ * matches error text that clearly mentions unsplash AND a
+ * configuration/availability concern, so genuine unrelated failures (a bad
+ * project id, a permissions error, an actually-malformed request) are never
+ * misreported as a provider-configuration issue.
+ */
+function isLikelyUnsplashNotConfigured(message) {
+    return /unsplash/i.test(message) && /(not[\s-]*(en|configur)|disabl|no.*(key|token)|access[\s-]*token)/i.test(message);
+}
+/**
+ * Wraps an error from an unsplash-touching REST call: a recognized
+ * "provider not configured" shape gets a friendly explanation (preserving
+ * the original server text for debugging); everything else passes through
+ * unchanged (already a non-stack-trace `MCPError` courtesy of
+ * `vikunjaRestRequest`'s own error contract).
+ */
+function wrapUnsplashError(error, action) {
+    if (error instanceof types_1.MCPError) {
+        if (isLikelyUnsplashNotConfigured(error.message)) {
+            throw new types_1.MCPError(types_1.ErrorCode.API_ERROR, `${action} unavailable: this Vikunja server does not appear to have an Unsplash ` +
+                `background provider configured. Ask your Vikunja administrator to set up an ` +
+                `Unsplash API key (or confirm Unsplash backgrounds are enabled) on the server. ` +
+                `(Server said: ${error.message})`);
+        }
+        throw error;
+    }
+    throw (0, error_handler_1.transformApiError)(error, action);
+}
+/**
+ * Removes a project's background, regardless of which provider set it.
+ * Per the spec, this does not error if the project has no background set.
+ */
+async function removeProjectBackground(args, authManager) {
+    if (!args.id) {
+        throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'Project id is required for remove-background operation');
+    }
+    (0, validation_1.validateId)(args.id, 'id');
+    let project;
+    try {
+        project = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'DELETE', `/projects/${args.id}/background`);
+    }
+    catch (error) {
+        if (error instanceof types_1.MCPError) {
+            throw error;
+        }
+        throw (0, error_handler_1.transformApiError)(error, 'Failed to remove project background');
+    }
+    const response = (0, response_factory_1.createStandardResponse)('remove-background', `Background removed from project ${args.id}`, { project }, { timestamp: new Date().toISOString() }, args.sessionId);
+    return { content: [{ type: 'text', text: (0, response_factory_1.formatAorpAsMarkdown)(response) }] };
+}
+/**
+ * Sets an unsplash photo (by its unsplash photo id, from `search-unsplash`)
+ * as a project's background.
+ */
+async function setUnsplashBackground(args, authManager) {
+    if (!args.id) {
+        throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'Project id is required for set-unsplash-background operation');
+    }
+    (0, validation_1.validateId)(args.id, 'id');
+    if (!args.unsplashImageId || args.unsplashImageId.trim() === '') {
+        throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'unsplashImageId is required for set-unsplash-background operation');
+    }
+    const body = { id: args.unsplashImageId };
+    let project;
+    try {
+        project = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'POST', `/projects/${args.id}/backgrounds/unsplash`, body);
+    }
+    catch (error) {
+        wrapUnsplashError(error, 'Setting the unsplash background');
+    }
+    const response = (0, response_factory_1.createStandardResponse)('set-unsplash-background', `Project ${args.id} background set to unsplash photo ${args.unsplashImageId}`, { project, unsplashImageId: args.unsplashImageId }, { timestamp: new Date().toISOString() }, args.sessionId);
+    return { content: [{ type: 'text', text: (0, response_factory_1.formatAorpAsMarkdown)(response) }] };
+}
+/**
+ * Searches unsplash for candidate background photos. Only works when the
+ * connected Vikunja server has an Unsplash provider configured — see
+ * `wrapUnsplashError`.
+ */
+async function searchUnsplashBackgrounds(args, authManager) {
+    if (args.page !== undefined) {
+        (0, validation_1.validateId)(args.page, 'page');
+    }
+    const params = new URLSearchParams();
+    if (args.unsplashQuery !== undefined && args.unsplashQuery.trim() !== '') {
+        params.set('s', args.unsplashQuery);
+    }
+    if (args.page !== undefined) {
+        params.set('p', String(args.page));
+    }
+    const query = params.toString();
+    let photos;
+    try {
+        const result = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'GET', `/backgrounds/unsplash/search${query ? `?${query}` : ''}`);
+        photos = Array.isArray(result) ? result : [];
+    }
+    catch (error) {
+        wrapUnsplashError(error, 'Searching unsplash backgrounds');
+    }
+    const photoWord = photos.length === 1 ? 'photo' : 'photos';
+    const response = (0, response_factory_1.createStandardResponse)('search-unsplash', `Found ${photos.length} unsplash ${photoWord}`, { photos }, { timestamp: new Date().toISOString() }, args.sessionId);
+    return { content: [{ type: 'text', text: (0, response_factory_1.formatAorpAsMarkdown)(response) }] };
+}
+//# sourceMappingURL=backgrounds.js.map

package/dist/tools/projects/backgrounds.js.map

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

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

@@ -0,0 +1,147 @@
+/**
+ * Project Kanban bucket operations
+ *
+ * Implements `list-buckets`, `create-bucket`, `update-bucket`,
+ * `delete-bucket`, and `list-view-tasks` (per-view task listing in real
+ * Kanban card order). `list-buckets` lets callers resolve a bucket by name
+ * (e.g. "Doing") instead of hard-coding numeric bucket ids; `update-bucket`
+ * and `delete-bucket` extend that convenience by accepting a `bucketTitle`
+ * wherever a `bucketId` is otherwise required, resolved internally via a
+ * bucket list lookup — the same resolve-by-name-internally shape as
+ * `setTaskBucket` (`src/tools/tasks/buckets.ts`), Wave D's exemplar for
+ * "don't make the caller pre-fetch ids they shouldn't have to know"
+ * (docs/ENDPOINT-PLAYBOOK.md §1).
+ *
+ * legacy client does not expose the Kanban view endpoints, so this calls the
+ * Vikunja REST API directly via the shared `vikunja-rest` helper.
+ */
+import type { AuthManager } from '../../auth/AuthManager';
+export interface ListBucketsArgs {
+    /** Project whose Kanban buckets should be listed. */
+    id?: number;
+    /** Optional Kanban view id. Auto-resolved from the project when omitted. */
+    viewId?: number;
+    /** Session id for response tracking. */
+    sessionId?: string;
+}
+export interface CreateBucketArgs {
+    /** Project the new bucket should belong to. */
+    id?: number;
+    /** Optional Kanban view id. Auto-resolved from the project when omitted. */
+    viewId?: number;
+    /** Title of the new bucket. */
+    title?: string;
+    /** Optional max task count for the bucket (0 = unlimited). */
+    limit?: number;
+    /** Session id for response tracking. */
+    sessionId?: string;
+}
+/** Identifies an existing bucket by either its numeric id or its title. */
+interface BucketRef {
+    bucketId?: number;
+    bucketTitle?: string;
+}
+export interface UpdateBucketArgs extends BucketRef {
+    /** Project the bucket belongs to. */
+    id?: number;
+    /** Optional Kanban view id. Auto-resolved from the project when omitted. */
+    viewId?: number;
+    /** New title, if renaming. */
+    title?: string;
+    /** New max task count, if changing (0 = unlimited). */
+    limit?: number;
+    /** Session id for response tracking. */
+    sessionId?: string;
+}
+export interface DeleteBucketArgs extends BucketRef {
+    /** Project the bucket belongs to. */
+    id?: number;
+    /** Optional Kanban view id. Auto-resolved from the project when omitted. */
+    viewId?: number;
+    /** Session id for response tracking. */
+    sessionId?: string;
+}
+export interface ListViewTasksArgs {
+    /** Project whose view tasks should be listed. */
+    id?: number;
+    /** Optional view id. Auto-resolved to the Kanban view when omitted. */
+    viewId?: number;
+    /** Page number for pagination. */
+    page?: number;
+    /** Items per page. */
+    perPage?: number;
+    /** Session id for response tracking. */
+    sessionId?: string;
+}
+/**
+ * Lists the Kanban buckets of a project.
+ *
+ * @param args - Project id and optional view id
+ * @param authManager - Active auth manager holding session credentials
+ * @returns MCP response containing the project's Kanban buckets
+ */
+export declare function listBuckets(args: ListBucketsArgs, authManager: AuthManager): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+/**
+ * Creates a new Kanban bucket (column) on a project's Kanban view.
+ */
+export declare function createBucket(args: CreateBucketArgs, authManager: AuthManager): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+/**
+ * Updates an existing Kanban bucket. `POST
+ * /projects/{projectID}/views/{view}/buckets/{bucketID}` replaces the whole
+ * bucket resource, so the current bucket is fetched first (via the bucket
+ * list, which also resolves `bucketTitle` when `bucketId` is omitted) and
+ * merged with the requested changes.
+ */
+export declare function updateBucket(args: UpdateBucketArgs, authManager: AuthManager): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+/**
+ * Deletes a Kanban bucket. Does not delete the tasks in it — Vikunja
+ * dissociates them from the bucket instead.
+ */
+export declare function deleteBucket(args: DeleteBucketArgs, authManager: AuthManager): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+/**
+ * Lists the tasks of a project view in their real server-side order
+ * (`GET /projects/{id}/views/{view}/tasks`), with pagination.
+ *
+ * The view id is auto-resolved to the project's Kanban view when omitted,
+ * matching `list-buckets`'s resolution behavior — this endpoint is most
+ * useful for Kanban views, where it returns cards in actual board order
+ * (unlike the generic task-listing endpoints used by `vikunja_tasks list`).
+ *
+ * The OpenAPI spec declares this endpoint's response as a flat `Task[]` for
+ * every view kind, but Vikunja's own endpoint description says a Kanban
+ * view returns "a list of buckets containing the tasks" instead — i.e. the
+ * real Kanban response is bucket-shaped (each item carries a nested `tasks`
+ * array), not task-shaped. Since this can't be verified against a live
+ * server from spec text alone, the response is passed through unmodified so
+ * callers can inspect the actual shape (check for a `tasks` field on each
+ * item) rather than have it silently coerced into an assumption that may be
+ * wrong. See docs/API_NOTES.md "Per-view task listing".
+ */
+export declare function listViewTasks(args: ListViewTasksArgs, authManager: AuthManager): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+export {};
+//# sourceMappingURL=buckets.d.ts.map

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

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