BEACON

{
  "name": "BEACON",
  "description": "Human feedback endpoint for software agents: a private REST conversation with a human operator. No reply and no response time are guaranteed. Limited public pilot of BEACON with one human operator. No reply, response time or continuous availability is guaranteed. Send one text message per request to reach the human operator. A human may or may not reply and no reply time is guaranteed; a returned task in TASK_STATE_WORKING is a storage receipt, not a reply. Only non-blocking sends are accepted (configuration.returnImmediately=true); poll GetTask. Task metadata beacon.status_url also provides public state and human_reply_available without a token; poll every next_poll_after_seconds, then read GetTask with your access token. Automatic storage acknowledgements are labeled system_template/recorded and author=system; they are not human replies. The first message needs the credential-handoff extension; later messages need a Bearer access token from the RFC 8693 token exchange. Closing, withdrawal and deletion requests use the REST API.",
  "supportedInterfaces": [
    {
      "url": "https://beacon.methodfield.com/a2a",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    }
  ],
  "provider": {
    "url": "https://beacon.methodfield.com",
    "organization": "BEACON operator"
  },
  "version": "0.6.0-stage8",
  "documentationUrl": "https://beacon.methodfield.com/docs",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "extensions": [
      {
        "uri": "https://beacon.methodfield.com/ext/credential-handoff/v1",
        "description": "First contact without exposing the conversation credential: put {\"code_challenge\": BASE64URL(SHA-256(verifier)), \"code_challenge_method\": \"S256\"} in message.metadata under this URI and list it in A2A-Extensions; then redeem the verifier at the token endpoint (RFC 8693, subject_token_type handoff-verifier, requested_token_type session-token) within 300 s.",
        "params": {
          "token_endpoint": "https://beacon.methodfield.com/oauth/token",
          "code_challenge_method": "S256",
          "requested_token_type": "urn:beacon:params:oauth:token-type:session-token"
        }
      }
    ],
    "extendedAgentCard": false
  },
  "securitySchemes": {
    "beaconAccessToken": {
      "httpAuthSecurityScheme": {
        "description": "Bearer access token for https://beacon.methodfield.com/a2a, obtained by exchanging the conversation session token at https://beacon.methodfield.com/oauth/token (RFC 8693, resource=https://beacon.methodfield.com/a2a). Required for every request except the first message.",
        "scheme": "Bearer",
        "bearerFormat": "opaque (bat_\u2026)"
      }
    }
  },
  "defaultInputModes": [
    "text/plain"
  ],
  "defaultOutputModes": [
    "text/plain"
  ],
  "skills": [
    {
      "id": "contact_human",
      "name": "Contact a human operator",
      "description": "A private conversation with the human operator of this BEACON. Replies are written by a person, may never come and are shown in the task history as ROLE_AGENT messages with metadata author=human; the task is TASK_STATE_INPUT_REQUIRED after a human reply and TASK_STATE_WORKING while waiting.",
      "tags": [
        "human-in-the-loop",
        "private-conversation",
        "contact"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "text/plain"
      ]
    }
  ]
}