agent-runtime/testcases/state_machines.md
Nico a2bc6347fc v0.13.0: Graph engine, versioned nodes, S3* audit, DB tools, Cytoscape
Architecture:
- Graph engine (engine.py) loads graph definitions, instantiates nodes
- Versioned nodes: input_v1, thinker_v1, output_v1, memorizer_v1, director_v1
- NODE_REGISTRY for dynamic node lookup by name
- Graph API: /api/graph/active, /api/graph/list, /api/graph/switch
- Graph definition: graphs/v1_current.py (7 nodes, 13 edges, 3 edge types)

S3* Audit system:
- Workspace mismatch detection (server vs browser controls)
- Code-without-tools retry (Thinker wrote code but no tool calls)
- Intent-without-action retry (request intent but Thinker only produced text)
- Dashboard feedback: browser sends workspace state on every message
- Sensor continuous comparison on 5s tick

State machines:
- create_machine / add_state / reset_machine / destroy_machine via function calling
- Local transitions (go:) resolve without LLM round-trip
- Button persistence across turns

Database tools:
- query_db tool via pymysql to MariaDB K3s pod (eras2_production)
- Table rendering in workspace (tab-separated parsing)
- Director pre-planning with Opus for complex data requests
- Error retry with corrected SQL

Frontend:
- Cytoscape.js pipeline graph with real-time node animations
- Overlay scrollbars (CSS-only, no reflow)
- Tool call/result trace events
- S3* audit events in trace

Testing:
- 167 integration tests (11 test suites)
- 22 node-level unit tests (test_nodes/)
- Three test levels: node unit, graph integration, scenario

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-29 00:18:45 +01:00

49 lines
1.6 KiB
Markdown

# State Machines
Tests the machine toolbox: create, add_state, transition, reset, destroy.
Machines are persistent UI components with states, buttons, content, and local transitions.
## Setup
- clear history
## Steps
### 1. Create a machine
- send: create a navigation machine called "nav" with initial state "main" showing two buttons: Menu 1 (goes to sub1) and Menu 2 (goes to sub2)
- expect_trace: has tool_call create_machine
- expect_trace: machine_created id="nav"
### 2. Verify machine renders
- send: what machines are on my dashboard?
- expect_response: contains "nav" or "machine"
### 3. Navigate via button click (local transition)
- action: first matching "menu_1"
- expect_trace: has machine_transition
- expect_trace: no thinker
### 4. Add a state to existing machine
- send: add a state "sub3" to the nav machine with a Back button and content "Third submenu"
- expect_trace: has tool_call add_state
### 5. Reset machine
- send: reset the nav machine to its initial state
- expect_trace: has tool_call reset_machine
- expect_response: contains "main" or "reset" or "initial"
### 6. Create second machine alongside first
- send: create a counter machine called "clicks" with initial state "zero" showing a Click Me button and content "Clicks: 0"
- expect_trace: has tool_call create_machine
- expect_trace: machine_created id="clicks"
### 7. Both machines coexist
- send: what machines are running?
- expect_response: contains "nav"
- expect_response: contains "click"
### 8. Destroy one machine
- send: destroy the clicks machine
- expect_trace: has tool_call destroy_machine
- send: what machines are running?
- expect_response: contains "nav"