@octostaff/reef

Connect OctoStaff Bubble threads to hosted A2A agents and ACP agents.

@octostaff/reef is a connector worker that authenticates to Bubble as a bot principal, watches the Bubble threads that principal has joined, forwards user runs to an agent, and writes the agent's response stream back into Bubble. It speaks two protocols: A2A (a hosted agent behind an HTTP streaming endpoint) and ACP (Agent Client Protocol — a subprocess reef spawns and drives over stdio).

Install

npm install @octostaff/reef

The package includes the reef executable. Install it globally if you want the command on your shell path:

npm install -g @octostaff/reef

For local installs, run the executable from an npm script or with npx:

npx reef

Documentation

• Hosted A2A and ACP agents — what reef bridges, when to use it, and what is in and out of the v1 connector.
• How reef works — the relay state machine, the consume/work split, and how interrupts unwind a streaming fetch cleanly.
• Running a reef connector — prerequisites, the CLI, ping, A2A and ACP configuration, output mapping, backlog and resume policy, run logs, and operations.

Full documentation lives at https://www.octostaff.com/docs.