@paraharness/node

Variables

Variable	Description
DEFAULT_SUBPROCESS_GRACE_MS	Grace period in milliseconds between SIGTERM and SIGKILL during process-group termination.
ISOLATED_GIT_ENV_OVERRIDES	Static isolated GIT_* environment overrides injected when a scope handle provides worktreePath.
local	Frozen local.* DSL builder namespace for @paraharness/node.
mcp	Frozen mcp.* DSL builder namespace for @paraharness/node.
nodeExecutors	Default frozen RuntimeExecutorRegistrySlice instance for @paraharness/node.

Functions

Function	Description
allocateDynamicPorts	Allocates distinct, conflict-free dynamic TCP ports for all named .port(name) entries on a daemon.
createAllowBinariesBuilder	Creates a policy guard builder and passive AST node restricting subprocess binaries (local.allowBinaries).
createDenyNetworkBuilder	Creates a policy guard builder and passive AST node denying outbound network access (local.denyNetwork).
createLocalCommandBuilder	Creates a fluent LocalCommandBuilder for local.command(id).
createLocalCommandToolDriver	Creates the ToolDriver for LocalCommandToolNode (type: 'node:command-tool').
createLocalDaemonBuilder	Creates a fluent LocalDaemonBuilder for local.daemon(id).
createLocalRunnerBuilder	Creates a LocalRunnerBuilder for local.runner({ id?, slots, maxDaemons? }).
createLocalServiceToolDriver	Creates the ToolDriver for LocalServiceToolNode (type: 'node:service-tool').
createLocalStreamCheckBuilder	Creates a fluent LocalStreamCheckBuilder for local.streamCheck(id).
createLocalStreamCheckToolDriver	Creates the ToolDriver for LocalStreamCheckToolNode (type: 'node:stream-check-tool').
createMcpServerBuilder	Creates an HTTP / MCP control-plane builder and passive AST node (mcp.server({ port })).
createMcpSseBuilder	Creates an MCP HTTP/SSE control-plane builder and passive AST node (local.mcpSse({ port })).
createMcpStdioBuilder	Creates an MCP stdio control-plane builder and passive AST node (local.mcpStdio(serverName)).
createNodeExecutors	Creates a RuntimeExecutorRegistrySlice registering all @paraharness/node executors and drivers.
createNodeHttpControlPlaneAdapter	Creates a ControlPlaneAdapter for NodeHttpControlPlaneNode (mcp.server({ port })).
createNodeMcpSseAdapter	Creates a ControlPlaneAdapter for NodeMcpSseNode (local.mcpSse({ port })).
createNodeMcpStdioAdapter	Creates a ControlPlaneAdapter for NodeMcpStdioNode (local.mcpStdio(serverName)).
evaluateNodeAllowBinariesGuard	Evaluates a NodeAllowBinariesNode (type: 'node:allow-binaries') policy guard against proposed tool effects.
evaluateNodeDenyNetworkGuard	Evaluates a NodeDenyNetworkNode (type: 'node:deny-network') policy guard against proposed tool effects.
executeLocalCommandCheck	Executes a LocalCommandCheckNode (type: 'node:command-check') as a deterministic check gate.
executeLocalCommandStep	Executes a LocalCommandNode (type: 'node:command') inside its configured runner pool slot.
executeLocalStreamCheck	Executes a LocalStreamCheckNode (type: 'node:stream-check') inside its runner pool slot.
resolveWorktreeEnvAndCwd	Resolves the subprocess working directory and environment map from the active scopeHandle and envConfig.
sanitizeDaemonScopeKey	Sanitizes a raw isolation scopeKey into a collision-free daemon container/resource identifier.
spawnDetachedSubprocess	Spawns a detached OS subprocess group (detached: true) with piped stdout and stderr.
startLocalDaemonService	Starts a LocalServiceNode (type: 'node:service') inside a long-lived runner daemon slot.
terminateProcessGroupWithGrace	Terminates a detached child process group and descendant PID tree gracefully (pidtree + fkill).
waitForTcpPortReady	Waits for 127.0.0.1:port to accept TCP connections via wait-on or rejects on timeout/abort.

