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:
1 parent
036b5641cf
commit
e1afdce073
3 files changed
+188
-2
No files matched your search
@@ -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)
|
||||
@@ -20,6 +20,8 @@ from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
|
||||
from typing import Any
|
||||
from urllib.parse import parse_qs, urlparse
|
||||
|
||||
from agenthub.admin_ui import render_index
|
||||
|
||||
|
||||
class StatusHTTP:
|
||||
def __init__(self, mgr: Any, host: str = "127.0.0.1", port: int = 30990):
|
||||
@@ -107,8 +109,18 @@ class StatusHTTP:
|
||||
|
||||
def do_GET(self):
|
||||
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):
|
||||
length = int(self.headers.get("Content-Length", 0))
|
||||
self._route_post(urlparse(self.path).path.rstrip("/"), self.rfile.read(length))
|
||||
|
||||
@@ -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
|
||||
Reference in new issue
Block a user