ComfyUI Node

AZAll Send Message

How one agent writes to another

By cronos3k·Created 5 months ago·Updated 5 months ago· 0
AZAll Send Message
  • config
  • confirmation
to
subject
body

Email, without the email server. AgentAZAll_Send drops a message into the current agent's outbox - a plain text file addressed to another agent - and that's it. Delivery happens later, when a Relay node runs. It's a tiny job, but it's the load-bearing primitive for every multi-agent workflow in the pack: the Novel Crafter's writer sending drafts to the editor, both sides of the Agent Debate, all of it starts with this node.

The design is deliberately decoupled. Send and deliver are separate steps, which is what lets the same message format travel between machines later (the project talks about swapping in FTP/email/HTTPS transports for cross-machine agents). For local ComfyUI use, though, the flow is: Send writes to outbox, Relay copies it into the recipient's inbox, the recipient's Inbox/Read Message nodes pick it up.

How it works

You provide a recipient address, a subject, and a body. Send validates that to and subject aren't empty, tries to sign the message with the agent's Ed25519 keypair if one exists (that's the agentazall package's PyNaCl dependency doing the work), and writes the formatted message to <mailbox>/<agent>/<date>/outbox/<msg-id>.txt. The message ID is generated by the core library and is how you'll reference it later.

One important detail: the recipient is looked up by exact address string. If the editor agent is configured as editor@localhost, you must send to editor@localhost - case and all - or the Relay won't find the matching mailbox folder.

The inputs that matter

  • config (required) - from AZAll Setup.
  • to (required) - recipient address, recipient-agent@localhost.
  • subject (required) - a one-line summary; shows up in the Inbox listing.
  • body - the full message content. Wire this from an LLM output if you want the agent to compose its own messages.

The confirmation output is informational - Message queued: <id> -> editor@localhost. Useful for wiring into a Text Display if you want to watch the flow.

Installing it

In cronos3k/comfyui-agentazall - Manager search "AgentAZAll", or:

cd ComfyUI/custom_nodes
git clone https://github.com/cronos3k/comfyui-agentazall.git
pip install "agentazall>=1.0.13"
# restart ComfyUI

No model files, no keys.

Common issues

The number-one confusion is "I sent it, where did it go?" - it's sitting in the outbox until a Relay runs. You need a Relay node in the graph (usually at the end of the sender's chain) to move it into the recipient's inbox. Second, address matching is exact, so inconsistent agent names silently strand messages. Third, the sender and recipient must share the same mailbox_dir for local delivery to work at all - Relay's docs are explicit about this. If messages never arrive, check that one thing first.

CategoryAgentAZAll/Messaging

Inputs (4)

NameTypeDefaultDescription
configAZALL_CONFIG
toSTRING
subjectSTRING
bodySTRING

Outputs (1)

NameTypeDescription
confirmationSTRING