Apps

An App turns a Harness + Agent pair into a deployed service that responds to external messages. The App owns the channel-specific binding (Slack, webhook, schedule, AG-UI), the inbound auth, the session-routing strategy, and the publish/unpublish lifecycle.

The same agent can back multiple apps (e.g., a Slack deployment and a webhook deployment), and each app’s lifecycle is independent.

App Architecture

How it works

An external channel sends a request to the app’s endpoint.
The app verifies the request using channel-specific auth (signing secret, OIDC, mTLS, etc.).
A session is found or created according to the session strategy.
The agent processes the message and the response flows back through the channel.

Channels

Channel	Status	What it does
Slack	Available	Deploy as a Slack bot
AG-UI	Available	AG-UI inbound channel
Schedule	Available	Cron-triggered invocation into an app-owned session
Webhook	Available	HTTP-triggered invocation
WhatsApp	Planned	—
Web Widget	Planned	—

See Slack Integration for the Slack-side setup.

Session routing

Each channel chooses how incoming messages map to sessions:

Strategy	Behaviour	Use when
`per_thread` (default)	Each thread is its own session	Support bots, Q&A
`per_channel`	One session per channel	Persistent channel assistant
`per_user`	One session per user	Personal assistant

Schedule and webhook channels use their own routing model (shared session vs. per-invocation).

Lifecycle

draft → published → draft → archived

Draft: configured but does not accept incoming requests.
Published: live; webhook requests are processed.
Archived: soft-deleted and hidden from listings.

Unpublishing stops new message processing; existing sessions remain accessible.

Reference

Method	Path	Description
POST	`/v1/apps`	Create app
GET	`/v1/apps`	List apps
GET	`/v1/apps/{app_id}`	Get app
PATCH	`/v1/apps/{app_id}`	Update app
DELETE	`/v1/apps/{app_id}`	Archive
POST	`/v1/apps/{app_id}/publish`	Publish
POST	`/v1/apps/{app_id}/unpublish`	Unpublish

Full request/response schemas in the API reference.

Do something

Publish an agent as a Slack app — end-to-end deployment.
Slack Integration — Slack-side manifest and OAuth setup.