@almadar/std 16.197.0 → 16.198.0

package/behaviors/registry/infra/atoms/std-migration-job.orb

@@ -214,12 +214,56 @@
             "default": {},
             "description": "ImportSource descriptor of the run (kind + options), supplied by the host.",
             "name": "source",
+            "properties": {
+              "event": {
+                "name": "event",
+                "required": false,
+                "type": "string"
+              },
+              "id": {
+                "name": "id",
+                "required": true,
+                "type": "string"
+              },
+              "kind": {
+                "name": "kind",
+                "required": true,
+                "type": "string"
+              },
+              "label": {
+                "name": "label",
+                "required": true,
+                "type": "string"
+              }
+            },
             "type": "object"
           },
           {
             "default": [],
             "description": "Client-side file metadata for upload sources (name/size/type/lastModified).",
             "items": {
+              "properties": {
+                "lastModified": {
+                  "name": "lastModified",
+                  "required": false,
+                  "type": "number"
+                },
+                "name": {
+                  "name": "name",
+                  "required": false,
+                  "type": "string"
+                },
+                "size": {
+                  "name": "size",
+                  "required": false,
+                  "type": "number"
+                },
+                "type": {
+                  "name": "type",
+                  "required": false,
+                  "type": "string"
+                }
+              },
               "type": "object"
             },
             "name": "files",
@@ -248,29 +292,54 @@
           },
           {
             "default": [],
-            "description": "Document metadata listed from the source.",
+            "description": "Document metadata listed from the source — migration.listDocuments service result, never destructured by the atom.",
             "items": {
-              "type": "object"
+              "type": "opaque"
             },
             "name": "documents",
             "type": "array"
           },
           {
             "default": {},
-            "description": "Most recently fetched document content.",
+            "description": "Most recently fetched document content — migration.fetchDocument service result, never destructured by the atom.",
             "name": "document",
-            "type": "object"
+            "type": "opaque"
           },
           {
             "default": {},
-            "description": "Staged/committed/failed/skipped counts.",
+            "description": "Staged/committed/failed/skipped counts — merged from host staging and migration.commit service results, never destructured by the atom.",
             "name": "stats",
-            "type": "object"
+            "type": "opaque"
           },
           {
             "default": [],
             "description": "Staged ImportUnits ready for review (ref/targetEntity/fields/parentRef), when the host stages the full rows rather than aggregate stats only.",
             "items": {
+              "properties": {
+                "fields": {
+                  "items": {
+                    "type": "scalar"
+                  },
+                  "name": "fields",
+                  "required": false,
+                  "type": "object"
+                },
+                "parentRef": {
+                  "name": "parentRef",
+                  "required": false,
+                  "type": "string"
+                },
+                "ref": {
+                  "name": "ref",
+                  "required": true,
+                  "type": "string"
+                },
+                "targetEntity": {
+                  "name": "targetEntity",
+                  "required": true,
+                  "type": "string"
+                }
+              },
               "type": "object"
             },
             "name": "units",
@@ -281,6 +350,18 @@
             "default": [],
             "description": "Source elements skipped during staging with a reason each, when the host stages the full rows rather than aggregate stats only.",
             "items": {
+              "properties": {
+                "reason": {
+                  "name": "reason",
+                  "required": true,
+                  "type": "string"
+                },
+                "ref": {
+                  "name": "ref",
+                  "required": true,
+                  "type": "string"
+                }
+              },
               "type": "object"
             },
             "name": "skipped",
@@ -291,7 +372,7 @@
             "default": [],
             "description": "Validation errors surfaced during staging, when the host stages the full rows rather than aggregate stats only.",
             "items": {
-              "type": "object"
+              "type": "opaque"
             },
             "name": "validationErrors",
             "synonyms": "staging errors, validation issues, import errors",
@@ -367,7 +448,7 @@
                 {
                   "name": "documents",
                   "required": true,
-                  "type": "[object]"
+                  "type": "[opaque]"
                 }
               ],
               "tier": "secondary"
@@ -380,7 +461,7 @@
                 {
                   "name": "document",
                   "required": true,
-                  "type": "object"
+                  "type": "opaque"
                 }
               ],
               "tier": "secondary"
@@ -398,7 +479,7 @@
                 {
                   "name": "failed",
                   "required": true,
-                  "type": "[object]"
+                  "type": "[opaque]"
                 }
               ],
               "tier": "secondary"
@@ -424,7 +505,7 @@
                 {
                   "name": "documents",
                   "required": true,
-                  "type": "[object]"
+                  "type": "[opaque]"
                 }
               ],
               "scope": "external",
