dox402.com

{
  "name": "connect_wallet",
  "kind": "act",
  "impl": "imperative",
  "description": "Opens the user's browser wallet to sign in to dox402 via SIWE (EIP-4361). The user must approve the signature in their wallet popup. Required before using balance, history, inference, or deposit tools.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "get_balance",
  "kind": "answer",
  "impl": "imperative",
  "description": "Returns the signed-in user's current token balance on dox402 (1 USDC = 1,000,000 tokens). Read-only.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "send_inference",
  "kind": "transact",
  "impl": "imperative",
  "description": "Sends a prompt to a Cloudflare Workers AI model through dox402 and returns the response. Debits the user's pre-funded token balance based on input/output tokens. Requires connect_wallet and a positive balance. Does NOT trigger any on-chain transaction.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "prompt": {
        "type": "string",
        "description": "The user prompt to send to the model."
      },
      "model": {
        "type": "string",
        "description": "Optional Workers AI model id (e.g. \"@cf/meta/llama-3.1-8b-instruct\"). Defaults to the UI-selected model."
      },
      "systemPrompt": {
        "type": "string",
        "description": "Optional system prompt to prepend."
      },
      "useRag": {
        "type": "boolean",
        "description": "If true and documents are uploaded, retrieve relevant chunks and inject them. Defaults to the UI toggle state."
      }
    },
    "required": [
      "prompt"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "view_history",
  "kind": "answer",
  "impl": "imperative",
  "description": "Returns the signed-in user's saved conversation history on dox402 as an ordered list of { role, content } messages. Read-only.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "open_deposit_ui",
  "kind": "act",
  "impl": "imperative",
  "description": "Opens the dox402 top-up panel so the user can deposit USDC to buy tokens. This tool does NOT send any transaction and does NOT sign anything; the user must select an amount and click the button, then approve the USDC transfer in their wallet. Use this when the user's balance is too low to run inference.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "suggestedUsdc": {
        "type": "number",
        "minimum": 0.001,
        "description": "Optional hint — pre-fills the custom amount field in USDC. The user still must confirm and sign."
      }
    },
    "additionalProperties": false
  },
  "page": "/"
}