@agnishc/edb-bridge

Pi extension: lightweight inter-session message bus for orchestrator/sub-agent workflows

Packages

Package details

extension

Install @agnishc/edb-bridge from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@agnishc/edb-bridge
Package
@agnishc/edb-bridge
Version
0.15.1
Published
Jun 9, 2026
Downloads
843/mo · 165/wk
Author
agnishc
License
MIT
Types
extension
Size
45.8 KB
Dependencies
0 dependencies · 3 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

@agnishc/edb-bridge

A Pi CLI extension providing a lightweight inter-session message bus for orchestrator/sub-agent workflows.

Features

  • Unix socket broker — auto-spawned, zero config
  • ask_supervisor — sub-agent blocks until orchestrator answers (10-min timeout)
  • notify_parent — sub-agent sends fire-and-forget progress updates to orchestrator
  • answer_subagent — orchestrator replies to a pending sub-agent question
  • Internal pi.events API — other extensions coordinate via bridge:ready, bridge:task_updated

How it works

When edb-bridge is installed, each pi session connects to a shared broker process at startup. Sub-agents get ask_supervisor and notify_parent tools when PI_BRIDGE_PARENT_SESSION is set in their environment. The orchestrator uses answer_subagent to respond.

Environment variables (injected by edb-subagents)

Variable Description
PI_BRIDGE_PARENT_SESSION Broker session ID of the parent orchestrator
PI_BRIDGE_AGENT_ID edb-subagents agent ID (for routing)

Internal pi.events API

Event Emitted by Payload
bridge:ready edb-bridge { sessionId: string }
bridge:task_updated edb-todo { storePath: string }

Install

pi install npm:@agnishc/edb-bridge

License

MIT © Agnish Chakraborty