@@ -439,7 +520,7 @@
                 {
                   "name": "document",
                   "required": true,
-                  "type": "object"
+                  "type": "opaque"
                 }
               ],
               "scope": "external",
@@ -454,19 +535,19 @@
                 {
                   "name": "stats",
                   "required": true,
-                  "type": "object"
+                  "type": "opaque"
                 },
                 {
                   "name": "units",
-                  "type": "[object]"
+                  "type": "[ImportUnit]"
                 },
                 {
                   "name": "skipped",
-                  "type": "[object]"
+                  "type": "[ImportSkip]"
                 },
                 {
                   "name": "validationErrors",
-                  "type": "[object]"
+                  "type": "[opaque]"
                 }
               ],
               "scope": "external",
@@ -481,7 +562,7 @@
                 {
                   "name": "stats",
                   "required": true,
-                  "type": "object"
+                  "type": "opaque"
                 }
               ],
               "scope": "external",
@@ -544,11 +625,50 @@
                 "payloadSchema": [
                   {
                     "name": "source",
+                    "properties": [
+                      {
+                        "name": "id",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "kind",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "label",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "event",
+                        "type": "string"
+                      }
+                    ],
                     "required": true,
                     "type": "object"
                   },
                   {
                     "name": "files",
+                    "properties": [
+                      {
+                        "name": "name",
+                        "type": "string"
+                      },
+                      {
+                        "name": "size",
+                        "type": "number"
+                      },
+                      {
+                        "name": "type",
+                        "type": "string"
+                      },
+                      {
+                        "name": "lastModified",
+                        "type": "number"
+                      }
+                    ],
                     "type": "[object]"
                   }
                 ],
@@ -564,7 +684,7 @@
                   {
                     "name": "documents",
                     "required": true,
-                    "type": "[object]"
+                    "type": "[opaque]"
                   }
                 ],
                 "tier": "secondary"
@@ -578,7 +698,7 @@
                   {
                     "name": "documents",
                     "required": true,
-                    "type": "[object]"
+                    "type": "[opaque]"
                   }
                 ],
                 "synonyms": "import fetched, source listed, documents ready",
@@ -593,7 +713,7 @@
                   {
                     "name": "document",
                     "required": true,
-                    "type": "object"
+                    "type": "opaque"
                   }
                 ],
                 "synonyms": "document loaded, content fetched",
@@ -636,7 +756,7 @@
                   {
                     "name": "document",
                     "required": true,
-                    "type": "object"
+                    "type": "opaque"
                   }
                 ],
                 "tier": "secondary"
@@ -650,19 +770,51 @@
                   {
                     "name": "stats",
                     "required": true,
-                    "type": "object"
+                    "type": "opaque"
                   },
                   {
                     "name": "units",
+                    "properties": [
+                      {
+                        "name": "ref",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "targetEntity",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "fields",
+                        "type": "Map<string,scalar>"
+                      },
+                      {
+                        "name": "parentRef",
+                        "type": "string"
+                      }
+                    ],
                     "type": "[object]"
                   },
                   {
                     "name": "skipped",
+                    "properties": [
+                      {
+                        "name": "ref",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "reason",
+                        "required": true,
+                        "type": "string"
+                      }
+                    ],
                     "type": "[object]"
                   },
                   {
                     "name": "validationErrors",
-                    "type": "[object]"
+                    "type": "[opaque]"
                   }
                 ],
                 "tier": "internal"
@@ -682,6 +834,26 @@
                 "payloadSchema": [
                   {
                     "name": "units",
+                    "properties": [
+                      {
+                        "name": "ref",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "targetEntity",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "fields",
+                        "type": "Map<string,scalar>"
+                      },
+                      {
+                        "name": "parentRef",
+                        "type": "string"
+                      }
+                    ],
                     "type": "[object]"
                   }
                 ],
@@ -704,19 +876,19 @@
                   {
                     "name": "stats",
                     "required": true,
-                    "type": "object"
+                    "type": "opaque"
                   },
                   {
                     "name": "units",
-                    "type": "[object]"
+                    "type": "[ImportUnit]"
                   },
                   {
                     "name": "skipped",
-                    "type": "[object]"
+                    "type": "[ImportSkip]"
                   },
                   {
                     "name": "validationErrors",
-                    "type": "[object]"
+                    "type": "[opaque]"
                   }
                 ],
                 "synonyms": "preview ready, staging complete, review import",
