@opvs-ai/mcp 0.5.2 → 0.5.4

package/dist/index.js

@@ -17,20 +17,17 @@
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { createClient, buildUrl, getResponseText, listWorkspaces, apiUnauthPost, apiUnauthGet, saveWorkspace, setCurrentWorkspace, DEFAULT_WORKSPACE, } from "@opvs-ai/core";
-// ── Helpers ──────────────────────────────────────────────────────
-function ok(text) {
-    return { content: [{ type: "text", text }] };
-}
-function err(msg) {
-    return {
-        content: [{ type: "text", text: `Error: ${msg}` }],
-        isError: true,
-    };
-}
-function resolveWorkspace(args) {
-    return args.workspace || process.env.OPVS_WORKSPACE || undefined;
-}
+import { createClient, buildUrl, getResponseText } from "@opvs-ai/core";
+// ── Handler modules ─────────────────────────────────────────────
+import { TOOLS as BOARD_TOOLS, handleTool as handleBoard } from "./handlers/board.js";
+import { TOOLS as AGENT_TOOLS, handleTool as handleAgent } from "./handlers/agent.js";
+import { TOOLS as DOCS_TOOLS, handleTool as handleDocs } from "./handlers/docs.js";
+import { TOOLS as VIEWS_TOOLS, handleTool as handleViews } from "./handlers/views.js";
+import { TOOLS as STAGES_TOOLS, handleTool as handleStages } from "./handlers/stages.js";
+import { TOOLS as AUTH_TOOLS, handleTool as handleAuth } from "./handlers/auth.js";
+import { GENERATED_TOOLS, handleGeneratedTool } from "./generated-tools.js";
+import { err } from "./handlers/types.js";
+// ── API client ──────────────────────────────────────────────────
 async function callApi(method, path, wsSlug, body) {
     const client = createClient(wsSlug);
     let res;
@@ -53,1477 +50,35 @@ async function callApi(method, path, wsSlug, body) {
     }
     return getResponseText(res);
 }
