@almadar/std 6.5.2 → 7.2.0

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

@@ -1,14 +1,14 @@
 {
   "name": "std-agent-provider",
   "version": "1.0.0",
-  "description": "Provider routing atom for agent model/provider switching. Composes UI atoms (stdModal for switch form, stdNotification for confirmation) with an agent trait that handles agent/switch-provider, agent/provider, and agent/model operators.",
+  "description": "std-agent-provider as a Function",
   "orbitals": [
     {
       "name": "AgentProviderOrbital",
       "entity": {
         "name": "AgentProvider",
-        "persistence": "persistent",
         "collection": "agentproviders",
+        "persistence": "persistent",
         "fields": [
           {
             "name": "id",
@@ -54,7 +54,7 @@
           {
             "name": "requestCount",
             "type": "number",
-            "default": 0
+            "default": 0.0
           },
           {
             "name": "message",
@@ -71,16 +71,80 @@
       "traits": [
         {
           "name": "AgentProviderModal",
-          "linkedEntity": "AgentProvider",
           "category": "interaction",
+          "linkedEntity": "AgentProvider",
           "emits": [
             {
-              "event": "SAVE",
-              "scope": "external"
+              "event": "SWITCHED",
+              "scope": "external",
+              "payload": [
+                {
+                  "name": "id",
+                  "type": "string"
+                }
+              ]
             },
             {
-              "event": "SWITCHED",
-              "scope": "external"
+              "event": "AgentProviderLoaded",
+              "description": "Fired when AgentProvider 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": "currentProvider",
+                  "type": "string"
+                },
+                {
+                  "name": "currentModel",
+                  "type": "string"
+                },
+                {
+                  "name": "fallbackProvider",
+                  "type": "string"
+                },
+                {
+                  "name": "requestCount",
+                  "type": "number"
+                },
+                {
+                  "name": "message",
+                  "type": "string"
+                },
+                {
+                  "name": "notificationType",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "AgentProviderLoadFailed",
+              "description": "Fired when AgentProvider fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
             }
           ],
           "stateMachine": {
@@ -100,7 +164,7 @@
               },
               {
                 "key": "SWITCH",
-                "name": "Open"
+                "name": "Switch"
               },
               {
                 "key": "CLOSE",
@@ -116,6 +180,24 @@
                     "required": true
                   }
                 ]
+              },
+              {
+                "key": "SWITCHED",
+                "name": "Switched"
+              },
+              {
+                "key": "AgentProviderLoaded",
+                "name": "AgentProvider loaded"
+              },
+              {
+                "key": "AgentProviderLoadFailed",
+                "name": "AgentProvider load failed",
+                "payload": [
+                  {
+                    "name": "message",
+                    "type": "string"
+                  }
+                ]
               }
             ],
             "transitions": [
@@ -132,20 +214,13 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
                       "gap": "lg",
+                      "type": "stack",
                       "children": [
                         {
-                          "type": "stack",
                           "direction": "horizontal",
-                          "gap": "md",
-                          "justify": "space-between",
                           "children": [
                             {
-                              "type": "stack",
-                              "direction": "horizontal",
-                              "gap": "md",
                               "children": [
                                 {
                                   "type": "icon",
@@ -153,31 +228,38 @@
                                   "size": "lg"
                                 },
                                 {
-                                  "type": "typography",
                                   "content": "Switch Provider",
-                                  "variant": "h2"
+                                  "variant": "h2",
+                                  "type": "typography"
                                 }
-                              ]
+                              ],
+                              "gap": "md",
+                              "direction": "horizontal",
+                              "type": "stack"
                             },
                             {
-                              "type": "button",
-                              "label": "Open",
-                              "event": "SWITCH",
                               "variant": "primary",
-                              "icon": "repeat"
+                              "event": "SWITCH",
+                              "icon": "repeat",
+                              "type": "button",
+                              "label": "Open"
                             }
-                          ]
+                          ],
+                          "type": "stack",
+                          "justify": "space-between",
+                          "gap": "md"
                         },
                         {
                           "type": "divider"
                         },
                         {
+                          "title": "Nothing open",
                           "type": "empty-state",
                           "icon": "repeat",
-                          "title": "Nothing open",
                           "description": "Click Open to view details in a modal overlay."
                         }
-                      ]
+                      ],
+                      "direction": "vertical"
                     }
                   ]
                 ]
@@ -189,30 +271,33 @@
                 "effects": [
                   [
                     "fetch",
-                    "AgentProvider"
+                    "AgentProvider",
+                    {
+                      "emit": {
+                        "failure": "AgentProviderLoadFailed",
+                        "success": "AgentProviderLoaded"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "modal",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
-                      "gap": "md",
                       "children": [
                         {
+                          "gap": "sm",
                           "type": "stack",
                           "direction": "horizontal",
-                          "gap": "sm",
                           "children": [
                             {
+                              "size": "md",
                               "type": "icon",
-                              "name": "repeat",
-                              "size": "md"
+                              "name": "repeat"
                             },
                             {
+                              "variant": "h3",
                               "type": "typography",
-                              "content": "Switch Provider",
-                              "variant": "h3"
+                              "content": "Switch Provider"
                             }
                           ]
                         },
@@ -220,37 +305,40 @@
                           "type": "divider"
                         },
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
                           "gap": "md",
+                          "type": "stack",
                           "children": [
                             {
+                              "content": "Current:",
                               "type": "typography",
-                              "variant": "caption",
-                              "content": "Current:"
+                              "variant": "caption"
                             },
                             {
                               "type": "badge",
                               "label": "@entity.currentProvider"
                             },
                             {
-                              "type": "badge",
-                              "label": "@entity.currentModel"
+                              "label": "@entity.currentModel",
+                              "type": "badge"
                             }
-                          ]
+                          ],
+                          "direction": "horizontal"
                         },
                         {
-                          "type": "form-section",
-                          "entity": "AgentProvider",
                           "mode": "edit",
-                          "submitEvent": "SAVE",
-                          "cancelEvent": "CLOSE",
+                          "type": "form-section",
                           "fields": [
                             "currentProvider",
                             "currentModel"
-                          ]
+                          ],
+                          "submitEvent": "SAVE",
+                          "entity": "AgentProvider",
+                          "cancelEvent": "CLOSE"
                         }
-                      ]
+                      ],
+                      "type": "stack",
+                      "gap": "md",
+                      "direction": "vertical"
                     }
                   ]
                 ]
