Metadata-Version: 2.4
Name: kneo-dash
Version: 0.2.0
Summary: Backend-for-frontend for Kneo Agent Dashboard, built on kneo-client
Author: Kneron, Inc. and kneo-dash contributors
License-Expression: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: FastAPI
Classifier: Intended Audience :: System Administrators
Classifier: Programming Language :: Python :: 3.12
Classifier: Typing :: Typed
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: kneo-client<2.0.0,>=1.0.0
Requires-Dist: fastapi>=0.115
Requires-Dist: uvicorn[standard]>=0.30
Requires-Dist: sse-starlette>=2.1
Requires-Dist: pydantic>=2.0
Requires-Dist: pydantic-settings>=2.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
Requires-Dist: httpx>=0.27; extra == "dev"
Requires-Dist: respx>=0.21; extra == "dev"
Requires-Dist: ruff>=0.8; extra == "dev"
Requires-Dist: mypy>=1.10; extra == "dev"
Dynamic: license-file

# kneo-dash

The **backend-for-frontend (BFF)** for the **Kneo Agent Dashboard** — the
operational console for the [Kneo Agent Platform](https://github.com/kneo-agent).
A thin FastAPI layer over the typed [`kneo-client`](https://pypi.org/project/kneo-client/)
SDK: it answers an operator's five questions — *what is running, what is stuck,
what needs human action, what changed, is production healthy* — and serves the
dashboard SPA. It never imports `kneo-serv` and never puts platform API keys in
the browser.

This package is normally run as the container image
`ghcr.io/kneo-agent/kneo-dash` (BFF + built SPA in one unit); the wheel is
published for library/embedding use.

## Install

```bash
pip install kneo-dash
```

## Run

The platform connection comes from the `kneo-client` profile environment
(`KNEO_URL` + `KNEO_API_KEY`, or a `~/.config/kneo/client.toml` profile):

```bash
KNEO_URL=https://your-kneo-serv KNEO_API_KEY=… kneo-dash   # serves the BFF on :8090
```

Dashboard-server settings use the `KNEO_DASH_` env prefix (e.g.
`KNEO_DASH_DEFAULT_PROFILE`, `KNEO_DASH_CORS_ORIGINS`, `KNEO_DASH_SPA_DIR`).

## Scope (0.2.0)

**Live debugging · actions · launch.** Runs list + detail (status · trace ·
checkpoints · run-graph · continuation chain · replay/recovery · time-travel
diff), a **live SSE trace tail**, **run control** (Stop/Resume), the
**human-in-the-loop** queue + task detail + resume, and **Launch**
(Load → Deploy → Run) — plus per-run token usage and health. The governance
surfaces (audit · policies · credentials) are enveloped-`501` scaffolds until
0.3.0; auth/OIDC + RBAC + the multi-env switcher are 0.4.0.

## Links

- Source & docs: <https://github.com/kneo-agent/kneo-dash>
- License: MIT
