Threads

$ ant beta:sessions:threads list

GET/v1/sessions/{session_id}/threads

$ ant beta:sessions:threads retrieve

GET/v1/sessions/{session_id}/threads/{thread_id}

$ ant beta:sessions:threads archive

POST/v1/sessions/{session_id}/threads/{thread_id}/archive

beta_managed_agents_session_thread: object{ id, agent, archived_at, 8 more }

An execution thread within a session. Each session has one primary thread plus zero or more child threads spawned by the coordinator.

beta_managed_agents_session_thread_stats: object{ active_seconds, duration_seconds, startup_seconds }

Timing statistics for a session thread.

active_seconds: optional number

Cumulative time in seconds the thread spent actively running. Excludes idle time.

formatdouble

duration_seconds: optional number

Elapsed time since thread creation in seconds. For archived threads, frozen at the final update.

formatdouble

startup_seconds: optional number

Time in seconds for the thread to begin running. Zero for child threads, which start immediately.

formatdouble

beta_managed_agents_session_thread_status: "running" or "idle" or "rescheduling" or "terminated"

SessionThreadStatus enum

"running"

"idle"

"rescheduling"

"terminated"

beta_managed_agents_session_thread_usage: object{ active_seconds, cache_creation, cache_read_input_tokens, 4 more }

Cumulative token usage for a session thread across all turns.

beta_managed_agents_stream_session_thread_events: BetaManagedAgentsUserMessageEvent { id, content, type, processed_at } or BetaManagedAgentsUserInterruptEvent { id, type, processed_at, session_thread_id } or BetaManagedAgentsUserToolConfirmationEvent { id, result, tool_use_id, 4 more } or 34 more

Server-sent event in a single thread's stream.

$ ant beta:sessions:threads:events list

GET/v1/sessions/{session_id}/threads/{thread_id}/events

$ ant beta:sessions:threads:events stream

GET/v1/sessions/{session_id}/threads/{thread_id}/stream