Classes

Class	Description
NodeRunnerDriver	Runtime concurrency limiter implementing RunnerDriver for NodeRunnerNode (local.runner).
PtyFramedInteractiveSession	Stateful ECHO-disabled OS pseudo-terminal session managing framed turn-based CLI communication (local.daemon.interact).

Interfaces

Interface	Description
LocalCommandBuilder	Fluent builder for a one-shot local OS subprocess command (local.command(id)).
LocalCommandCheckNode	Passive AST node adapting a LocalCommandNode into a deterministic CheckASTNode (cmd.asCheck()).
LocalCommandNode	Passive AST node representing a one-shot local OS subprocess command (local.command).
LocalCommandToolNode	Passive AST node adapting a LocalCommandNode into a post-flight-diffed ToolASTNode (cmd.asTool()).
LocalCommandUnrepeatableConfig	Idempotency guard configuration on LocalCommandNode that skips execution when preCheckCmd returns true.
LocalCommandUnrepeatableOptions	Options for configuring an idempotency guard on local.command().unrepeatable(preCheckCmd, options).
LocalDaemonBuilder	Fluent builder for a lifecycle-bound background daemon service (local.daemon(id)).
LocalDaemonCommandContext	Runtime context supplied to local.daemon .start(), .stopCommand(), and .interact() command factories.
LocalDaemonInteractOptions	Configuration options for registering a framed PTY interaction tool on local.daemon(id).interact(toolName, options).
LocalDaemonRegexDescriptor	Serializable regular expression descriptor used for frameDelimiter when specified as a pattern record.
LocalNamespace	Public local.* DSL builder namespace exported by @paraharness/node.
LocalRunnerBuilder	Fluent builder and passive descriptor for a local OS subprocess runner pool (local.runner).
LocalRunnerOptions	Configuration options for creating a local OS subprocess and daemon runner pool (local.runner).
LocalServiceInteractionConfig	Framed pseudo-terminal (PTY) interaction tool specification exposed by a LocalServiceNode.
LocalServiceNode	Passive AST node representing a lifecycle-bound background daemon service (local.daemon).
LocalServiceToolNode	Passive AST node representing a post-flight-diffed interaction tool bound to a LocalServiceNode.
LocalStreamCheckBuilder	Fluent builder for a streaming subprocess verification check (local.streamCheck(id)).
LocalStreamCheckCircuitBreakerConfig	Rolling-window regex circuit-breaker configuration over combined stdout and stderr for LocalStreamCheckNode.
LocalStreamCheckCircuitBreakerOptions	Configuration options for a rolling-window regex circuit breaker on local.streamCheck.
LocalStreamCheckNode	Passive AST node representing a streaming subprocess check with rolling-window regex circuit-breaking (local.streamCheck).
LocalStreamCheckToolNode	Passive AST node adapting a LocalStreamCheckNode into a post-flight-diffed ToolASTNode (streamCheck.asTool()).
McpNamespace	Public mcp.* DSL builder namespace exported by @paraharness/node.
McpServerOptions	Configuration options for exposing a local HTTP or MCP SSE control-plane server (mcp.server / local.mcpSse).
NodeAllowBinariesNode	Passive AST node restricting subprocess execution to an explicit allowlist of binary names (local.allowBinaries).
NodeDenyNetworkNode	Passive AST node denying outbound network access during subprocess execution (local.denyNetwork).
NodeHttpControlPlaneNode	Passive AST node exposing a local HTTP control-plane endpoint (local.httpControlPlane).
NodeMcpSseNode	Passive AST node exposing a Model Context Protocol (MCP) server over HTTP/SSE (mcp.server / local.mcpSse).
NodeMcpStdioNode	Passive AST node exposing a Model Context Protocol (MCP) server over standard I/O (local.mcpStdio).
NodeRunnerNode	Passive AST node representing a local OS subprocess and daemon concurrency pool (local.runner).