Interface: LocalServiceNode

Defined in: ast/domain/local-service-node.ts:37

Passive AST node representing a lifecycle-bound background daemon service (local.daemon).

Manages dynamic conflict-free port allocation, hash-suffixed scopeKey sanitization, TCP readiness verification, and framed pseudo-terminal (PTY) interaction tools.

Extends

• BaseServiceASTNode<"node:service">

Properties

Property	Modifier	Type	Description	Inherited from	Defined in
__handleBrand?	readonly	BivariantCallback<[handle: unknown], void>	Phantom type brand binding the service to its compatible scope handle type.	BaseServiceASTNode.__handleBrand	ast/base/base-service-ast-node.ts:38
id	readonly	string	Logical identifier of the service definition.	BaseServiceASTNode.id	ast/base/base-service-ast-node.ts:32
interactions	readonly	readonly LocalServiceInteractionConfig[]	Framed PTY interaction tool specifications exposed by this service.	-	ast/domain/local-service-node.ts:57
lifecycle	readonly	"scope" | "fork" | "skill"	Lifecycle scope governing when the service daemon is started and stopped.	BaseServiceASTNode.lifecycle	ast/base/base-service-ast-node.ts:34
ports	readonly	readonly string[]	Named dynamic TCP port identifiers allocated for each daemon session.	-	ast/domain/local-service-node.ts:41
readyWhenStdoutRegex?	readonly	object	Optional regex pattern over combined stdout/stderr indicating daemon readiness.	-	ast/domain/local-service-node.ts:55
readyWhenStdoutRegex.flags?	readonly	string	-	-	ast/domain/local-service-node.ts:55
readyWhenStdoutRegex.pattern	readonly	string	-	-	ast/domain/local-service-node.ts:55
runner	readonly	NodeRunnerNode	Runner pool governing daemon slot concurrency (maxDaemons).	-	ast/domain/local-service-node.ts:39
startArgv	readonly	(ctx) => readonly string[]	Pure factory mapping allocated ports, sanitized scopeKey, and worktreePath to the startup argv.	-	ast/domain/local-service-node.ts:43
stopArgv?	readonly	(ctx) => readonly string[]	Optional pure factory mapping session context to a cleanup/stop command argv.	-	ast/domain/local-service-node.ts:49
toolSchemas	readonly	readonly ServiceToolSchemaDescriptor[]	Up-front tool schema descriptors for all interaction tools exposed by this service.	BaseServiceASTNode.toolSchemas	ast/base/base-service-ast-node.ts:36
type	readonly	"node:service"	Unique string-literal discriminant of the service node.	BaseServiceASTNode.type	ast/base/base-service-ast-node.ts:30