List every registered Trillboards API operation.
WHEN TO USE:
- First call in an agent session to learn what the API offers.
- Filter to agent_safe=true to list only side-effect-free endpoints.
- Narrow to a single surface (data-api, sdk-api, device-api, sensing-api,
partner-api-generated, dsp-api-generated).
RETURNS:
- operations: Array of { surface, method, path, operation_id, summary,
description, agent_safe, idempotent, cost_tier, tags, doc_url,
example_request }
- total_operations: Total count.
- surfaces: Known surface identifiers.
EXAMPLE:
Agent: "What read-only endpoints can I call?"
list_endpoints({ agent_safe: true })