@almadar/std 16.242.0 → 16.244.0

package/behaviors/lolo/ui/learning/atoms/std-learn-live-sim.lolo

@@ -16,6 +16,7 @@ orbital LearnLiveSimOrbital {
     active : boolean = false
     title : string
     bodies : [LiveSimBody]
+    loadedBodies : [LiveSimBody]
     running : boolean = false
     gravity : number = 0
     damping : number = 1
@@ -27,9 +28,10 @@ orbital LearnLiveSimOrbital {
     initial: idle
 
     state idle {
-      INIT -> idle when (== @config.matchMode "")
+      INIT -> idle when (and (== @config.matchMode "") (== @config.rosterSource "config"))
         (set @entity.active true)
         (set @entity.title @config.title)
+        (set @entity.loadedBodies @config.bodies)
         (set @entity.bodies @config.bodies)
         (set @entity.running @config.running)
         (set @entity.gravity @config.gravity)
@@ -74,9 +76,10 @@ orbital LearnLiveSimOrbital {
         (set @entity.running false)
         (render-ui main null)
 
-      MODE_SELECTED -> idle when (== ?mode @config.matchMode)
+      MODE_SELECTED -> idle when (and (== ?mode @config.matchMode) (== @config.rosterSource "config"))
         (set @entity.active true)
         (set @entity.title @config.title)
+        (set @entity.loadedBodies @config.bodies)
         (set @entity.bodies @config.bodies)
         (set @entity.running @config.running)
         (set @entity.gravity @config.gravity)
@@ -116,6 +119,54 @@ orbital LearnLiveSimOrbital {
           ]
         })
 
+      ROSTER_LOADED -> idle when (and (== @config.rosterSource "event") (and (== ?mode @config.matchMode) (> (array/len ?bodies) 0)))
+        (set @entity.active true)
+        (set @entity.title @config.title)
+        (set @entity.loadedBodies ?bodies)
+        (set @entity.bodies ?bodies)
+        (set @entity.running @config.running)
+        (set @entity.gravity @config.gravity)
+        (set @entity.damping @config.damping)
+        (set @entity.tickCount 0)
+        (set @entity.sampleSpeed 0)
+        (render-ui main {
+          type: box
+          padding: md
+          children: [
+            { type: stack, direction: vertical, gap: md, children: [
+                { type: stack, direction: horizontal, justify: between, align: start, gap: md, children: [
+                    { type: stack, direction: vertical, gap: xs, children: [
+                        { type: typography, variant: h4, content: @entity.title },
+                        (if (== @config.summary "") null { type: typography, variant: body2, color: muted, content: @config.summary })
+                      ] },
+                    { type: badge, label: (if @entity.running "Running" "Paused"), variant: (if @entity.running "primary" "neutral") }
+                  ] },
+                { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: [
+                    (if @entity.running { type: button, action: TOGGLE_RUN, label: "Pause", icon: "pause", variant: primary, aria-pressed: "true" } { type: button, action: TOGGLE_RUN, label: "Play", icon: "play", variant: primary, aria-pressed: "false" }),
+                    { type: button, action: RESET, label: "Reset", icon: "rotate-ccw", variant: ghost },
+                    { type: typography, variant: caption, color: muted, content: (str/concat "Tick " @entity.tickCount) }
+                  ] },
+                { type: physics-canvas, keyMap: { Space: TOGGLE_RUN, KeyR: RESET }, width: @config.width, height: @config.height, backgroundColor: @config.backgroundColor, bodies: @entity.bodies, showVelocity: @config.showVelocity, showForces: false, velocityScale: @config.velocityScale },
+                { type: stack, direction: vertical, gap: sm, children: [
+                    { type: stack, direction: vertical, gap: xs, children: [
+                        { type: typography, variant: caption, color: muted, content: (str/concat "Gravity: " (math/round @entity.gravity 2)) },
+                        { type: range-slider, min: -1, max: 1.5, step: 0.05, value: @entity.gravity, showTooltip: true, action: "SET_GRAVITY" }
+                      ] },
+                    { type: stack, direction: vertical, gap: xs, children: [
+                        { type: typography, variant: caption, color: muted, content: (str/concat "Damping: " (math/round @entity.damping 3)) },
+                        { type: range-slider, min: 0.9, max: 1, step: 0.005, value: @entity.damping, showTooltip: true, action: "SET_DAMPING" }
+                      ] }
+                  ] },
+                { type: typography, variant: body, content: (str/concat "Sample body speed " (math/round @entity.sampleSpeed 2)) }
+              ] }
+          ]
+        })
+
+      ROSTER_LOADED -> idle when (and (== @config.rosterSource "event") (not (== ?mode @config.matchMode)))
+        (set @entity.active false)
+        (set @entity.running false)
+        (render-ui main null)
+
       TOGGLE_RUN -> idle when (== @entity.active true)
         (set @entity.running (not @entity.running))
         (render-ui main {
@@ -225,7 +276,7 @@ orbital LearnLiveSimOrbital {
         (emit RUN_TOGGLED { running: @entity.running })
 
       RESET -> idle when (== @entity.active true)
-        (set @entity.bodies @config.bodies)
+        (set @entity.bodies @entity.loadedBodies)
         (set @entity.running false)
         (set @entity.gravity @config.gravity)
         (set @entity.damping @config.damping)
@@ -404,6 +455,12 @@ orbital LearnLiveSimOrbital {
       }
         @description "Lab router broadcast naming the active mode; this instrument renders when the mode equals matchMode, otherwise renders null."
         @tier "domain"
+      ROSTER_LOADED {
+        mode : string!
+        bodies : [LiveSimBody]!
+      }
+        @description "Runtime content feed, honoured only when rosterSource is event — mode names the instrument it is for (the matchMode it carries, blank when standalone) and bodies is the initial body list; a matching instrument re-initialises from it exactly as INIT does from config, any other instrument hides."
+        @tier "domain"
       TOGGLE_RUN {
       }
         @description "Learner pressed the Play/Pause toggle — flips the running flag."
@@ -450,8 +507,12 @@ orbital LearnLiveSimOrbital {
     config {
       matchMode : string = ""
         @label "Match Mode"
-        @description "When composed behind a lab router, the MODE_SELECTED mode value this instrument responds to. Empty string means standalone — render immediately on INIT."
+        @description "When composed behind a lab router, the MODE_SELECTED mode value this instrument responds to. Empty string means standalone — render immediately on INIT (or on ROSTER_LOADED when rosterSource is event)."
         @tier "presentation"
+      rosterSource : "config" | "event" = "config"
+        @label "Roster Source"
+        @description "Where the body roster comes from: config reads the bodies knob at INIT; event waits for ROSTER_LOADED and takes the bodies from its payload."
+        @tier "domain"
       title : string = "Live Sim"
         @label "Title"
         @description "The instrument's name, the header's one hero."
@@ -502,7 +563,7 @@ orbital LearnLiveSimOrbital {
         { id: "ball-c", x: 420, y: 40, radius: 11, color: "series-3", vx: 2, vy: -1 }
       ]
         @label "Bodies"
-        @description "Initial bodies; each carries position (x,y), radius, color, and velocity (vx,vy). Restored on Reset."
+        @description "Initial bodies; each carries position (x,y), radius, color, and velocity (vx,vy). Restored on Reset. Used when rosterSource is config."
         @tier "presentation"
     }
   }

package/behaviors/lolo/ui/learning/atoms/std-learn-predict.lolo

@@ -27,6 +27,7 @@ orbital PredictOrbital {
     id : string!
     active : boolean = false
     title : string
+    scenarios : [PredictScenario]
     scenarioIndex : number = 0
     totalScenarios : number = 0
     phase : string
@@ -52,7 +53,7 @@ orbital PredictOrbital {
     initial: idle
 
     state idle {
-      INIT -> idle when (== @config.matchMode "")
+      INIT -> idle when (and (== @config.matchMode "") (== @config.rosterSource "config"))
         (let (
             (first (array/nth @config.scenarios 0))
           )
@@ -60,6 +61,7 @@ orbital PredictOrbital {
             (set @entity.active true)
             (set @entity.title @config.title)
             (set @entity.scenarioIndex 0)
+            (set @entity.scenarios @config.scenarios)
             (set @entity.totalScenarios (array/len @config.scenarios))
             (set @entity.phase "commit")
             (set @entity.chosenIndex 0)
@@ -115,7 +117,7 @@ orbital PredictOrbital {
         (set @entity.active false)
         (render-ui main null)
 
-      MODE_SELECTED -> idle when (== ?mode @config.matchMode)
+      MODE_SELECTED -> idle when (and (== ?mode @config.matchMode) (== @config.rosterSource "config"))
         (let (
             (first (array/nth @config.scenarios 0))
           )
@@ -123,6 +125,7 @@ orbital PredictOrbital {
             (set @entity.active true)
             (set @entity.title @config.title)
             (set @entity.scenarioIndex 0)
+            (set @entity.scenarios @config.scenarios)
             (set @entity.totalScenarios (array/len @config.scenarios))
             (set @entity.phase "commit")
             (set @entity.chosenIndex 0)
@@ -174,6 +177,71 @@ orbital PredictOrbital {
           ]
         })
 
+      ROSTER_LOADED -> idle when (and (== @config.rosterSource "event") (and (== ?mode @config.matchMode) (> (array/len ?scenarios) 0)))
+        (let (
+            (first (array/nth ?scenarios 0))
+          )
+          (do
+            (set @entity.active true)
+            (set @entity.title @config.title)
+            (set @entity.scenarioIndex 0)
+            (set @entity.scenarios ?scenarios)
+            (set @entity.totalScenarios (array/len ?scenarios))
+            (set @entity.phase "commit")
+            (set @entity.chosenIndex 0)
+            (set @entity.frames (object/get @first frames))
+            (set @entity.frameIndex 0)
+            (set @entity.frameCaption "")
+            (set @entity.frameValue 0)
+            (set @entity.revealSamples [])
+            (set @entity.revealCurves [])
+            (set @entity.score 0)
+            (set @entity.done false)
+            (set @entity.setupText (object/get @first setup))
+            (set @entity.question (object/get @first question))
+            (set @entity.options (object/get @first options))
+            (set @entity.correctIndex (object/get @first correctIndex))
+            (set @entity.explanation (object/get @first explanation ""))
+            (set @entity.feedback "")
+            (set @entity.view [
+              { type: card, variant: bordered, padding: md, children: [
+                  { type: typography, variant: body, content: @entity.setupText },
+                  { type: typography, variant: h4, content: @entity.question }
+                ] }
+            ])))
+        (render-ui main {
+          type: box
+          padding: md
+          children: [
+            { type: stack, direction: vertical, gap: md, children: [
+                { type: stack, direction: horizontal, justify: between, align: start, gap: md, children: [
+                    { type: stack, direction: vertical, gap: xs, children: [
+                        { type: typography, variant: h4, content: @entity.title },
+                        (if (== @config.summary "") null { type: typography, variant: body2, color: muted, content: @config.summary })
+                      ] },
+                    { type: badge, label: (if @entity.done (str/concat @entity.score " / " @entity.totalScenarios " correct") (if (== @entity.phase "commit") "Predict" (if (== @entity.phase "reveal") "Revealing" (if (== @entity.chosenIndex @entity.correctIndex) "Correct" "Incorrect")))), variant: (if @entity.done "primary" (if (== @entity.phase "judged") (if (== @entity.chosenIndex @entity.correctIndex) "success" "error") "neutral")) }
+                  ] },
+                { type: progress-bar, value: (+ @entity.scenarioIndex 1), max: @entity.totalScenarios, showPercentage: false, label: (str/concat "Scenario " (str/concat "" (+ @entity.scenarioIndex 1)) " of " (str/concat "" @entity.totalScenarios)) },
+                { type: stack, direction: vertical, gap: md, children: @entity.view },
+                { type: stack, direction: vertical, gap: sm, children: (array/map (array/range 0 (array/len @entity.options)) (fn (i)
+                    { type: button, action: PREDICT, actionPayload: { index: @i }, label: (array/nth @entity.options @i), size: lg, disabled: (!= @entity.phase "commit"), variant: (if (== @entity.phase "commit") "secondary" (if (== @entity.phase "reveal") (if (== @entity.chosenIndex @i) "primary" "ghost") (if (== @i @entity.correctIndex) "success" (if (== @entity.chosenIndex @i) "danger" "ghost")))) })) },
+                { type: math-canvas, width: @config.width, height: @config.height, title: "", xMin: 0, xMax: (math/max 1 (- (array/len @entity.frames) 1)), yMin: @config.valueMin, yMax: @config.valueMax, showAxes: true, showGrid: true, gridStep: @config.gridStep, curves: @entity.revealCurves, points: [], vectors: [], shapes: [], interactive: false, animate: false, keyMap: { ArrowRight: NEXT, KeyR: RETRY } },
+                { type: typography, variant: body, content: @entity.frameCaption },
+                { type: typography, variant: body, content: @entity.feedback },
+                { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: [
+                    { type: button, action: NEXT, label: @config.nextLabel, icon: "chevron-right", variant: primary, disabled: (if (and (== @entity.phase "judged") (== @entity.done false)) false true) },
+                    { type: button, action: RETRY, label: @config.retryLabel, icon: "rotate-ccw", variant: ghost, disabled: (if @entity.done false true) },
+                    { type: typography, variant: caption, color: muted, content: (str/concat "Correct " @entity.score " of " @entity.totalScenarios) }
+                  ] }
+              ] }
+          ]
+        })
+
+
+      ROSTER_LOADED -> idle when (and (== @config.rosterSource "event") (not (== ?mode @config.matchMode)))
+        (set @entity.active false)
+        (render-ui main null)
+
       PREDICT -> idle when (and (== @entity.active true) (and (== @entity.phase "commit") (== @entity.done false)))
         (let (
             (frame0 (array/nth @entity.frames 0))
@@ -190,11 +258,11 @@ orbital PredictOrbital {
         (emit PREDICTION_COMMITTED { scenarioIndex: @entity.scenarioIndex, chosenIndex: @entity.chosenIndex })
 
       NEXT -> idle when (and (== @entity.active true) (and (== @entity.phase "judged") (== @entity.done false)))
-        (if (>= (+ @entity.scenarioIndex 1) (array/len @config.scenarios)) (emit LEARN_ROUND_COMPLETE { score: @entity.score, total: (array/len @config.scenarios) }) null)
+        (if (>= (+ @entity.scenarioIndex 1) (array/len @entity.scenarios)) (emit LEARN_ROUND_COMPLETE { score: @entity.score, total: (array/len @entity.scenarios) }) null)
         (let (
             (nextIndex (+ @entity.scenarioIndex 1))
-            (finished (>= @nextIndex (array/len @config.scenarios)))
-            (next (array/nth @config.scenarios (math/min @nextIndex (- (array/len @config.scenarios) 1))))
+            (finished (>= @nextIndex (array/len @entity.scenarios)))
+            (next (array/nth @entity.scenarios (math/min @nextIndex (- (array/len @entity.scenarios) 1))))
           )
           (do
             (set @entity.scenarioIndex (if @finished @entity.scenarioIndex @nextIndex))
@@ -256,7 +324,7 @@ orbital PredictOrbital {
 
       RETRY -> idle when (and (== @entity.active true) (== @entity.done true))
         (let (
-            (first (array/nth @config.scenarios 0))
+            (first (array/nth @entity.scenarios 0))
           )
           (do
             (set @entity.scenarioIndex 0)
@@ -335,6 +403,12 @@ orbital PredictOrbital {
       }
         @description "Lab router broadcast naming the active mode; this instrument renders when the mode equals matchMode, otherwise renders null."
         @tier "domain"
+      ROSTER_LOADED {
+        mode : string!
+        scenarios : [PredictScenario]!
+      }
+        @description "Runtime content feed, honoured only when rosterSource is event — mode names the instrument it is for (the matchMode it carries, blank when standalone) and scenarios is the scenario list; a matching instrument re-initialises from it exactly as INIT does from config, any other instrument hides."
+        @tier "domain"
       PREDICT {
         index : number
       }
@@ -384,6 +458,10 @@ orbital PredictOrbital {
         @label "Match Mode"
         @description "When composed behind a lab router, the MODE_SELECTED mode value this instrument responds to. Empty string means standalone — render immediately on INIT."
         @tier "presentation"
+      rosterSource : "config" | "event" = "config"
+        @label "Roster Source"
+        @description "Where the scenario roster comes from: config reads the scenarios knob at INIT; event waits for ROSTER_LOADED and takes the roster from its payload."
+        @tier "domain"
       title : string = "Predict, Then Watch"
         @label "Title"
         @description "Title shown above the instrument."

package/behaviors/lolo/ui/learning/atoms/std-learn-sandbox.lolo

@@ -31,6 +31,8 @@ orbital LearnSandboxOrbital {
     id : string!
     active : boolean = false
     title : string
+    elements : [LearnSandboxElement]
+    links : [LearnSandboxLink]
     enabledIds : [string]
     total : number = 0
     holds : boolean = false
@@ -43,7 +45,9 @@ orbital LearnSandboxOrbital {
     initial: idle
 
     state idle {
-      INIT -> idle when (== @config.matchMode "")
+      INIT -> idle when (and (== @config.matchMode "") (== @config.rosterSource "config"))
+        (set @entity.elements @config.elements)
+        (set @entity.links @config.links)
         (set @entity.active true)
         (set @entity.title @config.title)
         (set @entity.enabledIds (array/map (array/filter @config.elements (fn e (== (object/get @e enabled true) true))) (fn e (object/get @e id))))
@@ -76,7 +80,7 @@ orbital LearnSandboxOrbital {
                     { type: badge, variant: (if @entity.holds "primary" "warning"), label: (if @entity.holds "Holds" "Does not hold") }
                   ] },
                 { type: biology-canvas, width: @config.width, height: @config.height, backgroundColor: @config.backgroundColor, nodes: @entity.nodes, edges: @entity.edges, shapes: [], interactive: @config.interactive, animate: @config.animate, keyMap: { KeyR: RESET } },
-                { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: (array/map @config.elements (fn e { type: button, action: TOGGLE, actionPayload: { elementId: (object/get @e id) }, label: (if (array/includes @entity.enabledIds (object/get @e id)) (object/get @e label) (str/concat (object/get @e label) " — off")), variant: (if (array/includes @entity.enabledIds (object/get @e id)) "secondary" "ghost"), aria-pressed: (if (array/includes @entity.enabledIds (object/get @e id)) "true" "false") })) },
+                { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: (array/map @entity.elements (fn e { type: button, action: TOGGLE, actionPayload: { elementId: (object/get @e id) }, label: (if (array/includes @entity.enabledIds (object/get @e id)) (object/get @e label) (str/concat (object/get @e label) " — off")), variant: (if (array/includes @entity.enabledIds (object/get @e id)) "secondary" "ghost"), aria-pressed: (if (array/includes @entity.enabledIds (object/get @e id)) "true" "false") })) },
                 { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: [
                     { type: button, action: RESET, label: @config.resetLabel, icon: "rotate-ccw", variant: ghost },
                     { type: typography, variant: caption, color: muted, content: (str/concat "Total " @entity.total " of " @config.threshold) }
@@ -90,7 +94,9 @@ orbital LearnSandboxOrbital {
         (set @entity.active false)
         (render-ui main null)
 
-      MODE_SELECTED -> idle when (== ?mode @config.matchMode)
+      MODE_SELECTED -> idle when (and (== ?mode @config.matchMode) (== @config.rosterSource "config"))
+        (set @entity.elements @config.elements)
+        (set @entity.links @config.links)
         (set @entity.active true)
         (set @entity.title @config.title)
         (set @entity.enabledIds (array/map (array/filter @config.elements (fn e (== (object/get @e enabled true) true))) (fn e (object/get @e id))))
@@ -123,7 +129,7 @@ orbital LearnSandboxOrbital {
                     { type: badge, variant: (if @entity.holds "primary" "warning"), label: (if @entity.holds "Holds" "Does not hold") }
                   ] },
                 { type: biology-canvas, width: @config.width, height: @config.height, backgroundColor: @config.backgroundColor, nodes: @entity.nodes, edges: @entity.edges, shapes: [], interactive: @config.interactive, animate: @config.animate, keyMap: { KeyR: RESET } },
-                { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: (array/map @config.elements (fn e { type: button, action: TOGGLE, actionPayload: { elementId: (object/get @e id) }, label: (if (array/includes @entity.enabledIds (object/get @e id)) (object/get @e label) (str/concat (object/get @e label) " — off")), variant: (if (array/includes @entity.enabledIds (object/get @e id)) "secondary" "ghost"), aria-pressed: (if (array/includes @entity.enabledIds (object/get @e id)) "true" "false") })) },
+                { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: (array/map @entity.elements (fn e { type: button, action: TOGGLE, actionPayload: { elementId: (object/get @e id) }, label: (if (array/includes @entity.enabledIds (object/get @e id)) (object/get @e label) (str/concat (object/get @e label) " — off")), variant: (if (array/includes @entity.enabledIds (object/get @e id)) "secondary" "ghost"), aria-pressed: (if (array/includes @entity.enabledIds (object/get @e id)) "true" "false") })) },
                 { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: [
                     { type: button, action: RESET, label: @config.resetLabel, icon: "rotate-ccw", variant: ghost },
                     { type: typography, variant: caption, color: muted, content: (str/concat "Total " @entity.total " of " @config.threshold) }
@@ -133,15 +139,64 @@ orbital LearnSandboxOrbital {
           ]
         })
 
+      ROSTER_LOADED -> idle when (and (== @config.rosterSource "event") (and (== ?mode @config.matchMode) (> (array/len ?elements) 0)))
+        (set @entity.elements ?elements)
+        (set @entity.links ?links)
+        (set @entity.active true)
+        (set @entity.title @config.title)
+        (set @entity.enabledIds (array/map (array/filter ?elements (fn e (== (object/get @e enabled true) true))) (fn e (object/get @e id))))
+        (let (
+            (activeElements (array/filter ?elements (fn e (array/includes @entity.enabledIds (object/get @e id)))))
+            (total (array/sum (array/map @activeElements (fn e (object/get @e weight)))))
+            (holds (>= @total @config.threshold))
+            (readout (str/concat @config.outcomeLabel ": total " @total " of " @config.threshold " needed. " (if @holds "Holds." "Does not hold.")))
+            (nodes (array/map ?elements (fn e { id: (object/get @e id), x: (object/get @e x), y: (object/get @e y), radius: @config.nodeRadius, color: (if (array/includes @entity.enabledIds (object/get @e id)) @config.enabledColor @config.disabledColor), label: (object/get @e label) })))
+            (edges (array/map ?links (fn l { from: (object/get @l from), to: (object/get @l to), color: (if (and (array/includes @entity.enabledIds (object/get @l from)) (array/includes @entity.enabledIds (object/get @l to))) @config.enabledEdgeColor @config.disabledEdgeColor) })))
+          )
+          (do
+            (set @entity.total @total)
+            (set @entity.holds @holds)
+            (set @entity.readout @readout)
+            (set @entity.nodes @nodes)
+            (set @entity.edges @edges)
+          )
+        )
+        (render-ui main {
+          type: box
+          padding: md
+          children: [
+            { type: stack, direction: vertical, gap: md, children: [
+                { type: stack, direction: horizontal, justify: between, align: start, gap: md, children: [
+                    { type: stack, direction: vertical, gap: xs, children: [
+                        { type: typography, variant: h4, content: @entity.title },
+                        (if (== @config.summary "") null { type: typography, variant: body2, color: muted, content: @config.summary })
+                      ] },
+                    { type: badge, variant: (if @entity.holds "primary" "warning"), label: (if @entity.holds "Holds" "Does not hold") }
+                  ] },
+                { type: biology-canvas, width: @config.width, height: @config.height, backgroundColor: @config.backgroundColor, nodes: @entity.nodes, edges: @entity.edges, shapes: [], interactive: @config.interactive, animate: @config.animate, keyMap: { KeyR: RESET } },
+                { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: (array/map @entity.elements (fn e { type: button, action: TOGGLE, actionPayload: { elementId: (object/get @e id) }, label: (if (array/includes @entity.enabledIds (object/get @e id)) (object/get @e label) (str/concat (object/get @e label) " — off")), variant: (if (array/includes @entity.enabledIds (object/get @e id)) "secondary" "ghost"), aria-pressed: (if (array/includes @entity.enabledIds (object/get @e id)) "true" "false") })) },
+                { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: [
+                    { type: button, action: RESET, label: @config.resetLabel, icon: "rotate-ccw", variant: ghost },
+                    { type: typography, variant: caption, color: muted, content: (str/concat "Total " @entity.total " of " @config.threshold) }
+                  ] },
+                { type: typography, variant: body, content: @entity.readout }
+              ] }
+          ]
+        })
+
+      ROSTER_LOADED -> idle when (and (== @config.rosterSource "event") (not (== ?mode @config.matchMode)))
+        (set @entity.active false)
+        (render-ui main null)
+
       TOGGLE -> idle when (== @entity.active true)
         (set @entity.enabledIds (if (array/includes @entity.enabledIds ?elementId) (array/filter @entity.enabledIds (fn eid (!= @eid ?elementId))) (array/concat @entity.enabledIds [?elementId])))
         (let (
-            (activeElements (array/filter @config.elements (fn e (array/includes @entity.enabledIds (object/get @e id)))))
+            (activeElements (array/filter @entity.elements (fn e (array/includes @entity.enabledIds (object/get @e id)))))
             (total (array/sum (array/map @activeElements (fn e (object/get @e weight)))))
             (holds (>= @total @config.threshold))
             (readout (str/concat @config.outcomeLabel ": total " @total " of " @config.threshold " needed. " (if @holds "Holds." "Does not hold.")))
-            (nodes (array/map @config.elements (fn e { id: (object/get @e id), x: (object/get @e x), y: (object/get @e y), radius: @config.nodeRadius, color: (if (array/includes @entity.enabledIds (object/get @e id)) @config.enabledColor @config.disabledColor), label: (object/get @e label) })))
-            (edges (array/map @config.links (fn l { from: (object/get @l from), to: (object/get @l to), color: (if (and (array/includes @entity.enabledIds (object/get @l from)) (array/includes @entity.enabledIds (object/get @l to))) @config.enabledEdgeColor @config.disabledEdgeColor) })))
+            (nodes (array/map @entity.elements (fn e { id: (object/get @e id), x: (object/get @e x), y: (object/get @e y), radius: @config.nodeRadius, color: (if (array/includes @entity.enabledIds (object/get @e id)) @config.enabledColor @config.disabledColor), label: (object/get @e label) })))
+            (edges (array/map @entity.links (fn l { from: (object/get @l from), to: (object/get @l to), color: (if (and (array/includes @entity.enabledIds (object/get @l from)) (array/includes @entity.enabledIds (object/get @l to))) @config.enabledEdgeColor @config.disabledEdgeColor) })))
           )
           (do
             (set @entity.total @total)
@@ -164,7 +219,7 @@ orbital LearnSandboxOrbital {
                     { type: badge, variant: (if @entity.holds "primary" "warning"), label: (if @entity.holds "Holds" "Does not hold") }
                   ] },
                 { type: biology-canvas, width: @config.width, height: @config.height, backgroundColor: @config.backgroundColor, nodes: @entity.nodes, edges: @entity.edges, shapes: [], interactive: @config.interactive, animate: @config.animate, keyMap: { KeyR: RESET } },
-                { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: (array/map @config.elements (fn e { type: button, action: TOGGLE, actionPayload: { elementId: (object/get @e id) }, label: (if (array/includes @entity.enabledIds (object/get @e id)) (object/get @e label) (str/concat (object/get @e label) " — off")), variant: (if (array/includes @entity.enabledIds (object/get @e id)) "secondary" "ghost"), aria-pressed: (if (array/includes @entity.enabledIds (object/get @e id)) "true" "false") })) },
+                { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: (array/map @entity.elements (fn e { type: button, action: TOGGLE, actionPayload: { elementId: (object/get @e id) }, label: (if (array/includes @entity.enabledIds (object/get @e id)) (object/get @e label) (str/concat (object/get @e label) " — off")), variant: (if (array/includes @entity.enabledIds (object/get @e id)) "secondary" "ghost"), aria-pressed: (if (array/includes @entity.enabledIds (object/get @e id)) "true" "false") })) },
                 { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: [
                     { type: button, action: RESET, label: @config.resetLabel, icon: "rotate-ccw", variant: ghost },
                     { type: typography, variant: caption, color: muted, content: (str/concat "Total " @entity.total " of " @config.threshold) }
@@ -176,14 +231,14 @@ orbital LearnSandboxOrbital {
         (emit SYSTEM_CHANGED { total: @entity.total, holds: @entity.holds })
 
       RESET -> idle when (== @entity.active true)
-        (set @entity.enabledIds (array/map (array/filter @config.elements (fn e (== (object/get @e enabled true) true))) (fn e (object/get @e id))))
+        (set @entity.enabledIds (array/map (array/filter @entity.elements (fn e (== (object/get @e enabled true) true))) (fn e (object/get @e id))))
         (let (
-            (activeElements (array/filter @config.elements (fn e (array/includes @entity.enabledIds (object/get @e id)))))
+            (activeElements (array/filter @entity.elements (fn e (array/includes @entity.enabledIds (object/get @e id)))))
             (total (array/sum (array/map @activeElements (fn e (object/get @e weight)))))
             (holds (>= @total @config.threshold))
             (readout (str/concat @config.outcomeLabel ": total " @total " of " @config.threshold " needed. " (if @holds "Holds." "Does not hold.")))
-            (nodes (array/map @config.elements (fn e { id: (object/get @e id), x: (object/get @e x), y: (object/get @e y), radius: @config.nodeRadius, color: (if (array/includes @entity.enabledIds (object/get @e id)) @config.enabledColor @config.disabledColor), label: (object/get @e label) })))
-            (edges (array/map @config.links (fn l { from: (object/get @l from), to: (object/get @l to), color: (if (and (array/includes @entity.enabledIds (object/get @l from)) (array/includes @entity.enabledIds (object/get @l to))) @config.enabledEdgeColor @config.disabledEdgeColor) })))
+            (nodes (array/map @entity.elements (fn e { id: (object/get @e id), x: (object/get @e x), y: (object/get @e y), radius: @config.nodeRadius, color: (if (array/includes @entity.enabledIds (object/get @e id)) @config.enabledColor @config.disabledColor), label: (object/get @e label) })))
+            (edges (array/map @entity.links (fn l { from: (object/get @l from), to: (object/get @l to), color: (if (and (array/includes @entity.enabledIds (object/get @l from)) (array/includes @entity.enabledIds (object/get @l to))) @config.enabledEdgeColor @config.disabledEdgeColor) })))
           )
           (do
             (set @entity.total @total)
@@ -206,7 +261,7 @@ orbital LearnSandboxOrbital {
                     { type: badge, variant: (if @entity.holds "primary" "warning"), label: (if @entity.holds "Holds" "Does not hold") }
                   ] },
                 { type: biology-canvas, width: @config.width, height: @config.height, backgroundColor: @config.backgroundColor, nodes: @entity.nodes, edges: @entity.edges, shapes: [], interactive: @config.interactive, animate: @config.animate, keyMap: { KeyR: RESET } },
-                { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: (array/map @config.elements (fn e { type: button, action: TOGGLE, actionPayload: { elementId: (object/get @e id) }, label: (if (array/includes @entity.enabledIds (object/get @e id)) (object/get @e label) (str/concat (object/get @e label) " — off")), variant: (if (array/includes @entity.enabledIds (object/get @e id)) "secondary" "ghost"), aria-pressed: (if (array/includes @entity.enabledIds (object/get @e id)) "true" "false") })) },
+                { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: (array/map @entity.elements (fn e { type: button, action: TOGGLE, actionPayload: { elementId: (object/get @e id) }, label: (if (array/includes @entity.enabledIds (object/get @e id)) (object/get @e label) (str/concat (object/get @e label) " — off")), variant: (if (array/includes @entity.enabledIds (object/get @e id)) "secondary" "ghost"), aria-pressed: (if (array/includes @entity.enabledIds (object/get @e id)) "true" "false") })) },
                 { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: [
                     { type: button, action: RESET, label: @config.resetLabel, icon: "rotate-ccw", variant: ghost },
                     { type: typography, variant: caption, color: muted, content: (str/concat "Total " @entity.total " of " @config.threshold) }
@@ -224,6 +279,13 @@ orbital LearnSandboxOrbital {
       }
         @description "Lab router broadcast naming the active mode; this instrument renders when the mode equals matchMode, otherwise renders null."
         @tier "domain"
+      ROSTER_LOADED {
+        mode : string!
+        elements : [LearnSandboxElement]!
+        links : [LearnSandboxLink]!
+      }
+        @description "Runtime content feed, honoured only when rosterSource is event — mode names the instrument it is for (the matchMode it carries, blank when standalone) and elements and links are the element roster and its relationships; a matching instrument re-initialises from it exactly as INIT does from config, any other instrument hides."
+        @tier "domain"
       TOGGLE {
         elementId : string
       }
@@ -253,7 +315,7 @@ orbital LearnSandboxOrbital {
     config {
       matchMode : string = ""
         @label "Match Mode"
-        @description "When composed behind a lab router, the MODE_SELECTED mode value this instrument responds to. Empty string means standalone — render immediately on INIT."
+        @description "When composed behind a lab router, the MODE_SELECTED mode value this instrument responds to. Empty string means standalone — render immediately on INIT, or on ROSTER_LOADED when rosterSource is event."
         @tier "presentation"
       title : string = "System Sandbox"
         @label "Title"
@@ -282,6 +344,10 @@ orbital LearnSandboxOrbital {
         @label "Animate"
         @description "Enable continuous redraw loop."
         @tier "presentation"
+      rosterSource : "config" | "event" = "config"
+        @label "Roster Source"
+        @description "Where the roster comes from: config reads elements and links knobs at INIT; event waits for ROSTER_LOADED and takes the roster from its payload."
+        @tier "domain"
       elements : [LearnSandboxElement] = [
         { id: "a", label: "Module A", weight: 15, enabled: true, x: 100, y: 80 },
         { id: "b", label: "Module B", weight: 20, enabled: true, x: 300, y: 60 },