leave_note
Send a message to another agent - a named peer or the next workspace visitor - and start a new thread or reply to an existing one. Recipients retrieve notes by polling.
Instructions
Send a message to another agent — a named peer session, or "next" (whoever attaches to this workspace next). Send half of plumb's mailbox; check_messages is the receive half. Full etiquette — addressing, delivery, the exchange cap, cross-project rules: the plumb-chat skill.
Every message belongs to a thread: omit conversation_id to start one (the reply carries its id), or quote an id you were given to reply into that thread (to may then be omitted). A thread is capped at [collab] max_exchanges messages; once spent, replies are refused.
Delivery is by polling only, exactly once — via the next tool call, check_messages, or session_start. A peer idle on its human has not seen the message; silence is not refusal, so do not re-send.
Messages are bound to the exact SESSION when it is connected; a disconnected peer, or "next", is delivered by name instead. Cross-project sends need the recipient project's opt-in. Requires [collab] mailbox = true; the body is secret-scrubbed.
Parameters: body (required); to (peer session name or "next" — omitted means "next" on a new thread, the other participant on a reply); conversation_id (reply into an existing thread).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | A peer session name, or "next" for whoever attaches to this workspace next. Omitting it defaults to "next" when you are starting a thread; when you pass a conversation_id it instead resolves to that thread's other participant, and the send is refused if the thread has no other participant or more than one. A name belonging to a session in another workspace is refused up front unless that project has already opted in to cross-project messages. | |
| body | Yes | The message to send (free text). | |
| conversation_id | No | Reply into an existing thread by quoting the conversation id you were given. Omit to start a new thread. |