@omnicoreos/planka-mcp 0.2.0 → 0.3.0

package/dist/tools/index.d.ts

@@ -1,3 +1,4 @@
+import { AccessPolicy } from "../config/policy.js";
 /**
  * All registered tools.
  */
@@ -11,10 +12,15 @@ export declare const allTools: ({
                 type: string;
                 description: string;
             };
+            withLists: {
+                type: string;
+                description: string;
+            };
         };
     };
     handler: (params: {
         projectId?: string;
+        withLists?: boolean;
     }) => Promise<{
         content: {
             type: "text";
@@ -36,12 +42,17 @@ export declare const allTools: ({
                 description: string;
                 default: boolean;
             };
+            limit: {
+                type: string;
+                description: string;
+            };
         };
         required: string[];
     };
     handler: (params: {
-        boardId: string;
+        boardId?: string;
         includeTaskCounts?: boolean;
+        limit?: number;
     }) => Promise<{
         content: {
             type: "text";
@@ -94,6 +105,56 @@ export declare const allTools: ({
         tasks?: string[];
         dueDate?: string;
         labelIds?: string[];
+    }) => Promise<{
+        isError?: true | undefined;
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    } | {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            cardId: {
+                type: string;
+                description: string;
+            };
+            detail: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            withComments: {
+                description: string;
+                anyOf: ({
+                    type: string;
+                    enum?: undefined;
+                } | {
+                    type: string;
+                    enum: string[];
+                })[];
+            };
+            descriptionChars: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    handler: (params: {
+        cardId: string;
+        detail?: "digest" | "full";
+        withComments?: number | "all";
+        descriptionChars?: number;
     }) => Promise<{
         content: {
             type: "text";
@@ -143,11 +204,11 @@ export declare const allTools: ({
         dueDate?: string | null;
         isCompleted?: boolean;
     }) => Promise<{
+        isError?: true | undefined;
         content: {
             type: "text";
             text: string;
         }[];
-        isError?: undefined;
     } | {
         content: {
             type: "text";
@@ -169,6 +230,10 @@ export declare const allTools: ({
                 type: string;
                 description: string;
             };
+            boardId: {
+                type: string;
+                description: string;
+            };
             position: {
                 type: string;
                 description: string;
@@ -179,13 +244,14 @@ export declare const allTools: ({
     handler: (params: {
         cardId: string;
         listId: string;
+        boardId?: string;
         position?: number;
     }) => Promise<{
+        isError?: true | undefined;
         content: {
             type: "text";
             text: string;
         }[];
-        isError?: undefined;
     } | {
         content: {
             type: "text";
@@ -218,11 +284,11 @@ export declare const allTools: ({
         cardId: string;
         tasks: string[];
     }) => Promise<{
+        isError?: true | undefined;
         content: {
             type: "text";
             text: string;
         }[];
-        isError?: undefined;
     } | {
         content: {
             type: "text";
@@ -240,6 +306,10 @@ export declare const allTools: ({
                 type: string;
                 description: string;
             };
+            cardId: {
+                type: string;
+                description: string;
+            };
             name: {
                 type: string;
                 description: string;
@@ -253,14 +323,15 @@ export declare const allTools: ({
     };
     handler: (params: {
         taskId: string;
+        cardId?: string;
         name?: string;
         isCompleted?: boolean;
     }) => Promise<{
+        isError?: true | undefined;
         content: {
             type: "text";
             text: string;
         }[];
-        isError?: undefined;
     } | {
         content: {
             type: "text";
@@ -278,17 +349,22 @@ export declare const allTools: ({
                 type: string;
                 description: string;
             };
+            cardId: {
+                type: string;
+                description: string;
+            };
         };
         required: string[];
     };
     handler: (params: {
         taskId: string;
+        cardId?: string;
     }) => Promise<{
+        isError?: true | undefined;
         content: {
             type: "text";
             text: string;
         }[];
-        isError?: undefined;
     } | {
         content: {
             type: "text";
@@ -296,6 +372,98 @@ export declare const allTools: ({
         }[];
         isError: boolean;
     }>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            boardId: {
+                type: string;
+                description: string;
+            };
+            name: {
+                type: string;
+                description: string;
+            };
+            color: {
+                type: string;
+                enum: readonly string[];
+                description: string;
+            };
+            position: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    handler: (params: {
+        boardId?: string;
+        name: string;
+        color: string;
+        position?: number;
+    }) => Promise<{
+        isError?: true | undefined;
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    } | import("./guard.js").ToolReply>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            labelId: {
+                type: string;
+                description: string;
+            };
+            name: {
+                type: string;
+                description: string;
+            };
+            color: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    handler: (params: {
+        labelId: string;
+        name?: string;
+        color?: string;
+    }) => Promise<{
+        isError?: true | undefined;
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    } | import("./guard.js").ToolReply>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            labelId: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    handler: (params: {
+        labelId: string;
+    }) => Promise<{
+        isError?: true | undefined;
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    } | import("./guard.js").ToolReply>;
 } | {
     name: string;
     description: string;
@@ -333,17 +501,17 @@ export declare const allTools: ({
         name?: string;
         color?: string;
     }) => Promise<{
-        content: {
-            type: "text";
-            text: string;
-        }[];
-        isError: boolean;
+        content: Array<{
+            type: string;
+            [key: string]: unknown;
+        }>;
+        isError?: boolean;
     } | {
         content: {
             type: "text";
             text: string;
         }[];
-        isError?: undefined;
+        isError: true;
     }>;
 } | {
     name: string;
@@ -385,17 +553,17 @@ export declare const allTools: ({
         labelIds?: string[];
         removeLabelIds?: string[];
     }) => Promise<{
+        isError?: true | undefined;
         content: {
             type: "text";
             text: string;
         }[];
-        isError: boolean;
     } | {
-        isError?: true | undefined;
         content: {
             type: "text";
             text: string;
         }[];
+        isError: boolean;
     }>;
 } | {
     name: string;
@@ -418,30 +586,19 @@ export declare const allTools: ({
         cardId: string;
         text: string;
     }) => Promise<{
+        isError?: true | undefined;
         content: {
             type: "text";
             text: string;
         }[];
-        isError?: undefined;
-    } | {
-        content: {
-            type: "text";
-            text: string;
-        }[];
-        isError: boolean;
-    }>;
+    } | import("./guard.js").ToolReply>;
 } | {
     name: string;
     description: string;
     inputSchema: {
         type: "object";
         properties: {
-            action: {
-                type: string;
-                enum: string[];
-                description: string;
-            };
-            commentId: {
+            cardId: {
                 type: string;
                 description: string;
             };
@@ -453,21 +610,20 @@ export declare const allTools: ({
         required: string[];
     };
     handler: (params: {
-        action: "update" | "delete";
-        commentId: string;
-        text?: string;
+        cardId: string;
+        text: string;
     }) => Promise<{
-        content: {
-            type: "text";
-            text: string;
-        }[];
-        isError: boolean;
+        content: Array<{
+            type: string;
+            [key: string]: unknown;
+        }>;
+        isError?: boolean;
     } | {
         content: {
             type: "text";
             text: string;
         }[];
-        isError?: undefined;
+        isError: true;
     }>;
 } | {
     name: string;
@@ -475,28 +631,23 @@ export declare const allTools: ({
     inputSchema: {
         type: "object";
         properties: {
-            action: {
-                type: string;
-                enum: string[];
-                description: string;
-            };
-            boardId: {
+            cardId: {
                 type: string;
                 description: string;
             };
-            listId: {
+            limit: {
                 type: string;
                 description: string;
             };
-            name: {
+            beforeId: {
                 type: string;
                 description: string;
             };
-            position: {
+            all: {
                 type: string;
                 description: string;
             };
-            type: {
+            order: {
                 type: string;
                 enum: string[];
                 description: string;
@@ -505,24 +656,23 @@ export declare const allTools: ({
         required: string[];
     };
     handler: (params: {
-        action: "create" | "update" | "delete";
-        boardId?: string;
-        listId?: string;
-        name?: string;
-        position?: number;
-        type?: "active" | "closed";
+        cardId: string;
+        limit?: number;
+        beforeId?: string;
+        all?: boolean;
+        order?: "asc" | "desc";
     }) => Promise<{
         content: {
             type: "text";
             text: string;
         }[];
-        isError: boolean;
+        isError?: undefined;
     } | {
         content: {
             type: "text";
             text: string;
         }[];
-        isError?: undefined;
+        isError: boolean;
     }>;
 } | {
     name: string;
@@ -530,15 +680,11 @@ export declare const allTools: ({
     inputSchema: {
         type: "object";
         properties: {
-            cardId: {
-                type: string;
-                description: string;
-            };
-            filePath: {
+            commentId: {
                 type: string;
                 description: string;
             };
-            name: {
+            text: {
                 type: string;
                 description: string;
             };
@@ -546,23 +692,22 @@ export declare const allTools: ({
         required: string[];
     };
     handler: (params: {
-        cardId: string;
-        filePath: string;
-        name?: string;
+        commentId: string;
+        text: string;
     }) => Promise<{
-        isError?: boolean | undefined;
+        isError?: true | undefined;
         content: {
             type: "text";
             text: string;
         }[];
-    }>;
+    } | import("./guard.js").ToolReply>;
 } | {
     name: string;
     description: string;
     inputSchema: {
         type: "object";
         properties: {
-            cardId: {
+            commentId: {
                 type: string;
                 description: string;
             };
@@ -570,30 +715,30 @@ export declare const allTools: ({
         required: string[];
     };
     handler: (params: {
-        cardId: string;
+        commentId: string;
     }) => Promise<{
+        isError?: true | undefined;
         content: {
             type: "text";
             text: string;
         }[];
-        isError: boolean;
-    } | {
-        content: {
-            type: "text";
-            text: string;
-        }[];
-    }>;
+    } | import("./guard.js").ToolReply>;
 } | {
     name: string;
     description: string;
     inputSchema: {
         type: "object";
         properties: {
-            cardId: {
+            action: {
                 type: string;
+                enum: string[];
                 description: string;
             };
-            attachmentId: {
+            commentId: {
+                type: string;
+                description: string;
+            };
+            text: {
                 type: string;
                 description: string;
             };
@@ -601,81 +746,190 @@ export declare const allTools: ({
         required: string[];
     };
     handler: (params: {
-        cardId: string;
-        attachmentId?: string;
+        action: "update" | "delete";
+        commentId: string;
+        text?: string;
     }) => Promise<{
+        content: Array<{
+            type: string;
+            [key: string]: unknown;
+        }>;
+        isError?: boolean;
+    } | {
         content: {
             type: "text";
             text: string;
         }[];
-        isError: boolean;
-    } | {
-        content: ({
+        isError: true;
+    }>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            boardId: {
+                type: string;
+                description: string;
+            };
+            name: {
+                type: string;
+                description: string;
+            };
+            position: {
+                type: string;
+                description: string;
+            };
+            type: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    handler: (params: {
+        boardId?: string;
+        name: string;
+        position?: number;
+        type?: "active" | "closed";
+    }) => Promise<{
+        isError?: true | undefined;
+        content: {
             type: "text";
             text: string;
-            data?: undefined;
-            mimeType?: undefined;
-        } | {
-            type: "image";
-            data: string;
-            mimeType: string;
-            text?: undefined;
-        })[];
-    }>;
+        }[];
+    } | import("./guard.js").ToolReply>;
 } | {
     name: string;
     description: string;
     inputSchema: {
         type: "object";
         properties: {
-            attachmentId: {
+            listId: {
+                type: string;
+                description: string;
+            };
+            name: {
+                type: string;
+                description: string;
+            };
+            position: {
                 type: string;
                 description: string;
             };
+            type: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
         };
         required: string[];
     };
     handler: (params: {
-        attachmentId: string;
+        listId: string;
+        name?: string;
+        position?: number;
+        type?: "active" | "closed";
     }) => Promise<{
+        isError?: true | undefined;
         content: {
             type: "text";
             text: string;
         }[];
-        isError: boolean;
-    } | {
+    } | import("./guard.js").ToolReply>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            listId: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    handler: (params: {
+        listId: string;
+    }) => Promise<{
+        isError?: true | undefined;
         content: {
             type: "text";
             text: string;
         }[];
-    }>;
+    } | import("./guard.js").ToolReply>;
 } | {
     name: string;
     description: string;
     inputSchema: {
         type: "object";
         properties: {
+            action: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            boardId: {
+                type: string;
+                description: string;
+            };
             listId: {
                 type: string;
                 description: string;
             };
-            withLabels: {
+            name: {
                 type: string;
                 description: string;
             };
-            withDescription: {
+            position: {
                 type: string;
                 description: string;
             };
-            labelFilter: {
+            type: {
                 type: string;
+                enum: string[];
                 description: string;
             };
-            limit: {
+        };
+        required: string[];
+    };
+    handler: (params: {
+        action: "create" | "update" | "delete";
+        boardId?: string;
+        listId?: string;
+        name?: string;
+        position?: number;
+        type?: "active" | "closed";
+    }) => Promise<{
+        content: Array<{
+            type: string;
+            [key: string]: unknown;
+        }>;
+        isError?: boolean;
+    } | {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError: true;
+    }>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            cardId: {
+                type: string;
+                description: string;
+            };
+            filePath: {
                 type: string;
                 description: string;
             };
-            offset: {
+            name: {
                 type: string;
                 description: string;
             };
@@ -683,13 +937,11 @@ export declare const allTools: ({
         required: string[];
     };
     handler: (params: {
-        listId: string;
-        withLabels?: boolean;
-        withDescription?: boolean;
-        labelFilter?: string;
-        limit?: number;
-        offset?: number;
+        cardId: string;
+        filePath: string;
+        name?: string;
     }) => Promise<{
+        isError?: true | undefined;
         content: {
             type: "text";
             text: string;
@@ -707,7 +959,7 @@ export declare const allTools: ({
     inputSchema: {
         type: "object";
         properties: {
-            boardId: {
+            cardId: {
                 type: string;
                 description: string;
             };
@@ -715,18 +967,18 @@ export declare const allTools: ({
         required: string[];
     };
     handler: (params: {
-        boardId: string;
+        cardId: string;
     }) => Promise<{
         content: {
             type: "text";
             text: string;
         }[];
+        isError: boolean;
     } | {
         content: {
             type: "text";
             text: string;
         }[];
-        isError: boolean;
     }>;
 } | {
     name: string;
@@ -734,22 +986,50 @@ export declare const allTools: ({
     inputSchema: {
         type: "object";
         properties: {
-            boardId: {
+            cardId: {
                 type: string;
                 description: string;
             };
-            cardsFrom: {
+            attachmentId: {
                 type: string;
-                items: {
-                    type: string;
-                };
                 description: string;
             };
-            highlightLabel: {
+        };
+        required: string[];
+    };
+    handler: (params: {
+        cardId: string;
+        attachmentId?: string;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError: boolean;
+    } | {
+        content: ({
+            type: "text";
+            text: string;
+            data?: undefined;
+            mimeType?: undefined;
+        } | {
+            type: "image";
+            data: string;
+            mimeType: string;
+            text?: undefined;
+        })[];
+    }>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            attachmentId: {
                 type: string;
                 description: string;
             };
-            limit: {
+            cardId: {
                 type: string;
                 description: string;
             };
@@ -757,11 +1037,10 @@ export declare const allTools: ({
         required: string[];
     };
     handler: (params: {
-        boardId: string;
-        cardsFrom?: string[];
-        highlightLabel?: string;
-        limit?: number;
+        attachmentId: string;
+        cardId?: string;
     }) => Promise<{
+        isError?: true | undefined;
         content: {
             type: "text";
             text: string;
@@ -779,46 +1058,104 @@ export declare const allTools: ({
     inputSchema: {
         type: "object";
         properties: {
-            boardId: {
-                type: string;
-                description: string;
+            readonly boardId: {
+                readonly type: "string";
+                readonly description: "Board ID. Optional with PLANKA_DEFAULT_BOARD_ID; ignored when listId is given.";
+            };
+            readonly listId: {
+                readonly type: "string";
+                readonly description: "Read exactly this column. THE CHEAP PATH: one request, no pagination, so total is the real size of the column and truncated is false by construction.";
+            };
+            readonly listName: {
+                readonly type: "string";
+                readonly description: "Column name fragment (case- and accent-insensitive) instead of an ID. Costs a board read; listId is cheaper.";
+            };
+            readonly query: {
+                readonly type: "string";
+                readonly description: "Free text matched against card name AND description. Several words are ANDed — all must appear — ignoring case and accents. A leading '/' makes the rest a case-insensitive regular expression.";
+            };
+            readonly labelName: {
+                readonly type: "string";
+                readonly description: "Only cards carrying this label name (exact name, case- and accent-insensitive). If the board has no such label, the response says so and lists the ones it does have.";
+            };
+            readonly labelIds: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Only cards carrying at least one of these label IDs (OR).";
             };
-            labelName: {
-                type: string;
-                description: string;
+            readonly userIds: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Only cards where one of these users is a member or a task assignee (OR).";
             };
-            query: {
-                type: string;
-                description: string;
+            readonly withLabels: {
+                readonly type: "boolean";
+                readonly description: "Resolve label names. Default true; false skips one board read on the listId path.";
             };
-            listId: {
+            readonly detail: {
+                readonly type: "string";
+                readonly enum: readonly ["digest", "full"];
+                readonly description: "digest (default): id, name, labels, members, tasks, dueDate, commentsTotal, updatedAt. full: every field of the card, description included.";
+            };
+            readonly descriptionChars: {
+                readonly type: "number";
+                readonly description: "Per-match description preview, in characters. 0 (the default) leaves descriptions out.";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Max matches to return. Default 25, max 200.";
+            };
+            readonly offset: {
+                readonly type: "number";
+                readonly description: "Skip this many matches. Use nextOffset from the previous response.";
+            };
+        };
+    };
+    handler: (params: import("./queries.js").FindCardsParams) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    } | {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            boardId: {
                 type: string;
                 description: string;
             };
-            withDescription: {
+            cardsFrom: {
                 type: string;
+                items: {
+                    type: string;
+                };
                 description: string;
             };
-            limit: {
+            highlightLabel: {
                 type: string;
                 description: string;
             };
-            offset: {
+            limit: {
                 type: string;
                 description: string;
             };
         };
         required: string[];
     };
-    handler: (params: {
-        boardId: string;
-        labelName?: string;
-        query?: string;
-        listId?: string;
-        withDescription?: boolean;
-        limit?: number;
-        offset?: number;
-    }) => Promise<{
+    handler: (params: import("./queries.js").BoardSummaryParams) => Promise<{
         content: {
             type: "text";
             text: string;
@@ -830,457 +1167,411 @@ export declare const allTools: ({
         }[];
         isError: boolean;
     }>;
-})[];
-/**
- * Content blocks a tool may return.
- * "image" lets the model actually SEE an attached screenshot (base64).
- */
-export type ToolContent = {
-    type: "text";
-    text: string;
 } | {
-    type: "image";
-    data: string;
-    mimeType: string;
-};
-/**
- * Tool type definition.
- */
-export interface Tool {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: Record<string, unknown>;
-        required?: string[];
-    };
-    handler: (params: unknown) => Promise<{
-        content: ToolContent[];
-        isError?: boolean;
-    }>;
-}
-/**
- * Get a tool by name.
- */
-export declare function getTool(name: string): Tool | undefined;
-/**
- * Required inputSchema fields that never arrived.
- *
- * The inputSchema is JSON Schema, not Zod: this only checks presence, which is
- * what stops a missing `tasks` from blowing up inside the handler as "Cannot
- * read properties of undefined (reading 'map')".
- */
-export declare function findMissingRequiredArgs(tool: Tool, args: unknown): string[];
-/**
- * Get all tool definitions (for MCP listTools).
- */
-export declare function getToolDefinitions(): {
     name: string;
     description: string;
     inputSchema: {
-        type: "object";
-        properties: {
-            projectId: {
-                type: string;
-                description: string;
-            };
-        };
-    } | {
         type: "object";
         properties: {
             boardId: {
                 type: string;
                 description: string;
             };
-            includeTaskCounts: {
-                type: string;
-                description: string;
-                default: boolean;
-            };
-        };
-        required: string[];
-    } | {
-        type: "object";
-        properties: {
-            listId: {
-                type: string;
-                description: string;
-            };
-            name: {
-                type: string;
-                description: string;
-            };
-            description: {
-                type: string;
-                description: string;
-            };
-            tasks: {
-                type: string;
-                items: {
-                    type: string;
-                };
-                description: string;
-            };
-            dueDate: {
-                type: string;
-                description: string;
-            };
-            labelIds: {
-                type: string;
-                items: {
-                    type: string;
-                };
-                description: string;
-            };
         };
         required: string[];
+    };
+    handler: (params: {
+        boardId?: string;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
     } | {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
         type: "object";
         properties: {
             cardId: {
                 type: string;
                 description: string;
             };
-            name: {
+            limit: {
                 type: string;
                 description: string;
             };
-            description: {
-                type: string[];
-                description: string;
-            };
-            dueDate: {
-                type: string[];
-                description: string;
-            };
-            isCompleted: {
+            beforeId: {
                 type: string;
                 description: string;
             };
         };
         required: string[];
-    } | {
+    };
+    handler: (params: {
+        cardId: string;
+        limit?: number;
+        beforeId?: string;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
         type: "object";
         properties: {
-            cardId: {
-                type: string;
-                description: string;
-            };
-            listId: {
+            boardId: {
                 type: string;
                 description: string;
             };
-            position: {
+            since: {
                 type: string;
                 description: string;
             };
-        };
-        required: string[];
-    } | {
-        type: "object";
-        properties: {
-            cardId: {
+            limit: {
                 type: string;
                 description: string;
             };
-            tasks: {
+            types: {
                 type: string;
                 items: {
                     type: string;
+                    enum: ("createCard" | "moveCard" | "addMemberToCard" | "removeMemberFromCard" | "completeTask" | "uncompleteTask")[];
                 };
-                minItems: number;
-                description: string;
-            };
-        };
-        required: string[];
-    } | {
-        type: "object";
-        properties: {
-            taskId: {
-                type: string;
-                description: string;
-            };
-            name: {
-                type: string;
-                description: string;
-            };
-            isCompleted: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
-    } | {
-        type: "object";
-        properties: {
-            taskId: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
-    } | {
-        type: "object";
-        properties: {
-            action: {
-                type: string;
-                enum: string[];
-                description: string;
-            };
-            boardId: {
-                type: string;
-                description: string;
-            };
-            labelId: {
-                type: string;
-                description: string;
-            };
-            name: {
-                type: string;
-                description: string;
-            };
-            color: {
-                type: string;
                 description: string;
             };
         };
-        required: string[];
-    } | {
+    };
+    handler: (params: {
+        boardId?: string;
+        since?: string;
+        limit?: number;
+        types?: string[];
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
         type: "object";
         properties: {
             cardId: {
                 type: string;
                 description: string;
             };
-            addLabelIds: {
+            add: {
                 type: string;
                 items: {
                     type: string;
                 };
                 description: string;
             };
-            labelIds: {
+            remove: {
                 type: string;
                 items: {
                     type: string;
                 };
                 description: string;
             };
-            removeLabelIds: {
+            addUserNames: {
                 type: string;
                 items: {
                     type: string;
                 };
                 description: string;
             };
-        };
-        required: string[];
-    } | {
-        type: "object";
-        properties: {
-            cardId: {
-                type: string;
-                description: string;
-            };
-            text: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
-    } | {
-        type: "object";
-        properties: {
-            action: {
-                type: string;
-                enum: string[];
-                description: string;
-            };
-            commentId: {
+            removeUserNames: {
                 type: string;
+                items: {
+                    type: string;
+                };
                 description: string;
             };
-            text: {
+            boardId: {
                 type: string;
                 description: string;
             };
         };
         required: string[];
-    } | {
+    };
+    handler: (params: {
+        cardId: string;
+        add?: string[];
+        remove?: string[];
+        addUserNames?: string[];
+        removeUserNames?: string[];
+        boardId?: string;
+    }) => Promise<{
+        isError?: true | undefined;
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
         type: "object";
         properties: {
-            action: {
-                type: string;
-                enum: string[];
-                description: string;
-            };
             boardId: {
                 type: string;
                 description: string;
             };
-            listId: {
-                type: string;
-                description: string;
-            };
-            name: {
-                type: string;
-                description: string;
-            };
-            position: {
-                type: string;
-                description: string;
-            };
-            type: {
+            detail: {
                 type: string;
                 enum: string[];
                 description: string;
             };
         };
-        required: string[];
-    } | {
-        type: "object";
-        properties: {
-            cardId: {
-                type: string;
-                description: string;
-            };
-            filePath: {
-                type: string;
-                description: string;
-            };
-            name: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
+    };
+    handler: (params: {
+        boardId?: string;
+        detail?: "digest" | "full";
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError: true;
     } | {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
         type: "object";
         properties: {
-            cardId: {
+            boardId: {
                 type: string;
                 description: string;
             };
         };
-        required: string[];
+    };
+    handler: (params?: {
+        boardId?: string;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError: true;
     } | {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
         type: "object";
         properties: {
             cardId: {
                 type: string;
                 description: string;
             };
-            attachmentId: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
-    } | {
-        type: "object";
-        properties: {
-            attachmentId: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
-    } | {
-        type: "object";
-        properties: {
             listId: {
                 type: string;
                 description: string;
             };
-            withLabels: {
-                type: string;
-                description: string;
-            };
-            withDescription: {
-                type: string;
-                description: string;
-            };
-            labelFilter: {
-                type: string;
-                description: string;
-            };
-            limit: {
+            boardId: {
                 type: string;
                 description: string;
             };
-            offset: {
+            name: {
                 type: string;
                 description: string;
             };
-        };
-        required: string[];
-    } | {
-        type: "object";
-        properties: {
-            boardId: {
+            position: {
                 type: string;
                 description: string;
             };
         };
         required: string[];
-    } | {
+    };
+    handler: (params: {
+        cardId: string;
+        listId?: string;
+        boardId?: string;
+        name?: string;
+        position?: number;
+    }) => Promise<{
+        isError?: true | undefined;
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
         type: "object";
         properties: {
-            boardId: {
-                type: string;
-                description: string;
-            };
-            cardsFrom: {
+            cardId: {
                 type: string;
-                items: {
-                    type: string;
-                };
                 description: string;
             };
-            highlightLabel: {
+            restoreToListId: {
                 type: string;
                 description: string;
             };
-            limit: {
+            position: {
                 type: string;
                 description: string;
             };
         };
         required: string[];
-    } | {
+    };
+    handler: (params: {
+        cardId: string;
+        restoreToListId?: string;
+        position?: number;
+    }) => Promise<{
+        isError?: true | undefined;
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
         type: "object";
         properties: {
-            boardId: {
-                type: string;
-                description: string;
-            };
-            labelName: {
+            fromListId: {
                 type: string;
                 description: string;
             };
-            query: {
+            toListId: {
                 type: string;
                 description: string;
             };
-            listId: {
-                type: string;
-                description: string;
-            };
-            withDescription: {
-                type: string;
-                description: string;
-            };
-            limit: {
-                type: string;
-                description: string;
-            };
-            offset: {
+            boardId: {
                 type: string;
                 description: string;
             };
         };
         required: string[];
     };
+    handler: (params: {
+        fromListId: string;
+        toListId: string;
+        boardId?: string;
+    }) => Promise<{
+        isError?: true | undefined;
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+})[];
+/**
+ * Content blocks a tool may return.
+ * "image" lets the model actually SEE an attached screenshot (base64).
+ */
+export type ToolContent = {
+    type: "text";
+    text: string;
+} | {
+    type: "image";
+    data: string;
+    mimeType: string;
+};
+/**
+ * Tool type definition.
+ */
+export interface Tool {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+    handler: (params: unknown) => Promise<{
+        content: ToolContent[];
+        isError?: boolean;
+    }>;
+}
+/**
+ * Get a tool by name.
+ *
+ * Returns a refusing stub for tools disabled by PLANKA_READ_ONLY or
+ * PLANKA_DISABLED_TOOLS, and undefined only for names that do not exist.
+ */
+export declare function getTool(name: string, policy?: AccessPolicy): Tool | undefined;
+/**
+ * Required inputSchema fields that never arrived.
+ *
+ * With one tool per action (create/update/delete instead of a `manage_*` enum)
+ * `required` is finally expressive enough for this generic check to carry the
+ * weight the hand-written guards used to.
+ *
+ * Checked against `effectiveInputSchema`, never the raw registry schema: what
+ * the deployment ANNOUNCED is what the call is judged by. Doing it the other
+ * way is how `PLANKA_DEFAULT_BOARD_ID` used to reject `planka_board_summary {}`
+ * while its own tools/list entry said `boardId` was optional.
+ */
+export declare function findMissingRequiredArgs(tool: Tool, args: unknown, policy?: AccessPolicy): string[];
+/**
+ * Tools kept only so callers written against the old names keep working.
+ *
+ * Each one routes to the create_/update_/delete_ tool that replaced it and adds
+ * nothing else. They are still callable when hidden — a model working from a
+ * cached tools/list must get the real behaviour, not "unknown tool".
+ *
+ * `PLANKA_HIDE_DEPRECATED=true` drops them from tools/list, which is worth a
+ * few hundred characters of context per session on a deployment that has
+ * already migrated.
+ */
+export declare const DEPRECATED_TOOL_NAMES: ReadonlySet<string>;
+/**
+ * The schema a tool is actually published — and judged — with.
+ *
+ * The single source of truth for both sides of the contract: `tools/list`
+ * advertises this, and the runtime presence check validates against this.
+ */
+export declare function effectiveInputSchema(tool: {
+    inputSchema: Tool["inputSchema"];
+}, policy?: AccessPolicy): Tool["inputSchema"];
+/**
+ * Get all tool definitions (for MCP listTools), after the access policy:
+ * read-only and disabled tools are not advertised at all.
+ */
+export declare function getToolDefinitions(policy?: AccessPolicy): {
+    _meta?: Record<string, unknown> | undefined;
+    annotations?: import("./annotations.js").ToolBehaviourHints | undefined;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+    title?: string | undefined;
+    name: string;
 }[];
 export { navigationTools } from "./navigation.js";
 export { cardTools } from "./cards.js";
@@ -1290,4 +1581,11 @@ export { commentTools } from "./comments.js";
 export { listTools } from "./lists.js";
 export { attachmentTools } from "./attachments.js";
 export { queryTools } from "./queries.js";
+export { activityTools } from "./activity.js";
+export { memberTools } from "./members.js";
+export { userTools } from "./users.js";
+export { cardOpsTools } from "./card-ops.js";
+export { missingRequiredArgs } from "./dispatch.js";
+export { toolPresentation, TOOLS_REQUIRING_USER_INTERACTION, } from "./annotations.js";
+export type { ToolBehaviourHints, ToolPresentation } from "./annotations.js";
 //# sourceMappingURL=index.d.ts.map