an open-source alternative to the dots, bots and muses of the world, run an office of claude code/codex like agents on your laptop, sandboxes or anywhere, uses your existing subscriptions
HTML agent-harnessagent-orchestrationagentsai-agentsautonomous-agentsclaude-codecodexcoding-agentsdesktop-appdeveloper-toolselectrongemini-cliharnessharness-engineeringlocal-firstmemorymulti-agentopencodeorchestrationtypescript
/**
* Broadcast fan-out target selection.
*
* Kept as a pure function (and out of `hive.ts`) so the rule is testable on its
* own, the way `queueDelivery` / `codexRemote` are.
*/
/** The subset of a registry agent that fan-out actually looks at. */
export interface BroadcastCandidate {
/** Michael's prep assistant — send-only, drains no inbox. */
isAssistant?: boolean;
/** PTY tab closed; the record is retained but the agent is not live. */
archived?: boolean;
}
/**
* The agents a `to: 'broadcast'` message fans out to.
*
* Excluded: the sender itself, the send-only prep assistant (direct mail to it
* would rot unread), and archived agents (no live PTY).
*
* NOT excluded: providers without a hook/proxy bridge. Fan-out used to gate on
* `canReceiveInbox`, which meant an agent on a hookless provider — `custom`,
* i.e. any CLI the presets don't know — silently never heard a broadcast, even
* though a DIRECT message to that same agent was delivered fine. That asymmetry
* was the bug: `deliver` already routes a hookless target through
* `emitTerminalHandoff` (a terminal work order) and only bounces to the god when
* the renderer is unavailable. Fan-out now selects the same agents direct mail
* can reach, and that existing per-target path decides HOW each one is served.
*
* The trade-off this accepts: with the renderer down, a broadcast to N hookless
* agents produces N bounces to the god instead of silence. That is the same
* behaviour N direct messages already produce, and it is the loud failure —
* nothing is dropped without the god being told.
*/
export function selectBroadcastTargets(
agents: Record<string, BroadcastCandidate | undefined>,
fromId: string
): string[] {
return Object.keys(agents).filter((id) => {
const agent = agents[id];
if (!agent) return false;
if (id === fromId) return false;
if (agent.isAssistant) return false;
if (agent.archived) return false;
return true;
});
}