@almadar/std 16.244.1 → 16.246.0

package/dist/index.js

@@ -2206,9 +2206,9 @@ var ARRAY_OPERATORS = {
     category: "std-array",
     minArity: 1,
     maxArity: 2,
-    description: "Minimum value (optionally by field)",
+    description: "Minimum value (optionally by field); null when no element counts",
     hasSideEffects: false,
-    returnType: "number",
+    returnType: "number | null",
     params: [
       { name: "arr", type: "array", description: "The array" },
       { name: "key", type: "string", description: "Field to compare", optional: true }
@@ -2220,9 +2220,9 @@ var ARRAY_OPERATORS = {
     category: "std-array",
     minArity: 1,
     maxArity: 2,
-    description: "Maximum value (optionally by field)",
+    description: "Maximum value (optionally by field); null when no element counts",
     hasSideEffects: false,
-    returnType: "number",
+    returnType: "number | null",
     params: [
       { name: "arr", type: "array", description: "The array" },
       { name: "key", type: "string", description: "Field to compare", optional: true }
@@ -9453,26 +9453,49 @@ function stdAgentContextAgentContextOrbital(params = {}) {
             "description": "The ephemeral conversation's own tools, carried through a summarizing.",
             "items": {
               "properties": {
-                "event": {
-                  "name": "event",
-                  "required": false,
-                  "type": "event"
+                "AgentToolInput": {
+                  "name": "AgentToolInput",
+                  "properties": {
+                    "event": {
+                      "name": "event",
+                      "required": true,
+                      "type": "EventAddress"
+                    }
+                  },
+                  "type": "object"
                 },
-                "read": {
-                  "name": "read",
-                  "required": false,
-                  "type": "string"
+                "AgentToolRead": {
+                  "name": "AgentToolRead",
+                  "properties": {
+                    "read": {
+                      "name": "read",
+                      "required": true,
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
                 },
-                "scope": {
-                  "name": "scope",
-                  "required": false,
-                  "type": "string",
-                  "values": [
-                    "declared"
-                  ]
+                "AgentToolScope": {
+                  "name": "AgentToolScope",
+                  "properties": {
+                    "scope": {
+                      "name": "scope",
+                      "required": true,
+                      "type": "string",
+                      "values": [
+                        "declared"
+                      ]
+                    }
+                  },
+                  "type": "object"
                 }
               },
-              "type": "object"
+              "type": "union",
+              "values": [
+                "AgentToolScope",
+                "AgentToolInput",
+                "AgentToolRead"
+              ]
             },
             "name": "pendingTools",
             "type": "array"
@@ -9564,23 +9587,8 @@ function stdAgentContextAgentContextOrbital(params = {}) {
                 "type": "string"
               },
               {
-                "entity": "AgentTool",
                 "name": "tools",
-                "properties": [
-                  {
-                    "name": "event",
-                    "type": "event"
-                  },
-                  {
-                    "name": "read",
-                    "type": "string"
-                  },
-                  {
-                    "name": "scope",
-                    "type": "string"
-                  }
-                ],
-                "type": "[object]"
+                "type": "[AgentTool]"
               },
               {
                 "name": "ephemeral",
@@ -9654,21 +9662,7 @@ function stdAgentContextAgentContextOrbital(params = {}) {
                 },
                 {
                   "name": "tools",
-                  "properties": [
-                    {
-                      "name": "event",
-                      "type": "event"
-                    },
-                    {
-                      "name": "read",
-                      "type": "string"
-                    },
-                    {
-                      "name": "scope",
-                      "type": "string"
-                    }
-                  ],
-                  "type": "[object]"
+                  "type": "[AgentTool]"
                 },
                 {
                   "name": "ephemeral",
@@ -9729,23 +9723,8 @@ function stdAgentContextAgentContextOrbital(params = {}) {
                   "type": "string"
                 },
                 {
-                  "entity": "AgentTool",
                   "name": "tools",
-                  "properties": [
-                    {
-                      "name": "event",
-                      "type": "event"
-                    },
-                    {
-                      "name": "read",
-                      "type": "string"
-                    },
-                    {
-                      "name": "scope",
-                      "type": "string"
-                    }
-                  ],
-                  "type": "[object]"
+                  "type": "[AgentTool]"
                 },
                 {
                   "name": "ephemeral",
@@ -10870,23 +10849,8 @@ function stdAgentMemoryAgentMemoryOrbital(params = {}) {
                 "type": "string"
               },
               {
-                "entity": "AgentTool",
                 "name": "tools",
-                "properties": [
-                  {
-                    "name": "event",
-                    "type": "event"
-                  },
-                  {
-                    "name": "read",
-                    "type": "string"
-                  },
-                  {
-                    "name": "scope",
-                    "type": "string"
-                  }
-                ],
-                "type": "[object]"
+                "type": "[AgentTool]"
               },
               {
                 "name": "ephemeral",
@@ -11261,21 +11225,7 @@ function stdAgentMemoryAgentMemoryOrbital(params = {}) {
                 },
                 {
                   "name": "tools",
-                  "properties": [
-                    {
-                      "name": "event",
-                      "type": "event"
-                    },
-                    {
-                      "name": "read",
-                      "type": "string"
-                    },
-                    {
-                      "name": "scope",
-                      "type": "string"
-                    }
-                  ],
-                  "type": "[object]"
+                  "type": "[AgentTool]"
                 },
                 {
                   "name": "ephemeral",
@@ -11431,23 +11381,8 @@ function stdAgentMemoryAgentMemoryOrbital(params = {}) {
                   "type": "string"
                 },
                 {
-                  "entity": "AgentTool",
                   "name": "tools",
-                  "properties": [
-                    {
-                      "name": "event",
-                      "type": "event"
-                    },
-                    {
-                      "name": "read",
-                      "type": "string"
-                    },
-                    {
-                      "name": "scope",
-                      "type": "string"
-                    }
-                  ],
-                  "type": "[object]"
+                  "type": "[AgentTool]"
                 },
                 {
                   "name": "ephemeral",
@@ -14994,26 +14929,49 @@ function stdAgentSessionAgentSessionOrbital(params = {}) {
             "description": "The ephemeral conversation's own tools (empty: none).",
             "items": {
               "properties": {
-                "event": {
-                  "name": "event",
-                  "required": false,
-                  "type": "event"
+                "AgentToolInput": {
+                  "name": "AgentToolInput",
+                  "properties": {
+                    "event": {
+                      "name": "event",
+                      "required": true,
+                      "type": "EventAddress"
+                    }
+                  },
+                  "type": "object"
                 },
-                "read": {
-                  "name": "read",
-                  "required": false,
-                  "type": "string"
+                "AgentToolRead": {
+                  "name": "AgentToolRead",
+                  "properties": {
+                    "read": {
+                      "name": "read",
+                      "required": true,
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
                 },
-                "scope": {
-                  "name": "scope",
-                  "required": false,
-                  "type": "string",
-                  "values": [
-                    "declared"
-                  ]
+                "AgentToolScope": {
+                  "name": "AgentToolScope",
+                  "properties": {
+                    "scope": {
+                      "name": "scope",
+                      "required": true,
+                      "type": "string",
+                      "values": [
+                        "declared"
+                      ]
+                    }
+                  },
+                  "type": "object"
                 }
               },
-              "type": "object"
+              "type": "union",
+              "values": [
+                "AgentToolScope",
+                "AgentToolInput",
+                "AgentToolRead"
+              ]
             },
             "name": "chatTools",
             "type": "array"
@@ -15979,23 +15937,8 @@ function stdAgentSessionAgentSessionOrbital(params = {}) {
                 "type": "string"
               },
               {
-                "entity": "AgentTool",
                 "name": "tools",
-                "properties": [
-                  {
-                    "name": "event",
-                    "type": "event"
-                  },
-                  {
-                    "name": "read",
-                    "type": "string"
-                  },
-                  {
-                    "name": "scope",
-                    "type": "string"
-                  }
-                ],
-                "type": "[object]"
+                "type": "[AgentTool]"
               },
               {
                 "name": "ephemeral",
@@ -16240,21 +16183,7 @@ function stdAgentSessionAgentSessionOrbital(params = {}) {
                 },
                 {
                   "name": "tools",
-                  "properties": [
-                    {
-                      "name": "event",
-                      "type": "event"
-                    },
-                    {
-                      "name": "read",
-                      "type": "string"
-                    },
-                    {
-                      "name": "scope",
-                      "type": "string"
-                    }
-                  ],
-                  "type": "[object]"
+                  "type": "[AgentTool]"
                 },
                 {
                   "name": "title",
@@ -16467,23 +16396,8 @@ function stdAgentSessionAgentSessionOrbital(params = {}) {
                   "type": "string"
                 },
                 {
-                  "entity": "AgentTool",
                   "name": "tools",
-                  "properties": [
-                    {
-                      "name": "event",
-                      "type": "event"
-                    },
-                    {
-                      "name": "read",
-                      "type": "string"
-                    },
-                    {
-                      "name": "scope",
-                      "type": "string"
-                    }
-                  ],
-                  "type": "[object]"
+                  "type": "[AgentTool]"
                 },
                 {
                   "name": "ephemeral",
@@ -26453,26 +26367,49 @@ function stdAgentToolLoopAgentToolLoopOrbital(params = {}) {
             "description": "The declared inputs it may fire (`{ event: Trait.EVENT }`) and the entities it may read (`{ read: Entity }`), as the signed-in user.",
             "items": {
               "properties": {
-                "event": {
-                  "name": "event",
-                  "required": false,
-                  "type": "event"
+                "AgentToolInput": {
+                  "name": "AgentToolInput",
+                  "properties": {
+                    "event": {
+                      "name": "event",
+                      "required": true,
+                      "type": "EventAddress"
+                    }
+                  },
+                  "type": "object"
                 },
-                "read": {
-                  "name": "read",
-                  "required": false,
-                  "type": "string"
+                "AgentToolRead": {
+                  "name": "AgentToolRead",
+                  "properties": {
+                    "read": {
+                      "name": "read",
+                      "required": true,
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
                 },
-                "scope": {
-                  "name": "scope",
-                  "required": false,
-                  "type": "string",
-                  "values": [
-                    "declared"
-                  ]
+                "AgentToolScope": {
+                  "name": "AgentToolScope",
+                  "properties": {
+                    "scope": {
+                      "name": "scope",
+                      "required": true,
+                      "type": "string",
+                      "values": [
+                        "declared"
+                      ]
+                    }
+                  },
+                  "type": "object"
                 }
               },
-              "type": "object"
+              "type": "union",
+              "values": [
+                "AgentToolScope",
+                "AgentToolInput",
+                "AgentToolRead"
+              ]
             },
             "label": "What may the assistant do?",
             "synonyms": "allowlist, abilities, actions, permissions",
@@ -26857,21 +26794,7 @@ function stdAgentToolLoopAgentToolLoopOrbital(params = {}) {
                 },
                 {
                   "name": "tools",
-                  "properties": [
-                    {
-                      "name": "event",
-                      "type": "event"
-                    },
-                    {
-                      "name": "read",
-                      "type": "string"
-                    },
-                    {
-                      "name": "scope",
-                      "type": "string"
-                    }
-                  ],
-                  "type": "[object]"
+                  "type": "[AgentTool]"
                 },
                 {
                   "name": "ephemeral",
@@ -43665,7 +43588,7 @@ function stdCalendarCalendarEventOrbital(params = {}) {
                 "when": {
                   "name": "when",
                   "required": false,
-                  "type": "object"
+                  "type": "SExpr"
                 }
               },
               "type": "object"
@@ -43690,7 +43613,7 @@ function stdCalendarCalendarEventOrbital(params = {}) {
                           "type": "icon"
                         },
                         {
-                          "content": "Agenda",
+                          "content": "@config.title",
                           "type": "typography",
                           "variant": "h2"
                         }
@@ -43708,7 +43631,8 @@ function stdCalendarCalendarEventOrbital(params = {}) {
                   "direction": "horizontal",
                   "gap": "md",
                   "justify": "between",
-                  "type": "stack"
+                  "type": "stack",
+                  "wrap": true
                 },
                 [
                   "if",
@@ -43771,6 +43695,7 @@ function stdCalendarCalendarEventOrbital(params = {}) {
                   "fields": [],
                   "gap": "md",
                   "groupBy": "@config.agendaGroupBy",
+                  "groupFormat": "date",
                   "itemActions": [
                     "array/filter",
                     "@config.agendaItemActions",
@@ -43824,18 +43749,20 @@ function stdCalendarCalendarEventOrbital(params = {}) {
                                   "variant": "overline"
                                 },
                                 {
+                                  "className": "hidden sm:block",
                                   "color": "muted",
                                   "name": "clock",
                                   "size": "sm",
                                   "type": "icon"
                                 }
                               ],
-                              "className": "w-16 shrink-0",
+                              "className": "w-14 sm:w-16 shrink-0",
                               "direction": "vertical",
                               "gap": "xs",
                               "type": "stack"
                             },
                             {
+                              "className": "hidden sm:block",
                               "orientation": "vertical",
                               "type": "divider"
                             },
@@ -43845,13 +43772,14 @@ function stdCalendarCalendarEventOrbital(params = {}) {
                                   "align": "center",
                                   "children": [
                                     {
-                                      "className": "truncate",
+                                      "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",
@@ -43861,7 +43789,8 @@ function stdCalendarCalendarEventOrbital(params = {}) {
                                   "direction": "horizontal",
                                   "gap": "sm",
                                   "justify": "between",
-                                  "type": "stack"
+                                  "type": "stack",
+                                  "wrap": true
                                 },
                                 {
                                   "className": "truncate",
@@ -43887,6 +43816,7 @@ function stdCalendarCalendarEventOrbital(params = {}) {
                       "type": "card"
                     }
                   ],
+                  "surface": "none",
                   "type": "data-list",
                   "variant": "default"
                 }
@@ -43941,7 +43871,8 @@ function stdCalendarCalendarEventOrbital(params = {}) {
                   "direction": "horizontal",
                   "gap": "md",
                   "justify": "between",
-                  "type": "stack"
+                  "type": "stack",
+                  "wrap": true
                 },
                 [
                   "if",
@@ -44322,7 +44253,7 @@ function stdCalendarCalendarEventOrbital(params = {}) {
                           "type": "icon"
                         },
                         {
-                          "content": "Week",
+                          "content": "@config.title",
                           "type": "typography",
                           "variant": "h2"
                         }
@@ -44372,7 +44303,8 @@ function stdCalendarCalendarEventOrbital(params = {}) {
                   "direction": "horizontal",
                   "gap": "md",
                   "justify": "between",
-                  "type": "stack"
+                  "type": "stack",
+                  "wrap": true
                 },
                 [
                   "if",
@@ -194646,7 +194578,7 @@ function stdUiDetailPanelDetailPanelOrbital(params = {}) {
                 "payload": {
                   "name": "payload",
                   "required": false,
-                  "type": "object"
+                  "type": "SExpr"
                 },
                 "roles": {
                   "items": {
@@ -194670,7 +194602,7 @@ function stdUiDetailPanelDetailPanelOrbital(params = {}) {
                 "when": {
                   "name": "when",
                   "required": false,
-                  "type": "object"
+                  "type": "SExpr"
                 }
               },
               "type": "object"
@@ -194879,7 +194811,7 @@ function stdUiDetailPanelDetailPanelOrbital(params = {}) {
               "payload": {
                 "name": "payload",
                 "required": false,
-                "type": "object"
+                "type": "SExpr"
               },
               "variant": {
                 "name": "variant",
@@ -194895,7 +194827,7 @@ function stdUiDetailPanelDetailPanelOrbital(params = {}) {
               "when": {
                 "name": "when",
                 "required": false,
-                "type": "object"
+                "type": "SExpr"
               }
             },
             "tier": "presentation",
@@ -197851,7 +197783,7 @@ function stdUiFormFormOrbital(params = {}) {
             "default": {},
             "description": "Inspection form extensions",
             "items": {
-              "type": "object"
+              "type": "SExpr"
             },
             "label": "Conditional Fields",
             "tier": "presentation",
@@ -198526,7 +198458,7 @@ function stdUiFormFormOrbital(params = {}) {
                 "expression": {
                   "name": "expression",
                   "required": true,
-                  "type": "object"
+                  "type": "SExpr"
                 },
                 "triggerFields": {
                   "items": {
@@ -198750,7 +198682,7 @@ function stdUiFormFormOrbital(params = {}) {
                 "condition": {
                   "name": "condition",
                   "required": false,
-                  "type": "object"
+                  "type": "SExpr"
                 },
                 "fields": {
                   "items": {
@@ -199066,7 +198998,7 @@ function stdUiFormFormOrbital(params = {}) {
                 "condition": {
                   "name": "condition",
                   "required": true,
-                  "type": "object"
+                  "type": "SExpr"
                 },
                 "fieldId": {
                   "name": "fieldId",
@@ -199922,7 +199854,7 @@ function stdUiFormSectionFormSectionOrbital(params = {}) {
             "default": {},
             "description": "Inspection form extensions",
             "items": {
-              "type": "object"
+              "type": "SExpr"
             },
             "label": "Conditional Fields",
             "tier": "presentation",
@@ -200597,7 +200529,7 @@ function stdUiFormSectionFormSectionOrbital(params = {}) {
                 "expression": {
                   "name": "expression",
                   "required": true,
-                  "type": "object"
+                  "type": "SExpr"
                 },
                 "triggerFields": {
                   "items": {
@@ -200821,7 +200753,7 @@ function stdUiFormSectionFormSectionOrbital(params = {}) {
                 "condition": {
                   "name": "condition",
                   "required": false,
-                  "type": "object"
+                  "type": "SExpr"
                 },
                 "fields": {
                   "items": {
@@ -201137,7 +201069,7 @@ function stdUiFormSectionFormSectionOrbital(params = {}) {
                 "condition": {
                   "name": "condition",
                   "required": true,
-                  "type": "object"
+                  "type": "SExpr"
                 },
                 "fieldId": {
                   "name": "fieldId",
@@ -206652,6 +206584,92 @@ function stdUiStateMachineViewStateMachineViewOrbital(params = {}) {
             "tier": "presentation",
             "type": "number"
           },
+          "annotations": {
+            "default": {
+              "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."
+                }
+              }
+            },
+            "description": "Author explanations shown in a popover on hover: a note per state name, per transition event and per effect type.",
+            "label": "Annotations",
+            "properties": {
+              "effects": {
+                "items": {
+                  "properties": {
+                    "body": {
+                      "name": "body",
+                      "required": true,
+                      "type": "string"
+                    },
+                    "title": {
+                      "name": "title",
+                      "required": false,
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "name": "effects",
+                "required": false,
+                "type": "object"
+              },
+              "states": {
+                "items": {
+                  "properties": {
+                    "body": {
+                      "name": "body",
+                      "required": true,
+                      "type": "string"
+                    },
+                    "title": {
+                      "name": "title",
+                      "required": false,
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "name": "states",
+                "required": false,
+                "type": "object"
+              },
+              "transitions": {
+                "items": {
+                  "properties": {
+                    "body": {
+                      "name": "body",
+                      "required": true,
+                      "type": "string"
+                    },
+                    "title": {
+                      "name": "title",
+                      "required": false,
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "name": "transitions",
+                "required": false,
+                "type": "object"
+              }
+            },
+            "tier": "presentation",
+            "type": "StateMachineViewAnnotations"
+          },
           "ariaBusy": {
             "description": "This region is updating; assistive technology waits before announcing it.",
             "label": "Aria-busy",
@@ -207059,7 +207077,7 @@ function stdUiStateMachineViewStateMachineViewOrbital(params = {}) {
                         "properties": {
                           "args": {
                             "items": {
-                              "type": "object"
+                              "type": "SExpr"
                             },
                             "name": "args",
                             "required": true,
@@ -207090,7 +207108,7 @@ function stdUiStateMachineViewStateMachineViewOrbital(params = {}) {
                     "guard": {
                       "name": "guard",
                       "required": false,
-                      "type": "object"
+                      "type": "SExpr"
                     },
                     "index": {
                       "name": "index",
@@ -207306,6 +207324,7 @@ function stdUiStateMachineViewStateMachineViewOrbital(params = {}) {
                   {
                     "activeState": "@config.activeState",
                     "activeTransition": "@config.activeTransition",
+                    "annotations": "@config.annotations",
                     "aria-busy": "@config.ariaBusy",
                     "aria-current": "@config.ariaCurrent",
                     "aria-describedby": "@config.ariaDescribedby",