-function getFormat() {
-    // MCP always uses JSON — YAML is for CLI display only.
-    // Claude Desktop and other MCP clients expect structured JSON responses.
-    return "json";
+function ok(text) {
+    return { content: [{ type: "text", text }] };
 }
-// ── Shared workspace property (added to every tool) ─────────────
-const WORKSPACE_PROP = {
-    workspace: {
-        type: "string",
-        description: "Workspace slug to use. If omitted, uses the current workspace. Use list_workspaces to see available workspaces.",
-    },
-};
-// ── Tool Definitions ─────────────────────────────────────────────
+// ── Tool registry ───────────────────────────────────────────────
 const TOOLS = [
-    // ── Workspace & Auth ──
-    {
-        name: "list_workspaces",
-        description: "List all configured workspaces with their brand names and API URLs. Call this first if you're unsure which workspace to use.",
-        inputSchema: {
-            type: "object",
-            properties: {},
-        },
-    },
-    {
-        name: "get_auth_status",
-        description: "Check who you are authenticated as — returns your user ID, email, brand, and permission scopes. Useful to verify access before other operations.",
-        inputSchema: {
-            type: "object",
-            properties: { ...WORKSPACE_PROP },
-        },
-    },
-    // ── Boards ──
-    {
-        name: "list_boards",
-        description: "List all boards in your workspace. Returns board IDs, names, task counts, and column counts.",
-        inputSchema: {
-            type: "object",
-            properties: { ...WORKSPACE_PROP },
-        },
-    },
-    {
-        name: "get_board",
-        description: "Get board details including all columns with their IDs and names. Use this to discover column IDs for move_task or create_task.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                board_id: { type: "string", description: "Board UUID" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["board_id"],
-        },
-    },
-    {
-        name: "create_board",
-        description: "Create a new board. Default columns: Backlog, To Do, In Progress, Review, Done. Visibility: 'public' (default) or 'private'.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                name: { type: "string", description: "Board name" },
-                description: { type: "string", description: "Board description" },
-                visibility: { type: "string", description: "public or private (default: public)" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["name"],
-        },
-    },
-    {
-        name: "update_board",
-        description: "Update a board's name, description, or visibility. Provide only the fields you want to change.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                board_id: { type: "string", description: "Board UUID" },
-                name: { type: "string", description: "New name" },
-                description: { type: "string", description: "New description" },
-                visibility: { type: "string", description: "public or private" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["board_id"],
-        },
-    },
-    {
-        name: "delete_board",
-        description: "Delete a board (soft delete — can be recovered by an admin).",
-        inputSchema: {
-            type: "object",
-            properties: {
-                board_id: { type: "string", description: "Board UUID" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["board_id"],
-        },
-    },
-    // ── Tasks ──
-    {
-        name: "list_tasks",
-        description: "List tasks on a board or assigned to you. Use self=true to find your assigned work across all boards (recommended starting point). Filter by status (pending, assigned, in_progress, review, done, failed) or priority (low, medium, high, critical).",
-        inputSchema: {
-            type: "object",
-            properties: {
-                board_id: {
-                    type: "string",
-                    description: "Board UUID (required unless self=true)",
-                },
-                self: {
-                    type: "boolean",
-                    description: "If true, list only tasks assigned to you across all boards",
-                },
-                status: {
-                    type: "string",
-                    description: "Filter: pending, assigned, in_progress, review, done, failed",
-                },
-                priority: {
-                    type: "string",
-                    description: "Filter: low, medium, high, critical",
-                },
-                limit: { type: "number", description: "Max results (default 25)" },
-                ...WORKSPACE_PROP,
-            },
-        },
-    },
-    {
-        name: "get_task",
-        description: "Get full details of a single task including description, agent instructions, comments, assignees, labels, and metadata.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                task_id: { type: "string", description: "Task UUID" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["task_id"],
-        },
-    },
-    {
-        name: "create_task",
-        description: "Create a new task on a board. Use assigned_to_agent_id='self' to assign to yourself. column_id accepts a UUID or column name (e.g. 'In Progress'). If column_id is omitted, the task goes to the first column. Priority: low, medium (default), high, critical.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                board_id: { type: "string", description: "Board UUID" },
-                title: { type: "string", description: "Task title" },
-                description: {
-                    type: "string",
-                    description: "Task description (markdown). Supports full PRDs, plans, and specs — no length limit.",
-                },
-                priority: {
-                    type: "string",
-                    description: "low, medium, high, critical (default: medium)",
-                },
-                column_id: { type: "string", description: "Column UUID or name (e.g. 'In Progress'). Defaults to first column." },
-                labels: {
-                    type: "array",
-                    items: { type: "string" },
-                    description: "Task labels/tags",
-                },
-                due_date: { type: "string", description: "Due date (YYYY-MM-DD)" },
-                agent_instructions: { type: "string", description: "Detailed instructions for the assigned agent" },
-                assigned_to_agent_id: { type: "string", description: "Agent UUID to assign to, or 'self' to assign to yourself" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["board_id", "title"],
-        },
-    },
-    {
-        name: "update_task",
-        description: "Update a task's fields. Status flow: pending → assigned → in_progress → review → done (or failed). Use assigned_to_agent_id='self' to assign to yourself. Provide only the fields you want to change.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                task_id: { type: "string", description: "Task UUID" },
-                status: {
-                    type: "string",
-                    description: "New status: pending, assigned, in_progress, review, done, failed",
-                },
-                priority: {
-                    type: "string",
-                    description: "New priority: low, medium, high, critical",
-                },
-                title: { type: "string", description: "New title" },
-                description: { type: "string", description: "New description (markdown)" },
-                result: { type: "string", description: "Agent result summary — set this when completing work" },
-                labels: {
-                    type: "array",
-                    items: { type: "string" },
-                    description: "New labels (replaces existing)",
-                },
-                due_date: { type: "string", description: "Due date (YYYY-MM-DD)" },
-                assigned_to_agent_id: { type: "string", description: "Agent UUID to assign to, or 'self' to assign to yourself" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["task_id"],
-        },
-    },
-    {
-        name: "delete_task",
-        description: "Delete a task (soft delete — can be recovered by an admin).",
-        inputSchema: {
-            type: "object",
-            properties: {
-                task_id: { type: "string", description: "Task UUID" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["task_id"],
-        },
-    },
-    {
-        name: "move_task",
-        description: "Move a task to a different column. column_id accepts a UUID or column name (e.g. 'Done', 'In Progress'). Use get_board or list_columns to see available columns and their names.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                task_id: { type: "string", description: "Task UUID" },
-                column_id: { type: "string", description: "Target column UUID or name (e.g. 'Done')" },
-                position: { type: "number", description: "Position within column (0 = top, optional)" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["task_id", "column_id"],
-        },
-    },
-    {
-        name: "list_subtasks",
-        description: "List subtasks of a parent task. Returns child tasks with their status and priority.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                task_id: { type: "string", description: "Parent task UUID" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["task_id"],
-        },
-    },
-    // ── Comments ──
-    {
-        name: "add_comment",
-        description: "Add a comment to a task. Use for progress updates, notes, questions, or deliverables. Supports markdown formatting.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                task_id: { type: "string", description: "Task UUID" },
-                content: {
-                    type: "string",
-                    description: "Comment text (markdown supported)",
-                },
-                ...WORKSPACE_PROP,
-            },
-            required: ["task_id", "content"],
-        },
-    },
-    {
-        name: "list_comments",
-        description: "List comments on a task, ordered newest first. Returns comment content, author, and timestamps.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                task_id: { type: "string", description: "Task UUID" },
-                limit: { type: "number", description: "Max results (default 25)" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["task_id"],
-        },
-    },
-    // ── Views (agent-optimized) ──
-    {
-        name: "get_board_session",
-        description: "RECOMMENDED FIRST CALL when starting work on a board. Returns everything in one call: board info, all columns with their UUIDs and names (needed for move_task), and your assigned tasks. Much more efficient than calling get_board + list_tasks separately.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                board_id: { type: "string", description: "Board UUID" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["board_id"],
-        },
-    },
-    {
-        name: "get_board_overview",
-        description: "Get board overview with column structure, task counts per column, and board metadata. Lighter than get_board_session (no task details).",
-        inputSchema: {
-            type: "object",
-            properties: {
-                board_id: { type: "string", description: "Board UUID" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["board_id"],
-        },
-    },
-    // ── Session ──
-    {
-        name: "get_session",
-        description: "Get your assigned tasks across all boards. Use this to find what you should work on. For a specific board's full context (columns, tasks), use get_board_session instead.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                board_id: {
-                    type: "string",
-                    description: "Optional: scope to a specific board",
-                },
-                ...WORKSPACE_PROP,
-            },
-        },
-    },
-    // ── Activity ──
-    {
-        name: "list_activity",
-        description: "Get recent activity feed (who did what, when). Provide exactly ONE of board_id or task_id. Shows task creation, status changes, comments, assignments, and moves. Ordered newest first.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                board_id: { type: "string", description: "Board UUID — activity for the whole board" },
-                task_id: { type: "string", description: "Task UUID — activity for a single task" },
-                limit: { type: "number", description: "Max results (default 25)" },
-                ...WORKSPACE_PROP,
-            },
-        },
-    },
-    // ── Metrics ──
-    {
-        name: "get_board_summary",
-        description: "Get board KPIs: task counts by status, workload by assignee, priority distribution, and recent activity stats. Useful for reporting and understanding board health.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                board_id: { type: "string", description: "Board UUID" },
-                days: { type: "number", description: "Time window in days (default 7)" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["board_id"],
-        },
-    },
-    {
-        name: "get_task_velocity",
-        description: "Get task velocity: tasks created vs completed per day over time. Useful for tracking team throughput and trends.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                days: { type: "number", description: "Time window in days (default 30)" },
-                ...WORKSPACE_PROP,
-            },
-        },
-    },
-    // ── Columns ──
-    {
-        name: "list_columns",
-        description: "List all columns on a board with their IDs, names, and positions. Use this to find column IDs needed by move_task and create_task (or just pass column names directly).",
-        inputSchema: {
-            type: "object",
-            properties: {
-                board_id: { type: "string", description: "Board UUID" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["board_id"],
-        },
-    },
-    {
-        name: "create_column",
-        description: "Create a new column on a board. New column is added at the end. Use reorder_columns to change position.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                board_id: { type: "string", description: "Board UUID" },
-                name: { type: "string", description: "Column name (e.g. 'In Review', 'Blocked')" },
-                color: { type: "string", description: "Column color hex (e.g. '#3B82F6')" },
-                wip_limit: { type: "number", description: "Max tasks allowed in this column" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["board_id", "name"],
-        },
-    },
-    {
-        name: "reorder_columns",
-        description: "Set the order of columns on a board. Pass ALL column UUIDs in the desired order — any omitted columns will be removed.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                board_id: { type: "string", description: "Board UUID" },
-                column_ids: {
-                    type: "array",
-                    items: { type: "string" },
-                    description: "ALL column UUIDs in desired left-to-right order",
-                },
-                ...WORKSPACE_PROP,
-            },
-            required: ["board_id", "column_ids"],
-        },
-    },
-    // ── Files ──
-    {
-        name: "list_files",
-        description: "List file attachments on a task. Returns file names, sizes, types, and IDs. Use get_file for download URLs.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                task_id: { type: "string", description: "Task UUID" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["task_id"],
-        },
-    },
-    {
-        name: "get_file",
-        description: "Get file metadata including name, size, MIME type, and download URL. Note: file upload is only available via the CLI (opvs files upload).",
-        inputSchema: {
-            type: "object",
-            properties: {
-                file_id: { type: "string", description: "File UUID" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["file_id"],
-        },
-    },
-    // ── Docs ──
-    {
-        name: "list_docs",
-        description: "List all AgentDocs documentation projects in your workspace. Returns project names, slugs, and page counts.",
-        inputSchema: {
-            type: "object",
-            properties: { ...WORKSPACE_PROP },
-        },
-    },
-    {
-        name: "get_doc",
-        description: "Get a documentation page by project and slug. The project parameter accepts a slug (e.g. 'platform-core-docs') or UUID.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                project: { type: "string", description: "Project slug or UUID (e.g. 'platform-core-docs')" },
-                slug: { type: "string", description: "Page slug" },
-                version: { type: "number", description: "Specific version number (optional, defaults to latest)" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["project", "slug"],
-        },
-    },
-    {
-        name: "create_doc",
-        description: "Create a new documentation page in a project. Content supports full markdown. Each page has a unique slug within its project.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                project: { type: "string", description: "Project slug or UUID" },
-                title: { type: "string", description: "Page title" },
-                slug: { type: "string", description: "Page slug (URL-friendly, must be unique in project)" },
-                content: { type: "string", description: "Page content (markdown)" },
-                message: { type: "string", description: "Commit message (default: 'Created via MCP')" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["project", "title", "slug"],
-        },
-    },
-    {
-        name: "update_doc",
-        description: "Update a documentation page's content. Creates a new version — previous versions are preserved and accessible by version number.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                project: { type: "string", description: "Project slug or UUID" },
-                slug: { type: "string", description: "Page slug" },
-                content: { type: "string", description: "New content (markdown)" },
-                title: { type: "string", description: "New title (optional)" },
-                message: { type: "string", description: "Commit message (default: 'Updated via MCP')" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["project", "slug", "content"],
-        },
-    },
-    {
-        name: "search_docs",
-        description: "Full-text search across documentation. Searches page titles and content. Optionally scope to a single project.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                query: { type: "string", description: "Search query (searches titles and content)" },
-                project: { type: "string", description: "Project slug or UUID to scope search (optional)" },
-                limit: { type: "number", description: "Max results (default 10)" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["query"],
-        },
-    },
-    // ── Docs: Project CRUD ──
-    {
-        name: "create_project",
-        description: "Create a new documentation project. Returns the project with its ID and slug.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                name: { type: "string", description: "Project name" },
-                description: { type: "string", description: "Project description" },
-                visibility: { type: "string", description: "public or private (default: public)" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["name"],
-        },
-    },
-    {
-        name: "update_project",
-        description: "Update a documentation project's name, description, or visibility. Brand admin only.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                project: { type: "string", description: "Project slug or UUID" },
-                name: { type: "string", description: "New name" },
-                description: { type: "string", description: "New description" },
-                visibility: { type: "string", description: "public or private" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["project"],
-        },
-    },
-    {
-        name: "delete_project",
-        description: "Soft-delete a documentation project. Brand admin only.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                project: { type: "string", description: "Project slug or UUID" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["project"],
-        },
-    },
-    // ── Docs: Page Operations ──
-    {
-        name: "list_pages",
-        description: "List pages in a documentation project. Use view='tree' for nested structure with children.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                project: { type: "string", description: "Project slug or UUID" },
-                view: { type: "string", description: "flat or tree (default: flat)" },
-                limit: { type: "number", description: "Max results (default 100)" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["project"],
-        },
-    },
-    {
-        name: "move_page",
-        description: "Move a page to a new path or change sort order within its folder. Does not create a revision.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                project: { type: "string", description: "Project slug or UUID" },
-                slug: { type: "string", description: "Page slug" },
-                path: { type: "string", description: "New tree path (e.g. '/guides')" },
-                sort_order: { type: "number", description: "New sort order within folder" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["project", "slug"],
-        },
-    },
-    {
-        name: "delete_page",
-        description: "Soft-delete a documentation page.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                project: { type: "string", description: "Project slug or UUID" },
-                slug: { type: "string", description: "Page slug" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["project", "slug"],
-        },
-    },
-    // ── Docs: Revision History ──
-    {
-        name: "page_history",
-        description: "Get revision history for a page. Returns all past versions with dates and authors.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                page_id: { type: "string", description: "Page UUID" },
-                limit: { type: "number", description: "Max results (default 25)" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["page_id"],
-        },
-    },
-    {
-        name: "page_diff",
-        description: "Compute unified diff between two revisions. Omit 'from' for parent comparison.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                page_id: { type: "string", description: "Page UUID" },
-                from_rev: { type: "string", description: "From revision ID (optional — defaults to parent)" },
-                to_rev: { type: "string", description: "To revision ID (optional — defaults to latest)" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["page_id"],
-        },
-    },
-    {
-        name: "page_rollback",
-        description: "Rollback a page to a previous revision. Non-destructive — creates a new revision with the old content.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                page_id: { type: "string", description: "Page UUID" },
-                revision_id: { type: "string", description: "Target revision ID to restore" },
-                message: { type: "string", description: "Commit message (default: 'Rollback via MCP')" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["page_id", "revision_id"],
-        },
-    },
-    // ── Docs: Media ──
-    {
-        name: "list_media",
-        description: "List media files in a documentation project. Returns filenames, sizes, URLs, and markdown embed snippets.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                project: { type: "string", description: "Project slug or UUID" },
-                limit: { type: "number", description: "Max results (default 25)" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["project"],
-        },
-    },
-    // ── Docs: Bulk & Export ──
-    {
-        name: "bulk_create_pages",
-        description: "Bulk create or update multiple pages at once. Used for multi-page writes. Each page needs title, slug, content_md, commit_message.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                project: { type: "string", description: "Project slug or UUID" },
-                pages: {
-                    type: "array",
-                    items: {
-                        type: "object",
-                        properties: {
-                            title: { type: "string" },
-                            slug: { type: "string" },
-                            content_md: { type: "string" },
-                            commit_message: { type: "string" },
-                            path: { type: "string" },
-                        },
-                        required: ["title", "slug", "content_md", "commit_message"],
-                    },
-                    description: "Array of page objects",
-                },
-                branch: { type: "string", description: "Target branch (default: main)" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["project", "pages"],
-        },
-    },
-    // ── Agent Optimization ──
-    {
-        name: "agent_my_tasks",
-        description: "Get tasks assigned to you across ALL boards in one call. More comprehensive than list_tasks with self=true — aggregates from every board and includes board names.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                board_id: { type: "string", description: "Scope to a specific board (optional)" },
-                status: { type: "string", description: "Filter: pending, assigned, in_progress, review, done, failed" },
-                limit: { type: "number", description: "Max results" },
-                ...WORKSPACE_PROP,
-            },
-        },
-    },
-    {
-        name: "agent_my_delegations",
-        description: "List tasks you delegated to other agents. Complement to agent_my_tasks — shows tasks you handed off, not tasks assigned to you.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                status: { type: "string", description: "Filter: pending, assigned, in_progress, review, done, failed" },
-                limit: { type: "number", description: "Max results" },
-                ...WORKSPACE_PROP,
-            },
-        },
-    },
-    {
-        name: "agent_batch_create_tasks",
-        description: "Create multiple tasks at once. Each task needs board_id and title. Returns list of created IDs and any errors.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                tasks: {
-                    type: "array",
-                    items: {
-                        type: "object",
-                        properties: {
-                            board_id: { type: "string", description: "Board UUID" },
-                            title: { type: "string", description: "Task title" },
-                            description: { type: "string", description: "Task description" },
-                            priority: { type: "string", description: "low, medium, high, critical" },
-                            column_id: { type: "string", description: "Column UUID or name" },
-                            agent_instructions: { type: "string", description: "Agent instructions" },
-                        },
-                        required: ["board_id", "title"],
-                    },
-                    description: "Array of task objects to create",
-                },
-                ...WORKSPACE_PROP,
-            },
-            required: ["tasks"],
-        },
-    },
-    {
-        name: "agent_report_progress",
-        description: "Report progress on a task. Updates metadata and adds a progress comment. Use this for long-running tasks to keep stakeholders informed.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                task_id: { type: "string", description: "Task UUID" },
-                percent: { type: "number", description: "Progress percentage (0-100)" },
-                message: { type: "string", description: "Progress message" },
-                current_operation: { type: "string", description: "What you're currently doing" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["task_id", "percent"],
-        },
-    },
-    {
-        name: "agent_complete_task",
-        description: "Mark a task as done or failed. Automatically walks through intermediate status transitions (pending→assigned→in_progress→done). Adds a completion comment.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                task_id: { type: "string", description: "Task UUID" },
-                status: { type: "string", description: "done or failed (default: done)" },
-                summary: { type: "string", description: "Completion summary (added as comment)" },
-                result_data: {
-                    type: "object",
-                    description: "Structured result data (JSON object)",
-                },
-                ...WORKSPACE_PROP,
-            },
-            required: ["task_id"],
-        },
-    },
-    {
-        name: "agent_delegate_task",
-        description: "Reassign a task to another agent by their slug (e.g. 'maya', 'grant'). Resolves the slug to a UUID, updates assignment, and adds a delegation comment.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                task_id: { type: "string", description: "Task UUID" },
-                agent_slug: { type: "string", description: "Target agent's slug (e.g. 'maya')" },
-                instructions: { type: "string", description: "Instructions for the target agent" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["task_id", "agent_slug"],
-        },
-    },
-    {
-        name: "search_tasks",
-        description: "Full-text search across all tasks/cards. Searches titles, descriptions, and comments.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                query: { type: "string", description: "Search query" },
-                board_id: { type: "string", description: "Scope to a specific board (optional)" },
-                limit: { type: "number", description: "Max results (default 25)" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["query"],
-        },
-    },
-    {
-        name: "batch_get_tasks",
-        description: "Get multiple tasks by IDs in one call (max 50). More efficient than calling get_task multiple times.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                ids: {
-                    type: "array",
-                    items: { type: "string" },
-                    description: "Array of task UUIDs (max 50)",
-                },
-                ...WORKSPACE_PROP,
-            },
-            required: ["ids"],
-        },
-    },
-    // ── Stages ──
-    {
-        name: "list_stages",
-        description: "List stages (sequential in-card steps) for a task. Stages enable multi-agent handoff workflows within a single task.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                task_id: { type: "string", description: "Task UUID" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["task_id"],
-        },
-    },
-    {
-        name: "create_stage",
-        description: "Create a stage on a task. The first stage auto-activates. Subsequent stages stay pending until the previous one is completed via handoff.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                task_id: { type: "string", description: "Task UUID" },
-                title: { type: "string", description: "Stage title" },
-                description: { type: "string", description: "Stage description" },
-                assignee_agent_id: { type: "string", description: "Agent UUID to assign this stage to" },
-                agent_instructions: { type: "string", description: "Instructions for the agent handling this stage" },
-                position: { type: "number", description: "Position in stage order" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["task_id", "title"],
-        },
-    },
-    {
-        name: "update_stage",
-        description: "Update a stage (pending or active only). Provide only the fields you want to change.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                task_id: { type: "string", description: "Task UUID" },
-                stage_id: { type: "string", description: "Stage UUID" },
-                title: { type: "string", description: "New title" },
-                description: { type: "string", description: "New description" },
-                assignee_agent_id: { type: "string", description: "New agent assignment" },
-                agent_instructions: { type: "string", description: "New agent instructions" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["task_id", "stage_id"],
-        },
-    },
-    {
-        name: "complete_stage",
-        description: "Complete a stage and hand off to the next one. Adds a handoff comment. If this is the last stage, the task can be completed.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                task_id: { type: "string", description: "Task UUID" },
-                stage_id: { type: "string", description: "Stage UUID to complete" },
-                comment: { type: "string", description: "Handoff comment for the next stage's assignee" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["task_id", "stage_id"],
-        },
-    },
-    {
-        name: "reorder_stages",
-        description: "Reorder pending stages on a task. Active and completed stages cannot be reordered.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                task_id: { type: "string", description: "Task UUID" },
-                order: {
-                    type: "array",
-                    items: { type: "string" },
-                    description: "Stage UUIDs in desired order",
-                },
-                ...WORKSPACE_PROP,
-            },
-            required: ["task_id", "order"],
-        },
-    },
-    // ── Task Links ──
-    {
-        name: "list_task_links",
-        description: "List all links for a task (incoming and outgoing). Link types: spawned, blocked_by, related.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                task_id: { type: "string", description: "Task UUID" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["task_id"],
-        },
-    },
-    {
-        name: "create_task_link",
-        description: "Create a link between two tasks. Types: 'spawned' (this task created the target), 'blocked_by' (this task is blocked by target), 'related' (general relation).",
-        inputSchema: {
-            type: "object",
-            properties: {
-                task_id: { type: "string", description: "Source task UUID" },
-                target_task_id: { type: "string", description: "Target task UUID" },
-                link_type: { type: "string", description: "spawned, blocked_by, or related (default: related)" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["task_id", "target_task_id"],
-        },
-    },
-    {
-        name: "delete_task_link",
-        description: "Delete a task link by its ID.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                link_id: { type: "string", description: "Link UUID" },
-                ...WORKSPACE_PROP,
-            },
-            required: ["link_id"],
-        },
-    },
-    // ── Auth ──
-    {
-        name: "request_access",
-        description: "Request access to OPVS workspaces by admin email. Sends an approval email to the admin. After the admin clicks approve, use check_access_status to complete authentication. Returns a request_id and poll_token needed for check_access_status.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                email: { type: "string", description: "Admin email address (the person who will approve access)" },
-                api_url: { type: "string", description: "API URL (default: https://app.opvs.ai)" },
-                project: { type: "string", description: "Project name (shown in approval email)" },
-            },
-            required: ["email"],
-        },
-    },
-    {
-        name: "check_access_status",
-        description: "Check the status of an access request. Call this after request_access to see if the admin has approved. Returns 'pending' (keep checking), 'active' (success — workspaces are now configured), 'denied', or 'expired'.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                request_id: { type: "string", description: "The request_id from request_access" },
-                poll_token: { type: "string", description: "The poll_token from request_access" },
-                api_url: { type: "string", description: "API URL (must match the one used in request_access)" },
-            },
-            required: ["request_id", "poll_token"],
-        },
-    },
+    ...BOARD_TOOLS,
+    ...AGENT_TOOLS,
+    ...DOCS_TOOLS,
+    ...VIEWS_TOOLS,
+    ...STAGES_TOOLS,
+    ...AUTH_TOOLS,
 ];
