@usine/executor/local

Interfaces

LocalExecutorOptions

Storage and session settings for Attempts executed on the local machine.

Properties

harnessReadiness?

readonly optional harnessReadiness?: HarnessProbe

Probes one rostered brain on this machine; defaults to the @usine/agents/preflight checks, which start no prompt.

instanceDirectory

readonly instanceDirectory: string & Brand<"InstanceDirectory">

Factory folder under which local Worker caches and Attempt checkouts are stored.

interruptGrace?

readonly optional interruptGrace?: Input

Grace for the parent task’s cancellation, then for the Attempt to settle; each wait is bounded separately. Defaults to two seconds.

repositoryUrl?

readonly optional repositoryUrl?: (repository) => string

Repository fetch URL override, for example a local mirror; defaults to the GitHub HTTPS clone URL.

Parameters

Parameter	Type
repository	string & Brand<"RepositoryName">

Returns

string

Type Aliases

HarnessProbe

HarnessProbe = (brain) => Effect.Effect<HarnessReadiness, ExecutorOperationError | WorkerCapabilityError>

Reports one rostered brain’s readiness on a Worker. Only a readiness report proves a capability gap; transport failures and timeouts stay retryable infrastructure errors.

Parameters

Parameter	Type
brain	BrainSpec

Returns

Effect.Effect<HarnessReadiness, ExecutorOperationError | WorkerCapabilityError>

Variables

layer

const layer: (options) => Layer.Layer<Executor, never, AttemptRuntime | CredentialProvider | FileSystem.FileSystem | Path.Path | ChildProcessSpawner.ChildProcessSpawner>

Runs Attempts in isolated checkouts on the local machine, each with its Pi parent as a durable task in this process (AttemptRuntime), so an orchestrator restart reattaches a live Attempt instead of failing it. Requires Node; worker contracts are platform-free.

Parameters

Parameter	Type
options	LocalExecutorOptions

Returns

Layer.Layer<Executor, never, AttemptRuntime | CredentialProvider | FileSystem.FileSystem | Path.Path | ChildProcessSpawner.ChildProcessSpawner>