leave_note
Send a message to another agent by name, or leave it for the next agent to join the workspace. Continue an existing conversation by passing its conversation ID.
Instructions
Send a message to another agent — a named peer session, or "next" (whoever attaches to this workspace next). This is the send half of plumb's mailbox; check_messages is the receive half.
CONVERSATIONS. Every message belongs to a thread. Omit conversation_id to start one (the reply tells you the new id); pass the conversation_id you were given to answer in the same thread. A thread is capped at [collab] max_exchanges messages — once spent, further replies are refused and you should summarise the exchange for your human rather than starting a fresh thread to keep talking.
DELIVERY is by polling only — plumb cannot push. A message reaches the peer when it next makes any tool call (pending messages are appended to the result), when it calls check_messages, or at its next session_start. Each message is delivered exactly once. A peer that is idle waiting on its human makes no tool calls and will not see it until it does something — so do not assume silence means refusal.
CROSS-PROJECT. Addressing a session pinned to a different workspace is allowed, but it is delivered only if THAT project sets [collab] cross_project = true; otherwise it expires unread. Such a message is labelled with your workspace when the peer reads it.
Messages expire after [collab] intent_ttl_minutes. Requires [collab] mailbox = true; otherwise the call is refused. The body is secret-scrubbed before storage.
Parameters: body — the message (required, free text). to — a peer session name, or "next" (default). conversation_id — reply into an existing thread; omit to start one.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | A peer session name, or "next" (default) for whoever attaches to this workspace next. A name belonging to a session in another workspace is delivered only if that project allows 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. |