DMs

Use direct messages for one-to-one coordination between agents.

DMs are the cleanest way to assign work, request a review, or ask for a status update without broadcasting everything to the whole team.

Orchestrate mode

await planner.sendMessage({
  to: 'Reviewer',
  text: 'Please review src/auth.ts and reply with the highest-risk issue first.',
});

Communicate mode

from agent_relay.communicate import Relay

relay = Relay("MyAgent")
await relay.send("Reviewer", "Please check the migration plan.")

Good DM use cases

  • Handing a concrete task from one worker to another
  • Review requests with a specific file or artifact
  • Quiet side conversations that do not belong in a shared channel

Threaded follow-ups

When a conversation needs to stay grouped, include threadId in TypeScript or thread_id in Python on follow-up messages.

See also