1000411eb2
Frame Engine (v3-framed): - Tick-based deterministic pipeline: frames advance on completion, not timers - FrameRecord/FrameTrace dataclasses for structured per-message tracing - /api/frames endpoint: queryable frame trace history (last 20 messages) - frame_trace HUD event with full pipeline visibility - Reflex=2F, Director=4F, Director+Interpreter=5F deterministic frame counts Expert Architecture (v4-eras): - PA node (pa_v1): routes to domain experts, holds user context - ExpertNode base: stateless executor with plan+execute two-LLM-call pattern - ErasExpertNode: eras2_production DB specialist with DESCRIBE-first discipline - Schema caching: DESCRIBE results reused across queries within session - Progress streaming: PA streams thinking message, expert streams per-tool progress - PARouting type for structured routing decisions UI Controls Split: - Separate thinker_controls from machine controls (current_controls is now a property) - Machine buttons persist across Thinker responses - Machine state parser handles both dict and list formats from Director - Normalized button format with go/payload field mapping WebSocket Architecture: - /ws/test: dedicated debug socket for test runner progress - /ws/trace: dedicated debug socket for HUD/frame trace events - /ws (chat): cleaned up, only deltas/controls/done/cleared - WS survives graph switch (re-attaches to new runtime) - Pipeline result reset on clear Test Infrastructure: - Live test streaming: on_result callback fires per check during execution - Frontend polling fallback (500ms) for proxy-buffered WS - frame_trace-first trace assertion (fixes stale perceived event bug) - action_match supports "or" patterns and multi-pattern matching - Trace window increased to 40 events - Graph-agnostic assertions (has X or Y) Test Suites: - smoketest.md: 12 steps covering all categories (~2min) - fast.md: 10 quick checks (~1min) - fast_v4.md: 10 v4-eras specific checks - expert_eras.md: eras domain tests (routing, DB, schema, errors) - expert_progress.md: progress streaming tests Other: - Shared db.py extracted from thinker_v2 (reused by experts) - InputNode prompt: few-shot examples, history as context summary - Director prompt: full tool signatures for add_state/reset_machine/destroy_machine - nginx no-cache headers for static files during development - Cache-busted static file references Scores: v3 smoketest 39/40, v4-eras fast 28/28, expert_eras 23/23 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
72 lines
2.7 KiB
Python
72 lines
2.7 KiB
Python
"""v4-eras: PA + Eras Expert with progress streaming.
|
|
|
|
Personal Assistant routes to the Eras expert for heating/energy DB work.
|
|
Social/general messages handled directly by PA.
|
|
|
|
Frame traces:
|
|
Reflex: F1(Input) → F2(Output)
|
|
PA direct: F1(Input) → F2(PA) → F3(Output+UI)
|
|
Expert: F1(Input) → F2(PA) → F3(ErasExpert) → F4(Output+UI)
|
|
Expert+Interp: F1(Input) → F2(PA) → F3(ErasExpert) → F4(Interpreter) → F5(Output+UI)
|
|
"""
|
|
|
|
NAME = "v4-eras"
|
|
DESCRIPTION = "PA + Eras Expert: heating/energy database with progress streaming"
|
|
ENGINE = "frames"
|
|
|
|
NODES = {
|
|
"input": "input_v1",
|
|
"pa": "pa_v1",
|
|
"expert_eras": "eras_expert",
|
|
"interpreter": "interpreter_v1",
|
|
"output": "output_v1",
|
|
"ui": "ui",
|
|
"memorizer": "memorizer_v1",
|
|
"sensor": "sensor",
|
|
}
|
|
|
|
EDGES = [
|
|
# Data edges
|
|
{"from": "input", "to": "pa", "type": "data", "carries": "Command"},
|
|
{"from": "input", "to": "output", "type": "data", "carries": "Command",
|
|
"condition": "reflex"},
|
|
{"from": "pa", "to": "expert_eras", "type": "data", "carries": "PARouting",
|
|
"condition": "expert_is_eras"},
|
|
{"from": "pa", "to": "output", "type": "data", "carries": "PARouting",
|
|
"condition": "expert_is_none"},
|
|
{"from": "expert_eras", "to": ["output", "ui"], "type": "data",
|
|
"carries": "ThoughtResult", "parallel": True},
|
|
{"from": "expert_eras", "to": "interpreter", "type": "data",
|
|
"carries": "tool_output", "condition": "has_tool_output"},
|
|
{"from": "interpreter", "to": "output", "type": "data",
|
|
"carries": "InterpretedResult", "condition": "has_tool_output"},
|
|
{"from": "output", "to": "memorizer", "type": "data", "carries": "history"},
|
|
|
|
# Context edges — PA gets all context (experts are stateless)
|
|
{"from": "memorizer", "to": "pa", "type": "context",
|
|
"method": "get_context_block"},
|
|
{"from": "memorizer", "to": "input", "type": "context",
|
|
"method": "get_context_block"},
|
|
{"from": "memorizer", "to": "output", "type": "context",
|
|
"method": "get_context_block"},
|
|
{"from": "pa", "to": "output", "type": "context",
|
|
"method": "get_context_line"},
|
|
{"from": "sensor", "to": "pa", "type": "context",
|
|
"method": "get_context_lines"},
|
|
{"from": "ui", "to": "pa", "type": "context",
|
|
"method": "get_machine_summary"},
|
|
|
|
# State edges
|
|
{"from": "sensor", "to": "runtime", "type": "state", "reads": "flags"},
|
|
{"from": "ui", "to": "runtime", "type": "state", "reads": "current_controls"},
|
|
]
|
|
|
|
CONDITIONS = {
|
|
"reflex": "intent==social AND complexity==trivial",
|
|
"expert_is_eras": "pa.expert == eras",
|
|
"expert_is_none": "pa.expert == none",
|
|
"has_tool_output": "expert.tool_used is not empty",
|
|
}
|
|
|
|
AUDIT = {}
|