supervisor-api-background-mode

What problem does it solve?

This Skill solves the problem of agent workflows timing out when long-running tool use must complete end-to-end before returning results to the user.

Core Features & Use Cases

• Background execution for long-running tasks: Submits Supervisor API requests asynchronously and returns immediately with a response_id, then polls until terminal completion.
• Timeout-safe “simulated streaming”: Converts fully available background output into incremental frontend-friendly stream deltas, preserving a chat-like experience.
• Robust ordering and approval handling: Skips echoed history items, breaks on incomplete output items to avoid validation errors, and supports multi-turn MCP tool approvals when needed.
• Use case: When an agent needs to run complex multi-tool workflows (e.g., large Genie queries or multi-step data analysis) that may exceed HTTP time limits, this Skill keeps the interaction responsive while still completing safely.

Quick Start

Ask the agent how often to poll for completion (every 2, 10, or 30 seconds), then apply the background-mode changes to your agent server to submit with background=True and stream the polled results to the frontend.