diff --git a/src/agenthub/http_admin.py b/src/agenthub/http_admin.py new file mode 100644 index 0000000..cb912a0 --- /dev/null +++ b/src/agenthub/http_admin.py @@ -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() diff --git a/src/agenthub/runtime.py b/src/agenthub/runtime.py index 013965b..53b03e6 100644 --- a/src/agenthub/runtime.py +++ b/src/agenthub/runtime.py @@ -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())