Skip to content

@usine/agents/preflight

const CODEX_CLI_VERSION: "0.144.0" = "0.144.0"

Baseline Codex CLI version used by the pinned app-server protocol conformance gate.


const preflight: (brain, host, environment) => Effect.Effect<HarnessReady, HarnessUnavailableError | SessionOperationError, ChildProcessSpawner>

Checks only the requested brain where host runs children, with environment and the worker user’s configuration, without running a prompt or logging in.

Parameter Type
brain BrainSpec
host ChildHost
environment Readonly<Record<string, string>>

Effect.Effect<HarnessReady, HarnessUnavailableError | SessionOperationError, ChildProcessSpawner>


const verifyHarness: (brain, host, environment) => Effect.Effect<HarnessReady, HarnessUnavailableError | SessionOperationError, ChildProcessSpawner | CodexAppServer | PiSdk>

Verifies a rostered brain where host runs children, through supplied process and SDK services; starts no prompt. Every check process sees environment as a child would: as its complete environment on this machine, or exported on top of a remote host’s own (ADR 0011). Pi children run their tools in this process, so a remote host cannot run them.

Parameter Type
brain BrainSpec
host LocalProcess | RemoteShell
environment Readonly<Record<string, string>>

Effect.Effect<HarnessReady, HarnessUnavailableError | SessionOperationError, ChildProcessSpawner | CodexAppServer | PiSdk>