Skip to content

Tool

set_thread_directive

Set a thread follow-up directive

SurfacesChat agentMCPCLI

Attach follow-up logic to a thread: when a reply arrives (or after a delay), the platform drafts/sends/asks/notifies per your instructions. Use it when the user wants a standing reply plan on a conversation ('if they reply, draft an answer in my voice'; 'remind me if no reply in 3 days'). `trigger`: 'reply' fires on the next inbound; 'no_reply_after'/'after' are timers (set `after` like '3d'/'7d'). `action.mode`: 'draft' (default — lands in Review), 'send' (auto-sends, if the deployment permits; otherwise downgraded to a draft), 'ask' (parks a check-in question), 'notify' (notification only). Cancel with cancel_thread_directive.

CLI: tinbox set-thread-directive

Parameters

NameTypeRequiredDefaultDescription
threadIdstringyes——
triggerreplyno_reply_afterafterno"reply"—
afterone ofno——
▸expand after
  • option 1string
  • option 2integer
modedraftsendasknotifyno——
tonestringno——
instructionsstringno——
questionstringno——
maxFiresintegerno——

Example

json
{
  "threadId": "thr_…"
}