// Proposal: MCP Enhanced Tool Spec
{
  name: string;          // Unique identifier for the tool
  description?: string;  // Human-readable description
  inputSchema: {         // JSON Schema for the tool's parameters
    type: "object",
    properties: { ... }  // Tool-specific parameters
  },
  outputSchema?: {         // JSON Schema for the tool's response
    type: "object",
    properties: { ... }    // Tool-specific parameters
  },
  annotations?: {        // Optional hints about tool behavior
    title?: string;      // Human-readable title for the tool
    readOnlyHint?: boolean;    // If true, the tool does not modify its environment
    destructiveHint?: boolean; // If true, the tool may perform destructive updates
    idempotentHint?: boolean;  // If true, repeated calls with same args have no additional effect
    openWorldHint?: boolean;   // If true, tool interacts with external entities
  },
  dependencies?: {
    requires: string[];  // List of tool names that must run before this one
    bindings: {
      [inputField: string]: {
        fromTool: string;      // Tool name
        outputPath: string;    // access output value from tool
      };
    };
  },
  ui?: {
    [variant: string]: {
      label?: string;
      type: string;                      // e.g., "VerticalLayout", "HorizontalLayout", etc.
      elements: { [key: string]: any }   // UI hints for form rendering
    };
  }
}

{
  "tools": [
    {
      "name": "perplexity_ask",
      "description": "Engages in a conversation using the Sonar API. Accepts an array of messages (each with a role and content) and returns an ask completion response from the Perplexity model.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "messages": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "role": {
                  "type": "string",
                  "description": "Role of the message (e.g., system, user, assistant)",
                  "enum": ["system", "user", "assistant"]
                },
                "content": {
                  "type": "string",
                  "description": "The content of the message"
                }
              },
              "required": ["role", "content"]
            },
            "description": "Array of conversation messages"
          }
        },
        "required": ["messages"]
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "response": {
            "type": "string",
            "description": "Completion response from the Perplexity Ask model"
          }
        },
        "required": ["response"]
      },
      "annotations": {
        "title": "Perplexity Ask Tool",
        "readOnlyHint": true
      },
      "dependencies": {
        "requires": ["perplexity_research"],
        "bindings": {
          "messages[0].content": {
            "fromTool": "perplexity_research",
            "outputPath": "system_response"
          }
        }
      },
      "ui": {
        "type": "VerticalLayout",
        "elements": [
          {
            "type": "Control",
            "label": "Role",
            "scope": "#/items/properties/role",
            "options": {
              "enum": ["system", "user", "assistant"]
            }
          },
          {
            "type": "Control",
            "label": "Content",
            "scope": "#/items/properties/content"
          },
          {
            "type": "Button",
            "label": "Run Ask",
            "data": {
              "scope": "#"
            }
          }
        ]
      }
    },
    {
      "name": "perplexity_research",
      "description": "Performs deep research using the Perplexity API. Accepts an array of messages (each with a role and content) and returns a comprehensive research response with citations.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "messages": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "role": {
                  "type": "string",
                  "description": "Role of the message (e.g., system, user, assistant)",
                  "enum": ["system", "user", "assistant"]
                },
                "content": {
                  "type": "string",
                  "description": "The content of the message"
                }
              },
              "required": ["role", "content"]
            },
            "description": "Array of conversation messages"
          }
        },
        "required": ["messages"]
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "system_response": {
            "type": "string",
            "description": "Research response with citations"
          }
        },
        "required": ["system_response"]
      },
      "annotations": {
        "title": "Perplexity Research Tool",
        "readOnlyHint": true
      },
      "ui": {
        "type": "VerticalLayout",
        "elements": [
          {
            "type": "Control",
            "label": "Role",
            "scope": "#/items/properties/role",
            "options": {
              "enum": ["system", "user", "assistant"]
            }
          },
          {
            "type": "Control",
            "label": "Content",
            "scope": "#/items/properties/content"
          },
          {
            "type": "Button",
            "label": "Run Research",
            "data": {
              "scope": "#"
            }
          }
        ]
      }
    }
  ]
}