@@ -278,15 +366,11 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
-                      "gap": "lg",
                       "children": [
                         {
+                          "justify": "space-between",
                           "type": "stack",
                           "direction": "horizontal",
-                          "gap": "md",
-                          "justify": "space-between",
                           "children": [
                             {
                               "type": "stack",
@@ -294,25 +378,26 @@
                               "gap": "md",
                               "children": [
                                 {
+                                  "size": "lg",
                                   "type": "icon",
-                                  "name": "repeat",
-                                  "size": "lg"
+                                  "name": "repeat"
                                 },
                                 {
-                                  "type": "typography",
                                   "content": "Switch Provider",
-                                  "variant": "h2"
+                                  "variant": "h2",
+                                  "type": "typography"
                                 }
                               ]
                             },
                             {
-                              "type": "button",
-                              "label": "Open",
                               "event": "SWITCH",
+                              "label": "Open",
                               "variant": "primary",
+                              "type": "button",
                               "icon": "repeat"
                             }
-                          ]
+                          ],
+                          "gap": "md"
                         },
                         {
                           "type": "divider"
@@ -320,10 +405,13 @@
                         {
                           "type": "empty-state",
                           "icon": "repeat",
-                          "title": "Nothing open",
-                          "description": "Click Open to view details in a modal overlay."
+                          "description": "Click Open to view details in a modal overlay.",
+                          "title": "Nothing open"
                         }
-                      ]
+                      ],
+                      "direction": "vertical",
+                      "type": "stack",
+                      "gap": "lg"
                     }
                   ]
                 ]
@@ -356,39 +444,36 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
-                      "gap": "lg",
                       "children": [
                         {
-                          "type": "stack",
+                          "justify": "space-between",
                           "direction": "horizontal",
                           "gap": "md",
-                          "justify": "space-between",
+                          "type": "stack",
                           "children": [
                             {
                               "type": "stack",
-                              "direction": "horizontal",
-                              "gap": "md",
                               "children": [
                                 {
-                                  "type": "icon",
                                   "name": "repeat",
-                                  "size": "lg"
+                                  "size": "lg",
+                                  "type": "icon"
                                 },
                                 {
                                   "type": "typography",
-                                  "content": "Switch Provider",
-                                  "variant": "h2"
+                                  "variant": "h2",
+                                  "content": "Switch Provider"
                                 }
-                              ]
+                              ],
+                              "gap": "md",
+                              "direction": "horizontal"
                             },
                             {
+                              "variant": "primary",
+                              "icon": "repeat",
                               "type": "button",
                               "label": "Open",
-                              "event": "SWITCH",
-                              "variant": "primary",
-                              "icon": "repeat"
+                              "event": "SWITCH"
                             }
                           ]
                         },
@@ -397,22 +482,90 @@
                         },
                         {
                           "type": "empty-state",
-                          "icon": "repeat",
                           "title": "Nothing open",
-                          "description": "Click Open to view details in a modal overlay."
+                          "description": "Click Open to view details in a modal overlay.",
+                          "icon": "repeat"
                         }
-                      ]
+                      ],
+                      "gap": "lg",
+                      "type": "stack",
+                      "direction": "vertical"
                     }
                   ]
                 ]
               }
             ]
-          }
+          },
+          "scope": "instance"
         },
         {
           "name": "AgentProviderNotification",
-          "linkedEntity": "AgentProvider",
           "category": "interaction",
+          "linkedEntity": "AgentProvider",
+          "emits": [
+            {
+              "event": "AgentProviderLoaded",
+              "description": "Fired when AgentProvider 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": "currentProvider",
+                  "type": "string"
+                },
+                {
+                  "name": "currentModel",
+                  "type": "string"
+                },
+                {
+                  "name": "fallbackProvider",
+                  "type": "string"
+                },
+                {
+                  "name": "requestCount",
+                  "type": "number"
+                },
+                {
+                  "name": "message",
+                  "type": "string"
+                },
+                {
+                  "name": "notificationType",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "AgentProviderLoadFailed",
+              "description": "Fired when AgentProvider fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
+            }
+          ],
           "stateMachine": {
             "states": [
               {
@@ -430,7 +583,7 @@
               },
               {
                 "key": "SHOW",
-                "name": "Show Notification",
+                "name": "Show",
                 "payload": [
                   {
                     "name": "message",
@@ -445,7 +598,21 @@
               },
               {
                 "key": "HIDE",
-                "name": "Hide Notification"
+                "name": "Hide"
+              },
+              {
+                "key": "AgentProviderLoaded",
+                "name": "AgentProvider loaded"
+              },
+              {
+                "key": "AgentProviderLoadFailed",
+                "name": "AgentProvider load failed",
+                "payload": [
+                  {
+                    "name": "message",
+                    "type": "string"
+                  }
+                ]
               }
             ],
             "transitions": [
@@ -456,7 +623,13 @@
                 "effects": [
                   [
                     "fetch",
-                    "AgentProvider"
+                    "AgentProvider",
+                    {
+                      "emit": {
+                        "success": "AgentProviderLoaded",
+                        "failure": "AgentProviderLoadFailed"
+                      }
+                    }
                   ]
                 ]
               },
@@ -479,49 +652,47 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
                       "gap": "lg",
+                      "type": "stack",
                       "children": [
                         {
                           "type": "stack",
                           "direction": "horizontal",
-                          "gap": "md",
                           "justify": "space-between",
                           "align": "center",
                           "children": [
                             {
-                              "type": "stack",
                               "direction": "horizontal",
-                              "gap": "md",
+                              "type": "stack",
                               "align": "center",
                               "children": [
                                 {
-                                  "type": "icon",
                                   "name": "server",
-                                  "size": "lg"
+                                  "size": "lg",
+                                  "type": "icon"
                                 },
                                 {
                                   "type": "typography",
                                   "content": "Provider Status",
                                   "variant": "h2"
                                 }
-                              ]
+                              ],
+                              "gap": "md"
                             },
                             {
                               "type": "button",
-                              "label": "Dismiss",
                               "event": "HIDE",
+                              "icon": "x",
                               "variant": "ghost",
-                              "icon": "x"
+                              "label": "Dismiss"
                             }
-                          ]
+                          ],
+                          "gap": "md"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "alert",
                           "variant": [
                             "object/get",
                             [
@@ -530,6 +701,7 @@
                             ],
                             "notificationType"
                           ],
+                          "type": "alert",
                           "message": [
                             "object/get",
                             [
@@ -556,7 +728,8 @@
                           ],
                           "category": "compliance"
                         }
-                      ]
+                      ],
+                      "direction": "vertical"
                     }
                   ]
                 ]
@@ -580,64 +753,64 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
                       "direction": "vertical",
+                      "type": "stack",
                       "gap": "lg",
                       "children": [
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "md",
-                          "justify": "space-between",
-                          "align": "center",
                           "children": [
                             {
-                              "type": "stack",
-                              "direction": "horizontal",
-                              "gap": "md",
-                              "align": "center",
                               "children": [
                                 {
+                                  "size": "lg",
                                   "type": "icon",
-                                  "name": "server",
-                                  "size": "lg"
+                                  "name": "server"
                                 },
                                 {
-                                  "type": "typography",
                                   "content": "Provider Status",
+                                  "type": "typography",
                                   "variant": "h2"
                                 }
-                              ]
+                              ],
+                              "gap": "md",
+                              "align": "center",
+                              "type": "stack",
+                              "direction": "horizontal"
                             },
                             {
                               "type": "button",
-                              "label": "Dismiss",
-                              "event": "HIDE",
                               "variant": "ghost",
-                              "icon": "x"
+                              "event": "HIDE",
+                              "icon": "x",
+                              "label": "Dismiss"
                             }
-                          ]
+                          ],
+                          "direction": "horizontal",
+                          "gap": "md",
+                          "type": "stack",
+                          "align": "center",
+                          "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"
                           ]
                         },
                         {
@@ -646,7 +819,6 @@
                         },
                         {
                           "type": "violation-alert",
-                          "severity": "warning",
                           "message": [
                             "object/get",
                             [
@@ -655,6 +827,7 @@
                             ],
                             "message"
                           ],
+                          "severity": "warning",
                           "category": "compliance"
                         }
                       ]
@@ -675,12 +848,13 @@
                 ]
               }
             ]
-          }
+          },
+          "scope": "instance"
         },
         {
           "name": "AgentProviderAgent",
-          "linkedEntity": "AgentProvider",
           "category": "interaction",
+          "linkedEntity": "AgentProvider",
           "emits": [
             {
               "event": "SHOW",
@@ -695,13 +869,78 @@
                   "type": "string"
                 }
               ]
+            },
+            {
+              "event": "AgentProviderLoaded",
+              "description": "Fired when AgentProvider 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": "currentProvider",
+                  "type": "string"
+                },
+                {
+                  "name": "currentModel",
+                  "type": "string"
+                },
+                {
+                  "name": "fallbackProvider",
+                  "type": "string"
+                },
+                {
+                  "name": "requestCount",
+                  "type": "number"
+                },
+                {
+                  "name": "message",
+                  "type": "string"
+                },
+                {
+                  "name": "notificationType",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "AgentProviderLoadFailed",
+              "description": "Fired when AgentProvider fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
             }
           ],
           "listens": [
             {
               "event": "SWITCHED",
-              "scope": "external",
-              "triggers": "SWITCHED"
+              "triggers": "SWITCHED",
+              "source": {
+                "kind": "trait",
+                "trait": "AgentProviderModal"
+              }
             }
           ],
           "stateMachine": {
@@ -733,18 +972,29 @@
                   }
                 ]
               },
+              {
+                "key": "SWITCHED",
+                "name": "Switched"
+              },
               {
                 "key": "SWITCH_AUTO",
-                "name": "Auto Switch to Fallback"
+                "name": "Switch Auto"
               },
               {
-                "key": "SWITCHED",
-                "name": "Switched",
+                "key": "SHOW",
+                "name": "Show"
+              },
+              {
+                "key": "AgentProviderLoaded",
+                "name": "AgentProvider loaded"
+              },
+              {
+                "key": "AgentProviderLoadFailed",
+                "name": "AgentProvider load failed",
                 "payload": [
                   {
-                    "name": "data",
-                    "type": "object",
-                    "required": true
+                    "name": "message",
+                    "type": "string"
                   }
                 ]
               }
@@ -757,7 +1007,13 @@
                 "effects": [
                   [
                     "fetch",
-                    "AgentProvider"
+                    "AgentProvider",
+                    {
+                      "emit": {
+                        "success": "AgentProviderLoaded",
+                        "failure": "AgentProviderLoadFailed"
+                      }
+                    }
                   ],
                   [
                     "agent/provider"
@@ -769,16 +1025,16 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "empty-state",
                       "icon": "repeat",
-                      "title": "Provider",
-                      "description": "Provider is ready"
+                      "type": "empty-state",
+                      "description": "Provider is ready",
+                      "title": "Provider"
                     }
                   ]
                 ]
               },
               {
-                "from": "active",
+                "from": "idle",
                 "to": "switching",
                 "event": "DO_SWITCH",
                 "effects": [
@@ -802,38 +1058,34 @@
               {
                 "from": "active",
                 "to": "switching",
-                "event": "SWITCHED",
+                "event": "DO_SWITCH",
                 "effects": [
                   [
                     "agent/switch-provider",
+                    "@payload.data.currentProvider",
+                    "@payload.data.currentModel"
+                  ],
+                  [
+                    "set",
                     "@entity.currentProvider",
-                    "@entity.currentModel"
+                    "@payload.data.currentProvider"
+                  ],
+                  [
+                    "set",
+                    "@entity.currentModel",
+                    "@payload.data.currentModel"
                   ]
                 ]
               },
               {
-                "from": "switching",
-                "to": "active",
-                "event": "INIT",
+                "from": "active",
+                "to": "switching",
+                "event": "SWITCHED",
                 "effects": [
                   [
-                    "agent/provider"
-                  ],
-                  [
-                    "agent/model"
-                  ],
-                  [
-                    "set",
-                    "@entity.requestCount",
-                    [
-                      "+",
-                      "@entity.requestCount",
-                      1
-                    ]
-                  ],
-                  [
-                    "emit",
-                    "SHOW"
+                    "agent/switch-provider",
+                    "@entity.currentProvider",
+                    "@entity.currentModel"
                   ]
                 ]
               },
@@ -854,29 +1106,34 @@
                 ]
               },
               {
-                "from": "idle",
-                "to": "switching",
-                "event": "DO_SWITCH",
+                "from": "switching",
+                "to": "active",
+                "event": "INIT",
                 "effects": [
                   [
-                    "agent/switch-provider",
-                    "@payload.data.currentProvider",
-                    "@payload.data.currentModel"
+                    "agent/provider"
                   ],
                   [
-                    "set",
-                    "@entity.currentProvider",
-                    "@payload.data.currentProvider"
+                    "agent/model"
                   ],
                   [
                     "set",
-                    "@entity.currentModel",
-                    "@payload.data.currentModel"
+                    "@entity.requestCount",
+                    [
+                      "+",
+                      "@entity.requestCount",
+                      1.0
+                    ]
+                  ],
+                  [
+                    "emit",
+                    "SHOW"
                   ]
                 ]
               }
             ]
-          }
+          },
+          "scope": "instance"
         }
       ],
       "pages": [
@@ -898,4 +1155,4 @@
       ]
     }
   ]
-}
+}