@vibescope/mcp-server 0.3.13 → 0.3.14

package/src/handlers/tool-docs.ts

@@ -1106,4 +1106,386 @@ Query aggregated project knowledge in a single call. Reduces token usage by comb
 **Token savings:** Replaces multiple tool calls (get_findings, get_decisions, get_blockers, etc.) with one call.
 
 **Example:** query_knowledge_base(project_id, categories: ["findings", "decisions"], limit: 10)`,
+
+	// Session tools (additional)
+	report_token_usage: `# report_token_usage
+Report actual token usage from Claude API responses.
+
+**Parameters:**
+- session_id (optional): Session UUID (uses current session if not provided)
+- input_tokens (required): Number of input tokens
+- output_tokens (required): Number of output tokens
+- model (optional): Model used (e.g., "claude-3-opus")
+
+**Returns:** Updated token usage summary`,
+
+	signal_idle: `# signal_idle
+Signal that the agent is idle and available for work.
+
+**Parameters:**
+- session_id (optional): Session UUID (uses current session if not provided)
+
+**Returns:** Idle status confirmation, may include suggested activities`,
+
+	confirm_agent_setup: `# confirm_agent_setup
+Confirm that agent setup is complete after following setup instructions.
+
+**Parameters:**
+- project_id (required): Project UUID
+- agent_type (required): Type of agent (e.g., "claude", "gemini")
+
+**Returns:** Setup confirmation status`,
+
+	// Project tools (additional)
+	get_project_summary: `# get_project_summary
+Get unified project statistics overview in a single call.
+
+**Parameters:**
+- project_id (required): Project UUID
+
+**Returns:** Task counts, blocker counts, finding counts, decision counts, and more`,
+
+	// Blocker tools (additional)
+	get_blocker: `# get_blocker
+Get a single blocker by ID.
+
+**Parameters:**
+- blocker_id (required): Blocker UUID
+
+**Returns:** Blocker details including description, status, resolution`,
+
+	get_blockers_stats: `# get_blockers_stats
+Get aggregate blocker statistics.
+
+**Parameters:**
+- project_id (required): Project UUID
+
+**Returns:** Open/resolved counts, breakdown by age`,
+
+	// Decision tools (additional)
+	get_decision: `# get_decision
+Get a single decision by ID.
+
+**Parameters:**
+- decision_id (required): Decision UUID
+
+**Returns:** Decision details including title, description, rationale`,
+
+	get_decisions_stats: `# get_decisions_stats
+Get aggregate decision statistics.
+
+**Parameters:**
+- project_id (required): Project UUID
+
+**Returns:** Total count, recent decisions count`,
+
+	// Idea tools (additional)
+	get_idea: `# get_idea
+Get a single idea by ID.
+
+**Parameters:**
+- idea_id (required): Idea UUID
+
+**Returns:** Idea details including title, description, status`,
+
+	// Finding tools (additional)
+	get_finding: `# get_finding
+Get a single finding by ID.
+
+**Parameters:**
+- finding_id (required): Finding UUID
+
+**Returns:** Finding details including title, category, severity, status`,
+
+	get_findings_stats: `# get_findings_stats
+Get aggregate finding statistics.
+
+**Parameters:**
+- project_id (required): Project UUID
+
+**Returns:** Counts by category, severity, and status`,
+
+	// Deployment tools (additional)
+	get_deployment_requirements_stats: `# get_deployment_requirements_stats
+Get aggregate deployment requirement statistics.
+
+**Parameters:**
+- project_id (required): Project UUID
+
+**Returns:** Counts by stage and status`,
+
+	// Worktree tools
+	get_stale_worktrees: `# get_stale_worktrees
+Find orphaned worktrees that need cleanup.
+
+**Parameters:**
+- project_id (required): Project UUID
+- hostname (optional): Filter to worktrees created on this machine
+
+**Returns:** List of stale worktrees with task info and cleanup commands`,
+
+	clear_worktree_path: `# clear_worktree_path
+Clear worktree path from a task after cleanup.
+
+**Parameters:**
+- task_id (required): Task UUID
+
+**Note:** Call this AFTER running git worktree remove`,
+
+	// Role tools
+	get_role_settings: `# get_role_settings
+Get project role settings and configuration.
+
+**Parameters:**
+- project_id (required): Project UUID
+
+**Returns:** Role configuration including allowed roles, default role`,
+
+	update_role_settings: `# update_role_settings
+Configure project role behavior.
+
+**Parameters:**
+- project_id (required): Project UUID
+- default_role (optional): Default role for new sessions
+- allowed_roles (optional): Array of allowed role names
+
+**Returns:** Updated role settings`,
+
+	set_session_role: `# set_session_role
+Set the role for the current session.
+
+**Parameters:**
+- session_id (optional): Session UUID (uses current session)
+- role (required): Role name (e.g., "developer", "validator", "deployer")
+
+**Returns:** Updated session with new role`,
+
+	get_agents_by_role: `# get_agents_by_role
+List active agents grouped by role.
+
+**Parameters:**
+- project_id (required): Project UUID
+
+**Returns:** Agents organized by role`,
+
+	// File checkout/lock tools
+	checkout_file: `# checkout_file
+Lock a file for editing to prevent conflicts with other agents.
+
+**Parameters:**
+- project_id (required): Project UUID
+- file_path (required): Path to the file to lock
+- reason (optional): Why you need to edit this file
+
+**Returns:** Checkout confirmation with expiry time`,
+
+	checkin_file: `# checkin_file
+Release a file lock after editing.
+
+**Parameters:**
+- project_id (required): Project UUID
+- file_path (required): Path to the file to release
+
+**Returns:** Checkin confirmation`,
+
+	get_file_checkouts: `# get_file_checkouts
+List current file locks.
+
+**Parameters:**
+- project_id (required): Project UUID
+- file_path (optional): Filter to specific file
+
+**Returns:** List of active file checkouts`,
+
+	get_file_checkouts_stats: `# get_file_checkouts_stats
+Get file checkout statistics.
+
+**Parameters:**
+- project_id (required): Project UUID
+
+**Returns:** Active checkout count, breakdown by agent`,
+
+	abandon_checkout: `# abandon_checkout
+Force-release a file lock (use with caution).
+
+**Parameters:**
+- project_id (required): Project UUID
+- file_path (required): Path to the file to release
+
+**Note:** Only use when the original agent is unreachable`,
+
+	is_file_available: `# is_file_available
+Check if a file is available for checkout.
+
+**Parameters:**
+- project_id (required): Project UUID
+- file_path (required): Path to check
+
+**Returns:** Availability status, current holder if locked`,
+
+	// Connector tools
+	get_connectors: `# get_connectors
+List project connectors (integrations).
+
+**Parameters:**
+- project_id (required): Project UUID
+
+**Returns:** Array of configured connectors`,
+
+	get_connector: `# get_connector
+Get connector details.
+
+**Parameters:**
+- connector_id (required): Connector UUID
+
+**Returns:** Connector configuration and status`,
+
+	add_connector: `# add_connector
+Create a new external integration connector.
+
+**Parameters:**
+- project_id (required): Project UUID
+- type (required): Connector type (webhook, slack, discord, etc.)
+- name (required): Display name
+- config (required): Type-specific configuration
+
+**Returns:** Created connector details`,
+
+	update_connector: `# update_connector
+Update connector configuration.
+
+**Parameters:**
+- connector_id (required): Connector UUID
+- name (optional): New display name
+- config (optional): Updated configuration
+- enabled (optional): Enable/disable connector
+
+**Returns:** Updated connector details`,
+
+	delete_connector: `# delete_connector
+Remove a connector.
+
+**Parameters:**
+- connector_id (required): Connector UUID
+
+**Returns:** Deletion confirmation`,
+
+	test_connector: `# test_connector
+Send a test event to verify connector configuration.
+
+**Parameters:**
+- connector_id (required): Connector UUID
+
+**Returns:** Test result with success/failure details`,
+
+	get_connector_events: `# get_connector_events
+Get event history for a connector.
+
+**Parameters:**
+- connector_id (required): Connector UUID
+- limit (optional): Max events to return (default: 50)
+
+**Returns:** Array of sent events with status`,
+
+	// Cloud agent tools
+	update_agent_status: `# update_agent_status
+Update your status message on the dashboard. Call this after start_work_session and whenever you start a new task.
+
+**Parameters:**
+- status_message (required): Status text shown on dashboard (e.g. "Working on: Task title")
+- agent_name (required): Your agent name
+- project_id (required): Project UUID
+
+**Example:** update_agent_status(status_message: "Working on: Progress Report Modal", agent_name: "Leon", project_id: "...")`,
+
+	cleanup_stale_cloud_agents: `# cleanup_stale_cloud_agents
+Clean up stale cloud agents that failed to start or lost connection.
+
+**Parameters:**
+- project_id (required): Project UUID
+- stale_minutes (optional): Minutes of inactivity before considered stale (default: 5)
+- include_running (optional): Include running agents in cleanup (default: false)
+- dry_run (optional): Preview what would be cleaned without actually cleaning (default: false)
+
+**Returns:**
+- cleaned: Number of agents cleaned up
+- failed: Number of cleanup failures
+- agents: Array of affected agents with status
+
+**Example:** cleanup_stale_cloud_agents(project_id, stale_minutes: 10, dry_run: true)`,
+
+	list_cloud_agents: `# list_cloud_agents
+List cloud agents for a project with optional status filter.
+
+**Parameters:**
+- project_id (required): Project UUID
+- status (optional): Filter by status - starting, running, stopped, failed, or all (default: all)
+
+**Returns:**
+- agents: Array of agents with id, name, status, created_at, last_heartbeat, public_ip, ecs_task_id
+- count: Total number of agents returned
+
+**Example:** list_cloud_agents(project_id, status: "running")`,
+
+	// Chat tools
+	send_project_message: `# send_project_message
+Send a message to the project chat channel for agent and user communication.
+
+**Parameters:**
+- project_id (required): Project UUID
+- message (required): Message content to send
+- author_name (optional): Name of the message sender (defaults to session persona)
+
+**Returns:**
+- message_id: UUID of the sent message
+- timestamp: When the message was sent
+
+**Example:** send_project_message(project_id: "123e4567-e89b-12d3-a456-426614174000", message: "Deployment completed successfully")`,
+
+	get_project_messages: `# get_project_messages
+Read recent project chat messages to stay informed about project communication.
+
+**Parameters:**
+- project_id (required): Project UUID
+- limit (optional): Number of recent messages to retrieve (default: 20, max: 100)
+- since (optional): ISO timestamp to get messages after this time
+
+**Returns:**
+- messages: Array of messages with id, author_name, message, timestamp
+- count: Number of messages returned
+
+**Example:** get_project_messages(project_id: "123e4567-e89b-12d3-a456-426614174000", limit: 10)`,
+
+	// Version management tools  
+	check_mcp_version: `# check_mcp_version
+Check for available MCP server updates and version information.
+
+**Parameters:**
+- check_remote (optional): Whether to check remote registry for updates (default: true)
+
+**Returns:**
+- current_version: Currently running MCP server version
+- latest_version: Latest available version (if check_remote is true)
+- update_available: Boolean indicating if an update is available
+- release_notes: Summary of changes in latest version (if available)
+
+**Example:** check_mcp_version(check_remote: true)`,
+
+	update_mcp_server: `# update_mcp_server
+Self-update the MCP server to the latest available version.
+
+**Parameters:**
+- version (optional): Specific version to update to (defaults to latest)
+- restart_after_update (optional): Whether to restart after update (default: true)
+- backup_config (optional): Whether to backup current config (default: true)
+
+**Returns:**
+- success: Boolean indicating if update succeeded
+- old_version: Previous version before update
+- new_version: Version after update
+- restart_required: Whether manual restart is needed
+
+**Example:** update_mcp_server()
+
+**Note:** This operation may temporarily disconnect active sessions during restart.`,
 };