@almadar/std 16.244.0 → 16.245.0

package/behaviors/signatures.lolo

@@ -11335,7 +11335,7 @@ pattern meter {
 ;; an `Alias.orbitals.X` reference overrides config + identifiers, never
 ;; the imported orbital's own topology.
 
-;; === atoms (280 behaviors, 280 apps, 281 orbitals, 281 entities, 302 traits, 284 pages) ===
+;; === atoms (288 behaviors, 288 apps, 290 orbitals, 290 entities, 314 traits, 293 pages) ===
 
 ;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-completion.orb)
 app std-agent-completion {
@@ -11387,6 +11387,16 @@ app std-agent-planner {
   source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-planner.orb)"
 }
 
+;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-proposal.orb)
+app std-agent-proposal {
+  alias          : AgentProposal
+  version        : "1.0.0"
+  orbitals       : (AgentProposalOrbital)
+  override-surface : (config)
+  ;; via uses Alias from "std/behaviors/std-agent-proposal" { config { ... } }
+  source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-proposal.orb)"
+}
+
 ;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-session.orb)
 app std-agent-session {
   alias          : AgentSession
@@ -11397,6 +11407,16 @@ app std-agent-session {
   source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-session.orb)"
 }
 
+;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-suggestions.orb)
+app std-agent-suggestions {
+  alias          : AgentSuggestions
+  version        : "1.0.0"
+  orbitals       : (AgentSuggestionsOrbital AgentSuggestionRecordsOrbital)
+  override-surface : (config)
+  ;; via uses Alias from "std/behaviors/std-agent-suggestions" { config { ... } }
+  source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-suggestions.orb)"
+}
+
 ;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-tool-call.orb)
 app std-agent-tool-call {
   alias          : AgentToolCall
@@ -11757,6 +11777,16 @@ app std-detail-layout {
   source         : "@almadar/std (behaviors/registry/ui/core/atoms/std-detail-layout.orb)"
 }
 
+;; From @almadar/std (behaviors/registry/ui/core/atoms/std-doc-page.orb)
+app std-doc-page {
+  alias          : DocPage
+  version        : "1.0.0"
+  orbitals       : (DocPageOrbital)
+  override-surface : (config)
+  ;; via uses Alias from "std/behaviors/std-doc-page" { config { ... } }
+  source         : "@almadar/std (behaviors/registry/ui/core/atoms/std-doc-page.orb)"
+}
+
 ;; From @almadar/std (behaviors/registry/ui/game/atoms/std-dungeon-combat.orb)
 app std-dungeon-combat {
   alias          : DungeonCombat
@@ -12587,6 +12617,46 @@ app std-pad-lock {
   source         : "@almadar/std (behaviors/registry/ui/game/atoms/std-pad-lock.orb)"
 }
 
+;; From @almadar/std (behaviors/registry/infra/atoms/std-page-open.orb)
+app std-page-open {
+  alias          : PageOpen
+  version        : "1.0.0"
+  orbitals       : (PageOpenOrbital)
+  override-surface : (config)
+  ;; via uses Alias from "std/behaviors/std-page-open" { config { ... } }
+  source         : "@almadar/std (behaviors/registry/infra/atoms/std-page-open.orb)"
+}
+
+;; From @almadar/std (behaviors/registry/infra/atoms/std-page-search.orb)
+app std-page-search {
+  alias          : PageSearch
+  version        : "1.0.0"
+  orbitals       : (PageSearchOrbital)
+  override-surface : (config)
+  ;; via uses Alias from "std/behaviors/std-page-search" { config { ... } }
+  source         : "@almadar/std (behaviors/registry/infra/atoms/std-page-search.orb)"
+}
+
+;; From @almadar/std (behaviors/registry/infra/atoms/std-page-treat.orb)
+app std-page-treat {
+  alias          : PageTreat
+  version        : "1.0.0"
+  orbitals       : (PageTreatOrbital)
+  override-surface : (config)
+  ;; via uses Alias from "std/behaviors/std-page-treat" { config { ... } }
+  source         : "@almadar/std (behaviors/registry/infra/atoms/std-page-treat.orb)"
+}
+
+;; From @almadar/std (behaviors/registry/infra/atoms/std-page-watch.orb)
+app std-page-watch {
+  alias          : PageWatch
+  version        : "1.0.0"
+  orbitals       : (PageWatchOrbital)
+  override-surface : (config)
+  ;; via uses Alias from "std/behaviors/std-page-watch" { config { ... } }
+  source         : "@almadar/std (behaviors/registry/infra/atoms/std-page-watch.orb)"
+}
+
 ;; From @almadar/std (behaviors/registry/ui/core/atoms/std-pagination.orb)
 app std-pagination {
   alias          : Pagination
@@ -13227,6 +13297,16 @@ app ui-avl-state-machine {
   source         : "@almadar/std (behaviors/registry/ui/avl/atoms/ui-avl-state-machine.orb)"
 }
 
+;; From @almadar/std (behaviors/registry/ui/avl/atoms/ui-avl-transition-explainer.orb)
+app ui-avl-transition-explainer {
+  alias          : UiAvlTransitionExplainer
+  version        : "1.0.0"
+  orbitals       : (AvlTransitionExplainerOrbital)
+  override-surface : (config)
+  ;; via uses Alias from "std/behaviors/ui-avl-transition-explainer" { config { ... } }
+  source         : "@almadar/std (behaviors/registry/ui/avl/atoms/ui-avl-transition-explainer.orb)"
+}
+
 ;; From @almadar/std (behaviors/registry/ui/core/atoms/ui-badge.orb)
 app ui-badge {
   alias          : UiBadge
@@ -14187,6 +14267,39 @@ orbital std-agent-planner.orbitals.AgentPlannerOrbital {
   source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-planner.orb orbitals[0])"
 }
 
+;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-proposal.orb orbitals[0])
+orbital std-agent-proposal.orbitals.AgentProposalOrbital {
+  alias          : AgentProposal
+  entity         : AgentProposalRun
+  traits         : (AgentProposalWorkflow AgentProposalLoop = Loop.traits.AgentToolLoop)
+  pages          : ("/agent-proposal")
+  config {
+    approveLabel   : string = "Approve" @label "Approve button" @tier "presentation"
+    cancelLabel    : string = "Cancel" @label "Cancel button" @tier "presentation"
+    discardLabel   : string = "Discard" @label "Discard button" @tier "presentation"
+    feedbackLabel  : string = "What should change?" @label "Revision feedback label" @tier "presentation"
+    icon           : string = "sparkles" @label "Panel icon" @tier "presentation"
+    inputLabel     : string = "What should the agent work from?" @label "Start form label" @tier "presentation"
+    instructions   : string = "You turn what the person hands over into one structured proposal. Look things up with the tools if you need to, then call the proposal tool exactly once with a short summary and the list of items. Do not call it again unless asked to revise." @label "How should the agent behave?" @description "Standing instructions sent with every run." @synonyms "system prompt, persona, guidance" @tier "domain"
+    itemFields     : [ProposalField] = [] @label "Which item values are shown?" @description "The item keys to show, each `{ name, label, variant }`." @synonyms "columns, fields, attributes" @tier "domain"
+    itemPattern    : pattern = "data-list" @label "How are the proposed items drawn?" @description "The pattern the review renders the items with; it receives `entity` (the items) and `fields`." @synonyms "item layout, list pattern, table" @tier "presentation"
+    itemsHeading   : string = "Items" @label "Items heading" @tier "presentation"
+    maxSteps       : number = 8 @label "Model round-trips per run" @tier "policy"
+    panelSlot      : slot = "main" @label "Where the panel renders" @description "`main` for the content of a page or launcher; `modal` or `drawer` for an overlay." @tier "presentation"
+    prompt         : string = "Work out a proposal from the following." @label "What is the agent asked to do?" @description "The request that precedes the person's input in every run." @synonyms "task, goal, brief, question" @tier "domain"
+    retryLabel     : string = "Retry" @label "Retry button" @tier "presentation"
+    reviseLabel    : string = "Revise" @label "Revise button" @tier "presentation"
+    showInputForm  : boolean = true @label "Show a start form?" @description "On, the idle panel lets the person type what the agent works from. Off, the panel renders nothing until the app starts it with PROPOSAL_REQUESTED." @synonyms "start form, input box, manual start" @tier "presentation"
+    startLabel     : string = "Propose" @label "Start button" @tier "presentation"
+    summaryHeading : string = "Summary" @label "Summary heading" @tier "presentation"
+    title          : string = "Proposal" @label "Panel heading" @tier "presentation"
+    tools          : [AgentTool] = [{"event":"AgentProposalWorkflow.PROPOSE"}] @label "What may the agent do?" @description "The declared inputs it may fire and the entities it may read, as the signed-in person. An importing app restates the list with PROPOSE addressed by its local orbital name, which the agent can never propose without." @synonyms "allowlist, abilities, permissions" @tier "domain"
+    workingLabel   : string = "Working out a proposal…" @label "While the agent works" @tier "presentation"
+  }
+  override-surface : (entity fields extend pages omit only config events roles entities mounts)
+  source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-proposal.orb orbitals[0])"
+}
+
 ;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-session.orb orbitals[1])
 orbital std-agent-session.orbitals.AgentChatsOrbital {
   alias          : AgentSession
@@ -14207,6 +14320,48 @@ orbital std-agent-session.orbitals.AgentSessionOrbital {
   source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-session.orb orbitals[0])"
 }
 
+;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-suggestions.orb orbitals[1])
+orbital std-agent-suggestions.orbitals.AgentSuggestionRecordsOrbital {
+  alias          : AgentSuggestions
+  entity         : AgentSuggestion
+  traits         : (AgentSuggestionHistory)
+  pages          : ("/agent-suggestions/history")
+  override-surface : (entity fields extend pages omit only config events roles entities mounts)
+  source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-suggestions.orb orbitals[1])"
+}
+
+;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-suggestions.orb orbitals[0])
+orbital std-agent-suggestions.orbitals.AgentSuggestionsOrbital {
+  alias          : AgentSuggestions
+  entity         : AgentSuggestionsHost
+  traits         : (AgentSuggestionProposer AgentSuggestionInbox AgentSuggestionTrigger AgentSuggestionRunner AgentSuggestionLoop = Loop.traits.AgentToolLoop)
+  pages          : ("/agent-suggestions")
+  config {
+    acceptLabel    : string = "Accept" @label "Accept button" @tier "presentation"
+    actions        : [string] = [] @label "Which actions may a suggestion carry?" @description "When listed, a proposal carrying any other action, or none, is refused (SUGGESTION_REJECTED). Empty accepts any action." @tier "domain"
+    analyzeLabel   : string = "Look for suggestions" @label "Look-again button" @description "Shown in the empty inbox; asks the agent to look again." @tier "presentation"
+    closeLabel     : string = "Close" @label "Close button" @tier "presentation"
+    cooldownMinutes : number = 60 @label "Minutes between proactive runs" @description "A trigger starts a run only when this long has passed since the person's last run. 0 runs on every trigger." @tier "policy"
+    dismissLabel   : string = "Dismiss" @label "Dismiss button" @tier "presentation"
+    emptyDescription : string = "" @label "Empty inbox hint" @tier "presentation"
+    emptyTitle     : string = "No suggestions right now" @label "Empty inbox title" @tier "presentation"
+    historyHref    : string = "/agent-suggestions/history" @label "Where past suggestions are listed" @description "The page the inbox links to for accepted and dismissed suggestions; empty hides the link. The history page of an app that imports this orbital is its own page over its retargeted entity." @tier "presentation"
+    historyLabel   : string = "Past suggestions" @label "Past-suggestions link" @tier "presentation"
+    icon           : string = "lightbulb" @label "Inbox icon" @tier "presentation"
+    instructions   : string = "You propose next steps to the signed-in person. Look things up with the tools, then call the proposal tool once for each suggestion worth making, with the reason in its body. When a proposal is refused as a duplicate or the pending limit is reached, do not propose again. Propose nothing when nothing is worth suggesting." @label "How should the agent behave?" @description "Standing instructions sent with every proactive run." @tier "domain"
+    kinds          : [string] = [] @label "Which kinds may be proposed?" @description "When listed, a proposal of any other kind is refused (SUGGESTION_REJECTED). Empty accepts any kind." @tier "domain"
+    maxPending     : number = 5 @label "How many suggestions may wait at once?" @description "A proposal is refused (SUGGESTION_LIMIT_REACHED) while this many are pending. 0 refuses every proposal." @tier "policy"
+    maxSteps       : number = 8 @label "Model round-trips per run" @tier "policy"
+    panelSlot      : slot = "main" @label "Where the inbox renders" @description "`main` for the content of a launcher or page; `modal` or `drawer` for an overlay opened with OPEN (a notification bell)." @tier "presentation"
+    prompt         : string = "Look at what I have been doing and propose what I could do next, one suggestion at a time." @label "What does the agent look into?" @description "The request each proactive run answers." @tier "domain"
+    startOpen      : boolean = true @label "Show the inbox as soon as it mounts?" @description "Off for an overlay that waits for OPEN." @tier "presentation"
+    title          : string = "Suggestions" @label "Inbox heading" @tier "presentation"
+    tools          : [AgentTool] = [{"event":"AgentSuggestionProposer.PROPOSE_SUGGESTION"}] @label "What may the agent do?" @description "The declared inputs it may fire and the entities it may read, as the signed-in person. An importing app restates the list with the proposal input addressed by its local orbital name (`{ event: Suggestions.AgentSuggestionProposer.PROPOSE_SUGGESTION }`), which the agent can never propose without." @tier "domain"
+  }
+  override-surface : (entity fields extend pages omit only config events roles entities mounts)
+  source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-suggestions.orb orbitals[0])"
+}
+
 ;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-tool-call.orb orbitals[0])
 orbital std-agent-tool-call.orbitals.AgentToolCallOrbital {
   alias          : AgentToolCall
@@ -14567,6 +14722,16 @@ orbital std-detail-layout.orbitals.DetailLayoutOrbital {
   source         : "@almadar/std (behaviors/registry/ui/core/atoms/std-detail-layout.orb orbitals[0])"
 }
 
+;; From @almadar/std (behaviors/registry/ui/core/atoms/std-doc-page.orb orbitals[0])
+orbital std-doc-page.orbitals.DocPageOrbital {
+  alias          : DocPage
+  entity         : DocPageView
+  traits         : (DocPageRender)
+  pages          : ("/doc")
+  override-surface : (entity fields extend pages omit only config events roles entities mounts)
+  source         : "@almadar/std (behaviors/registry/ui/core/atoms/std-doc-page.orb orbitals[0])"
+}
+
 ;; From @almadar/std (behaviors/registry/ui/game/atoms/std-dungeon-combat.orb orbitals[0])
 orbital std-dungeon-combat.orbitals.DungeonCombatOrbital {
   alias          : DungeonCombat
@@ -15397,6 +15562,46 @@ orbital std-pad-lock.orbitals.PadLockOrbital {
   source         : "@almadar/std (behaviors/registry/ui/game/atoms/std-pad-lock.orb orbitals[0])"
 }
 
+;; From @almadar/std (behaviors/registry/infra/atoms/std-page-open.orb orbitals[0])
+orbital std-page-open.orbitals.PageOpenOrbital {
+  alias          : PageOpen
+  entity         : PageOpenRecord
+  traits         : (PageOpen)
+  pages          : ("/page-open")
+  override-surface : (entity fields extend pages omit only config events roles entities mounts)
+  source         : "@almadar/std (behaviors/registry/infra/atoms/std-page-open.orb orbitals[0])"
+}
+
+;; From @almadar/std (behaviors/registry/infra/atoms/std-page-search.orb orbitals[0])
+orbital std-page-search.orbitals.PageSearchOrbital {
+  alias          : PageSearch
+  entity         : PageSearchRecord
+  traits         : (PageSearch)
+  pages          : ("/page-search")
+  override-surface : (entity fields extend pages omit only config events roles entities mounts)
+  source         : "@almadar/std (behaviors/registry/infra/atoms/std-page-search.orb orbitals[0])"
+}
+
+;; From @almadar/std (behaviors/registry/infra/atoms/std-page-treat.orb orbitals[0])
+orbital std-page-treat.orbitals.PageTreatOrbital {
+  alias          : PageTreat
+  entity         : PageTreatRecord
+  traits         : (PageTreat)
+  pages          : ("/page-treat")
+  override-surface : (entity fields extend pages omit only config events roles entities mounts)
+  source         : "@almadar/std (behaviors/registry/infra/atoms/std-page-treat.orb orbitals[0])"
+}
+
+;; From @almadar/std (behaviors/registry/infra/atoms/std-page-watch.orb orbitals[0])
+orbital std-page-watch.orbitals.PageWatchOrbital {
+  alias          : PageWatch
+  entity         : PageWatchRecord
+  traits         : (PageWatch)
+  pages          : ("/page-watch")
+  override-surface : (entity fields extend pages omit only config events roles entities mounts)
+  source         : "@almadar/std (behaviors/registry/infra/atoms/std-page-watch.orb orbitals[0])"
+}
+
 ;; From @almadar/std (behaviors/registry/ui/core/atoms/std-pagination.orb orbitals[0])
 orbital std-pagination.orbitals.PagedItemOrbital {
   alias          : Pagination
@@ -16037,6 +16242,16 @@ orbital ui-avl-state-machine.orbitals.AvlStateMachineOrbital {
   source         : "@almadar/std (behaviors/registry/ui/avl/atoms/ui-avl-state-machine.orb orbitals[0])"
 }
 
+;; From @almadar/std (behaviors/registry/ui/avl/atoms/ui-avl-transition-explainer.orb orbitals[0])
+orbital ui-avl-transition-explainer.orbitals.AvlTransitionExplainerOrbital {
+  alias          : UiAvlTransitionExplainer
+  entity         : AvlTransitionExplainerItem
+  traits         : (AvlTransitionExplainerRender)
+  pages          : ("/avl-transition-explainer")
+  override-surface : (entity fields extend pages omit only config events roles entities mounts)
+  source         : "@almadar/std (behaviors/registry/ui/avl/atoms/ui-avl-transition-explainer.orb orbitals[0])"
+}
+
 ;; From @almadar/std (behaviors/registry/ui/core/atoms/ui-badge.orb orbitals[0])
 orbital ui-badge.orbitals.BadgeOrbital {
   alias          : UiBadge
@@ -16962,7 +17177,7 @@ entity std-agent-context.entity {
   alias          : AgentContext
   name           : AgentContextWindow
   persistence    : runtime
-  fields         : (id! pendingMessages lastSize)
+  fields         : (id! pendingMessages lastSize pendingInstructions pendingTools pendingEphemeral)
   override-surface : (extends name fields persistence collection)
   source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-context.orb orbitals[0].entity)"
 }
@@ -16998,6 +17213,16 @@ entity std-agent-planner.entity {
   source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-planner.orb orbitals[0].entity)"
 }
 
+;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-proposal.orb orbitals[0].entity)
+entity std-agent-proposal.entity {
+  alias          : AgentProposal
+  name           : AgentProposalRun
+  persistence    : runtime
+  fields         : (id! input context request feedback summary items error)
+  override-surface : (extends name fields persistence collection)
+  source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-proposal.orb orbitals[0].entity)"
+}
+
 ;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-session.orb orbitals[1].entity)
 entity std-agent-session.entity {
   alias          : AgentSession
@@ -17020,6 +17245,27 @@ entity std-agent-session.entity {
   source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-session.orb orbitals[0].entity)"
 }
 
+;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-suggestions.orb orbitals[1].entity)
+entity std-agent-suggestions.entity {
+  alias          : AgentSuggestions
+  name           : AgentSuggestion
+  persistence    : persistent
+  collection     : agentSuggestions
+  fields         : (id! ownerId! kind title body action href payload subject signature status createdAt resolvedAt pendingProposal)
+  override-surface : (extends name fields persistence collection)
+  source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-suggestions.orb orbitals[1].entity)"
+}
+
+;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-suggestions.orb orbitals[0].entity)
+entity std-agent-suggestions.entity {
+  alias          : AgentSuggestions
+  name           : AgentSuggestionsHost
+  persistence    : runtime
+  fields         : (id!)
+  override-surface : (extends name fields persistence collection)
+  source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-suggestions.orb orbitals[0].entity)"
+}
+
 ;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-tool-call.orb orbitals[0].entity)
 entity std-agent-tool-call.entity {
   alias          : AgentToolCall
@@ -17035,7 +17281,7 @@ entity std-agent-tool-loop.entity {
   alias          : AgentToolLoop
   name           : AgentTurn
   persistence    : runtime
-  fields         : (id! status reply error)
+  fields         : (id! status reply error ephemeral)
   override-surface : (extends name fields persistence collection)
   source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-tool-loop.orb orbitals[0].entity)"
 }
@@ -17390,6 +17636,16 @@ entity std-detail-layout.entity {
   source         : "@almadar/std (behaviors/registry/ui/core/atoms/std-detail-layout.orb orbitals[0].entity)"
 }
 
