Interface: LocalNamespace

Defined in: node/src/builders/local-namespace-contract.ts:37

Public local.* DSL builder namespace exported by @paraharness/node.

Provides declarative builders for local OS process pools (local.runner), one-shot commands (local.command), streaming verification checks (local.streamCheck), background daemons (local.daemon), subprocess policy guards (local.allowBinaries, local.denyNetwork), and MCP transports (local.mcpStdio, local.mcpSse).

Methods

allowBinaries()

allowBinaries(binaries): AstBuilder<NodeAllowBinariesNode> & NodeAllowBinariesNode;

Defined in: node/src/builders/local-namespace-contract.ts:93

Creates a policy guard restricting subprocess execution to an explicit allowlist of binaries.

Compiles to NodeAllowBinariesNode (type: 'node:allow-binaries').

Parameters

Parameter	Type	Description
binaries	readonly string[]	Allowed executable binary names.

Returns

AstBuilder<NodeAllowBinariesNode> & NodeAllowBinariesNode

Frozen allow-binaries guard node.

---

command()

command(id): LocalCommandBuilder<unknown, unknown, unknown>;

Defined in: node/src/builders/local-namespace-contract.ts:58

Creates a fluent builder for a one-shot local OS subprocess command (local.command(id)).

Compiles to LocalCommandNode and supports .asCheck() and .asTool() projections.

Parameters

Parameter	Type	Description
id	string	Unique identifier of the command.

Returns

LocalCommandBuilder<unknown, unknown, unknown>

Fluent command builder.

---

daemon()

daemon(id): LocalDaemonBuilder;

Defined in: node/src/builders/local-namespace-contract.ts:82

Creates a fluent builder for a lifecycle-bound background daemon service (local.daemon(id)).

Manages dynamic port allocation, hash-suffixed scopeKey sanitization, TCP readiness, and PTY interactions.

Parameters

Parameter	Type	Description
id	string	Unique identifier of the daemon service.

Returns

LocalDaemonBuilder

Fluent daemon builder.

---

denyNetwork()

denyNetwork(): AstBuilder<NodeDenyNetworkNode> & NodeDenyNetworkNode;

Defined in: node/src/builders/local-namespace-contract.ts:104

Creates a policy guard denying outbound network access for guarded subprocesses.

Compiles to NodeDenyNetworkNode (type: 'node:deny-network').

Returns

AstBuilder<NodeDenyNetworkNode> & NodeDenyNetworkNode

Frozen deny-network guard node.

---

mcpSse()

mcpSse(options): AstBuilder<NodeMcpSseNode> & NodeMcpSseNode;

Defined in: node/src/builders/local-namespace-contract.ts:126

Creates an MCP HTTP/SSE control-plane descriptor (local.mcpSse).

Compiles to NodeMcpSseNode (type: 'node:mcp-sse').

Parameters

Parameter	Type	Description
options	McpServerOptions	TCP port configuration.

Returns

AstBuilder<NodeMcpSseNode> & NodeMcpSseNode

Frozen MCP SSE control-plane node.

---

mcpStdio()

mcpStdio(serverName?): AstBuilder<NodeMcpStdioNode> & NodeMcpStdioNode;

Defined in: node/src/builders/local-namespace-contract.ts:115

Creates an MCP stdio control-plane descriptor (local.mcpStdio).

Compiles to NodeMcpStdioNode (type: 'node:mcp-stdio').

Parameters

Parameter	Type	Description
serverName?	string	Logical MCP server name.

Returns

AstBuilder<NodeMcpStdioNode> & NodeMcpStdioNode

Frozen MCP stdio control-plane node.

---

runner()

runner(options): LocalRunnerBuilder;

Defined in: node/src/builders/local-namespace-contract.ts:47

Creates a local OS subprocess and daemon concurrency pool (local.runner).

Separates one-shot command slots (slots) from long-lived daemon slots (maxDaemons).

Parameters

Parameter	Type	Description
options	LocalRunnerOptions	Runner pool concurrency options.

Returns

LocalRunnerBuilder

Frozen runner pool builder.

---

streamCheck()

streamCheck<THandle>(id): LocalStreamCheckBuilder<THandle>;

Defined in: node/src/builders/local-namespace-contract.ts:71

Creates a fluent builder for a streaming subprocess check (local.streamCheck(id)).

Streams combined stdout and stderr through a rolling multi-line regex circuit breaker.

Type Parameters

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

Parameters

Parameter	Type	Description
id	string	Unique identifier of the streaming check.

Returns

LocalStreamCheckBuilder<THandle>

Fluent stream check builder.