@almadar/std 6.5.2 → 7.2.0

package/dist/behaviors/registry/atoms/std-agent-completion.orb

@@ -1,14 +1,14 @@
 {
   "name": "std-agent-completion",
   "version": "1.0.0",
-  "description": "Completion flow atom for agent text generation. Composes UI atoms (stdModal for prompt input, stdNotification for feedback) with an agent trait that handles agent/generate and retry logic.",
+  "description": "std-agent-completion as a Function",
   "orbitals": [
     {
       "name": "AgentCompletionOrbital",
       "entity": {
         "name": "AgentCompletion",
-        "persistence": "persistent",
         "collection": "agentcompletions",
+        "persistence": "persistent",
         "fields": [
           {
             "name": "id",
@@ -76,16 +76,84 @@
       "traits": [
         {
           "name": "AgentCompletionModal",
-          "linkedEntity": "AgentCompletion",
           "category": "interaction",
+          "linkedEntity": "AgentCompletion",
           "emits": [
             {
-              "event": "SAVE",
-              "scope": "external"
+              "event": "GENERATED",
+              "scope": "external",
+              "payload": [
+                {
+                  "name": "id",
+                  "type": "string"
+                }
+              ]
             },
             {
-              "event": "GENERATED",
-              "scope": "external"
+              "event": "AgentCompletionLoaded",
+              "description": "Fired when AgentCompletion 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": "prompt",
+                  "type": "string"
+                },
+                {
+                  "name": "response",
+                  "type": "string"
+                },
+                {
+                  "name": "provider",
+                  "type": "string"
+                },
+                {
+                  "name": "model",
+                  "type": "string"
+                },
+                {
+                  "name": "error",
+                  "type": "string"
+                },
+                {
+                  "name": "message",
+                  "type": "string"
+                },
+                {
+                  "name": "notificationType",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "AgentCompletionLoadFailed",
+              "description": "Fired when AgentCompletion fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
             }
           ],
           "stateMachine": {
@@ -105,7 +173,7 @@
               },
               {
                 "key": "GENERATE",
-                "name": "Open"
+                "name": "Generate"
               },
               {
                 "key": "CLOSE",
@@ -121,6 +189,24 @@
                     "required": true
                   }
                 ]
+              },
+              {
+                "key": "GENERATED",
+                "name": "Generated"
+              },
+              {
+                "key": "AgentCompletionLoaded",
+                "name": "AgentCompletion loaded"
+              },
+              {
+                "key": "AgentCompletionLoadFailed",
+                "name": "AgentCompletion load failed",
+                "payload": [
+                  {
+                    "name": "message",
+                    "type": "string"
+                  }
+                ]
               }
             ],
             "transitions": [
@@ -137,18 +223,16 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
                       "direction": "vertical",
+                      "type": "stack",
                       "gap": "lg",
                       "children": [
                         {
-                          "type": "stack",
                           "direction": "horizontal",
+                          "type": "stack",
                           "gap": "md",
-                          "justify": "space-between",
                           "children": [
                             {
-                              "type": "stack",
                               "direction": "horizontal",
                               "gap": "md",
                               "children": [
@@ -162,24 +246,26 @@
                                   "content": "AgentCompletion",
                                   "variant": "h2"
                                 }
-                              ]
+                              ],
+                              "type": "stack"
                             },
                             {
-                              "type": "button",
                               "label": "Open",
                               "event": "GENERATE",
-                              "variant": "primary",
-                              "icon": "sparkles"
+                              "type": "button",
+                              "icon": "sparkles",
+                              "variant": "primary"
                             }
-                          ]
+                          ],
+                          "justify": "space-between"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "empty-state",
                           "icon": "sparkles",
                           "title": "Nothing open",
+                          "type": "empty-state",
                           "description": "Click Open to view details in a modal overlay."
                         }
                       ]
@@ -196,8 +282,8 @@
                     "render-ui",
                     "modal",
                     {
-                      "type": "stack",
                       "direction": "vertical",
+                      "type": "stack",
                       "gap": "md",
                       "children": [
                         {
@@ -206,14 +292,14 @@
                           "gap": "sm",
                           "children": [
                             {
-                              "type": "icon",
+                              "size": "md",
                               "name": "sparkles",
-                              "size": "md"
+                              "type": "icon"
                             },
                             {
-                              "type": "typography",
                               "content": "AgentCompletion",
-                              "variant": "h3"
+                              "variant": "h3",
+                              "type": "typography"
                             }
                           ]
                         },
@@ -221,7 +307,6 @@
                           "type": "divider"
                         },
                         {
-                          "type": "stack",
                           "direction": "horizontal",
                           "gap": "sm",
                           "children": [
@@ -230,20 +315,21 @@
                               "label": "@entity.provider"
                             },
                             {
-                              "type": "badge",
-                              "label": "@entity.model"
+                              "label": "@entity.model",
+                              "type": "badge"
                             }
-                          ]
+                          ],
+                          "type": "stack"
                         },
                         {
+                          "cancelEvent": "CLOSE",
                           "type": "form-section",
                           "entity": "AgentCompletion",
-                          "mode": "create",
-                          "submitEvent": "SAVE",
-                          "cancelEvent": "CLOSE",
                           "fields": [
                             "prompt"
-                          ]
+                          ],
+                          "mode": "create",
+                          "submitEvent": "SAVE"
                         }
                       ]
                     }
