Skip to content

@usine/core/agent/brain

How an Agent session runs: its coding harness, model, and reasoning effort.

  • Schema.Class

new BrainSpec(…args): BrainSpec

Parameter Type
…args [props: object, options?: MakeOptions]

BrainSpec

readonly effort: "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max"

readonly harness: "claude" | "codex" | "pi"

readonly model: string & Brand<"ModelId">

Effort = typeof Effort.Type

The requested amount of reasoning for a session; available levels depend on its harness and model.


Harness = typeof Harness.Type

The coding runtime that executes an Agent session.


ModelId = typeof ModelId.Type

A provider’s model name; the selected harness checks its availability when the session starts.

const Effort: Schema.Literals<readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"]>

The requested amount of reasoning for a session; available levels depend on its harness and model.


const EFFORTS: readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"]

Reasoning levels accepted in Agent files; support depends on the chosen harness and model.


const Harness: Schema.Literals<readonly ["claude", "codex", "pi"]>

The coding runtime that executes an Agent session.


const HARNESSES: readonly ["claude", "codex", "pi"]

Coding runtimes an Agent can select for delegated work.


const ModelId: Schema.brand<Schema.String, "ModelId">

A provider’s model name; the selected harness checks its availability when the session starts.