agenteye 0.1.0b1__py3-none-any.whl

agenteye-0.1.0b1.dist-info/METADATA

@@ -0,0 +1,118 @@
+Metadata-Version: 2.4
+Name: agenteye
+Version: 0.1.0b1
+Summary: Command-line client for the AgentEye dashboard API
+Author-email: Exosphere <support@exosphere.host>
+License: Proprietary
+Project-URL: Homepage, https://exosphere.host
+Project-URL: Documentation, https://github.com/agenteye-enterprise/releases
+Keywords: agents,observability,ai,monitoring,agenteye,cli
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.27
+Requires-Dist: typer>=0.12
+Requires-Dist: rich>=13
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Requires-Dist: respx>=0.21; extra == "dev"
+
+# AgentEye CLI (`agenteye`)
+
+A command-line client for the AgentEye **dashboard** API. It lets a developer —
+or the coding agent working alongside them — authenticate and query agent
+sessions, event logs, and evaluations from the terminal, with a `--json` flag on
+every command for scripting.
+
+> This is the **`agenteye` CLI**, distinct from the collector daemon
+> (`agenteye-collector`). The PyPI package and the installed command are both
+> `agenteye`.
+
+## Install
+
+```bash
+pipx install agenteye      # recommended (isolated)
+# or: uv tool install agenteye  /  pip install agenteye
+```
+
+Install isolated (pipx / uv tool) — the AgentEye Python SDK shares the `agenteye`
+distribution name, so isolation avoids a clash in a shared virtualenv.
+
+For development in this repo:
+
+```bash
+cd cli
+uv sync --extra dev
+uv run agenteye --help
+```
+
+## Authentication
+
+The CLI talks to the dashboard (default `http://localhost:3000`) and logs in with
+an emailed one-time code:
+
+```bash
+agenteye login --email you@example.com
+# enter the 6-digit code; the session is stored in ~/.agenteye/cli.json (mode 0600)
+agenteye whoami
+agenteye logout
+```
+
+Sessions expire (24h by default); re-run `agenteye login` when prompted.
+
+## Commands
+
+```text
+agenteye sessions [--since 24h] [--status error] [--all]
+agenteye events --session-id <id> [--event-type tool_use,tool_result] [--all]
+agenteye logs ...                       # alias of events
+agenteye evals --score helpfulness:0.5..0.8 --latest-per-session
+agenteye session show <id>
+agenteye session export <id> -o out.json
+agenteye re-evaluate <id>
+agenteye jobs                           # in-flight evaluation queue
+agenteye environments [--source events|evals]
+agenteye version                        # print the CLI version
+agenteye help                           # show top-level help
+```
+
+Add `--json` to any command for machine-readable output:
+
+```bash
+agenteye events --session-id run-001 --all --json | jq '.events[].payload'
+```
+
+## Configuration
+
+| Setting | Flag | Env var | Default |
+|---|---|---|---|
+| Dashboard URL | `--base-url` | `AGENTEYE_DASHBOARD_URL` | `http://localhost:3000` |
+| Session token | `--token` | `AGENTEYE_CLI_TOKEN` | from `~/.agenteye/cli.json` |
+| JSON output | `--json` | `AGENTEYE_CLI_JSON` | off |
+
+Precedence is **flag > environment variable > config file > default**. The config
+directory honours `AGENTEYE_HOME` (same as the SDK and collector).
+
+## Exit codes
+
+| Code | Meaning |
+|---|---|
+| 0 | Success |
+| 2 | Usage error (bad arguments) |
+| 3 | Cannot reach the dashboard |
+| 4 | Not logged in / session expired |
+| 5 | Authenticated but missing permission |
+
+## Tests
+
+```bash
+cd cli
+uv run --extra dev pytest
+```

agenteye-0.1.0b1.dist-info/RECORD

