@d3ara1n/pi-chat-room

Agent-to-agent messaging for pi — built on @d3ara1n/pi-mesh. Exposes the send_to tool so agents can message each other; incoming messages arrive as user messages prefixed [From: NAME], queued until idle. Role-agnostic and order-agnostic: just the messagin

Packages

Package details

extension

Install @d3ara1n/pi-chat-room from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@d3ara1n/pi-chat-room
Package
@d3ara1n/pi-chat-room
Version
0.1.0
Published
Jul 29, 2026
Downloads
69/mo · 69/wk
Author
d3ara1n
License
MIT
Types
extension
Size
10.6 KB
Dependencies
1 dependency · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@d3ara1n/pi-chat-room

Agent-to-agent messaging for pi — built on @d3ara1n/pi-mesh. Exposes the send_to tool so agents can message each other; incoming messages arrive as user messages prefixed [From: NAME].

Role-agnostic and order-agnostic: it doesn't know "assistant" or "director" — it just delivers messages between named peers. Roles are declared via pi-mesh's mesh_set_profile.

How it works

  • Send: the send_to tool resolves a peer by name and delivers a message over the mesh. Asynchronous — returns once the recipient's mesh acknowledges receipt, NOT when the recipient agent reads or replies. Replies arrive later as their own [From: ...] messages.
  • Receive: incoming messages are injected as user messages ([From: NAME] ...), queued via deliverAs: "followUp" until the agent is idle — never interrupts an in-flight turn.
  • Output dual-channel: an agent's normal output goes to the human user; addressing another agent REQUIRES send_to. This is enforced via promptGuidelines, since LLMs have no native notion of routing output to one audience vs another.

Tool

send_to

Send a message to another pi instance on the mesh.

Parameter Required Description
name yes Recipient's mesh name (from mesh_list).
message yes The message body.

Installation

pi install npm:@d3ara1n/pi-mesh
pi install npm:@d3ara1n/pi-chat-room

Or add to ~/.pi/agent/settings.json:

{
  "extensions": [
    "/absolute/path/to/pi-extensions/packages/pi-mesh",
    "/absolute/path/to/pi-extensions/packages/pi-chat-room"
  ]
}

Dependencies

License

MIT