feat(admin): single-file dark dashboard UI on / and /ui

Static HTML served by StatusHTTP (stdlib only, no build step): service
health pills, channel connection states, agent processes, live bindings
table; fetches existing /status + /sessions JSON, 10s auto-refresh.
This commit is contained in:
openbot committed 2026-10-13 15:00:55 +08:00
1 parent 036b5641cf
commit e1afdce073
3 files changed
+188 -2

No files matched your search

+100
View File
@@ -0,0 +1,100 @@
"""Admin UI for agenthub — single-file dashboard served by StatusHTTP.
Design: dark terminal-inspired theme, pure stdlib (no build step), auto-refresh.
Panels: service health, channels (connection state), agents (running procs),
live session bindings. All data comes from the existing /status + /sessions
endpoints — the UI is a static HTML string that fetches JSON client-side.
"""
DARK_CSS = """
:root{--bg:#0d1117;--panel:#161b22;--border:#30363d;--fg:#e6edf3;--muted:#8b949e;
--green:#3fb950;--red:#f85149;--amber:#d29922;--blue:#58a6ff;--mono:ui-monospace,'SF Mono','Cascadia Code',Menlo,monospace}
*{box-sizing:border-box;margin:0;padding:0}
body{background:var(--bg);color:var(--fg);font-family:var(--mono);font-size:14px;padding:24px;max-width:1200px;margin:0 auto}
h1{font-size:18px;font-weight:600;display:flex;align-items:center;gap:10px;margin-bottom:4px}
h1 .sub{font-size:12px;color:var(--muted);font-weight:400}
.grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(340px,1fr));gap:16px;margin-top:18px}
.card{background:var(--panel);border:1px solid var(--border);border-radius:8px;padding:16px}
.card h2{font-size:12px;text-transform:uppercase;letter-spacing:.08em;color:var(--muted);margin-bottom:12px;display:flex;justify-content:space-between;align-items:center}
.pill{font-size:11px;padding:2px 8px;border-radius:10px;font-weight:600}
.pill.ok{background:#12351d;color:var(--green)}
.pill.bad{background:#3d1418;color:var(--red)}
.pill.warn{background:#33290c;color:var(--amber)}
.row{display:flex;justify-content:space-between;align-items:center;padding:8px 0;border-bottom:1px solid var(--border)}
.row:last-child{border-bottom:none}
.row .k{color:var(--muted)}
.dot{width:8px;height:8px;border-radius:50%;display:inline-block;margin-right:8px}
.dot.ok{background:var(--green)}.dot.bad{background:var(--red)}.dot.warn{background:var(--amber)}.dot.idle{background:var(--muted)}
.kv{font-size:22px;font-weight:600}
.meta{color:var(--muted);font-size:12px;margin-top:6px}
table{width:100%;border-collapse:collapse;font-size:13px}
th{color:var(--muted);text-align:left;font-weight:500;padding:6px 8px;border-bottom:1px solid var(--border);font-size:11px;text-transform:uppercase;letter-spacing:.06em}
td{padding:8px;border-bottom:1px solid var(--border)}
tr:last-child td{border-bottom:none}
code{background:#21262d;padding:1px 6px;border-radius:4px;font-size:12px;color:var(--blue)}
#refresh{color:var(--muted);font-size:11px;cursor:pointer;user-select:none}
#refresh:hover{color:var(--blue)}
.empty{color:var(--muted);font-style:italic;padding:12px 0;font-size:13px}
"""
HTML = """<!DOCTYPE html>
<html lang="zh"><head><meta charset="utf-8">
<title>agenthub</title><style>__CSS__</style></head>
<body>
<h1>⚡ agenthub <span class="sub">ACP bridge · IM ⇄ NATS ⇄ agents</span></h1>
<div class="meta">refreshed <span id="ts">—</span> · <span id="refresh">↻ refresh</span> · auto 10s</div>
<div class="grid">
<div class="card"><h2>Service <span id="svc-pill" class="pill">…</span></h2>
<div style="display:flex;gap:32px;margin-top:4px">
<div><div class="kv" id="k-agents">—</div><div class="meta">agents</div></div>
<div><div class="kv" id="k-sessions">—</div><div class="meta">sessions</div></div>
<div><div class="kv" id="k-uptime">—</div><div class="meta">uptime</div></div>
</div></div>
<div class="card"><h2>Channels</h2><div id="channels"></div></div>
<div class="card"><h2>Agents</h2><div id="agents"></div></div>
<div class="card"><h2>Live Bindings</h2><div id="bindings"></div></div>
</div>
<script>
const $=id=>document.getElementById(id);
const dot=s=>({connected:'ok',running:'ok',subscribed:'ok',ok:'ok',failed:'bad',error:'bad',degraded:'warn'}[s]||'idle');
function fmtUp(s){if(s<60)return Math.round(s)+'s';if(s<3600)return Math.floor(s/60)+'m '+Math.round(s%60)+'s';return Math.floor(s/3600)+'h '+Math.floor(s%3600/60)+'m'}
async function load(){
try{
const st=await fetch('status').then(r=>r.json());
const se=await fetch('sessions').then(r=>r.json()).catch(()=>({bindings:[]}));
$('ts').textContent=new Date().toLocaleTimeString();
const ok=st.status!=='degraded';
$('svc-pill').textContent=st.status;
$('svc-pill').className='pill '+(ok?'ok':'bad');
$('k-agents').textContent=st.agents.length;
$('k-sessions').textContent=(se.bindings||[]).length;
$('k-uptime').textContent=fmtUp(st.uptime_s||0);
// channels
$('channels').innerHTML=st.channels.length?st.channels.map(c=>{
const d=dot(c.state);
return `<div class="row"><span><span class="dot ${d}"></span>${c.name}</span>
<span style="color:var(--${d==='ok'?'green':d==='bad'?'red':'amber'})">${c.state}${c.error?` <span title="${c.error}" style="color:var(--muted)">⚠</span>`:''}</span></div>`;
}).join(''):'<div class="empty">no channels</div>';
// agents
$('agents').innerHTML=st.agents.map(a=>{
const d=a.running?'ok':'idle';
return `<div class="row"><span><span class="dot ${d}"></span>${a.name}</span><code>${a.cmd}</code></div>`;
}).join('')||'<div class="empty">no agents configured</div>';
// bindings
const bs=se.bindings||[];
$('bindings').innerHTML=bs.length?`<table><tr><th>channel</th><th>chat</th><th>agent</th><th>last active</th></tr>`+
bs.map(b=>`<tr><td>${b.channel}</td><td>${b.chat_id}</td><td>${b.agent}</td>
<td style="color:var(--muted)">${Math.max(0,Math.round(Date.now()/1000-b.last_active))}s ago</td></tr>`).join('')+
'</table>':'<div class="empty">no live sessions</div>';
}catch(e){$('svc-pill').textContent='unreachable';$('svc-pill').className='pill bad';}
}
$('refresh').onclick=load;setInterval(load,10000);load();
</script></body></html>"""
def render_index() -> str:
return HTML.replace("__CSS__", DARK_CSS)
+14 -2
View File
@@ -20,6 +20,8 @@ from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
from typing import Any from typing import Any
from urllib.parse import parse_qs, urlparse from urllib.parse import parse_qs, urlparse
from agenthub.admin_ui import render_index
class StatusHTTP: class StatusHTTP:
def __init__(self, mgr: Any, host: str = "127.0.0.1", port: int = 30990): def __init__(self, mgr: Any, host: str = "127.0.0.1", port: int = 30990):
@@ -107,8 +109,18 @@ class StatusHTTP:
def do_GET(self): def do_GET(self):
parsed = urlparse(self.path) parsed = urlparse(self.path)
self._route_get(parsed.path.rstrip("/") or "/", parse_qs(parsed.query)) path = parsed.path.rstrip("/") or "/"
if path in ("/", "/ui", "/index.html"):
# Admin UI (browser-facing): the same nginx /agents/ prefix
# serves it; JSON endpoints remain for programmatic access.
data = render_index().encode()
self.send_response(200)
self.send_header("Content-Type", "text/html; charset=utf-8")
self.send_header("Content-Length", str(len(data)))
self.end_headers()
self.wfile.write(data)
return
self._route_get(path, parse_qs(parsed.query))
def do_POST(self): def do_POST(self):
length = int(self.headers.get("Content-Length", 0)) length = int(self.headers.get("Content-Length", 0))
self._route_post(urlparse(self.path).path.rstrip("/"), self.rfile.read(length)) self._route_post(urlparse(self.path).path.rstrip("/"), self.rfile.read(length))
+74
View File
@@ -0,0 +1,74 @@
"""Tests for the admin UI endpoint (served on / and /ui)."""
import json
import threading
import time
import urllib.request
from unittest.mock import MagicMock
import pytest
from agenthub.http_admin import StatusHTTP
class FakeBinding:
def __init__(self, channel, chat_id, agent, acp_session_id):
self.channel = channel
self.chat_id = chat_id
self.agent = agent
self.acp_session_id = acp_session_id
self.last_active = time.time()
@pytest.fixture
def server():
mgr = MagicMock()
mgr.list_agents.return_value = [
{"name": "opencode", "cmd": "opencode acp", "running": True},
{"name": "codex", "cmd": "codex acp", "running": False},
]
mgr._bindings = {
("wecom", "c1"): FakeBinding("wecom", "c1", "opencode", "s1"),
}
mgr._lock = threading.Lock()
http = StatusHTTP(mgr, host="127.0.0.1", port=0) # port 0 = ephemeral
http.start()
port = http._server.server_address[1]
yield f"http://127.0.0.1:{port}"
http.stop()
def _get(url):
with urllib.request.urlopen(url, timeout=5) as r:
return r.status, r.read()
def test_root_serves_html(server):
code, body = _get(server + "/")
assert code == 200
assert b"text/html" not in body # header not in body; content check below
assert b"agenthub" in body
assert b"<!DOCTYPE html>" in body
def test_ui_alias(server):
code, body = _get(server + "/ui")
assert code == 200 and b"<!DOCTYPE html>" in body
def test_json_endpoints_still_work(server):
code, body = _get(server + "/status")
d = json.loads(body)
assert d["service"] == "agenthub"
assert len(d["agents"]) == 2
code, body = _get(server + "/sessions")
d = json.loads(body)
assert d["bindings"][0]["agent"] == "opencode"
def test_html_references_fetch_targets(server):
_, body = _get(server + "/")
# UI fetches status/sessions relatively — must not hardcode hosts
assert b"fetch('status')" in body
assert b"fetch('sessions')" in body
assert b"botflow_truncated" not in body # sanity: unrelated content absent