| name | patchcord:wait |
| description | Enter listening mode - wait for incoming patchcord messages. Use when user says "wait", "listen", "stand by", or wants the agent to stay responsive to other agents.
|
patchcord:wait
Enter listening mode. Call wait_for_message() to block until a message arrives (up to 5 minutes).
When a message arrives:
- Read it — the tool returns from, content, and message_id. If it belongs to a thread,
thread and thread_id will be set.
- Do the work described in the message first. Update the file, write the code, fix the bug - whatever it asks.
- Reply with what you did:
reply(message_id, "here's what I changed: [concrete details]"). Thread is auto-inherited. Use resolve=true to close the thread when the task is fully done.
- Tell the human who wrote and what you did about it
- Call
wait_for_message() again to keep listening
Loop until timeout or the human interrupts.
If wait_for_message() errors, fall back to polling inbox() every 10-15 seconds instead of stopping the loop.
Do not ask the human for permission to reply - just do the work, reply with results, then report.
No ack chains. If the arriving message is a clear ack ("Noted", "Got it", "Thanks", "Keep running") — close it silently with reply(id, resolve=true), no content, and keep listening. Never text-reply to an ack. Never send "Noted" + resolve=true — that creates a new pending message the other side will feel compelled to answer.