@@ -467,12 +467,21 @@ idempotent retries.
467467
468468Waits for a selected run to become ` completed ` , ` failed ` , ` cancelled ` ,
469469` interrupted ` , or ` rolled_back ` . Without ` runId ` , it pins the latest run at call
470- time; an idle thread returns immediately. A pending live question or approval on
471- the selected run, or an earlier unfinished run blocking it, also returns with
472- ` timedOut: false ` and ` hasPendingQuestion ` or ` pendingApproval ` . The run's status
473- does not change. Message-based asynchronous questions do not end the wait.
474- Read the fresh request before responding; the result grants no approval authority.
475- A timeout reports the latest durable status and does not cancel work.
470+ time. An idle thread returns immediately.
471+
472+ Thread-scoped and linked callers return on blocking input by default. Unlinked
473+ external MCP callers enable this behavior with ` returnOnInput: true ` . Setting
474+ ` returnOnInput: false ` keeps the wait terminal-only.
475+
476+ An input-aware wait returns ` timedOut: false ` and ` hasPendingQuestion ` or
477+ ` pendingApproval ` for live input on the selected run or an earlier unfinished run
478+ blocking it. The run keeps its current status. Asynchronous message-based
479+ questions leave the wait active. Read a fresh question with ` t3_pending_request ` .
480+ Secret cards appear in thread activity. Ask the user to answer secret cards and
481+ approvals in the thread. The result grants no approval authority.
482+
483+ A timeout reports the latest durable status and leaves the work running. A ` next `
484+ hint on a timed-out wait tells the caller to end its turn.
476485
477486### ` t3_thread_interrupt `
478487
0 commit comments