@@ -331,15 +331,16 @@ launching again. `create_threads` remains the batch option for a shared checkout
331331
332332### ` t3_thread_list `
333333
334- Lists durable thread shells in the calling thread's project, newest first.
335- Callers can filter by title, run status, and whether app-owned sub-agent threads
336- are included. Results are bounded and offset-paginated. Deleted threads and
337- threads from other projects are never exposed .
334+ Lists durable thread shells in one project, newest first: ` projectId ` when
335+ given, else the calling thread's project. Callers can filter by title, run
336+ status, and whether app-owned sub-agent threads are included. Results are
337+ bounded and offset-paginated. Deleted threads are never listed .
338338
339339### ` t3_thread_read `
340340
341- Reads a project-scoped thread's durable state, recent runs, and visible
342- timeline. The default ` messages ` view returns user messages, assistant
341+ Reads the durable state, recent runs, and visible timeline of any thread in
342+ the environment by thread ID. A deleted thread returns ` thread_not_found ` . The
343+ default ` messages ` view returns user messages, assistant
343344messages, and proposed plans. The ` activity ` view also returns summarized tool,
344345reasoning, checkpoint, handoff, and runtime-request items. Large item text is
345346bounded and reports whether it was truncated. ` afterPosition ` and
@@ -353,7 +354,7 @@ distinguishable from human-authored messages.
353354
354355### ` t3_thread_update `
355356
356- Updates metadata for the calling thread or another thread in the same project .
357+ Updates metadata for the calling thread or any other thread in the environment .
357358The typed actions are ` rename ` , ` regenerate_title ` , ` link_pull_request ` , and
358359` unlink_pull_request ` . A link input supplies the repository, number, and URL;
359360the server records the target thread's project ID. Branch and workspace changes
@@ -367,7 +368,7 @@ detail also exposes an in-flight title regeneration.
367368
368369### ` t3_thread_send `
369370
370- Sends a message to an ordinary or delegated thread in the calling project :
371+ Sends a message to any ordinary or delegated thread in the environment :
371372
372373- ` auto ` starts an idle thread, steers a fully active turn, or queues behind a
373374 turn that is not yet steerable;
@@ -434,9 +435,11 @@ results use the latest assistant content from the final work turn.
434435 mode. It may not escalate privileges.
435436- A child interaction mode may stay equal to or narrow from ` default ` to
436437 ` plan ` . It may not escalate from ` plan ` to ` default ` .
437- - General thread management is limited to the calling thread's project. Send
438- additionally enforces the same runtime and interaction privilege ceiling as
439- child creation.
438+ - Thread tools take any thread in the environment as a target. For a thread
439+ caller, list and search cover one project: its own unless ` projectId ` is given.
440+ - A tool that changes another thread needs the calling thread's live run, and
441+ the target's runtime and interaction modes may not be broader than the
442+ caller's. This is the same privilege ceiling as child creation.
440443- Provider instances must be enabled, installed, available, authenticated, and
441444 backed by a V2 adapter.
442445- A requested model must be advertised by the selected provider when the
0 commit comments