@radzor/state-machine

Finite state machine with guards, transition actions, and history tracking. Define states, transitions, and conditional logic for complex stateful workflows.

Automationv0.1.0typescriptpythonUniversalstate-machinefsmstatecharttransitionsguardsautomationby Radzor

Install

View source on GitHub →

$npx radzor@latest add state-machine

⚠ Constraints: State is in-memory; lost on process restart. Guards must be synchronous functions. Context mutations in actions should return new objects, not mutate in place.

Inputs

Name	Type	Default	Description
definition*	MachineDefinition	—	State machine definition with states, transitions, and guards.
context	Record<string, unknown>	[object Object]	Initial context data available to guards and actions.
historySize	number	100	Maximum number of transition records to keep in history.

definition*MachineDefinition

State machine definition with states, transitions, and guards.

contextRecord<string, unknown>

Initial context data available to guards and actions.

default: [object Object]

historySize

{ "llm": { "constraints": "State is in-memory; lost on process restart. Guards must be synchronous functions. Context mutations in actions should return new objects, not mutate in place.", "usageExamples": "llm/examples.md", "integrationPrompt": "llm/integration.md" }, "name": "@radzor/state-machine", "tags": [ "state-machine", "fsm", "statechart", "transitions", "guards", "automation" ], "events": [ { "name": "onTransition", "payload": { "to": "string", "from": "string", "event": "string", "context": "Record<string, unknown>" }, "description": "Fired after a successful state transition." }, { "name": "onGuardRejected", "payload": { "from": "string", "event": "string", "guard": "string", "context": "Record<string, unknown>" }, "description": "Fired when a transition is blocked by a guard condition." } ], "inputs": [ { "name": "definition", "type": "MachineDefinition", "required": true, "description": "State machine definition with states, transitions, and guards." }, { "name": "context", "type": "Record<string, unknown>", "default": {}, "required": false, "description": "Initial context data available to guards and actions." }, { "name": "historySize", "type": "number", "default": 100, "required": false, "description": "Maximum number of transition records to keep in history." } ], "radzor": "1.0.0", "actions": [ { "name": "transition", "params": [ { "name": "event", "type": "string", "description": "Event name that triggers the transition." }, { "name": "payload", "type": "Record<string, unknown>", "required": false, "description": "Optional payload passed to guards and actions." } ], "returns": "MachineState", "description": "Attempt to transition the machine by sending an event." }, { "name": "getState", "params": [], "returns": "MachineState", "description": "Get the current machine state, context, and history." }, { "name": "getHistory", "params": [], "returns": "TransitionRecord[]", "description": "Get the full transition history." }, { "name": "reset", "params": [], "returns": "void", "description": "Reset the machine to its initial state and clear history." }, { "name": "canTransition", "params": [ { "name": "event", "type": "string", "description": "Event name to check." } ], "returns": "boolean", "description": "Check if an event can trigger a transition from the current state." } ], "outputs": [ { "name": "machineState", "type": "MachineState", "fields": [ { "name": "current", "type": "string", "description": "Name of the current state." }, { "name": "context", "type": "Record<string, unknown>", "description": "Current context data." }, { "name": "history", "type": "TransitionRecord[]", "description": "List of past transitions." } ], "description": "Current state of the machine." } ], "runtime": "universal", "version": "0.1.0", "category": "automation", "languages": [ "typescript", "python" ], "description": "Finite state machine with guards, transition actions, and history tracking. Define states, transitions, and conditional logic for complex stateful workflows.", "dependencies": { "radzor": [], "packages": {} }, "composability": { "connectsTo": [ { "event": "onTransition", "description": "Track state transitions for audit trail", "compatibleWith": [ "@radzor/event-tracker.action.track.eventName", "@radzor/log-aggregator.action.info.message" ] }, { "output": "machineState", "mapField": "current", "compatibleWith": [ "@radzor/notification-hub.action.send.body" ] } ] } }

@radzor/state-machine

Install

Inputs

Outputs

Actions

Events

Composability

radzor.manifest.json