@@ -273,41 +359,41 @@
                     "render-ui",
                     "main",
                     {
+                      "gap": "lg",
                       "type": "stack",
                       "direction": "vertical",
-                      "gap": "lg",
                       "children": [
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
                           "gap": "md",
                           "justify": "space-between",
                           "children": [
                             {
-                              "type": "stack",
-                              "direction": "horizontal",
                               "gap": "md",
+                              "type": "stack",
                               "children": [
                                 {
-                                  "type": "icon",
                                   "name": "sparkles",
+                                  "type": "icon",
                                   "size": "lg"
                                 },
                                 {
                                   "type": "typography",
-                                  "content": "AgentCompletion",
-                                  "variant": "h2"
+                                  "variant": "h2",
+                                  "content": "AgentCompletion"
                                 }
-                              ]
+                              ],
+                              "direction": "horizontal"
                             },
                             {
+                              "event": "GENERATE",
                               "type": "button",
                               "label": "Open",
-                              "event": "GENERATE",
-                              "variant": "primary",
-                              "icon": "sparkles"
+                              "icon": "sparkles",
+                              "variant": "primary"
                             }
-                          ]
+                          ],
+                          "direction": "horizontal",
+                          "type": "stack"
                         },
                         {
                           "type": "divider"
@@ -351,63 +437,132 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
                       "direction": "vertical",
-                      "gap": "lg",
                       "children": [
                         {
-                          "type": "stack",
                           "direction": "horizontal",
-                          "gap": "md",
-                          "justify": "space-between",
                           "children": [
                             {
-                              "type": "stack",
                               "direction": "horizontal",
                               "gap": "md",
                               "children": [
                                 {
-                                  "type": "icon",
                                   "name": "sparkles",
-                                  "size": "lg"
+                                  "size": "lg",
+                                  "type": "icon"
                                 },
                                 {
+                                  "variant": "h2",
                                   "type": "typography",
-                                  "content": "AgentCompletion",
-                                  "variant": "h2"
+                                  "content": "AgentCompletion"
                                 }
-                              ]
+                              ],
+                              "type": "stack"
                             },
                             {
-                              "type": "button",
-                              "label": "Open",
-                              "event": "GENERATE",
                               "variant": "primary",
-                              "icon": "sparkles"
+                              "event": "GENERATE",
+                              "icon": "sparkles",
+                              "type": "button",
+                              "label": "Open"
                             }
-                          ]
+                          ],
+                          "gap": "md",
+                          "justify": "space-between",
+                          "type": "stack"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "empty-state",
-                          "icon": "sparkles",
                           "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",
+                          "icon": "sparkles"
                         }
-                      ]
+                      ],
+                      "type": "stack",
+                      "gap": "lg"
                     }
                   ]
                 ]
               }
             ]