-// ── Tool Handlers ────────────────────────────────────────────────
+// ── Handler router ──────────────────────────────────────────────
+const handlers = [handleBoard, handleAgent, handleDocs, handleViews, handleStages];
 async function handleTool(name, args) {
-    const fmt = getFormat();
-    const ws = resolveWorkspace(args);
-    switch (name) {
-        // ── Workspace & Auth ──
-        case "list_workspaces": {
-            const workspaces = listWorkspaces();
-            if (workspaces.length === 0) {
-                return ok("No workspaces configured. Run `opvs auth request -w <slug> -e <email>` to add one.");
-            }
-            const lines = workspaces.map((w) => {
-                const marker = w.isCurrent ? " (current)" : "";
-                return `- ${w.slug}: ${w.brand_name || "(no brand)"}${marker}\n  api_url: ${w.api_url}`;
-            });
-            return ok(`workspaces:\n${lines.join("\n")}\n`);
-        }
-        case "get_auth_status": {
-            const text = await callApi("GET", "/api/v1/auth/me", ws);
-            return ok(text);
-        }
-        // ── Boards ──
-        case "list_boards": {
-            const url = buildUrl("/api/v1/board/boards", undefined, fmt);
-            return ok(await callApi("GET", url, ws));
-        }
-        case "get_board": {
-            const url = buildUrl(`/api/v1/board/boards/${args.board_id}`, undefined, fmt);
-            return ok(await callApi("GET", url, ws));
-        }
-        case "create_board": {
-            const body = { name: args.name };
-            if (args.description)
-                body.description = args.description;
-            if (args.visibility)
-                body.visibility = args.visibility;
-            return ok(await callApi("POST", "/api/v1/board/boards", ws, body));
-        }
-        case "update_board": {
-            const body = {};
-            if (args.name)
-                body.name = args.name;
-            if (args.description)
-                body.description = args.description;
-            if (args.visibility)
-                body.visibility = args.visibility;
-            if (Object.keys(body).length === 0) {
-                return err("Nothing to update. Provide name, description, or visibility.");
-            }
-            return ok(await callApi("PATCH", `/api/v1/board/boards/${args.board_id}`, ws, body));
-        }
-        case "delete_board": {
-            await callApi("DELETE", `/api/v1/board/boards/${args.board_id}`, ws);
-            return ok(`Deleted board ${args.board_id}`);
-        }
-        // ── Tasks ──
-        case "list_tasks": {
-            const params = {};
-            if (args.status)
-                params.status = String(args.status);
-            if (args.priority)
-                params.priority = String(args.priority);
-            if (args.limit)
-                params.limit = String(args.limit);
-            if (args.self) {
-                const url = buildUrl("/api/v1/board/agent-api/my-tasks", params, fmt);
-                return ok(await callApi("GET", url, ws));
-            }
-            if (!args.board_id) {
-                return err("Provide board_id or set self=true");
-            }
-            const url = buildUrl(`/api/v1/board/boards/${args.board_id}/tasks`, params, fmt);
-            return ok(await callApi("GET", url, ws));
-        }
-        case "get_task": {
-            const url = buildUrl(`/api/v1/board/tasks/${args.task_id}`, undefined, fmt);
-            return ok(await callApi("GET", url, ws));
-        }
-        case "create_task": {
-            const body = { title: args.title };
-            if (args.description)
-                body.description = args.description;
-            if (args.priority)
-                body.priority = args.priority;
-            if (args.column_id)
-                body.column_id = args.column_id;
-            if (args.labels)
-                body.labels = args.labels;
-            if (args.due_date)
-                body.due_date = args.due_date;
-            if (args.agent_instructions)
-                body.agent_instructions = args.agent_instructions;
-            if (args.assigned_to_agent_id)
-                body.assigned_to_agent_id = args.assigned_to_agent_id;
-            return ok(await callApi("POST", `/api/v1/board/boards/${args.board_id}/tasks`, ws, body));
-        }
-        case "update_task": {
-            const body = {};
-            if (args.status)
-                body.status = args.status;
-            if (args.priority)
-                body.priority = args.priority;
-            if (args.title)
-                body.title = args.title;
-            if (args.description)
-                body.description = args.description;
-            if (args.result)
-                body.agent_result_summary = args.result;
-            if (args.labels)
-                body.labels = args.labels;
-            if (args.due_date)
-                body.due_date = args.due_date;
-            if (args.assigned_to_agent_id)
-                body.assigned_to_agent_id = args.assigned_to_agent_id;
-            if (Object.keys(body).length === 0) {
-                return err("Nothing to update. Provide status, priority, title, description, result, labels, due_date, or assigned_to_agent_id.");
-            }
-            return ok(await callApi("PATCH", `/api/v1/board/tasks/${args.task_id}`, ws, body));
-        }
-        case "delete_task": {
-            await callApi("DELETE", `/api/v1/board/tasks/${args.task_id}`, ws);
-            return ok(`Deleted task ${args.task_id}`);
-        }
-        case "move_task": {
-            const body = { column_id: args.column_id };
-            if (args.position !== undefined)
-                body.position = args.position;
-            return ok(await callApi("POST", `/api/v1/board/tasks/${args.task_id}/move`, ws, body));
-        }
-        case "list_subtasks": {
-            const url = buildUrl(`/api/v1/board/tasks/${args.task_id}/subtasks`, undefined, fmt);
-            return ok(await callApi("GET", url, ws));
-        }
-        // ── Comments ──
-        case "add_comment": {
-            return ok(await callApi("POST", `/api/v1/board/tasks/${args.task_id}/comments`, ws, { content: args.content }));
-        }
-        case "list_comments": {
-            const params = {};
-            if (args.limit)
-                params.limit = String(args.limit);
-            const url = buildUrl(`/api/v1/board/tasks/${args.task_id}/comments`, params, fmt);
-            return ok(await callApi("GET", url, ws));
-        }
-        // ── Views ──
-        case "get_board_session": {
-            const url = buildUrl(`/api/v1/board/views/boards/${args.board_id}/session`, undefined, fmt || "yaml");
-            return ok(await callApi("GET", url, ws));
-        }
-        case "get_board_overview": {
-            const url = buildUrl(`/api/v1/board/views/boards/${args.board_id}/overview`, undefined, fmt || "yaml");
-            return ok(await callApi("GET", url, ws));
-        }
-        // ── Session ──
-        case "get_session": {
-            if (args.board_id) {
-                const url = buildUrl(`/api/v1/board/boards/${args.board_id}`, undefined, fmt);
-                return ok(await callApi("GET", url, ws));
-            }
-            const url = buildUrl("/api/v1/board/agent-api/my-tasks", undefined, fmt);
-            return ok(await callApi("GET", url, ws));
-        }
-        // ── Activity ──
-        case "list_activity": {
-            const params = {};
-            if (args.limit)
-                params.per_page = String(args.limit);
-            if (args.task_id) {
-                const url = buildUrl(`/api/v1/board/activity/tasks/${args.task_id}`, params, fmt);
-                return ok(await callApi("GET", url, ws));
-            }
-            if (args.board_id) {
-                const url = buildUrl(`/api/v1/board/activity/boards/${args.board_id}`, params, fmt);
-                return ok(await callApi("GET", url, ws));
-            }
-            return err("Provide board_id or task_id");
-        }
-        // ── Metrics ──
-        case "get_board_summary": {
-            const params = { board_id: String(args.board_id) };
-            if (args.days)
-                params.days = String(args.days);
-            const url = buildUrl("/api/v1/board/metrics/board-summary", params, fmt);
-            return ok(await callApi("GET", url, ws));
-        }
-        case "get_task_velocity": {
-            const params = {};
-            if (args.days)
-                params.days = String(args.days);
-            const url = buildUrl("/api/v1/board/metrics/task-velocity", params, fmt);
-            return ok(await callApi("GET", url, ws));
-        }
-        // ── Columns ──
-        case "list_columns": {
-            const url = buildUrl(`/api/v1/board/boards/${args.board_id}/columns`, undefined, fmt);
-            return ok(await callApi("GET", url, ws));
-        }
-        case "create_column": {
-            const body = { name: args.name };
-            if (args.color)
-                body.color = args.color;
-            if (args.wip_limit !== undefined)
-                body.wip_limit = args.wip_limit;
-            return ok(await callApi("POST", `/api/v1/board/boards/${args.board_id}/columns`, ws, body));
-        }
-        case "reorder_columns": {
-            return ok(await callApi("POST", `/api/v1/board/boards/${args.board_id}/columns/reorder`, ws, { column_ids: args.column_ids }));
-        }
-        // ── Files ──
-        case "list_files": {
-            const url = buildUrl(`/api/v1/board/tasks/${args.task_id}/files`, undefined, fmt);
-            return ok(await callApi("GET", url, ws));
-        }
-        case "get_file": {
-            return ok(await callApi("GET", `/api/v1/board/files/${args.file_id}`, ws));
-        }
-        // ── Docs ──
-        case "list_docs": {
-            const url = buildUrl("/api/v1/docs/projects", undefined, fmt);
-            return ok(await callApi("GET", url, ws));
-        }
-        case "get_doc": {
-            const params = {};
-            if (args.version)
-                params.version = String(args.version);
-            const url = buildUrl(`/api/v1/docs/projects/${args.project}/pages/${args.slug}`, params, fmt);
-            return ok(await callApi("GET", url, ws));
-        }
-        case "create_doc": {
-            const body = {
-                title: String(args.title),
-                slug: String(args.slug),
-                commit_message: String(args.message || "Created via MCP"),
-            };
-            if (args.content)
-                body.content_md = String(args.content);
-            return ok(await callApi("POST", `/api/v1/docs/projects/${args.project}/pages`, ws, body));
-        }
-        case "update_doc": {
-            const body = {
-                content_md: String(args.content),
-                commit_message: String(args.message || "Updated via MCP"),
-            };
-            if (args.title)
-                body.title = String(args.title);
-            return ok(await callApi("PUT", `/api/v1/docs/projects/${args.project}/pages/${args.slug}`, ws, body));
-        }
-        case "search_docs": {
-            const params = { q: String(args.query) };
-            if (args.project)
-                params.project = String(args.project);
-            if (args.limit)
-                params.limit = String(args.limit);
-            const url = buildUrl("/api/v1/docs/search", params, fmt);
-            return ok(await callApi("GET", url, ws));
-        }
-        // ── Docs: Project CRUD ──
-        case "create_project": {
-            const body = { name: args.name };
-            if (args.description)
-                body.description = args.description;
-            if (args.visibility)
-                body.visibility = args.visibility;
-            return ok(await callApi("POST", "/api/v1/docs/projects", ws, body));
-        }
-        case "update_project": {
-            const body = {};
-            if (args.name)
-                body.name = args.name;
-            if (args.description)
-                body.description = args.description;
-            if (args.visibility)
-                body.visibility = args.visibility;
-            if (Object.keys(body).length === 0) {
-                return err("Nothing to update. Provide name, description, or visibility.");
-            }
-            return ok(await callApi("PATCH", `/api/v1/docs/projects/${args.project}`, ws, body));
-        }
-        case "delete_project": {
-            await callApi("DELETE", `/api/v1/docs/projects/${args.project}`, ws);
-            return ok(`Deleted project ${args.project}`);
-        }
-        // ── Docs: Page Operations ──
-        case "list_pages": {
-            const params = {};
-            if (args.view)
-                params.view = String(args.view);
-            if (args.limit)
-                params.limit = String(args.limit);
-            const url = buildUrl(`/api/v1/docs/projects/${args.project}/pages`, params, fmt);
-            return ok(await callApi("GET", url, ws));
-        }
-        case "move_page": {
-            const body = {};
-            if (args.path)
-                body.path = args.path;
-            if (args.sort_order !== undefined)
-                body.sort_order = args.sort_order;
-            if (Object.keys(body).length === 0) {
-                return err("Provide path or sort_order.");
-            }
-            return ok(await callApi("PATCH", `/api/v1/docs/projects/${args.project}/pages/${args.slug}/move`, ws, body));
-        }
-        case "delete_page": {
-            await callApi("DELETE", `/api/v1/docs/projects/${args.project}/pages/${args.slug}`, ws);
-            return ok(`Deleted page ${args.slug}`);
-        }
-        // ── Docs: Revision History ──
-        case "page_history": {
-            const params = {};
-            if (args.limit)
-                params.limit = String(args.limit);
-            const url = buildUrl(`/api/v1/docs/pages/${args.page_id}/history`, params, fmt);
-            return ok(await callApi("GET", url, ws));
-        }
-        case "page_diff": {
-            const params = {};
-            if (args.from_rev)
-                params.from = String(args.from_rev);
-            if (args.to_rev)
-                params.to = String(args.to_rev);
-            const url = buildUrl(`/api/v1/docs/pages/${args.page_id}/diff`, params, fmt);
-            return ok(await callApi("GET", url, ws));
-        }
-        case "page_rollback": {
-            const body = {
-                revision_id: args.revision_id,
-                commit_message: String(args.message || "Rollback via MCP"),
-            };
-            return ok(await callApi("POST", `/api/v1/docs/pages/${args.page_id}/rollback`, ws, body));
-        }
-        // ── Docs: Media ──
-        case "list_media": {
-            const params = {};
-            if (args.limit)
-                params.limit = String(args.limit);
-            const url = buildUrl(`/api/v1/docs/projects/${args.project}/media`, params, fmt);
-            return ok(await callApi("GET", url, ws));
-        }
-        // ── Docs: Bulk ──
-        case "bulk_create_pages": {
-            const body = { pages: args.pages };
-            if (args.branch)
-                body.branch = args.branch;
-            return ok(await callApi("POST", `/api/v1/docs/projects/${args.project}/pages/bulk`, ws, body));
-        }
-        // ── Agent Optimization ──
-        case "agent_my_tasks": {
-            const params = {};
-            if (args.board_id)
-                params.board_id = String(args.board_id);
-            if (args.status)
-                params.status = String(args.status);
-            if (args.limit)
-                params.limit = String(args.limit);
-            const url = buildUrl("/api/v1/board/agent-api/my-tasks", params, fmt);
-            return ok(await callApi("GET", url, ws));
-        }
-        case "agent_my_delegations": {
-            const params = {};
-            if (args.status)
-                params.status = String(args.status);
-            if (args.limit)
-                params.limit = String(args.limit);
-            const url = buildUrl("/api/v1/board/agent-api/my-delegations", params, fmt);
-            return ok(await callApi("GET", url, ws));
-        }
-        case "agent_batch_create_tasks": {
-            return ok(await callApi("POST", "/api/v1/board/agent-api/tasks/batch", ws, { tasks: args.tasks }));
-        }
-        case "agent_report_progress": {
-            const body = { percent: args.percent };
-            if (args.message)
-                body.message = args.message;
-            if (args.current_operation)
-                body.current_operation = args.current_operation;
-            return ok(await callApi("POST", `/api/v1/board/agent-api/tasks/${args.task_id}/progress`, ws, body));
-        }
-        case "agent_complete_task": {
-            const body = {};
-            if (args.status)
-                body.status = args.status;
-            if (args.summary)
-                body.summary = args.summary;
-            if (args.result_data)
-                body.result_data = args.result_data;
-            return ok(await callApi("POST", `/api/v1/board/agent-api/tasks/${args.task_id}/complete`, ws, body));
-        }
-        case "agent_delegate_task": {
-            const body = { agent_slug: args.agent_slug };
-            if (args.instructions)
-                body.instructions = args.instructions;
-            return ok(await callApi("POST", `/api/v1/board/agent-api/tasks/${args.task_id}/delegate`, ws, body));
-        }
-        case "search_tasks": {
-            const params = { q: String(args.query) };
-            if (args.board_id)
-                params.board_id = String(args.board_id);
-            if (args.limit)
-                params.limit = String(args.limit);
-            const url = buildUrl("/api/v1/board/cards/search", params, fmt);
-            return ok(await callApi("GET", url, ws));
-        }
-        case "batch_get_tasks": {
-            const ids = args.ids.join(",");
-            const url = buildUrl("/api/v1/board/tasks/batch", { ids }, fmt);
-            return ok(await callApi("GET", url, ws));
-        }
-        // ── Stages ──
-        case "list_stages": {
-            const url = buildUrl(`/api/v1/board/tasks/${args.task_id}/stages`, undefined, fmt);
-            return ok(await callApi("GET", url, ws));
-        }
-        case "create_stage": {
-            const body = { title: args.title };
-            if (args.description)
-                body.description = args.description;
-            if (args.assignee_agent_id)
-                body.assignee_agent_id = args.assignee_agent_id;
-            if (args.agent_instructions)
-                body.agent_instructions = args.agent_instructions;
-            if (args.position !== undefined)
-                body.position = args.position;
-            return ok(await callApi("POST", `/api/v1/board/tasks/${args.task_id}/stages`, ws, body));
-        }
-        case "update_stage": {
-            const body = {};
-            if (args.title)
-                body.title = args.title;
-            if (args.description)
-                body.description = args.description;
-            if (args.assignee_agent_id)
-                body.assignee_agent_id = args.assignee_agent_id;
-            if (args.agent_instructions)
-                body.agent_instructions = args.agent_instructions;
-            if (Object.keys(body).length === 0) {
-                return err("Nothing to update. Provide title, description, assignee_agent_id, or agent_instructions.");
-            }
-            return ok(await callApi("PATCH", `/api/v1/board/tasks/${args.task_id}/stages/${args.stage_id}`, ws, body));
-        }
-        case "complete_stage": {
-            const body = {};
-            if (args.comment)
-                body.comment = args.comment;
-            return ok(await callApi("POST", `/api/v1/board/tasks/${args.task_id}/stages/${args.stage_id}/handoff`, ws, body));
-        }
-        case "reorder_stages": {
-            return ok(await callApi("POST", `/api/v1/board/tasks/${args.task_id}/stages/reorder`, ws, { order: args.order }));
-        }
-        // ── Task Links ──
-        case "list_task_links": {
-            const url = buildUrl(`/api/v1/board/tasks/${args.task_id}/links`, undefined, fmt);
-            return ok(await callApi("GET", url, ws));
-        }
-        case "create_task_link": {
-            const body = {
-                target_task_id: args.target_task_id,
-                link_type: args.link_type || "related",
-            };
-            return ok(await callApi("POST", `/api/v1/board/tasks/${args.task_id}/links`, ws, body));
-        }
-        case "delete_task_link": {
-            await callApi("DELETE", `/api/v1/board/task-links/${args.link_id}`, ws);
-            return ok(`Deleted link ${args.link_id}`);
-        }
-        // ── Auth ──
-        case "request_access": {
-            const baseUrl = args.api_url || DEFAULT_WORKSPACE.api_url;
-            try {
-                const res = await apiUnauthPost(baseUrl, "/api/v1/auth/pat/request-by-email", {
-                    owner_email: args.email,
-                    project_name: args.project || null,
-                    requested_scopes: ["board:read", "board:write"],
-                    ttl_hours: 72,
-                    fingerprint: { agent_type: "Claude Desktop (MCP)", hostname: "mcp-server" },
-                });
-                const data = await res.json();
-                const brandCount = data.brands?.length ?? 0;
-                const brandList = data.brands?.map(b => b.brand_name).join(", ") || "unknown";
-                return ok(`Approval email sent to ${args.email}.\n` +
-                    `Found ${brandCount} workspace${brandCount !== 1 ? "s" : ""}: ${brandList}\n\n` +
-                    `Save these for check_access_status:\n` +
-                    `  request_id: ${data.request_id}\n` +
-                    `  poll_token: ${data.poll_token}\n` +
-                    `  api_url: ${baseUrl}\n\n` +
-                    `Ask the admin to check their email and click "Approve Access". ` +
-                    `Then call check_access_status with the request_id and poll_token above.`);
-            }
-            catch (e) {
-                const error = e;
-                return err(error.detail || error.message || "Failed to request access");
-            }
-        }
-        case "check_access_status": {
-            const baseUrl = args.api_url || DEFAULT_WORKSPACE.api_url;
-            try {
-                const res = await apiUnauthGet(baseUrl, `/api/v1/auth/pat/request/${args.request_id}/status`, String(args.poll_token));
-                const data = await res.json();
-                if (data.status === "pending") {
-                    return ok("Status: pending — the admin has not yet approved. Try again in a few seconds.");
-                }
-                if (data.status === "denied") {
-                    return ok("Status: denied — the admin rejected the access request.");
-                }
-                if (data.status === "expired") {
-                    return ok("Status: expired — the request timed out. Use request_access to try again.");
-                }
-                if (data.status === "active") {
-                    // Save workspace tokens to config
-                    if (data.workspaces?.length) {
-                        for (const ws of data.workspaces) {
-                            saveWorkspace(ws.brand_slug, {
-                                api_url: baseUrl,
-                                token: ws.token,
-                                brand_id: ws.brand_id,
-                                brand_name: ws.brand_name,
-                            });
-                        }
-                        setCurrentWorkspace(data.workspaces[0].brand_slug);
-                        const slugs = data.workspaces.map(ws => ws.brand_slug).join(", ");
-                        return ok(`Status: active — access granted!\n` +
-                            `${data.workspaces.length} workspace${data.workspaces.length !== 1 ? "s" : ""} configured: ${slugs}\n` +
-                            `Current workspace: ${data.workspaces[0].brand_slug}\n\n` +
-                            `You can now use all OPVS tools. Use list_workspaces to see available workspaces.`);
-                    }
-                    else if (data.token) {
-                        // Single-brand fallback
-                        return ok(`Status: active — access granted!\n` +
-                            `Brand: ${data.brand_name} (ID: ${data.brand_id})\n` +
-                            `Token received. Configure your workspace to use it.`);
-                    }
-                }
-                return ok(`Status: ${data.status}`);
-            }
-            catch (e) {
-                const error = e;
-                return err(error.detail || error.message || "Failed to check status");
-            }
-        }
-        default:
-            return err(`Unknown tool: ${name}`);
+    // Try each domain handler
+    for (const handler of handlers) {
+        const result = await handler(name, args, callApi, buildUrl);
+        if (result !== null)
+            return result;
     }
+    // Auth handler has a different signature (no buildUrl)
+    const authResult = await handleAuth(name, args, callApi);
+    if (authResult !== null)
+        return authResult;
+    return err(`Unknown tool: ${name}`);
 }
-// ── Server Setup ─────────────────────────────────────────────────
-const server = new Server({ name: "opvs", version: "0.5.2" }, { capabilities: { tools: {} } });
-// ── opvsHUB Generated Tools ──────────────────────────────────────
-import { GENERATED_TOOLS, handleGeneratedTool } from "./generated-tools.js";
+// ── Server setup ────────────────────────────────────────────────
+const server = new Server({ name: "opvs", version: "0.5.4" }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [...TOOLS, ...GENERATED_TOOLS],
 }));