@almadar/std 16.197.0 → 16.199.0

package/behaviors/lolo/ui/learning/atoms/ui-biology-canvas.lolo

@@ -1,6 +1,68 @@
 app ui-biology-canvas "1.0.0"
 "BiologyCanvas — UI factory (1:1 with the @almadar/ui biology-canvas pattern)."
 orbital BiologyCanvasOrbital {
+  type BiologyCanvasCamera = {
+    pos : BiologyCanvasCameraPos
+    target : BiologyCanvasCameraTarget
+    zoom : number
+    fov : number
+    mode : "isometric" | "perspective" | "top-down" | "front" | "follow" | "chase"
+    azimuth : number
+    elevation : number
+  }
+  type BiologyCanvasCameraPos = {
+    x : number!
+    y : number!
+    z : number
+  }
+  type BiologyCanvasCameraTarget = {
+    x : number!
+    y : number!
+    z : number
+  }
+  type BiologyCanvasLighting = {
+    ambient : BiologyCanvasLightingAmbient
+    directional : BiologyCanvasLightingDirectional
+    hemisphere : BiologyCanvasLightingHemisphere
+    points : [BiologyCanvasLightingPointsItem]
+    environment : "room" | "none"
+    toneMapping : "aces" | "none"
+  }
+  type BiologyCanvasLightingAmbient = {
+    intensity : number
+    color : string
+    position : [number]
+  }
+  type BiologyCanvasLightingDirectional = {
+    intensity : number
+    color : string
+    position : [number]
+  }
+  type BiologyCanvasLightingHemisphere = {
+    intensity : number
+    color : string
+    groundColor : string
+  }
+  type BiologyCanvasLightingPointsItem = {
+    intensity : number
+    color : string
+    position : [number]!
+    distance : number
+    decay : number
+  }
+  type BiologyCanvasPost = {
+    bloom : BiologyCanvasPostBloom
+    vignette : BiologyCanvasPostVignette
+  }
+  type BiologyCanvasPostBloom = {
+    intensity : number
+    threshold : number
+    smoothing : number
+  }
+  type BiologyCanvasPostVignette = {
+    offset : number
+    darkness : number
+  }
   type BiologyCanvasNodesItem = {
     id : string
     x : number!
@@ -275,15 +337,15 @@ orbital BiologyCanvasOrbital {
         @label "Mode"
         @description "Painter: 2D raster (default) or 3D mesh scene via the lazy three.js host."
         @tier "presentation"
-      camera : json = {}
+      camera : BiologyCanvasCamera
         @label "Camera"
         @description "3D only: neutral camera pose ({ mode, zoom, fov, azimuth, target })."
         @tier "presentation"
-      lighting : object = {}
+      lighting : BiologyCanvasLighting
         @label "Lighting"
         @description "3D only: scene light rig as data."
         @tier "presentation"
-      post : object = {}
+      post : BiologyCanvasPost
         @label "Post"
         @description "3D only: post-processing stack (bloom/vignette)."
         @tier "presentation"

package/behaviors/lolo/ui/learning/atoms/ui-chemistry-canvas.lolo

@@ -1,6 +1,68 @@
 app ui-chemistry-canvas "1.0.0"
 "ChemistryCanvas — UI factory (1:1 with the @almadar/ui chemistry-canvas pattern)."
 orbital ChemistryCanvasOrbital {
+  type ChemistryCanvasCamera = {
+    pos : ChemistryCanvasCameraPos
+    target : ChemistryCanvasCameraTarget
+    zoom : number
+    fov : number
+    mode : "isometric" | "perspective" | "top-down" | "front" | "follow" | "chase"
+    azimuth : number
+    elevation : number
+  }
+  type ChemistryCanvasCameraPos = {
+    x : number!
+    y : number!
+    z : number
+  }
+  type ChemistryCanvasCameraTarget = {
+    x : number!
+    y : number!
+    z : number
+  }
+  type ChemistryCanvasLighting = {
+    ambient : ChemistryCanvasLightingAmbient
+    directional : ChemistryCanvasLightingDirectional
+    hemisphere : ChemistryCanvasLightingHemisphere
+    points : [ChemistryCanvasLightingPointsItem]
+    environment : "room" | "none"
+    toneMapping : "aces" | "none"
+  }
+  type ChemistryCanvasLightingAmbient = {
+    intensity : number
+    color : string
+    position : [number]
+  }
+  type ChemistryCanvasLightingDirectional = {
+    intensity : number
+    color : string
+    position : [number]
+  }
+  type ChemistryCanvasLightingHemisphere = {
+    intensity : number
+    color : string
+    groundColor : string
+  }
+  type ChemistryCanvasLightingPointsItem = {
+    intensity : number
+    color : string
+    position : [number]!
+    distance : number
+    decay : number
+  }
+  type ChemistryCanvasPost = {
+    bloom : ChemistryCanvasPostBloom
+    vignette : ChemistryCanvasPostVignette
+  }
+  type ChemistryCanvasPostBloom = {
+    intensity : number
+    threshold : number
+    smoothing : number
+  }
+  type ChemistryCanvasPostVignette = {
+    offset : number
+    darkness : number
+  }
   type ChemistryCanvasAtomsItem = {
     id : string
     x : number!
@@ -271,15 +333,15 @@ orbital ChemistryCanvasOrbital {
         @label "Mode"
         @description "Painter: 2D raster (default) or 3D mesh scene via the lazy three.js host."
         @tier "presentation"
-      camera : json = {}
+      camera : ChemistryCanvasCamera
         @label "Camera"
         @description "3D only: neutral camera pose ({ mode, zoom, fov, azimuth, target })."
         @tier "presentation"
-      lighting : object = {}
+      lighting : ChemistryCanvasLighting
         @label "Lighting"
         @description "3D only: scene light rig as data."
         @tier "presentation"
-      post : object = {}
+      post : ChemistryCanvasPost
         @label "Post"
         @description "3D only: post-processing stack (bloom/vignette)."
         @tier "presentation"

package/behaviors/lolo/ui/learning/atoms/ui-learning-canvas.lolo

@@ -37,6 +37,13 @@ orbital LearningCanvasOrbital {
     x : number!
     y : number!
   }
+  type LearningCanvasProjector = {
+    tileWidth : number!
+    floorHeight : number!
+    diamondTopY : number!
+    squareGrid : boolean!
+    worldPixelDirect : boolean!
+  }
   type LearningCanvasReadoutsItem = {
     label : string!
     value : string!
@@ -95,6 +102,8 @@ orbital LearningCanvasOrbital {
           height: @config.height
           backgroundColor: @config.backgroundColor
           shapes: @config.shapes
+          drawables: @config.drawables
+          projector: @config.projector
           readouts: @config.readouts
           traces: @config.traces
           interactive: @config.interactive
@@ -112,6 +121,8 @@ orbital LearningCanvasOrbital {
           height: @config.height
           backgroundColor: @config.backgroundColor
           shapes: @payload.shapes
+          drawables: @payload.drawables
+          projector: @config.projector
           readouts: @payload.readouts
           traces: @payload.traces
           interactive: @config.interactive
@@ -140,6 +151,7 @@ orbital LearningCanvasOrbital {
     listens {
       UPDATE {
         shapes : [LearningCanvasShapesItem]
+        drawables : [node]
         readouts : [LearningCanvasReadoutsItem]
         traces : [LearningCanvasTracesItem]
       }
@@ -169,6 +181,14 @@ orbital LearningCanvasOrbital {
         @label "Shapes"
         @description "Declarative shapes to draw."
         @tier "presentation"
+      drawables : [node] = []
+        @label "Drawables"
+        @description "Neutral game-canvas drawables (e.g. `draw-sprite`, `draw-fx-layer`) painted in world coordinates via the supplied `projector`. This lets the learning canvas reuse the game drawable vocabulary without reimplementing sprites/FX."
+        @tier "presentation"
+      projector : LearningCanvasProjector
+        @label "Projector"
+        @description "World-to-pixel projector for `drawables`. When absent, `drawables` are ignored."
+        @tier "presentation"
       readouts : [LearningCanvasReadoutsItem] = []
         @label "Readouts"
         @description "Top-right status chip row (live measurements, scores, counters)."

package/behaviors/lolo/ui/learning/atoms/ui-math-canvas.lolo

@@ -182,6 +182,7 @@ orbital MathCanvasOrbital {
           angles: @config.angles
           hops: @config.hops
           shapes: @config.shapes
+          drawables: @config.drawables
           readouts: @config.readouts
           traces: @config.traces
           interactive: @config.interactive
@@ -220,6 +221,7 @@ orbital MathCanvasOrbital {
           angles: @payload.angles
           hops: @payload.hops
           shapes: @payload.shapes
+          drawables: @payload.drawables
           readouts: @payload.readouts
           traces: @payload.traces
           interactive: @config.interactive
@@ -252,6 +254,7 @@ orbital MathCanvasOrbital {
         angles : [MathCanvasAnglesItem]
         hops : [MathCanvasHopsItem]
         shapes : [MathCanvasShapesItem]
+        drawables : [node]
         readouts : [MathCanvasReadoutsItem]
         traces : [MathCanvasTracesItem]
       }
@@ -361,6 +364,10 @@ orbital MathCanvasOrbital {
         @label "Shapes"
         @description "Extra declarative shapes in canvas pixel coordinates."
         @tier "presentation"
+      drawables : [node] = []
+        @label "Drawables"
+        @description "Game-canvas drawables painted in math world coordinates (e.g. `draw-sprite` for a character sprite on the graph). The canvas maps their `ScenePos` through the same x/y world→pixel transform used for curves/points."
+        @tier "presentation"
       readouts : [MathCanvasReadoutsItem] = []
         @label "Readouts"
         @description "Top-right status chips, forwarded verbatim to LearningCanvas."

package/behaviors/lolo/ui/learning/atoms/ui-physics-canvas.lolo

@@ -1,6 +1,68 @@
 app ui-physics-canvas "1.0.0"
 "PhysicsCanvas — UI factory (1:1 with the @almadar/ui physics-canvas pattern)."
 orbital PhysicsCanvasOrbital {
+  type PhysicsCanvasCamera = {
+    pos : PhysicsCanvasCameraPos
+    target : PhysicsCanvasCameraTarget
+    zoom : number
+    fov : number
+    mode : "isometric" | "perspective" | "top-down" | "front" | "follow" | "chase"
+    azimuth : number
+    elevation : number
+  }
+  type PhysicsCanvasCameraPos = {
+    x : number!
+    y : number!
+    z : number
+  }
+  type PhysicsCanvasCameraTarget = {
+    x : number!
+    y : number!
+    z : number
+  }
+  type PhysicsCanvasLighting = {
+    ambient : PhysicsCanvasLightingAmbient
+    directional : PhysicsCanvasLightingDirectional
+    hemisphere : PhysicsCanvasLightingHemisphere
+    points : [PhysicsCanvasLightingPointsItem]
+    environment : "room" | "none"
+    toneMapping : "aces" | "none"
+  }
+  type PhysicsCanvasLightingAmbient = {
+    intensity : number
+    color : string
+    position : [number]
+  }
+  type PhysicsCanvasLightingDirectional = {
+    intensity : number
+    color : string
+    position : [number]
+  }
+  type PhysicsCanvasLightingHemisphere = {
+    intensity : number
+    color : string
+    groundColor : string
+  }
+  type PhysicsCanvasLightingPointsItem = {
+    intensity : number
+    color : string
+    position : [number]!
+    distance : number
+    decay : number
+  }
+  type PhysicsCanvasPost = {
+    bloom : PhysicsCanvasPostBloom
+    vignette : PhysicsCanvasPostVignette
+  }
+  type PhysicsCanvasPostBloom = {
+    intensity : number
+    threshold : number
+    smoothing : number
+  }
+  type PhysicsCanvasPostVignette = {
+    offset : number
+    darkness : number
+  }
   type PhysicsCanvasBodiesItem = {
     id : string
     x : number!
@@ -326,15 +388,15 @@ orbital PhysicsCanvasOrbital {
         @label "Mode"
         @description "Painter: 2D raster (default) or 3D mesh scene via the lazy three.js host."
         @tier "presentation"
-      camera : json = {}
+      camera : PhysicsCanvasCamera
         @label "Camera"
         @description "3D only: neutral camera pose ({ mode, zoom, fov, azimuth, target })."
         @tier "presentation"
-      lighting : object = {}
+      lighting : PhysicsCanvasLighting
         @label "Lighting"
         @description "3D only: scene light rig as data."
         @tier "presentation"
-      post : object = {}
+      post : PhysicsCanvasPost
         @label "Post"
         @description "3D only: post-processing stack (bloom/vignette)."
         @tier "presentation"

package/behaviors/registry/agent/atoms/std-agent-tool-call.orb

@@ -143,7 +143,7 @@
                 },
                 "toolCalls": {
                   "items": {
-                    "type": "object"
+                    "type": "opaque"
                   },
                   "name": "toolCalls",
                   "required": false,
@@ -172,7 +172,7 @@
                 "schema": {
                   "name": "schema",
                   "required": false,
-                  "type": "object"
+                  "type": "opaque"
                 }
               },
               "type": "object"
@@ -269,7 +269,7 @@
                       },
                       {
                         "name": "toolCalls",
-                        "type": "[object]"
+                        "type": "[opaque]"
                       },
                       {
                         "name": "toolCallId",
@@ -294,7 +294,7 @@
                       },
                       {
                         "name": "schema",
-                        "type": "object"
+                        "type": "opaque"
                       }
                     ],
                     "required": true,

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

@@ -179,7 +179,7 @@
                 },
                 "toolCalls": {
                   "items": {
-                    "type": "object"
+                    "type": "opaque"
                   },
                   "name": "toolCalls",
                   "required": false,
@@ -208,7 +208,7 @@
                 "schema": {
                   "name": "schema",
                   "required": false,
-                  "type": "object"
+                  "type": "opaque"
                 }
               },
               "type": "object"
@@ -338,7 +338,7 @@
                       },
                       {
                         "name": "toolCalls",
-                        "type": "[object]"
+                        "type": "[opaque]"
                       },
                       {
                         "name": "toolCallId",
@@ -363,7 +363,7 @@
                       },
                       {
                         "name": "schema",
-                        "type": "object"
+                        "type": "opaque"
                       }
                     ],
                     "required": true,

package/behaviors/registry/infra/atoms/std-approval-gate.orb

@@ -354,7 +354,7 @@
             "description": "The held data of the gated action, replayed by the downstream listener when the request is granted.",
             "name": "payload",
             "synonyms": "request data, held payload, pending data, gated data",
-            "type": "object"
+            "type": "opaque"
           }
         ],
         "id": "ent_01KXG04EYQFWN6TM97JNWHHSF4",
@@ -698,7 +698,7 @@
                     },
                     {
                       "name": "payload",
-                      "type": "object"
+                      "type": "opaque"
                     }
                   ],
                   "type": "object"
@@ -771,7 +771,7 @@
                     },
                     {
                       "name": "payload",
-                      "type": "object"
+                      "type": "opaque"
                     }
                   ],
                   "type": "object"
@@ -852,7 +852,7 @@
                 },
                 {
                   "name": "payload",
-                  "type": "object"
+                  "type": "opaque"
                 }
               ],
               "scope": "external",
@@ -1110,7 +1110,7 @@
                       },
                       {
                         "name": "payload",
-                        "type": "object"
+                        "type": "opaque"
                       }
                     ],
                     "type": "object"
@@ -1184,7 +1184,7 @@
                       },
                       {
                         "name": "payload",
-                        "type": "object"
+                        "type": "opaque"
                       }
                     ],
                     "type": "object"
