Skip to content

Interface: LocalServiceNode ​

Defined in: core/dist/ast/domain/local-service-node.d.ts:38

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 ​

Properties ​

PropertyModifierTypeDescriptionInherited fromDefined in
__handleBrand?readonlyBivariantCallback<[handle: unknown], void>Phantom type brand binding the service to its compatible scope handle type.BaseServiceASTNode.__handleBrandcore/dist/ast/base/base-service-ast-node.d.ts:36
idreadonlystringLogical identifier of the service definition.BaseServiceASTNode.idcore/dist/ast/base/base-service-ast-node.d.ts:30
interactionsreadonlyreadonly LocalServiceInteractionConfig[]Framed PTY interaction tool specifications exposed by this service.-core/dist/ast/domain/local-service-node.d.ts:61
lifecyclereadonly"scope" | "fork" | "skill"Lifecycle scope governing when the service daemon is started and stopped.BaseServiceASTNode.lifecyclecore/dist/ast/base/base-service-ast-node.d.ts:32
portsreadonlyreadonly string[]Named dynamic TCP port identifiers allocated for each daemon session.-core/dist/ast/domain/local-service-node.d.ts:42
readyWhenStdoutRegex?readonlyobjectOptional regex pattern over combined stdout/stderr indicating daemon readiness.-core/dist/ast/domain/local-service-node.d.ts:56
readyWhenStdoutRegex.flags?readonlystring--core/dist/ast/domain/local-service-node.d.ts:58
readyWhenStdoutRegex.patternreadonlystring--core/dist/ast/domain/local-service-node.d.ts:57
runnerreadonlyNodeRunnerNodeRunner pool governing daemon slot concurrency (maxDaemons).-core/dist/ast/domain/local-service-node.d.ts:40
startArgvreadonly(ctx) => readonly string[]Pure factory mapping allocated ports, sanitized scopeKey, and worktreePath to the startup argv.-core/dist/ast/domain/local-service-node.d.ts:44
stopArgv?readonly(ctx) => readonly string[]Optional pure factory mapping session context to a cleanup/stop command argv.-core/dist/ast/domain/local-service-node.d.ts:50
toolSchemasreadonlyreadonly ServiceToolSchemaDescriptor[]Up-front tool schema descriptors for all interaction tools exposed by this service.BaseServiceASTNode.toolSchemascore/dist/ast/base/base-service-ast-node.d.ts:34
typereadonly"node:service"Unique string-literal discriminant of the service node.BaseServiceASTNode.typecore/dist/ast/base/base-service-ast-node.d.ts:28

Released under the MIT License.