turn_context.py 5.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108
  1. """Per-turn context shared between ``GatewayRunner._run_agent_inner`` and ``TurnRunner``.
  2. Each ex-closure local is a field, written once by ``_run_agent_inner`` while wiring the turn.
  3. ``message`` (ex-``nonlocal``) is the only rebindable field; other mutable state uses
  4. single-element lists so mutation stays visible to the outer body.
  5. """
  6. from __future__ import annotations
  7. from dataclasses import dataclass, field
  8. from typing import Any, Callable, List, Optional
  9. from agent.session_activity import AwakeIdleMeter
  10. @dataclass
  11. class TurnContext:
  12. # read-only turn identity / wiring
  13. source: Any = None
  14. reply_expected: Optional[bool] = None
  15. # Scheduled heartbeats are proactive work, not replies to the source message that
  16. # registered the watch. Their routine delivery surfaces stay quiet.
  17. scheduled_heartbeat: bool = False
  18. _run_still_current: Callable[[], bool] = None # type: ignore[assignment]
  19. _live_status_adapter: Any = None
  20. _live_status_mode: str = "off"
  21. _thinking_enabled: bool = False
  22. progress_mode: str = "off"
  23. progress_grouping: str = "grouped"
  24. tool_progress_enabled: bool = False
  25. progress_queue: Any = None
  26. log_queue: Any = None
  27. # mutable single-element containers (shared with the outer body)
  28. last_progress_msg: list = field(default_factory=lambda: [None])
  29. last_tool: list = field(default_factory=lambda: [None])
  30. last_was_terminal_block: list = field(default_factory=lambda: [False])
  31. repeat_count: list = field(default_factory=lambda: [0])
  32. long_tool_hint_fired: list = field(default_factory=lambda: [False])
  33. agent_holder: list = field(default_factory=lambda: [None])
  34. # Turn-scoped so the poll loop and stale-agent eviction both discount host sleep from idle.
  35. awake_idle: AwakeIdleMeter = field(default_factory=AwakeIdleMeter)
  36. _LONG_TOOL_THRESHOLD_S: float = 30.0
  37. _cleanup_progress: bool = False
  38. _cleanup_msg_ids: list[str] = field(default_factory=list)
  39. _progress_metadata: Optional[dict] = None
  40. _progress_reply_to: Optional[Any] = None
  41. message: Optional[str] = None # the only rebindable field
  42. # turn parameters / config snapshots (read-only in run_sync)
  43. history: Any = None
  44. context_prompt: Optional[str] = None
  45. channel_prompt: Optional[str] = None
  46. session_id: Optional[str] = None
  47. session_key: Optional[str] = None
  48. run_generation: Optional[int] = None
  49. process_task_id: str = ""
  50. process_baseline: frozenset[str] = field(default_factory=frozenset)
  51. _interrupt_depth: int = 0
  52. event_message_id: Optional[str] = None
  53. # Raw inbound platform id (not the event_message_id reply anchor); stamped on the user turn.
  54. inbound_message_id: Optional[str] = None
  55. moa_config: Optional[dict] = None
  56. title_user_message: Optional[str] = None
  57. persist_user_message: Optional[Any] = None
  58. persist_user_timestamp: Optional[float] = None
  59. # display_kind of the persisted user row for a self-injected turn; DB-only, never sent.
  60. # "internal_notification" for async-delegation/background notifications (#82888).
  61. persist_user_display_kind: Optional[str] = None
  62. persist_user_display_metadata: Optional[dict] = None
  63. user_config: Any = None
  64. mute_notification_reply: bool = False
  65. voice_turn: bool = False # a voice-note turn: runs on auxiliary.voice_chat
  66. enabled_toolsets: Any = None
  67. disabled_toolsets: Any = None
  68. log_mode_enabled: bool = False
  69. # The chat's resolved display.interim_assistant_messages. Turn-shaped gates (scheduled heartbeat, hold_stream,
  70. # finite viewer) apply in TurnRunner; a fresh agent's delegation.gateway_mode reads this session-shaped value.
  71. interim_assistant_messages_enabled: bool = False
  72. needs_progress_queue: bool = False
  73. AIAgent: Any = None
  74. resolve_display_setting: Any = None
  75. result_holder: list = field(default_factory=lambda: [None])
  76. tools_holder: list = field(default_factory=lambda: [None])
  77. stream_consumer_holder: list = field(default_factory=lambda: [None])
  78. streaming_tts_consumer_holder: list = field(default_factory=lambda: [None])
  79. # voice-ack wiring
  80. _voice_ack_fired: list = field(default_factory=lambda: [False])
  81. _voice_ack_guild: list = field(default_factory=lambda: [None])
  82. _voice_ack_loop: Any = None
  83. # hook / status bridge wiring
  84. _loop_for_step: Any = None
  85. _hooks_ref: Any = None
  86. _status_adapter: Any = None
  87. _status_chat_id: Any = None
  88. _status_thread_metadata: Optional[dict] = None
  89. # bound TurnRunner callbacks read via ctx
  90. progress_callback: Optional[Callable] = None
  91. voice_ack_callback: Optional[Callable] = None
  92. _step_callback_sync: Optional[Callable] = None
  93. _event_callback_sync: Optional[Callable] = None
  94. _status_callback_sync: Optional[Callable] = None
  95. # Slack-native task cards (opt-in); ID-bearing callbacks correlate start/complete by call ID
  96. # --- Slack-native task-card progress (opt-in; #29483) ------------------ True when the Slack adapter's
  97. # ``native_task_cards_enabled()`` opt-in is set for this turn's platform. The ID-bearing lifecycle
  98. # callbacks are published by TurnRunner (like voice_ack_callback above) so tool starts and completions
  99. # correlate by real tool-call ID instead of tool name.
  100. _native_slack_task_cards: bool = False
  101. native_tool_start_callback: Optional[Callable] = None
  102. native_tool_complete_callback: Optional[Callable] = None