agentready.gh.miniasp.com

{
  "name": "get_page_context",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get a semantic summary of the current page: title, headings, regions, available actions overview, and forms. Call this first to orient.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/"
}

{
  "name": "find_on_page",
  "kind": "answer",
  "impl": "imperative",
  "description": "Search the page for a keyword or description. Matches interactive elements (buttons, links, fields) AND visible page text (paragraphs, headings, tables, lists), in any language including Chinese/Japanese/Korean. Interactive hits return refs for read_target / activate_target / set_field; text hits return a snippet (call read_target with its ref for the surrounding content). kind: \"any\" (default) | \"action\" (buttons, links, tabs) | \"field\" (inputs, selects) | \"text\" (page content only). If nothing",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Keyword(s) or a short description, e.g. \"Add to cart for MacBook Pro\", \"三年保固\". Prefer distinctive words as they appear on the page."
      },
      "kind": {
        "type": "string",
        "enum": [
          "any",
          "action",
          "field",
          "text"
        ],
        "description": "Limit result kinds"
      }
    },
    "required": [
      "query"
    ]
  },
  "page": "/"
}

{
  "name": "read_target",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read details of one element by semantic ref: current value, options, link target, or surrounding content.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "ref": {
        "type": "string",
        "description": "Ref from find_on_page"
      }
    },
    "required": [
      "ref"
    ]
  },
  "page": "/"
}

{
  "name": "activate_target",
  "kind": "act",
  "impl": "imperative",
  "description": "Activate a page element by ref: click buttons, links, tabs, toggles. Consequential actions (submit, pay, delete) require user approval in the on-page panel.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "ref": {
        "type": "string",
        "description": "Ref from find_on_page"
      }
    },
    "required": [
      "ref"
    ]
  },
  "page": "/"
}

{
  "name": "set_field",
  "kind": "act",
  "impl": "imperative",
  "description": "Set one form field by ref: text inputs, textarea, select, checkbox, radio.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "ref": {
        "type": "string",
        "description": "Ref from find_on_page"
      },
      "value": {
        "type": "string",
        "description": "New value (for checkbox: \"true\"/\"false\")"
      }
    },
    "required": [
      "ref",
      "value"
    ]
  },
  "page": "/"
}

{
  "name": "fill_form",
  "kind": "act",
  "impl": "imperative",
  "description": "Fill a form in one call. Fields are matched by human-readable label or name. Sensitive fields (passwords, payment) are refused. Never submits the form.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "ref": {
        "type": "string",
        "description": "Ref of the form or any field inside it (from find_on_page)"
      },
      "values": {
        "type": "object",
        "description": "Map of field name/label to value, e.g. {\"Email\": \"a@b.c\", \"Quantity\": \"2\"}"
      }
    },
    "required": [
      "ref",
      "values"
    ]
  },
  "page": "/"
}

{
  "name": "submit_form",
  "kind": "transact",
  "impl": "imperative",
  "description": "Submit a form after review. Always requires explicit human approval via the on-page panel. Use fill_form first, then submit_form with the form ref.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "ref": {
        "type": "string",
        "description": "Ref of the form or any field inside it"
      },
      "summary": {
        "type": "string",
        "description": "Short human-readable summary of what will be submitted"
      }
    },
    "required": [
      "ref",
      "summary"
    ]
  },
  "page": "/"
}

{
  "name": "get_install_snippet",
  "kind": "answer",
  "impl": "imperative",
  "description": "Return the exact <script> tag that adds AgentReady.js to a website, plus the npm install command.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/"
}

{
  "name": "go_to_section",
  "kind": "act",
  "impl": "imperative",
  "description": "Scroll this page to a named section. Sections: why, how, tools, levels, safety, live, compat, start.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "section": {
        "type": "string",
        "enum": [
          "why",
          "how",
          "tools",
          "levels",
          "safety",
          "live",
          "compat",
          "start"
        ],
        "description": "Section id to scroll to"
      }
    },
    "required": [
      "section"
    ]
  },
  "page": "/"
}

{
  "name": "product_search",
  "kind": "act",
  "impl": "imperative",
  "description": "Search: fill the search fields (Search products, Category, Max price) and run the search. Runs the search immediately.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "q": {
        "type": "string",
        "description": "Search products. placeholder: Search the catalog…"
      },
      "category": {
        "type": "string",
        "description": "Category",
        "enum": [
          "All categories",
          "Keyboards",
          "Mice",
          "Monitors",
          "Audio"
        ]
      },
      "max_price": {
        "type": "number",
        "description": "Max price",
        "minimum": 0,
        "maximum": 2000
      }
    },
    "additionalProperties": false
  },
  "page": "/demo/store/"
}