Skip to content

Evaluate optional lightweight admin UI package #9

@ryanwi

Description

@ryanwi

Motivation

agent-control-plane exposes rich read APIs (get_operational_scorecard, get_health_snapshot, get_state_change_feed, list_tickets, get_plan_progress, etc.) but there's no out-of-the-box way to visualize governance state without building a custom frontend on top.

For projects that adopt the library standalone (outside of a larger app like AlphaBond), this creates friction — the library is useful but opaque without significant UI investment.

Proposal

Evaluate a lightweight, optional agent-control-plane[ui] package — similar to how Celery has Flower.

Candidates to evaluate:

  • Textual (terminal UI, zero web server overhead) — aligns with AlphaBond's existing TUI interest (ryanwi/alphabond#258)
  • Streamlit / Gradio (quick web UI, minimal frontend code)
  • FastAPI + HTMX (lightweight, embeddable)

Key views that would be high value:

  • Active sessions + tier routing outcomes
  • Pending approval tickets
  • Token budget utilization
  • Operational scorecard
  • Recent EventKind feed

Design Constraint

The library core must remain UI-free. This should be an optional extra that consuming apps can mount or run standalone — not a hard dependency.

Open Question

Is the intended audience "AlphaBond only" or "any agentic Python app"? The answer determines how much investment this warrants vs. leaving UI to consumers.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions