Serving agents

Harnest gives managed and advanced agents the same development server, neutral API, events, and playground.

harnest serve AGENT_DIR

harnest compile AGENT_DIR --output .harnest/my-agent
.harnest/my-agent/harnest-agent

Server configuration

Configure the bind, timeout, concurrency, limits, and playground.

Use sessions, JSON responses, SSE streams, and live WebSockets.

Expose business-specific FastAPI routes through the managed agent runtime.

Handle required actions and resume suspended work.

Add authentication, durable storage, TLS, supervision, and network policy.

Mode	Start with	Receive
JSON	`POST /responses`	One completed response
SSE	`POST /responses` with `"stream": true`	Named `response.*` events
WebSocket	Connect to `/live`, then send `response.create`	The same events over a live channel

Input and output Pydantic schemas apply to every mode and OpenAPI.