Runtime Surface

Last updated: 2026-03-22

The important distinction is:

Public operator install

Install the framework product like this:

npm install -g @tetsuo-ai/agenc
agenc onboard
agenc start
agenc
agenc ui

What those commands mean:

- canonical first-run onboarding flow - writes ~/.agenc/config.json - generates the curated workspace profile under ~/.agenc/workspace/

- attaches the terminal operator console

- opens or prints the daemon-backed dashboard URL on /ui/

For remote shells and automation:

agenc ui --no-open

Single runtime authority

The current product contract is local-daemon-first:

not allowed to fork into a second authority

Public builder boundary

External builders should not treat @tetsuo-ai/runtime as the extension story.

Use these public surfaces instead:

Internal implementation packages such as @tetsuo-ai/runtime, @tetsuo-ai/mcp, and @tetsuo-ai/docs-mcp remain kernel or repo-internal.

Task Validation V2

The runtime understands both immediate public completion and reviewed public completion.

submitTaskResult() instead of sending complete_task

external attestation for an open public task

validateTaskResult() resolve reviewed submissions explicitly

private settlement

Use /docs/architecture/flows/task-lifecycle for the full state transitions.

Current support matrix

Current public wrapper support:

Validated release lanes:

First-party connector lifecycle

The first supported built-in connector is Telegram.

agenc connector list
agenc connector status telegram
agenc connector add telegram --bot-token-env TELEGRAM_BOT_TOKEN
agenc connector remove telegram

For non-interactive environments:

printf '%s' "$TELEGRAM_BOT_TOKEN" | agenc connector add telegram --bot-token-stdin

Connector health is visible from both CLI and dashboard.

Marketplace routing note

The current agenc-core implementation also documents internal marketplace operator routing:

Those flows are implementation details in agenc-core. The public operator install contract still starts with @tetsuo-ai/agenc and the agenc CLI.

Canonical local state

The current operator home is ~/.agenc/.

Important paths:

Legacy .agenc-runtime.json should be treated as compatibility input only, not as the current default.

Where to go for source-of-truth details

For the implementation contract, use: