@almadar/std 6.5.2 → 7.2.0

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

@@ -1,14 +1,14 @@
 {
   "name": "std-agent-classifier",
   "version": "1.0.0",
-  "description": "Classification flow atom for agent-powered text classification. Composes UI atoms (stdModal for input form, stdNotification for result badge) with an agent trait that uses agent/generate with a classification prompt.",
+  "description": "std-agent-classifier as a Function",
   "orbitals": [
     {
       "name": "AgentClassifierOrbital",
       "entity": {
         "name": "AgentClassifier",
-        "persistence": "persistent",
         "collection": "agentclassifiers",
+        "persistence": "persistent",
         "fields": [
           {
             "name": "id",
@@ -49,7 +49,7 @@
           {
             "name": "confidence",
             "type": "number",
-            "default": 0
+            "default": 0.0
           },
           {
             "name": "model",
@@ -71,16 +71,80 @@
       "traits": [
         {
           "name": "AgentClassifierModal",
-          "linkedEntity": "AgentClassifier",
           "category": "interaction",
+          "linkedEntity": "AgentClassifier",
           "emits": [
             {
-              "event": "SAVE",
-              "scope": "external"
+              "event": "CLASSIFIED",
+              "scope": "external",
+              "payload": [
+                {
+                  "name": "id",
+                  "type": "string"
+                }
+              ]
             },
             {
-              "event": "CLASSIFIED",
-              "scope": "external"
+              "event": "AgentClassifierLoaded",
+              "description": "Fired when AgentClassifier finishes loading",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "id",
+                  "type": "string"
+                },
+                {
+                  "name": "name",
+                  "type": "string"
+                },
+                {
+                  "name": "description",
+                  "type": "string"
+                },
+                {
+                  "name": "status",
+                  "type": "string"
+                },
+                {
+                  "name": "createdAt",
+                  "type": "string"
+                },
+                {
+                  "name": "input",
+                  "type": "string"
+                },
+                {
+                  "name": "category",
+                  "type": "string"
+                },
+                {
+                  "name": "confidence",
+                  "type": "number"
+                },
+                {
+                  "name": "model",
+                  "type": "string"
+                },
+                {
+                  "name": "message",
+                  "type": "string"
+                },
+                {
+                  "name": "notificationType",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "AgentClassifierLoadFailed",
+              "description": "Fired when AgentClassifier fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
             }
           ],
           "stateMachine": {
@@ -100,7 +164,7 @@
               },
               {
                 "key": "CLASSIFY",
-                "name": "Open"
+                "name": "Classify"
               },
               {
                 "key": "CLOSE",
@@ -116,6 +180,24 @@
                     "required": true
                   }
                 ]
+              },
+              {
+                "key": "CLASSIFIED",
+                "name": "Classified"
+              },
+              {
+                "key": "AgentClassifierLoaded",
+                "name": "AgentClassifier loaded"
+              },
+              {
+                "key": "AgentClassifierLoadFailed",
+                "name": "AgentClassifier load failed",
+                "payload": [
+                  {
+                    "name": "message",
+                    "type": "string"
+                  }
+                ]
               }
             ],
             "transitions": [
@@ -133,19 +215,16 @@
                     "main",
                     {
                       "type": "stack",
-                      "direction": "vertical",
-                      "gap": "lg",
                       "children": [
                         {
-                          "type": "stack",
+                          "justify": "space-between",
                           "direction": "horizontal",
+                          "type": "stack",
                           "gap": "md",
-                          "justify": "space-between",
                           "children": [
                             {
                               "type": "stack",
                               "direction": "horizontal",
-                              "gap": "md",
                               "children": [
                                 {
                                   "type": "icon",
@@ -157,14 +236,15 @@
                                   "content": "AgentClassifier",
                                   "variant": "h2"
                                 }
-                              ]
+                              ],
+                              "gap": "md"
                             },
                             {
-                              "type": "button",
-                              "label": "Open",
+                              "icon": "tag",
                               "event": "CLASSIFY",
+                              "type": "button",
                               "variant": "primary",
-                              "icon": "tag"
+                              "label": "Open"
                             }
                           ]
                         },
@@ -172,12 +252,14 @@
                           "type": "divider"
                         },
                         {
-                          "type": "empty-state",
                           "icon": "tag",
-                          "title": "Nothing open",
-                          "description": "Click Open to view details in a modal overlay."
+                          "description": "Click Open to view details in a modal overlay.",
+                          "type": "empty-state",
+                          "title": "Nothing open"
                         }
-                      ]
+                      ],
+                      "gap": "lg",
+                      "direction": "vertical"
                     }
                   ]
                 ]
@@ -196,18 +278,18 @@
                       "gap": "md",
                       "children": [
                         {
-                          "type": "stack",
                           "direction": "horizontal",
                           "gap": "sm",
+                          "type": "stack",
                           "children": [
                             {
+                              "size": "md",
                               "type": "icon",
-                              "name": "tag",
-                              "size": "md"
+                              "name": "tag"
                             },
                             {
-                              "type": "typography",
                               "content": "AgentClassifier",
+                              "type": "typography",
                               "variant": "h3"
                             }
                           ]
@@ -222,35 +304,35 @@
                           "children": [
                             {
                               "type": "typography",
-                              "variant": "caption",
-                              "content": "Categories:"
+                              "content": "Categories:",
+                              "variant": "caption"
                             },
                             {
                               "type": "badge",
-                              "label": "positive",
-                              "variant": "secondary"
+                              "variant": "secondary",
+                              "label": "positive"
                             },
                             {
-                              "type": "badge",
                               "label": "negative",
-                              "variant": "secondary"
+                              "variant": "secondary",
+                              "type": "badge"
                             },
                             {
+                              "variant": "secondary",
                               "type": "badge",
-                              "label": "neutral",
-                              "variant": "secondary"
+                              "label": "neutral"
                             }
                           ]
                         },
                         {
-                          "type": "form-section",
+                          "cancelEvent": "CLOSE",
                           "entity": "AgentClassifier",
-                          "mode": "create",
                           "submitEvent": "SAVE",
-                          "cancelEvent": "CLOSE",
                           "fields": [
                             "input"
-                          ]
+                          ],
+                          "mode": "create",
+                          "type": "form-section"
                         }
                       ]
                     }
@@ -281,13 +363,10 @@
                     "main",
                     {
                       "type": "stack",
-                      "direction": "vertical",
                       "gap": "lg",
                       "children": [
                         {
-                          "type": "stack",
                           "direction": "horizontal",
-                          "gap": "md",
                           "justify": "space-between",
                           "children": [
                             {
@@ -296,9 +375,9 @@
                               "gap": "md",
                               "children": [
                                 {
+                                  "size": "lg",
                                   "type": "icon",
-                                  "name": "tag",
-                                  "size": "lg"
+                                  "name": "tag"
                                 },
                                 {
                                   "type": "typography",
@@ -308,24 +387,27 @@
                               ]
                             },
                             {
+                              "icon": "tag",
                               "type": "button",
-                              "label": "Open",
-                              "event": "CLASSIFY",
                               "variant": "primary",
-                              "icon": "tag"
+                              "label": "Open",
+                              "event": "CLASSIFY"
                             }
-                          ]
+                          ],
+                          "gap": "md",
+                          "type": "stack"
                         },
                         {
                           "type": "divider"
                         },
                         {
+                          "title": "Nothing open",
                           "type": "empty-state",
                           "icon": "tag",
-                          "title": "Nothing open",
                           "description": "Click Open to view details in a modal overlay."
                         }
-                      ]
+                      ],
+                      "direction": "vertical"
                     }
                   ]
                 ]
@@ -358,50 +440,50 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
                       "direction": "vertical",
+                      "type": "stack",
                       "gap": "lg",
                       "children": [
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "md",
                           "justify": "space-between",
                           "children": [
                             {
-                              "type": "stack",
-                              "direction": "horizontal",
-                              "gap": "md",
                               "children": [
                                 {
                                   "type": "icon",
-                                  "name": "tag",
-                                  "size": "lg"
+                                  "size": "lg",
+                                  "name": "tag"
                                 },
                                 {
-                                  "type": "typography",
                                   "content": "AgentClassifier",
+                                  "type": "typography",
                                   "variant": "h2"
                                 }
-                              ]
+                              ],
+                              "gap": "md",
+                              "type": "stack",
+                              "direction": "horizontal"
                             },
                             {
-                              "type": "button",
+                              "variant": "primary",
                               "label": "Open",
+                              "icon": "tag",
                               "event": "CLASSIFY",
-                              "variant": "primary",
-                              "icon": "tag"
+                              "type": "button"
                             }
-                          ]
+                          ],
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "md"
                         },
                         {
                           "type": "divider"
                         },
                         {
                           "type": "empty-state",
-                          "icon": "tag",
+                          "description": "Click Open to view details in a modal overlay.",
                           "title": "Nothing open",
-                          "description": "Click Open to view details in a modal overlay."
+                          "icon": "tag"
                         }
                       ]
                     }
@@ -409,12 +491,77 @@
                 ]
               }
             ]
-          }
+          },
+          "scope": "instance"
         },
         {
           "name": "AgentClassifierNotification",
-          "linkedEntity": "AgentClassifier",
           "category": "interaction",
+          "linkedEntity": "AgentClassifier",
+          "emits": [
+            {
+              "event": "AgentClassifierLoaded",
+              "description": "Fired when AgentClassifier finishes loading",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "id",
+                  "type": "string"
+                },
+                {
+                  "name": "name",
+                  "type": "string"
+                },
+                {
+                  "name": "description",
+                  "type": "string"
+                },
+                {
+                  "name": "status",
+                  "type": "string"
+                },
+                {
+                  "name": "createdAt",
+                  "type": "string"
+                },
+                {
+                  "name": "input",
+                  "type": "string"
+                },
+                {
+                  "name": "category",
+                  "type": "string"
+                },
+                {
+                  "name": "confidence",
+                  "type": "number"
+                },
+                {
+                  "name": "model",
+                  "type": "string"
+                },
+                {
+                  "name": "message",
+                  "type": "string"
+                },
+                {
+                  "name": "notificationType",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "AgentClassifierLoadFailed",
+              "description": "Fired when AgentClassifier fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
+            }
+          ],
           "stateMachine": {
             "states": [
               {
@@ -432,7 +579,7 @@
               },
               {
                 "key": "SHOW",
-                "name": "Show Notification",
+                "name": "Show",
                 "payload": [
                   {
                     "name": "message",
@@ -447,7 +594,21 @@
               },
               {
                 "key": "HIDE",
-                "name": "Hide Notification"
+                "name": "Hide"
+              },
+              {
+                "key": "AgentClassifierLoaded",
+                "name": "AgentClassifier loaded"
+              },
+              {
+                "key": "AgentClassifierLoadFailed",
+                "name": "AgentClassifier load failed",
+                "payload": [
+                  {
+                    "name": "message",
+                    "type": "string"
+                  }
+                ]
               }
             ],
             "transitions": [
@@ -458,7 +619,13 @@
                 "effects": [
                   [
                     "fetch",
-                    "AgentClassifier"
+                    "AgentClassifier",
+                    {
+                      "emit": {
+                        "failure": "AgentClassifierLoadFailed",
+                        "success": "AgentClassifierLoaded"
+                      }
+                    }
                   ]
                 ]
               },
@@ -481,64 +648,64 @@
                     "render-ui",
                     "main",
                     {
+                      "gap": "lg",
                       "type": "stack",
                       "direction": "vertical",
-                      "gap": "lg",
                       "children": [
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "md",
-                          "justify": "space-between",
                           "align": "center",
+                          "type": "stack",
                           "children": [
                             {
                               "type": "stack",
-                              "direction": "horizontal",
                               "gap": "md",
-                              "align": "center",
                               "children": [
                                 {
-                                  "type": "icon",
+                                  "size": "lg",
                                   "name": "tag",
-                                  "size": "lg"
+                                  "type": "icon"
                                 },
                                 {
                                   "type": "typography",
                                   "content": "AgentClassifier Result",
                                   "variant": "h2"
                                 }
-                              ]
+                              ],
+                              "align": "center",
+                              "direction": "horizontal"
                             },
                             {
                               "type": "button",
+                              "icon": "x",
                               "label": "Dismiss",
-                              "event": "HIDE",
                               "variant": "ghost",
-                              "icon": "x"
+                              "event": "HIDE"
                             }
-                          ]
+                          ],
+                          "gap": "md",
+                          "justify": "space-between",
+                          "direction": "horizontal"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "alert",
-                          "variant": [
+                          "message": [
                             "object/get",
                             [
                               "array/first",
                               "@entity"
                             ],
-                            "notificationType"
+                            "message"
                           ],
-                          "message": [
+                          "type": "alert",
+                          "variant": [
                             "object/get",
                             [
                               "array/first",
                               "@entity"
                             ],
-                            "message"
+                            "notificationType"
                           ]
                         },
                         {
@@ -546,7 +713,7 @@
                           "position": "top-right"
                         },
                         {
-                          "type": "violation-alert",
+                          "category": "compliance",
                           "severity": "warning",
                           "message": [
                             "object/get",
@@ -556,7 +723,7 @@
                             ],
                             "message"
                           ],
-                          "category": "compliance"
+                          "type": "violation-alert"
                         }
                       ]
                     }
@@ -582,64 +749,62 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
                       "gap": "lg",
                       "children": [
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "md",
-                          "justify": "space-between",
-                          "align": "center",
                           "children": [
                             {
-                              "type": "stack",
-                              "direction": "horizontal",
-                              "gap": "md",
                               "align": "center",
+                              "direction": "horizontal",
+                              "type": "stack",
                               "children": [
                                 {
                                   "type": "icon",
-                                  "name": "tag",
-                                  "size": "lg"
+                                  "size": "lg",
+                                  "name": "tag"
                                 },
                                 {
-                                  "type": "typography",
                                   "content": "AgentClassifier Result",
-                                  "variant": "h2"
+                                  "variant": "h2",
+                                  "type": "typography"
                                 }
-                              ]
+                              ],
+                              "gap": "md"
                             },
                             {
+                              "variant": "ghost",
                               "type": "button",
                               "label": "Dismiss",
-                              "event": "HIDE",
-                              "variant": "ghost",
-                              "icon": "x"
+                              "icon": "x",
+                              "event": "HIDE"
                             }
-                          ]
+                          ],
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "align": "center",
+                          "gap": "md",
+                          "justify": "space-between"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "alert",
-                          "variant": [
+                          "message": [
                             "object/get",
                             [
                               "array/first",
                               "@entity"
                             ],
-                            "notificationType"
+                            "message"
                           ],
-                          "message": [
+                          "type": "alert",
+                          "variant": [
                             "object/get",
                             [
                               "array/first",
                               "@entity"
                             ],
-                            "message"
+                            "notificationType"
                           ]
                         },
                         {
@@ -647,8 +812,6 @@
                           "position": "top-right"
                         },
                         {
-                          "type": "violation-alert",
-                          "severity": "warning",
                           "message": [
                             "object/get",
                             [
@@ -657,9 +820,13 @@
                             ],
                             "message"
                           ],
-                          "category": "compliance"
+                          "type": "violation-alert",
+                          "category": "compliance",
+                          "severity": "warning"
                         }
-                      ]
+                      ],
+                      "direction": "vertical",
+                      "type": "stack"
                     }
                   ]
                 ]
@@ -677,12 +844,13 @@
                 ]
               }
             ]
-          }
+          },
+          "scope": "instance"
         },
         {
           "name": "AgentClassifierAgent",
-          "linkedEntity": "AgentClassifier",
           "category": "interaction",
+          "linkedEntity": "AgentClassifier",
           "emits": [
             {
               "event": "SHOW",
@@ -697,13 +865,78 @@
                   "type": "number"
                 }
               ]
+            },
+            {
+              "event": "AgentClassifierLoaded",
+              "description": "Fired when AgentClassifier finishes loading",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "id",
+                  "type": "string"
+                },
+                {
+                  "name": "name",
+                  "type": "string"
+                },
+                {
+                  "name": "description",
+                  "type": "string"
+                },
+                {
+                  "name": "status",
+                  "type": "string"
+                },
+                {
+                  "name": "createdAt",
+                  "type": "string"
+                },
+                {
+                  "name": "input",
+                  "type": "string"
+                },
+                {
+                  "name": "category",
+                  "type": "string"
+                },
+                {
+                  "name": "confidence",
+                  "type": "number"
+                },
+                {
+                  "name": "model",
+                  "type": "string"
+                },
+                {
+                  "name": "message",
+                  "type": "string"
+                },
+                {
+                  "name": "notificationType",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "AgentClassifierLoadFailed",
+              "description": "Fired when AgentClassifier fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
             }
           ],
           "listens": [
             {
               "event": "CLASSIFIED",
               "triggers": "CLASSIFIED",
-              "scope": "external"
+              "source": {
+                "kind": "trait",
+                "trait": "AgentClassifierModal"
+              }
             }
           ],
           "stateMachine": {
@@ -735,18 +968,29 @@
                   }
                 ]
               },
+              {
+                "key": "CLASSIFIED",
+                "name": "Classified"
+              },
               {
                 "key": "RESET",
                 "name": "Reset"
               },
               {
-                "key": "CLASSIFIED",
-                "name": "Classified",
+                "key": "SHOW",
+                "name": "Show"
+              },
+              {
+                "key": "AgentClassifierLoaded",
+                "name": "AgentClassifier loaded"
+              },
+              {
+                "key": "AgentClassifierLoadFailed",
+                "name": "AgentClassifier load failed",
                 "payload": [
                   {
-                    "name": "data",
-                    "type": "object",
-                    "required": true
+                    "name": "message",
+                    "type": "string"
                   }
                 ]
               }
@@ -759,16 +1003,22 @@
                 "effects": [
                   [
                     "fetch",
-                    "AgentClassifier"
+                    "AgentClassifier",
+                    {
+                      "emit": {
+                        "success": "AgentClassifierLoaded",
+                        "failure": "AgentClassifierLoadFailed"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
                       "type": "empty-state",
-                      "icon": "tag",
                       "title": "Classifier",
-                      "description": "Classifier is ready"
+                      "description": "Classifier is ready",
+                      "icon": "tag"
                     }
                   ]
                 ]
@@ -843,12 +1093,13 @@
                   [
                     "set",
                     "@entity.confidence",
-                    0
+                    0.0
                   ]
                 ]
               }
             ]
-          }
+          },
+          "scope": "instance"
         }
       ],
       "pages": [
@@ -870,4 +1121,4 @@
       ]
     }
   ]
-}
+}