Module purpose 

Every ambient purpose, in one place: its tag (the second half of an AmbientCallKey, the outcome-log purpose and the token-usage category), how long its CLI call may run, and which queue it waits in. Each caller keeps its OWN purpose: two callers under one purpose cancel each other.

docs/reports/REPORT_AMBIENT_FRAMEWORK_REASSESSMENT_2026_10_08.md section 6.3.

Structs

Purpose

One kind of ambient call.

Constants

ACTIVITY_SUMMARY

The per-turn session title the pane requests (session:activity_summary).

ACTIVITY_SUMMARY_PUSHED

A missing session title, recovered by the background sweep (backend::reactive::activity_watcher). Its own purpose so it never cancels, or is cancelled by, the pane’s own title request.

BACKGROUND_TIMEOUT 🔒

CONTINUITY_STATE

The rolling continuity state (backend::continuity_state): off any user-facing path, and a long multi-section reply, so it may take longer.

DEFINITION_SUMMARY

The once-per-definition conversation preview for the AgentPicker’s “My Agents” list (tasks::generate_definition_activity_summary).

DISPATCH_NAME

A Workflow dispatch’s display name. Separate from SUBAGENT_NAME so the two are counted apart. docs/specs/SPEC_SWARM_DISPATCH_NAMING_AND_ROW_MODEL_2026_07_19.md.

INTERACTIVE_TIMEOUT 🔒

The time limits. A call that answers in about 1.5 s on a quiet account can take much longer when many agents share one login and the CLI retries on overload, and a reply cut off at the limit has been paid for and is thrown away. 15 s timed out a third of suggestion calls. A suggestion or a title that arrives after 25 s is still useful.

NARRATION

A line narrating an autonomous AgentMux action in the pane’s conversation.

NEXT_PROMPT_SUGGESTION

The composer’s ghost-text next-prompt suggestion. docs/specs/SPEC_AMBIENT_GHOST_TEXT_NEXT_PROMPT_2026_07_03.md.

SESSION_CONTINUED_NOTE

The note a pane shows when a fresh session continues its conversation from AgentMux’s record (backend::continued_note): where things stand, then “How can I help?”. It waits in the interactive queue, since the user is looking at the pane, but gets the longer limit: its material runs to 12k characters and a note that lands late still helps. It restates the conversation, so, like the continuity state, its text stays out of the srv log.

SUBAGENT_NAME

A subagent’s display name (tasks::generate_subagent_name), when its parent gave no description. One-shot: the name is cached on SubAgent.display_name, so its generation is always 1. The backlog pass runs it as background work.