-          }
+          },
+          "scope": "instance"
         },
         {
           "name": "AgentCompletionNotification",
-          "linkedEntity": "AgentCompletion",
           "category": "interaction",
+          "linkedEntity": "AgentCompletion",
+          "emits": [
+            {
+              "event": "AgentCompletionLoaded",
+              "description": "Fired when AgentCompletion 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": "prompt",
+                  "type": "string"
+                },
+                {
+                  "name": "response",
+                  "type": "string"
+                },
+                {
+                  "name": "provider",
+                  "type": "string"
+                },
+                {
+                  "name": "model",
+                  "type": "string"
+                },
+                {
+                  "name": "error",
+                  "type": "string"
+                },
+                {
+                  "name": "message",
+                  "type": "string"
+                },
+                {
+                  "name": "notificationType",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "AgentCompletionLoadFailed",
+              "description": "Fired when AgentCompletion fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
+            }
+          ],
           "stateMachine": {
             "states": [
               {
@@ -425,7 +580,7 @@
               },
               {
                 "key": "SHOW",
-                "name": "Show Notification",
+                "name": "Show",
                 "payload": [
                   {
                     "name": "message",
@@ -440,7 +595,21 @@
               },
               {
                 "key": "HIDE",
-                "name": "Hide Notification"
+                "name": "Hide"
+              },
+              {
+                "key": "AgentCompletionLoaded",
+                "name": "AgentCompletion loaded"
+              },
+              {
+                "key": "AgentCompletionLoadFailed",
+                "name": "AgentCompletion load failed",
+                "payload": [
+                  {
+                    "name": "message",
+                    "type": "string"
+                  }
+                ]
               }
             ],
             "transitions": [
@@ -451,7 +620,13 @@
                 "effects": [
                   [
                     "fetch",
-                    "AgentCompletion"
+                    "AgentCompletion",
+                    {
+                      "emit": {
+                        "failure": "AgentCompletionLoadFailed",
+                        "success": "AgentCompletionLoaded"
+                      }
+                    }
                   ]
                 ]
               },
@@ -474,40 +649,40 @@
                     "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",
+                          "justify": "space-between",
                           "children": [
                             {
-                              "type": "stack",
-                              "direction": "horizontal",
-                              "gap": "md",
-                              "align": "center",
                               "children": [
                                 {
                                   "type": "icon",
-                                  "name": "sparkles",
-                                  "size": "lg"
+                                  "size": "lg",
+                                  "name": "sparkles"
                                 },
                                 {
-                                  "type": "typography",
                                   "content": "AgentCompletion Status",
-                                  "variant": "h2"
+                                  "variant": "h2",
+                                  "type": "typography"
                                 }
-                              ]
+                              ],
+                              "gap": "md",
+                              "direction": "horizontal",
+                              "align": "center",
+                              "type": "stack"
                             },
                             {
-                              "type": "button",
                               "label": "Dismiss",
-                              "event": "HIDE",
                               "variant": "ghost",
+                              "type": "button",
+                              "event": "HIDE",
                               "icon": "x"
                             }
                           ]
@@ -516,7 +691,6 @@
                           "type": "divider"
                         },
                         {
-                          "type": "alert",
                           "variant": [
                             "object/get",
                             [
@@ -532,15 +706,14 @@
                               "@entity"
                             ],
                             "message"
-                          ]
+                          ],
+                          "type": "alert"
                         },
                         {
-                          "type": "toast-slot",
-                          "position": "top-right"
+                          "position": "top-right",
+                          "type": "toast-slot"
                         },
                         {
-                          "type": "violation-alert",
-                          "severity": "warning",
                           "message": [
                             "object/get",
                             [
@@ -549,7 +722,9 @@
                             ],
                             "message"
                           ],
-                          "category": "compliance"
+                          "type": "violation-alert",
+                          "category": "compliance",
+                          "severity": "warning"
                         }
                       ]
                     }
@@ -577,41 +752,40 @@
                     {
                       "type": "stack",
                       "direction": "vertical",
-                      "gap": "lg",
                       "children": [
                         {
+                          "gap": "md",
                           "type": "stack",
                           "direction": "horizontal",
-                          "gap": "md",
-                          "justify": "space-between",
                           "align": "center",
                           "children": [
                             {
-                              "type": "stack",
                               "direction": "horizontal",
-                              "gap": "md",
                               "align": "center",
+                              "type": "stack",
                               "children": [
                                 {
                                   "type": "icon",
-                                  "name": "sparkles",
-                                  "size": "lg"
+                                  "size": "lg",
+                                  "name": "sparkles"
                                 },
                                 {
+                                  "variant": "h2",
                                   "type": "typography",
-                                  "content": "AgentCompletion Status",
-                                  "variant": "h2"
+                                  "content": "AgentCompletion Status"
                                 }
-                              ]
+                              ],
+                              "gap": "md"
                             },
                             {
                               "type": "button",
-                              "label": "Dismiss",
-                              "event": "HIDE",
+                              "icon": "x",
                               "variant": "ghost",
-                              "icon": "x"
+                              "event": "HIDE",
+                              "label": "Dismiss"
                             }
-                          ]
+                          ],
+                          "justify": "space-between"
                         },
                         {
                           "type": "divider"
@@ -640,7 +814,6 @@
                           "position": "top-right"
                         },
                         {
-                          "type": "violation-alert",
                           "severity": "warning",
                           "message": [
                             "object/get",
@@ -650,9 +823,11 @@
                             ],
                             "message"
                           ],
