Documentation
¶
Overview ¶
Package buzz runs an Orb agent on Buzz: buzz-acp holds the agent's relay identity and drives its sessions over ACP, and the agent's shell posts with the buzz CLI, which runs here with the Buzz key. It takes its configuration as Options; the chat/platforms catalog builds them.
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Front ¶
Front serves the agent on Buzz until ctx ends: buzz-acp reaches its sessions through an ACP socket. Without Options.Socket the agent starts buzz-acp and ends with it, so a clean exit (an owner's !shutdown) stays final under the container's restart policy; with it, the socket is open to its group, so buzz-acp can run as another user, out of the tools' reach.
func HarnessSettings ¶
HarnessSettings are buzz-acp's settings for an Orb agent: it reaches the agent through relay, a command connecting its stdio to the agent's ACP socket, and Buzz's own memory is off, since the agent's is Orb's.
func Shim ¶
Shim is Orb started as `buzz` from the agent's shell, in dir: it hands the command to the agent through socket (ORB_BUZZ), and the agent runs the real CLI with the Buzz key. Standard input goes along only for a "-" argument (--content -), since the bash tool feeds its script on the shell's stdin.
Types ¶
type Options ¶
type Options struct {
// CLI is the real buzz CLI, which the agent's shell reaches through Shim.
CLI string
// Credentials are the Buzz key, owner tag and relay as KEY=VALUE, given to
// the CLI alone.
Credentials []string
// Profile is published as the agent's kind:0 at start.
Profile chat.Identity
// Socket, when set, is the ACP socket buzz-acp, running outside this
// process as another user, reaches the agent on. Otherwise the agent
// starts Harness itself, with HarnessEnv (its BUZZ_* settings).
Socket string
Harness string
HarnessEnv []string
}
Options configure Buzz for one agent.
Source Files