Behavior Runtime Engine (behavior-mcp)

This skill provides step-by-step guidance and operational patterns for interacting with @putervision/behavior-mcp with project slug "world-model-mcp".

---

1. Role in the PuterVision Pentad

• Workflow State (state-memory-mcp): Persistent task DAGs, decisions, milestones, and blockers.
• Perception (vision-memory-mcp): Visual layout caching, screenshots, and visual specifications.
• Spatial World (world-model-mcp): Persistent 3D/2D coordinates, bounding boxes, and topological relations.
• Strategic Reasoning (agent-reasoning-mcp): Strategic BDI goals, utility scoring, and intention dispatch.
• Tactical Execution (behavior-mcp): High-frequency (~60Hz) deterministic behavior tree execution directly in browser runtimes with reactive interrupts.

---

2. Core Operational Sequence

1. Define or Load Behavior: Call load_behavior with action: "load" to inject and start tree execution.
2. Register Reactive Triggers: Configure emergency preemption using register_trigger with priority and cooldown guards.
3. Monitor Telemetry: Poll execution health, tick rates, and active traversal nodes with get_status.
4. Runtime Blackboard: Read and mutate execution variables via manage_blackboard.
5. Safety Guardrails: Immediately halt or pause rogue states using abort_behavior.

---

3. Complete 10 Consolidated MCP Tools Reference

Tool Name	Key Actions	Key Parameters	Description
load_behavior	load, unload, swap	behavior_name, behavior_version, parameters, intention_id	Hot-swap, inject, or initialize behavior tree instances in browser runtime.
set_parameters	set, get, reset	execution_id, parameters	Dynamically update or query execution parameters for the active tree.
get_status	current, history, tree_state	execution_id, limit	Query active behavior status, current node path, tick count, duration, and errors.
abort_behavior	abort, pause, resume	execution_id, reason	Immediately halt, pause, or resume execution and disengage active inputs.
register_trigger	register, list	name, condition_type, priority, cooldown_ms, behavior_name	Configure reactive interrupt triggers with priority preemption and cooldowns.
replay_recording	capture, list	recording_id, execution_id, frames, name	Capture or replay deterministic browser action sequences with adaptive timing.
get_metrics	current, history, aggregate, compare	execution_id, behavior_name, limit	Retrieve execution telemetry, tick durations, stuck events, and statistics.
manage_behaviors	register, list, get	name, version, tree, tree_json, description	CRUD operations for immutable JSON behavior trees with SHA-256 tree hash verification.
manage_blackboard	get, set	execution_id, key, value	Read or write shared behavior tree blackboard state variables.
manage_runtime_db	stats, audit, snapshot, diff, restore	action, name, description	Database maintenance, diagnostics, and SHA-256 Merkle audit verification.