@vinhnt-sdk/step-executor
v0.6.4
Published
Step execution kernel for VNT Agent - tool lifecycle, timeouts, permission gating, doom-loop detection, self-correction and run state
Maintainers
Readme
@vinhnt-sdk/step-executor
Step execution kernel for VNT Agent — tool lifecycle, per-tool timeouts, permission gating, doom-loop detection, self-correction and run state machine.
Install
pnpm add @vinhnt-sdk/step-executorUsage
import { StepExecutor, PermissionGate, runLoop, RunStateMachine } from "@vinhnt-sdk/step-executor";Contents
StepExecutor— per-step tool execution: invoke → permission re-check → run with timeout → result processing, with pluggable hooks/loggingPermissionGate— permission evaluation against saved patterns, rules and risk defaults (consumes@vinhnt-sdk/permission)tool-context-builder/approval-handler/tool-error-router/self-correction/tool-result-processor— step lifecycle helperstermination— stop-condition evaluation and judge-based loop terminationkernel-utils— doom-loop detection, arg hashing, timeouts, tool domains, defaultsrun-state/run-context— per-run state machine and contextcircuit-breaker/kernel-error— failure isolation and typed errors
Hooks
The package exposes a minimal structural StepExecutorPluginHooks interface. Hosts (e.g. core's PluginManager) only need to implement fireHook for the tool-lifecycle / permission hook names.
