Runner and PlugsReference
Configuration keys
Every key of blaise.yml, generated from its JSON schema.
Every key that blaise.yml accepts. The file is checked against this schema when the runner starts.
Editors can use the same schema for completion: it is published as agent-config.v1.schema.json in
@blaiseagent/runner. The prose reference is Configuration.
A key that accepts expressions takes a ${{ }} expression wherever it takes a plain value. Keys
under setup[] describe one entry of the setup list.
| Key | Type | Required | Expressions | Description |
|---|---|---|---|---|
version | 1 | yes | no | Format version of this file. |
server | object | no | no | Connection to Blaise. |
server.url | string | no | yes | Base URL of the Blaise server. |
server.token | string | no | yes | Runner token. Overrides the credential stored by blaise-agent login. Prefer an expression such as ${{ env.BLAISE_RUNNER_TOKEN }} to a literal token. |
log | object | no | no | Runner logging. |
log.level | trace, debug, info, warn, error, fatal | no | yes | Minimum level to emit. |
log.format | pretty, json | no | yes | Output format. Auto-detected from the TTY when unset. |
labels | object | no | no | Labels this runner declares, as key/value pairs. A value is a string or a list of strings. Agents state label requirements; a session runs on a runner whose labels include every required value. Values may use ${{ env.* }} expressions. |
capacity | integer | no | no | Maximum number of sessions this runner instance runs at once. Omit for no limit. Blaise offers work to the instance with the most free capacity first and never beyond this number. |
agent | object | no | no | The ACP agent to launch, layered over the adapter configuration sent by Blaise. Expressions are evaluated when a run starts. |
agent.driver | string | no | no | The ACP agent driver to launch, e.g. claude. |
agent.command | string | no | no | Executable that starts the ACP agent. Overrides the driver's default. |
agent.args | list of string | no | no | Arguments for command. |
setup | list of object | no | no | Ordered list of plugs. |
setup[].id | string | no | no | Unique name. Used to read the plug's outputs (setup.<id>.outputs.*) and to key its persisted state. Required for plugs that persist state. |
setup[].use | string | yes | no | The plug: blaise:<name>, a path (./x.ts) or a package specifier. Third-party scoped packages must be quoted in YAML. |
setup[].with | object | no | no | Inputs, validated by the plug's own schema. May contain ${{ }} expressions. |