@almadar/std 16.204.0 → 16.206.0

package/behaviors/lolo/ui/game/organisms/std-platformer-puzzle.lolo

@@ -0,0 +1,302 @@
+app std-platformer-puzzle "1.0.0"
+"Platformer + puzzle genre substrate organism. Composes the standard authorities — platformer-body, pickup, objective-flow, choice-gate, fx-particles, fx-narrative, tutorial-overlay — and enforces five trait-typed pillar slots: agency, challenge, goal, reward, feedback. Levels consume this organism, fill every slot with a local rebinding trait, and add their own geometry, render, and math rules. Math targets and grade levels stay downstream in the domain package; this substrate is domain-agnostic."
+
+orbital PlatformerPuzzleOrbital {
+  uses Body from "std/behaviors/std-platformer-body"
+  uses Pickup from "std/behaviors/std-pickup"
+  uses Gate from "std/behaviors/std-objective-flow"
+  uses Choice from "std/behaviors/std-choice-gate"
+  uses Particles from "std/behaviors/std-fx-particles"
+  uses Narrative from "std/behaviors/std-fx-narrative"
+  uses Tutorial from "std/behaviors/std-tutorial-overlay"
+
+  type PlatformerBody = {
+    x : number!
+    y : number!
+    width : number!
+    height : number!
+    vx : number
+    vy : number
+    grounded : boolean
+    facingRight : boolean
+  }
+  type PlatformerPlatform = {
+    id : string
+    x : number!
+    y : number!
+    width : number!
+    height : number!
+    type : "ground" | "platform" | "hazard" | "goal"
+  }
+  type PlatformerCurveSample = {
+    x : number!
+    y : number!
+  }
+  type BodyDriftRegion = {
+    id : string!
+    x0 : number!
+    x1 : number!
+    y0 : number!
+    y1 : number!
+    ax : number!
+    ay : number!
+  }
+  type CurveMod = {
+    x0 : number!
+    x1 : number!
+    a : number!
+    b : number
+    h : number!
+    k : number!
+  }
+  type PlatformerTuning = {
+    jumpStrength : number
+    moveSpeed : number
+    gravity : number
+  }
+  type PickupFeature = {
+    id : string!
+    x : number!
+    y : number!
+    kind : string!
+    glyph : string
+    message : string
+    collected : boolean
+  }
+  type ChoiceOption = {
+    id : string!
+    dx : number!
+    label : string!
+    correct : boolean!
+  }
+  type ChoiceGate = {
+    id : string!
+    x : number!
+    y : number!
+    hint : string
+    options : [ChoiceOption]!
+    solved : boolean
+    chosen : string
+  }
+  type Fx = {
+    id : string!
+    type : string!
+    x : number!
+    z : number
+    y : number
+    message : string
+    ttl : number!
+    maxTtl : number
+    bornAt : number
+    space : string
+    effect : string
+    color : string
+    size : number
+    vx : number
+    vy : number
+    vz : number
+    particleCount : number
+    animation : string
+  }
+  type FxPreset = {
+    type : string!
+    color : string
+    color2 : string
+    size : number
+    shape : string
+    count : number
+    glow : number
+    gravity : number
+    vx : number
+    vy : number
+    vz : number
+    space : string
+    effect : string
+    particleCount : number
+    animation : string
+  }
+  type NarrativeCue = {
+    text : string!
+    style : "hint" | "fact" | "warn" | "celebrate"
+    x : number
+    y : number
+    ttl : number
+    space : "screen" | "world"
+  }
+  type StyleDef = {
+    color : string!
+    size : number!
+    ttl : number!
+    effect : string!
+  }
+  type TutorialStep = {
+    id : string!
+    title : string!
+    body : string
+    demoId : string
+  }
+  type Asset = {
+    url : asset
+    atlas : asset
+    sprite : string
+    role : string
+    category : string
+    animations : [string]
+    style : string
+    variant : string
+    dimension : string
+    aspect : string
+    name : string
+    thumbnailUrl : string
+  }
+  type DirectionAssets = {
+    up : Asset
+    down : Asset
+    left : Asset
+    right : Asset
+  }
+
+  entity PlatformerPuzzleData [runtime, shared] {
+    id : string!
+    body : PlatformerBody = { x: 0, y: 0, width: 1, height: 1, vx: 0, vy: 0, grounded: false, facingRight: true }
+    fell : boolean = false
+    hazardId : string = ""
+    goalId : string = ""
+    skating : boolean = false
+    curveMods : [CurveMod] = []
+    tuning : PlatformerTuning = {}
+    pickups : [PickupFeature] = []
+    pickupCompleted : boolean = false
+    total : number = 0
+    choices : [ChoiceGate] = []
+    result : string = "none"
+    fx : [Fx] = []
+    narrativeSeq : number = 0
+    lastNarrative : string = ""
+    step : number = 0
+    done : boolean = false
+    score : number = 0
+    lives : number = 3
+    objectivesLeft : number = 1
+    celebrated : boolean = false
+  }
+
+  trait PlatformerPuzzleBody = Body.traits.PlatformerBody -> PlatformerPuzzleData {
+    events {
+      STEER: STEER
+      JUMP: JUMP
+      PLACE: PLACE
+      BODY_MOVED: BODY_MOVED
+      BODY_JUMPED: BODY_JUMPED
+      BODY_LANDED: BODY_LANDED
+      BODY_HAZARD: BODY_HAZARD
+      BODY_GOAL: BODY_GOAL
+      BODY_FELL: BODY_FELL
+      BODY_SKATE_START: BODY_SKATE_START
+      BODY_SKATE_END: BODY_SKATE_END
+      CURVE_MOD_ADD: CURVE_MOD_ADD
+      CURVE_MOD_CLEAR: CURVE_MOD_CLEAR
+      SET_TUNING: SET_TUNING
+    }
+    config { running: true }
+  }
+
+  trait PlatformerPuzzlePickup = Pickup.traits.Pickup -> PlatformerPuzzleData {
+    events {
+      BODY_MOVED: BODY_MOVED
+    }
+    config { running: true }
+  }
+
+  trait PlatformerPuzzleObjective = Gate.traits.ObjectiveFlow -> PlatformerPuzzleData {
+    events {
+      PROGRESS: PROGRESS
+      GAME_END: GAME_END
+    }
+    config { running: true }
+  }
+
+  trait PlatformerPuzzleChoice = Choice.traits.ChoiceGate -> PlatformerPuzzleData {
+    events {
+      BODY_MOVED: BODY_MOVED
+    }
+    config { running: true }
+  }
+
+  trait PlatformerPuzzleFx = Particles.traits.FxParticles -> PlatformerPuzzleData {
+    events {
+      BURST: BURST
+    }
+    config { running: true }
+  }
+
+  trait PlatformerPuzzleNarrative = Narrative.traits.FxNarrative -> PlatformerPuzzleData {
+    events {
+      NARRATE: NARRATE
+      BURST: BURST
+    }
+    config { running: true }
+  }
+
+  trait PlatformerPuzzleTutorial = Tutorial.traits.TutorialOverlay -> PlatformerPuzzleData {
+    events {
+      SHOW: SHOW
+      TUTORIAL_DONE: TUTORIAL_DONE
+    }
+    config { autoShow: false, previewTrait: @trait.PlatformerPuzzleNoopPreview }
+  }
+
+  trait PlatformerPuzzleNoopPreview -> PlatformerPuzzleData [interaction, instance] {
+    initial: idle
+    state idle {
+      INIT -> idle
+        (render-ui overlay null)
+    }
+  }
+
+  trait PlatformerPuzzle -> @rebindable PlatformerPuzzleData [interaction, instance] {
+    initial: active
+
+    state active {
+      INIT -> active
+        (render-ui main null)
+    }
+
+    config {
+      agencyTrait : trait
+        @label "Agency trait"
+        @description "Trait that provides player verbs and immediate response. Usually a rebinding of std-platformer-body, std-motion-body, or std-hero-nav."
+        @tier "domain"
+      challengeTrait : trait
+        @label "Challenge trait"
+        @description "Trait that provides the obstacle, decision, or opposition. Usually a rebinding of std-choice-gate, std-gate-lock, std-patrol-hazard, std-velocity-gate, std-loop-lock, or std-pad-lock."
+        @tier "domain"
+      goalTrait : trait
+        @label "Goal trait"
+        @description "Trait that resolves the win condition. Usually a rebinding of std-objective-flow or std-objective-reach."
+        @tier "domain"
+      rewardTrait : trait
+        @label "Reward trait"
+        @description "Trait that provides collectibles or scoring. Usually a rebinding of std-pickup, std-score, std-xp, or std-gold."
+        @tier "domain"
+      feedbackTrait : trait
+        @label "Feedback trait"
+        @description "Trait that provides visual, audio, or narrative feedback. Usually a rebinding of std-fx-particles, std-fx-narrative, std-tutorial-overlay, std-audio-cue, or std-zone-card."
+        @tier "domain"
+      backgroundAsset : Asset = {}
+        @label "Background Asset"
+        @description "Game-shell background panel sprite (theme chrome)."
+        @tier "presentation"
+      hudBackgroundAsset : Asset = {}
+        @label "HUD Background Asset"
+        @description "HUD panel background sprite (theme chrome)."
+        @tier "presentation"
+      directionAssets : DirectionAssets = {}
+        @label "Direction Assets"
+        @description "D-pad direction icon sprites."
+        @tier "presentation"
+    }
+  }
+
+  page "/platformer-puzzle" as PlatformerPuzzlePage -> PlatformerPuzzleBody, PlatformerPuzzlePickup, PlatformerPuzzleObjective, PlatformerPuzzleChoice, PlatformerPuzzleFx, PlatformerPuzzleNarrative, PlatformerPuzzleTutorial, PlatformerPuzzle
+}

