mcp

var ErrorHintRegistry = map[string][]ErrorHint{
	"repository": {
		{
			Original:   "Could not resolve to a Repository",
			Suggestion: "Check the owner/repo spelling. Ensure the repository exists and you have access. Tip: Use the exact format 'owner/repo' (e.g., 'mmornati/leanproxy-mcp').",
			Action:     "check_repo",
			Reference:  "https://docs.github.com/en/github/finding-open-source-projects-on-github",
		},
	},
	"not running": {
		{
			Original:   "is not running",
			Suggestion: "The MCP server is not running. Run 'leanproxy server start <server_name>' or check server status with 'leanproxy status'.",
			Action:     "restart_server",
		},
	},
	"not healthy": {
		{
			Original:   "not healthy",
			Suggestion: "The server is in an error state. Check 'leanproxy-mcp status --running' for details. The server will automatically restart on the next request.",
			Action:     "restart_server",
		},
	},
	"server not available": {
		{
			Original:   "server not available",
			Suggestion: "The server crashed or failed to start. Check the logs at /tmp/leanproxy.log for error details. The server will attempt to restart automatically.",
			Action:     "check_logs",
		},
	},
	"signal: killed": {
		{
			Original:   "signal: killed",
			Suggestion: "The server process was killed (likely by the system or OOM). Check /tmp/leanproxy.log for more details. Auto-restart will attempt recovery.",
			Action:     "check_logs",
		},
	},
	"command not found": {
		{
			Original:   "command not found",
			Suggestion: "The server command (e.g., npx, uv) is not installed or not in PATH. Check your configuration and install the required dependencies.",
			Action:     "check_dependencies",
		},
	},
	"failed": {
		{
			Original:   "server error",
			Suggestion: "The remote server encountered an error. Try again in a few moments, or check the server logs for more details.",
			Action:     "retry",
		},
	},
	"not authenticated": {
		{
			Original:   "not authenticated",
			Suggestion: "Authentication required. Check your credentials configuration for this server.",
			Action:     "check_auth",
		},
		{
			Original:   "401",
			Suggestion: "Authentication failed. Verify your API token or credentials are correct.",
			Action:     "check_auth",
		},
	},
	"forbidden": {
		{
			Original:   "403",
			Suggestion: "Access denied. You may not have permission for this operation. Check your API token scopes.",
			Action:     "check_permissions",
		},
		{
			Original:   "permission denied",
			Suggestion: "Insufficient permissions. Verify your account has the required access rights.",
			Action:     "check_permissions",
		},
	},
	"not found": {
		{
			Original:   "404",
			Suggestion: "The requested resource was not found. Check if the resource exists and the URL is correct.",
			Action:     "verify_resource",
		},
	},
	"rate limited": {
		{
			Original:   "429",
			Suggestion: "Rate limit exceeded. Wait a moment before retrying, or check if you need to configure rate limiting.",
			Action:     "wait_retry",
		},
		{
			Original:   "rate limit",
			Suggestion: "Too many requests. Consider adding a delay between requests or reducing request frequency.",
			Action:     "wait_retry",
		},
	},
	"timeout": {
		{
			Original:   "timeout",
			Suggestion: "The request timed out. The server may be slow or unavailable. Try again or increase timeout settings.",
			Action:     "retry",
		},
		{
			Original:   "context deadline exceeded",
			Suggestion: "The request took too long. Try again or check if the server is experiencing issues.",
			Action:     "retry",
		},
	},
	"invalid params": {
		{
			Original:   "invalid params",
			Suggestion: "Check the parameter names and types. Use list_servers to get servers, then list_tools to see available parameters.",
			Action:     "check_params",
		},
		{
			Original:   "missing",
			Suggestion: "A required parameter is missing. Use list_servers to get servers, then list_tools to see required parameters.",
			Action:     "check_params",
		},
	},
	"connection refused": {
		{
			Original:   "connection refused",
			Suggestion: "Cannot connect to the server. Verify the server is running and the connection settings are correct.",
			Action:     "check_server",
		},
	},
	"tool not found": {
		{
			Original:   "tool not found",
			Suggestion: "The tool doesn't exist on this server. Use list_servers to get servers, then list_tools to discover available tools.",
			Action:     "list_tools",
		},
	},
}

var InvokeToolParamDefaults = map[string]interface{}{}

