{
  "name": "submit_agent_feedback",
  "description": "Submit structured feedback about this app from an AI agent perspective. Use after attempting a task — flag confusion, bugs, suggestions, or praise. Feedback is private to the app owner.",
  "input_schema": {
    "type": "object",
    "properties": {
      "kind": {
        "type": "string",
        "enum": [
          "confusion",
          "bug",
          "suggestion",
          "praise"
        ],
        "description": "Category of feedback."
      },
      "message": {
        "type": "string",
        "maxLength": 4096,
        "description": "Free-text feedback. Be specific. Reference selectors when possible."
      },
      "tag": {
        "type": "string",
        "description": "Optional — the platform-* element this feedback is about."
      },
      "context": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string"
          },
          "selector": {
            "type": "string"
          }
        }
      },
      "agent": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "version": {
            "type": "string"
          }
        }
      }
    },
    "required": [
      "kind",
      "message"
    ]
  },
  "endpoint": {
    "method": "POST",
    "url": "__AGENT_FEEDBACK_ENDPOINT__",
    "contentType": "application/json"
  }
}