package/behaviors/lolo/ui/learning/atoms/std-learn-slope-probe.lolo

@@ -22,6 +22,7 @@ orbital LearnSlopeProbeOrbital {
     triBy : number = 0
     triCx : number = 0
     triCy : number = 0
+    curve : [ProbeSample] = []
     segment : [ProbeSample] = []
     bucket : number = 9999
   }
@@ -32,15 +33,19 @@ orbital LearnSlopeProbeOrbital {
     state idle {
       INIT -> idle
         (set @entity.probing false)
+        (set @entity.curve @config.curve)
         (set @entity.segment [])
         (set @entity.bucket 9999)
 
+      SET_CURVE -> idle
+        (set @entity.curve @payload.curve)
+
       BODY_MOVED -> idle when @config.running
-        (let ((on (and @payload.skating (> (array/len @config.curve) 1))))
-        (let ((inRange (and @on (and (>= @payload.x (object/get (array/first @config.curve) x)) (<= @payload.x (object/get (array/last @config.curve) x))))))
+        (let ((on (and @payload.skating (> (array/len @entity.curve) 1))))
+        (let ((inRange (and @on (and (>= @payload.x (object/get (array/first @entity.curve) x)) (<= @payload.x (object/get (array/last @entity.curve) x))))))
         (if @inRange
-          (let ((leftSamp (array/last (array/filter @config.curve (fn s (<= (object/get @s x) @payload.x)))))
-                (rightSamp (array/first (array/filter @config.curve (fn s (> (object/get @s x) @payload.x))))))
+          (let ((leftSamp (array/last (array/filter @entity.curve (fn s (<= (object/get @s x) @payload.x)))))
+                (rightSamp (array/first (array/filter @entity.curve (fn s (> (object/get @s x) @payload.x))))))
           (let ((slope (if (== @rightSamp null) 0 (/ (- (object/get @rightSamp y) (object/get @leftSamp y)) (- (object/get @rightSamp x) (object/get @leftSamp x))))))
           (let ((curveY (if (== @rightSamp null) (object/get @leftSamp y) (+ (object/get @leftSamp y) (* @slope (- @payload.x (object/get @leftSamp x)))))))
           (let ((norm (math/sqrt (+ 1 (* @slope @slope)))))
@@ -61,7 +66,7 @@ orbital LearnSlopeProbeOrbital {
               (set @entity.triBy @curveY)
               (set @entity.triCx (+ @payload.x @config.triRun))
               (set @entity.triCy (+ @curveY (* @slope @config.triRun)))
-              (set @entity.segment (array/filter @config.curve (fn s (and (>= (object/get @s x) (- @payload.x @config.window)) (<= (object/get @s x) (+ @payload.x @config.window))))))
+              (set @entity.segment (array/filter @entity.curve (fn s (and (>= (object/get @s x) (- @payload.x @config.window)) (<= (object/get @s x) (+ @payload.x @config.window))))))
               (if (!= @newBucket @entity.bucket)
                 (do
                   (set @entity.bucket @newBucket)
@@ -89,6 +94,7 @@ orbital LearnSlopeProbeOrbital {
     }
 
     listens {
+      SET_CURVE { curve : [ProbeSample]! }
       BODY_MOVED { x : number!, y : number!, vx : number!, vy : number!, grounded : boolean!, skating : boolean!, speed : number! }
       RESTART { id : string }
     }
@@ -100,7 +106,7 @@ orbital LearnSlopeProbeOrbital {
         @tier "domain"
       curve : [ProbeSample] = []
         @label "Curve"
-        @description "Surface samples (x strictly increasing) of the graph being ridden — the same table the body skates and the canvas draws, so the readout matches what is underfoot."
+        @description "Surface samples (x strictly increasing) of the graph being ridden — the same table the body skates and the canvas draws, so the readout matches what is underfoot. Seeded onto the entity on INIT; the live curve is entity.curve — SET_CURVE replaces it at runtime (stitched mega-curves) and RESTART does not reseed it."
         @tier "domain"
       window : number = 1.5
         @label "Tangent Window"

package/behaviors/registry/agent/atoms/std-agent-completion.orb

@@ -177,6 +177,27 @@
       "traits": [
         {
           "category": "lifecycle",
+          "effectRow": [
+            {
+              "kind": "emit",
+              "resource": "COMPLETED"
+            },
+            {
+              "kind": "llm/generate"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.prompt"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.response"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.status"
+            }
+          ],
           "emits": [
             {
               "event": "COMPLETED",
@@ -406,6 +427,12 @@
         },
         {
           "category": "lifecycle",
+          "effectRow": [
+            {
+              "kind": "set",
+              "resource": "@entity.status"
+            }
+          ],
           "entityRefIds": {
             "Completion": "ent_01KXG04EHB6HVH0F0XE0VWB0WV"
           },

package/behaviors/registry/agent/atoms/std-agent-context.orb

@@ -285,6 +285,23 @@
       "traits": [
         {
           "category": "lifecycle",
+          "effectRow": [
+            {
+              "kind": "emit",
+              "resource": "COUNTED"
+            },
+            {
+              "kind": "llm/token-count"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.status"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.tokenCount"
+            }
+          ],
           "emits": [
             {
               "event": "COUNTED",
@@ -496,6 +513,30 @@
         },
         {
           "category": "lifecycle",
+          "effectRow": [
+            {
+              "kind": "emit",
+              "resource": "COMPACTED"
+            },
+            {
+              "kind": "llm/compact"
+            },
+            {
+              "kind": "llm/token-count"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.afterTokens"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.beforeTokens"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.status"
+            }
+          ],
           "emits": [
             {
               "event": "COMPACTED",
@@ -857,6 +898,12 @@
         },
         {
           "category": "lifecycle",
+          "effectRow": [
+            {
+              "kind": "set",
+              "resource": "@entity.status"
+            }
+          ],
           "entityRefIds": {
             "ContextWindow": "ent_01KXG04EJ6PXMMHTTEJ27RNN6C"
           },

package/behaviors/registry/agent/atoms/std-agent-fix-loop.orb

@@ -210,6 +210,34 @@
       "traits": [
         {
           "category": "lifecycle",
+          "effectRow": [
+            {
+              "kind": "emit",
+              "resource": "FIX_APPLIED"
+            },
+            {
+              "kind": "llm/generate"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.errors"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.fixPrompt"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.orbitalName"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.status"
+            },
+            {
+              "kind": "validate/validate"
+            }
+          ],
           "emits": [
             {
               "event": "FIX_APPLIED",
@@ -442,6 +470,12 @@
         },
         {
           "category": "lifecycle",
+          "effectRow": [
+            {
+              "kind": "set",
+              "resource": "@entity.status"
+            }
+          ],
           "entityRefIds": {
             "FixLoop": "ent_01M055GH36GR0CV0VXM4J3HCZT"
           },
@@ -546,7 +580,29 @@
             ]
           }
         }
-      ]
+      ],
+      "types": {
+        "ValidationError": [
+          {
+            "name": "orbitalName",
+            "type": "string"
+          },
+          {
+            "name": "message",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "code",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "severity",
+            "type": "string"
+          }
+        ]
+      }
     }
   ],
   "schemaVersion": 1,

package/behaviors/registry/agent/atoms/std-agent-memory.orb

@@ -293,6 +293,39 @@
       "traits": [
         {
           "category": "lifecycle",
+          "effectRow": [
+            {
+              "kind": "emit",
+              "resource": "RECALLED"
+            },
+            {
+              "kind": "memory/recall"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.category"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.content"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.memoryId"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.query"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.results"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.status"
+            }
+          ],
           "emits": [
             {
               "event": "RECALLED",
@@ -544,6 +577,31 @@
         },
         {
           "category": "lifecycle",
+          "effectRow": [
+            {
+              "kind": "emit",
+              "resource": "STORED"
+            },
+            {
+              "kind": "memory/store"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.category"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.content"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.memoryId"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.status"
+            }
+          ],
           "emits": [
             {
               "event": "STORED",
@@ -801,6 +859,12 @@
         },
         {
           "category": "lifecycle",
+          "effectRow": [
+            {
+              "kind": "set",
+              "resource": "@entity.status"
+            }
+          ],
           "entityRefIds": {
             "AgentMemory": "ent_01KXG04EK05QG9T8V7MTF554J2"
           },
@@ -934,7 +998,30 @@
             ]
           }
         }
-      ]
+      ],
+      "types": {
+        "MemoryRecord": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "content",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "category",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "strength",
+            "type": "number"
+          }
+        ]
+      }
     }
   ],
   "schemaVersion": 1,