@almadar/std 16.197.0 → 16.199.0

package/behaviors/registry/ui/core/organisms/ui-form.orb

@@ -191,7 +191,7 @@
               "properties": {
                 "entity": {
                   "items": {
-                    "type": "object"
+                    "type": "opaque"
                   },
                   "name": "entity",
                   "required": false,
@@ -199,7 +199,7 @@
                 },
                 "formValues": {
                   "items": {
-                    "type": "object"
+                    "type": "opaque"
                   },
                   "name": "formValues",
                   "required": true,
@@ -207,7 +207,7 @@
                 },
                 "globalVariables": {
                   "items": {
-                    "type": "string"
+                    "type": "opaque"
                   },
                   "name": "globalVariables",
                   "required": true,
@@ -215,7 +215,7 @@
                 },
                 "localVariables": {
                   "items": {
-                    "type": "string"
+                    "type": "opaque"
                   },
                   "name": "localVariables",
                   "required": false,
@@ -346,7 +346,7 @@
                   "defaultValue": {
                     "name": "defaultValue",
                     "required": false,
-                    "type": "string"
+                    "type": "opaque"
                   },
                   "disabled": {
                     "name": "disabled",
@@ -655,7 +655,7 @@
                         "defaultValue": {
                           "name": "defaultValue",
                           "required": false,
-                          "type": "string"
+                          "type": "opaque"
                         },
                         "disabled": {
                           "name": "disabled",
@@ -914,32 +914,30 @@
           },
           "emits": [
             {
+              "definerKnob": "submitEvent",
               "description": "Event dispatch props (for trait state machine integration)",
               "event": "@config.submitEvent",
               "eventId": "evt_01KXG04SPJ7H96GN6APRSKRCZS",
               "payloadSchema": [
                 {
-                  "name": "id",
-                  "type": "string"
+                  "name": "data",
+                  "required": true,
+                  "type": "@entity"
                 }
               ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "cancelEvent",
               "description": "Event to dispatch on cancel (defaults to 'CANCEL')",
               "event": "@config.cancelEvent",
               "eventId": "evt_01KXG04SPJWT4NNHT8EQNRH7NS",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "onFieldChange",
               "description": "Callback when any field value changes",
               "event": "@config.onFieldChange",
               "eventId": "evt_01KXG04SPJEZNCE021SWHC2TEB",
@@ -954,13 +952,57 @@
                     },
                     {
                       "name": "value",
+                      "properties": [
+                        {
+                          "name": "string",
+                          "type": "string"
+                        },
+                        {
+                          "name": "number",
+                          "type": "number"
+                        },
+                        {
+                          "name": "boolean",
+                          "type": "boolean"
+                        },
+                        {
+                          "name": "array",
+                          "type": "[string]"
+                        },
+                        {
+                          "name": "FormFIELDCHANGEChangeValue",
+                          "properties": [
+                            {
+                              "name": "name",
+                              "required": true,
+                              "type": "string"
+                            },
+                            {
+                              "name": "url",
+                              "required": true,
+                              "type": "string"
+                            },
+                            {
+                              "name": "mimeType",
+                              "required": true,
+                              "type": "string"
+                            },
+                            {
+                              "name": "sizeBytes",
+                              "required": true,
+                              "type": "number"
+                            }
+                          ],
+                          "type": "object"
+                        }
+                      ],
                       "required": true,
-                      "type": "object"
+                      "type": "union"
                     },
                     {
                       "name": "formValues",
                       "required": true,
-                      "type": "Map<string,object>"
+                      "type": "Map<string,opaque>"
                     }
                   ],
                   "type": "object"
@@ -1025,8 +1067,9 @@
                 "name": "@config.submit event",
                 "payloadSchema": [
                   {
-                    "name": "id",
-                    "type": "string"
+                    "name": "data",
+                    "required": true,
+                    "type": "@entity"
                   }
                 ],
                 "tier": "essential"
@@ -1036,12 +1079,6 @@
                 "id": "evt_01KXG04SPJWT4NNHT8EQNRH7NS",
                 "key": "@config.cancelEvent",
                 "name": "@config.cancel event",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               },
               {
@@ -1060,13 +1097,57 @@
                       },
                       {
                         "name": "value",
+                        "properties": [
+                          {
+                            "name": "string",
+                            "type": "string"
+                          },
+                          {
+                            "name": "number",
+                            "type": "number"
+                          },
+                          {
+                            "name": "boolean",
+                            "type": "boolean"
+                          },
+                          {
+                            "name": "array",
+                            "type": "[string]"
+                          },
+                          {
+                            "name": "FormFIELDCHANGEChangeValue",
+                            "properties": [
+                              {
+                                "name": "name",
+                                "required": true,
+                                "type": "string"
+                              },
+                              {
+                                "name": "url",
+                                "required": true,
+                                "type": "string"
+                              },
+                              {
+                                "name": "mimeType",
+                                "required": true,
+                                "type": "string"
+                              },
+                              {
+                                "name": "sizeBytes",
+                                "required": true,
+                                "type": "number"
+                              }
+                            ],
+                            "type": "object"
+                          }
+                        ],
                         "required": true,
-                        "type": "object"
+                        "type": "union"
                       },
                       {
                         "name": "formValues",
                         "required": true,
-                        "type": "Map<string,object>"
+                        "type": "Map<string,opaque>"
                       }
                     ],
                     "type": "object"

package/behaviors/registry/ui/core/organisms/ui-media-gallery.orb

@@ -355,6 +355,7 @@
           },
           "emits": [
             {
+              "definerKnob": "selectionEvent",
               "description": "Event name emitted when selection changes (emitted as UI:{selectionEvent})",
               "event": "@config.selectionEvent",
               "eventId": "evt_01KXG04STWF6EJB6RZPKZEB7ZS",
@@ -362,7 +363,7 @@
                 {
                   "name": "selection",
                   "required": true,
-                  "type": "[object]"
+                  "type": "[string]"
                 }
               ],
               "scope": "external",
@@ -426,7 +427,7 @@
                   {
                     "name": "selection",
                     "required": true,
-                    "type": "[object]"
+                    "type": "[string]"
                   }
                 ],
                 "tier": "essential"

package/behaviors/registry/ui/core/organisms/ui-segment-renderer.orb

@@ -93,14 +93,38 @@
               "type": "string"
             },
             "segments": {
-              "default": [],
+              "default": [
+                {
+                  "content": "Content",
+                  "type": "markdown"
+                },
+                {
+                  "content": "Content 2",
+                  "type": "markdown"
+                }
+              ],
               "description": "Parsed lesson segments (see `parseLessonSegments`)",
               "items": {
+                "properties": {
+                  "content": {
+                    "name": "content",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "type": {
+                    "name": "type",
+                    "required": true,
+                    "type": "string",
+                    "values": [
+                      "markdown"
+                    ]
+                  }
+                },
                 "type": "object"
               },
               "label": "Segments",
               "tier": "presentation",
-              "type": "[object]"
+              "type": "[SegmentRendererSegmentsItem]"
             },
             "userProgress": {
               "description": "User progress for restoring activation/reflection state",

package/behaviors/registry/ui/core/organisms/ui-subagent-trace-panel.orb

@@ -127,21 +127,21 @@
               "default": [],
               "description": "Full coordinator activities (tool calls, results, messages, errors).",
               "items": {
-                "type": "object"
+                "type": "opaque"
               },
               "label": "Coordinator Activities",
               "tier": "presentation",
-              "type": "[json]"
+              "type": "[opaque]"
             },
             "coordinatorMessages": {
               "default": [],
               "description": "Canonical Coordinator conversation — same shape live and on reload. When present, takes precedence over `coordinatorActivities` for the Coordinator section.",
               "items": {
-                "type": "object"
+                "type": "opaque"
               },
               "label": "Coordinator Messages",
               "tier": "presentation",
-              "type": "[json]"
+              "type": "[opaque]"
             },
             "disclosureLevel": {
               "default": 1.0,
@@ -265,11 +265,11 @@
               "default": [],
               "description": "All known subagents from the runner.",
               "items": {
-                "type": "object"
+                "type": "opaque"
               },
               "label": "Subagents",
               "tier": "presentation",
-              "type": "[json]"
+              "type": "[opaque]"
             },
             "totalCount": {
               "description": "Total number of items",
@@ -280,15 +280,10 @@
           },
           "emits": [
             {
+              "definerKnob": "onClose",
               "description": "Optional dismiss handler.",
               "event": "@config.onClose",
               "eventId": "evt_01KXG04T2ZM0RAP5SG9R021ZRC",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             },
@@ -349,12 +344,6 @@
                 "id": "evt_01KXG04T2ZM0RAP5SG9R021ZRC",
                 "key": "@config.onClose",
                 "name": "@config.on close",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               }
             ],