@@ -1293,7 +1293,7 @@
                   },
                   {
                     "name": "payload",
-                    "type": "object"
+                    "type": "opaque"
                   }
                 ],
                 "synonyms": "approved, authorized, confirmed, validated",

package/behaviors/registry/infra/atoms/std-audit-capture.orb

@@ -99,14 +99,14 @@
             "description": "The state of the entity prior to the modification.",
             "name": "before",
             "synonyms": "previous, original, old value",
-            "type": "object"
+            "type": "opaque"
           },
           {
             "default": {},
             "description": "The state of the entity after a modification.",
             "name": "after",
             "synonyms": "new, updated, post, subsequent",
-            "type": "object"
+            "type": "opaque"
           },
           {
             "default": 0.0,
@@ -254,7 +254,7 @@
                 "payloadSchema": [
                   {
                     "name": "data",
-                    "type": "object"
+                    "type": "@entity(captureEntity)"
                   }
                 ]
               },

package/behaviors/registry/infra/atoms/std-cascade-on-delete.orb

@@ -226,7 +226,7 @@
               "payloadSchema": [
                 {
                   "name": "data",
-                  "type": "[object]"
+                  "type": "[@entity(dependentEntity)]"
                 }
               ]
             },
@@ -277,7 +277,7 @@
                 "payloadSchema": [
                   {
                     "name": "data",
-                    "type": "object"
+                    "type": "@entity(parentEntity)"
                   }
                 ]
               },
