Discovery

Capabilities in the `discovery` group, auto-generated from defineCapability() declarations.

Discovery

GET /.well-known/agent-card.json

A2A v1.0 agent card — capability discovery for A2A-aware peers and frontier models

Capability ID: discovery.agent_card Auth: none

Request schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Response schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "propertyNames": {
    "type": "string"
  },
  "additionalProperties": {}
}

Examples

agent-card

Request:

{}

Response:

{
  "protocolVersion": "1.0",
  "name": "BrainstormRouter",
  "skills": []
}

---

GET /v1/capabilities/{capability_id}/describe

Behavior block for one capability — effects, cost shape, security profile, composition, recovery vocabulary

Capability ID: discovery.capability.describe Auth: none

Request schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "capability_id": {
      "type": "string",
      "minLength": 1,
      "description": "Dotted capability id (e.g. `intelligence.estimate`, `completions.create`)"
    }
  },
  "required": ["capability_id"],
  "additionalProperties": false
}

Response schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "propertyNames": {
    "type": "string"
  },
  "additionalProperties": {}
}

Examples

describe-intelligence-estimate

Request:

{
  "capability_id": "intelligence.estimate"
}

Response:

{
  "capability_id": "intelligence.estimate",
  "summary": "Predict per-model cost for a completion request (no provider calls)",
  "protocols": {
    "rest": {
      "method": "POST",
      "path": "/v1/estimate"
    }
  },
  "behavior": {}
}

---

GET /

Arrival manifest — one document a frontier model reads to understand what BR does and how to use it

Capability ID: discovery.root_manifest Auth: none

Request schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Response schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "propertyNames": {
    "type": "string"
  },
  "additionalProperties": {}
}

Examples

arrival

Request:

{}

Response:

{
  "product": "BrainstormRouter",
  "version": "0.3",
  "posture_summary": {
    "models_online": 31,
    "providers_online": 8
  }
}

---