+                          "type": "violation-alert",
                           "category": "compliance"
                         }
-                      ]
+                      ],
+                      "gap": "lg"
                     }
                   ]
                 ]
@@ -670,12 +845,13 @@
                 ]
               }
             ]
-          }
+          },
+          "scope": "instance"
         },
         {
           "name": "AgentCompletionAgent",
-          "linkedEntity": "AgentCompletion",
           "category": "interaction",
+          "linkedEntity": "AgentCompletion",
           "emits": [
             {
               "event": "SHOW",
@@ -686,13 +862,82 @@
                   "type": "string"
                 }
               ]
+            },
+            {
+              "event": "AgentCompletionLoaded",
+              "description": "Fired when AgentCompletion 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": "prompt",
+                  "type": "string"
+                },
+                {
+                  "name": "response",
+                  "type": "string"
+                },
+                {
+                  "name": "provider",
+                  "type": "string"
+                },
+                {
+                  "name": "model",
+                  "type": "string"
+                },
+                {
+                  "name": "error",
+                  "type": "string"
+                },
+                {
+                  "name": "message",
+                  "type": "string"
+                },
+                {
+                  "name": "notificationType",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "AgentCompletionLoadFailed",
+              "description": "Fired when AgentCompletion fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
             }
           ],
           "listens": [
             {
               "event": "GENERATED",
               "triggers": "GENERATED",
-              "scope": "external"
+              "source": {
+                "kind": "trait",
+                "trait": "AgentCompletionModal"
+              }
             }
           ],
           "stateMachine": {
@@ -728,21 +973,32 @@
                 ]
               },
               {
-                "key": "RETRY",
-                "name": "Retry"
+                "key": "GENERATED",
+                "name": "Generated"
               },
               {
                 "key": "RESET",
                 "name": "Reset"
               },
               {
-                "key": "GENERATED",
-                "name": "Generated",
+                "key": "RETRY",
+                "name": "Retry"
+              },
+              {
+                "key": "SHOW",
+                "name": "Show"
+              },
+              {
+                "key": "AgentCompletionLoaded",
+                "name": "AgentCompletion loaded"
+              },
+              {
+                "key": "AgentCompletionLoadFailed",
+                "name": "AgentCompletion load failed",
                 "payload": [
                   {
-                    "name": "data",
-                    "type": "object",
-                    "required": true
+                    "name": "message",
+                    "type": "string"
                   }
                 ]
               }
@@ -755,16 +1011,22 @@
                 "effects": [
                   [
                     "fetch",
-                    "AgentCompletion"
+                    "AgentCompletion",
+                    {
+                      "emit": {
+                        "success": "AgentCompletionLoaded",
+                        "failure": "AgentCompletionLoadFailed"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
+                      "description": "Completion is ready",
                       "type": "empty-state",
                       "icon": "sparkles",
-                      "title": "Completion",
-                      "description": "Completion is ready"
+                      "title": "Completion"
                     }
                   ]
                 ]
@@ -845,50 +1107,50 @@
                 ]
               },
               {
-                "from": "error",
-                "to": "generating",
-                "event": "RETRY",
-                "guard": [
-                  "=",
-                  "@entity.status",
-                  "error"
-                ],
+                "from": "completed",
+                "to": "idle",
+                "event": "RESET",
                 "effects": [
                   [
                     "set",
                     "@entity.status",
-                    "generating"
+                    "idle"
                   ],
                   [
                     "set",
-                    "@entity.error",
+                    "@entity.response",
                     ""
                   ],
                   [
-                    "agent/generate",
-                    "@entity.prompt"
+                    "set",
+                    "@entity.prompt",
+                    ""
                   ]
                 ]
               },
               {
-                "from": "completed",
-                "to": "idle",
-                "event": "RESET",
+                "from": "error",
+                "to": "generating",
+                "event": "RETRY",
+                "guard": [
+                  "=",
+                  "@entity.status",
+                  "error"
+                ],
                 "effects": [
                   [
                     "set",
                     "@entity.status",
-                    "idle"
+                    "generating"
                   ],
                   [
                     "set",
-                    "@entity.response",
+                    "@entity.error",
                     ""
                   ],
                   [
-                    "set",
-                    "@entity.prompt",
-                    ""
+                    "agent/generate",
+                    "@entity.prompt"
                   ]
                 ]
               },
@@ -910,7 +1172,8 @@
                 ]
               }
             ]
-          }
+          },
+          "scope": "instance"
         }
       ],
       "pages": [
@@ -932,4 +1195,4 @@
       ]
     }
   ]
-}
+}