@almadar/std 16.245.0 → 16.246.1

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",
@@ -194655,7 +194578,7 @@ function stdUiDetailPanelDetailPanelOrbital(params = {}) {
                 "payload": {
                   "name": "payload",
                   "required": false,
-                  "type": "object"
+                  "type": "SExpr"
                 },
                 "roles": {
                   "items": {
@@ -194679,7 +194602,7 @@ function stdUiDetailPanelDetailPanelOrbital(params = {}) {
                 "when": {
                   "name": "when",
                   "required": false,
-                  "type": "object"
+                  "type": "SExpr"
                 }
               },
               "type": "object"
@@ -194888,7 +194811,7 @@ function stdUiDetailPanelDetailPanelOrbital(params = {}) {
               "payload": {
                 "name": "payload",
                 "required": false,
-                "type": "object"
+                "type": "SExpr"
               },
               "variant": {
                 "name": "variant",
@@ -194904,7 +194827,7 @@ function stdUiDetailPanelDetailPanelOrbital(params = {}) {
               "when": {
                 "name": "when",
                 "required": false,
-                "type": "object"
+                "type": "SExpr"
               }
             },
             "tier": "presentation",
@@ -197860,7 +197783,7 @@ function stdUiFormFormOrbital(params = {}) {
             "default": {},
             "description": "Inspection form extensions",
             "items": {
-              "type": "object"
+              "type": "SExpr"
             },
             "label": "Conditional Fields",
             "tier": "presentation",
@@ -198535,7 +198458,7 @@ function stdUiFormFormOrbital(params = {}) {
                 "expression": {
                   "name": "expression",
                   "required": true,
-                  "type": "object"
+                  "type": "SExpr"
                 },
                 "triggerFields": {
                   "items": {
@@ -198759,7 +198682,7 @@ function stdUiFormFormOrbital(params = {}) {
                 "condition": {
                   "name": "condition",
                   "required": false,
-                  "type": "object"
+                  "type": "SExpr"
                 },
                 "fields": {
                   "items": {
@@ -199075,7 +198998,7 @@ function stdUiFormFormOrbital(params = {}) {
                 "condition": {
                   "name": "condition",
                   "required": true,
-                  "type": "object"
+                  "type": "SExpr"
                 },
                 "fieldId": {
                   "name": "fieldId",
@@ -199931,7 +199854,7 @@ function stdUiFormSectionFormSectionOrbital(params = {}) {
             "default": {},
             "description": "Inspection form extensions",
             "items": {
-              "type": "object"
+              "type": "SExpr"
             },
             "label": "Conditional Fields",
             "tier": "presentation",
@@ -200606,7 +200529,7 @@ function stdUiFormSectionFormSectionOrbital(params = {}) {
                 "expression": {
                   "name": "expression",
                   "required": true,
-                  "type": "object"
+                  "type": "SExpr"
                 },
                 "triggerFields": {
                   "items": {
@@ -200830,7 +200753,7 @@ function stdUiFormSectionFormSectionOrbital(params = {}) {
                 "condition": {
                   "name": "condition",
                   "required": false,
-                  "type": "object"
+                  "type": "SExpr"
                 },
                 "fields": {
                   "items": {
@@ -201146,7 +201069,7 @@ function stdUiFormSectionFormSectionOrbital(params = {}) {
                 "condition": {
                   "name": "condition",
                   "required": true,
-                  "type": "object"
+                  "type": "SExpr"
                 },
                 "fieldId": {
                   "name": "fieldId",
@@ -206661,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",
@@ -207068,7 +207077,7 @@ function stdUiStateMachineViewStateMachineViewOrbital(params = {}) {
                         "properties": {
                           "args": {
                             "items": {
-                              "type": "object"
+                              "type": "SExpr"
                             },
                             "name": "args",
                             "required": true,
@@ -207099,7 +207108,7 @@ function stdUiStateMachineViewStateMachineViewOrbital(params = {}) {
                     "guard": {
                       "name": "guard",
                       "required": false,
-                      "type": "object"
+                      "type": "SExpr"
                     },
                     "index": {
                       "name": "index",
@@ -207315,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",
@@ -213016,29 +213026,56 @@ async function getFactorySignatureCatalog() {
 
 // behaviors/knob-embeddings.ts
 var pending4 = null;
-function decodeVector2(stored) {
-  if (!("d" in stored)) return stored;
-  const bytes = Buffer.from(stored.d, "base64");
-  const out = new Array(bytes.length);
-  for (let i = 0; i < bytes.length; i++) {
-    out[i] = bytes.readInt8(i) * stored.s / 127;
+function writeVector(stored, slot) {
+  if ("d" in stored) {
+    const bytes = Buffer.from(stored.d, "base64");
+    if (bytes.length !== slot.length) return false;
+    slot.set(new Int8Array(bytes.buffer, bytes.byteOffset, bytes.length));
+    return true;
   }
-  return out;
+  if (stored.length !== slot.length) return false;
+  let maxAbs = 0;
+  for (const v of stored) maxAbs = Math.max(maxAbs, Math.abs(v));
+  for (let i = 0; i < stored.length; i++) {
+    slot[i] = maxAbs === 0 ? 0 : Math.round(stored[i] * 127 / maxAbs);
+  }
+  return true;
 }
-function reconstructVectors(parsed) {
+function decodeKnobEmbeddingsFile(parsed) {
+  const interned = typeof parsed?.table === "object" && typeof parsed?.keys === "object";
+  const nonInterned = typeof parsed?.vectors === "object" && parsed.vectors !== null;
+  if (typeof parsed?.model !== "string" || typeof parsed?.dimensions !== "number" || !interned && !nonInterned) {
+    return null;
+  }
+  const dims = parsed.dimensions;
+  const stored = interned ? parsed.table ?? [] : Object.values(parsed.vectors ?? {});
+  const backing = new Int8Array(stored.length * dims);
+  const slots = [];
+  for (let i = 0; i < stored.length; i++) {
+    const slot = backing.subarray(i * dims, (i + 1) * dims);
+    if (!writeVector(stored[i], slot)) return null;
+    slots.push(slot);
+  }
   const vectors = {};
-  if (parsed.table && parsed.keys) {
-    const decoded = parsed.table.map(decodeVector2);
-    for (const [key, idx] of Object.entries(parsed.keys)) {
-      const vec = decoded[idx];
-      if (vec) vectors[key] = vec;
+  if (interned) {
+    for (const [key, idx] of Object.entries(parsed.keys ?? {})) {
+      const slot = slots[idx];
+      if (slot) vectors[key] = slot;
     }
-    return vectors;
+  } else {
+    Object.keys(parsed.vectors ?? {}).forEach((key, i) => {
+      vectors[key] = slots[i];
+    });
   }
-  for (const [key, stored] of Object.entries(parsed.vectors ?? {})) {
-    vectors[key] = decodeVector2(stored);
+  return { version: parsed.version ?? "", model: parsed.model, dimensions: dims, vectors };
+}
+async function readKnobEmbeddingsFile(path) {
+  try {
+    const { readFileSync } = await import('fs');
+    return decodeKnobEmbeddingsFile(JSON.parse(readFileSync(path, "utf-8")));
+  } catch {
+    return null;
   }
-  return vectors;
 }
 function loadManifest2() {
   pending4 ?? (pending4 = loadManifestUncached2().then((m) => {
@@ -213048,26 +213085,8 @@ function loadManifest2() {
   return pending4;
 }
 async function loadManifestUncached2() {
-  try {
-    const { readFileSync } = await import('fs');
-    const { resolve } = await import('path');
-    const dir = await resolveStdDataDir();
-    const raw = readFileSync(resolve(dir, "knob-embeddings.json"), "utf-8");
-    const parsed = JSON.parse(raw);
-    const interned = typeof parsed?.table === "object" && typeof parsed?.keys === "object";
-    const nonInterned = typeof parsed?.vectors === "object" && parsed.vectors !== null;
-    if (typeof parsed?.model !== "string" || typeof parsed?.dimensions !== "number" || !interned && !nonInterned) {
-      return null;
-    }
-    return {
-      version: parsed.version,
-      model: parsed.model,
-      dimensions: parsed.dimensions,
-      vectors: reconstructVectors(parsed)
-    };
-  } catch {
-    return null;
-  }
+  const { resolve } = await import('path');
+  return readKnobEmbeddingsFile(resolve(await resolveStdDataDir(), "knob-embeddings.json"));
 }
 async function getKnobEmbeddings() {
   return loadManifest2();