federation

---

name: federation description: Manage cross-installation agent federation

$ARGUMENTS Manage federation peers, trust, and audit logs. Parse subcommand from $ARGUMENTS.

Usage: /federation [options]

Subcommands:

• init -- Generate keypair and initialize federation
• join <endpoint> -- Connect to a federation peer
• leave -- Leave the federation gracefully
• peers -- List known peers with trust levels
• send <node-id> <message-type> <payload> -- Send a message to a peer with optional budget controls (ADR-097)
• status -- Show federation health, sessions, metrics
• audit [--compliance hipaa|soc2|gdpr] [--since DATE] -- Query audit logs
• trust <node-id> [--review] -- View trust score breakdown
• config [--pii-policy PATH] -- Configure PII policies and compliance mode

Budget options for send (all optional, ADR-097 Phase 1; defaults preserve legacy unbounded behavior except maxHops floors at 8 to defang recursion):

• --max-hops N -- max hop chain length (default 8, 0 disallows remote delegation)
• --max-tokens N -- cumulative token cap across the hop chain (default unbounded)
• --max-usd N -- cumulative USD cap across the hop chain (default unbounded)
• --hop-count N -- starting hop count (default 0; pass-through when re-forwarding)
• --spent-tokens N / --spent-usd N -- caller-reported usage from previous legs

Errors return constant strings (HOP_LIMIT_EXCEEDED, BUDGET_EXCEEDED, INVALID_BUDGET) with no remaining-budget echo.

Steps by subcommand:

init: npx -y -p @claude-flow/plugin-agent-federation@latest ruflo-federation init join: npx -y -p @claude-flow/plugin-agent-federation@latest ruflo-federation join ENDPOINT leave: npx -y -p @claude-flow/plugin-agent-federation@latest ruflo-federation leave peers: npx -y -p @claude-flow/plugin-agent-federation@latest ruflo-federation peers send: npx -y -p @claude-flow/plugin-agent-federation@latest ruflo-federation send NODE_ID MSG_TYPE PAYLOAD [--max-hops N] [--max-tokens N] [--max-usd N] [--hop-count N] [--spent-tokens N] [--spent-usd N] status: npx -y -p @claude-flow/plugin-agent-federation@latest ruflo-federation status audit: npx -y -p @claude-flow/plugin-agent-federation@latest ruflo-federation audit --compliance MODE --since DATE trust: npx -y -p @claude-flow/plugin-agent-federation@latest ruflo-federation trust NODE_ID --review config: npx -y -p @claude-flow/plugin-agent-federation@latest ruflo-federation config --pii-policy PATH