@almadar/std 16.242.0 → 16.244.0

package/behaviors/lolo/ui/learning/atoms/std-learn-scatter-fit.lolo

@@ -24,6 +24,7 @@ orbital LearnScatterFitOrbital {
     id : string!
     active : boolean = false
     title : string
+    initialPoints : [LearnScatterFitPoint]
     points : [LearnScatterFitPoint]
     slope : number
     intercept : number
@@ -43,7 +44,8 @@ orbital LearnScatterFitOrbital {
     initial: idle
 
     state idle {
-      INIT -> idle when (== @config.matchMode "")
+      INIT -> idle when (and (== @config.matchMode "") (== @config.rosterSource "config"))
+        (set @entity.initialPoints @config.initialPoints)
         (set @entity.active true)
         (set @entity.title @config.title)
         (set @entity.points @config.initialPoints)
@@ -123,7 +125,8 @@ orbital LearnScatterFitOrbital {
         (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.initialPoints @config.initialPoints)
         (set @entity.active true)
         (set @entity.title @config.title)
         (set @entity.points @config.initialPoints)
@@ -198,6 +201,87 @@ orbital LearnScatterFitOrbital {
         })
         (emit LEARN_SCATTER_FIT_UPDATED { slope: @entity.slope, intercept: @entity.intercept, r: @entity.r, rSquared: @entity.rSquared, pointCount: (array/len @entity.points), narration: @entity.narration })
 
+      ROSTER_LOADED -> idle when (and (== @config.rosterSource "event") (== ?mode @config.matchMode))
+        (set @entity.initialPoints ?initialPoints)
+        (set @entity.active true)
+        (set @entity.title @config.title)
+        (set @entity.points ?initialPoints)
+        (set @entity.guessSlope 0)
+        (set @entity.guessIntercept (/ (+ @config.axisYMin @config.axisYMax) 2))
+        (set @entity.revealed false)
+        (set @entity.running @config.autoRun)
+        (let (
+            (pts ?initialPoints)
+            (n (array/len @pts))
+            (meanX (if (> @n 0) (/ (array/reduce @pts 0 (fn (acc p) (+ @acc (object/get @p x)))) @n) 0))
+            (meanY (if (> @n 0) (/ (array/reduce @pts 0 (fn (acc p) (+ @acc (object/get @p y)))) @n) 0))
+            (sxx (array/reduce @pts 0 (fn (acc p) (let ((dx (- (object/get @p x) @meanX))) (+ @acc (* @dx @dx))))))
+            (syy (array/reduce @pts 0 (fn (acc p) (let ((dy (- (object/get @p y) @meanY))) (+ @acc (* @dy @dy))))))
+            (sxy (array/reduce @pts 0 (fn (acc p) (+ @acc (* (- (object/get @p x) @meanX) (- (object/get @p y) @meanY))))))
+            (newSlope (if (> @sxx 0) (/ @sxy @sxx) 0))
+            (newIntercept (- @meanY (* @newSlope @meanX)))
+            (newR (if (and (> @sxx 0) (> @syy 0)) (/ @sxy (math/sqrt (* @sxx @syy))) 0))
+            (fitCurve { label: @config.fitLabel, color: @config.fitColor, samples: [
+              { x: @config.axisXMin, y: (math/clamp @newIntercept @config.axisYMin @config.axisYMax) },
+              { x: @config.axisXMax, y: (math/clamp (+ (* @newSlope @config.axisXMax) @newIntercept) @config.axisYMin @config.axisYMax) }
+            ]})
+            (residualCurves (if @config.showResiduals
+              (array/map @pts (fn p { label: "", color: @config.residualColor, dash: @config.residualDash, samples: [ { x: (object/get @p x), y: (object/get @p y) }, { x: (object/get @p x), y: (+ (* @newSlope (object/get @p x)) @newIntercept) } ] }))
+              []))
+          )
+          (do
+            (set @entity.slope @newSlope)
+            (set @entity.intercept @newIntercept)
+            (set @entity.r @newR)
+            (set @entity.rSquared (* @newR @newR))
+            (set @entity.guessScore 0)
+            (set @entity.curves (array/concat (array/append [] @fitCurve) @residualCurves))
+            (set @entity.done (>= @n @config.maxPoints))
+            (set @entity.narration (str/concat (str/concat "" @n) " " @config.narrationLoadedTemplate " — r = " (str/concat "" (math/round @newR 3)) ", R² = " (str/concat "" (math/round (* @newR @newR) 3))))
+          )
+        )
+        (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.revealed "Revealed" (if @entity.done "Max points" (if @entity.running "Adding points" (if @config.guessMode "Guessing" "Fitted")))), variant: (if @entity.revealed "success" (if @entity.done "neutral" (if @entity.running "primary" "neutral"))) }
+                  ] },
+                { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: [
+                    { type: button, action: ADD_POINT, label: @config.addPointLabel, icon: "plus", variant: primary, disabled: @entity.done },
+                    { type: button, action: REVEAL_FIT, label: @config.revealLabel, icon: "eye", variant: secondary },
+                    (if @entity.running { type: button, action: TOGGLE_RUN, label: @config.pauseLabel, icon: "pause", variant: secondary, aria-pressed: "true" } { type: button, action: TOGGLE_RUN, label: @config.runLabel, icon: "play", variant: secondary, aria-pressed: "false", disabled: @entity.done }),
+                    { type: button, action: RESET, label: @config.resetLabel, icon: "rotate-ccw", variant: ghost },
+                    { type: typography, variant: caption, color: muted, content: (str/concat (str/concat "" (array/len @entity.points)) (str/concat " of " (str/concat "" @config.maxPoints))) }
+                  ] },
+                { type: math-canvas, keyMap: { Space: TOGGLE_RUN, ArrowRight: ADD_POINT, KeyR: RESET }, width: @config.width, height: @config.height, xMin: @config.axisXMin, xMax: @config.axisXMax, yMin: @config.axisYMin, yMax: @config.axisYMax, showAxes: @config.showAxes, showGrid: @config.showGrid, gridStep: @config.gridStep, showTickLabels: @config.showTickLabels, curves: @entity.curves, points: @entity.points, vectors: [], interactive: @config.interactive, animate: @config.animate },
+                { type: stack, direction: vertical, gap: sm, children: [
+                    { type: stack, direction: vertical, gap: xs, children: [
+                        { type: typography, variant: caption, content: (str/concat @config.guessSlopeCaption (math/round @entity.guessSlope 2)) },
+                        { type: range-slider, min: @config.guessSlopeMin, max: @config.guessSlopeMax, step: @config.guessSlopeStep, value: @entity.guessSlope, showTooltip: true, action: "GUESS_LINE", actionPayload: { param: "slope" } }
+                      ] },
+                    { type: stack, direction: vertical, gap: xs, children: [
+                        { type: typography, variant: caption, content: (str/concat @config.guessInterceptCaption (math/round @entity.guessIntercept 1)) },
+                        { type: range-slider, min: @config.guessInterceptMin, max: @config.guessInterceptMax, step: @config.guessInterceptStep, value: @entity.guessIntercept, showTooltip: true, action: "GUESS_LINE", actionPayload: { param: "intercept" } }
+                      ] }
+                  ] },
+                { type: typography, variant: caption, color: muted, content: (if @config.showR (str/concat "r = " (math/round @entity.r 3) " — R² = " (math/round @entity.rSquared 3) " — guess score " @entity.guessScore "%") "") },
+                { type: typography, variant: body, content: @entity.narration }
+              ] }
+          ]
+        })
+        (emit LEARN_SCATTER_FIT_UPDATED { slope: @entity.slope, intercept: @entity.intercept, r: @entity.r, rSquared: @entity.rSquared, pointCount: (array/len @entity.points), narration: @entity.narration })
+
+      ROSTER_LOADED -> idle when (and (== @config.rosterSource "event") (not (== ?mode @config.matchMode)))
+        (set @entity.active false)
+        (set @entity.running false)
+        (render-ui main null)
+
       ADD_POINT -> idle when (and @entity.active (not @entity.done))
         (let (
             (marginX (* (- @config.axisXMax @config.axisXMin) @config.pointMarginPct))
@@ -531,13 +615,13 @@ orbital LearnScatterFitOrbital {
         (emit LEARN_SCATTER_FIT_UPDATED { slope: @entity.slope, intercept: @entity.intercept, r: @entity.r, rSquared: @entity.rSquared, pointCount: (array/len @entity.points), narration: @entity.narration })
 
       RESET -> idle when (== @entity.active true)
-        (set @entity.points @config.initialPoints)
+        (set @entity.points @entity.initialPoints)
         (set @entity.guessSlope 0)
         (set @entity.guessIntercept (/ (+ @config.axisYMin @config.axisYMax) 2))
         (set @entity.revealed false)
         (set @entity.running @config.autoRun)
         (let (
-            (pts @config.initialPoints)
+            (pts @entity.initialPoints)
             (n (array/len @pts))
             (meanX (if (> @n 0) (/ (array/reduce @pts 0 (fn (acc p) (+ @acc (object/get @p x)))) @n) 0))
             (meanY (if (> @n 0) (/ (array/reduce @pts 0 (fn (acc p) (+ @acc (object/get @p y)))) @n) 0))
@@ -697,6 +781,12 @@ orbital LearnScatterFitOrbital {
       }
         @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!
+        initialPoints : [LearnScatterFitPoint]!
+      }
+        @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 initialPoints is the starting point set; a matching instrument re-initialises from it exactly as INIT does from config, any other instrument hides."
+        @tier "domain"
       DRAG_POINT {
         id : string
         x : number
@@ -736,7 +826,7 @@ orbital LearnScatterFitOrbital {
     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"
       autoRun : boolean = false
         @label "Auto Run"
@@ -750,6 +840,10 @@ orbital LearnScatterFitOrbital {
         @label "Concept"
         @description "One line under the title saying what the learner is looking at (keep it under ~65 characters). Empty shows no line."
         @tier "presentation"
+      rosterSource : "config" | "event" = "config"
+        @label "Roster Source"
+        @description "Where the roster comes from: config reads initialPoints knob at INIT; event waits for ROSTER_LOADED and takes the roster from its payload."
+        @tier "domain"
       initialPoints : [LearnScatterFitPoint] = [
         { id: "p0", x: 15, y: 25, label: "", color: "ink", radius: 5 },
         { id: "p1", x: 32, y: 40, label: "", color: "ink", radius: 5 },

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

@@ -18,6 +18,8 @@ orbital ScenarioOrbital {
     id : string!
     active : boolean = false
     title : string
+    nodes : [ScenarioNode]
+    startId : string
     currentId : string
     situation : string
     choices : [ScenarioChoice]
@@ -34,7 +36,9 @@ orbital ScenarioOrbital {
     initial: idle
 
     state idle {
-      INIT -> idle when (== @config.matchMode "")
+      INIT -> idle when (and (== @config.matchMode "") (== @config.rosterSource "config"))
+        (set @entity.nodes @config.nodes)
+        (set @entity.startId @config.startId)
         (let (
             (start (array/find @config.nodes (fn n (== (object/get @n id) @config.startId))))
           )
@@ -89,7 +93,9 @@ orbital ScenarioOrbital {
         (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.nodes @config.nodes)
+        (set @entity.startId @config.startId)
         (let (
             (start (array/find @config.nodes (fn n (== (object/get @n id) @config.startId))))
           )
@@ -140,11 +146,68 @@ orbital ScenarioOrbital {
           ]
         })
 
+      ROSTER_LOADED -> idle when (and (== @config.rosterSource "event") (and (== ?mode @config.matchMode) (> (array/len ?nodes) 0)))
+        (set @entity.nodes ?nodes)
+        (set @entity.startId ?startId)
+        (let (
+            (start (array/find ?nodes (fn n (== (object/get @n id) ?startId))))
+          )
+          (do
+            (set @entity.active true)
+            (set @entity.title @config.title)
+            (set @entity.currentId ?startId)
+            (set @entity.situation (object/get @start situation))
+            (set @entity.choices (object/get @start choices []))
+            (set @entity.metricA @config.metricAStart)
+            (set @entity.metricB @config.metricBStart)
+            (set @entity.stepCount 0)
+            (set @entity.path [])
+            (set @entity.done false)
+            (set @entity.feedback "")
+            (set @entity.view [
+              { type: card, variant: bordered, padding: md, children: [
+                  { type: typography, variant: body, content: @entity.situation }
+                ] }
+            ])))
+        (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 "Ended" (str/concat "Decision " (+ @entity.stepCount 1))), variant: (if @entity.done "primary" "neutral") }
+                  ] },
+                { type: stack, direction: horizontal, align: center, gap: md, wrap: true, children: [
+                    { type: stat-display, label: @config.metricALabel, value: (math/round @entity.metricA 0) },
+                    { type: stat-display, label: @config.metricBLabel, value: (math/round @entity.metricB 0) }
+                  ] },
+                { type: stack, direction: vertical, gap: md, children: @entity.view },
+                { type: stack, direction: vertical, gap: sm, children: (array/map (array/range 0 (array/len @entity.choices)) (fn (i)
+                    { type: button, action: CHOOSE, actionPayload: { index: @i }, label: (object/get (array/nth @entity.choices @i) label), variant: secondary, size: lg, disabled: (if @entity.done true false) })) },
+                { type: typography, variant: body, content: @entity.feedback },
+                { type: stack, direction: vertical, gap: xs, children: (array/map @entity.path (fn (line)
+                    { type: typography, variant: caption, color: muted, content: @line })) },
+                { type: stack, direction: horizontal, align: center, gap: sm, wrap: true, children: [
+                    { type: button, action: RESTART, label: @config.restartLabel, icon: "rotate-ccw", variant: primary, disabled: (if @entity.done false true) },
+                    { type: typography, variant: caption, color: muted, content: (str/concat "Decisions " @entity.stepCount) }
+                  ] }
+              ] }
+          ]
+        })
+
+      ROSTER_LOADED -> idle when (and (== @config.rosterSource "event") (not (== ?mode @config.matchMode)))
+        (set @entity.active false)
+        (render-ui main null)
+
       CHOOSE -> idle when (and (== @entity.active true) (== @entity.done false))
         (let (
             (choice (array/nth @entity.choices ?index))
             (nextId (object/get @choice next))
-            (nextNode (array/find @config.nodes (fn n (== (object/get @n id) @nextId))))
+            (nextNode (array/find @entity.nodes (fn n (== (object/get @n id) @nextId))))
             (nextChoices (object/get @nextNode choices []))
             (ended (== (array/len @nextChoices) 0))
             (note (object/get @choice note ""))
@@ -208,12 +271,12 @@ orbital ScenarioOrbital {
 
       RESTART -> idle when (and (== @entity.active true) (== @entity.done true))
         (let (
-            (start (array/find @config.nodes (fn n (== (object/get @n id) @config.startId))))
+            (start (array/find @entity.nodes (fn n (== (object/get @n id) @entity.startId))))
           )
           (do
             (set @entity.active true)
             (set @entity.title @config.title)
-            (set @entity.currentId @config.startId)
+            (set @entity.currentId @entity.startId)
             (set @entity.situation (object/get @start situation))
             (set @entity.choices (object/get @start choices []))
             (set @entity.metricA @config.metricAStart)
@@ -256,7 +319,7 @@ orbital ScenarioOrbital {
               ] }
           ]
         })
-        (emit SCENARIO_RESTARTED { startId: @config.startId })
+        (emit SCENARIO_RESTARTED { startId: @entity.startId })
     }
 
     listens {
@@ -265,6 +328,13 @@ orbital ScenarioOrbital {
       }
         @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!
+        nodes : [ScenarioNode]!
+        startId : string!
+      }
+        @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 nodes is the decision graph and startId the node it opens on; a matching instrument re-initialises from it exactly as INIT does from config, any other instrument hides."
+        @tier "domain"
       CHOOSE {
         index : number
       }
@@ -296,7 +366,7 @@ orbital ScenarioOrbital {
     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 = "Decision Scenario"
         @label "Title"
@@ -324,6 +394,10 @@ orbital ScenarioOrbital {
         @label "Start Node"
         @description "Id of the node the scenario opens on."
         @tier "domain"
+      rosterSource : "config" | "event" = "config"
+        @label "Roster Source"
+        @description "Where the roster comes from: config reads nodes and startId knobs at INIT; event waits for ROSTER_LOADED and takes the roster from its payload."
+        @tier "domain"
       nodes : [ScenarioNode] = [
         { id: "start", situation: "Your town's river floods every spring. The council asks you to lead the response.", choices: [
             { label: "Build a levee now", next: "levee", deltaA: -60, deltaB: 10, note: "Fast protection, most of the budget gone." },

package/behaviors/lolo/ui/learning/atoms/std-learn-speed-drill.lolo

@@ -11,6 +11,7 @@ orbital SpeedDrillOrbital {
     id : string!
     active : boolean = false
     title : string
+    items : [SpeedDrillItem]
     itemIndex : number = 0
     totalItems : number = 0
     remaining : number = 0
@@ -32,7 +33,8 @@ orbital SpeedDrillOrbital {
     initial: idle
 
     state idle {
-      INIT -> idle when (== @config.matchMode "")
+      INIT -> idle when (and (== @config.matchMode "") (== @config.rosterSource "config"))
+        (set @entity.items @config.items)
         (let (
             (first (array/nth @config.items 0))
           )
@@ -94,7 +96,8 @@ orbital SpeedDrillOrbital {
         (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.items @config.items)
         (let (
             (first (array/nth @config.items 0))
           )
@@ -151,6 +154,69 @@ orbital SpeedDrillOrbital {
           ]
         })
 
+      ROSTER_LOADED -> idle when (and (== @config.rosterSource "event") (and (== ?mode @config.matchMode) (> (array/len ?items) 0)))
+        (set @entity.items ?items)
+        (let (
+            (first (array/nth ?items 0))
+          )
+          (do
+            (set @entity.active true)
+            (set @entity.title @config.title)
+            (set @entity.itemIndex 0)
+            (set @entity.totalItems (array/len ?items))
+            (set @entity.remaining (* @config.timeLimit 10))
+            (set @entity.running true)
+            (set @entity.verdict "")
+            (set @entity.pickedIndex -1)
+            (set @entity.score 0)
+            (set @entity.streak 0)
+            (set @entity.bestStreak 0)
+            (set @entity.done false)
+            (set @entity.promptText (object/get @first prompt))
+            (set @entity.options (object/get @first options))
+            (set @entity.correctIndex (object/get @first correctIndex))
+            (set @entity.feedback "")
+            (set @entity.view [
+              { type: card, variant: bordered, padding: md, children: [
+                  { type: typography, variant: h4, content: @entity.promptText }
+                ] }
+            ])))
+        (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 "Round complete" (str/concat @entity.score " pts · streak " @entity.streak)), variant: (if @entity.done "primary" (if (== @entity.verdict "correct") "success" (if (== @entity.verdict "") "neutral" "error"))) }
+                  ] },
+                { type: progress-bar, value: (+ @entity.itemIndex 1), max: @entity.totalItems, showPercentage: false, label: (str/concat "Item " (str/concat "" (+ @entity.itemIndex 1)) " of " (str/concat "" @entity.totalItems)) },
+                { type: progress-bar, value: @entity.remaining, max: (* @config.timeLimit 10), variant: (if (< @entity.remaining (* @config.timeLimit 3)) "warning" "primary"), showPercentage: false, label: (str/concat "Time left: " (math/round (/ @entity.remaining 10) 1) "s") },
+                { 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: ANSWER, actionPayload: { index: @i }, label: (array/nth @entity.options @i), size: lg, disabled: (not @entity.running), variant: (if @entity.running "secondary" (if (== @i @entity.correctIndex) "success" (if (== @i @entity.pickedIndex) "danger" "ghost"))) })) },
+                (if (or (== @entity.feedback "") @entity.done) null { type: stack, direction: vertical, gap: xs, children: [
+                    { type: badge, variant: (if (== @entity.verdict "correct") "success" "error"), label: (if (== @entity.verdict "correct") "Correct" (if (== @entity.verdict "timeout") "Time's up" "Incorrect")) },
+                    { type: typography, variant: body, content: @entity.feedback }
+                  ] }),
+                (if @entity.done { type: typography, variant: body, content: @entity.feedback } null),
+                { 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.running false) (and (!= @entity.verdict "") (== @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 "Best streak " @entity.bestStreak) }
+                  ] }
+              ] }
+          ]
+        })
+
+      ROSTER_LOADED -> idle when (and (== @config.rosterSource "event") (not (== ?mode @config.matchMode)))
+        (set @entity.active false)
+        (set @entity.running false)
+        (render-ui main null)
+
       ANSWER -> idle when (and (== @entity.active true) (and (== @entity.running true) (== @entity.done false)))
         (let (
             (correct (== ?index @entity.correctIndex))
@@ -171,11 +237,11 @@ orbital SpeedDrillOrbital {
         (emit ANSWER_JUDGED { correct: (== @entity.verdict "correct"), timeLeftTenths: @entity.remaining, score: @entity.score, streak: @entity.streak })
 
       NEXT -> idle when (and (== @entity.active true) (and (== @entity.running false) (and (!= @entity.verdict "") (== @entity.done false))))
-        (if (>= (+ @entity.itemIndex 1) (array/len @config.items)) (emit LEARN_ROUND_COMPLETE { score: @entity.score, total: (array/len @config.items) }) null)
+        (if (>= (+ @entity.itemIndex 1) (array/len @entity.items)) (emit LEARN_ROUND_COMPLETE { score: @entity.score, total: (array/len @entity.items) }) null)
         (let (
             (nextIndex (+ @entity.itemIndex 1))
-            (finished (>= @nextIndex (array/len @config.items)))
-            (next (array/nth @config.items (math/min @nextIndex (- (array/len @config.items) 1))))
+            (finished (>= @nextIndex (array/len @entity.items)))
+            (next (array/nth @entity.items (math/min @nextIndex (- (array/len @entity.items) 1))))
           )
           (do
             (set @entity.itemIndex (if @finished @entity.itemIndex @nextIndex))
@@ -233,7 +299,7 @@ orbital SpeedDrillOrbital {
 
       RETRY -> idle when (and (== @entity.active true) (== @entity.done true))
         (let (
-            (first (array/nth @config.items 0))
+            (first (array/nth @entity.items 0))
           )
           (do
             (set @entity.itemIndex 0)
@@ -303,6 +369,12 @@ orbital SpeedDrillOrbital {
       }
         @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!
+        items : [SpeedDrillItem]!
+      }
+        @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 items is the drill roster; a matching instrument re-initialises from it exactly as INIT does from config, any other instrument hides."
+        @tier "domain"
       ANSWER {
         index : number
       }
@@ -352,7 +424,7 @@ orbital SpeedDrillOrbital {
     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 = "Speed Drill"
         @label "Title"
@@ -362,6 +434,10 @@ orbital SpeedDrillOrbital {
         @label "Concept"
         @description "One line under the title saying what is being drilled (keep it under ~65 characters). Empty shows no line."
         @tier "presentation"
+      rosterSource : "config" | "event" = "config"
+        @label "Roster Source"
+        @description "Where the roster comes from: config reads items knob at INIT; event waits for ROSTER_LOADED and takes the roster from its payload."
+        @tier "domain"
       items : [SpeedDrillItem] = [
         { prompt: "7 × 8", options: ["54", "56", "63", "48"], correctIndex: 1 },
         { prompt: "9 × 6", options: ["54", "56", "45", "63"], correctIndex: 0 },