+;; From @almadar/std (behaviors/registry/ui/core/atoms/std-doc-page.orb orbitals[0].entity)
+entity std-doc-page.entity {
+  alias          : DocPage
+  name           : DocPageView
+  persistence    : runtime
+  fields         : (id!)
+  override-surface : (extends name fields persistence collection)
+  source         : "@almadar/std (behaviors/registry/ui/core/atoms/std-doc-page.orb orbitals[0].entity)"
+}
+
 ;; From @almadar/std (behaviors/registry/ui/game/atoms/std-dungeon-combat.orb orbitals[0].entity)
 entity std-dungeon-combat.entity {
   alias          : DungeonCombat
@@ -17680,7 +17936,7 @@ entity std-learn-arrangement.entity {
   alias          : LearnArrangement
   name           : LearnArrangementScene
   persistence    : runtime
-  fields         : (id! active title totalItems placedIds checked correctCount verdict slotShapes)
+  fields         : (id! active items title totalItems placedIds checked correctCount verdict slotShapes)
   override-surface : (extends name fields persistence collection)
   source         : "@almadar/std (behaviors/registry/ui/learning/atoms/std-learn-arrangement.orb orbitals[0].entity)"
 }
@@ -17690,7 +17946,7 @@ entity std-learn-classify.entity {
   alias          : LearnClassify
   name           : LearnClassifyScene
   persistence    : runtime
-  fields         : (id! active title itemIndex itemText itemHint itemExplanation correctCategory selectedCategory feedback verdict correctCount attemptedCount totalItems roundComplete running elapsedMs score categoryStats backdropShapes roundView)
+  fields         : (id! active items categories title itemIndex itemText itemHint itemExplanation correctCategory selectedCategory feedback verdict correctCount attemptedCount totalItems roundComplete running elapsedMs score categoryStats backdropShapes roundView)
   override-surface : (extends name fields persistence collection)
   source         : "@almadar/std (behaviors/registry/ui/learning/atoms/std-learn-classify.orb orbitals[0].entity)"
 }
@@ -17710,7 +17966,7 @@ entity std-learn-coupled-sim.entity {
   alias          : LearnCoupledSim
   name           : CoupledSimScene
   persistence    : runtime
-  fields         : (id! active title t p q coefA coefB running speed pSamples qSamples curves)
+  fields         : (id! active title taskText kind pLabel qLabel pStart qStart coefALabel coefBLabel t p q coefA coefB running speed pSamples qSamples curves)
   override-surface : (extends name fields persistence collection)
   source         : "@almadar/std (behaviors/registry/ui/learning/atoms/std-learn-coupled-sim.orb orbitals[0].entity)"
 }
@@ -17720,7 +17976,7 @@ entity std-learn-derivation.entity {
   alias          : LearnDerivation
   name           : LearnDerivationScene
   persistence    : runtime
-  fields         : (id! active title lines feedback goalReached running elapsedMs narration renderChildren)
+  fields         : (id! active premises candidates title lines feedback goalReached running elapsedMs narration renderChildren)
   override-surface : (extends name fields persistence collection)
   source         : "@almadar/std (behaviors/registry/ui/learning/atoms/std-learn-derivation.orb orbitals[0].entity)"
 }
@@ -17740,7 +17996,7 @@ entity std-learn-doser.entity {
   alias          : LearnDoser
   name           : DoserScene
   persistence    : runtime
-  fields         : (id! active title done running elapsedMs dose bandLabel bandColor narration containers readouts doseSeries)
+  fields         : (id! active title done running elapsedMs dose bandLabel bandColor narration containers readouts doseSeries bands)
   override-surface : (extends name fields persistence collection)
   source         : "@almadar/std (behaviors/registry/ui/learning/atoms/std-learn-doser.orb orbitals[0].entity)"
 }
@@ -17750,7 +18006,7 @@ entity std-learn-estimate.entity {
   alias          : LearnEstimate
   name           : EstimateScene
   persistence    : runtime
-  fields         : (id! active title promptIndex totalPrompts estimate locked band score done promptText promptHint answer unit feedback view)
+  fields         : (id! active title prompts promptIndex totalPrompts estimate locked band score done promptText promptHint answer unit feedback view)
   override-surface : (extends name fields persistence collection)
   source         : "@almadar/std (behaviors/registry/ui/learning/atoms/std-learn-estimate.orb orbitals[0].entity)"
 }
@@ -17770,7 +18026,7 @@ entity std-learn-goal-seek.entity {
   alias          : LearnGoalSeek
   name           : GoalSeekScene
   persistence    : runtime
-  fields         : (id! active title curveKind paramA paramB paramALabel paramBLabel targetSamples curves distance attempts solved feedback resultRow yMin yMax)
+  fields         : (id! active title curveKind goalText targetA targetB paramA paramB paramALabel paramBLabel targetSamples curves distance attempts solved feedback resultRow yMin yMax)
   override-surface : (extends name fields persistence collection)
   source         : "@almadar/std (behaviors/registry/ui/learning/atoms/std-learn-goal-seek.orb orbitals[0].entity)"
 }
@@ -17780,7 +18036,7 @@ entity std-learn-grid-sim.entity {
   alias          : LearnGridSim
   name           : GridSimScene
   persistence    : runtime
-  fields         : (id! active title cells generation aliveCount running speed elapsedMs cellShapes)
+  fields         : (id! active title taskText rule rows cols seeds cells generation aliveCount running speed elapsedMs cellShapes)
   override-surface : (extends name fields persistence collection)
   source         : "@almadar/std (behaviors/registry/ui/learning/atoms/std-learn-grid-sim.orb orbitals[0].entity)"
 }
@@ -17790,7 +18046,7 @@ entity std-learn-hotspot.entity {
   alias          : LearnHotspot
   name           : HotspotScene
   persistence    : runtime
-  fields         : (id! active title promptIndex totalPrompts score tries found done promptText targetId explanation feedback canvasShapes view)
+  fields         : (id! active title shapes prompts promptIndex totalPrompts score tries found done promptText targetId explanation feedback canvasShapes view)
   override-surface : (extends name fields persistence collection)
   source         : "@almadar/std (behaviors/registry/ui/learning/atoms/std-learn-hotspot.orb orbitals[0].entity)"
 }
@@ -17800,7 +18056,7 @@ entity std-learn-live-sim.entity {
   alias          : LearnLiveSim
   name           : LiveSimScene
   persistence    : runtime
-  fields         : (id! active title bodies running gravity damping tickCount sampleSpeed)
+  fields         : (id! active title bodies loadedBodies running gravity damping tickCount sampleSpeed)
   override-surface : (extends name fields persistence collection)
   source         : "@almadar/std (behaviors/registry/ui/learning/atoms/std-learn-live-sim.orb orbitals[0].entity)"
 }
@@ -17840,7 +18096,7 @@ entity std-learn-predict.entity {
   alias          : LearnPredict
   name           : PredictScene
   persistence    : runtime
-  fields         : (id! active title scenarioIndex totalScenarios phase chosenIndex frames frameIndex frameCaption frameValue revealSamples revealCurves score done setupText question options correctIndex explanation feedback view)
+  fields         : (id! active title scenarios scenarioIndex totalScenarios phase chosenIndex frames frameIndex frameCaption frameValue revealSamples revealCurves score done setupText question options correctIndex explanation feedback view)
   override-surface : (extends name fields persistence collection)
   source         : "@almadar/std (behaviors/registry/ui/learning/atoms/std-learn-predict.orb orbitals[0].entity)"
 }
@@ -17860,7 +18116,7 @@ entity std-learn-sandbox.entity {
   alias          : LearnSandbox
   name           : LearnSandboxScene
   persistence    : runtime
-  fields         : (id! active title enabledIds total holds readout nodes edges)
+  fields         : (id! active title elements links enabledIds total holds readout nodes edges)
   override-surface : (extends name fields persistence collection)
   source         : "@almadar/std (behaviors/registry/ui/learning/atoms/std-learn-sandbox.orb orbitals[0].entity)"
 }
@@ -17870,7 +18126,7 @@ entity std-learn-scatter-fit.entity {
   alias          : LearnScatterFit
   name           : LearnScatterFitScene
   persistence    : runtime
-  fields         : (id! active title points slope intercept r rSquared guessSlope guessIntercept guessScore revealed running done curves narration)
+  fields         : (id! active title initialPoints points slope intercept r rSquared guessSlope guessIntercept guessScore revealed running done curves narration)
   override-surface : (extends name fields persistence collection)
   source         : "@almadar/std (behaviors/registry/ui/learning/atoms/std-learn-scatter-fit.orb orbitals[0].entity)"
 }
@@ -17880,7 +18136,7 @@ entity std-learn-scenario.entity {
   alias          : LearnScenario
   name           : ScenarioScene
   persistence    : runtime
-  fields         : (id! active title currentId situation choices metricA metricB stepCount path done feedback view)
+  fields         : (id! active title nodes startId currentId situation choices metricA metricB stepCount path done feedback view)
   override-surface : (extends name fields persistence collection)
   source         : "@almadar/std (behaviors/registry/ui/learning/atoms/std-learn-scenario.orb orbitals[0].entity)"
 }
@@ -17910,7 +18166,7 @@ entity std-learn-speed-drill.entity {
   alias          : LearnSpeedDrill
   name           : SpeedDrillScene
   persistence    : runtime
-  fields         : (id! active title itemIndex totalItems remaining running verdict score streak bestStreak done promptText options correctIndex feedback pickedIndex view)
+  fields         : (id! active title items itemIndex totalItems remaining running verdict score streak bestStreak done promptText options correctIndex feedback pickedIndex view)
   override-surface : (extends name fields persistence collection)
   source         : "@almadar/std (behaviors/registry/ui/learning/atoms/std-learn-speed-drill.orb orbitals[0].entity)"
 }
@@ -17920,7 +18176,7 @@ entity std-learn-stepper.entity {
   alias          : LearnStepper
   name           : LearnStepperScene
   persistence    : runtime
-  fields         : (id! active title cursorIndex activeFilter narration currentStageLabel currentStageDescription categoryTally tallyItems visibleThreadNote shapes filterButtons)
+  fields         : (id! active title stages categories categorySummaries cursorIndex activeFilter narration currentStageLabel currentStageDescription categoryTally tallyItems visibleThreadNote shapes filterButtons)
   override-surface : (extends name fields persistence collection)
   source         : "@almadar/std (behaviors/registry/ui/learning/atoms/std-learn-stepper.orb orbitals[0].entity)"
 }
@@ -17940,7 +18196,7 @@ entity std-learn-trace-player.entity {
   alias          : LearnTracePlayer
   name           : TracePlayerScene
   persistence    : runtime
-  fields         : (id! active title frameIndex running speed elapsedMs bars frameLabel frameCaption statusNote)
+  fields         : (id! active title frames frameIndex running speed elapsedMs bars frameLabel frameCaption statusNote)
   override-surface : (extends name fields persistence collection)
   source         : "@almadar/std (behaviors/registry/ui/learning/atoms/std-learn-trace-player.orb orbitals[0].entity)"
 }
@@ -17960,7 +18216,7 @@ entity std-learn-tree.entity {
   alias          : LearnTree
   name           : LearnTreeScene
   persistence    : runtime
-  fields         : (id! active title nodes edges entries cursor pending descending trail curId curVal curRank curRankOffset depth maxDepth count traversing traversalOrder sweptIds done running narration)
+  fields         : (id! active title values nodes edges entries cursor pending descending trail curId curVal curRank curRankOffset depth maxDepth count traversing traversalOrder sweptIds done running narration)
   override-surface : (extends name fields persistence collection)
   source         : "@almadar/std (behaviors/registry/ui/learning/atoms/std-learn-tree.orb orbitals[0].entity)"
 }
@@ -18232,6 +18488,46 @@ entity std-pad-lock.entity {
   source         : "@almadar/std (behaviors/registry/ui/game/atoms/std-pad-lock.orb orbitals[0].entity)"
 }
 
+;; From @almadar/std (behaviors/registry/infra/atoms/std-page-open.orb orbitals[0].entity)
+entity std-page-open.entity {
+  alias          : PageOpen
+  name           : PageOpenRecord
+  persistence    : runtime
+  fields         : (opened errorMessage)
+  override-surface : (extends name fields persistence collection)
+  source         : "@almadar/std (behaviors/registry/infra/atoms/std-page-open.orb orbitals[0].entity)"
+}
+
+;; From @almadar/std (behaviors/registry/infra/atoms/std-page-search.orb orbitals[0].entity)
+entity std-page-search.entity {
+  alias          : PageSearch
+  name           : PageSearchRecord
+  persistence    : runtime
+  fields         : (query tab errorMessage status)
+  override-surface : (extends name fields persistence collection)
+  source         : "@almadar/std (behaviors/registry/infra/atoms/std-page-search.orb orbitals[0].entity)"
+}
+
+;; From @almadar/std (behaviors/registry/infra/atoms/std-page-treat.orb orbitals[0].entity)
+entity std-page-treat.entity {
+  alias          : PageTreat
+  name           : PageTreatRecord
+  persistence    : runtime
+  fields         : (treated errorMessage)
+  override-surface : (extends name fields persistence collection)
+  source         : "@almadar/std (behaviors/registry/infra/atoms/std-page-treat.orb orbitals[0].entity)"
+}
+
+;; From @almadar/std (behaviors/registry/infra/atoms/std-page-watch.orb orbitals[0].entity)
+entity std-page-watch.entity {
+  alias          : PageWatch
+  name           : PageWatchRecord
+  persistence    : runtime
+  fields         : (watchId found errorMessage status)
+  override-surface : (extends name fields persistence collection)
+  source         : "@almadar/std (behaviors/registry/infra/atoms/std-page-watch.orb orbitals[0].entity)"
+}
+
 ;; From @almadar/std (behaviors/registry/ui/core/atoms/std-pagination.orb orbitals[0].entity)
 entity std-pagination.entity {
   alias          : Pagination
@@ -18885,6 +19181,16 @@ entity ui-avl-state-machine.entity {
   source         : "@almadar/std (behaviors/registry/ui/avl/atoms/ui-avl-state-machine.orb orbitals[0].entity)"
 }
 
+;; From @almadar/std (behaviors/registry/ui/avl/atoms/ui-avl-transition-explainer.orb orbitals[0].entity)
+entity ui-avl-transition-explainer.entity {
+  alias          : UiAvlTransitionExplainer
+  name           : AvlTransitionExplainerItem
+  persistence    : runtime
+  fields         : (id!)
+  override-surface : (extends name fields persistence collection)
+  source         : "@almadar/std (behaviors/registry/ui/avl/atoms/ui-avl-transition-explainer.orb orbitals[0].entity)"
+}
+
 ;; From @almadar/std (behaviors/registry/ui/core/atoms/ui-badge.orb orbitals[0].entity)
 entity ui-badge.entity {
   alias          : UiBadge
@@ -19881,7 +20187,7 @@ trait std-agent-memory.traits.AgentMemoryRecall {
   category       : lifecycle
   states         : (ready* recalling remembering)
   events         : (INIT MEMORY_STORED LIST MemoriesForList MemoryListFailed RECALL REMEMBER MemoryEmbedded MemoriesForRecall MemoryEmbedFailed AgentMemoriesLoadFailed RECALLED ASSISTANT_MEMORIES_LOADED)
-  transitions    : ((ready -> ready on INIT) (ready -> ready on MEMORY_STORED) (ready -> ready on LIST) (ready -> ready on MemoriesForList) (ready -> ready on MemoryListFailed) (ready -> recalling on RECALL) (ready -> remembering on REMEMBER) (recalling -> recalling on MemoryEmbedded) (recalling -> ready on MemoriesForRecall) (recalling -> ready on MemoryEmbedFailed) (recalling -> ready on AgentMemoriesLoadFailed) (remembering -> ready on MemoryEmbedded) (remembering -> ready on MemoryEmbedFailed))
+  transitions    : ((ready -> ready on INIT) (ready -> ready on MEMORY_STORED) (ready -> ready on LIST) (ready -> ready on MemoriesForList) (ready -> ready on MemoryListFailed) (ready -> ready on RECALL) (ready -> recalling on RECALL) (ready -> ready on REMEMBER) (ready -> remembering on REMEMBER) (recalling -> recalling on MemoryEmbedded) (recalling -> ready on MemoriesForRecall) (recalling -> ready on MemoryEmbedFailed) (recalling -> ready on AgentMemoriesLoadFailed) (remembering -> ready on MemoryEmbedded) (remembering -> ready on MemoryEmbedFailed))
   emits          : (RECALLED ASSISTANT_MEMORIES_LOADED MemoriesForList MemoryListFailed MEMORY_STORED AgentMemoriesLoadFailed MemoriesForRecall MemoryEmbedded MemoryEmbedFailed)
   config {
     recallLimit    : number = 3 @label "Memories recalled per request" @description "How many of the closest memories go to the model with each request." @tier "policy"
@@ -19915,6 +20221,39 @@ trait std-agent-planner.traits.PlannerListener {
   source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-planner.orb orbitals[0].traits[1])"
 }
 
+;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-proposal.orb orbitals[0].traits[0])
+trait std-agent-proposal.traits.AgentProposalWorkflow {
+  alias          : AgentProposal
+  linkedEntity   : AgentProposalRun
+  category       : interaction
+  states         : (idle* working review failed)
+  events         : (PROPOSE INIT INPUT_CHANGED CLOSE START_TYPED PROPOSAL_REQUESTED PROPOSAL_LOOP_REPLIED PROPOSAL_LOOP_FAILED CANCEL FEEDBACK_CHANGED APPROVE REVISE DISCARD RETRY PROPOSAL_APPROVED PROPOSAL_DISCARDED PROPOSAL_CANCELLED PROPOSAL_RUN_REQUESTED)
+  transitions    : ((idle -> idle on PROPOSE) (idle -> idle on INIT) (idle -> idle on INIT) (idle -> idle on INPUT_CHANGED) (idle -> idle on CLOSE) (idle -> working on START_TYPED) (idle -> working on PROPOSAL_REQUESTED) (working -> review on PROPOSE) (working -> failed on PROPOSAL_LOOP_REPLIED) (working -> failed on PROPOSAL_LOOP_FAILED) (working -> idle on CANCEL) (working -> idle on CANCEL) (working -> idle on CLOSE) (review -> review on FEEDBACK_CHANGED) (review -> review on PROPOSE) (review -> idle on APPROVE) (review -> idle on APPROVE) (review -> working on REVISE) (review -> review on REVISE) (review -> idle on DISCARD) (review -> idle on DISCARD) (review -> idle on CLOSE) (failed -> working on RETRY) (failed -> idle on DISCARD) (failed -> idle on DISCARD) (failed -> idle on CLOSE))
+  emits          : (PROPOSAL_APPROVED PROPOSAL_DISCARDED PROPOSAL_CANCELLED PROPOSAL_RUN_REQUESTED)
+  config {
+    approveButton  : string = "@config.approveLabel" @label "Approve button" @tier "presentation"
+    cancelButton   : string = "@config.cancelLabel" @label "Cancel button" @tier "presentation"
+    discardButton  : string = "@config.discardLabel" @label "Discard button" @tier "presentation"
+    feedbackText   : string = "@config.feedbackLabel" @label "Revision feedback label" @tier "presentation"
+    fieldsForItems : [ProposalField] = "@config.itemFields" @label "Which item values are shown?" @tier "domain"
+    framing        : string = "@config.prompt" @label "What is the agent asked to do?" @description "The request that precedes the person's input." @synonyms "task, goal, brief" @tier "domain"
+    heading        : string = "@config.title" @label "Panel heading" @tier "presentation"
+    headingIcon    : string = "@config.icon" @label "Panel icon" @tier "presentation"
+    inputText      : string = "@config.inputLabel" @label "Start form label" @tier "presentation"
+    itemsTitle     : string = "@config.itemsHeading" @label "Items heading" @tier "presentation"
+    patternForItems : pattern = "@config.itemPattern" @label "How are the proposed items drawn?" @tier "presentation"
+    retryButton    : string = "@config.retryLabel" @label "Retry button" @tier "presentation"
+    reviseButton   : string = "@config.reviseLabel" @label "Revise button" @tier "presentation"
+    slot           : slot = "@config.panelSlot" @label "Where the panel renders" @tier "internal"
+    startButton    : string = "@config.startLabel" @label "Start button" @tier "presentation"
+    summaryTitle   : string = "@config.summaryHeading" @label "Summary heading" @tier "presentation"
+    withInputForm  : boolean = "@config.showInputForm" @label "Show a start form?" @tier "presentation"
+    workingText    : string = "@config.workingLabel" @label "While the agent works" @tier "presentation"
+  }
+  override-surface : (linkedEntity name events effects listens emitsScope config)
+  source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-proposal.orb orbitals[0].traits[0])"
+}
+
 ;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-session.orb orbitals[1].traits[0])
 trait std-agent-session.traits.AgentChatKeeper {
   alias          : AgentSession
@@ -19951,14 +20290,15 @@ trait std-agent-session.traits.AgentConversation {
   linkedEntity   : AgentConversationView
   category       : interaction
   states         : (idle*)
-  events         : (INIT THREAD_LOADED ASK STEP REPLIED NEW_CHAT_CLICKED OPEN_CHATS_CLICKED CHATS_LISTED CHAT_PICKED OPEN_MEMORY_CLICKED MEMORIES_LISTED BACK_TO_CHAT REPLY_FAILED ASSISTANT_HISTORY_REQUESTED ASSISTANT_NEW_CHAT ASSISTANT_SEND ASSISTANT_CHATS_REQUESTED ASSISTANT_CHAT_SELECTED ASSISTANT_MEMORIES_REQUESTED)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on THREAD_LOADED) (idle -> idle on ASK) (idle -> idle on STEP) (idle -> idle on REPLIED) (idle -> idle on NEW_CHAT_CLICKED) (idle -> idle on OPEN_CHATS_CLICKED) (idle -> idle on CHATS_LISTED) (idle -> idle on CHAT_PICKED) (idle -> idle on OPEN_MEMORY_CLICKED) (idle -> idle on MEMORIES_LISTED) (idle -> idle on BACK_TO_CHAT) (idle -> idle on REPLY_FAILED))
-  emits          : (ASSISTANT_HISTORY_REQUESTED ASSISTANT_NEW_CHAT NEW_CHAT_CLICKED ASSISTANT_SEND ASSISTANT_CHATS_REQUESTED ASSISTANT_CHAT_SELECTED ASSISTANT_MEMORIES_REQUESTED OPEN_CHATS_CLICKED OPEN_MEMORY_CLICKED CHAT_PICKED ASK)
+  events         : (INIT THREAD_LOADED ASK START_CHAT STEP REPLIED NEW_CHAT_CLICKED OPEN_CHATS_CLICKED CHATS_LISTED CHAT_PICKED OPEN_MEMORY_CLICKED MEMORIES_LISTED BACK_TO_CHAT REPLY_FAILED ASSISTANT_HISTORY_REQUESTED ASSISTANT_NEW_CHAT ASSISTANT_EPHEMERAL_SEND ASSISTANT_SEND ASSISTANT_CHATS_REQUESTED ASSISTANT_CHAT_SELECTED ASSISTANT_MEMORIES_REQUESTED)
+  transitions    : ((idle -> idle on INIT) (idle -> idle on INIT) (idle -> idle on THREAD_LOADED) (idle -> idle on ASK) (idle -> idle on ASK) (idle -> idle on START_CHAT) (idle -> idle on STEP) (idle -> idle on REPLIED) (idle -> idle on NEW_CHAT_CLICKED) (idle -> idle on OPEN_CHATS_CLICKED) (idle -> idle on CHATS_LISTED) (idle -> idle on CHAT_PICKED) (idle -> idle on OPEN_MEMORY_CLICKED) (idle -> idle on MEMORIES_LISTED) (idle -> idle on BACK_TO_CHAT) (idle -> idle on REPLY_FAILED))
+  emits          : (ASSISTANT_HISTORY_REQUESTED ASSISTANT_NEW_CHAT NEW_CHAT_CLICKED ASSISTANT_EPHEMERAL_SEND ASSISTANT_SEND ASSISTANT_CHATS_REQUESTED ASSISTANT_CHAT_SELECTED ASSISTANT_MEMORIES_REQUESTED OPEN_CHATS_CLICKED OPEN_MEMORY_CLICKED CHAT_PICKED ASK)
   config {
     backLabel      : string = "Back" @label "Back to the conversation" @tier "presentation"
     chatsEmptyTitle : string = "No conversations yet" @label "Empty conversation list" @tier "presentation"
     chatsLabel     : string = "Conversations" @label "Past conversations button" @description "Shows the person's past conversations in place of the chat; picking one reopens it." @tier "presentation"
     emptyTitle     : string = "Ask me to do something in this app" @label "Empty conversation title" @tier "presentation"
+    ephemeral      : boolean = false @label "Ephemeral conversation?" @description "A self-contained conversation: it runs under the instructions, tools, greeting and header the app starts it with (ASSISTANT_CHAT_START), is never stored among the person's conversations or remembered, shows no conversation, past-chat or memory buttons, and ignores the assistant's own replies." @synonyms "private, one-off, scoped chat, own persona, not saved" @tier "domain"
     links          : [AgentLink] = [{"href":"/agent-session/chats","label":"All conversations"}] @label "Links above the conversation" @description "Related pages (e.g. the run history)." @tier "presentation"
     memoryEmptyTitle : string = "Nothing remembered yet" @label "Empty memory list" @tier "presentation"
     memoryLabel    : string = "What I remember" @label "Memory button" @description "Shows what the assistant remembers for this person in place of the chat." @tier "presentation"
@@ -19983,6 +20323,99 @@ trait std-agent-session.traits.AgentThread {
   source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-session.orb orbitals[0].traits[0])"
 }
 
+;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-suggestions.orb orbitals[1].traits[0])
+trait std-agent-suggestions.traits.AgentSuggestionHistory {
+  alias          : AgentSuggestions
+  linkedEntity   : AgentSuggestion
+  category       : interaction
+  states         : (browsing*)
+  events         : (INIT SuggestionsLoaded SuggestionsLoadFailed)
+  transitions    : ((browsing -> browsing on INIT) (browsing -> browsing on SuggestionsLoaded) (browsing -> browsing on SuggestionsLoadFailed))
+  emits          : (SuggestionsLoaded SuggestionsLoadFailed)
+  config {
+    emptyHeading   : string = "Nothing suggested yet" @label "What shows when nothing was ever suggested?" @tier "presentation"
+  }
+  override-surface : (linkedEntity name events effects listens emitsScope config)
+  source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-suggestions.orb orbitals[1].traits[0])"
+}
+
+;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-suggestions.orb orbitals[0].traits[1])
+trait std-agent-suggestions.traits.AgentSuggestionInbox {
+  alias          : AgentSuggestions
+  linkedEntity   : AgentSuggestion
+  category       : interaction
+  states         : (closed* open)
+  events         : (INIT OPEN SuggestionsLoaded SuggestionsLoadFailed SuggestionResolveFailed REFRESH ANALYZE ACCEPT SuggestionForAccept SuggestionAccepted DISMISS SuggestionForDismiss SuggestionDismissed CLOSE SUGGESTION_ACCEPTED SUGGESTION_DISMISSED SUGGESTIONS_ANALYZE_REQUESTED)
+  transitions    : ((closed -> open on INIT) (closed -> closed on INIT) (closed -> open on OPEN) (open -> open on SuggestionsLoaded) (open -> open on SuggestionsLoadFailed) (open -> open on SuggestionResolveFailed) (open -> open on REFRESH) (open -> open on OPEN) (open -> open on ANALYZE) (open -> open on ACCEPT) (open -> open on SuggestionForAccept) (open -> open on SuggestionAccepted) (open -> open on SuggestionAccepted) (open -> open on DISMISS) (open -> open on SuggestionForDismiss) (open -> open on SuggestionDismissed) (open -> closed on CLOSE))
+  emits          : (SUGGESTION_ACCEPTED SUGGESTION_DISMISSED SUGGESTIONS_ANALYZE_REQUESTED SuggestionsLoaded SuggestionsLoadFailed SuggestionResolveFailed SuggestionForAccept SuggestionForDismiss SuggestionAccepted SuggestionDismissed)
+  config {
+    approveLabel   : string = "@config.acceptLabel" @label "Accept button label" @synonyms "approve, yes, do it" @tier "presentation"
+    closeButtonLabel : string = "@config.closeLabel" @label "Close button label" @synonyms "back, hide" @tier "presentation"
+    declineLabel   : string = "@config.dismissLabel" @label "Dismiss button label" @synonyms "reject, no thanks, hide" @tier "presentation"
+    emptyHeading   : string = "@config.emptyTitle" @label "What shows when nothing is pending?" @synonyms "empty state, no suggestions" @tier "presentation"
+    emptyHint      : string = "@config.emptyDescription" @label "Hint under the empty heading" @tier "presentation"
+    heading        : string = "@config.title" @label "Inbox heading" @description "Heading at the top of the inbox." @synonyms "panel title, suggestions title" @tier "presentation"
+    headingIcon    : string = "@config.icon" @label "Inbox icon" @description "Lucide icon name shown beside the heading." @synonyms "header icon" @tier "presentation"
+    historyLink    : string = "@config.historyHref" @label "Past-suggestions page" @description "Where accepted and dismissed suggestions are listed; empty hides the link." @tier "presentation"
+    historyLinkLabel : string = "@config.historyLabel" @label "Past-suggestions link label" @synonyms "history, archive, earlier suggestions" @tier "presentation"
+    inboxSlot      : slot = "@config.panelSlot" @label "Where the inbox renders" @description "`main` inline; `modal` or `drawer` for an overlay opened with OPEN." @tier "internal"
+    lookAgainLabel : string = "@config.analyzeLabel" @label "Look-again button label" @description "The empty inbox's button, which asks the agent to look again." @synonyms "refresh, find suggestions, analyze" @tier "presentation"
+    showOnMount    : boolean = "@config.startOpen" @label "Show the inbox as soon as it mounts?" @description "Off for an overlay that waits for OPEN." @tier "presentation"
+  }
+  override-surface : (linkedEntity name events effects listens emitsScope config)
+  source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-suggestions.orb orbitals[0].traits[1])"
+}
+
+;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-suggestions.orb orbitals[0].traits[0])
+trait std-agent-suggestions.traits.AgentSuggestionProposer {
+  alias          : AgentSuggestions
+  linkedEntity   : AgentSuggestion
+  category       : lifecycle
+  states         : (ready*)
+  events         : (INIT PROPOSE_SUGGESTION SuggestionsForPropose SuggestionCheckFailed SuggestionSaveFailed SUGGESTION_ADDED SUGGESTION_DUPLICATE SUGGESTION_LIMIT_REACHED SUGGESTION_REJECTED)
+  transitions    : ((ready -> ready on INIT) (ready -> ready on PROPOSE_SUGGESTION) (ready -> ready on PROPOSE_SUGGESTION) (ready -> ready on PROPOSE_SUGGESTION) (ready -> ready on SuggestionsForPropose) (ready -> ready on SuggestionsForPropose) (ready -> ready on SuggestionsForPropose) (ready -> ready on SuggestionCheckFailed) (ready -> ready on SuggestionSaveFailed))
+  emits          : (SUGGESTION_ADDED SUGGESTION_DUPLICATE SUGGESTION_LIMIT_REACHED SUGGESTION_REJECTED SuggestionsForPropose SuggestionCheckFailed SuggestionSaveFailed)
+  config {
+    allowedActions : [string] = "@config.actions" @label "Which actions may a suggestion carry?" @description "When listed, any other action is refused. Empty accepts any." @synonyms "allowed actions, commands, events" @tier "domain"
+    allowedKinds   : [string] = "@config.kinds" @label "Which kinds may be proposed?" @description "When listed, any other kind is refused. Empty accepts any." @synonyms "types, categories, allowed kinds" @tier "domain"
+    pendingLimit   : number = "@config.maxPending" @label "How many suggestions may wait at once?" @description "A proposal is refused (SUGGESTION_LIMIT_REACHED) while this many are pending." @synonyms "limit, cap, queue size" @tier "policy"
+  }
+  override-surface : (linkedEntity name events effects listens emitsScope config)
+  source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-suggestions.orb orbitals[0].traits[0])"
+}
+
+;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-suggestions.orb orbitals[0].traits[3])
+trait std-agent-suggestions.traits.AgentSuggestionRunner {
+  alias          : AgentSuggestions
+  linkedEntity   : AgentSuggestionRun
+  category       : lifecycle
+  states         : (ready* starting analyzing)
+  events         : (INIT START RunRecorded RunRecordFailed LOOP_REPLIED LOOP_FAILED SUGGESTION_RUN_STARTED SUGGESTION_RUN_DONE SUGGESTION_RUN_FAILED)
+  transitions    : ((ready -> ready on INIT) (ready -> starting on START) (starting -> analyzing on RunRecorded) (starting -> ready on RunRecordFailed) (analyzing -> ready on LOOP_REPLIED) (analyzing -> ready on LOOP_FAILED))
+  emits          : (SUGGESTION_RUN_STARTED SUGGESTION_RUN_DONE SUGGESTION_RUN_FAILED RunRecorded RunRecordFailed)
+  config {
+    request        : string = "@config.prompt" @label "What does the agent look into?" @description "The request each proactive run answers." @synonyms "task, goal, question, brief" @tier "domain"
+  }
+  override-surface : (linkedEntity name events effects listens emitsScope config)
+  source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-suggestions.orb orbitals[0].traits[3])"
+}
+
+;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-suggestions.orb orbitals[0].traits[2])
+trait std-agent-suggestions.traits.AgentSuggestionTrigger {
+  alias          : AgentSuggestions
+  linkedEntity   : AgentSuggestionRun
+  category       : lifecycle
+  states         : (ready*)
+  events         : (INIT TRIGGERED RunsForTrigger RunsLoadFailed SUGGESTION_RUN_ALLOWED)
+  transitions    : ((ready -> ready on INIT) (ready -> ready on TRIGGERED) (ready -> ready on RunsForTrigger) (ready -> ready on RunsForTrigger) (ready -> ready on RunsLoadFailed))
+  emits          : (SUGGESTION_RUN_ALLOWED RunsForTrigger RunsLoadFailed)
+  config {
+    gapMinutes     : number = "@config.cooldownMinutes" @label "Minutes between proactive runs" @description "A trigger starts a run only when this long has passed since the person's last run." @synonyms "throttle, rate limit, interval, frequency" @tier "policy"
+  }
+  override-surface : (linkedEntity name events effects listens emitsScope config)
+  source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-suggestions.orb orbitals[0].traits[2])"
+}
+
 ;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-tool-call.orb orbitals[0].traits[0])
 trait std-agent-tool-call.traits.ToolCallExecution {
   alias          : AgentToolCall
@@ -20014,12 +20447,14 @@ trait std-agent-tool-loop.traits.AgentToolLoop {
   linkedEntity   : AgentTurn
   category       : interaction
   states         : (idle* thinking)
-  events         : (INIT CONVERSE ANSWERED ASK_FAILED ASSISTANT_STEP ASSISTANT_REPLIED ASSISTANT_REPLY_FAILED)
-  transitions    : ((idle -> idle on INIT) (idle -> thinking on CONVERSE) (thinking -> idle on ANSWERED) (thinking -> idle on ASK_FAILED))
+  events         : (INIT CONVERSE CANCEL ANSWERED ASK_FAILED ASSISTANT_STEP ASSISTANT_REPLIED ASSISTANT_REPLY_FAILED)
+  transitions    : ((idle -> idle on INIT) (idle -> thinking on CONVERSE) (idle -> thinking on CONVERSE) (idle -> thinking on CONVERSE) (thinking -> idle on CANCEL) (thinking -> idle on ANSWERED) (thinking -> idle on ASK_FAILED) (thinking -> idle on ASK_FAILED))
   emits          : (ASSISTANT_STEP ASSISTANT_REPLIED ASSISTANT_REPLY_FAILED ANSWERED ASK_FAILED)
   config {
+    cancelKey      : string = "agent-tool-loop" @label "Cancel key" @description "The key this instance's model call runs under, so CANCEL aborts it. Give each instance of the loop in one app its own." @synonyms "call key, abort key" @tier "internal"
     instructions   : string = "You operate this app for the signed-in user. Use the tools to act and to look things up; when a tool reports that something was refused or denied, say so plainly." @label "How should the assistant behave?" @description "Standing instructions sent with every conversation." @synonyms "system prompt, persona, guidance" @tier "domain"
     maxSteps       : number = 8 @label "Model round-trips per request" @description "How many model calls one request may take before it fails." @tier "policy"
+    quiet          : boolean = false @label "Run in the background?" @description "No live ASSISTANT_STEP stream and no failure toast: the request is reported only through ASSISTANT_REPLIED and ASSISTANT_REPLY_FAILED. For a run nobody is watching, such as one the app starts on its own." @synonyms "silent, background, no toast, suppress errors, headless run" @tier "policy"
     tools          : [AgentTool] = [] @label "What may the assistant do?" @description "The declared inputs it may fire (`{ event: Trait.EVENT }`) and the entities it may read (`{ read: Entity }`), as the signed-in user." @synonyms "allowlist, abilities, actions, permissions" @tier "domain"
   }
   override-surface : (linkedEntity name events effects listens emitsScope config)
@@ -20084,12 +20519,15 @@ trait std-app-layout.traits.AppLayout {
     contentClassName : string = "max-w-5xl mx-auto w-full" @label "Content wrapper class" @description "CSS class applied to the content area wrapper." @tier "internal"
     contentTrait   : trait @label "Content trait" @description "Trait rendered inside the app layout content area" @tier "presentation"
     currentPath    : string = "" @label "Current path" @description "Nav-highlight ONLY: which nav item to mark active. This is NOT the page route — it does not change what page loads or where the orbital lives. To set the landing route or a page path, use the orbital's pagePath / page path, not this knob. When omitted, the layout reads the current route." @synonyms "active nav item, highlighted nav link, which menu item is selected, nav highlight" @tier "internal"
-    layoutMode     : string = "sidebar" @label "Where should navigation be placed?" @description "sidebar = left rail; topnav = top bar; bottomnav = mobile tab bar; minimal = no nav." @synonyms "nav position, navigation style, menu placement, layout style" @tier "presentation" @values (sidebar topnav bottomnav minimal)
+    layoutMode     : string = "sidebar" @label "Where should navigation be placed?" @description "sidebar = left rail; topnav = top bar; bottomnav = mobile tab bar; minimal = no nav; drawer = navigation behind a menu button at every width, content full width." @synonyms "nav position, navigation style, menu placement, layout style" @tier "presentation" @values (sidebar topnav bottomnav minimal drawer)
     layoutPattern  : pattern = "dashboard-layout" @label "Layout pattern" @description "UI pattern used to render the application chrome" @tier "internal"
+    logoSrc        : string = "" @label "Logo image" @description "Address of the logo shown beside the app name in the chrome header (an image URL or an inline data: SVG); empty shows the name's first letter." @synonyms "logo, brand mark, app icon, logo url" @tier "presentation"
     navItems       : [NavItem] = "@pages" @label "Which sections appear in the sidebar?" @description "Top-level navigation links shown on the left rail." @synonyms "nav links, menu items, sidebar sections, navigation entries, pages" @tier "presentation"
     notificationClickEvent : event = "NOTIFY_CLICK" @label "Notification click event" @description "Event emitted when the user picks a notification" @tier "internal"
     notifications  : [NotificationSpec] = [] @label "What notifications should appear?" @description "Items shown in the notifications dropdown." @synonyms "alerts, messages, notices, notification items, bell items" @tier "presentation"
     searchEvent    : event = "SEARCH" @label "Search event" @description "Event emitted when the user runs a global search" @tier "internal"
+    showSearch     : boolean = true @label "Show the search box?" @description "The top-bar search box; turn off for apps whose pages carry their own search." @synonyms "search bar, top search, hide search" @tier "presentation"
+    showThemeToggle : boolean = true @label "Show the light/dark toggle?" @description "The theme toggle in the top bar; turn off when the app offers it elsewhere, such as a settings page." @synonyms "dark mode button, theme switch, hide theme toggle" @tier "presentation"
     sidebarTrait   : trait @label "Sidebar trait" @description "Optional trait rendered in the sidebar between the nav links and the footer — the Notion/Confluence-style always-visible page tree; scrolls independently. Unset renders plain nav only." @synonyms "sidebar tree, nav tree, page tree in sidebar, hierarchy rail" @tier "presentation"
     theme          : string = "@currentTheme" @label "Theme" @description "Data-theme attribute applied to the layout root (e.g. almadar-website-dark)." @tier "presentation"
     topBarActions  : [ItemAction] = [] @label "What shortcuts go in the top bar?" @description "Icon buttons shown on the right side of the top bar (e.g. cart, help, profile)." @synonyms "toolbar buttons, header actions, shortcut icons, quick actions" @tier "presentation"
@@ -20324,7 +20762,7 @@ trait std-book-reader.traits.BookReaderRead {
   category       : interaction
   states         : (cover* reading)
   events         : (INIT START_READING OPEN_CHAPTER NEXT_CHAPTER PREV_CHAPTER BACK_TO_COVER CHAPTER_OPENED)
-  transitions    : ((cover -> cover on INIT) (cover -> reading on START_READING) (cover -> reading on OPEN_CHAPTER) (reading -> reading on INIT) (reading -> reading on OPEN_CHAPTER) (reading -> reading on NEXT_CHAPTER) (reading -> reading on PREV_CHAPTER) (reading -> cover on BACK_TO_COVER))
+  transitions    : ((cover -> cover on INIT) (cover -> reading on INIT) (cover -> reading on START_READING) (cover -> reading on OPEN_CHAPTER) (reading -> reading on INIT) (reading -> reading on OPEN_CHAPTER) (reading -> reading on NEXT_CHAPTER) (reading -> reading on PREV_CHAPTER) (reading -> cover on BACK_TO_COVER))
   emits          : (CHAPTER_OPENED)
   config {
     author         : string = "" @label "Author" @tier "presentation"
@@ -20335,8 +20773,9 @@ trait std-book-reader.traits.BookReaderRead {
     coverLabel     : string = "Cover" @label "Back-to-cover label" @tier "presentation"
     direction      : string = "ltr" @label "Text direction" @description "rtl for Arabic, Hebrew and other right-to-left books" @synonyms "right to left, arabic book" @tier "presentation" @values (ltr rtl)
     nextLabel      : string = "Next" @label "Next button label" @tier "presentation"
+    opensAt        : string = "cover" @label "Opens at" @description "Where the reader opens: the cover, or straight into the first chapter (an article read in place)" @tier "presentation" @values (cover reading)
     previousLabel  : string = "Previous" @label "Previous button label" @tier "presentation"
-    readingContent : render-ui = {"children":[{"children":[{"children":[{"align":"start","children":[{"action":"BACK_TO_COVER","label":"@config.coverLabel","leftIcon":"book-open","type":"button","variant":"link"},{"className":"pt-2","content":"@config.contentsLabel","type":"typography","variant":"label","weight":"semibold"},{"align":"start","children":["array/map","@config.chapters",["fn","chapter",{"action":"OPEN_CHAPTER","actionPayload":{"index":"@index"},"aria-current":["if",["==","@index","@entity.chapterIndex"],"page","false"],"className":["if",["==","@index","@entity.chapterIndex"],"h-auto justify-start text-start text-foreground font-semibold","h-auto justify-start text-start"],"label":["object/get","@chapter","title",""],"type":"button","variant":"link"}]],"direction":"vertical","gap":"none","type":"stack"}],"className":"lg:sticky lg:top-6 self-start","direction":"vertical","gap":"xs","type":"stack"},{"children":[{"children":[{"color":"muted","content":"@entity.progressLabel","type":"typography","variant":"caption"},{"className":"tracking-tight","content":"@entity.chapterTitle","size":"3xl","type":"typography","variant":"h1","weight":"bold"}],"direction":"vertical","gap":"lg","role":"status","type":"stack"},{"content":"@entity.chapterContent","direction":"@config.direction","type":"markdown-content"},{"type":"divider"},{"children":[{"action":"PREV_CHAPTER","disabled":"@entity.isFirst","label":"@config.previousLabel","leftIcon":["if",["==","@config.direction","rtl"],"chevron-right","chevron-left"],"type":"button","variant":"secondary"},{"action":"NEXT_CHAPTER","disabled":"@entity.isLast","label":"@config.nextLabel","rightIcon":["if",["==","@config.direction","rtl"],"chevron-left","chevron-right"],"type":"button","variant":"primary"}],"direction":"horizontal","gap":"md","justify":"between","type":"stack"}],"direction":"vertical","gap":"lg","type":"stack"}],"gap":"xl","ratio":"1:3","type":"split"}],"maxWidth":"xl","padding":"lg","size":"xl","type":"container"}],"dir":"@config.direction","fullWidth":true,"paddingY":"xl","type":"box"} @label "Reading body" @tier "internal"
+    readingContent : render-ui = {"children":[{"children":[{"children":[{"align":"start","children":[{"className":"text-balance","content":"@config.title","type":"typography","variant":"h5","weight":"semibold"},{"className":["if",["==","@config.author",""],"hidden","pb-2"],"color":"muted","content":"@config.author","type":"typography","variant":"caption"},{"action":"BACK_TO_COVER","label":"@config.coverLabel","leftIcon":"book-open","type":"button","variant":"link"},{"className":"pt-2","content":"@config.contentsLabel","type":"typography","variant":"label","weight":"semibold"},{"align":"start","children":["array/map","@config.chapters",["fn","chapter",{"action":"OPEN_CHAPTER","actionPayload":{"index":"@index"},"aria-current":["if",["==","@index","@entity.chapterIndex"],"page","false"],"className":["if",["==","@index","@entity.chapterIndex"],"h-auto justify-start text-start text-foreground font-semibold","h-auto justify-start text-start"],"label":["object/get","@chapter","title",""],"type":"button","variant":"link"}]],"direction":"vertical","gap":"none","type":"stack"}],"className":"lg:sticky lg:top-6 self-start","direction":"vertical","gap":"xs","type":"stack"},{"children":[{"children":[{"color":"muted","content":"@entity.progressLabel","type":"typography","variant":"caption"},{"className":"tracking-tight","content":"@entity.chapterTitle","size":"3xl","type":"typography","variant":"h1","weight":"bold"}],"direction":"vertical","gap":"lg","role":"status","type":"stack"},{"content":"@entity.chapterContent","direction":"@config.direction","type":"markdown-content"},{"type":"divider"},{"children":[{"action":"PREV_CHAPTER","disabled":"@entity.isFirst","label":"@config.previousLabel","leftIcon":["if",["==","@config.direction","rtl"],"chevron-right","chevron-left"],"type":"button","variant":"secondary"},{"action":"NEXT_CHAPTER","disabled":"@entity.isLast","label":"@config.nextLabel","rightIcon":["if",["==","@config.direction","rtl"],"chevron-left","chevron-right"],"type":"button","variant":"primary"}],"direction":"horizontal","gap":"md","justify":"between","type":"stack"}],"direction":"vertical","gap":"lg","type":"stack"}],"gap":"xl","ratio":"1:3","type":"split"}],"maxWidth":"xl","padding":"lg","size":"xl","type":"container"}],"dir":"@config.direction","fullWidth":true,"paddingY":"xl","type":"box"} @label "Reading body" @tier "internal"
     startLabel     : string = "Start reading" @label "Start button label" @tier "presentation"
     subtitle       : string = "" @label "Subtitle" @tier "presentation"
     title          : string = "Untitled book" @label "Title" @tier "presentation"
@@ -20426,9 +20865,9 @@ trait std-calendar.traits.CalendarEventCalendar {
   config {
     agendaGroupBy  : string = "date" @label "Agenda group-by field" @description "Row field the agenda list groups its day sections by. Rebound hosts point this at their own timestamp column (e.g. startTime, scheduledAt)." @synonyms "group field, section field, day field" @tier "presentation"
     agendaItemActions : [ItemAction] = [] @label "Agenda item actions" @description "Per-item action buttons on agenda-list rows — data-list itemActions descriptors (label/event/icon/variant). Consumers override to wire their own row actions (View/Edit/Delete) so agenda hosts never need a second table for actions." @synonyms "agenda actions, row actions, event actions, list actions" @tier "presentation"
-    agendaListBodyContent : render-ui = {"children":[{"align":"center","children":[{"align":"center","children":[{"name":"list","size":"xl","type":"icon"},{"content":"Agenda","type":"typography","variant":"h2"}],"direction":"horizontal","gap":"sm","type":"stack"},{"onSelect":"SELECT_DAY","selected":"@entity.selectedRange","type":"date-range-selector"}],"direction":"horizontal","gap":"md","justify":"between","type":"stack"},["if","@config.bodySearch",{"children":[{"className":"w-full max-w-md","clearable":true,"event":"REFETCH_QUERY","placeholder":"@config.searchPlaceholder","type":"search-input"}],"direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],["if",[">",["array/len","@config.filters"],0],{"children":[{"entity":"CalendarEvent","event":"REFETCH_FILTER","filters":"@config.filters","look":"@config.filterBarLook","type":"filter-group"}],"direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],{"type":"divider"},{"entity":"@payload.data","fields":[],"gap":"md","groupBy":"@config.agendaGroupBy","itemActions":["array/filter","@config.agendaItemActions",["fn","action",["or",["=",["array/len",["object/get","@action","roles",[]]],0],["array/includes",["object/get","@action","roles",[]],"@config.viewerRole"]]]],"renderItem":["fn","item",{"children":[{"align":"start","children":[{"align":"center","children":[{"color":"muted","content":"@config.timeBinding","format":"time","type":"typography","variant":"overline"},{"color":"muted","name":"clock","size":"sm","type":"icon"}],"className":"w-16 shrink-0","direction":"vertical","gap":"xs","type":"stack"},{"orientation":"vertical","type":"divider"},{"children":[{"align":"center","children":[{"className":"truncate","content":"@config.titleBinding","type":"typography","variant":"h4","weight":"medium"},{"label":"@config.badgeBinding","size":"sm","type":"badge","variant":"default"}],"direction":"horizontal","gap":"sm","justify":"between","type":"stack"},{"className":"truncate","color":"muted","content":"@config.descriptionBinding","type":"typography","variant":"body2"}],"className":"flex-1 min-w-0","direction":"vertical","gap":"xs","type":"stack"}],"direction":"horizontal","gap":"md","type":"stack"}],"look":"flat-bordered","padding":"md","type":"card"}],"type":"data-list","variant":"default"}],"className":"w-full p-card-md","direction":"vertical","gap":"lg","type":"stack"} @label "Agenda list body content tree" @description "Render-ui SExpr for calendarLook='agenda-list' — events grouped by day with overline day headers (Today, Tomorrow, …) and a time marker per event." @tier "internal"
+    agendaListBodyContent : render-ui = {"children":[{"align":"center","children":[{"align":"center","children":[{"name":"list","size":"xl","type":"icon"},{"content":"@config.title","type":"typography","variant":"h2"}],"direction":"horizontal","gap":"sm","type":"stack"},{"onSelect":"SELECT_DAY","selected":"@entity.selectedRange","type":"date-range-selector"}],"direction":"horizontal","gap":"md","justify":"between","type":"stack","wrap":true},["if","@config.bodySearch",{"children":[{"className":"w-full max-w-md","clearable":true,"event":"REFETCH_QUERY","placeholder":"@config.searchPlaceholder","type":"search-input"}],"direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],["if",[">",["array/len","@config.filters"],0],{"children":[{"entity":"CalendarEvent","event":"REFETCH_FILTER","filters":"@config.filters","look":"@config.filterBarLook","type":"filter-group"}],"direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],{"type":"divider"},{"entity":"@payload.data","fields":[],"gap":"md","groupBy":"@config.agendaGroupBy","groupFormat":"date","itemActions":["array/filter","@config.agendaItemActions",["fn","action",["or",["=",["array/len",["object/get","@action","roles",[]]],0],["array/includes",["object/get","@action","roles",[]],"@config.viewerRole"]]]],"renderItem":["fn","item",{"children":[{"align":"start","children":[{"align":"center","children":[{"color":"muted","content":"@config.timeBinding","format":"time","type":"typography","variant":"overline"},{"className":"hidden sm:block","color":"muted","name":"clock","size":"sm","type":"icon"}],"className":"w-14 sm:w-16 shrink-0","direction":"vertical","gap":"xs","type":"stack"},{"className":"hidden sm:block","orientation":"vertical","type":"divider"},{"children":[{"align":"center","children":[{"className":"min-w-[8rem] flex-1 line-clamp-2 break-words","content":"@config.titleBinding","type":"typography","variant":"h4","weight":"medium"},{"className":"shrink-0 whitespace-nowrap","label":"@config.badgeBinding","size":"sm","type":"badge","variant":"default"}],"direction":"horizontal","gap":"sm","justify":"between","type":"stack","wrap":true},{"className":"truncate","color":"muted","content":"@config.descriptionBinding","type":"typography","variant":"body2"}],"className":"flex-1 min-w-0","direction":"vertical","gap":"xs","type":"stack"}],"direction":"horizontal","gap":"md","type":"stack"}],"look":"flat-bordered","padding":"md","type":"card"}],"surface":"none","type":"data-list","variant":"default"}],"className":"w-full p-card-md","direction":"vertical","gap":"lg","type":"stack"} @label "Agenda list body content tree" @description "Render-ui SExpr for calendarLook='agenda-list' — events grouped by day with overline day headers (Today, Tomorrow, …) and a time marker per event." @tier "internal"
     badgeBinding   : string = "@item.status" @label "Badge binding" @description "Per-row binding for the event status/badge slot." @tier "presentation"
-    bodyContent    : render-ui = {"children":[{"align":"center","children":[{"align":"center","children":[{"name":"calendar","size":"xl","type":"icon"},{"content":"@config.title","type":"typography","variant":"h2"}],"direction":"horizontal","gap":"sm","type":"stack"},{"onSelect":"SELECT_DAY","selected":"@entity.selectedRange","type":"date-range-selector"}],"direction":"horizontal","gap":"md","justify":"between","type":"stack"},["if","@config.bodySearch",{"children":[{"className":"w-full max-w-md","clearable":true,"event":"REFETCH_QUERY","placeholder":"@config.searchPlaceholder","type":"search-input"}],"direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],["if",[">",["array/len","@config.filters"],0],{"children":[{"entity":"CalendarEvent","event":"REFETCH_FILTER","filters":"@config.filters","look":"@config.filterBarLook","type":"filter-group"}],"direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],{"type":"divider"},{"events":"@payload.data","onEventClick":"@config.onEventClick","renderItem":["fn","item",{"content":"@config.titleBinding","type":"typography","variant":"small"}],"startField":"@config.startField","type":"calendar-grid"},{"type":"divider"},{"content":"Upcoming Events","type":"typography","variant":"h4"},{"entity":"@payload.data","fields":"@config.fields","itemActions":["array/filter","@config.agendaItemActions",["fn","action",["or",["=",["array/len",["object/get","@action","roles",[]]],0],["array/includes",["object/get","@action","roles",[]],"@config.viewerRole"]]]],"look":"@config.tableLook","type":"data-list"}],"direction":"vertical","gap":"lg","type":"stack"} @label "Body content tree" @description "Render-ui SExpr rendered after events load for calendarLook='month' — the month-grid + upcoming-events list. calendarLook='agenda-list' / 'week-timeline' render agendaListBodyContent / weekTimelineBodyContent instead; all three share this trait's state machine, emits, and listens." @tier "internal"
+    bodyContent    : render-ui = {"children":[{"align":"center","children":[{"align":"center","children":[{"name":"calendar","size":"xl","type":"icon"},{"content":"@config.title","type":"typography","variant":"h2"}],"direction":"horizontal","gap":"sm","type":"stack"},{"onSelect":"SELECT_DAY","selected":"@entity.selectedRange","type":"date-range-selector"}],"direction":"horizontal","gap":"md","justify":"between","type":"stack","wrap":true},["if","@config.bodySearch",{"children":[{"className":"w-full max-w-md","clearable":true,"event":"REFETCH_QUERY","placeholder":"@config.searchPlaceholder","type":"search-input"}],"direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],["if",[">",["array/len","@config.filters"],0],{"children":[{"entity":"CalendarEvent","event":"REFETCH_FILTER","filters":"@config.filters","look":"@config.filterBarLook","type":"filter-group"}],"direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],{"type":"divider"},{"events":"@payload.data","onEventClick":"@config.onEventClick","renderItem":["fn","item",{"content":"@config.titleBinding","type":"typography","variant":"small"}],"startField":"@config.startField","type":"calendar-grid"},{"type":"divider"},{"content":"Upcoming Events","type":"typography","variant":"h4"},{"entity":"@payload.data","fields":"@config.fields","itemActions":["array/filter","@config.agendaItemActions",["fn","action",["or",["=",["array/len",["object/get","@action","roles",[]]],0],["array/includes",["object/get","@action","roles",[]],"@config.viewerRole"]]]],"look":"@config.tableLook","type":"data-list"}],"direction":"vertical","gap":"lg","type":"stack"} @label "Body content tree" @description "Render-ui SExpr rendered after events load for calendarLook='month' — the month-grid + upcoming-events list. calendarLook='agenda-list' / 'week-timeline' render agendaListBodyContent / weekTimelineBodyContent instead; all three share this trait's state machine, emits, and listens." @tier "internal"
     bodySearch     : boolean = false @label "Show the calendar's own search box?" @description "Embeds a title search box in the toolbar above the calendar body (all three calendarLook trees). Defaults false: std-calendar has never had a search box, so an untouched consumer's surface is unchanged; the primary path is composing std-search beside this atom and wiring XSearch.SEARCH -> REFETCH_QUERY. Set true only for a standalone calendar with no page-level search affordance." @synonyms "inline search, calendar search, built-in search, show search, duplicate search" @tier "presentation"
     calendarLook   : string = "month" @label "Calendar look" @description "Layer 3 body layout: default month-grid + upcoming-events list ('month'), day-grouped agenda list ('agenda-list'), or 7-column week timeline ('week-timeline')." @tier "presentation" @values (month agenda-list week-timeline)
     descriptionBinding : string = "@item.description" @label "Description binding" @description "Per-row binding for the event description slot." @tier "presentation"
@@ -20445,7 +20884,7 @@ trait std-calendar.traits.CalendarEventCalendar {
     title          : string = "Calendar" @label "Title" @description "Header text shown above the calendar body." @tier "presentation"
     titleBinding   : string = "@item.name" @label "Title binding" @description "Per-row binding for the event title slot." @tier "presentation"
     viewerRole     : string = "" @label "Viewer's role" @description "The signed-in viewer's role that each action's `roles` is checked against. Bind it explicitly at the call site (e.g. `viewerRole: @user.role`) in an app whose identity carries a role; left empty, only actions with no `roles` show." @tier "policy"
-    weekTimelineBodyContent : render-ui = {"children":[{"align":"center","children":[{"align":"center","children":[{"name":"calendar","size":"xl","type":"icon"},{"content":"Week","type":"typography","variant":"h2"}],"direction":"horizontal","gap":"sm","type":"stack"},{"align":"center","children":[{"action":"CALENDAR_PREV_WEEK","icon":"chevron-left","label":"Previous week","type":"button","variant":"ghost"},{"color":"muted","content":["time/format","@entity.weekAnchor","MMM D, YYYY"],"type":"typography","variant":"caption"},{"action":"CALENDAR_NEXT_WEEK","icon":"chevron-right","label":"Next week","type":"button","variant":"ghost"}],"direction":"horizontal","gap":"xs","type":"stack"},{"onSelect":"SELECT_DAY","selected":"@entity.selectedRange","type":"date-range-selector"}],"direction":"horizontal","gap":"md","justify":"between","type":"stack"},["if","@config.bodySearch",{"children":[{"className":"w-full max-w-md","clearable":true,"event":"REFETCH_QUERY","placeholder":"@config.searchPlaceholder","type":"search-input"}],"direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],["if",[">",["array/len","@config.filters"],0],{"children":[{"entity":"CalendarEvent","event":"REFETCH_FILTER","filters":"@config.filters","look":"@config.filterBarLook","type":"filter-group"}],"direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],{"type":"divider"},{"className":"w-full","dayWindow":7,"events":"@payload.data","onEventClick":"@config.onEventClick","renderItem":["fn","item",{"content":"@config.titleBinding","type":"typography","variant":"small"}],"startField":"@config.startField","swipeLeftEvent":"CALENDAR_NEXT_WEEK","swipeRightEvent":"CALENDAR_PREV_WEEK","type":"calendar-grid","weekStart":"@entity.weekAnchor"}],"direction":"vertical","gap":"md","type":"stack"} @label "Week timeline body content tree" @description "Render-ui SExpr for calendarLook='week-timeline' — events grouped by weekday in a 7-column timeline window." @tier "internal"
+    weekTimelineBodyContent : render-ui = {"children":[{"align":"center","children":[{"align":"center","children":[{"name":"calendar","size":"xl","type":"icon"},{"content":"@config.title","type":"typography","variant":"h2"}],"direction":"horizontal","gap":"sm","type":"stack"},{"align":"center","children":[{"action":"CALENDAR_PREV_WEEK","icon":"chevron-left","label":"Previous week","type":"button","variant":"ghost"},{"color":"muted","content":["time/format","@entity.weekAnchor","MMM D, YYYY"],"type":"typography","variant":"caption"},{"action":"CALENDAR_NEXT_WEEK","icon":"chevron-right","label":"Next week","type":"button","variant":"ghost"}],"direction":"horizontal","gap":"xs","type":"stack"},{"onSelect":"SELECT_DAY","selected":"@entity.selectedRange","type":"date-range-selector"}],"direction":"horizontal","gap":"md","justify":"between","type":"stack","wrap":true},["if","@config.bodySearch",{"children":[{"className":"w-full max-w-md","clearable":true,"event":"REFETCH_QUERY","placeholder":"@config.searchPlaceholder","type":"search-input"}],"direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],["if",[">",["array/len","@config.filters"],0],{"children":[{"entity":"CalendarEvent","event":"REFETCH_FILTER","filters":"@config.filters","look":"@config.filterBarLook","type":"filter-group"}],"direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],{"type":"divider"},{"className":"w-full","dayWindow":7,"events":"@payload.data","onEventClick":"@config.onEventClick","renderItem":["fn","item",{"content":"@config.titleBinding","type":"typography","variant":"small"}],"startField":"@config.startField","swipeLeftEvent":"CALENDAR_NEXT_WEEK","swipeRightEvent":"CALENDAR_PREV_WEEK","type":"calendar-grid","weekStart":"@entity.weekAnchor"}],"direction":"vertical","gap":"md","type":"stack"} @label "Week timeline body content tree" @description "Render-ui SExpr for calendarLook='week-timeline' — events grouped by weekday in a 7-column timeline window." @tier "internal"
   }
   override-surface : (linkedEntity name events effects listens emitsScope config)
   source         : "@almadar/std (behaviors/registry/ui/core/atoms/std-calendar.orb orbitals[0].traits[0])"
@@ -20820,6 +21259,31 @@ trait std-detail-layout.traits.DetailLayout {
   source         : "@almadar/std (behaviors/registry/ui/core/atoms/std-detail-layout.orb orbitals[0].traits[0])"
 }
 
+;; From @almadar/std (behaviors/registry/ui/core/atoms/std-doc-page.orb orbitals[0].traits[0])
+trait std-doc-page.traits.DocPageRender {
+  alias          : DocPage
+  linkedEntity   : DocPageView
+  category       : interaction
+  states         : (idle*)
+  events         : (INIT)
+  transitions    : ((idle -> idle on INIT))
+  config {
+    content        : render-ui = {"children":[],"direction":"vertical","gap":"lg","type":"stack"} @label "Content" @description "The page body: markdown, code and live behaviors (trait references) in reading order" @tier "presentation"
+    crumbs         : [DocCrumb] = [] @label "Breadcrumb" @description "Ancestors first, the current page last without a link; empty hides it" @tier "presentation"
+    direction      : string = "ltr" @label "Direction" @tier "presentation" @values (ltr rtl)
+    lede           : string = "" @label "Lede" @description "One or two sentences under the title; empty hides it" @tier "presentation"
+    navItems       : [DocNavItem] = [] @label "Sidebar" @description "The documentation tree; mark the current page active" @tier "presentation"
+    next           : DocLink = {"href":"","label":""} @label "Next page" @description "Empty href hides it" @tier "presentation"
+    prev           : DocLink = {"href":"","label":""} @label "Previous page" @description "Empty href hides it" @tier "presentation"
+    sidebarLabel   : string = "Documentation" @label "Sidebar label" @tier "presentation"
+    title          : string = "Untitled page" @label "Title" @tier "presentation"
+    toc            : [DocTocEntry] = [] @label "On this page" @description "Anchors of the page's sections (each section declares the same id); empty hides it" @tier "presentation"
+    tocLabel       : string = "On this page" @label "Contents label" @tier "presentation"
+  }
+  override-surface : (linkedEntity name events effects listens emitsScope config)
+  source         : "@almadar/std (behaviors/registry/ui/core/atoms/std-doc-page.orb orbitals[0].traits[0])"
+}
+
 ;; From @almadar/std (behaviors/registry/ui/game/atoms/std-dungeon-combat.orb orbitals[0].traits[0])
 trait std-dungeon-combat.traits.DungeonCombat {
   alias          : DungeonCombat
@@ -21319,10 +21783,12 @@ trait std-hero.traits.HeroRender {
   emits          : (CTA_PRIMARY CTA_SECONDARY)
   config {
     alignment      : string = "center" @label "Alignment" @description "Center the copy, or align it to the start edge" @tier "presentation" @values (center start)
+    backdropContent : render-ui = {"className":"hidden","type":"box"} @label "Backdrop" @description "A scene behind the whole block, such as an animated canvas; it fills the block, never takes clicks, and the copy stays on top. Empty by default." @tier "presentation"
     command        : string = "" @label "Command" @description "A shell command shown in a copyable code box under the actions, e.g. an install one-liner; empty hides it" @synonyms "install command, cli, terminal snippet" @tier "presentation"
     copyContent    : render-ui = {"align":["if",["==","@config.alignment","center"],"center","start"],"children":[{"label":"@config.eyebrow","size":"md","type":"badge","variant":"primary"},{"align":["if",["==","@config.alignment","center"],"center","left"],"className":"tracking-tight text-balance","content":"@config.headline","type":"typography","variant":["if",["==","@config.look","banner"],"h2","h1"],"weight":"bold"},{"align":["if",["==","@config.alignment","center"],"center","left"],"className":["if",["==","@config.lede",""],"hidden","max-w-2xl text-pretty"],"color":"muted","content":"@config.lede","type":"typography","variant":"large"},{"children":[{"action":"HERO_PRIMARY","actionPayload":{"href":"@config.primaryHref"},"className":["if",["==","@config.primaryLabel",""],"hidden",""],"href":"@config.primaryHref","label":"@config.primaryLabel","size":"lg","type":"button","variant":"primary"},{"action":"HERO_SECONDARY","actionPayload":{"href":"@config.secondaryHref"},"className":["if",["==","@config.secondaryLabel",""],"hidden",""],"href":"@config.secondaryHref","label":"@config.secondaryLabel","size":"lg","type":"button","variant":"secondary"}],"className":["if",["==","@config.primaryLabel",""],["if",["==","@config.secondaryLabel",""],"hidden","pt-2"],"pt-2"],"direction":"horizontal","gap":"md","justify":["if",["==","@config.alignment","center"],"center","start"],"type":"stack","wrap":true},{"children":[{"code":"@config.command","language":"bash","showCopyButton":true,"showLanguageBadge":false,"type":"code-block"}],"className":["if",["==","@config.command",""],"hidden","max-w-xl"],"fullWidth":true,"type":"box"}],"direction":"vertical","gap":"lg","type":"stack"} @label "Copy block" @tier "internal"
     eyebrow        : string = "" @label "Eyebrow" @description "Small badge above the headline; empty hides it" @synonyms "tag, kicker, label above title" @tier "presentation"
     headline       : string = "Build what you mean" @label "Headline" @description "Main headline" @synonyms "title, heading" @tier "presentation"
+    height         : string = "auto" @label "Height" @description "auto fits the copy; tall fills most of the screen with the copy centred, for a hero over a backdrop scene" @tier "presentation" @values (auto tall)
     lede           : string = "" @label "Supporting text" @description "One or two sentences under the headline; empty hides it" @synonyms "subtitle, subheading, description, tagline" @tier "presentation"
     look           : string = "hero" @label "Look" @description "hero = full-width page opener with an h1; banner = contained call-to-action card with an h2" @synonyms "cta banner, call to action, callout, page header, masthead" @tier "presentation" @values (hero banner)
     mediaAlt       : string = "" @label "Media alt text" @tier "presentation"
@@ -21333,8 +21799,8 @@ trait std-hero.traits.HeroRender {
     primaryLabel   : string = "Get started" @label "Primary action label" @description "Empty hides the primary action" @tier "presentation"
     secondaryHref  : string = "" @label "Secondary action link" @description "In-app path, #anchor, or absolute URL" @tier "presentation"
     secondaryLabel : string = "" @label "Secondary action label" @description "Empty hides the secondary action" @tier "presentation"
-    sideContent    : render-ui = {"bg":["if",["==","@config.surface","muted"],"muted","transparent"],"children":[{"children":[{"bg":["if",["==","@config.look","banner"],"muted","transparent"],"border":["==","@config.look","banner"],"children":[{"align":"center","children":["@config.copyContent","@config.mediaContent"],"gap":"xl","ratio":"1:1","type":"split"}],"padding":["if",["==","@config.look","banner"],"xl","none"],"rounded":["if",["==","@config.look","banner"],"2xl","none"],"type":"box"}],"maxWidth":"xl","padding":"lg","size":"xl","type":"container"}],"fullWidth":true,"paddingY":["if",["==","@config.look","banner"],"xl","2xl"],"type":"box"} @label "Side-by-side body" @tier "internal"
-    stackedContent : render-ui = {"bg":["if",["==","@config.surface","muted"],"muted","transparent"],"children":[{"children":[{"bg":["if",["==","@config.look","banner"],"muted","transparent"],"border":["==","@config.look","banner"],"children":[{"align":["if",["==","@config.alignment","center"],"center","stretch"],"children":["@config.copyContent","@config.mediaContent"],"direction":"vertical","gap":"2xl","type":"stack"}],"padding":["if",["==","@config.look","banner"],"xl","none"],"rounded":["if",["==","@config.look","banner"],"2xl","none"],"type":"box"}],"maxWidth":"xl","padding":"lg","size":"xl","type":"container"}],"fullWidth":true,"paddingY":["if",["==","@config.look","banner"],"xl","2xl"],"type":"box"} @label "Stacked body" @tier "internal"
+    sideContent    : render-ui = {"bg":["if",["==","@config.surface","muted"],"muted","transparent"],"children":[{"aria-hidden":true,"children":["@config.backdropContent"],"className":"inset-0 pointer-events-none","position":"absolute","type":"box"},{"children":[{"children":[{"bg":["if",["==","@config.look","banner"],"muted","transparent"],"border":["==","@config.look","banner"],"children":[{"align":"center","children":["@config.copyContent","@config.mediaContent"],"gap":"xl","ratio":"1:1","type":"split"}],"padding":["if",["==","@config.look","banner"],"xl","none"],"rounded":["if",["==","@config.look","banner"],"2xl","none"],"type":"box"}],"maxWidth":"xl","padding":"lg","size":"xl","type":"container"}],"fullWidth":true,"position":"relative","type":"box"}],"className":["if",["==","@config.height","tall"],"flex min-h-[80vh] items-center",""],"fullWidth":true,"overflow":"hidden","paddingY":["if",["==","@config.look","banner"],"xl","2xl"],"position":"relative","type":"box"} @label "Side-by-side body" @tier "internal"
+    stackedContent : render-ui = {"bg":["if",["==","@config.surface","muted"],"muted","transparent"],"children":[{"aria-hidden":true,"children":["@config.backdropContent"],"className":"inset-0 pointer-events-none","position":"absolute","type":"box"},{"children":[{"children":[{"bg":["if",["==","@config.look","banner"],"muted","transparent"],"border":["==","@config.look","banner"],"children":[{"align":["if",["==","@config.alignment","center"],"center","stretch"],"children":["@config.copyContent","@config.mediaContent"],"direction":"vertical","gap":"2xl","type":"stack"}],"padding":["if",["==","@config.look","banner"],"xl","none"],"rounded":["if",["==","@config.look","banner"],"2xl","none"],"type":"box"}],"maxWidth":"xl","padding":"lg","size":"xl","type":"container"}],"fullWidth":true,"position":"relative","type":"box"}],"className":["if",["==","@config.height","tall"],"flex min-h-[80vh] items-center",""],"fullWidth":true,"overflow":"hidden","paddingY":["if",["==","@config.look","banner"],"xl","2xl"],"position":"relative","type":"box"} @label "Stacked body" @tier "internal"
     surface        : string = "plain" @label "Surface" @description "Background behind the block" @tier "presentation" @values (plain muted)
   }
   override-surface : (linkedEntity name events effects listens emitsScope config)
@@ -21442,8 +21908,8 @@ trait std-learn-arrangement.traits.LearnArrangementSim {
   linkedEntity   : LearnArrangementScene
   category       : interaction
   states         : (idle*)
-  events         : (INIT MODE_SELECTED PLACE UNDO CHECK RETRY ARRANGEMENT_CHECKED ARRANGEMENT_RESET LEARN_ROUND_COMPLETE)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on PLACE) (idle -> idle on UNDO) (idle -> idle on CHECK) (idle -> idle on RETRY))
+  events         : (INIT MODE_SELECTED ROSTER_LOADED PLACE UNDO CHECK RETRY ARRANGEMENT_CHECKED ARRANGEMENT_RESET LEARN_ROUND_COMPLETE)
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on ROSTER_LOADED) (idle -> idle on ROSTER_LOADED) (idle -> idle on PLACE) (idle -> idle on UNDO) (idle -> idle on CHECK) (idle -> idle on RETRY))
   emits          : (ARRANGEMENT_CHECKED ARRANGEMENT_RESET LEARN_ROUND_COMPLETE)
   config {
     animate        : boolean = false @label "Animate" @description "Enable continuous redraw loop." @tier "presentation"
@@ -21457,6 +21923,7 @@ trait std-learn-arrangement.traits.LearnArrangementSim {
     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." @tier "presentation"
     pendingColor   : string = "series-2" @label "Pending Slot Color" @description "Fill color for a filled slot before grading." @tier "presentation"
     retryLabel     : string = "Retry" @label "Retry Button Label" @tier "presentation"
+    rosterSource   : string = "config" @label "Roster Source" @description "Where the roster comes from: config reads the items knob(s) at INIT; event waits for ROSTER_LOADED and takes the roster from its payload." @tier "domain" @values (config event)
     slotBorderColor : string = "ink" @label "Slot Border Color" @tier "presentation"
     slotFontSize   : string = "sm" @label "Slot Text Size" @description "Slot label size role: xs, sm, base or lg." @tier "presentation"
     slotHeight     : number = 60 @label "Slot Height (px)" @tier "presentation"
@@ -21480,8 +21947,8 @@ trait std-learn-classify.traits.LearnClassifySim {
   linkedEntity   : LearnClassifyScene
   category       : interaction
   states         : (idle*)
-  events         : (INIT MODE_SELECTED PICK ADVANCE RETRY TOGGLE_RUN CLASSIFY_UPDATED LEARN_ROUND_COMPLETE)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on PICK) (idle -> idle on ADVANCE) (idle -> idle on RETRY) (idle -> idle on TOGGLE_RUN))
+  events         : (INIT MODE_SELECTED ROSTER_LOADED PICK ADVANCE RETRY TOGGLE_RUN CLASSIFY_UPDATED LEARN_ROUND_COMPLETE)
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on ROSTER_LOADED) (idle -> idle on ROSTER_LOADED) (idle -> idle on PICK) (idle -> idle on ADVANCE) (idle -> idle on RETRY) (idle -> idle on TOGGLE_RUN))
   emits          : (CLASSIFY_UPDATED LEARN_ROUND_COMPLETE)
   config {
     advanceLabel   : string = "Next" @label "Advance Button Label" @description "Label text for the button that advances to the next item." @tier "presentation"
@@ -21502,6 +21969,7 @@ trait std-learn-classify.traits.LearnClassifySim {
     penaltyPerMiss : number = 0 @label "Penalty Per Miss" @description "Rubric points subtracted for each incorrect pick (score never drops below 0)." @tier "domain"
     pointsPerCorrect : number = 1 @label "Points Per Correct" @description "Rubric points added to the score for each correct pick; at the default 1 with no penalty, the plain correct/attempted counts render instead of the rubric score." @tier "domain"
     retryLabel     : string = "Retry Round" @label "Retry Button Label" @description "Label text for the button that restarts the round from the end-of-round summary." @tier "presentation"
+    rosterSource   : string = "config" @label "Roster Source" @description "Where the roster comes from: config reads the items/categories knob(s) at INIT; event waits for ROSTER_LOADED and takes the roster from its payload." @tier "domain" @values (config event)
     scoreCap       : number = 0 @label "Score Cap" @description "Upper bound on the rubric score; 0 means uncapped." @tier "domain"
     showHint       : boolean = true @label "Show Hint" @description "Show each item's hint line beneath the prompt before the learner picks; hide for a harder drill." @tier "domain"
     summary        : string = "" @label "Concept" @description "One line under the title saying what is being classified (keep it under ~65 characters). Empty shows no line." @tier "presentation"
@@ -21562,8 +22030,8 @@ trait std-learn-coupled-sim.traits.CoupledSimSim {
   linkedEntity   : CoupledSimScene
   category       : interaction
   states         : (idle*)
-  events         : (INIT MODE_SELECTED TOGGLE_RUN SPEED_SET RUN PAUSE RESET SET_A SET_B SHOCK RUN_TOGGLED SIM_RESET COEFS_CHANGED SHOCK_APPLIED)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on TOGGLE_RUN) (idle -> idle on SPEED_SET) (idle -> idle on RUN) (idle -> idle on PAUSE) (idle -> idle on RESET) (idle -> idle on SET_A) (idle -> idle on SET_B) (idle -> idle on SHOCK))
+  events         : (INIT MODE_SELECTED ROSTER_LOADED TOGGLE_RUN SPEED_SET RUN PAUSE RESET SET_A SET_B SHOCK RUN_TOGGLED SIM_RESET COEFS_CHANGED SHOCK_APPLIED)
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on ROSTER_LOADED) (idle -> idle on ROSTER_LOADED) (idle -> idle on TOGGLE_RUN) (idle -> idle on SPEED_SET) (idle -> idle on RUN) (idle -> idle on PAUSE) (idle -> idle on RESET) (idle -> idle on SET_A) (idle -> idle on SET_B) (idle -> idle on SHOCK))
   emits          : (RUN_TOGGLED SIM_RESET COEFS_CHANGED SHOCK_APPLIED)
   config {
     autoRun        : boolean = true @label "Auto Run" @description "Whether the simulation starts running immediately on load." @tier "domain"
@@ -21583,13 +22051,14 @@ trait std-learn-coupled-sim.traits.CoupledSimSim {
     gridStep       : number = 50 @label "Grid Step" @tier "presentation"
     height         : number = 360 @label "Height" @tier "presentation"
     kind           : string = "predator-prey" @label "Interaction Family" @description "Which coupled dynamics govern the two quantities: predator-prey (oscillating cycles), epidemic (S and I with transmission and recovery), or kinetics (A decaying into B)." @synonyms "predator prey, Lotka-Volterra, SIR, epidemic, reaction kinetics, coupled ODE" @tier "domain"
-    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." @tier "presentation"
+    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 (or on ROSTER_LOADED when rosterSource is event)." @tier "presentation"
     pColor         : string = "series-1" @label "P Color" @tier "presentation"
     pLabel         : string = "Prey" @label "P Label" @description "Display name of the first quantity." @tier "domain"
     pStart         : number = 120 @label "P Start" @tier "domain"
     qColor         : string = "series-2" @label "Q Color" @tier "presentation"
     qLabel         : string = "Predators" @label "Q Label" @description "Display name of the second quantity." @tier "domain"
     qStart         : number = 40 @label "Q Start" @tier "domain"
+    rosterSource   : string = "config" @label "Roster Source" @description "Where the system definition (taskText, kind, pLabel, qLabel, pStart, qStart, coefALabel, coefBLabel) comes from: config reads those knobs at INIT; event waits for ROSTER_LOADED and takes them from its payload." @tier "domain" @values (config event)
     shockDownLabel : string = "− Prey cull" @label "Shock Down Label" @tier "presentation"
     shockSize      : number = 40 @label "Shock Size" @description "How much of the first quantity a shock button injects or removes." @tier "domain"
     shockUpLabel   : string = "+ Prey burst" @label "Shock Up Label" @tier "presentation"
@@ -21610,8 +22079,8 @@ trait std-learn-derivation.traits.LearnDerivationSim {
   linkedEntity   : LearnDerivationScene
   category       : interaction
   states         : (idle*)
-  events         : (INIT MODE_SELECTED APPLY_STEP TOGGLE_RUN RESET DERIVATION_UPDATED LEARN_ROUND_COMPLETE)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on APPLY_STEP) (idle -> idle on TOGGLE_RUN) (idle -> idle on RESET))
+  events         : (INIT MODE_SELECTED ROSTER_LOADED APPLY_STEP TOGGLE_RUN RESET DERIVATION_UPDATED LEARN_ROUND_COMPLETE)
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on ROSTER_LOADED) (idle -> idle on ROSTER_LOADED) (idle -> idle on APPLY_STEP) (idle -> idle on TOGGLE_RUN) (idle -> idle on RESET))
   emits          : (DERIVATION_UPDATED LEARN_ROUND_COMPLETE)
   config {
     autoApplyIntervalMs : number = 800 @label "Auto-Apply Interval (ms)" @description "Milliseconds of running clock per automatic candidate application — the 32ms base tick accumulates elapsed time and applies the first applicable candidate each time this interval elapses." @tier "domain"
@@ -21628,6 +22097,7 @@ trait std-learn-derivation.traits.LearnDerivationSim {
     noStepAvailableMessage : string = "No further steps are available yet." @label "No Step Available Message" @description "Feedback shown when the auto-apply tick finds no applicable candidate." @tier "presentation"
     premises       : [LearnDerivationLine] = [{"badgeLabel":"GIVEN","badgeVariant":"neutral","id":"given-a","kind":"fact","label":"A","negated":false,"subject":"A"},{"badgeLabel":"RULE","badgeVariant":"info","id":"given-a-implies-b","kind":"link","label":"A → B","leftNegated":false,"leftSubject":"A","rightNegated":false,"rightSubject":"B"}] @label "Premises" @description "The starting lines of the derivation: plain facts (subject/negated) and two-sided links (leftSubject/leftNegated/rightSubject/rightNegated) the learner combines with candidate steps. Each line carries its own badgeLabel/badgeVariant." @synonyms "premise, given, starting line, hypothesis, starting statement" @tier "domain"
     resetLabel     : string = "Reset" @label "Reset Button Label" @description "Label text for the button that restores the starting premises." @tier "presentation"
+    rosterSource   : string = "config" @label "Roster Source" @description "Where the roster comes from: config reads the premises/candidates knob(s) at INIT; event waits for ROSTER_LOADED and takes the roster from its payload." @tier "domain" @values (config event)
     summary        : string = "" @label "Concept" @description "One line under the title saying what is being derived (keep it under ~65 characters). Empty shows no line." @tier "presentation"
     title          : string = "Derivation Lab" @label "Title" @description "Title shown above the derivation panel." @tier "presentation"
     width          : number = 600 @label "Width" @description "Maximum width of the panel, in pixels." @tier "presentation"
@@ -21642,8 +22112,8 @@ trait std-learn-diagram.traits.LearnDiagramSim {
   linkedEntity   : LearnDiagramScene
   category       : interaction
   states         : (idle*)
-  events         : (INIT MODE_SELECTED SELECT_PART CLEAR_PART PART_SELECTED SELECTION_CLEARED)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on SELECT_PART) (idle -> idle on CLEAR_PART))
+  events         : (INIT MODE_SELECTED ROSTER_LOADED SELECT_PART CLEAR_PART PART_SELECTED SELECTION_CLEARED)
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on ROSTER_LOADED) (idle -> idle on ROSTER_LOADED) (idle -> idle on SELECT_PART) (idle -> idle on CLEAR_PART))
   emits          : (PART_SELECTED SELECTION_CLEARED)
   config {
     backgroundColor : string = "" @label "Background Color" @description "Canvas ground. Empty uses the theme drawing ground." @tier "presentation"
@@ -21654,6 +22124,7 @@ trait std-learn-diagram.traits.LearnDiagramSim {
     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." @tier "presentation"
     overviewText   : string = "Select a part below to learn what it does." @label "Overview Text" @description "Caption card text shown when no part is selected." @tier "presentation"
     parts          : [LearnDiagramPart] = [{"color":"series-1","description":"Receives raw data or requests from the outside world and hands them to the processor.","id":"input","label":"Input","radius":34,"x":120,"y":200},{"color":"series-2","description":"The central component that transforms incoming data according to the system's rules.","id":"processor","label":"Processor","radius":46,"x":300,"y":200},{"color":"series-3","description":"Persists data so it can be retrieved later, even after the system restarts.","id":"storage","label":"Storage","radius":34,"x":300,"y":320},{"color":"series-4","description":"Delivers the processor's results back out to users or other systems.","id":"output","label":"Output","radius":34,"x":480,"y":200},{"color":"series-5","description":"Coordinates timing and configuration for the processor without touching the data itself.","id":"controller","label":"Controller","radius":26,"x":300,"y":80}] @label "Parts" @description "Roster of labeled parts (id, label, description, x, y, radius, color) the diagram renders as circles; the learner selects one to see its description." @synonyms "part, node, component, label, annotation" @tier "domain"
+    rosterSource   : string = "config" @label "Roster Source" @description "Where the parts and links roster comes from: config reads the parts and links knobs at INIT; event waits for ROSTER_LOADED and takes the roster from its payload." @tier "domain" @values (config event)
     summary        : string = "" @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"
     title          : string = "System Diagram" @label "Title" @description "Title shown above the diagram." @tier "presentation"
     width          : number = 600 @label "Width" @description "Canvas width in pixels." @tier "presentation"
@@ -21668,8 +22139,8 @@ trait std-learn-doser.traits.LearnDoserSim {
   linkedEntity   : DoserScene
   category       : interaction
   states         : (idle*)
-  events         : (INIT MODE_SELECTED ADD_SMALL ADD_LARGE TOGGLE_DRIP RESET DOSE_ADDED DOSE_RESET DOSER_UPDATED LEARN_ROUND_COMPLETE)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on ADD_SMALL) (idle -> idle on ADD_LARGE) (idle -> idle on TOGGLE_DRIP) (idle -> idle on RESET))
+  events         : (INIT MODE_SELECTED ROSTER_LOADED ADD_SMALL ADD_LARGE TOGGLE_DRIP RESET DOSE_ADDED DOSE_RESET DOSER_UPDATED LEARN_ROUND_COMPLETE)
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on ROSTER_LOADED) (idle -> idle on ROSTER_LOADED) (idle -> idle on ADD_SMALL) (idle -> idle on ADD_LARGE) (idle -> idle on TOGGLE_DRIP) (idle -> idle on RESET))
   emits          : (DOSE_ADDED DOSE_RESET DOSER_UPDATED LEARN_ROUND_COMPLETE)
   config {
     autoDrip       : boolean = false @label "Auto Drip" @description "When true, INIT/MODE_SELECTED/Reset start the drip clock adding a small increment each interval; toggle live with the Auto-dose/Pause button." @tier "domain"
@@ -21682,6 +22153,7 @@ trait std-learn-doser.traits.LearnDoserSim {
     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." @tier "presentation"
     quantityLabel  : string = "Dose" @label "Quantity Label" @description "Label used for the accumulated-quantity readout and in the narration line." @synonyms "quantity, amount, dose, volume, level" @tier "domain"
     reservoirLabel : string = "Reservoir" @label "Reservoir Label" @description "Label for the vessel that fills as dose accumulates." @synonyms "reservoir, beaker, tank, container, receiving vessel" @tier "presentation"
+    rosterSource   : string = "config" @label "Roster Source" @description "Where the band roster comes from: config reads the bands knob at INIT; event waits for ROSTER_LOADED and takes the roster from its payload." @tier "domain" @values (config event)
     series         : [string] = [] @label "Palette" @description "Overrides the theme's categorical palette on the canvas (series-1…N) — a subject's real-world color convention, such as indicator colors. Empty uses the theme's palette." @tier "presentation"
     showCanvas     : boolean = true @label "Show Canvas" @description "When true (the default, standalone use) the instrument renders its own reservoir/source canvas and narration below the control strip. Set false when a domain sibling trait composes this atom via @rebindable and owns the accurate scene render itself — then only the control strip (add/drip/reset buttons) embeds via @trait.<name>, avoiding a duplicate canvas." @tier "presentation"
     sourceColor    : string = "series-1" @label "Source Color" @description "Tone name for the source vessel fill (for example series-1)." @tier "presentation"
@@ -21704,8 +22176,8 @@ trait std-learn-estimate.traits.EstimateSim {
   linkedEntity   : EstimateScene
   category       : interaction
   states         : (idle*)
-  events         : (INIT MODE_SELECTED SET_ESTIMATE LOCK_IN NEXT RETRY ESTIMATE_JUDGED PROMPT_ADVANCED ROUND_RESTARTED LEARN_ROUND_COMPLETE)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on SET_ESTIMATE) (idle -> idle on LOCK_IN) (idle -> idle on NEXT) (idle -> idle on RETRY))
+  events         : (INIT MODE_SELECTED ROSTER_LOADED SET_ESTIMATE LOCK_IN NEXT RETRY ESTIMATE_JUDGED PROMPT_ADVANCED ROUND_RESTARTED LEARN_ROUND_COMPLETE)
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on ROSTER_LOADED) (idle -> idle on ROSTER_LOADED) (idle -> idle on SET_ESTIMATE) (idle -> idle on LOCK_IN) (idle -> idle on NEXT) (idle -> idle on RETRY))
   emits          : (ESTIMATE_JUDGED PROMPT_ADVANCED ROUND_RESTARTED LEARN_ROUND_COMPLETE)
   config {
     closePct       : number = 0.25 @label "Close Band" @description "Relative error at or below this fraction (but above the exact band) counts as close (partial points)." @tier "domain"
@@ -21717,6 +22189,7 @@ trait std-learn-estimate.traits.EstimateSim {
     nextLabel      : string = "Next" @label "Next Label" @tier "presentation"
     prompts        : [EstimatePrompt] = [{"answer":300,"hint":"Light covers 300,000 km every second.","prompt":"How many meters does light travel in one microsecond?","unit":"m"},{"answer":212,"hint":"It is 100 °C.","prompt":"What is the boiling point of water at sea level, in Fahrenheit?","unit":"°F"},{"answer":11.6,"hint":"A day is 86,400 seconds.","prompt":"Roughly how many days is one million seconds?","unit":"days"}] @label "Prompts" @description "The question roster; each prompt carries the true numeric answer, an optional unit, and an optional hint. Realizations declare their own subject's quantities here." @tier "domain"
     retryLabel     : string = "Try Again" @label "Retry Label" @tier "presentation"
+    rosterSource   : string = "config" @label "Roster Source" @description "Where the prompt roster comes from: config reads the prompts knob at INIT; event waits for ROSTER_LOADED and takes the roster from its payload." @tier "domain" @values (config event)
     sliderDefault  : number = 100 @label "Slider Default" @description "Starting position of the estimate slider for each prompt." @tier "domain"
     sliderMax      : number = 500 @label "Slider Max" @description "Upper bound of the estimate slider." @tier "domain"
     sliderMin      : number = 0 @label "Slider Min" @description "Lower bound of the estimate slider." @tier "domain"
@@ -21758,8 +22231,8 @@ trait std-learn-goal-seek.traits.GoalSeekSim {
   linkedEntity   : GoalSeekScene
   category       : interaction
   states         : (idle*)
-  events         : (INIT MODE_SELECTED SET_PARAM_A SET_PARAM_B CHECK RESET PARAMS_CHANGED GOAL_CHECKED GOAL_RESET LEARN_ROUND_COMPLETE)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on SET_PARAM_A) (idle -> idle on SET_PARAM_B) (idle -> idle on CHECK) (idle -> idle on RESET))
+  events         : (INIT MODE_SELECTED ROSTER_LOADED SET_PARAM_A SET_PARAM_B CHECK RESET PARAMS_CHANGED GOAL_CHECKED GOAL_RESET LEARN_ROUND_COMPLETE)
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on ROSTER_LOADED) (idle -> idle on ROSTER_LOADED) (idle -> idle on SET_PARAM_A) (idle -> idle on SET_PARAM_B) (idle -> idle on CHECK) (idle -> idle on RESET))
   emits          : (PARAMS_CHANGED GOAL_CHECKED GOAL_RESET LEARN_ROUND_COMPLETE)
   config {
     checkLabel     : string = "Check" @label "Check Label" @tier "presentation"
@@ -21769,7 +22242,7 @@ trait std-learn-goal-seek.traits.GoalSeekSim {
     height         : number = 400 @label "Height" @tier "presentation"
     learnerColor   : string = "series-2" @label "Learner Color" @tier "presentation"
     learnerLabel   : string = "Yours" @label "Learner Label" @tier "presentation"
-    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." @tier "presentation"
+    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 (or on ROSTER_LOADED when rosterSource is event)." @tier "presentation"
     paramADefault  : number = 1 @label "Parameter A Default" @description "Starting value of the learner's first parameter." @tier "domain"
     paramALabel    : string = "A" @label "Parameter A Label" @description "Display label for the first parameter." @tier "presentation"
     paramAMax      : number = 5 @label "Parameter A Max" @tier "domain"
@@ -21780,6 +22253,7 @@ trait std-learn-goal-seek.traits.GoalSeekSim {
     paramBMax      : number = 5 @label "Parameter B Max" @tier "domain"
     paramBMin      : number = -5 @label "Parameter B Min" @tier "domain"
     paramBStep     : number = 0.1 @label "Parameter B Step" @tier "presentation"
+    rosterSource   : string = "config" @label "Roster Source" @description "Where the problem definition (goalText, curveKind, targetA, targetB) comes from: config reads those knobs at INIT; event waits for ROSTER_LOADED and takes them from its payload." @tier "domain" @values (config event)
     showAxes       : boolean = true @label "Show Axes" @tier "presentation"
     showGrid       : boolean = true @label "Show Grid" @tier "presentation"
     showLiveDistance : boolean = true @label "Show Live Distance" @description "When true the RMS distance updates live as the learner tunes (warmer/colder); when false only attempts are shown, for a harder variant." @tier "domain"
@@ -21804,8 +22278,8 @@ trait std-learn-grid-sim.traits.GridSimSim {
   linkedEntity   : GridSimScene
   category       : interaction
   states         : (idle*)
-  events         : (INIT MODE_SELECTED TOGGLE_RUN SPEED_SET RUN PAUSE STEP TAP_CELL RESET RUN_TOGGLED GRID_STEPPED CELL_TOGGLED GRID_RESET)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on TOGGLE_RUN) (idle -> idle on SPEED_SET) (idle -> idle on RUN) (idle -> idle on PAUSE) (idle -> idle on STEP) (idle -> idle on TAP_CELL) (idle -> idle on RESET))
+  events         : (INIT MODE_SELECTED ROSTER_LOADED TOGGLE_RUN SPEED_SET RUN PAUSE STEP TAP_CELL RESET RUN_TOGGLED GRID_STEPPED CELL_TOGGLED GRID_RESET)
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on ROSTER_LOADED) (idle -> idle on ROSTER_LOADED) (idle -> idle on TOGGLE_RUN) (idle -> idle on SPEED_SET) (idle -> idle on RUN) (idle -> idle on PAUSE) (idle -> idle on STEP) (idle -> idle on TAP_CELL) (idle -> idle on RESET))
   emits          : (RUN_TOGGLED GRID_STEPPED CELL_TOGGLED GRID_RESET)
   config {
     autoRun        : boolean = false @label "Auto Run" @description "Whether the evolution starts running immediately on load." @tier "domain"
@@ -21816,10 +22290,11 @@ trait std-learn-grid-sim.traits.GridSimSim {
     diffuseRate    : number = 0.5 @label "Diffuse Rate" @description "Diffusion rule only: how strongly a cell moves toward its neighbourhood average each generation." @tier "domain"
     height         : number = 332 @label "Height" @tier "presentation"
     lowColor       : string = "muted" @label "Low Color" @tier "presentation"
-    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." @tier "presentation"
+    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 (or on ROSTER_LOADED when rosterSource is event)." @tier "presentation"
     midColor       : string = "series-3" @label "Mid Color" @tier "presentation"
     offColor       : string = "fill" @label "Off Color" @tier "presentation"
     onColor        : string = "series-2" @label "On Color" @tier "presentation"
+    rosterSource   : string = "config" @label "Roster Source" @description "Where the world definition (taskText, rule, rows, cols, seeds) comes from: config reads those knobs at INIT; event waits for ROSTER_LOADED and takes them from its payload." @tier "domain" @values (config event)
     rows           : number = 12 @label "Rows" @tier "domain"
     rule           : string = "life" @label "Rule" @description "The local update rule: life (Conway birth-3 survive-2-3), spread (an active 4-neighbour activates a cell), or diffusion (cells relax toward the neighbourhood average with decay)." @synonyms "game of life, contagion, wavefront, heat diffusion, cellular automaton rule" @tier "domain"
     seeds          : [number] = [1,18,32,33,34,88,89,90] @label "Seeds" @description "Flat cell indexes (row·cols + col) active at the start — the default plants a glider and a blinker. Realizations declare their own starting pattern here." @tier "domain"
@@ -21839,8 +22314,8 @@ trait std-learn-hotspot.traits.HotspotSim {
   linkedEntity   : HotspotScene
   category       : interaction
   states         : (idle*)
-  events         : (INIT MODE_SELECTED TAP_SHAPE NEXT RETRY TAP_JUDGED PROMPT_ADVANCED ROUND_RESTARTED LEARN_ROUND_COMPLETE)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on TAP_SHAPE) (idle -> idle on NEXT) (idle -> idle on RETRY))
+  events         : (INIT MODE_SELECTED ROSTER_LOADED TAP_SHAPE NEXT RETRY TAP_JUDGED PROMPT_ADVANCED ROUND_RESTARTED LEARN_ROUND_COMPLETE)
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on ROSTER_LOADED) (idle -> idle on ROSTER_LOADED) (idle -> idle on TAP_SHAPE) (idle -> idle on NEXT) (idle -> idle on RETRY))
   emits          : (TAP_JUDGED PROMPT_ADVANCED ROUND_RESTARTED LEARN_ROUND_COMPLETE)
   config {
     backgroundColor : string = "" @label "Background Color" @tier "presentation"
@@ -21850,6 +22325,7 @@ trait std-learn-hotspot.traits.HotspotSim {
     nextLabel      : string = "Next" @label "Next Label" @tier "presentation"
     prompts        : [HotspotPrompt] = [{"explanation":"The nucleus holds the DNA.","prompt":"Tap the part that stores the cell's genetic material.","targetId":"nucleus"},{"explanation":"Mitochondria run cellular respiration.","prompt":"Tap the part that produces the cell's energy.","targetId":"mitochondrion"},{"explanation":"Ribosomes translate mRNA into protein.","prompt":"Tap the part that builds proteins.","targetId":"ribosome"}] @label "Prompts" @description "The question roster; each prompt names a target hotspot id and an explanation revealed on a hit." @tier "domain"
     retryLabel     : string = "Try Again" @label "Retry Label" @tier "presentation"
+    rosterSource   : string = "config" @label "Roster Source" @description "Where the shapes and prompts roster comes from: config reads the shapes and prompts knobs at INIT; event waits for ROSTER_LOADED and takes the roster from its payload." @tier "domain" @values (config event)
     shapes         : [HotspotShape] = [{"color":"series-1","id":"nucleus","label":"Nucleus","radius":34,"x":300,"y":170},{"color":"series-2","id":"membrane","label":"Membrane","radius":26,"x":130,"y":120},{"color":"series-3","id":"mitochondrion","label":"Mitochondrion","radius":24,"x":460,"y":120},{"color":"series-4","id":"ribosome","label":"Ribosome","radius":18,"x":200,"y":280},{"color":"series-5","id":"vacuole","label":"Vacuole","radius":28,"x":420,"y":280}] @label "Hotspots" @description "The labeled parts of the scene; each carries an id, display label, canvas position, radius, and color. Realizations declare their own subject's parts here." @tier "domain"
     summary        : string = "" @label "Concept" @description "One line under the title saying what is being identified (keep it under ~65 characters). Empty shows no line." @tier "presentation"
     title          : string = "Tap the Part" @label "Title" @description "Title shown above the canvas." @tier "presentation"
@@ -21865,17 +22341,18 @@ trait std-learn-live-sim.traits.LiveSimSim {
   linkedEntity   : LiveSimScene
   category       : interaction
   states         : (idle*)
-  events         : (INIT MODE_SELECTED TOGGLE_RUN RUN PAUSE RESET SET_GRAVITY SET_DAMPING RUN_TOGGLED SIM_RESET)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on TOGGLE_RUN) (idle -> idle on RUN) (idle -> idle on PAUSE) (idle -> idle on RESET) (idle -> idle on SET_GRAVITY) (idle -> idle on SET_DAMPING))
+  events         : (INIT MODE_SELECTED ROSTER_LOADED TOGGLE_RUN RUN PAUSE RESET SET_GRAVITY SET_DAMPING RUN_TOGGLED SIM_RESET)
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on ROSTER_LOADED) (idle -> idle on ROSTER_LOADED) (idle -> idle on TOGGLE_RUN) (idle -> idle on RUN) (idle -> idle on PAUSE) (idle -> idle on RESET) (idle -> idle on SET_GRAVITY) (idle -> idle on SET_DAMPING))
   emits          : (RUN_TOGGLED SIM_RESET)
   config {
     backgroundColor : string = "" @label "Background Color" @description "Canvas ground override; empty uses the theme's drawing ground." @tier "presentation"
-    bodies         : [LiveSimBody] = [{"color":"series-1","id":"ball-a","radius":14,"vx":4,"vy":0,"x":100,"y":60},{"color":"series-2","id":"ball-b","radius":18,"vx":-3,"vy":2,"x":260,"y":90},{"color":"series-3","id":"ball-c","radius":11,"vx":2,"vy":-1,"x":420,"y":40}] @label "Bodies" @description "Initial bodies; each carries position (x,y), radius, color, and velocity (vx,vy). Restored on Reset." @tier "presentation"
+    bodies         : [LiveSimBody] = [{"color":"series-1","id":"ball-a","radius":14,"vx":4,"vy":0,"x":100,"y":60},{"color":"series-2","id":"ball-b","radius":18,"vx":-3,"vy":2,"x":260,"y":90},{"color":"series-3","id":"ball-c","radius":11,"vx":2,"vy":-1,"x":420,"y":40}] @label "Bodies" @description "Initial bodies; each carries position (x,y), radius, color, and velocity (vx,vy). Restored on Reset. Used when rosterSource is config." @tier "presentation"
     damping        : number = 0.995 @label "Damping" @description "Initial fraction of velocity retained each tick (air resistance); adjustable live via the Damping slider." @tier "domain"
     gravity        : number = 0.4 @label "Gravity" @description "Initial downward acceleration added to each body's vy every tick; adjustable live via the Gravity slider." @tier "domain"
     height         : number = 400 @label "Height" @description "Simulation height in pixels; bounds the bounce." @tier "presentation"
-    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." @tier "presentation"
+    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 (or on ROSTER_LOADED when rosterSource is event)." @tier "presentation"
     restitution    : number = 0.78 @label "Restitution" @description "Fraction of speed kept when a body bounces off a wall." @tier "domain"
+    rosterSource   : string = "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" @values (config event)
     running        : boolean = false @label "Running" @description "Whether the simulation starts already running on INIT." @tier "domain"
     showVelocity   : boolean = true @label "Show Velocity" @description "Draw each body's velocity vector as an arrow." @tier "presentation"
     summary        : string = "" @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"
@@ -22007,8 +22484,8 @@ trait std-learn-predict.traits.PredictSim {
   linkedEntity   : PredictScene
   category       : interaction
   states         : (idle*)
-  events         : (INIT MODE_SELECTED PREDICT NEXT RETRY PREDICTION_COMMITTED SCENARIO_ADVANCED ROUND_RESTARTED LEARN_ROUND_COMPLETE)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on PREDICT) (idle -> idle on NEXT) (idle -> idle on RETRY))
+  events         : (INIT MODE_SELECTED ROSTER_LOADED PREDICT NEXT RETRY PREDICTION_COMMITTED SCENARIO_ADVANCED ROUND_RESTARTED LEARN_ROUND_COMPLETE)
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on ROSTER_LOADED) (idle -> idle on ROSTER_LOADED) (idle -> idle on PREDICT) (idle -> idle on NEXT) (idle -> idle on RETRY))
   emits          : (PREDICTION_COMMITTED SCENARIO_ADVANCED ROUND_RESTARTED LEARN_ROUND_COMPLETE)
   config {
     gridStep       : number = 25 @label "Grid Step" @tier "presentation"
@@ -22018,6 +22495,7 @@ trait std-learn-predict.traits.PredictSim {
     retryLabel     : string = "Try Again" @label "Retry Label" @tier "presentation"
     revealColor    : string = "series-1" @label "Reveal Color" @tier "presentation"
     revealLabel    : string = "Outcome" @label "Reveal Label" @tier "presentation"
+    rosterSource   : string = "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" @values (config event)
     scenarios      : [PredictScenario] = [{"correctIndex":1,"explanation":"With no limiting factor yet, growth compounds each season.","frames":[{"caption":"Season 1: 40 rabbits","value":40},{"caption":"Season 2: 52 rabbits","value":52},{"caption":"Season 3: 68 rabbits","value":68},{"caption":"Season 4: 88 rabbits","value":88},{"caption":"Season 5: 114 rabbits","value":114},{"caption":"Season 6: 148 rabbits — still accelerating","value":148}],"options":["It levels off","It keeps accelerating","It collapses"],"question":"What happens to the population over the next six seasons?","setup":"A small island hosts 40 rabbits with unlimited grass and no predators."},{"correctIndex":1,"explanation":"Predation and food limits impose a carrying capacity.","frames":[{"caption":"Season 1: 148 rabbits","value":148},{"caption":"Season 2: 160 rabbits","value":160},{"caption":"Season 3: 166 rabbits","value":166},{"caption":"Season 4: 169 rabbits","value":169},{"caption":"Season 5: 170 rabbits — the curve flattens","value":170}],"options":["It keeps accelerating","It levels off near a ceiling","It grows linearly"],"question":"What happens to the rabbit population now?","setup":"The same island now has foxes, and grass is running short."}] @label "Scenarios" @description "The scenario roster; each carries a setup, the question, the offered predictions with the correct index, an explanation, and the reveal frames (caption + value) that play out after the learner commits. Realizations declare their own subject's scenarios here." @tier "domain"
     summary        : string = "" @label "Concept" @description "One line under the title saying what is being predicted (keep it under ~65 characters). Empty shows no line." @tier "presentation"
     title          : string = "Predict, Then Watch" @label "Title" @description "Title shown above the instrument." @tier "presentation"
@@ -22060,8 +22538,8 @@ trait std-learn-sandbox.traits.LearnSandboxSim {
   linkedEntity   : LearnSandboxScene
   category       : interaction
   states         : (idle*)
-  events         : (INIT MODE_SELECTED TOGGLE RESET SYSTEM_CHANGED SANDBOX_RESET)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on TOGGLE) (idle -> idle on RESET))
+  events         : (INIT MODE_SELECTED ROSTER_LOADED TOGGLE RESET SYSTEM_CHANGED SANDBOX_RESET)
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on ROSTER_LOADED) (idle -> idle on ROSTER_LOADED) (idle -> idle on TOGGLE) (idle -> idle on RESET))
   emits          : (SYSTEM_CHANGED SANDBOX_RESET)
   config {
     animate        : boolean = false @label "Animate" @description "Enable continuous redraw loop." @tier "presentation"
@@ -22074,10 +22552,11 @@ trait std-learn-sandbox.traits.LearnSandboxSim {
     height         : number = 320 @label "Height" @description "Canvas height in pixels." @tier "presentation"
     interactive    : boolean = false @label "Interactive" @description "Enable pointer interaction on the canvas." @tier "presentation"
     links          : [LearnSandboxLink] = [{"from":"a","to":"b"},{"from":"b","to":"c"},{"from":"a","to":"d"},{"from":"d","to":"e"}] @label "Links" @description "Declared relationships drawn between elements; a link dims when either endpoint is disabled." @synonyms "link, edge, connection, dependency, relationship" @tier "domain"
-    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." @tier "presentation"
+    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, or on ROSTER_LOADED when rosterSource is event." @tier "presentation"
     nodeRadius     : number = 34 @label "Node Radius" @tier "presentation"
     outcomeLabel   : string = "System Status" @label "Outcome Label" @description "Label prefix used in the readout describing the derived total and hold status." @tier "presentation"
     resetLabel     : string = "Reset" @label "Reset Button Label" @tier "presentation"
+    rosterSource   : string = "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" @values (config event)
     summary        : string = "" @label "Concept" @description "One line under the title saying what the system models (keep it under ~65 characters). Empty shows no line." @tier "presentation"
     threshold      : number = 60 @label "Threshold" @description "The summed weight of enabled elements must reach this value for the system to hold." @synonyms "threshold, tipping point, sufficient total" @tier "domain"
     title          : string = "System Sandbox" @label "Title" @description "Title shown above the instrument." @tier "presentation"
@@ -22093,8 +22572,8 @@ trait std-learn-scatter-fit.traits.LearnScatterFitSim {
   linkedEntity   : LearnScatterFitScene
   category       : interaction
   states         : (idle*)
-  events         : (INIT MODE_SELECTED ADD_POINT DRAG_POINT GUESS_LINE REVEAL_FIT TOGGLE_RUN RESET LEARN_SCATTER_FIT_UPDATED LEARN_ROUND_COMPLETE)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on ADD_POINT) (idle -> idle on DRAG_POINT) (idle -> idle on GUESS_LINE) (idle -> idle on REVEAL_FIT) (idle -> idle on TOGGLE_RUN) (idle -> idle on RESET))
+  events         : (INIT MODE_SELECTED ROSTER_LOADED ADD_POINT DRAG_POINT GUESS_LINE REVEAL_FIT TOGGLE_RUN RESET LEARN_SCATTER_FIT_UPDATED LEARN_ROUND_COMPLETE)
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on ROSTER_LOADED) (idle -> idle on ROSTER_LOADED) (idle -> idle on ADD_POINT) (idle -> idle on DRAG_POINT) (idle -> idle on GUESS_LINE) (idle -> idle on REVEAL_FIT) (idle -> idle on TOGGLE_RUN) (idle -> idle on RESET))
   emits          : (LEARN_SCATTER_FIT_UPDATED LEARN_ROUND_COMPLETE)
   config {
     addPointLabel  : string = "Add Point" @label "Add Point Button Label" @tier "presentation"
@@ -22121,7 +22600,7 @@ trait std-learn-scatter-fit.traits.LearnScatterFitSim {
     height         : number = 400 @label "Height" @description "Canvas height in pixels." @tier "presentation"
     initialPoints  : [LearnScatterFitPoint] = [{"color":"ink","id":"p0","label":"","radius":5,"x":15,"y":25},{"color":"ink","id":"p1","label":"","radius":5,"x":32,"y":40},{"color":"ink","id":"p2","label":"","radius":5,"x":48,"y":44},{"color":"ink","id":"p3","label":"","radius":5,"x":63,"y":62},{"color":"ink","id":"p4","label":"","radius":5,"x":80,"y":70}] @label "Initial Points" @description "Scatter points the canvas starts with, in axis data coordinates; Reset reseeds from this roster." @synonyms "seed points, dataset, scatter data, sample" @tier "domain"
     interactive    : boolean = true @label "Interactive" @description "Enable pointer interaction on the canvas — required for dragging points." @tier "presentation"
-    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." @tier "presentation"
+    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, or on ROSTER_LOADED when rosterSource is event." @tier "presentation"
     maxPoints      : number = 20 @label "Max Points" @description "Cap on accumulated scatter points; Add Point and the auto-run tick stop once reached, until Reset." @tier "domain"
     narrationAddedTemplate : string = "point added" @label "Added Narration Template" @description "Narration phrase after a point is added (button or tick), assembled as \"<template> <n> — r = .., R² = ..\"." @tier "domain"
     narrationAutoAddingTemplate : string = "Auto-adding — tick adds a new point." @label "Auto-Adding Narration" @description "Narration shown after Run is pressed." @tier "domain"
@@ -22139,6 +22618,7 @@ trait std-learn-scatter-fit.traits.LearnScatterFitSim {
     residualColor  : string = "guide" @label "Residual Color" @tier "presentation"
     residualDash   : string = "dashed" @label "Residual Dash Style" @tier "presentation" @values (dashed dotted)
     revealLabel    : string = "Reveal Fit" @label "Reveal Fit Button Label" @tier "presentation"
+    rosterSource   : string = "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" @values (config event)
     runLabel       : string = "Run" @label "Run Button Label" @tier "presentation"
     showAxes       : boolean = true @label "Show Axes" @tier "presentation"
     showGrid       : boolean = true @label "Show Grid" @tier "presentation"
@@ -22159,17 +22639,18 @@ trait std-learn-scenario.traits.ScenarioSim {
   linkedEntity   : ScenarioScene
   category       : interaction
   states         : (idle*)
-  events         : (INIT MODE_SELECTED CHOOSE RESTART CHOICE_MADE SCENARIO_RESTARTED)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on CHOOSE) (idle -> idle on RESTART))
+  events         : (INIT MODE_SELECTED ROSTER_LOADED CHOOSE RESTART CHOICE_MADE SCENARIO_RESTARTED)
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on ROSTER_LOADED) (idle -> idle on ROSTER_LOADED) (idle -> idle on CHOOSE) (idle -> idle on RESTART))
   emits          : (CHOICE_MADE SCENARIO_RESTARTED)
   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." @tier "presentation"
+    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, or on ROSTER_LOADED when rosterSource is event." @tier "presentation"
     metricALabel   : string = "Budget" @label "Metric A Label" @description "Display name of the first tracked consequence metric." @tier "domain"
     metricAStart   : number = 100 @label "Metric A Start" @tier "domain"
     metricBLabel   : string = "Support" @label "Metric B Label" @description "Display name of the second tracked consequence metric." @tier "domain"
     metricBStart   : number = 50 @label "Metric B Start" @tier "domain"
     nodes          : [ScenarioNode] = [{"choices":[{"deltaA":-60,"deltaB":10,"label":"Build a levee now","next":"levee","note":"Fast protection, most of the budget gone."},{"deltaA":-25,"deltaB":-5,"label":"Restore the upstream wetlands","next":"wetlands","note":"Cheaper and greener, but slower to work."}],"id":"start","situation":"Your town's river floods every spring. The council asks you to lead the response."},{"choices":[{"deltaA":-30,"deltaB":-10,"label":"Raise the levee again","next":"end-lock-in","note":"Costs keep compounding."},{"deltaA":-20,"deltaB":15,"label":"Add wetlands as a second line","next":"end-hybrid","note":"Late, but it eases the pressure."}],"id":"levee","situation":"The levee holds the first spring, but silt builds up and the river rises higher each year."},{"choices":[{"deltaA":-15,"deltaB":25,"label":"Expand the wetland corridor","next":"end-green","note":"The town rallies behind the project."},{"deltaA":10,"deltaB":5,"label":"Bank the savings","next":"end-thrifty","note":"Prudent, though the corridor stays small."}],"id":"wetlands","situation":"Two springs pass; the wetlands now absorb most floods, and wildlife is returning."},{"choices":[],"id":"end-lock-in","situation":"You are locked into an arms race with the river: protected, but at ever-growing cost."},{"choices":[],"id":"end-hybrid","situation":"The hybrid defense works: the levee buys time and the wetlands cut the peak floods."},{"choices":[],"id":"end-green","situation":"The restored river corridor protects the town and becomes its most loved public space."},{"choices":[],"id":"end-thrifty","situation":"The town stays safe in normal years, with savings in reserve for a bigger flood."}] @label "Nodes" @description "The decision graph; each node carries a situation and its choices, each choice naming the next node, metric deltas, and a consequence note. A node with no choices ends the run. Realizations declare their own subject's decision tree here." @tier "domain"
     restartLabel   : string = "Play Again" @label "Restart Label" @tier "presentation"
+    rosterSource   : string = "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" @values (config event)
     startId        : string = "start" @label "Start Node" @description "Id of the node the scenario opens on." @tier "domain"
     summary        : string = "" @label "Concept" @description "One line under the title saying what the scenario explores (keep it under ~65 characters). Empty shows no line." @tier "presentation"
     title          : string = "Decision Scenario" @label "Title" @description "Title shown above the scenario." @tier "presentation"
@@ -22223,15 +22704,16 @@ trait std-learn-speed-drill.traits.SpeedDrillSim {
   linkedEntity   : SpeedDrillScene
   category       : interaction
   states         : (idle*)
-  events         : (INIT MODE_SELECTED ANSWER NEXT RETRY ANSWER_JUDGED PROMPT_ADVANCED ROUND_RESTARTED LEARN_ROUND_COMPLETE)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on ANSWER) (idle -> idle on NEXT) (idle -> idle on RETRY))
+  events         : (INIT MODE_SELECTED ROSTER_LOADED ANSWER NEXT RETRY ANSWER_JUDGED PROMPT_ADVANCED ROUND_RESTARTED LEARN_ROUND_COMPLETE)
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on ROSTER_LOADED) (idle -> idle on ROSTER_LOADED) (idle -> idle on ANSWER) (idle -> idle on NEXT) (idle -> idle on RETRY))
   emits          : (ANSWER_JUDGED PROMPT_ADVANCED ROUND_RESTARTED LEARN_ROUND_COMPLETE)
   config {
     basePoints     : number = 10 @label "Base Points" @description "Points for a correct answer regardless of speed." @tier "domain"
     items          : [SpeedDrillItem] = [{"correctIndex":1,"options":["54","56","63","48"],"prompt":"7 × 8"},{"correctIndex":0,"options":["54","56","45","63"],"prompt":"9 × 6"},{"correctIndex":2,"options":["124","132","144","148"],"prompt":"12 × 12"}] @label "Items" @description "The drill roster; each item carries a prompt, its options, and the index of the correct option. Realizations declare their own subject's items here." @tier "domain"
-    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." @tier "presentation"
+    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, or on ROSTER_LOADED when rosterSource is event." @tier "presentation"
     nextLabel      : string = "Next" @label "Next Label" @tier "presentation"
     retryLabel     : string = "Try Again" @label "Retry Label" @tier "presentation"
+    rosterSource   : string = "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" @values (config event)
     speedBonus     : number = 10 @label "Speed Bonus" @description "Maximum extra points awarded in proportion to the time left on the clock." @tier "domain"
     summary        : string = "" @label "Concept" @description "One line under the title saying what is being drilled (keep it under ~65 characters). Empty shows no line." @tier "presentation"
     timeLimit      : number = 6 @label "Time Limit" @description "Seconds the learner has to answer each item before it counts as a miss." @tier "domain"
@@ -22247,8 +22729,8 @@ trait std-learn-stepper.traits.LearnStepperSim {
   linkedEntity   : LearnStepperScene
   category       : interaction
   states         : (idle*)
-  events         : (INIT MODE_SELECTED NEXT PREV FILTER_CATEGORY RESET_STEPPER STEPPER_ADVANCED)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on NEXT) (idle -> idle on PREV) (idle -> idle on FILTER_CATEGORY) (idle -> idle on RESET_STEPPER))
+  events         : (INIT MODE_SELECTED ROSTER_LOADED NEXT PREV FILTER_CATEGORY RESET_STEPPER STEPPER_ADVANCED)
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on ROSTER_LOADED) (idle -> idle on ROSTER_LOADED) (idle -> idle on NEXT) (idle -> idle on PREV) (idle -> idle on FILTER_CATEGORY) (idle -> idle on RESET_STEPPER))
   emits          : (STEPPER_ADVANCED)
   config {
     allLabel       : string = "All" @label "All Filter Label" @tier "presentation"
@@ -22268,6 +22750,7 @@ trait std-learn-stepper.traits.LearnStepperSim {
     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." @tier "presentation"
     maxPosition    : number = 4 @label "Max Position" @description "Latest position on the axis (after the last stage)." @tier "domain"
     minPosition    : number = 0 @label "Min Position" @description "Earliest position on the axis (before the first stage)." @tier "domain"
+    rosterSource   : string = "config" @label "Roster Source" @description "Where the stages, categories and category summaries come from: config reads those knobs at INIT; event waits for ROSTER_LOADED and takes them from its payload. The axis range (minPosition/maxPosition) stays config." @tier "domain" @values (config event)
     stages         : [LearnStepperStage] = [{"category":"a","description":"First stage in the sequence.","id":"stage-1","label":"Stage One","position":1},{"category":"b","description":"Second stage in the sequence.","id":"stage-2","label":"Stage Two","position":2},{"category":"a","description":"Third stage in the sequence.","id":"stage-3","label":"Stage Three","position":3}] @label "Stages" @description "Ordered roster of stages (position, label, category, description) stepped through by NEXT/PREV and filtered by FILTER_CATEGORY. Sorted ascending by position." @synonyms "stage roster, sequence, timeline, cycle, phase, event roster, ordered stages" @tier "domain"
     startPrompt    : string = "Press Next to begin." @label "Start Prompt" @description "Narration shown before the learner has advanced past the first stage." @tier "presentation"
     summary        : string = "" @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"
@@ -22285,8 +22768,8 @@ trait std-learn-tour-3d.traits.Learn3DTourSim {
   linkedEntity   : Learn3DTourScene
   category       : interaction
   states         : (idle*)
-  events         : (INIT MODE_SELECTED TOUR SELECT_STATION RESET SYNC_STATIONS TOUR_3D_UPDATED LEARN_ROUND_COMPLETE)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on TOUR) (idle -> idle on SELECT_STATION) (idle -> idle on RESET) (idle -> idle on SYNC_STATIONS))
+  events         : (INIT MODE_SELECTED ROSTER_LOADED TOUR SELECT_STATION RESET SYNC_STATIONS TOUR_3D_UPDATED LEARN_ROUND_COMPLETE)
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on ROSTER_LOADED) (idle -> idle on ROSTER_LOADED) (idle -> idle on TOUR) (idle -> idle on SELECT_STATION) (idle -> idle on RESET) (idle -> idle on SYNC_STATIONS))
   emits          : (TOUR_3D_UPDATED LEARN_ROUND_COMPLETE)
   config {
     azimuth        : number = 0.6 @label "Azimuth" @description "Camera orbit azimuth in radians; the learner can orbit freely on top of this." @tier "presentation"
@@ -22299,6 +22782,7 @@ trait std-learn-tour-3d.traits.Learn3DTourSim {
     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." @tier "presentation"
     post           : Post3D = {} @label "Post Processing" @description "3D post-processing stack (bloom/vignette) as data; empty object disables it." @tier "presentation"
     resetLabel     : string = "Reset" @label "Reset Button Label" @description "Label text for the button that returns the tour to the first station." @tier "presentation"
+    rosterSource   : string = "config" @label "Roster Source" @description "Where the stations, edges and backdrop come from: config reads those knobs at INIT; event waits for ROSTER_LOADED and takes them from its payload." @tier "domain" @values (config event)
     stations       : [Learn3DStation] = [{"caption":"The first stop on the tour — the camera retargets here and the narration reads its caption.","color":"series-1","id":"alpha","name":"Station Alpha","opacity":1,"radius":1,"shape":"sphere","x":0,"y":0,"z":0},{"caption":"The second stop — press Tour again or click a shape to advance the selection.","color":"series-2","id":"beta","name":"Station Beta","opacity":1,"radius":0.8,"shape":"sphere","x":3,"y":1,"z":-1},{"caption":"The final stop — once every station has been visited the tour marks itself complete.","color":"series-3","id":"gamma","name":"Station Gamma","opacity":1,"radius":0.8,"shape":"sphere","x":-3,"y":-1,"z":1}] @label "Stations" @description "The station roster in didactic tour order — each with scene position, mesh shape, and a caption. Tour and clicks enlarge the selected station, retarget the camera onto its x/y/z, and narrate its caption." @synonyms "station, stop, waypoint, tour, landmark, 3d" @tier "domain"
     summary        : string = "" @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"
     title          : string = "3D Guided Tour" @label "Title" @description "Title shown above the canvas." @tier "presentation"
@@ -22316,8 +22800,8 @@ trait std-learn-trace-player.traits.TracePlayerSim {
   linkedEntity   : TracePlayerScene
   category       : interaction
   states         : (idle*)
-  events         : (INIT MODE_SELECTED TOGGLE_RUN SPEED_SET PLAY PAUSE RESTART FRAME_ADVANCED TRACE_DONE)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on TOGGLE_RUN) (idle -> idle on SPEED_SET) (idle -> idle on PLAY) (idle -> idle on PAUSE) (idle -> idle on RESTART))
+  events         : (INIT MODE_SELECTED ROSTER_LOADED TOGGLE_RUN SPEED_SET PLAY PAUSE RESTART FRAME_ADVANCED TRACE_DONE)
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on ROSTER_LOADED) (idle -> idle on ROSTER_LOADED) (idle -> idle on TOGGLE_RUN) (idle -> idle on SPEED_SET) (idle -> idle on PLAY) (idle -> idle on PAUSE) (idle -> idle on RESTART))
   emits          : (FRAME_ADVANCED TRACE_DONE)
   config {
     backgroundColor : string = "" @label "Background Color" @description "Canvas ground override; empty uses the theme's drawing ground." @tier "presentation"
@@ -22327,6 +22811,7 @@ trait std-learn-trace-player.traits.TracePlayerSim {
     highlightColor : string = "highlight" @label "Highlight Bar Color" @description "Color of bars whose index appears in the current frame's highlights." @tier "presentation"
     loop           : boolean = false @label "Loop" @description "When true, autoplay wraps from the last frame back to the first instead of stopping and emitting TRACE_DONE." @tier "domain"
     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." @tier "presentation"
+    rosterSource   : string = "config" @label "Roster Source" @description "Where the frame roster comes from: config reads the frames knob at INIT; event waits for ROSTER_LOADED and takes the roster from its payload." @tier "domain" @values (config event)
     summary        : string = "" @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"
     tickMs         : number = 500 @label "Tick Milliseconds" @description "Milliseconds per frame shown in the readout; the autoplay cadence." @tier "presentation"
     title          : string = "Trace Player" @label "Title" @description "The instrument's name, the header's one hero." @tier "presentation"
@@ -22350,7 +22835,7 @@ trait std-learn-transport.traits.LearnTransportSim {
     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." @tier "presentation"
     stepIntervalMs : number = 500 @label "Step Interval (ms)" @description "Milliseconds of running clock per domain step — the 32ms base tick accumulates elapsed time and fires LEARN_STEP each time this interval elapses. 300-900 suits narrated steppers; 32 fires every frame for continuous sims." @tier "domain"
     summary        : string = "" @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"
-    title          : string = "Learning Instrument" @label "Title" @description "The instrument's name, the header's one hero." @tier "presentation"
+    title          : string = "Learning Instrument" @label "Title" @description "The instrument's name, the header's one hero. Empty shows no title." @tier "presentation"
     totalSteps     : int = 0 @label "Total Steps" @description "When the walk has a known length, the step counter reads 'Step N of M'. 0 means open-ended." @tier "presentation"
   }
   override-surface : (linkedEntity name events effects listens emitsScope config)
@@ -22363,8 +22848,8 @@ trait std-learn-tree.traits.LearnTreeSim {
   linkedEntity   : LearnTreeScene
   category       : interaction
   states         : (idle*)
-  events         : (INIT MODE_SELECTED INSERT_VALUE DELETE_VALUE RUN_TRAVERSAL TOGGLE_RUN RESET TREE_UPDATED)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on INSERT_VALUE) (idle -> idle on DELETE_VALUE) (idle -> idle on RUN_TRAVERSAL) (idle -> idle on TOGGLE_RUN) (idle -> idle on RESET))
+  events         : (INIT MODE_SELECTED ROSTER_LOADED INSERT_VALUE DELETE_VALUE RUN_TRAVERSAL TOGGLE_RUN RESET TREE_UPDATED)
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on ROSTER_LOADED) (idle -> idle on ROSTER_LOADED) (idle -> idle on INSERT_VALUE) (idle -> idle on DELETE_VALUE) (idle -> idle on RUN_TRAVERSAL) (idle -> idle on TOGGLE_RUN) (idle -> idle on RESET))
   emits          : (TREE_UPDATED)
   config {
     autoRun        : boolean = false @label "Auto Run" @description "When true, the tick auto-steps the traversal sweep started by Traverse; toggle live with the Run/Pause button. Has no effect on Insert/Delete, which stay manual." @synonyms "auto run, auto step, auto play" @tier "domain"
@@ -22372,6 +22857,7 @@ trait std-learn-tree.traits.LearnTreeSim {
     balanced       : boolean = false @label "Balance Readout" @description "When true, each insert's narration reports the tree's current height against its node count so the learner can judge balance; no auto-rotation is performed." @synonyms "balance, height, balance readout" @tier "domain"
     height         : number = 400 @label "Height" @description "Canvas height in pixels." @tier "presentation"
     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." @tier "presentation"
+    rosterSource   : string = "config" @label "Roster Source" @description "Where the insertion values come from: config reads the values knob at INIT; event waits for ROSTER_LOADED and takes them from its payload." @tier "domain" @values (config event)
     showComparisons : boolean = true @label "Show Comparisons" @description "Include each left/right comparison in the narration while a value descends; turn off for a terse attach-only narration." @synonyms "comparisons, narration detail" @tier "presentation"
     summary        : string = "" @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"
     title          : string = "Ordered Tree" @label "Title" @description "Title shown above the canvas." @tier "presentation"
@@ -22969,6 +23455,81 @@ trait std-pad-lock.traits.PadLock {
   source         : "@almadar/std (behaviors/registry/ui/game/atoms/std-pad-lock.orb orbitals[0].traits[0])"
 }
 
+;; From @almadar/std (behaviors/registry/infra/atoms/std-page-open.orb orbitals[0].traits[0])
+trait std-page-open.traits.PageOpen {
+  alias          : PageOpen
+  linkedEntity   : PageOpenRecord
+  category       : interaction
+  states         : (ready*)
+  events         : (INIT OPEN TAB_OPENED OPEN_CALL_FAILED OPENED OPEN_FAILED)
+  transitions    : ((ready -> ready on INIT) (ready -> ready on OPEN) (ready -> ready on TAB_OPENED) (ready -> ready on OPEN_CALL_FAILED))
+  emits          : (TAB_OPENED OPEN_CALL_FAILED OPENED OPEN_FAILED)
+  config {
+    statusSlot     : slot = "main" @label "Status slot" @description "Where the atom shows its one-line status; an organism running it in the background sends it to `system`" @synonyms "status area, slot" @tier "presentation"
+  }
+  override-surface : (linkedEntity name events effects listens emitsScope config)
+  source         : "@almadar/std (behaviors/registry/infra/atoms/std-page-open.orb orbitals[0].traits[0])"
+}
+
+;; From @almadar/std (behaviors/registry/infra/atoms/std-page-search.orb orbitals[0].traits[0])
+trait std-page-search.traits.PageSearch {
+  alias          : PageSearch
+  linkedEntity   : PageSearchRecord
+  category       : interaction
+  states         : (idle* searching)
+  events         : (INIT SEARCH TAB_OPENED RESULTS_READ SEARCH_CALL_FAILED RESULTS SEARCH_FAILED)
+  transitions    : ((idle -> idle on INIT) (idle -> searching on SEARCH) (searching -> searching on INIT) (searching -> searching on TAB_OPENED) (searching -> idle on RESULTS_READ) (searching -> idle on SEARCH_CALL_FAILED) (searching -> idle on SEARCH_CALL_FAILED))
+  emits          : (TAB_OPENED RESULTS_READ SEARCH_CALL_FAILED RESULTS SEARCH_FAILED)
+  config {
+    fields         : Map<string,PageField> = {} @label "Fields" @description "Field name to how to read it from each result: `selector` (a descendant; absent reads the result itself), `attr` (an attribute; absent reads the text) , `resolve` (the value is a URL: return it absolute), `template` (compose the value from other fields, `{name}` per field; empty when any is empty) and `required` (leave the result out until this field reads non-empty)" @synonyms "columns, properties, extract" @tier "domain"
+    maxResults     : number = 10 @label "Results per search" @description "Most results read from one search" @synonyms "limit, count, how many" @tier "policy"
+    queryParam     : string = "q" @label "Query parameter" @description "Name of the URL parameter that carries the search terms" @synonyms "query key, search parameter" @tier "domain"
+    resultSelector : string = ".result" @label "Result selector" @description "CSS selector of one result on the results page" @synonyms "result, item, card, tile" @tier "domain"
+    resultsMatch   : string = "https://example.com/search*" @label "Results pages" @description "URL match pattern the results page lies in (Chrome match-pattern syntax); the search page must match it, and the extension asks for access to exactly these pages" @synonyms "site, url pattern, results url" @tier "domain"
+    searchUrl      : string = "https://example.com/search" @label "Search page" @description "URL of the site's search results page, without the query" @synonyms "search url, results page, endpoint" @tier "domain"
+    statusSlot     : slot = "main" @label "Status slot" @description "Where the atom shows its one-line status; an organism running it in the background sends it to `system`" @synonyms "status area, slot" @tier "presentation"
+    waitMs         : number = 8000 @label "Wait for results (ms)" @description "How long to wait for the results page to load and its first result to appear" @synonyms "timeout, wait, patience" @tier "infra"
+  }
+  override-surface : (linkedEntity name events effects listens emitsScope config)
+  source         : "@almadar/std (behaviors/registry/infra/atoms/std-page-search.orb orbitals[0].traits[0])"
+}
+
+;; From @almadar/std (behaviors/registry/infra/atoms/std-page-treat.orb orbitals[0].traits[0])
+trait std-page-treat.traits.PageTreat {
+  alias          : PageTreat
+  linkedEntity   : PageTreatRecord
+  category       : interaction
+  states         : (ready*)
+  events         : (INIT TREAT APPLIED TREAT_MANY APPLIED_MANY APPLY_FAILED TREATED TREATED_MANY TREAT_FAILED)
+  transitions    : ((ready -> ready on INIT) (ready -> ready on TREAT) (ready -> ready on APPLIED) (ready -> ready on TREAT_MANY) (ready -> ready on APPLIED_MANY) (ready -> ready on APPLY_FAILED))
+  emits          : (APPLIED APPLIED_MANY APPLY_FAILED TREATED TREATED_MANY TREAT_FAILED)
+  config {
+    statusSlot     : slot = "main" @label "Status slot" @description "Where the atom shows its one-line status; an organism running it in the background sends it to `system`" @synonyms "status area, slot" @tier "presentation"
+  }
+  override-surface : (linkedEntity name events effects listens emitsScope config)
+  source         : "@almadar/std (behaviors/registry/infra/atoms/std-page-treat.orb orbitals[0].traits[0])"
+}
+
+;; From @almadar/std (behaviors/registry/infra/atoms/std-page-watch.orb orbitals[0].traits[0])
+trait std-page-watch.traits.PageWatch {
+  alias          : PageWatch
+  linkedEntity   : PageWatchRecord
+  category       : lifecycle
+  states         : (active*)
+  events         : (INIT WATCHING WATCH_FAILED ITEM_FOUND ITEM)
+  transitions    : ((active -> active on INIT) (active -> active on WATCHING) (active -> active on WATCH_FAILED) (active -> active on ITEM_FOUND))
+  emits          : (WATCHING WATCH_FAILED ITEM)
+  config {
+    fields         : Map<string,PageField> = {} @label "Fields" @description "Field name to how to read it from each element: `selector` (a descendant; absent reads the element itself), `attr` (an attribute; absent reads the text) , `resolve` (the value is a URL: return it absolute), `template` (compose the value from other fields, `{name}` per field; empty when any is empty) and `required` (leave the element out until this field reads non-empty — a placeholder is reported once it fills in)" @synonyms "columns, properties, extract, read" @tier "domain"
+    itemEvent      : event = "PageWatch.ITEM_FOUND" @label "Item input" @description "The declared input each element arrives as; it follows the trait when a composer renames it" @tier "internal"
+    itemSelector   : string = ".item" @label "Item selector" @description "CSS selector of the elements to report" @synonyms "selector, element, card, tile, row" @tier "domain"
+    match          : string = "https://example.com/*" @label "Pages" @description "URL match pattern of the tabs to watch, in Chrome match-pattern syntax (`<scheme>://<host>/<path>` with `*` wildcards)" @synonyms "site, url pattern, pages, domain" @tier "domain"
+    statusSlot     : slot = "main" @label "Status slot" @description "Where the atom shows its one-line status; an organism running it in the background sends it to `system`" @synonyms "status area, slot" @tier "presentation"
+  }
+  override-surface : (linkedEntity name events effects listens emitsScope config)
+  source         : "@almadar/std (behaviors/registry/infra/atoms/std-page-watch.orb orbitals[0].traits[0])"
+}
+
 ;; From @almadar/std (behaviors/registry/ui/core/atoms/std-pagination.orb orbitals[0].traits[0])
 trait std-pagination.traits.PagedItemPagination {
   alias          : Pagination
@@ -24599,6 +25160,7 @@ trait ui-avl-state-machine.traits.AvlStateMachineRender {
   config {
     activeState    : string @label "Active State" @description "State execution is currently in." @tier "presentation"
     activeTransition : number @label "Active Transition" @description "`index` of the transition that just fired." @tier "presentation"
+    annotations    : AvlStateMachineAnnotations = {"effects":{"persist":{"body":"Saves the order."}},"states":{"pending":{"body":"Every order starts here.","title":"Unpaid"}},"transitions":{"PAY":{"body":"Only fires when the amount is positive."}}} @label "Annotations" @description "Author explanations shown in a popover on hover: a note per state name, per transition event and per effect type." @tier "presentation"
     ariaBusy       : boolean @label "Aria-busy" @description "This region is updating; assistive technology waits before announcing it." @synonyms "aria-busy" @tier "presentation"
     ariaCurrent    : string @label "Aria-current" @description "Marks the current item in a set: the current page, step, location, date or time." @synonyms "aria-current" @tier "presentation" @values (page step location date time true false)
     ariaDescribedby : string @label "Aria-describedby" @description "Id of the element whose text describes this one (help text, error)." @synonyms "aria-describedby" @tier "presentation"
@@ -24633,6 +25195,42 @@ trait ui-avl-state-machine.traits.AvlStateMachineRender {
   source         : "@almadar/std (behaviors/registry/ui/avl/atoms/ui-avl-state-machine.orb orbitals[0].traits[0])"
 }
 
+;; From @almadar/std (behaviors/registry/ui/avl/atoms/ui-avl-transition-explainer.orb orbitals[0].traits[0])
+trait ui-avl-transition-explainer.traits.AvlTransitionExplainerRender {
+  alias          : UiAvlTransitionExplainer
+  linkedEntity   : AvlTransitionExplainerItem
+  category       : interaction
+  states         : (idle*)
+  events         : (INIT)
+  transitions    : ((idle -> idle on INIT))
+  config {
+    annotations    : AvlTransitionExplainerAnnotations = {"effects":{"persist":{"body":"Saves the order."}},"transitions":{"PAY":{"body":"The customer pays the order total.","title":"Paying"}}} @label "Annotations" @description "Author explanations shown in a popover on hover: the event's note and per-effect-type notes." @tier "presentation"
+    ariaBusy       : boolean @label "Aria-busy" @description "This region is updating; assistive technology waits before announcing it." @synonyms "aria-busy" @tier "presentation"
+    ariaCurrent    : string @label "Aria-current" @description "Marks the current item in a set: the current page, step, location, date or time." @synonyms "aria-current" @tier "presentation" @values (page step location date time true false)
+    ariaDescribedby : string @label "Aria-describedby" @description "Id of the element whose text describes this one (help text, error)." @synonyms "aria-describedby" @tier "presentation"
+    ariaExpanded   : boolean @label "Aria-expanded" @description "Whether the element it controls is expanded." @synonyms "aria-expanded" @tier "presentation"
+    ariaHidden     : boolean @label "Aria-hidden" @description "Hide from assistive technology (decorative content only)." @synonyms "aria-hidden" @tier "presentation"
+    ariaLabel      : string @label "Aria-label" @description "Accessible name read by screen readers when the visible text is missing or not descriptive (e.g. an icon-only control)." @synonyms "aria-label" @tier "presentation"
+    ariaLabelledby : string @label "Aria-labelledby" @description "Id of the element whose text names this one." @synonyms "aria-labelledby" @tier "presentation"
+    ariaLive       : string @label "Aria-live" @description "Announce changes to this region: polite waits for a pause, assertive interrupts." @synonyms "aria-live" @tier "presentation" @values (off polite assertive)
+    ariaPressed    : string @label "Aria-pressed" @description "Toggle-button state." @synonyms "aria-pressed" @tier "presentation" @values (true false mixed)
+    ariaSelected   : boolean @label "Aria-selected" @description "Whether this item is selected (tabs, options, grid cells)." @synonyms "aria-selected" @tier "presentation"
+    className      : string @label "Class Name" @description "className prop" @tier "presentation"
+    dir            : string @label "Dir" @description "Text direction of this element's content." @tier "presentation" @values (ltr rtl auto)
+    enter          : string @label "Enter" @description "How this element animates in when it mounts (theme-styled); overrides the theme's default slot entry. `none` opts out." @tier "presentation" @values (none fade rise scale slide)
+    enterDelay     : number @label "Enter Delay" @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating." @tier "presentation"
+    lang           : string @label "Lang" @description "Language of this element's content (BCP 47, e.g. ar, sl, en)." @tier "presentation"
+    orbitalName    : string = "" @label "Orbital Name" @description "Orbital the transition belongs to." @tier "presentation"
+    role           : string @label "Role" @description "WAI-ARIA role when the element's native semantics don't describe it." @tier "presentation" @values (alert alertdialog application article banner blockquote button caption cell checkbox code columnheader combobox complementary contentinfo definition deletion dialog document emphasis feed figure form generic grid gridcell group heading img insertion link list listbox listitem log main marquee math menu menubar menuitem menuitemcheckbox menuitemradio meter navigation none note option paragraph presentation progressbar radio radiogroup region row rowgroup rowheader scrollbar search searchbox separator slider spinbutton status strong subscript superscript switch tab table tablist tabpanel term textbox time timer toolbar tooltip tree treegrid treeitem)
+    skeleton       : string @label "Skeleton" @description "Skeleton shown while this element's server render is in flight: a shape (`table`, `list`, …), `{ variant, rows?, columns?, fields? }`, or `none`." @tier "presentation" @values (header table list grid detail stats form card text none)
+    tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
+    traitName      : string = "" @label "Trait Name" @description "Trait the transition belongs to." @tier "presentation"
+    transition     : AvlTransitionExplainerTransition = {"effects":[{"args":[],"type":"set"},{"args":[],"type":"persist"}],"event":"PAY","from":"pending","index":0,"to":"paid"} @label "Transition" @description "The transition to explain." @tier "presentation"
+  }
+  override-surface : (linkedEntity name events effects listens emitsScope config)
+  source         : "@almadar/std (behaviors/registry/ui/avl/atoms/ui-avl-transition-explainer.orb orbitals[0].traits[0])"
+}
+
 ;; From @almadar/std (behaviors/registry/ui/core/atoms/ui-badge.orb orbitals[0].traits[0])
 trait ui-badge.traits.BadgeRender {
   alias          : UiBadge
@@ -26440,6 +27038,7 @@ trait ui-module-card.traits.ModuleCardRender {
   events         : (INIT)
   transitions    : ((idle -> idle on INIT))
   config {
+    annotations    : Map<string,ModuleCardAnnotationsValue> = {"item":{}} @label "Annotations" @description "Author explanations per trait name (states, transition events, effect types), shown in a popover on hover." @tier "presentation"
     ariaBusy       : boolean @label "Aria-busy" @description "This region is updating; assistive technology waits before announcing it." @synonyms "aria-busy" @tier "presentation"
     ariaCurrent    : string @label "Aria-current" @description "Marks the current item in a set: the current page, step, location, date or time." @synonyms "aria-current" @tier "presentation" @values (page step location date time true false)
     ariaDescribedby : string @label "Aria-describedby" @description "Id of the element whose text describes this one (help text, error)." @synonyms "aria-describedby" @tier "presentation"
@@ -28240,6 +28839,15 @@ page std-agent-planner.pages.AgentPlannerPage {
   source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-planner.orb orbitals[0].pages[0])"
 }
 
+;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-proposal.orb orbitals[0].pages[0])
+page std-agent-proposal.pages.AgentProposalPage {
+  alias          : AgentProposal
+  defaultPath    : /agent-proposal
+  traits         : (AgentProposalWorkflow AgentProposalLoop)
+  override-surface : (path linkedEntity traits)
+  source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-proposal.orb orbitals[0].pages[0])"
+}
+
 ;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-session.orb orbitals[1].pages[0])
 page std-agent-session.pages.AgentChatsPage {
   alias          : AgentSession
@@ -28258,6 +28866,24 @@ page std-agent-session.pages.AgentSessionPage {
   source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-session.orb orbitals[0].pages[0])"
 }
 
+;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-suggestions.orb orbitals[1].pages[0])
+page std-agent-suggestions.pages.AgentSuggestionHistoryPage {
+  alias          : AgentSuggestions
+  defaultPath    : /agent-suggestions/history
+  traits         : (AgentSuggestionHistory)
+  override-surface : (path linkedEntity traits)
+  source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-suggestions.orb orbitals[1].pages[0])"
+}
+
+;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-suggestions.orb orbitals[0].pages[0])
+page std-agent-suggestions.pages.AgentSuggestionsPage {
+  alias          : AgentSuggestions
+  defaultPath    : /agent-suggestions
+  traits         : (AgentSuggestionInbox AgentSuggestionProposer AgentSuggestionTrigger AgentSuggestionRunner AgentSuggestionLoop)
+  override-surface : (path linkedEntity traits)
+  source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-suggestions.orb orbitals[0].pages[0])"
+}
+
 ;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-tool-call.orb orbitals[0].pages[0])
 page std-agent-tool-call.pages.AgentToolCallPage {
   alias          : AgentToolCall
@@ -28582,6 +29208,15 @@ page std-detail-layout.pages.DetailLayoutPage {
   source         : "@almadar/std (behaviors/registry/ui/core/atoms/std-detail-layout.orb orbitals[0].pages[0])"
 }
 
+;; From @almadar/std (behaviors/registry/ui/core/atoms/std-doc-page.orb orbitals[0].pages[0])
+page std-doc-page.pages.DocPage {
+  alias          : DocPage
+  defaultPath    : /doc
+  traits         : (DocPageRender)
+  override-surface : (path linkedEntity traits)
+  source         : "@almadar/std (behaviors/registry/ui/core/atoms/std-doc-page.orb orbitals[0].pages[0])"
+}
+
 ;; From @almadar/std (behaviors/registry/ui/game/atoms/std-dungeon-combat.orb orbitals[0].pages[0])
 page std-dungeon-combat.pages.DungeonCombatPage {
   alias          : DungeonCombat
@@ -29348,6 +29983,42 @@ page std-pad-lock.pages.PadLockPage {
   source         : "@almadar/std (behaviors/registry/ui/game/atoms/std-pad-lock.orb orbitals[0].pages[0])"
 }
 
+;; From @almadar/std (behaviors/registry/infra/atoms/std-page-open.orb orbitals[0].pages[0])
+page std-page-open.pages.PageOpenPage {
+  alias          : PageOpen
+  defaultPath    : /page-open
+  traits         : (PageOpen)
+  override-surface : (path linkedEntity traits)
+  source         : "@almadar/std (behaviors/registry/infra/atoms/std-page-open.orb orbitals[0].pages[0])"
+}
+
+;; From @almadar/std (behaviors/registry/infra/atoms/std-page-search.orb orbitals[0].pages[0])
+page std-page-search.pages.PageSearchPage {
+  alias          : PageSearch
+  defaultPath    : /page-search
+  traits         : (PageSearch)
+  override-surface : (path linkedEntity traits)
+  source         : "@almadar/std (behaviors/registry/infra/atoms/std-page-search.orb orbitals[0].pages[0])"
+}
+
+;; From @almadar/std (behaviors/registry/infra/atoms/std-page-treat.orb orbitals[0].pages[0])
+page std-page-treat.pages.PageTreatPage {
+  alias          : PageTreat
+  defaultPath    : /page-treat
+  traits         : (PageTreat)
+  override-surface : (path linkedEntity traits)
+  source         : "@almadar/std (behaviors/registry/infra/atoms/std-page-treat.orb orbitals[0].pages[0])"
+}
+
+;; From @almadar/std (behaviors/registry/infra/atoms/std-page-watch.orb orbitals[0].pages[0])
+page std-page-watch.pages.PageWatchPage {
+  alias          : PageWatch
+  defaultPath    : /page-watch
+  traits         : (PageWatch)
+  override-surface : (path linkedEntity traits)
+  source         : "@almadar/std (behaviors/registry/infra/atoms/std-page-watch.orb orbitals[0].pages[0])"
+}
+
 ;; From @almadar/std (behaviors/registry/ui/core/atoms/std-pagination.orb orbitals[0].pages[0])
 page std-pagination.pages.PagedItemPaginationPage {
   alias          : Pagination
@@ -29933,6 +30604,15 @@ page ui-avl-state-machine.pages.AvlStateMachinePage {
   source         : "@almadar/std (behaviors/registry/ui/avl/atoms/ui-avl-state-machine.orb orbitals[0].pages[0])"
 }
 
+;; From @almadar/std (behaviors/registry/ui/avl/atoms/ui-avl-transition-explainer.orb orbitals[0].pages[0])
+page ui-avl-transition-explainer.pages.AvlTransitionExplainerPage {
+  alias          : UiAvlTransitionExplainer
+  defaultPath    : /avl-transition-explainer
+  traits         : (AvlTransitionExplainerRender)
+  override-surface : (path linkedEntity traits)
+  source         : "@almadar/std (behaviors/registry/ui/avl/atoms/ui-avl-transition-explainer.orb orbitals[0].pages[0])"
+}
+
 ;; From @almadar/std (behaviors/registry/ui/core/atoms/ui-badge.orb orbitals[0].pages[0])
 page ui-badge.pages.BadgePage {
   alias          : UiBadge
@@ -35402,6 +36082,7 @@ trait ui-data-list.traits.DataListRender {
     fields         : [DataListFieldsItem] = [] @label "Fields" @description "Field definitions for rendering each row. The pattern contract in `@almadar/core/patterns` documents `columns` as the wire-format alias the compiler emits — both names resolve to the same shape here. Pass either." @tier "presentation"
     gap            : string = "none" @label "Gap" @description "Gap between rows" @tier "presentation" @values (none sm md lg)
     groupBy        : string @label "Group By" @description "Group items by a field value (renders section headers between groups)" @tier "presentation"
+    groupFormat    : string @label "Group Format" @description "How a `groupBy` value is bucketed and labelled (`date` = one section per day)" @tier "presentation" @values (date time datetime currency number boolean percent)
     hasMore        : boolean @label "Has More" @description "Whether more items are available for infinite scroll" @tier "presentation"
     infiniteScroll : boolean @label "Infinite Scroll" @description "Enable infinite scroll loading" @tier "presentation"
     isLoading      : boolean = false @label "Is Loading" @description "Loading state" @tier "presentation"
@@ -37302,9 +37983,12 @@ trait ui-markdown-content.traits.MarkdownContentRender {
   linkedEntity   : MarkdownContentItem
   category       : interaction
   states         : (idle*)
-  events         : (INIT)
+  events         : (INIT @config.askEvent @config.noteEvent @config.annotationEvent)
   transitions    : ((idle -> idle on INIT))
+  emits          : (@config.askEvent @config.noteEvent @config.annotationEvent)
   config {
+    annotationEvent : event = "ANNOTATION" @label "Annotation Event" @description "Event emitted when a highlighted passage is clicked (as `UI:<annotationEvent>`)" @tier "presentation"
+    annotations    : [MarkdownContentAnnotationsItem] = [] @label "Annotations" @description "Passages to highlight. Each `text` is matched exactly, first occurrence in document order inside a single rendered text node (outside code); a passage that spans formatting boundaries is not highlighted." @tier "presentation"
     ariaBusy       : boolean @label "Aria-busy" @description "This region is updating; assistive technology waits before announcing it." @synonyms "aria-busy" @tier "presentation"
     ariaCurrent    : string @label "Aria-current" @description "Marks the current item in a set: the current page, step, location, date or time." @synonyms "aria-current" @tier "presentation" @values (page step location date time true false)
     ariaDescribedby : string @label "Aria-describedby" @description "Id of the element whose text describes this one (help text, error)." @synonyms "aria-describedby" @tier "presentation"
@@ -37315,6 +37999,8 @@ trait ui-markdown-content.traits.MarkdownContentRender {
     ariaLive       : string @label "Aria-live" @description "Announce changes to this region: polite waits for a pause, assertive interrupts." @synonyms "aria-live" @tier "presentation" @values (off polite assertive)
     ariaPressed    : string @label "Aria-pressed" @description "Toggle-button state." @synonyms "aria-pressed" @tier "presentation" @values (true false mixed)
     ariaSelected   : boolean @label "Aria-selected" @description "Whether this item is selected (tabs, options, grid cells)." @synonyms "aria-selected" @tier "presentation"
+    askEvent       : event = "ASK" @label "Ask Event" @description "Event emitted when the reader picks Ask on selected text (as `UI:<askEvent>`)" @tier "presentation"
+    askLabel       : string @label "Ask Label" @description "Ask action label (default: translated)" @tier "presentation"
     className      : string @label "Class Name" @description "Additional CSS classes" @tier "presentation"
     content        : string = "" @label "Content" @description "The markdown content to render" @tier "presentation"
     dir            : string @label "Dir" @description "Text direction of this element's content." @tier "presentation" @values (ltr rtl auto)
@@ -37322,6 +38008,8 @@ trait ui-markdown-content.traits.MarkdownContentRender {
     enter          : string @label "Enter" @description "How this element animates in when it mounts (theme-styled); overrides the theme's default slot entry. `none` opts out." @tier "presentation" @values (none fade rise scale slide)
     enterDelay     : number @label "Enter Delay" @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating." @tier "presentation"
     lang           : string @label "Lang" @description "Language of this element's content (BCP 47, e.g. ar, sl, en)." @tier "presentation"
+    noteEvent      : event = "NOTE" @label "Note Event" @description "Event emitted when the reader picks Note on selected text (as `UI:<noteEvent>`)" @tier "presentation"
+    noteLabel      : string @label "Note Label" @description "Note action label (default: translated)" @tier "presentation"
     role           : string @label "Role" @description "WAI-ARIA role when the element's native semantics don't describe it." @tier "presentation" @values (alert alertdialog application article banner blockquote button caption cell checkbox code columnheader combobox complementary contentinfo definition deletion dialog document emphasis feed figure form generic grid gridcell group heading img insertion link list listbox listitem log main marquee math menu menubar menuitem menuitemcheckbox menuitemradio meter navigation none note option paragraph presentation progressbar radio radiogroup region row rowgroup rowheader scrollbar search searchbox separator slider spinbutton status strong subscript superscript switch tab table tablist tabpanel term textbox time timer toolbar tooltip tree treegrid treeitem)
     skeleton       : string @label "Skeleton" @description "Skeleton shown while this element's server render is in flight: a shape (`table`, `list`, …), `{ variant, rows?, columns?, fields? }`, or `none`." @tier "presentation" @values (header table list grid detail stats form card text none)
     tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
@@ -39111,6 +39799,7 @@ trait ui-upload-drop-zone.traits.UploadDropZoneRender {
     lang           : string @label "Lang" @description "Language of this element's content (BCP 47, e.g. ar, sl, en)." @tier "presentation"
     maxFiles       : number = 1 @label "Max Files" @description "Max number of files" @tier "presentation"
     maxSize        : number @label "Max Size" @description "Max file size in bytes" @tier "presentation"
+    readAs         : string = "dataUrl" @label "Read As" @description "How the file is read into `content`: a base64 data URL (default) or its UTF-8 text" @tier "presentation" @values (dataUrl text)
     role           : string @label "Role" @description "WAI-ARIA role when the element's native semantics don't describe it." @tier "presentation" @values (alert alertdialog application article banner blockquote button caption cell checkbox code columnheader combobox complementary contentinfo definition deletion dialog document emphasis feed figure form generic grid gridcell group heading img insertion link list listbox listitem log main marquee math menu menubar menuitem menuitemcheckbox menuitemradio meter navigation none note option paragraph presentation progressbar radio radiogroup region row rowgroup rowheader scrollbar search searchbox separator slider spinbutton status strong subscript superscript switch tab table tablist tabpanel term textbox time timer toolbar tooltip tree treegrid treeitem)
     skeleton       : string @label "Skeleton" @description "Skeleton shown while this element's server render is in flight: a shape (`table`, `list`, …), `{ variant, rows?, columns?, fields? }`, or `none`." @tier "presentation" @values (header table list grid detail stats form card text none)
     tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
@@ -42560,9 +43249,13 @@ trait ui-segment-renderer.traits.SegmentRendererRender {
   linkedEntity   : SegmentRendererItem
   category       : interaction
   states         : (idle*)
-  events         : (INIT)
+  events         : (INIT @config.activationSaveEvent @config.reflectionSaveEvent @config.bloomAnswerEvent @config.askEvent @config.noteEvent @config.annotationEvent)
   transitions    : ((idle -> idle on INIT))
+  emits          : (@config.activationSaveEvent @config.reflectionSaveEvent @config.bloomAnswerEvent @config.askEvent @config.noteEvent @config.annotationEvent)
   config {
+    activationSaveEvent : event = "ACTIVATION_SAVE" @label "Activation Save Event" @description "Event emitted when the activation prompt is saved or skipped (as `UI:<activationSaveEvent>`)" @tier "presentation"
+    annotationEvent : event = "ANNOTATION" @label "Annotation Event" @description "Event emitted when a highlighted passage is clicked (as `UI:<annotationEvent>`)" @tier "presentation"
+    annotations    : [SegmentRendererAnnotationsItem] = [] @label "Annotations" @description "Passages to highlight. Each `text` is matched exactly against the markdown segments, first segment whose source contains it, first occurrence inside one rendered text node (outside code); one that spans formatting is not highlighted." @tier "presentation"
     ariaBusy       : boolean @label "Aria-busy" @description "This region is updating; assistive technology waits before announcing it." @synonyms "aria-busy" @tier "presentation"
     ariaCurrent    : string @label "Aria-current" @description "Marks the current item in a set: the current page, step, location, date or time." @synonyms "aria-current" @tier "presentation" @values (page step location date time true false)
     ariaDescribedby : string @label "Aria-describedby" @description "Id of the element whose text describes this one (help text, error)." @synonyms "aria-describedby" @tier "presentation"
@@ -42573,14 +43266,21 @@ trait ui-segment-renderer.traits.SegmentRendererRender {
     ariaLive       : string @label "Aria-live" @description "Announce changes to this region: polite waits for a pause, assertive interrupts." @synonyms "aria-live" @tier "presentation" @values (off polite assertive)
     ariaPressed    : string @label "Aria-pressed" @description "Toggle-button state." @synonyms "aria-pressed" @tier "presentation" @values (true false mixed)
     ariaSelected   : boolean @label "Aria-selected" @description "Whether this item is selected (tabs, options, grid cells)." @synonyms "aria-selected" @tier "presentation"
+    askEvent       : event = "ASK" @label "Ask Event" @description "Event emitted when the reader picks Ask on selected text (as `UI:<askEvent>`)" @tier "presentation"
+    askLabel       : string @label "Ask Label" @description "Ask action label (default: translated)" @tier "presentation"
+    bloomAnswerEvent : event = "BLOOM_ANSWER" @label "Bloom Answer Event" @description "Event emitted on the first reveal of a Bloom question (as `UI:<bloomAnswerEvent>`)" @tier "presentation"
     className      : string @label "Class Name" @description "Additional CSS classes for the root container" @tier "presentation"
     containerClassName : string @label "Container Class Name" @description "CSS classes for the outer wrapping div" @tier "presentation"
     dir            : string @label "Dir" @description "Text direction of this element's content." @tier "presentation" @values (ltr rtl auto)
     enter          : string @label "Enter" @description "How this element animates in when it mounts (theme-styled); overrides the theme's default slot entry. `none` opts out." @tier "presentation" @values (none fade rise scale slide)
     enterDelay     : number @label "Enter Delay" @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating." @tier "presentation"
     lang           : string @label "Lang" @description "Language of this element's content (BCP 47, e.g. ar, sl, en)." @tier "presentation"
+    lesson         : string @label "Lesson" @description "Raw lesson markdown with learning tags; parsed with `parseLessonSegments` and rendered" @tier "presentation"
+    noteEvent      : event = "NOTE" @label "Note Event" @description "Event emitted when the reader picks Note on selected text (as `UI:<noteEvent>`)" @tier "presentation"
+    noteLabel      : string @label "Note Label" @description "Note action label (default: translated)" @tier "presentation"
+    reflectionSaveEvent : event = "REFLECTION_SAVE" @label "Reflection Save Event" @description "Event emitted when a reflection note is saved (as `UI:<reflectionSaveEvent>`)" @tier "presentation"
     role           : string @label "Role" @description "WAI-ARIA role when the element's native semantics don't describe it." @tier "presentation" @values (alert alertdialog application article banner blockquote button caption cell checkbox code columnheader combobox complementary contentinfo definition deletion dialog document emphasis feed figure form generic grid gridcell group heading img insertion link list listbox listitem log main marquee math menu menubar menuitem menuitemcheckbox menuitemradio meter navigation none note option paragraph presentation progressbar radio radiogroup region row rowgroup rowheader scrollbar search searchbox separator slider spinbutton status strong subscript superscript switch tab table tablist tabpanel term textbox time timer toolbar tooltip tree treegrid treeitem)
-    segments       : [SegmentRendererSegmentsItem] = [{"answer":"Answer","question":"Question","type":"quiz"},{"answer":"Answer 2","question":"Question 2","type":"quiz"}] @label "Segments" @description "Parsed lesson segments (see `parseLessonSegments`)" @tier "presentation"
+    segments       : [SegmentRendererSegmentsItem] = [] @label "Segments" @description "Parsed lesson segments (see `parseLessonSegments`). Ignored when `lesson` is given." @tier "presentation"
     skeleton       : string @label "Skeleton" @description "Skeleton shown while this element's server render is in flight: a shape (`table`, `list`, …), `{ variant, rows?, columns?, fields? }`, or `none`." @tier "presentation" @values (header table list grid detail stats form card text none)
     tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
     userProgress   : SegmentRendererUserProgress @label "User Progress" @description "User progress for restoring activation/reflection state" @tier "presentation"