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:
1 parent
436efc3b09
commit
2bcdf946f7
2 files changed
+122
No files matched your search
@@ -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()
|
||||
@@ -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())
|
||||
|
||||
Reference in new issue
Block a user