@@ -0,0 +1,24 @@
+agenteye_cli/__init__.py,sha256=eyyZX0uQp1piaMqpjvK32dLQtbmYb1LDWOhjJQlg70Y,377
+agenteye_cli/__main__.py,sha256=GhA_jQK0HPEAxwgfSYLfQz8t5uDWTBxCY5icQ_MuVrw,59
+agenteye_cli/_context.py,sha256=IC2XnFIx6c7NO5LF3O1th9-_gljDaM_qJkt83QUlGTU,1549
+agenteye_cli/_version.py,sha256=2f9m0YyP0UybST_fqXzfDdE3BUiRQVajDfkzhl26WPw,24
+agenteye_cli/app.py,sha256=7cZ3fcEXv3LCoi3JycM0sNsMrPUnMuTGVYJORqTZU4E,2678
+agenteye_cli/auth.py,sha256=s6zP3LCRgKbP36oo0KJtOoeWg_MRPTych8qobPoeaho,4026
+agenteye_cli/client.py,sha256=ND3jFIha6knxV10pdV5iVBvxpzfd87GpFEdfgdE06vE,10004
+agenteye_cli/config.py,sha256=H9-9iAdhja61LB--wwO9xkMpk87ePXXeeHFzaMRBH0A,2989
+agenteye_cli/dates.py,sha256=wCabqz9AgaGwQs6ucs0e_b0MrL_UhcF7hEP-AZN23gs,1616
+agenteye_cli/errors.py,sha256=yUtXlxtPOIt2P8nZuy78ITWEWMEabDiPO496W0Fx-j8,1481
+agenteye_cli/models.py,sha256=NwUOabAayNPvy4bq0S08Xz48o4gN9Cucwb84twdJD2s,3628
+agenteye_cli/output.py,sha256=R0-W2pny8iSYysFxKLhCPsEnNuSJVExfSzzkYOhspcM,2367
+agenteye_cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+agenteye_cli/commands/auth_cmds.py,sha256=XP6KKj1XJnC_cPY3-RDNDXFXUQ_9ohUEbr8kVXyVLAk,2841
+agenteye_cli/commands/env_cmds.py,sha256=fG5Q-zBCHAPTwy8gzfidecvAQQWadHYW2pmKjmLG3Pc,975
+agenteye_cli/commands/evals_cmds.py,sha256=Xkm5ebZ8Et4Ds54Oy0OcbrM_i9SMRqcRWfBu-gh52K4,3244
+agenteye_cli/commands/events_cmds.py,sha256=4ThYr3ypJzJm5r3jMgytJXCOb1T4Lbk1i9_22tf22K0,3105
+agenteye_cli/commands/jobs_cmds.py,sha256=KcE2MTuOa2yL2956xQv-yX0-8pepoq1XF7zQTKfRMig,1128
+agenteye_cli/commands/sessions_cmds.py,sha256=gmAO4_I3TYDp82tlZ9YyapGwysH4afv5fZ7JTJkxYds,5885
+agenteye-0.1.0b1.dist-info/METADATA,sha256=JvOOddMyux2a262MirFm1uYEt8TbZvPoQ1Ka51CkXC4,3662
+agenteye-0.1.0b1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+agenteye-0.1.0b1.dist-info/entry_points.txt,sha256=lRieI4-qJsfCnYXUW8piSTVY8s7N5D_zHBUmNAqMB4s,50
+agenteye-0.1.0b1.dist-info/top_level.txt,sha256=oc6HWsjPbGZpd-ctGjZd5lq3_4c7HIBW5kfAdIzkbrE,13
+agenteye-0.1.0b1.dist-info/RECORD,,

agenteye-0.1.0b1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

agenteye-0.1.0b1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+agenteye = agenteye_cli.app:app

agenteye-0.1.0b1.dist-info/top_level.txt

@@ -0,0 +1 @@
+agenteye_cli

agenteye_cli/__init__.py

@@ -0,0 +1,10 @@
+"""AgentEye CLI — a command-line client for the AgentEye dashboard API.
+
+The query layer lives in :mod:`agenteye_cli.client` as pure functions that take a
+``ClientContext`` and return plain dataclasses. They never print and never import
+Typer/Rich, so a future MCP server can wrap them with zero duplication.
+"""
+
+from ._version import __version__
+
+__all__ = ["__version__"]

agenteye_cli/__main__.py

@@ -0,0 +1,4 @@
+from .app import app
+
+if __name__ == "__main__":
+    app()

agenteye_cli/_context.py

