@vibescope/mcp-server 0.2.1 → 0.2.2

package/dist/index.js

@@ -7,6 +7,8 @@ import { initApiClient, getApiClient } from './api-client.js';
 import { ValidationError, } from './validators.js';
 import { RateLimiter, } from './utils.js';
 import { buildHandlerRegistry } from './handlers/index.js';
+import { tools } from './tools.js';
+import { createTokenUsage, trackTokenUsage as trackTokens, } from './token-tracking.js';
 // ============================================================================
 // Agent Instance Tracking
 // ============================================================================
@@ -18,38 +20,11 @@ let currentSessionId = null;
 let currentPersona = null;
 // Current role for this agent instance
 let currentRole = null;
-let sessionTokenUsage = {
-    callCount: 0,
-    totalTokens: 0,
-    byTool: {},
-    byModel: {},
-    currentModel: null,
-};
-// Estimate tokens from JSON (rough: ~4 chars per token)
-function estimateTokens(obj) {
-    return Math.ceil(JSON.stringify(obj).length / 4);
-}
-// Track token usage for a tool call (input = args, output = response)
+// Token usage tracking for this session (using token-tracking module)
+let sessionTokenUsage = createTokenUsage();
+// Wrapper function to track token usage with the session's usage object
 function trackTokenUsage(toolName, args, response) {
-    const inputTokens = estimateTokens(args);
-    const outputTokens = estimateTokens(response);
-    const totalTokens = inputTokens + outputTokens;
-    sessionTokenUsage.callCount++;
-    sessionTokenUsage.totalTokens += totalTokens;
-    if (!sessionTokenUsage.byTool[toolName]) {
-        sessionTokenUsage.byTool[toolName] = { calls: 0, tokens: 0 };
-    }
-    sessionTokenUsage.byTool[toolName].calls++;
-    sessionTokenUsage.byTool[toolName].tokens += totalTokens;
-    // Track by model if a model is set
-    const model = sessionTokenUsage.currentModel;
-    if (model) {
-        if (!sessionTokenUsage.byModel[model]) {
-            sessionTokenUsage.byModel[model] = { input: 0, output: 0 };
-        }
-        sessionTokenUsage.byModel[model].input += inputTokens;
-        sessionTokenUsage.byModel[model].output += outputTokens;
-    }
+    trackTokens(sessionTokenUsage, toolName, args, response);
 }
 // Global rate limiter instance (60 requests per minute per API key)
 const rateLimiter = new RateLimiter(60, 60000);
@@ -175,2691 +150,7 @@ async function validateApiKey() {
         scope: 'personal', // API handles authorization, scope not needed locally
     };
 }
