========================
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 :doc:`channel-adapter` for setup.