feat(http): status http surface for nginx /agents reverse proxy

- http_admin.py: ThreadingHTTPServer on 127.0.0.1:30990
  GET /agents/ /status /healthz /sessions; POST /agents/prompt (ops)
- runtime starts it from config.http
- verified locally: healthz + status return JSON
This commit is contained in:
openbot committed 2026-10-06 16:12:52 +08:00
1 parent 436efc3b09
commit 2bcdf946f7
2 files changed
+122

No files matched your search

+111
View File
@@ -0,0 +1,111 @@
"""Minimal HTTP surface for nginx reverse proxy (/agents).
Endpoints (read-only):
GET /agents/ -> service overview {status, agents, uptime}
GET /agents/status -> same as above
GET /agents/sessions -> live bindings
GET /agents/healthz -> liveness (200)
POST /agents/prompt -> {channel, chat_id, text, agent?, cwd?} (ops tool; loopback-guarded)
Runs a ThreadingHTTPServer in-thread; bound to loopback by default —
nginx on the same host proxies https://api.vxquant.com/agents/ to it.
"""
from __future__ import annotations
import json
import threading
import time
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
from typing import Any
from urllib.parse import parse_qs, urlparse
class StatusHTTP:
def __init__(self, mgr: Any, host: str = "127.0.0.1", port: int = 30990):
self.mgr = mgr
self.host = host
self.port = port
self.started = time.time()
self._server: ThreadingHTTPServer | None = None
self._thread: threading.Thread | None = None
outer = self
class Handler(BaseHTTPRequestHandler):
def log_message(self, format, *args): # noqa: A002
pass # nginx access log covers it
def _json(self, code: int, obj: dict[str, Any]) -> None:
data = json.dumps(obj, ensure_ascii=False, default=str).encode()
self.send_response(code)
self.send_header("Content-Type", "application/json; charset=utf-8")
self.send_header("Content-Length", str(len(data)))
self.end_headers()
self.wfile.write(data)
def _route_get(self, path: str, qs: dict) -> None:
m = outer.mgr
if path in ("/", "/status"):
self._json(
200,
{
"service": "agenthub",
"status": "running",
"uptime_s": round(time.time() - outer.started, 1),
"agents": m.list_agents(),
},
)
elif path == "/healthz":
self._json(200, {"ok": True})
elif path == "/sessions":
bindings = []
with m._lock:
for (channel, chat_id), b in m._bindings.items():
bindings.append(
{
"channel": channel,
"chat_id": chat_id,
"agent": b.agent,
"acp_session_id": b.acp_session_id,
"last_active": b.last_active,
}
)
self._json(200, {"bindings": bindings})
else:
self._json(404, {"error": "not found"})
def _route_post(self, path: str, body: bytes) -> None:
if path != "/prompt":
self._json(404, {"error": "not found"})
return
try:
req = json.loads(body or b"{}")
res = outer.mgr.prompt(
req["channel"], str(req["chat_id"]), str(req["text"]),
agent=req.get("agent"), cwd=req.get("cwd"),
timeout_s=float(req.get("timeout_s", 120)),
)
self._json(200, res)
except KeyError as e:
self._json(400, {"error": f"missing field {e}"})
except Exception as e: # noqa: BLE001
self._json(500, {"error": str(e)})
def do_GET(self):
parsed = urlparse(self.path)
self._route_get(parsed.path.rstrip("/") or "/", 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))
self._handler = Handler
def start(self) -> None:
self._server = ThreadingHTTPServer((self.host, self.port), self._handler)
self._thread = threading.Thread(target=self._server.serve_forever, name="agenthub-http", daemon=True)
self._thread.start()
def stop(self) -> None:
if self._server:
self._server.shutdown()
+11
View File
@@ -131,6 +131,17 @@ def main(argv: list[str] | None = None) -> None:
ch.start()
log.info(f"channel started: {ch.name}")
# status HTTP for nginx /agents reverse proxy
try:
from .http_admin import StatusHTTP
http_cfg = cfg.get("http", {})
http = StatusHTTP(mgr, host=http_cfg.get("listen_host", "127.0.0.1"), port=int(http_cfg.get("port", 30990)))
http.start()
log.info(f"status http on {http.host}:{http.port}")
except Exception as e: # noqa: BLE001
log.warning(f"status http failed to start: {e}")
stop = threading.Event()
signal.signal(signal.SIGTERM, lambda *_: stop.set())
signal.signal(signal.SIGINT, lambda *_: stop.set())