Interface: LocalStreamCheckBuilder<THandle>

Defined in: node/src/builders/local-stream-check-builder.ts:29

Fluent builder for a streaming subprocess verification check (local.streamCheck(id)).

Streams stdout and stderr into a combined rolling multi-line buffer, supports early circuit-breaking on failure stack traces, and projects into a post-flight-diffed tool via .asTool().

Extends

• AstBuilder<LocalStreamCheckNode<THandle>>

Type Parameters

Type Parameter	Default type	Description
THandle	unknown	Runtime handle type of the active isolation scope.

Methods

argv()

argv(args): LocalStreamCheckBuilder<THandle>;

Defined in: node/src/builders/local-stream-check-builder.ts:54

Binds the command argument vector executed by the streaming check.

Index 0 of args specifies the executable binary and subsequent entries are arguments.

Parameters

Parameter	Type	Description
args	readonly string[]	Command argument vector.

Returns

LocalStreamCheckBuilder<THandle>

Updated immutable stream check builder.

---

asTool()

asTool(): AstBuilder<LocalStreamCheckToolNode<THandle>> & LocalStreamCheckToolNode<THandle>;

Defined in: node/src/builders/local-stream-check-builder.ts:102

Projects this streaming check into a post-flight-diffed LocalStreamCheckToolNode (type: 'node:stream-check-tool').

Sets effectTracking: 'subprocess-post-flight' and omits describeEffects so workspace mutations performed during a test run are verified post-flight via CheckpointableScope.diffEffects().

Returns

AstBuilder<LocalStreamCheckToolNode<THandle>> & LocalStreamCheckToolNode<THandle>

Tool builder and AST descriptor.

---

circuitBreakWhenStdout()

circuitBreakWhenStdout(pattern, options?): LocalStreamCheckBuilder<THandle>;

Defined in: node/src/builders/local-stream-check-builder.ts:89

Configures a rolling-window regular expression circuit breaker over combined stdout and stderr.

When pattern matches across the rolling stream buffer, collects options.graceLinesAfterMatch (defaulting to 25) trailing lines, kills the process group, and fails the check immediately.

Parameters

Parameter	Type	Description
pattern	string | RegExp	Regular expression or pattern string to match.
options?	LocalStreamCheckCircuitBreakerOptions	Optional trailing grace line capture configuration.

Returns

LocalStreamCheckBuilder<THandle>

Updated immutable stream check builder.

---

env()

env(envVars): LocalStreamCheckBuilder<THandle>;

Defined in: node/src/builders/local-stream-check-builder.ts:65

Binds static string or symbolic EnvRef environment variables injected into the subprocess.

Symbolic EnvRef entries are resolved via ctx.resolveEnv at check invocation time.

Parameters

Parameter	Type	Description
envVars	Readonly<Record<string, string | EnvRef>>	Environment variable map.

Returns

LocalStreamCheckBuilder<THandle>

Updated immutable stream check builder.

---

runner()

runner(runner): LocalStreamCheckBuilder<THandle>;

Defined in: node/src/builders/local-stream-check-builder.ts:43

Binds the NodeRunnerNode pool governing concurrency slots for this streaming check.

Acquires a one-shot command slot via RunnerDriver.withSlot when the check runs.

Parameters

Parameter	Type	Description
runner	MaybeBuilder<NodeRunnerNode>	Runner pool AST node or builder.

Returns

LocalStreamCheckBuilder<THandle>

Updated immutable stream check builder.

---

timeoutMinutes()

timeoutMinutes(minutes): LocalStreamCheckBuilder<THandle>;

Defined in: node/src/builders/local-stream-check-builder.ts:76

Sets the wall-clock timeout in minutes before the streaming subprocess group is terminated.

Sends SIGTERM followed by SIGKILL to the detached process group when the timeout expires.

Parameters

Parameter	Type	Description
minutes	number	Positive timeout duration in minutes.

Returns

LocalStreamCheckBuilder<THandle>

Updated immutable stream check builder.

---

toAST()

toAST(): LocalStreamCheckNode;

Defined in: core/dist/ast/ast-builder.d.ts:19

Compiles the current builder configuration into a deeply frozen passive AST node.

Validates required builder invariants at compilation time and returns an immutable plain-object AST representation containing zero execution methods.

Returns

LocalStreamCheckNode

Deeply frozen passive AST node.

Inherited from

AstBuilder.toAST

Properties

Property	Modifier	Type	Description	Defined in
id	readonly	string	Unique identifier of the streaming check.	node/src/builders/local-stream-check-builder.ts:32