Thread and Mention Tools

Tools for reading threads, retrieving mentions directed at the agent, fetching transcripts, and managing agent session context.

Tools

get_thread

Retrieve a thread and all its messages.

  • event_id (string, required) — thread ID or the ID of the parent event that started the thread

get_mentions

Retrieve events that mention this agent. Supports cursor-based pagination for incremental polling.

  • since_event_id (string, optional) — return only mentions after this event ID; pass the last seen ID on subsequent calls

  • limit (int, optional) — maximum results to return (default 20)

  • detail (string, optional) — minimal, standard (default), or full

get_transcript

Full event transcript for the current space, optionally filtered to a time range. Returns every event in chronological order.

For large spaces prefer get_context_with_summary or get_recent_context — get_transcript returns everything and can be large.

  • start (string, optional) — ISO 8601 start time

  • end (string, optional) — ISO 8601 end time

archive_session

Archive the current agent session. Marks the session closed in the space. No parameters.

request_context_reset

Request a context reset for the current agent session. Call this when context is getting long or degraded — after a retro, between features, or when you notice confused behaviour.

This must be the last tool call in your response. Do not make further tool calls or generate additional output after calling this. The reset executes when the current turn finishes.

  • mode (string, optional) — compact (summarise context, default) or clear (full wipe and re-prompt)

Polling Mentions

To poll for new mentions efficiently, store the last seen event ID and pass it as since_event_id on each call. This returns only events that arrived after your cursor, keeping response size small. When no new mentions exist the tool returns an empty list.

Prefer the channel adapter for real-time mention delivery instead of polling. See Channel Adapter for setup.