var InvokeToolParamMeta = map[string]ParameterMeta{
	"server": {
		Required:    true,
		Description: "Server name from list_servers (e.g., 'github', 'garmin', 'filesystem'). Must be a configured and running MCP server.",
	},
	"tool": {
		Required:    true,
		Description: "Tool name from list_tools (e.g., 'list_issues', 'get_activities'). Do NOT prefix with server name.",
	},
	"arguments": {
		Required:    false,
		Description: "Tool arguments as key-value pairs. Refer to list_tools output for available parameters. Pass empty object {} if no arguments needed.",
	},
}

var LeanproxyTools = []ToolDefinition{
	{
		Name:        "list_tools",
		Description: "List all tools available on a specific MCP server. **IMPORTANT:** Always call list_servers first to get available server names, then use this tool to see tools on a specific server.",
		Categories:  []string{"discovery", "meta"},
		Examples: []ToolExample{
			{
				Input: map[string]interface{}{
					"server_name": "github",
				},
				Description: "List all tools available on the github server",
			},
			{
				Input: map[string]interface{}{
					"server_name": "garmin",
				},
				Description: "List all tools available on the garmin server",
			},
			{
				Input: map[string]interface{}{
					"server_name":           "github",
					"max_description_chars": 150,
				},
				Description: "List github tools with shorter descriptions",
			},
		},
		Returns: ReturnSchema{
			Type:        "object",
			Description: "Returns a content block with formatted tool list for the specified server",
			Fields: []FieldDescription{
				{Name: "content", Type: "array", Desc: "Array of text content blocks"},
			},
		},
		InputSchema: json.RawMessage(`{
			"type": "object",
			"properties": {
				"server_name": {
					"type": "string",
					"description": "MCP server name (from list_servers). Required - identifies which server's tools to list."
				},
				"max_description_chars": {
					"type": "number",
					"description": "Maximum characters for tool descriptions (default: 200, min: 50, max: 500)",
					"default": 200
				}
			},
			"required": ["server_name"]
		}`),
	},
	{
		Name:        "invoke_tool",
		Description: "Invoke a tool on a configured MCP server. **Required:** First use list_servers to get server names, then use list_tools to discover available tools on that server.",
		Categories:  []string{"execution", "meta"},
		Examples: []ToolExample{
			{
				Input: map[string]interface{}{
					"server": "github",
					"tool":   "list_issues",
					"arguments": map[string]interface{}{
						"owner":   "mmornati",
						"repo":    "leanproxy-mcp",
						"state":   "open",
						"perPage": 10,
					},
				},
				Description: "List open issues on leanproxy-mcp repository",
			},
			{
				Input: map[string]interface{}{
					"server": "github",
					"tool":   "search_issues",
					"arguments": map[string]interface{}{
						"query":   "is:issue is:open label:bug",
						"owner":   "mmornati",
						"repo":    "leanproxy-mcp",
						"perPage": 5,
					},
				},
				Description: "Search for open bug issues",
			},
		},
		Returns: ReturnSchema{
			Type:        "object",
			Description: "Returns the result from the remote MCP tool invocation",
			Fields: []FieldDescription{
				{Name: "content", Type: "array", Desc: "Array of content blocks from tool"},
			},
		},
		InputSchema: json.RawMessage(`{
			"type": "object",
			"properties": {
				"server": {
					"type": "string",
					"description": "Server name from list_servers (e.g., 'github', 'garmin', 'filesystem'). Must be a configured MCP server."
				},
				"tool": {
					"type": "string",
					"description": "Tool name from list_tools (e.g., 'list_issues', 'get_activities'). Do NOT prefix with server name."
				},
				"arguments": {
					"type": "object",
					"description": "Tool arguments as key-value pairs. Refer to list_tools output for available parameters."
				}
			},
			"required": ["server", "tool"],
			"additionalProperties": false
		}`),
	},
}

var ListToolsParamDefaults = map[string]interface{}{
	"max_description_chars": 200,
}

var ListToolsParamMeta = map[string]ParameterMeta{
	"server_name": {
		Required:        true,
		Default:         nil,
		Description:     "MCP server name (from list_servers). Required - identifies which server's tools to list.",
		SuggestedValues: []string{"github", "garmin", "filesystem", "intervals"},
	},
	"max_description_chars": {
		Required:    false,
		Default:     200,
		Min:         50,
		Max:         500,
		Description: "Maximum characters for tool descriptions. Default: 200. Range: 50-500.",
	},
}