Capability Quality Guide
What users can expect from every capability published by Xenodia.
Every published capability includes enough information for a user or agent to decide whether and how to call it through Xenodia.
Published Information
| Field | What it tells you |
|---|---|
slug | The stable identifier used in Xenodia routes. |
name | The capability name shown in the catalog. |
category | The type of task the capability supports. |
short_description | A concise description of its purpose. |
default_version | The currently published API version. |
funding_modes | The supported payment relationship. |
invoke_path | The public Xenodia route for the default operation. |
operations | The available operations, inputs, outputs, and prices. |
agent_doc_what | When an agent should choose the capability. |
agent_doc_how | The recommended order and safety rules. |
trust_signals | Evidence, freshness, availability, idempotency, or audit signals. |
Operation Information
Each operation publishes its Xenodia method and path, purpose, price, input fields, a minimal request example, expected outputs, supported execution modes, and whether an Idempotency-Key is required.
Changes And Compatibility
Published slugs and routes remain stable. When an incompatible request or response change is required, Xenodia publishes a new version and preserves documented compatibility routes where applicable.
Descriptions, tags, examples, and guidance may improve without changing the behavior of an existing version.
Pricing And Safety
Prices use unit_price_micro_usdc, where 1000000 equals 1 USDC. Multi-operation capabilities show the price of each operation before you call it.
Before invoking a paid operation, confirm:
- The operation is currently available.
- Its live price and funding mode are acceptable.
- The request follows the published input shape.
- A paid or asynchronous retry reuses the same
Idempotency-Keyonly for the same logical request. - The returned request ID and billing summary are retained for support and audit.
The consumer catalog contains only the information needed to choose, call, price, retry, and audit a capability.