package/behaviors/registry/ui/core/organisms/ui-tabbed-container.orb

@@ -187,6 +187,7 @@
           },
           "emits": [
             {
+              "definerKnob": "onTabChange",
               "description": "Callback when tab changes",
               "event": "@config.onTabChange",
               "eventId": "evt_01KXG04T45ABQXZ1JSDXS2CCNQ",

package/behaviors/registry/ui/core/organisms/ui-timeline.orb

@@ -280,7 +280,13 @@
               "payloadSchema": [
                 {
                   "name": "id",
+                  "required": true,
                   "type": "string"
+                },
+                {
+                  "name": "row",
+                  "required": true,
+                  "type": "@entity"
                 }
               ],
               "scope": "external",
@@ -343,7 +349,13 @@
                 "payloadSchema": [
                   {
                     "name": "id",
+                    "required": true,
                     "type": "string"
+                  },
+                  {
+                    "name": "row",
+                    "required": true,
+                    "type": "@entity"
                   }
                 ],
                 "tier": "essential"

package/behaviors/registry/ui/core/templates/ui-counter-template.orb

@@ -242,41 +242,26 @@
           },
           "emits": [
             {
+              "definerKnob": "onIncrement",
               "description": "Called when increment is clicked",
               "event": "@config.onIncrement",
               "eventId": "evt_01KXG04TADGEMAVSQP576EWT36",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "onDecrement",
               "description": "Called when decrement is clicked",
               "event": "@config.onDecrement",
               "eventId": "evt_01KXG04TADBYD5EHNZRE69HDKZ",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "onReset",
               "description": "Called when reset is clicked",
               "event": "@config.onReset",
               "eventId": "evt_01KXG04TADKWPZVDR2YXHJ9EQX",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             },
@@ -334,12 +319,6 @@
                 "id": "evt_01KXG04TADGEMAVSQP576EWT36",
                 "key": "@config.onIncrement",
                 "name": "@config.on increment",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               },
               {
@@ -347,12 +326,6 @@
                 "id": "evt_01KXG04TADBYD5EHNZRE69HDKZ",
                 "key": "@config.onDecrement",
                 "name": "@config.on decrement",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               },
               {
@@ -360,12 +333,6 @@
                 "id": "evt_01KXG04TADKWPZVDR2YXHJ9EQX",
                 "key": "@config.onReset",
                 "name": "@config.on reset",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               }
             ],