-// ============================================================================
-// Tool Definitions
-// ============================================================================
-const tools = [
-    {
-        name: 'start_work_session',
-        description: `CALL THIS FIRST when beginning work on a project.
-Returns session info, persona, and next task. Use mode:'full' for complete context.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                git_url: {
-                    type: 'string',
-                    description: 'Git repository URL. Used to find project if project_id not provided.',
-                },
-                mode: {
-                    type: 'string',
-                    enum: ['lite', 'full'],
-                    description: 'Response mode: lite (default, minimal tokens) or full (complete context)',
-                },
-                model: {
-                    type: 'string',
-                    enum: ['opus', 'sonnet', 'haiku'],
-                    description: 'Claude model being used (for accurate cost tracking). E.g., "opus", "sonnet", "haiku".',
-                },
-            },
-        },
-    },
-    {
-        name: 'get_help',
-        description: 'Get guidance on a specific topic. Use when unsure about workflows.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                topic: {
-                    type: 'string',
-                    enum: ['getting_started', 'tasks', 'validation', 'deployment', 'git', 'blockers', 'milestones', 'fallback', 'session', 'tokens', 'sprints', 'topics'],
-                    description: 'Help topic. Use "topics" to list all available.',
-                },
-            },
-            required: ['topic'],
-        },
-    },
-    {
-        name: 'get_token_usage',
-        description: 'Get token usage stats for this session. Monitor efficiency.',
-        inputSchema: {
-            type: 'object',
-            properties: {},
-        },
-    },
-    // Cost monitoring tools
-    {
-        name: 'get_cost_summary',
-        description: 'Get cost summary (daily/weekly/monthly) for a project.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                period: {
-                    type: 'string',
-                    enum: ['daily', 'weekly', 'monthly'],
-                    description: 'Summary period (default: daily)',
-                },
-                limit: {
-                    type: 'number',
-                    description: 'Max records to return (default: 30)',
-                },
-            },
-            required: ['project_id'],
-        },
-    },
-    {
-        name: 'get_cost_alerts',
-        description: 'Get cost alerts for the current user.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Filter by project (optional)',
-                },
-            },
-        },
-    },
-    {
-        name: 'add_cost_alert',
-        description: 'Add a cost alert threshold.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID (null for all projects)',
-                },
-                threshold_amount: {
-                    type: 'number',
-                    description: 'Amount in USD that triggers the alert',
-                },
-                threshold_period: {
-                    type: 'string',
-                    enum: ['daily', 'weekly', 'monthly'],
-                    description: 'Period for the threshold',
-                },
-                alert_type: {
-                    type: 'string',
-                    enum: ['warning', 'critical'],
-                    description: 'Alert severity (default: warning)',
-                },
-            },
-            required: ['threshold_amount', 'threshold_period'],
-        },
-    },
-    {
-        name: 'update_cost_alert',
-        description: 'Update a cost alert.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                alert_id: {
-                    type: 'string',
-                    description: 'Alert UUID',
-                },
-                threshold_amount: {
-                    type: 'number',
-                    description: 'New threshold amount in USD',
-                },
-                threshold_period: {
-                    type: 'string',
-                    enum: ['daily', 'weekly', 'monthly'],
-                    description: 'New period',
-                },
-                alert_type: {
-                    type: 'string',
-                    enum: ['warning', 'critical'],
-                    description: 'New alert type',
-                },
-                enabled: {
-                    type: 'boolean',
-                    description: 'Enable or disable the alert',
-                },
-            },
-            required: ['alert_id'],
-        },
-    },
-    {
-        name: 'delete_cost_alert',
-        description: 'Delete a cost alert.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                alert_id: {
-                    type: 'string',
-                    description: 'Alert UUID to delete',
-                },
-            },
-            required: ['alert_id'],
-        },
-    },
-    {
-        name: 'get_task_costs',
-        description: 'Get cost breakdown by task for a project.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                limit: {
-                    type: 'number',
-                    description: 'Max tasks to return (default: 20)',
-                },
-            },
-            required: ['project_id'],
-        },
-    },
-    {
-        name: 'discover_tools',
-        description: 'List tools by category. Use get_tool_info for details.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                category: {
-                    type: 'string',
-                    enum: ['session', 'project', 'tasks', 'milestones', 'progress', 'blockers', 'decisions', 'ideas', 'findings', 'validation', 'deployment', 'fallback', 'requests', 'organizations', 'cost'],
-                    description: 'Category to list (omit for all categories)',
-                },
-            },
-        },
-    },
-    {
-        name: 'get_tool_info',
-        description: 'Get detailed tool documentation.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                tool_name: {
-                    type: 'string',
-                    description: 'Tool name',
-                },
-            },
-            required: ['tool_name'],
-        },
-    },
-    {
-        name: 'get_project_context',
-        description: 'Get full project context: goals, instructions, tasks, blockers, decisions.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID. If not provided, will list all projects.',
-                },
-                git_url: {
-                    type: 'string',
-                    description: 'Git repository URL. Used to find project if project_id not provided.',
-                },
-            },
-        },
-    },
-    {
-        name: 'get_git_workflow',
-        description: 'Get git workflow config and branching instructions for the project.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                task_id: {
-                    type: 'string',
-                    description: 'Optional task ID to include branch naming suggestion',
-                },
-            },
-            required: ['project_id'],
-        },
-    },
-    {
-        name: 'create_project',
-        description: 'Create a new project to track in Vibescope.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                name: {
-                    type: 'string',
-                    description: 'Project display name',
-                },
-                description: {
-                    type: 'string',
-                    description: 'Brief project description',
-                },
-                goal: {
-                    type: 'string',
-                    description: 'What does "done" look like for this project?',
-                },
-                git_url: {
-                    type: 'string',
-                    description: 'Git repository URL (if available)',
-                },
-                tech_stack: {
-                    type: 'array',
-                    items: { type: 'string' },
-                    description: 'Technologies used (e.g., ["TypeScript", "React", "PostgreSQL"])',
-                },
-            },
-            required: ['name'],
-        },
-    },
-    {
-        name: 'update_project',
-        description: 'Update project details (name, description, goal, settings).',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                name: { type: 'string' },
-                description: { type: 'string' },
-                goal: { type: 'string' },
-                git_url: { type: 'string' },
-                tech_stack: {
-                    type: 'array',
-                    items: { type: 'string' },
-                },
-                status: {
-                    type: 'string',
-                    enum: ['active', 'paused', 'completed', 'archived'],
-                },
-                git_workflow: {
-                    type: 'string',
-                    enum: ['none', 'trunk-based', 'github-flow', 'git-flow'],
-                    description: 'Git workflow: none (no branching), trunk-based (commit to main), github-flow (feature branches + PR), git-flow (develop/release branches)',
-                },
-                git_main_branch: {
-                    type: 'string',
-                    description: 'Main branch name (default: main)',
-                },
-                git_develop_branch: {
-                    type: 'string',
-                    description: 'Development branch name (used with git-flow)',
-                },
-                git_auto_branch: {
-                    type: 'boolean',
-                    description: 'Automatically create feature branches for new tasks',
-                },
-                git_auto_tag: {
-                    type: 'boolean',
-                    description: 'Automatically tag deployments on main branch',
-                },
-                deployment_instructions: {
-                    type: 'string',
-                    description: 'Instructions for how to deploy (e.g., "Push to main for Vercel auto-deploy", "Run fly deploy")',
-                },
-            },
-            required: ['project_id'],
-        },
-    },
-    {
-        name: 'update_project_readme',
-        description: 'Sync README content to the dashboard.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                readme_content: {
-                    type: 'string',
-                    description: 'README content in markdown format',
-                },
-            },
-            required: ['project_id', 'readme_content'],
-        },
-    },
-    {
-        name: 'get_tasks',
-        description: 'Get tasks for a project, optionally filtered by status. By default returns only root tasks (not subtasks).',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                status: {
-                    type: 'string',
-                    enum: ['backlog', 'pending', 'in_progress', 'completed', 'cancelled'],
-                    description: 'Filter by status (optional)',
-                },
-                limit: {
-                    type: 'number',
-                    description: 'Max number of tasks to return (default 50)',
-                },
-                offset: {
-                    type: 'number',
-                    description: 'Number of tasks to skip for pagination (default 0)',
-                },
-                search_query: {
-                    type: 'string',
-                    description: 'Search tasks by title',
-                },
-                include_subtasks: {
-                    type: 'boolean',
-                    description: 'Include subtasks in results (default false). Use get_subtasks for subtasks of a specific task.',
-                },
-            },
-            required: ['project_id'],
-        },
-    },
-    {
-        name: 'get_next_task',
-        description: 'Get highest priority pending task. Skips claimed tasks. Check deployment_blocks_tasks first.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-            },
-            required: ['project_id'],
-        },
-    },
-    {
-        name: 'add_task',
-        description: 'Add a new task. Priority 1=highest, 5=lowest. Include estimated_minutes. Use blocking=true for deployment finalization tasks that must complete before other work.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                title: {
-                    type: 'string',
-                    description: 'Task title',
-                },
-                description: {
-                    type: 'string',
-                    description: 'Detailed description',
-                },
-                priority: {
-                    type: 'number',
-                    minimum: 1,
-                    maximum: 5,
-                    description: 'Priority 1-5 (1 = highest)',
-                },
-                estimated_minutes: {
-                    type: 'number',
-                    minimum: 1,
-                    description: 'Estimated time to complete in minutes',
-                },
-                blocking: {
-                    type: 'boolean',
-                    description: 'When true, this task blocks all other work until complete (used for deployment finalization)',
-                },
-                task_type: {
-                    type: 'string',
-                    enum: ['frontend', 'backend', 'database', 'feature', 'bugfix', 'design', 'mcp', 'testing', 'docs', 'infra', 'other'],
-                    description: 'Task category (frontend, backend, database, feature, bugfix, design, mcp, testing, docs, infra, other)',
-                },
-            },
-            required: ['project_id', 'title'],
-        },
-    },
-    {
-        name: 'update_task',
-        description: 'Update task status, progress, or details. Include progress_note with progress_percentage.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                task_id: {
-                    type: 'string',
-                    description: 'Task UUID',
-                },
-                title: { type: 'string' },
-                description: { type: 'string' },
-                priority: {
-                    type: 'number',
-                    minimum: 1,
-                    maximum: 5,
-                },
-                status: {
-                    type: 'string',
-                    enum: ['backlog', 'pending', 'in_progress', 'completed', 'cancelled'],
-                },
-                progress_percentage: {
-                    type: 'number',
-                    minimum: 0,
-                    maximum: 100,
-                    description: '0-100 completion percentage',
-                },
-                progress_note: {
-                    type: 'string',
-                    description: 'Brief note (auto-logged)',
-                },
-                estimated_minutes: {
-                    type: 'number',
-                    minimum: 1,
-                    description: 'Revised time estimate',
-                },
-                git_branch: {
-                    type: 'string',
-                    description: 'Git branch associated with this task',
-                },
-                task_type: {
-                    type: 'string',
-                    enum: ['frontend', 'backend', 'database', 'feature', 'bugfix', 'design', 'mcp', 'testing', 'docs', 'infra', 'other'],
-                    description: 'Task category (frontend, backend, database, feature, bugfix, design, mcp, testing, docs, infra, other)',
-                },
-            },
-            required: ['task_id'],
-        },
-    },
-    {
-        name: 'complete_task',
-        description: 'Mark task done. Returns next_task and context counts (validation, blockers, deployment).',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                task_id: {
-                    type: 'string',
-                    description: 'Task UUID',
-                },
-                summary: {
-                    type: 'string',
-                    description: 'Brief summary of what was done',
-                },
-            },
-            required: ['task_id'],
-        },
-    },
-    {
-        name: 'log_progress',
-        description: `Log progress update. Record significant milestones or observations.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                task_id: {
-                    type: 'string',
-                    description: 'Task UUID (optional, links progress to specific task)',
-                },
-                summary: {
-                    type: 'string',
-                    description: 'Brief summary of progress',
-                },
-                details: {
-                    type: 'string',
-                    description: 'Detailed notes (optional)',
-                },
-            },
-            required: ['project_id', 'summary'],
-        },
-    },
-    {
-        name: 'add_blocker',
-        description: `Record a blocker preventing progress.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                description: {
-                    type: 'string',
-                    description: 'What is blocking progress?',
-                },
-            },
-            required: ['project_id', 'description'],
-        },
-    },
-    {
-        name: 'resolve_blocker',
-        description: `Mark a blocker as resolved.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                blocker_id: {
-                    type: 'string',
-                    description: 'Blocker UUID',
-                },
-                resolution_note: {
-                    type: 'string',
-                    description: 'How was it resolved?',
-                },
-            },
-            required: ['blocker_id'],
-        },
-    },
-    {
-        name: 'get_blockers',
-        description: `Get blockers for a project, optionally filtered by status.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                status: {
-                    type: 'string',
-                    enum: ['open', 'resolved'],
-                    description: 'Filter by status (default: open)',
-                },
-                limit: {
-                    type: 'number',
-                    description: 'Max number of blockers to return (default 50, max 200)',
-                },
-                offset: {
-                    type: 'number',
-                    description: 'Number of blockers to skip for pagination (default 0)',
-                },
-                search_query: {
-                    type: 'string',
-                    description: 'Search blockers by description',
-                },
-            },
-            required: ['project_id'],
-        },
-    },
-    {
-        name: 'log_decision',
-        description: `Record an architectural or technical decision with rationale.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                title: {
-                    type: 'string',
-                    description: 'Decision title (e.g., "Use PostgreSQL for database")',
-                },
-                description: {
-                    type: 'string',
-                    description: 'What was decided',
-                },
-                rationale: {
-                    type: 'string',
-                    description: 'Why this decision was made',
-                },
-                alternatives_considered: {
-                    type: 'array',
-                    items: { type: 'string' },
-                    description: 'Other options that were considered',
-                },
-            },
-            required: ['project_id', 'title', 'description'],
-        },
-    },
-    {
-        name: 'get_decisions',
-        description: `Get recorded decisions for a project.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                limit: {
-                    type: 'number',
-                    description: 'Max number of decisions to return (default 50, max 200)',
-                },
-                offset: {
-                    type: 'number',
-                    description: 'Number of decisions to skip for pagination (default 0)',
-                },
-                search_query: {
-                    type: 'string',
-                    description: 'Search decisions by title or description',
-                },
-            },
-            required: ['project_id'],
-        },
-    },
-    {
-        name: 'add_idea',
-        description: `Record an idea for improvements or features. Starts as 'raw', can progress to 'shipped'.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                title: {
-                    type: 'string',
-                    description: 'Idea title',
-                },
-                description: {
-                    type: 'string',
-                    description: 'Detailed description',
-                },
-                status: {
-                    type: 'string',
-                    enum: ['raw', 'exploring', 'planned', 'in_development', 'shipped'],
-                    description: 'Development stage (default: raw)',
-                },
-            },
-            required: ['project_id', 'title'],
-        },
-    },
-    {
-        name: 'update_idea',
-        description: `Update an idea's status or details.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                idea_id: {
-                    type: 'string',
-                    description: 'Idea UUID',
-                },
-                title: {
-                    type: 'string',
-                    description: 'Updated title',
-                },
-                description: {
-                    type: 'string',
-                    description: 'Updated description',
-                },
-                status: {
-                    type: 'string',
-                    enum: ['raw', 'exploring', 'planned', 'in_development', 'shipped'],
-                    description: 'New development stage',
-                },
-                doc_url: {
-                    type: 'string',
-                    description: 'URL to feature documentation/specification',
-                },
-            },
-            required: ['idea_id'],
-        },
-    },
-    {
-        name: 'get_ideas',
-        description: `Get recorded ideas for a project, optionally filtered by status.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                status: {
-                    type: 'string',
-                    enum: ['raw', 'exploring', 'planned', 'in_development', 'shipped'],
-                    description: 'Filter by status (optional)',
-                },
-                limit: {
-                    type: 'number',
-                    description: 'Max number of ideas to return (default 50, max 100)',
-                },
-                offset: {
-                    type: 'number',
-                    description: 'Number of ideas to skip for pagination (default 0)',
-                },
-                search_query: {
-                    type: 'string',
-                    description: 'Search ideas by title or description',
-                },
-            },
-            required: ['project_id'],
-        },
-    },
-    {
-        name: 'delete_task',
-        description: `Delete a task.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                task_id: {
-                    type: 'string',
-                    description: 'Task UUID',
-                },
-            },
-            required: ['task_id'],
-        },
-    },
-    {
-        name: 'add_task_reference',
-        description: 'Add a reference URL to a task (docs, PRs, issues).',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                task_id: {
-                    type: 'string',
-                    description: 'Task UUID',
-                },
-                url: {
-                    type: 'string',
-                    description: 'URL to add as reference',
-                },
-                label: {
-                    type: 'string',
-                    description: 'Optional label/title for the reference',
-                },
-            },
-            required: ['task_id', 'url'],
-        },
-    },
-    {
-        name: 'remove_task_reference',
-        description: `Remove a reference link from a task by URL.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                task_id: {
-                    type: 'string',
-                    description: 'Task UUID',
-                },
-                url: {
-                    type: 'string',
-                    description: 'URL of the reference to remove',
-                },
-            },
-            required: ['task_id', 'url'],
-        },
-    },
-    {
-        name: 'delete_idea',
-        description: `Delete an idea.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                idea_id: {
-                    type: 'string',
-                    description: 'Idea UUID',
-                },
-            },
-            required: ['idea_id'],
-        },
-    },
-    {
-        name: 'convert_idea_to_task',
-        description: `Convert an idea to a task. Creates a task from the idea's title and description, links them, and optionally updates the idea status to 'in_development'. Useful for planned ideas that are ready for implementation.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                idea_id: {
-                    type: 'string',
-                    description: 'Idea UUID to convert',
-                },
-                priority: {
-                    type: 'number',
-                    minimum: 1,
-                    maximum: 5,
-                    description: 'Task priority 1-5 (default: 3, 1 = highest)',
-                },
-                estimated_minutes: {
-                    type: 'number',
-                    minimum: 1,
-                    description: 'Estimated time to complete in minutes',
-                },
-                update_status: {
-                    type: 'boolean',
-                    description: "Update idea status to 'in_development' (default: true)",
-                },
-            },
-            required: ['idea_id'],
-        },
-    },
-    // Findings (knowledge base)
-    {
-        name: 'add_finding',
-        description: 'Record a finding from an audit/review (performance, security, code quality, etc).',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: { type: 'string', description: 'Project UUID' },
-                category: { type: 'string', enum: ['performance', 'security', 'code_quality', 'accessibility', 'documentation', 'architecture', 'testing', 'other'], description: 'Category of the finding (default: other)' },
-                title: { type: 'string', description: 'Brief title describing the finding' },
-                description: { type: 'string', description: 'Detailed description of the finding, including impact and suggested fix' },
-                severity: { type: 'string', enum: ['info', 'low', 'medium', 'high', 'critical'], description: 'Severity level (default: info)' },
-                file_path: { type: 'string', description: 'File path where the issue was found (optional)' },
-                line_number: { type: 'number', description: 'Line number in the file (optional)' },
-                related_task_id: { type: 'string', description: 'ID of related task if this finding came from a task (optional)' },
-            },
-            required: ['project_id', 'title'],
-        },
-    },
-    {
-        name: 'get_findings',
-        description: `Get findings for a project, optionally filtered by category, severity, or status.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: { type: 'string', description: 'Project UUID' },
-                category: { type: 'string', enum: ['performance', 'security', 'code_quality', 'accessibility', 'documentation', 'architecture', 'testing', 'other'], description: 'Filter by category (optional)' },
-                severity: { type: 'string', enum: ['info', 'low', 'medium', 'high', 'critical'], description: 'Filter by severity (optional)' },
-                status: { type: 'string', enum: ['open', 'addressed', 'dismissed', 'wontfix'], description: 'Filter by status (default: all)' },
-                limit: { type: 'number', description: 'Max number of findings to return (default 50, max 200)' },
-                offset: { type: 'number', description: 'Number of findings to skip for pagination (default 0)' },
-                search_query: { type: 'string', description: 'Search findings by title or description' },
-            },
-            required: ['project_id'],
-        },
-    },
-    {
-        name: 'update_finding',
-        description: `Update a finding's status or details. Use to mark findings as addressed or dismissed.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                finding_id: { type: 'string', description: 'Finding UUID' },
-                status: { type: 'string', enum: ['open', 'addressed', 'dismissed', 'wontfix'], description: 'New status' },
-                resolution_note: { type: 'string', description: 'Note explaining how the finding was addressed or why it was dismissed' },
-                title: { type: 'string', description: 'Updated title' },
-                description: { type: 'string', description: 'Updated description' },
-                severity: { type: 'string', enum: ['info', 'low', 'medium', 'high', 'critical'], description: 'Updated severity' },
-            },
-            required: ['finding_id'],
-        },
-    },
-    {
-        name: 'delete_finding',
-        description: `Delete a finding.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                finding_id: { type: 'string', description: 'Finding UUID' },
-            },
-            required: ['finding_id'],
-        },
-    },
-    {
-        name: 'delete_blocker',
-        description: `Delete a blocker.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                blocker_id: {
-                    type: 'string',
-                    description: 'Blocker UUID',
-                },
-            },
-            required: ['blocker_id'],
-        },
-    },
-    // Git Issues tools
-    {
-        name: 'add_git_issue',
-        description: `Record a git-related issue (merge conflict, push failure, etc.). Auto-created by claim_validation when conflicts detected.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                issue_type: {
-                    type: 'string',
-                    enum: ['merge_conflict', 'push_failed', 'rebase_needed', 'branch_diverged', 'pr_not_mergeable'],
-                    description: 'Type of git issue',
-                },
-                branch: {
-                    type: 'string',
-                    description: 'Branch where the issue occurred',
-                },
-                target_branch: {
-                    type: 'string',
-                    description: 'Target branch for merge/rebase (optional)',
-                },
-                pr_url: {
-                    type: 'string',
-                    description: 'Pull request URL if applicable (optional)',
-                },
-                conflicting_files: {
-                    type: 'array',
-                    items: { type: 'string' },
-                    description: 'List of files with conflicts (optional)',
-                },
-                error_message: {
-                    type: 'string',
-                    description: 'Error message from git operation (optional)',
-                },
-                task_id: {
-                    type: 'string',
-                    description: 'Related task UUID (optional)',
-                },
-            },
-            required: ['project_id', 'issue_type', 'branch'],
-        },
-    },
-    {
-        name: 'resolve_git_issue',
-        description: `Mark a git issue as resolved.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                git_issue_id: {
-                    type: 'string',
-                    description: 'Git issue UUID',
-                },
-                resolution_note: {
-                    type: 'string',
-                    description: 'How the issue was resolved (optional)',
-                },
-                auto_resolved: {
-                    type: 'boolean',
-                    description: 'Whether this was auto-resolved (e.g., PR became mergeable)',
-                },
-            },
-            required: ['git_issue_id'],
-        },
-    },
-    {
-        name: 'get_git_issues',
-        description: `Get git issues for a project, optionally filtered by status, type, or branch.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                status: {
-                    type: 'string',
-                    enum: ['open', 'resolved'],
-                    description: 'Filter by status (default: open)',
-                },
-                issue_type: {
-                    type: 'string',
-                    enum: ['merge_conflict', 'push_failed', 'rebase_needed', 'branch_diverged', 'pr_not_mergeable'],
-                    description: 'Filter by issue type (optional)',
-                },
-                branch: {
-                    type: 'string',
-                    description: 'Filter by branch (optional)',
-                },
-                limit: {
-                    type: 'number',
-                    description: 'Max issues to return (default: 50)',
-                },
-            },
-            required: ['project_id'],
-        },
-    },
-    {
-        name: 'delete_git_issue',
-        description: `Delete a git issue.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                git_issue_id: {
-                    type: 'string',
-                    description: 'Git issue UUID',
-                },
-            },
-            required: ['git_issue_id'],
-        },
-    },
-    {
-        name: 'delete_decision',
-        description: `Delete a decision.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                decision_id: {
-                    type: 'string',
-                    description: 'Decision UUID',
-                },
-            },
-            required: ['decision_id'],
-        },
-    },
-    {
-        name: 'get_activity_feed',
-        description: `Get combined activity feed (tasks, progress, blockers, decisions) in chronological order.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                types: {
-                    type: 'array',
-                    items: {
-                        type: 'string',
-                        enum: ['task', 'progress', 'blocker', 'decision'],
-                    },
-                    description: 'Filter by activity types (default: all)',
-                },
-                created_by: {
-                    type: 'string',
-                    enum: ['agent', 'user'],
-                    description: 'Filter by creator (default: all)',
-                },
-                since: {
-                    type: 'string',
-                    description: 'ISO date string - only return activity after this time',
-                },
-                limit: {
-                    type: 'number',
-                    description: 'Max number of items to return (default 50, max 200)',
-                },
-            },
-            required: ['project_id'],
-        },
-    },
-    {
-        name: 'batch_update_tasks',
-        description: 'Update multiple tasks at once. Include progress_note with progress_percentage.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                updates: {
-                    type: 'array',
-                    description: 'Array of task updates to apply',
-                    items: {
-                        type: 'object',
-                        properties: {
-                            task_id: { type: 'string', description: 'Task UUID' },
-                            status: { type: 'string', enum: ['backlog', 'pending', 'in_progress', 'completed', 'cancelled'] },
-                            progress_percentage: { type: 'number', minimum: 0, maximum: 100 },
-                            progress_note: { type: 'string', description: 'Brief note about what was achieved' },
-                            priority: { type: 'number', minimum: 1, maximum: 5 },
-                        },
-                        required: ['task_id'],
-                    },
-                },
-            },
-            required: ['updates'],
-        },
-    },
-    {
-        name: 'batch_complete_tasks',
-        description: `Mark multiple tasks as completed at once.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                completions: {
-                    type: 'array',
-                    description: 'Array of task completions',
-                    items: {
-                        type: 'object',
-                        properties: {
-                            task_id: { type: 'string', description: 'Task UUID' },
-                            summary: { type: 'string', description: 'Optional completion summary' },
-                        },
-                        required: ['task_id'],
-                    },
-                },
-            },
-            required: ['completions'],
-        },
-    },
-    // =========================================================================
-    // Subtask Tools
-    // =========================================================================
-    {
-        name: 'add_subtask',
-        description: `Add a subtask to break down a larger task into smaller workable pieces.
-Subtasks can be claimed and worked on independently by any agent.
-Subtasks inherit the project from their parent task.
-Max depth is 1 (subtasks cannot have their own subtasks).`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                parent_task_id: {
-                    type: 'string',
-                    description: 'UUID of the parent task to add subtask to',
-                },
-                title: {
-                    type: 'string',
-                    description: 'Subtask title',
-                },
-                description: {
-                    type: 'string',
-                    description: 'Detailed description (optional)',
-                },
-                priority: {
-                    type: 'number',
-                    minimum: 1,
-                    maximum: 5,
-                    description: 'Priority 1-5 (1 = highest). Defaults to parent task priority.',
-                },
-                estimated_minutes: {
-                    type: 'number',
-                    minimum: 1,
-                    description: 'Estimated time to complete in minutes',
-                },
-            },
-            required: ['parent_task_id', 'title'],
-        },
-    },
-    {
-        name: 'get_subtasks',
-        description: `Get subtasks for a parent task.
-Returns subtasks with aggregate completion stats.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                parent_task_id: {
-                    type: 'string',
-                    description: 'UUID of the parent task',
-                },
-                status: {
-                    type: 'string',
-                    enum: ['backlog', 'pending', 'in_progress', 'completed', 'cancelled'],
-                    description: 'Filter by status (optional)',
-                },
-            },
-            required: ['parent_task_id'],
-        },
-    },
-    {
-        name: 'heartbeat',
-        description: `Send heartbeat to maintain 'active' status. Call every 30-60 seconds.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                session_id: {
-                    type: 'string',
-                    description: 'Session ID from start_work_session (optional, uses current session if not provided)',
-                },
-                current_worktree_path: {
-                    type: ['string', 'null'],
-                    description: 'Report your current git worktree path (e.g., "../project-task-abc123"). Set to null to clear.',
-                },
-            },
-        },
-    },
-    {
-        name: 'end_work_session',
-        description: `End session and release claimed tasks. Returns session summary.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                session_id: {
-                    type: 'string',
-                    description: 'Session ID to end (optional, uses current session if not provided)',
-                },
-            },
-        },
-    },
-    // =========================================================================
-    // Task Validation Tools
-    // =========================================================================
-    {
-        name: 'get_tasks_awaiting_validation',
-        description: `Get completed tasks not yet validated.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-            },
-            required: ['project_id'],
-        },
-    },
-    {
-        name: 'claim_validation',
-        description: 'Claim a completed task for review. Shows "being reviewed" on dashboard.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                task_id: {
-                    type: 'string',
-                    description: 'Task UUID to claim for review',
-                },
-            },
-            required: ['task_id'],
-        },
-    },
-    {
-        name: 'validate_task',
-        description: 'Validate a completed task. Include test results in validation_notes. For github-flow/git-flow projects, a PR must exist before approval (add via add_task_reference).',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                task_id: {
-                    type: 'string',
-                    description: 'Task UUID to validate',
-                },
-                validation_notes: {
-                    type: 'string',
-                    description: 'Notes about the validation (what was checked, any issues found)',
-                },
-                approved: {
-                    type: 'boolean',
-                    description: 'Whether the task passes validation (true = approved, false = needs more work)',
-                },
-                skip_pr_check: {
-                    type: 'boolean',
-                    description: 'Skip PR existence check (use only for tasks that legitimately do not need a PR)',
-                },
-            },
-            required: ['task_id', 'approved'],
-        },
-    },
-    // =========================================================================
-    // Deployment Coordination Tools
-    // =========================================================================
-    {
-        name: 'request_deployment',
-        description: 'Request a deployment. Requires validation first. One active deployment per project.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                environment: {
-                    type: 'string',
-                    enum: ['development', 'staging', 'production'],
-                    description: 'Target environment (default: production)',
-                },
-                version_bump: {
-                    type: 'string',
-                    enum: ['patch', 'minor', 'major'],
-                    description: 'Version bump: major/minor/patch (default: patch)',
-                },
-                notes: {
-                    type: 'string',
-                    description: 'Optional notes about this deployment',
-                },
-                git_ref: {
-                    type: 'string',
-                    description: 'Git branch or commit being deployed',
-                },
-            },
-            required: ['project_id'],
-        },
-    },
-    {
-        name: 'claim_deployment_validation',
-        description: `Claim pending deployment for validation. Run build+tests, then call report_validation.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-            },
-            required: ['project_id'],
-        },
-    },
-    {
-        name: 'report_validation',
-        description: `Report build/test results. If passed, status->'ready'. If failed, creates investigation task.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                build_passed: {
-                    type: 'boolean',
-                    description: 'Whether the build succeeded',
-                },
-                tests_passed: {
-                    type: 'boolean',
-                    description: 'Whether the tests passed',
-                },
-                error_message: {
-                    type: 'string',
-                    description: 'Error details if validation failed',
-                },
-            },
-            required: ['project_id', 'build_passed', 'tests_passed'],
-        },
-    },
-    {
-        name: 'check_deployment_status',
-        description: `Get active deployment status and details.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-            },
-            required: ['project_id'],
-        },
-    },
-    {
-        name: 'start_deployment',
-        description: `Start deployment (requires 'ready' status). Sets status to 'deploying'.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-            },
-            required: ['project_id'],
-        },
-    },
-    {
-        name: 'complete_deployment',
-        description: `Mark deployment as complete (success or failure).`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                success: {
-                    type: 'boolean',
-                    description: 'Whether the deployment succeeded',
-                },
-                summary: {
-                    type: 'string',
-                    description: 'Summary of what was deployed or why it failed',
-                },
-            },
-            required: ['project_id', 'success'],
-        },
-    },
-    {
-        name: 'cancel_deployment',
-        description: `Cancel active deployment. Sets status to 'failed'.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                reason: {
-                    type: 'string',
-                    description: 'Reason for cancellation',
-                },
-            },
-            required: ['project_id'],
-        },
-    },
-    {
-        name: 'add_deployment_requirement',
-        description: `Add a pre-deployment requirement (migration, env var, config change). These are shown as a checklist before deployment.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                type: {
-                    type: 'string',
-                    description: 'Type of requirement',
-                    enum: ['migration', 'env_var', 'config', 'manual', 'breaking_change', 'agent_task'],
-                },
-                title: {
-                    type: 'string',
-                    description: 'Brief description (e.g., "Run migration: 20250114_token_tracking.sql")',
-                },
-                description: {
-                    type: 'string',
-                    description: 'Optional detailed instructions',
-                },
-                file_path: {
-                    type: 'string',
-                    description: 'Optional file path reference',
-                },
-                stage: {
-                    type: 'string',
-                    description: 'Deployment stage: preparation (default), deployment, or verification',
-                    enum: ['preparation', 'deployment', 'verification'],
-                },
-                blocking: {
-                    type: 'boolean',
-                    description: 'When true, converted task blocks all other work until complete',
-                },
-            },
-            required: ['project_id', 'type', 'title'],
-        },
-    },
-    {
-        name: 'complete_deployment_requirement',
-        description: `Mark a deployment requirement as completed.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                requirement_id: {
-                    type: 'string',
-                    description: 'Requirement UUID',
-                },
-            },
-            required: ['requirement_id'],
-        },
-    },
-    {
-        name: 'get_deployment_requirements',
-        description: `Get pending deployment requirements for a project.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                status: {
-                    type: 'string',
-                    description: 'Filter by status (default: pending)',
-                    enum: ['pending', 'completed', 'converted_to_task', 'all'],
-                },
-                stage: {
-                    type: 'string',
-                    description: 'Filter by stage (optional)',
-                    enum: ['preparation', 'deployment', 'verification', 'all'],
-                },
-            },
-            required: ['project_id'],
-        },
-    },
-    {
-        name: 'schedule_deployment',
-        description: `Schedule a deployment for a specific time. Supports one-time and recurring schedules with auto-trigger or manual trigger modes.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                scheduled_at: {
-                    type: 'string',
-                    description: 'ISO 8601 datetime for when the deployment should be triggered',
-                },
-                schedule_type: {
-                    type: 'string',
-                    description: 'Schedule type: once (one-time), daily, weekly, or monthly',
-                    enum: ['once', 'daily', 'weekly', 'monthly'],
-                },
-                auto_trigger: {
-                    type: 'boolean',
-                    description: 'Whether agents should automatically trigger this deployment when due (default: true)',
-                },
-                environment: {
-                    type: 'string',
-                    description: 'Target environment (default: production)',
-                    enum: ['development', 'staging', 'production'],
-                },
-                version_bump: {
-                    type: 'string',
-                    description: 'Version bump: patch, minor, or major (default: patch)',
-                    enum: ['patch', 'minor', 'major'],
-                },
-                notes: {
-                    type: 'string',
-                    description: 'Optional notes about this scheduled deployment',
-                },
-                git_ref: {
-                    type: 'string',
-                    description: 'Optional git branch or commit to deploy',
-                },
-            },
-            required: ['project_id', 'scheduled_at'],
-        },
-    },
-    {
-        name: 'get_scheduled_deployments',
-        description: `Get scheduled deployments for a project.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                include_disabled: {
-                    type: 'boolean',
-                    description: 'Include disabled schedules (default: false)',
-                },
-            },
-            required: ['project_id'],
-        },
-    },
-    {
-        name: 'update_scheduled_deployment',
-        description: `Update a scheduled deployment's configuration.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                schedule_id: {
-                    type: 'string',
-                    description: 'Schedule UUID',
-                },
-                scheduled_at: {
-                    type: 'string',
-                    description: 'New scheduled time (ISO 8601)',
-                },
-                schedule_type: {
-                    type: 'string',
-                    description: 'New schedule type',
-                    enum: ['once', 'daily', 'weekly', 'monthly'],
-                },
-                auto_trigger: {
-                    type: 'boolean',
-                    description: 'Whether to auto-trigger',
-                },
-                enabled: {
-                    type: 'boolean',
-                    description: 'Enable or disable the schedule',
-                },
-                environment: {
-                    type: 'string',
-                    description: 'Target environment',
-                    enum: ['development', 'staging', 'production'],
-                },
-                version_bump: {
-                    type: 'string',
-                    description: 'Version bump type',
-                    enum: ['patch', 'minor', 'major'],
-                },
-                notes: {
-                    type: 'string',
-                    description: 'Notes about this deployment',
-                },
-                git_ref: {
-                    type: 'string',
-                    description: 'Git branch or commit to deploy',
-                },
-            },
-            required: ['schedule_id'],
-        },
-    },
-    {
-        name: 'delete_scheduled_deployment',
-        description: `Delete a scheduled deployment.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                schedule_id: {
-                    type: 'string',
-                    description: 'Schedule UUID',
-                },
-            },
-            required: ['schedule_id'],
-        },
-    },
-    {
-        name: 'trigger_scheduled_deployment',
-        description: `Manually trigger a scheduled deployment. Creates a new deployment and updates the schedule.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                schedule_id: {
-                    type: 'string',
-                    description: 'Schedule UUID',
-                },
-            },
-            required: ['schedule_id'],
-        },
-    },
-    {
-        name: 'check_due_deployments',
-        description: `Check for scheduled deployments that are due. Returns schedules where: enabled AND auto_trigger AND scheduled_at <= NOW().`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-            },
-            required: ['project_id'],
-        },
-    },
-    {
-        name: 'start_fallback_activity',
-        description: `Start a background activity when no tasks available.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                activity: {
-                    type: 'string',
-                    description: 'The fallback activity type (e.g., code_review, security_review)',
-                    enum: [
-                        'feature_ideation',
-                        'code_review',
-                        'performance_audit',
-                        'ux_review',
-                        'cost_analysis',
-                        'security_review',
-                        'test_coverage',
-                        'documentation_review',
-                        'dependency_audit',
-                        'validate_completed_tasks',
-                    ],
-                },
-            },
-            required: ['project_id', 'activity'],
-        },
-    },
-    {
-        name: 'stop_fallback_activity',
-        description: `Stop current fallback activity. Auto-clears when starting a regular task.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                summary: {
-                    type: 'string',
-                    description: 'Optional summary of what was accomplished during this activity',
-                },
-            },
-            required: ['project_id'],
-        },
-    },
-    {
-        name: 'get_activity_history',
-        description: `Get background activity completion history.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                activity_type: {
-                    type: 'string',
-                    description: 'Optional: filter to a specific activity type',
-                },
-                limit: {
-                    type: 'number',
-                    description: 'Max number of history entries to return (default 50)',
-                },
-            },
-            required: ['project_id'],
-        },
-    },
-    {
-        name: 'get_activity_schedules',
-        description: `Get background activity schedules.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-            },
-            required: ['project_id'],
-        },
-    },
-    // =========================================================================
-    // Agent Request Tools
-    // =========================================================================
-    {
-        name: 'get_pending_requests',
-        description: `Get unacknowledged user requests for this agent/project.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-            },
-            required: ['project_id'],
-        },
-    },
-    {
-        name: 'acknowledge_request',
-        description: `Mark a user request as handled.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                request_id: {
-                    type: 'string',
-                    description: 'Request UUID to acknowledge',
-                },
-            },
-            required: ['request_id'],
-        },
-    },
-    {
-        name: 'answer_question',
-        description: `Answer a question from the user. Use this when the user has asked a question via the dashboard.
-The answer will be displayed to the user and the question marked as answered.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                request_id: {
-                    type: 'string',
-                    description: 'Request UUID of the question to answer',
-                },
-                answer: {
-                    type: 'string',
-                    description: 'Your answer to the user\'s question',
-                },
-            },
-            required: ['request_id', 'answer'],
-        },
-    },
-    // ============================================================================
-    // Milestone Tools
-    // ============================================================================
-    {
-        name: 'add_milestone',
-        description: `Add a milestone to a task.
-Milestones help break down large tasks into smaller trackable steps.
-Use this to show progress on complex tasks and help gauge completion.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                task_id: {
-                    type: 'string',
-                    description: 'Task UUID to add milestone to',
-                },
-                title: {
-                    type: 'string',
-                    description: 'Milestone title (brief description of what needs to be done)',
-                },
-                description: {
-                    type: 'string',
-                    description: 'Optional detailed description',
-                },
-                order_index: {
-                    type: 'number',
-                    minimum: 0,
-                    description: 'Order of this milestone (0-based, defaults to end of list)',
-                },
-            },
-            required: ['task_id', 'title'],
-        },
-    },
-    {
-        name: 'update_milestone',
-        description: `Update a milestone's title, description, status, or order.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                milestone_id: {
-                    type: 'string',
-                    description: 'Milestone UUID',
-                },
-                title: {
-                    type: 'string',
-                    description: 'Updated title',
-                },
-                description: {
-                    type: 'string',
-                    description: 'Updated description',
-                },
-                status: {
-                    type: 'string',
-                    enum: ['pending', 'in_progress', 'completed'],
-                    description: 'Milestone status',
-                },
-                order_index: {
-                    type: 'number',
-                    minimum: 0,
-                    description: 'Updated order',
-                },
-            },
-            required: ['milestone_id'],
-        },
-    },
-    {
-        name: 'complete_milestone',
-        description: `Mark a milestone as completed. This is a convenience wrapper for update_milestone with status=completed.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                milestone_id: {
-                    type: 'string',
-                    description: 'Milestone UUID',
-                },
-            },
-            required: ['milestone_id'],
-        },
-    },
-    {
-        name: 'delete_milestone',
-        description: `Delete a milestone from a task.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                milestone_id: {
-                    type: 'string',
-                    description: 'Milestone UUID',
-                },
-            },
-            required: ['milestone_id'],
-        },
-    },
-    {
-        name: 'get_milestones',
-        description: `Get all milestones for a task, ordered by order_index.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                task_id: {
-                    type: 'string',
-                    description: 'Task UUID',
-                },
-            },
-            required: ['task_id'],
-        },
-    },
-    // ============================================================================
-    // Bodies of Work Tools
-    // ============================================================================
-    {
-        name: 'create_body_of_work',
-        description: `Create a new body of work to group tasks into phases (pre/core/post).
-Bodies of work allow organizing related tasks with optional auto-deployment on completion.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                title: {
-                    type: 'string',
-                    description: 'Title for the body of work',
-                },
-                description: {
-                    type: 'string',
-                    description: 'Optional description',
-                },
-                auto_deploy_on_completion: {
-                    type: 'boolean',
-                    description: 'Automatically request deployment when all tasks complete (default: false)',
-                },
-                deploy_environment: {
-                    type: 'string',
-                    enum: ['development', 'staging', 'production'],
-                    description: 'Target environment for auto-deploy (default: production)',
-                },
-                deploy_version_bump: {
-                    type: 'string',
-                    enum: ['patch', 'minor', 'major'],
-                    description: 'Version bump for auto-deploy (default: minor)',
-                },
-                deploy_trigger: {
-                    type: 'string',
-                    enum: ['all_completed', 'all_completed_validated'],
-                    description: 'When to trigger auto-deploy: all_completed (immediate) or all_completed_validated (requires validation, default)',
-                },
-            },
-            required: ['project_id', 'title'],
-        },
-    },
-    {
-        name: 'update_body_of_work',
-        description: `Update a body of work's settings.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                body_of_work_id: {
-                    type: 'string',
-                    description: 'Body of work UUID',
-                },
-                title: {
-                    type: 'string',
-                    description: 'Updated title',
-                },
-                description: {
-                    type: 'string',
-                    description: 'Updated description',
-                },
-                auto_deploy_on_completion: {
-                    type: 'boolean',
-                    description: 'Auto-deploy setting',
-                },
-                deploy_environment: {
-                    type: 'string',
-                    enum: ['development', 'staging', 'production'],
-                    description: 'Target environment',
-                },
-                deploy_version_bump: {
-                    type: 'string',
-                    enum: ['patch', 'minor', 'major'],
-                    description: 'Version bump type',
-                },
-                deploy_trigger: {
-                    type: 'string',
-                    enum: ['all_completed', 'all_completed_validated'],
-                    description: 'When to trigger auto-deploy',
-                },
-            },
-            required: ['body_of_work_id'],
-        },
-    },
-    {
-        name: 'get_body_of_work',
-        description: `Get a body of work with all its tasks organized by phase.
-Use summary_only: true to get task counts and next task instead of full task arrays (saves tokens).`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                body_of_work_id: {
-                    type: 'string',
-                    description: 'Body of work UUID',
-                },
-                summary_only: {
-                    type: 'boolean',
-                    description: 'Return task counts and next task instead of full task arrays (default: false)',
-                },
-            },
-            required: ['body_of_work_id'],
-        },
-    },
-    {
-        name: 'get_bodies_of_work',
-        description: `List bodies of work for a project with task counts per phase.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                status: {
-                    type: 'string',
-                    enum: ['draft', 'active', 'completed', 'cancelled'],
-                    description: 'Filter by status (optional)',
-                },
-                limit: {
-                    type: 'number',
-                    description: 'Max number of bodies of work to return (default 50, max 100)',
-                },
-                offset: {
-                    type: 'number',
-                    description: 'Number of items to skip for pagination (default 0)',
-                },
-                search_query: {
-                    type: 'string',
-                    description: 'Search bodies of work by title or description',
-                },
-            },
-            required: ['project_id'],
-        },
-    },
-    {
-        name: 'delete_body_of_work',
-        description: `Delete a body of work. Tasks are preserved but no longer grouped.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                body_of_work_id: {
-                    type: 'string',
-                    description: 'Body of work UUID',
-                },
-            },
-            required: ['body_of_work_id'],
-        },
-    },
-    {
-        name: 'add_task_to_body_of_work',
-        description: `Add a task to a body of work in a specific phase.
-Phases control execution order: pre tasks run first, then core, then post.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                body_of_work_id: {
-                    type: 'string',
-                    description: 'Body of work UUID',
-                },
-                task_id: {
-                    type: 'string',
-                    description: 'Task UUID to add',
-                },
-                phase: {
-                    type: 'string',
-                    enum: ['pre', 'core', 'post'],
-                    description: 'Task phase (default: core)',
-                },
-                order_index: {
-                    type: 'number',
-                    description: 'Order within phase (auto-assigned if not specified)',
-                },
-            },
-            required: ['body_of_work_id', 'task_id'],
-        },
-    },
-    {
-        name: 'remove_task_from_body_of_work',
-        description: `Remove a task from its body of work. The task is preserved.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                task_id: {
-                    type: 'string',
-                    description: 'Task UUID to remove',
-                },
-            },
-            required: ['task_id'],
-        },
-    },
-    {
-        name: 'activate_body_of_work',
-        description: `Activate a draft body of work to start execution.
-Requires at least one task. Once active, tasks can be worked on following phase order.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                body_of_work_id: {
-                    type: 'string',
-                    description: 'Body of work UUID',
-                },
-            },
-            required: ['body_of_work_id'],
-        },
-    },
-    {
-        name: 'add_task_dependency',
-        description: `Add a dependency between tasks in a body of work.
-The dependent task cannot start until the dependency is completed. Prevents circular dependencies.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                body_of_work_id: {
-                    type: 'string',
-                    description: 'Body of work UUID',
-                },
-                task_id: {
-                    type: 'string',
-                    description: 'Task that depends on another task',
-                },
-                depends_on_task_id: {
-                    type: 'string',
-                    description: 'Task that must complete first',
-                },
-            },
-            required: ['body_of_work_id', 'task_id', 'depends_on_task_id'],
-        },
-    },
-    {
-        name: 'remove_task_dependency',
-        description: `Remove a dependency between tasks.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                task_id: {
-                    type: 'string',
-                    description: 'Task UUID',
-                },
-                depends_on_task_id: {
-                    type: 'string',
-                    description: 'Dependency task UUID',
-                },
-            },
-            required: ['task_id', 'depends_on_task_id'],
-        },
-    },
-    {
-        name: 'get_task_dependencies',
-        description: `Get task dependencies for a body of work or specific task.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                body_of_work_id: {
-                    type: 'string',
-                    description: 'Body of work UUID (optional if task_id provided)',
-                },
-                task_id: {
-                    type: 'string',
-                    description: 'Specific task UUID (optional if body_of_work_id provided)',
-                },
-            },
-        },
-    },
-    {
-        name: 'get_next_body_of_work_task',
-        description: `Get the next available task from a body of work.
-Considers phase order (pre → core → post) and task dependencies.
-Only returns tasks where all dependencies are completed.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                body_of_work_id: {
-                    type: 'string',
-                    description: 'Body of work UUID',
-                },
-            },
-            required: ['body_of_work_id'],
-        },
-    },
-    // ============================================================================
-    // Sprint Tools
-    // ============================================================================
-    {
-        name: 'create_sprint',
-        description: `Create a new sprint. Sprints are time-bounded bodies of work with velocity tracking.
-Sprints start in 'planning' status where tasks can be added with story points.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                title: {
-                    type: 'string',
-                    description: 'Sprint title (e.g., "Sprint 5" or "Q1 Release")',
-                },
-                goal: {
-                    type: 'string',
-                    description: 'Sprint goal statement',
-                },
-                start_date: {
-                    type: 'string',
-                    description: 'Start date (YYYY-MM-DD)',
-                },
-                end_date: {
-                    type: 'string',
-                    description: 'End date (YYYY-MM-DD)',
-                },
-                auto_deploy_on_completion: {
-                    type: 'boolean',
-                    description: 'Automatically request deployment when sprint completes (default: false)',
-                },
-                deploy_environment: {
-                    type: 'string',
-                    enum: ['development', 'staging', 'production'],
-                    description: 'Target environment for auto-deploy (default: production)',
-                },
-                deploy_version_bump: {
-                    type: 'string',
-                    enum: ['patch', 'minor', 'major'],
-                    description: 'Version bump for auto-deploy (default: minor)',
-                },
-            },
-            required: ['project_id', 'title', 'start_date', 'end_date'],
-        },
-    },
-    {
-        name: 'update_sprint',
-        description: `Update a sprint's details. Can update title, goal, dates, and deployment settings.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                sprint_id: {
-                    type: 'string',
-                    description: 'Sprint UUID',
-                },
-                title: {
-                    type: 'string',
-                    description: 'New sprint title',
-                },
-                goal: {
-                    type: 'string',
-                    description: 'New sprint goal',
-                },
-                start_date: {
-                    type: 'string',
-                    description: 'New start date (YYYY-MM-DD)',
-                },
-                end_date: {
-                    type: 'string',
-                    description: 'New end date (YYYY-MM-DD)',
-                },
-                auto_deploy_on_completion: {
-                    type: 'boolean',
-                    description: 'Auto-deploy setting',
-                },
-                deploy_environment: {
-                    type: 'string',
-                    enum: ['development', 'staging', 'production'],
-                    description: 'Target environment',
-                },
-                deploy_version_bump: {
-                    type: 'string',
-                    enum: ['patch', 'minor', 'major'],
-                    description: 'Version bump type',
-                },
-            },
-            required: ['sprint_id'],
-        },
-    },
-    {
-        name: 'get_sprint',
-        description: `Get a sprint with all its tasks organized by phase (pre/core/post).
-Includes progress percentage, velocity points, and committed points.
-Use summary_only: true to get task counts and next task instead of full task arrays (saves tokens).`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                sprint_id: {
-                    type: 'string',
-                    description: 'Sprint UUID',
-                },
-                summary_only: {
-                    type: 'boolean',
-                    description: 'Return task counts and next task instead of full task arrays (default: false)',
-                },
-            },
-            required: ['sprint_id'],
-        },
-    },
-    {
-        name: 'get_sprints',
-        description: `List sprints for a project with velocity metrics.
-Returns sprints sorted by sprint_number descending (most recent first).`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                status: {
-                    type: 'string',
-                    enum: ['planning', 'active', 'in_review', 'retrospective', 'completed', 'cancelled'],
-                    description: 'Filter by sprint status (optional)',
-                },
-                limit: {
-                    type: 'number',
-                    description: 'Max sprints to return (default: 20, max: 100)',
-                },
-            },
-            required: ['project_id'],
-        },
-    },
-    {
-        name: 'delete_sprint',
-        description: `Delete a sprint. Tasks are preserved but no longer grouped.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                sprint_id: {
-                    type: 'string',
-                    description: 'Sprint UUID',
-                },
-            },
-            required: ['sprint_id'],
-        },
-    },
-    {
-        name: 'start_sprint',
-        description: `Start a sprint. Transitions from 'planning' to 'active' status.
-Locks the committed_points at the current total story points.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                sprint_id: {
-                    type: 'string',
-                    description: 'Sprint UUID',
-                },
-            },
-            required: ['sprint_id'],
-        },
-    },
-    {
-        name: 'complete_sprint',
-        description: `Complete a sprint. Handles retrospective phase and auto-deployment if configured.
-Status flow: active → in_review → retrospective → completed`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                sprint_id: {
-                    type: 'string',
-                    description: 'Sprint UUID',
-                },
-                retrospective_notes: {
-                    type: 'string',
-                    description: 'Sprint retrospective notes',
-                },
-                skip_retrospective: {
-                    type: 'boolean',
-                    description: 'Skip retrospective phase and go directly to completed (default: false)',
-                },
-            },
-            required: ['sprint_id'],
-        },
-    },
-    {
-        name: 'add_task_to_sprint',
-        description: `Add a task to a sprint with optional story points.
-Tasks can be added during 'planning' status. Story points contribute to committed_points.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                sprint_id: {
-                    type: 'string',
-                    description: 'Sprint UUID',
-                },
-                task_id: {
-                    type: 'string',
-                    description: 'Task UUID to add',
-                },
-                story_points: {
-                    type: 'number',
-                    description: 'Story point estimate (optional, must be non-negative integer)',
-                },
-                phase: {
-                    type: 'string',
-                    enum: ['pre', 'core', 'post'],
-                    description: 'Task phase (default: core)',
-                },
-            },
-            required: ['sprint_id', 'task_id'],
-        },
-    },
-    {
-        name: 'remove_task_from_sprint',
-        description: `Remove a task from a sprint. Task is preserved but returns to backlog.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                sprint_id: {
-                    type: 'string',
-                    description: 'Sprint UUID',
-                },
-                task_id: {
-                    type: 'string',
-                    description: 'Task UUID to remove',
-                },
-            },
-            required: ['sprint_id', 'task_id'],
-        },
-    },
-    {
-        name: 'get_sprint_backlog',
-        description: `Get tasks from backlog/pending that can be added to a sprint.
-Returns tasks not already assigned to any body of work or sprint.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                sprint_id: {
-                    type: 'string',
-                    description: 'Sprint UUID to exclude already-added tasks (optional)',
-                },
-            },
-            required: ['project_id'],
-        },
-    },
-    {
-        name: 'get_sprint_velocity',
-        description: `Get velocity metrics for completed sprints.
-Returns committed vs completed points and average velocity.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                limit: {
-                    type: 'number',
-                    description: 'Number of sprints to analyze (default: 10, max: 50)',
-                },
-            },
-            required: ['project_id'],
-        },
-    },
-    // ============================================================================
-    // Organization Tools
-    // ============================================================================
-    {
-        name: 'list_organizations',
-        description: 'List organizations the current user belongs to.',
-        inputSchema: {
-            type: 'object',
-            properties: {},
-        },
-    },
-    {
-        name: 'create_organization',
-        description: 'Create a new organization. You become the owner.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                name: {
-                    type: 'string',
-                    description: 'Organization display name',
-                },
-                description: {
-                    type: 'string',
-                    description: 'Brief description of the organization',
-                },
-                slug: {
-                    type: 'string',
-                    description: 'URL-friendly identifier (auto-generated from name if not provided)',
-                },
-            },
-            required: ['name'],
-        },
-    },
-    {
-        name: 'update_organization',
-        description: 'Update organization details. Requires admin role.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                organization_id: {
-                    type: 'string',
-                    description: 'Organization UUID',
-                },
-                name: {
-                    type: 'string',
-                    description: 'New organization name',
-                },
-                description: {
-                    type: 'string',
-                    description: 'New description',
-                },
-                logo_url: {
-                    type: 'string',
-                    description: 'URL to organization logo',
-                },
-            },
-            required: ['organization_id'],
-        },
-    },
-    {
-        name: 'delete_organization',
-        description: 'Delete an organization. Requires owner role. Removes all shares.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                organization_id: {
-                    type: 'string',
-                    description: 'Organization UUID',
-                },
-            },
-            required: ['organization_id'],
-        },
-    },
-    {
-        name: 'list_org_members',
-        description: 'List members of an organization.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                organization_id: {
-                    type: 'string',
-                    description: 'Organization UUID',
-                },
-            },
-            required: ['organization_id'],
-        },
-    },
-    {
-        name: 'invite_member',
-        description: 'Invite a user to an organization by email. Requires admin role.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                organization_id: {
-                    type: 'string',
-                    description: 'Organization UUID',
-                },
-                email: {
-                    type: 'string',
-                    description: 'Email address to invite',
-                },
-                role: {
-                    type: 'string',
-                    enum: ['admin', 'member', 'viewer'],
-                    description: 'Role to assign (default: member)',
-                },
-            },
-            required: ['organization_id', 'email'],
-        },
-    },
-    {
-        name: 'update_member_role',
-        description: 'Change a member\'s role. Requires admin role. Cannot change owner.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                organization_id: {
-                    type: 'string',
-                    description: 'Organization UUID',
-                },
-                user_id: {
-                    type: 'string',
-                    description: 'User UUID to update',
-                },
-                role: {
-                    type: 'string',
-                    enum: ['admin', 'member', 'viewer'],
-                    description: 'New role to assign',
-                },
-            },
-            required: ['organization_id', 'user_id', 'role'],
-        },
-    },
-    {
-        name: 'remove_member',
-        description: 'Remove a member from an organization. Requires admin role.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                organization_id: {
-                    type: 'string',
-                    description: 'Organization UUID',
-                },
-                user_id: {
-                    type: 'string',
-                    description: 'User UUID to remove',
-                },
-            },
-            required: ['organization_id', 'user_id'],
-        },
-    },
-    {
-        name: 'leave_organization',
-        description: 'Leave an organization. Owner cannot leave without transferring ownership.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                organization_id: {
-                    type: 'string',
-                    description: 'Organization UUID',
-                },
-            },
-            required: ['organization_id'],
-        },
-    },
-    {
-        name: 'share_project_with_org',
-        description: 'Share a project with an organization. You must own the project.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                organization_id: {
-                    type: 'string',
-                    description: 'Organization UUID to share with',
-                },
-                permission: {
-                    type: 'string',
-                    enum: ['read', 'write', 'admin'],
-                    description: 'Permission level (default: read)',
-                },
-            },
-            required: ['project_id', 'organization_id'],
-        },
-    },
-    {
-        name: 'update_project_share',
-        description: 'Update the permission level for a project share.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                organization_id: {
-                    type: 'string',
-                    description: 'Organization UUID',
-                },
-                permission: {
-                    type: 'string',
-                    enum: ['read', 'write', 'admin'],
-                    description: 'New permission level',
-                },
-            },
-            required: ['project_id', 'organization_id', 'permission'],
-        },
-    },
-    {
-        name: 'unshare_project',
-        description: 'Remove a project share from an organization.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                organization_id: {
-                    type: 'string',
-                    description: 'Organization UUID',
-                },
-            },
-            required: ['project_id', 'organization_id'],
-        },
-    },
-    {
-        name: 'list_project_shares',
-        description: 'List all organizations a project is shared with.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-            },
-            required: ['project_id'],
-        },
-    },
-];
+// Tool definitions imported from tools.ts
 // ============================================================================
 // Tool Handlers
 // ============================================================================