@almadar/std 16.173.0 → 16.175.0

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

@@ -5,21 +5,117 @@ orbital PhysicsCanvasOrbital {
     id : string
     x : number!
     y : number!
+    z : number
     radius : number
     color : string
     label : string
     vx : number
     vy : number
+    vz : number
     fx : number
     fy : number
+    fz : number
   }
   type PhysicsCanvasConstraintsItem = {
     from : string!
     to : string!
     color : string
+    kind : "rod" | "spring" | "string"
+  }
+  type PhysicsCanvasSceneObjectsItem = {
+    kind : "ground" | "wall" | "ramp" | "box" | "pivot"!
+    x : number
+    y : number
+    x1 : number
+    y1 : number
+    x2 : number
+    y2 : number
+    width : number
+    height : number
+    color : string
+    fill : string
+    label : string
+  }
+  type PhysicsCanvasTrailsItem = {
+    id : string
+    points : [PhysicsCanvasTrailsItemPointsItem]!
+    color : string
+    width : number
+    opacity : number
+    fade : boolean
+  }
+  type PhysicsCanvasTrailsItemPointsItem = {
+    x : number!
+    y : number!
+    z : number
+  }
+  type PhysicsCanvasVectorsItem = {
+    x : number
+    y : number
+    body : string
+    dx : number!
+    dy : number!
+    scale : number
+    color : string
+    label : string
+    dash : "dashed" | "dotted"
+  }
+  type PhysicsCanvasSurface3d = {
+    nx : number!
+    ny : number!
+    heights : [number]!
+    spacing : number
+    x : number
+    y : number
+    bands : [PhysicsCanvasSurface3dBandsItem]
+    color : string
+    opacity : number
+    flatShading : boolean
+  }
+  type PhysicsCanvasSurface3dBandsItem = {
+    min : number
+    color : string!
+  }
+  type PhysicsCanvasVectors3dItem = {
+    id : string
+    x : number!
+    y : number!
+    z : number
+    dx : number!
+    dy : number!
+    dz : number
+    color : string
+    label : string
+    width : number
+  }
+  type PhysicsCanvasAnglesItem = {
+    x : number!
+    y : number!
+    from : number!
+    to : number!
+    radius : number
+    color : string
+    label : string
+  }
+  type PhysicsCanvasField = {
+    kind : "arrows" | "into" | "out"!
+    spacing : number
+    angle : number
+    size : number
+    color : string
+    x : number
+    y : number
+    width : number
+    height : number
+  }
+  type PhysicsCanvasMetersItem = {
+    label : string!
+    value : number!
+    max : number
+    color : string
   }
   type PhysicsCanvasShapesItem = {
-    type : "line" | "arrow" | "circle" | "rect" | "polygon" | "path" | "text" | "axis" | "grid"!
+    type : "line" | "arrow" | "circle" | "ellipse" | "rect" | "polygon" | "path" | "text" | "axis" | "grid" | "venn-region"!
     id : string
     x : number
     y : number
@@ -44,11 +140,42 @@ orbital PhysicsCanvasOrbital {
     fill : string
     lineWidth : number
     opacity : number
+    startAngle : number
+    endAngle : number
+    dash : "dashed" | "dotted"
+    inside : [string]
+    outside : [string]
   }
   type PhysicsCanvasShapesItemPointsItem = {
     x : number!
     y : number!
   }
+  type PhysicsCanvasReadoutsItem = {
+    label : string!
+    value : string!
+    color : string
+  }
+  type PhysicsCanvasTracesItem = {
+    x : number
+    y : number
+    width : number
+    height : number
+    series : [PhysicsCanvasTracesItemSeriesItem]!
+    xLabel : string
+    yLabel : string
+    frameColor : string
+    backgroundColor : string
+    backgroundOpacity : number
+  }
+  type PhysicsCanvasTracesItemSeriesItem = {
+    samples : [PhysicsCanvasTracesItemSeriesItemSamplesItem]!
+    color : string
+    label : string
+  }
+  type PhysicsCanvasTracesItemSeriesItemSamplesItem = {
+    x : number!
+    y : number!
+  }
   type PhysicsCanvasError = {
     message : string!
     name : string
@@ -76,13 +203,30 @@ orbital PhysicsCanvasOrbital {
           height: @config.height
           title: @config.title
           backgroundColor: @config.backgroundColor
+          mode: @config.mode
+          camera: @config.camera
+          lighting: @config.lighting
+          post: @config.post
           bodies: @config.bodies
           constraints: @config.constraints
           showVelocity: @config.showVelocity
           showForces: @config.showForces
           velocityScale: @config.velocityScale
           forceScale: @config.forceScale
+          sceneObjects: @config.sceneObjects
+          trails: @config.trails
+          vectors: @config.vectors
+          surface3d: @config.surface3d
+          vectors3d: @config.vectors3d
+          vectorScale: @config.vectorScale
+          angles: @config.angles
+          field: @config.field
+          meters: @config.meters
           shapes: @config.shapes
+          readouts: @config.readouts
+          traces: @config.traces
+          showGrid: @config.showGrid
+          shadows: @config.shadows
           interactive: @config.interactive
           animate: @config.animate
           onShapeClick: @config.onShapeClick
@@ -97,13 +241,30 @@ orbital PhysicsCanvasOrbital {
           height: @config.height
           title: @config.title
           backgroundColor: @config.backgroundColor
+          mode: @config.mode
+          camera: @config.camera
+          lighting: @config.lighting
+          post: @config.post
           bodies: @payload.bodies
           constraints: @payload.constraints
           showVelocity: @config.showVelocity
           showForces: @config.showForces
           velocityScale: @config.velocityScale
           forceScale: @config.forceScale
+          sceneObjects: @payload.sceneObjects
+          trails: @payload.trails
+          vectors: @payload.vectors
+          surface3d: @config.surface3d
+          vectors3d: @payload.vectors3d
+          vectorScale: @config.vectorScale
+          angles: @payload.angles
+          field: @config.field
+          meters: @payload.meters
           shapes: @payload.shapes
+          readouts: @payload.readouts
+          traces: @payload.traces
+          showGrid: @config.showGrid
+          shadows: @config.shadows
           interactive: @config.interactive
           animate: @config.animate
           onShapeClick: @config.onShapeClick
@@ -125,7 +286,15 @@ orbital PhysicsCanvasOrbital {
       UPDATE {
         bodies : [PhysicsCanvasBodiesItem]
         constraints : [PhysicsCanvasConstraintsItem]
+        sceneObjects : [PhysicsCanvasSceneObjectsItem]
+        trails : [PhysicsCanvasTrailsItem]
+        vectors : [PhysicsCanvasVectorsItem]
+        vectors3d : [PhysicsCanvasVectors3dItem]
+        angles : [PhysicsCanvasAnglesItem]
+        meters : [PhysicsCanvasMetersItem]
         shapes : [PhysicsCanvasShapesItem]
+        readouts : [PhysicsCanvasReadoutsItem]
+        traces : [PhysicsCanvasTracesItem]
       }
         @description "Live scene update; payload carries the current drawable state."
         @synonyms "tick, redraw, animate, frame"
@@ -153,6 +322,22 @@ orbital PhysicsCanvasOrbital {
         @label "Background Color"
         @description "backgroundColor prop"
         @tier "presentation"
+      mode : "2d" | "3d" = "2d"
+        @label "Mode"
+        @description "Painter: 2D raster (default) or 3D mesh scene via the lazy three.js host."
+        @tier "presentation"
+      camera : json = {}
+        @label "Camera"
+        @description "3D only: neutral camera pose ({ mode, zoom, fov, azimuth, target })."
+        @tier "presentation"
+      lighting : json = {}
+        @label "Lighting"
+        @description "3D only: scene light rig as data."
+        @tier "presentation"
+      post : json = {}
+        @label "Post"
+        @description "3D only: post-processing stack (bloom/vignette)."
+        @tier "presentation"
       bodies : [PhysicsCanvasBodiesItem] = []
         @label "Bodies"
         @description "bodies prop"
@@ -177,17 +362,69 @@ orbital PhysicsCanvasOrbital {
         @label "Force Scale"
         @description "forceScale prop"
         @tier "presentation"
+      sceneObjects : [PhysicsCanvasSceneObjectsItem] = []
+        @label "Scene Objects"
+        @description "Ground/wall/ramp/box/pivot scene fixtures. 2D only."
+        @tier "presentation"
+      trails : [PhysicsCanvasTrailsItem] = []
+        @label "Trails"
+        @description "Fading trajectory polylines (2D) / trajectory tubes (3D)."
+        @tier "presentation"
+      vectors : [PhysicsCanvasVectorsItem] = []
+        @label "Vectors"
+        @description "Named force/velocity/free-body arrows, anchored by point or by body id. 2D only."
+        @tier "presentation"
+      surface3d : PhysicsCanvasSurface3d
+        @label "Surface3d"
+        @description "A 3D height-field surface mesh (wave, terrain, potential well). 3D only."
+        @tier "presentation"
+      vectors3d : [PhysicsCanvasVectors3dItem] = []
+        @label "Vectors3d"
+        @description "Labeled 3D arrows (field arrows, axis triads). 3D only."
+        @tier "presentation"
+      vectorScale : number = 1
+        @label "Vector Scale"
+        @description "Multiplies every `vectors3d` entry's `dx`/`dy`/`dz` (default 1). 3D only."
+        @tier "presentation"
+      angles : [PhysicsCanvasAnglesItem] = []
+        @label "Angles"
+        @description "Angle arcs between two bearings. 2D only."
+        @tier "presentation"
+      field : PhysicsCanvasField
+        @label "Field"
+        @description "A single uniform vector/into/out field lattice. 2D only."
+        @tier "presentation"
+      meters : [PhysicsCanvasMetersItem] = []
+        @label "Meters"
+        @description "Bottom-left labeled bar gauges. 2D only."
+        @tier "presentation"
       shapes : [PhysicsCanvasShapesItem] = []
         @label "Shapes"
-        @description "Extra declarative shapes in canvas pixel coordinates."
+        @description "Extra declarative shapes in canvas pixel coordinates (2D mode only — ignored in 3D)."
+        @tier "presentation"
+      readouts : [PhysicsCanvasReadoutsItem] = []
+        @label "Readouts"
+        @description "Top-right status chip row, forwarded to LearningCanvas verbatim."
+        @tier "presentation"
+      traces : [PhysicsCanvasTracesItem] = []
+        @label "Traces"
+        @description "Inset sparkline panels, forwarded to LearningCanvas verbatim."
+        @tier "presentation"
+      showGrid : boolean
+        @label "Show Grid"
+        @description "3D only: show the ground grid (default off)."
+        @tier "presentation"
+      shadows : boolean
+        @label "Shadows"
+        @description "3D only: enable shadows. Omitted → the host default."
         @tier "presentation"
-      interactive : boolean = false
+      interactive : boolean
         @label "Interactive"
-        @description "interactive prop"
+        @description "2D: pointer interaction (click/hover). 3D: orbit camera controls."
         @tier "presentation"
       animate : boolean = false
         @label "Animate"
-        @description "animate prop"
+        @description "2D only: continuous redraw loop. 3D motion is entity-state driven."
         @tier "presentation"
       onShapeClick : string = "SHAPE_CLICK"
         @label "On Shape Click"

package/behaviors/lolo/ui/marketing/organisms/ui-book-viewer.lolo

@@ -115,7 +115,7 @@ orbital BookViewerOrbital {
         @label "Total Count"
         @description "Total number of items"
         @tier "presentation"
-      activeFilters : json = {}
+      activeFilters : Map string string = {}
         @label "Active Filters"
         @description "Active filters"
         @tier "presentation"

package/behaviors/lolo/ui/marketing/organisms/ui-case-study-organism.lolo

@@ -107,7 +107,7 @@ orbital CaseStudyOrganismOrbital {
         @label "Total Count"
         @description "Total number of items"
         @tier "presentation"
-      activeFilters : json = {}
+      activeFilters : Map string string = {}
         @label "Active Filters"
         @description "Active filters"
         @tier "presentation"

package/behaviors/lolo/ui/marketing/organisms/ui-feature-grid-organism.lolo

@@ -108,7 +108,7 @@ orbital FeatureGridOrganismOrbital {
         @label "Total Count"
         @description "Total number of items"
         @tier "presentation"
-      activeFilters : json = {}
+      activeFilters : Map string string = {}
         @label "Active Filters"
         @description "Active filters"
         @tier "presentation"

package/behaviors/lolo/ui/marketing/organisms/ui-hero-organism.lolo

@@ -121,7 +121,7 @@ orbital HeroOrganismOrbital {
         @label "Total Count"
         @description "Total number of items"
         @tier "presentation"
-      activeFilters : json = {}
+      activeFilters : Map string string = {}
         @label "Active Filters"
         @description "Active filters"
         @tier "presentation"

package/behaviors/lolo/ui/marketing/organisms/ui-pricing-organism.lolo

@@ -109,7 +109,7 @@ orbital PricingOrganismOrbital {
         @label "Total Count"
         @description "Total number of items"
         @tier "presentation"
-      activeFilters : json = {}
+      activeFilters : Map string string = {}
         @label "Active Filters"
         @description "Active filters"
         @tier "presentation"

package/behaviors/lolo/ui/marketing/organisms/ui-showcase-organism.lolo

@@ -113,7 +113,7 @@ orbital ShowcaseOrganismOrbital {
         @label "Total Count"
         @description "Total number of items"
         @tier "presentation"
-      activeFilters : json = {}
+      activeFilters : Map string string = {}
         @label "Active Filters"
         @description "Active filters"
         @tier "presentation"

package/behaviors/lolo/ui/marketing/organisms/ui-stats-organism.lolo

@@ -101,7 +101,7 @@ orbital StatsOrganismOrbital {
         @label "Total Count"
         @description "Total number of items"
         @tier "presentation"
-      activeFilters : json = {}
+      activeFilters : Map string string = {}
         @label "Active Filters"
         @description "Active filters"
         @tier "presentation"

package/behaviors/lolo/ui/marketing/organisms/ui-step-flow-organism.lolo

@@ -109,7 +109,7 @@ orbital StepFlowOrganismOrbital {
         @label "Total Count"
         @description "Total number of items"
         @tier "presentation"
-      activeFilters : json = {}
+      activeFilters : Map string string = {}
         @label "Active Filters"
         @description "Active filters"
         @tier "presentation"

package/behaviors/lolo/ui/marketing/organisms/ui-team-organism.lolo

@@ -106,7 +106,7 @@ orbital TeamOrganismOrbital {
         @label "Total Count"
         @description "Total number of items"
         @tier "presentation"
-      activeFilters : json = {}
+      activeFilters : Map string string = {}
         @label "Active Filters"
         @description "Active filters"
         @tier "presentation"

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

@@ -731,8 +731,29 @@
                   },
                   {
                     "name": "spec",
+                    "properties": [
+                      {
+                        "name": "orbitalName",
+                        "type": "string"
+                      },
+                      {
+                        "name": "organism",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "method",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "deltaPrompt",
+                        "required": true,
+                        "type": "string"
+                      }
+                    ],
                     "required": true,
-                    "type": "OrbitalSpec"
+                    "type": "object"
                   }
                 ]
               },

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

@@ -256,13 +256,49 @@
                 "payloadSchema": [
                   {
                     "name": "messages",
+                    "properties": [
+                      {
+                        "name": "role",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "content",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "toolCalls",
+                        "type": "[object]"
+                      },
+                      {
+                        "name": "toolCallId",
+                        "type": "string"
+                      }
+                    ],
                     "required": true,
-                    "type": "[LlmMessage]"
+                    "type": "[object]"
                   },
                   {
                     "name": "tools",
+                    "properties": [
+                      {
+                        "name": "name",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "description",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "schema",
+                        "type": "object"
+                      }
+                    ],
                     "required": true,
-                    "type": "[LlmToolDef]"
+                    "type": "[object]"
                   }
                 ]
               },

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

@@ -325,13 +325,49 @@
                 "payloadSchema": [
                   {
                     "name": "messages",
+                    "properties": [
+                      {
+                        "name": "role",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "content",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "toolCalls",
+                        "type": "[object]"
+                      },
+                      {
+                        "name": "toolCallId",
+                        "type": "string"
+                      }
+                    ],
                     "required": true,
-                    "type": "[LlmMessage]"
+                    "type": "[object]"
                   },
                   {
                     "name": "tools",
+                    "properties": [
+                      {
+                        "name": "name",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "description",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "schema",
+                        "type": "object"
+                      }
+                    ],
                     "required": true,
-                    "type": "[LlmToolDef]"
+                    "type": "[object]"
                   }
                 ]
               },

package/behaviors/registry/agent/organisms/std-agent-rabit.orb

@@ -1437,8 +1437,30 @@
                   },
                   {
                     "name": "spec",
+                    "properties": [
+                      {
+                        "name": "orbitalName",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "organism",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "method",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "deltaPrompt",
+                        "required": true,
+                        "type": "string"
+                      }
+                    ],
                     "required": true,
-                    "type": "OrbitalSpec"
+                    "type": "object"
                   }
                 ]
               },

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

@@ -299,8 +299,7 @@
           "linkedEntity": "ApprovalRequest",
           "linkedEntityId": "ent_01KXG04EYQFWN6TM97JNWHHSF4",
           "name": "LoadingSpinner",
-          "ref": "Spinner.traits.SpinnerRender",
-          "refId": "trt_01KXG04KQTE55FSTDE4V4XKESN"
+          "ref": "Spinner.traits.SpinnerRender"
         },
         {
           "config": {
@@ -313,8 +312,7 @@
           "linkedEntity": "ApprovalRequest",
           "linkedEntityId": "ent_01KXG04EYQFWN6TM97JNWHHSF4",
           "name": "ErrorSpinner",
-          "ref": "Spinner.traits.SpinnerRender",
-          "refId": "trt_01KXG04KQTE55FSTDE4V4XKESN"
+          "ref": "Spinner.traits.SpinnerRender"
         },
         {
           "config": {
@@ -335,8 +333,7 @@
           "linkedEntity": "ApprovalRequest",
           "linkedEntityId": "ent_01KXG04EYQFWN6TM97JNWHHSF4",
           "name": "LoadingText",
-          "ref": "Typography.traits.TypographyRender",
-          "refId": "trt_01KXG04MN4YEZRM29MVNFTYM98"
+          "ref": "Typography.traits.TypographyRender"
         },
         {
           "config": {
@@ -349,8 +346,7 @@
           "linkedEntity": "ApprovalRequest",
           "linkedEntityId": "ent_01KXG04EYQFWN6TM97JNWHHSF4",
           "name": "ShieldCheckIcon",
-          "ref": "Icon.traits.IconRender",
-          "refId": "trt_01KXG04K2JE4GSQVWEWHAHDE2A"
+          "ref": "Icon.traits.IconRender"
         },
         {
           "config": {
@@ -367,8 +363,7 @@
           "linkedEntity": "ApprovalRequest",
           "linkedEntityId": "ent_01KXG04EYQFWN6TM97JNWHHSF4",
           "name": "ApprovalQueueTitle",
-          "ref": "Typography.traits.TypographyRender",
-          "refId": "trt_01KXG04MN4YEZRM29MVNFTYM98"
+          "ref": "Typography.traits.TypographyRender"
         },
         {
           "config": {
@@ -393,16 +388,14 @@
           "linkedEntity": "ApprovalRequest",
           "linkedEntityId": "ent_01KXG04EYQFWN6TM97JNWHHSF4",
           "name": "CloseButton",
-          "ref": "Button.traits.ButtonRender",
-          "refId": "trt_01KXG04JBQPWD7RW8X33NXPXG9"
+          "ref": "Button.traits.ButtonRender"
         },
         {
           "id": "trt_01KY21K6QC0P4NS69R6ATZPC18",
           "linkedEntity": "ApprovalRequest",
           "linkedEntityId": "ent_01KXG04EYQFWN6TM97JNWHHSF4",
           "name": "ApprovalDivider",
-          "ref": "Divider.traits.DividerRender",
-          "refId": "trt_01KXG04JVTJZ479S2KPR7HD1KB"
+          "ref": "Divider.traits.DividerRender"
         },
         {
           "config": {
@@ -419,8 +412,7 @@
           "linkedEntity": "ApprovalRequest",
           "linkedEntityId": "ent_01KXG04EYQFWN6TM97JNWHHSF4",
           "name": "ErrorAlert",
-          "ref": "Alert.traits.AlertRender",
-          "refId": "trt_01KXG04MT125AX1BGFS3ZNGX67"
+          "ref": "Alert.traits.AlertRender"
         },
         {
           "capabilities": [