Studio
Inspect a local Runtime through an authenticated Studio proxy.
Attach Studio to a running Runtime:
nylorun studio@nylorun/studio is an optional local dashboard. The CLI loads the
application-installed Studio package and talks to Runtime through a trusted
local proxy. Runtime credentials stay in that proxy, not the browser bundle.
nylorun studio resolves the active project scope. --runtime-url is an
optional override, not required when a local Runtime is already in .nylorun/.
Pass --no-open to skip the browser. Studio attachment does not start
Runtime. Generated projects expose the same command as npm run studio.
The published usage line also mentions --port for Studio; the implemented
flag is --studio-port. Default listen port starts at 4161.
Run Studio and Runtime on the same development machine. Studio binds loopback and accepts only a loopback Runtime destination. Do not expose Studio or a development Runtime as an unauthenticated public service.
What Studio does
Studio lists registered agents and sessions, sends text, displays completed
assistant responses and tool inputs/results, restores history, observes
canonical SSE events, and cancels a turn. Each session shows chat beside an
Events inspector (/items + live /events) and an optional Agent Manifest
tab. When an agent is used as a tool, Studio shows delegation.started /
delegation.completed, labels child actions with their agent, and can filter
events by agent. Model Settings lists vault-stored providers and can switch
the active provider/model.
Responses appear when complete. This release does not include token streaming, media, an approvals UI, or a remote Cloud dashboard.
Manifest inspection is a capability catalog: manifestSchemaVersion is 4;
manifest.capabilities rows include id, type, tool schemas, and
hooks: { at, scope }[].
Local Runtime routes Studio uses (server-authenticated):
| Endpoint | Purpose |
|---|---|
GET /v1/agents | Saved agent manifests |
GET /v1/sessions?agentId=... | Sessions for one agent |
GET /v1/sessions/:id | Session status, waits, and uncertainty |
POST /v1/sessions/:id/commands | Session commands (content, not text) |
GET /v1/sessions/:id/events | Canonical SSE history |
GET /v1/sessions/:id/items | History page (?agent= filters a delegated agent) |
GET /v1/host/model | Active provider metadata (no secret) |
PUT /v1/host/model | Store a host provider credential |
PUT /v1/host/model/selection | Switch the active provider/model |
Keep keys, cookies, headers, and raw provider payloads out of Studio configuration, manifests, and events.
Local development tool
Studio is optional and is not started by nylorun serve. Do not treat it as
an unauthenticated production dashboard.
Start from the host
Creator and npm run dev start Studio after Runtime is ready. To attach it
later:
npm run studioStart a new session after changing definitions or implementations.
Studio has no public TypeScript API in these docs. The CLI is documented in CLI.