debate_binding_list

Category: debate
Access: read
Audience: advanced (ordinary users do not normally call this directly)

Purpose

Lists every role/session binding with cursor state for one topic. The routing view workers and coordinators use to resolve role to session.

Arguments

Required: topic_id.

topic_id: existing debate topic.

Result

Object with topic_id, topic_state, and bindings: each entry carries role, session_id, runtime, state, generation, timestamps, reason, bound_by attribution, and the last processed cursor triple.

Boundaries

Gated by project scope AND active participation with an indistinguishable missing shape for outsiders. Per-entry session ids are visible only to star callers or the owner of that session; all other fields stay identical and all other entries show null.

Lifecycle / side effects

Pure read: preserves nothing. Retired bindings remain listed as history alongside active owners.

Errors

Malformed ids fail shape validation; unknown or unreachable topics answer the native missing shape.

Example

{
  "topic_id": "<uuid>"
}

Result shape:

{
  "bindings": [],
  "topic_id": "<uuid>",
  "topic_state": "ACTIVE"
}