foxctl-room-agent

What problem does it solve?

It helps participant agents reliably operate inside an existing foxctl room by following the room protocol for membership, inbox/task handling, durable replies, and escalation.

Core Features & Use Cases

• Participant-side room protocol: Ensures you are properly joined and bound to the correct delivery context before executing work in a room.
• Inbox, tasks, and lifecycle actions: Handles direct asks and supports claiming, touching, blocking, completing, and transitioning tasks with strict lifecycle guardrails.
• Chain-aware durable communication: Routes replies through the room (not pane-local chat) and satisfies reply-required requests only when responding within the same message chain.
• Reminders and room automation support: Works with the room loop for follow-ups, stale-reply nudges, and coordinator pulses while respecting reminder behavior.
• Escalation and decision routing: Escalates decisions by sending reply-expected requests to the right participant in the room.

Quick Start

Start by checking the room state and your inbox for direct asks with the instruction: run foxctl room status and then foxctl room inbox for your actor.