@@ -288,7 +288,7 @@
                 "payloadSchema": [
                   {
                     "name": "data",
-                    "type": "[object]"
+                    "type": "[@entity(dependentEntity)]"
                   }
                 ]
               },

package/behaviors/registry/infra/atoms/std-cooldown.orb

@@ -68,7 +68,6 @@
   "orbitals": [
     {
       "entity": {
-        "collection": "cooldown_states",
         "fields": [
           {
             "name": "id",
@@ -92,7 +91,7 @@
         ],
         "id": "ent_01KXG04F8TJJ9ASFRDGES09D5K",
         "name": "CooldownRecord",
-        "persistence": "persistent"
+        "persistence": "runtime"
       },
       "id": "orb_01KXG04F8TJADJKTFF6VASJDX1",
       "name": "CooldownOrbital",

package/behaviors/registry/infra/atoms/std-game-clock.orb

@@ -68,7 +68,6 @@
   "orbitals": [
     {
       "entity": {
-        "collection": "game_clock_states",
         "fields": [
           {
             "name": "id",
@@ -92,7 +91,7 @@
         ],
         "id": "ent_01KXG04FBQ6K4G6J1ZNCTFVWT1",
         "name": "GameClockRecord",
-        "persistence": "persistent"
+        "persistence": "runtime"
       },
       "id": "orb_01KXG04FBQV351H0MNMBN12VGE",
       "name": "GameClockOrbital",

package/behaviors/registry/infra/atoms/std-lifecycle.orb

@@ -244,7 +244,7 @@
               "payloadSchema": [
                 {
                   "name": "data",
-                  "type": "[object]"
+                  "type": "[@entity(targetEntity)]"
                 }
               ]
             },
@@ -303,7 +303,7 @@
                 "payloadSchema": [
                   {
                     "name": "data",
-                    "type": "[object]"
+                    "type": "[@entity(targetEntity)]"
                   }
                 ]
               },