@@ -736,7 +908,7 @@
                   {
                     "name": "failed",
                     "required": true,
-                    "type": "[object]"
+                    "type": "[opaque]"
                   }
                 ],
                 "tier": "secondary"
@@ -757,7 +929,7 @@
                   {
                     "name": "stats",
                     "required": true,
-                    "type": "object"
+                    "type": "opaque"
                   }
                 ],
                 "synonyms": "import done, migration complete, data imported",

package/behaviors/registry/infra/atoms/std-notify-on-event.orb

@@ -836,7 +836,7 @@
                 "payloadSchema": [
                   {
                     "name": "data",
-                    "type": "object"
+                    "type": "opaque"
                   },
                   {
                     "name": "status",

package/behaviors/registry/infra/atoms/std-reminder-scheduler.orb

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

package/behaviors/registry/ml/atoms/std-data-collector.orb

@@ -73,7 +73,7 @@
             "default": [],
             "description": "Data points accumulated in the current cycle.",
             "items": {
-              "type": "string"
+              "type": "opaque"
             },
             "name": "buffer",
             "type": "array"
@@ -134,7 +134,7 @@
                 {
                   "name": "buffer",
                   "required": true,
-                  "type": "[any]"
+                  "type": "[opaque]"
                 },
                 {
                   "name": "count",
@@ -178,7 +178,7 @@
                   {
                     "name": "point",
                     "required": true,
-                    "type": "any"
+                    "type": "opaque"
                   }
                 ]
               },
@@ -191,7 +191,7 @@
                   {
                     "name": "buffer",
                     "required": true,
-                    "type": "[any]"
+                    "type": "[opaque]"
                   },
                   {
                     "name": "count",

package/behaviors/registry/ml/atoms/std-graph-builder.orb

@@ -81,6 +81,9 @@
           {
             "default": [],
             "items": {
+              "items": {
+                "type": "scalar"
+              },
               "type": "object"
             },
             "name": "nodes",
@@ -89,6 +92,18 @@
           {
             "default": [],
             "items": {
+              "properties": {
+                "source": {
+                  "name": "source",
+                  "required": true,
+                  "type": "string"
+                },
+                "target": {
+                  "name": "target",
+                  "required": true,
+                  "type": "string"
+                }
+              },
               "type": "object"
             },
             "name": "edges",
@@ -171,12 +186,12 @@
                 {
                   "name": "nodes",
                   "required": true,
-                  "type": "[object]"
+                  "type": "[Map<string,scalar>]"
                 },
                 {
                   "name": "edges",
                   "required": true,
-                  "type": "[object]"
+                  "type": "[GraphBuilderEdge]"
                 },
                 {
                   "name": "nodeCount",
@@ -216,7 +231,7 @@
                   {
                     "name": "entities",
                     "required": true,
-                    "type": "[object]"
+                    "type": "[opaque]"
                   }
                 ]
               },
@@ -234,12 +249,12 @@
                   {
                     "name": "nodes",
                     "required": true,
-                    "type": "[object]"
+                    "type": "[Map<string,scalar>]"
                   },
                   {
                     "name": "edges",
                     "required": true,
-                    "type": "[object]"
+                    "type": "[GraphBuilderEdge]"
                   },
                   {
                     "name": "nodeCount",

package/behaviors/registry/ml/atoms/std-ml-classify.orb

@@ -133,6 +133,34 @@
           {
             "default": {},
             "name": "request",
+            "properties": {
+              "accepted": {
+                "items": {
+                  "type": "scalar"
+                },
+                "name": "accepted",
+                "required": true,
+                "type": "array"
+              },
+              "candidate": {
+                "name": "candidate",
+                "required": true,
+                "type": "scalar"
+              },
+              "categories": {
+                "items": {
+                  "type": "string"
+                },
+                "name": "categories",
+                "required": true,
+                "type": "array"
+              },
+              "key": {
+                "name": "key",
+                "required": true,
+                "type": "scalar"
+              }
+            },
             "type": "object"
           },
           {
@@ -297,6 +325,28 @@
                   },
                   {
                     "name": "request",
+                    "properties": [
+                      {
+                        "name": "candidate",
+                        "required": true,
+                        "type": "scalar"
+                      },
+                      {
+                        "name": "key",
+                        "required": true,
+                        "type": "scalar"
+                      },
+                      {
+                        "name": "accepted",
+                        "required": true,
+                        "type": "[scalar]"
+                      },
+                      {
+                        "name": "categories",
+                        "required": true,
+                        "type": "[string]"
+                      }
+                    ],
                     "type": "object"
                   }
                 ]