agent-usage-manager 0.2.2__tar.gz → 0.2.3__tar.gz

{agent_usage_manager-0.2.2 → agent_usage_manager-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-usage-manager
-Version: 0.2.2
+Version: 0.2.3
 Summary: htop for AI agents — liveness, CPU/mem/GPU usage, and a kill switch for headless agents (openclaw, hermes, ollama, vllm, claude-code).
 Project-URL: Homepage, https://github.com/minglong51/agent-usage-manager
 Project-URL: Repository, https://github.com/minglong51/agent-usage-manager
@@ -19,14 +19,14 @@ Description-Content-Type: text/markdown
 
 # agent-usage-manager
 
-A tiny, single-file web dashboard for **headless AI agents** running on a machine —
+A small web dashboard for **headless AI agents** running on a machine —
 OpenClaw, Hermes, Claude Code, Ollama, vLLM, llama.cpp, or anything you name. It
 shows which agents are alive and what they're costing you (CPU, memory, GPU), and
 gives you a **kill button** per agent. Think `htop`, scoped to just your agents —
 the [screenshot below](docs/dashboard.png) is a real run on a fleet node.
 
 No database, no auth framework (one static token file gates the kill switch),
-no dependencies beyond FastAPI + psutil. Runs on macOS and Linux. It is a
+four direct dependencies (FastAPI, uvicorn, psutil, PyYAML). Runs on macOS and Linux. It is a
 per-node monitor and guarded local control panel: fleet schedulers may consume
 its read-only telemetry, but should own their own scheduling and actuation.
 
@@ -365,7 +365,15 @@ SIGTERM/SIGKILL on POSIX and TerminateProcess on Windows.
 
 ## Release notes
 
-### 0.2.2 — unreleased
+### 0.2.3 — startup fixes
+
+- The browser now opens once the port actually accepts, instead of on a fixed
+  1s timer. A cold `uvx` run outran the timer and landed on connection-refused.
+- No more `/favicon.ico` 404.
+- Dropped two inaccurate README claims ("single-file"; "no dependencies beyond
+  FastAPI + psutil" — there are four).
+
+### 0.2.2 — telemetry identity and fleet labels
 
 - Added `api_version` and `aum_version` to `/api/agents` and `list --json`.
 - Added per-agent `create_time` so external telemetry consumers can pair it with

{agent_usage_manager-0.2.2 → agent_usage_manager-0.2.3}/README.md

@@ -1,13 +1,13 @@
 # agent-usage-manager
 
-A tiny, single-file web dashboard for **headless AI agents** running on a machine —
+A small web dashboard for **headless AI agents** running on a machine —
 OpenClaw, Hermes, Claude Code, Ollama, vLLM, llama.cpp, or anything you name. It
 shows which agents are alive and what they're costing you (CPU, memory, GPU), and
 gives you a **kill button** per agent. Think `htop`, scoped to just your agents —
 the [screenshot below](docs/dashboard.png) is a real run on a fleet node.
 
 No database, no auth framework (one static token file gates the kill switch),
-no dependencies beyond FastAPI + psutil. Runs on macOS and Linux. It is a
+four direct dependencies (FastAPI, uvicorn, psutil, PyYAML). Runs on macOS and Linux. It is a
 per-node monitor and guarded local control panel: fleet schedulers may consume
 its read-only telemetry, but should own their own scheduling and actuation.
 
@@ -346,7 +346,15 @@ SIGTERM/SIGKILL on POSIX and TerminateProcess on Windows.
 
 ## Release notes
 
-### 0.2.2 — unreleased
+### 0.2.3 — startup fixes
+
+- The browser now opens once the port actually accepts, instead of on a fixed
+  1s timer. A cold `uvx` run outran the timer and landed on connection-refused.
+- No more `/favicon.ico` 404.
+- Dropped two inaccurate README claims ("single-file"; "no dependencies beyond
+  FastAPI + psutil" — there are four).
+
+### 0.2.2 — telemetry identity and fleet labels
 
 - Added `api_version` and `aum_version` to `/api/agents` and `list --json`.
 - Added per-agent `create_time` so external telemetry consumers can pair it with

{agent_usage_manager-0.2.2 → agent_usage_manager-0.2.3}/agent_usage_manager/cli.py

@@ -3,7 +3,9 @@ from __future__ import annotations
 import argparse
 import ipaddress
 import os
+import socket
 import threading
+import time
 import webbrowser
 
 
@@ -25,6 +27,23 @@ def _bind_allowed(host: str, unsafe_expose: bool) -> bool:
         return False
 
 
+def _open_when_ready(url: str, host: str, port: int, timeout: float = 15.0) -> None:
+    """Open the browser only once the port accepts, never on a fixed delay.
+
+    A cold first run (uvx resolving the env, then importing fastapi/uvicorn)
+    outruns any guess, and the browser lands on connection-refused. On timeout
+    we stay silent: the URL is already on stdout.
+    """
+    deadline = time.monotonic() + timeout
+    while time.monotonic() < deadline:
+        try:
+            with socket.create_connection((host, port), timeout=0.25):
+                webbrowser.open(url)
+                return
+        except OSError:
+            time.sleep(0.1)
+
+
 def _dur(s: float) -> str:
     s = max(0, int(s))
     d, h, m = s // 86400, s % 86400 // 3600, s % 3600 // 60
@@ -128,7 +147,9 @@ def main() -> None:
     print(f"agent-usage-manager → {url}")
 
     if not args.no_browser:
-        threading.Timer(1.0, lambda: webbrowser.open(url)).start()
+        threading.Thread(
+            target=_open_when_ready, args=(url, open_host, args.port), daemon=True
+        ).start()
 
     uvicorn.run("agent_usage_manager.app:app", host=args.host, port=args.port)
 

{agent_usage_manager-0.2.2 → agent_usage_manager-0.2.3}/agent_usage_manager/static/index.html

@@ -3,6 +3,7 @@
 <head>
 <meta charset="utf-8" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
+<link rel="icon" href="data:," />
 <title>agent usage manager</title>
 <style>
   :root { color-scheme: dark; }

{agent_usage_manager-0.2.2 → agent_usage_manager-0.2.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "agent-usage-manager"
-version = "0.2.2"
+version = "0.2.3"
 description = "htop for AI agents — liveness, CPU/mem/GPU usage, and a kill switch for headless agents (openclaw, hermes, ollama, vllm, claude-code)."
 readme = "README.md"
 license = { text = "MIT" }

{agent_usage_manager-0.2.2 → agent_usage_manager-0.2.3}/uv.lock

@@ -8,7 +8,7 @@ resolution-markers = [
 
 [[package]]
 name = "agent-usage-manager"
-version = "0.2.2"
+version = "0.2.3"
 source = { editable = "." }
 dependencies = [
     { name = "fastapi", version = "0.128.8", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.10'" },