@@ -0,0 +1,50 @@
+"""Shared command-layer state and helpers.
+
+Kept separate from ``app.py`` so command modules can import these without a
+circular dependency (``app.py`` imports the command modules).
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Optional, Tuple
+
+import click
+
+from . import config as cfgmod
+from . import dates as _dates
+from .client import ClientContext
+from .errors import AuthError
+
+
+@dataclass
+class AppState:
+    json: bool
+    base_url: str
+    token: Optional[str]
+    timeout: float
+    config: cfgmod.CliConfig
+
+
+def build_context(state: AppState) -> ClientContext:
+    return ClientContext(base_url=state.base_url, token=state.token, timeout=state.timeout)
+
+
+def require_auth(state: AppState) -> ClientContext:
+    """Return a client context, or raise AuthError if not usably authenticated."""
+    if not state.token:
+        raise AuthError("Not logged in. Run 'agenteye login'.")
+    # Only enforce local expiry when the token came from the stored config; an
+    # explicit --token / env override has no known expiry, so trust it.
+    if state.token == state.config.session_token and cfgmod.is_expired(state.config):
+        raise AuthError("Session expired. Run 'agenteye login'.")
+    return build_context(state)
+
+
+def resolve_dates(
+    since: Optional[str], ts_from: Optional[str], ts_to: Optional[str]
+) -> Tuple[Optional[str], Optional[str]]:
+    try:
+        return _dates.resolve_range(since, ts_from, ts_to)
+    except ValueError as exc:
+        raise click.BadParameter(str(exc))

agenteye_cli/_version.py

@@ -0,0 +1 @@
+__version__ = "0.1.0b1"

agenteye_cli/app.py

@@ -0,0 +1,92 @@
+"""Typer application: global options + command registration."""
+
+from __future__ import annotations
+
+from typing import Optional
+
+import typer
+
+from . import config as cfgmod
+from . import output
+from ._context import AppState
+from ._version import __version__
+from .commands import (
+    auth_cmds,
+    env_cmds,
+    evals_cmds,
+    events_cmds,
+    jobs_cmds,
+    sessions_cmds,
+)
+
+app = typer.Typer(
+    no_args_is_help=True,
+    add_completion=False,
+    help="Query the AgentEye dashboard — sessions, events, and evaluations — from your terminal.",
+)
+session_app = typer.Typer(no_args_is_help=True, help="Inspect or export a single session.")
+app.add_typer(session_app, name="session")
+
+
+def _version_callback(value: bool) -> None:
+    if value:
+        print(__version__)
+        raise typer.Exit()
+
+
+@app.callback()
+def main(
+    ctx: typer.Context,
+    json_output: bool = typer.Option(
+        False, "--json", envvar="AGENTEYE_CLI_JSON", help="Emit JSON to stdout instead of a table."
+    ),
+    base_url: Optional[str] = typer.Option(
+        None,
+        "--base-url",
+        envvar="AGENTEYE_DASHBOARD_URL",
+        metavar="URL",
+        help="Dashboard base URL (default http://localhost:3000).",
+    ),
+    token: Optional[str] = typer.Option(
+        None, "--token", envvar="AGENTEYE_CLI_TOKEN", help="Session token override (for CI/agents)."
+    ),
+    timeout: float = typer.Option(30.0, "--timeout", help="HTTP timeout in seconds."),
+    no_color: bool = typer.Option(
+        False, "--no-color", envvar="NO_COLOR", help="Disable coloured output."
+    ),
+    quiet: bool = typer.Option(False, "--quiet", "-q", help="Suppress status messages on stderr."),
+    version: bool = typer.Option(
+        False, "--version", callback=_version_callback, is_eager=True, help="Show version and exit."
+    ),
+) -> None:
+    """Resolve global options into the per-invocation AppState (flag > env > config > default)."""
+    cfg = cfgmod.load_config()
+    output.configure(no_color=no_color, quiet=quiet)
+    ctx.obj = AppState(
+        json=json_output,
+        base_url=base_url or cfg.base_url or cfgmod.DEFAULT_BASE_URL,
+        token=token or cfg.session_token,
+        timeout=timeout,
+        config=cfg,
+    )
+
+
+@app.command()
+def version() -> None:
+    """Show the CLI version."""
+    print(__version__)
+
+
+@app.command("help")
+def help_cmd(ctx: typer.Context) -> None:
+    """Show top-level help and available commands."""
+    parent = ctx.parent
+    typer.echo((parent or ctx).get_help())
+
+
+auth_cmds.register(app)
+events_cmds.register(app)
+evals_cmds.register(app)
+sessions_cmds.register(app, session_app)
+jobs_cmds.register(app)
+env_cmds.register(app)

agenteye_cli/auth.py

@@ -0,0 +1,134 @@
+"""Email-OTP device login against the dashboard.
+
+Flow: ``/api/auth/otp/request`` (sends a code) then ``/api/auth/otp/verify``.
+The verify response carries the session token in the ``ae_session`` **Set-Cookie**
+header (not the JSON body), so we read it from ``response.cookies``.
+"""
+
+from __future__ import annotations
+
+from datetime import datetime, timedelta, timezone
+from typing import Any, Dict, Optional, Tuple
+
+import httpx
+
+from .config import CliConfig, save_config
+from .errors import ApiError, AuthError, NetworkError
+
+
+def _iso(dt: datetime) -> str:
+    return dt.astimezone(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
+
+
+def _network_error(base_url: str, exc: Exception) -> NetworkError:
+    return NetworkError(f"Cannot reach the AgentEye dashboard at {base_url}: {exc}")
+
+
+def request_otp(
+    base_url: str,
+    email: str,
+    *,
+    timeout: float = 30.0,
+    transport: Optional[httpx.BaseTransport] = None,
+) -> None:
+    """Ask the dashboard to email a login code. Always succeeds quietly for a
+    valid request (the server returns 200 even for unknown emails)."""
+    try:
+        with httpx.Client(base_url=base_url.rstrip("/"), timeout=timeout, transport=transport) as client:
+            response = client.post("/api/auth/otp/request", json={"email": email})
+    except httpx.RequestError as exc:
+        raise _network_error(base_url, exc)
+    if response.status_code >= 400:
+        raise ApiError(
+            f"Failed to request a login code (HTTP {response.status_code}).",
+            status=response.status_code,
+        )
+
+
+def verify_otp(
+    base_url: str,
+    email: str,
+    code: str,
+    *,
+    timeout: float = 30.0,
+    transport: Optional[httpx.BaseTransport] = None,
+) -> Tuple[str, int, Dict[str, Any]]:
+    """Exchange the code for a session token. Returns ``(token, expires_in_secs, user)``."""
+    try:
+        with httpx.Client(base_url=base_url.rstrip("/"), timeout=timeout, transport=transport) as client:
+            response = client.post(
+                "/api/auth/otp/verify", json={"email": email, "code": code}
+            )
+    except httpx.RequestError as exc:
+        raise _network_error(base_url, exc)
+
+    if response.status_code == 401:
+        raise AuthError("Invalid or expired login code.")
+    if response.status_code >= 400:
+        raise ApiError(
+            f"Login verification failed (HTTP {response.status_code}).",
+            status=response.status_code,
+        )
+
+    token = response.cookies.get("ae_session")
+    if not token:
+        raise AuthError("The dashboard did not return a session token.")
+
+    try:
+        body = response.json()
+    except Exception:
+        body = {}
+    if not isinstance(body, dict):
+        body = {}
+
+    try:
+        expires_in = int(body.get("expires_in_secs"))
+    except (TypeError, ValueError):
+        expires_in = 86400
+
+    user = body.get("user") or {}
+    if not isinstance(user, dict):
+        user = {}
+
+    return token, expires_in, user
+
+
+def persist_session(
+    cfg: CliConfig,
+    base_url: str,
+    token: str,
+    expires_in_secs: int,
+    user: Dict[str, Any],
+    *,
+    now: Optional[datetime] = None,
+) -> CliConfig:
+    now = now or datetime.now(timezone.utc)
+    cfg.base_url = base_url
+    cfg.session_token = token
+    cfg.expires_at = _iso(now + timedelta(seconds=expires_in_secs))
+    cfg.email = (user or {}).get("email") or cfg.email
+    cfg.user_id = (user or {}).get("id") or cfg.user_id
+    save_config(cfg)
+    return cfg
+
+
+def logout(
+    base_url: str,
+    token: Optional[str],
+    *,
+    timeout: float = 30.0,
+    transport: Optional[httpx.BaseTransport] = None,
+) -> None:
+    """Best-effort server-side session revocation; never raises."""
+    if not token:
+        return
+    try:
+        with httpx.Client(
+            base_url=base_url.rstrip("/"),
+            cookies={"ae_session": token},
+            timeout=timeout,
+            transport=transport,
+        ) as client:
+            client.post("/api/auth/logout")
+    except httpx.RequestError:
+        pass