@almadar/std 6.5.2 → 7.2.0

package/behaviors/registry/atoms/std-agent-step-progress.orb

@@ -1,7 +1,7 @@
 {
   "name": "std-agent-step-progress",
   "version": "1.0.0",
-  "description": "Pipeline/workflow step indicator atom. Tracks progress through a series of named steps with start/advance/complete/fail lifecycle. Listens for ADVANCE, COMPLETE, FAIL so orchestrating traits can drive the progress externally.",
+  "description": "std-agent-step-progress as a Function",
   "orbitals": [
     {
       "name": "AgentStepProgressOrbital",
@@ -38,35 +38,50 @@
           {
             "name": "currentStep",
             "type": "number",
-            "default": 0
+            "default": 0.0
           },
           {
             "name": "totalSteps",
             "type": "number",
-            "default": 4
+            "default": 4.0
           }
         ]
       },
       "traits": [
         {
           "name": "AgentStepProgressProgress",
-          "linkedEntity": "AgentStepProgress",
           "category": "interaction",
+          "linkedEntity": "AgentStepProgress",
           "emits": [
             {
-              "event": "ADVANCE",
-              "scope": "external",
+              "event": "AgentStepProgressLoaded",
+              "description": "Fired when AgentStepProgress finishes loading",
+              "scope": "internal",
               "payload": [
                 {
-                  "name": "step",
+                  "name": "id",
+                  "type": "string"
+                },
+                {
+                  "name": "name",
+                  "type": "string"
+                },
+                {
+                  "name": "description",
+                  "type": "string"
+                },
+                {
+                  "name": "status",
+                  "type": "string"
+                },
+                {
+                  "name": "createdAt",
+                  "type": "string"
+                },
+                {
+                  "name": "currentStep",
                   "type": "number"
-                }
-              ]
-            },
-            {
-              "event": "COMPLETE",
-              "scope": "external",
-              "payload": [
+                },
                 {
                   "name": "totalSteps",
                   "type": "number"
@@ -74,33 +89,17 @@
               ]
             },
             {
-              "event": "FAIL",
-              "scope": "external",
+              "event": "AgentStepProgressLoadFailed",
+              "description": "Fired when AgentStepProgress fails to load",
+              "scope": "internal",
               "payload": [
                 {
-                  "name": "step",
-                  "type": "number"
+                  "name": "message",
+                  "type": "string"
                 }
               ]
             }
           ],
-          "listens": [
-            {
-              "event": "ADVANCE",
-              "triggers": "ADVANCE",
-              "scope": "external"
-            },
-            {
-              "event": "COMPLETE",
-              "triggers": "COMPLETE",
-              "scope": "external"
-            },
-            {
-              "event": "FAIL",
-              "triggers": "FAIL",
-              "scope": "external"
-            }
-          ],
           "stateMachine": {
             "states": [
               {
@@ -124,23 +123,37 @@
               },
               {
                 "key": "START",
-                "name": "Start Pipeline"
+                "name": "Start"
+              },
+              {
+                "key": "RESET",
+                "name": "Reset"
               },
               {
                 "key": "ADVANCE",
-                "name": "Advance Step"
+                "name": "Advance"
               },
               {
                 "key": "COMPLETE",
-                "name": "Complete Pipeline"
+                "name": "Complete"
               },
               {
                 "key": "FAIL",
-                "name": "Pipeline Failed"
+                "name": "Fail"
               },
               {
-                "key": "RESET",
-                "name": "Reset Pipeline"
+                "key": "AgentStepProgressLoaded",
+                "name": "AgentStepProgress loaded"
+              },
+              {
+                "key": "AgentStepProgressLoadFailed",
+                "name": "AgentStepProgress load failed",
+                "payload": [
+                  {
+                    "name": "message",
+                    "type": "string"
+                  }
+                ]
               }
             ],
             "transitions": [
@@ -151,45 +164,48 @@
                 "effects": [
                   [
                     "fetch",
-                    "AgentStepProgress"
+                    "AgentStepProgress",
+                    {
+                      "emit": {
+                        "failure": "AgentStepProgressLoadFailed",
+                        "success": "AgentStepProgressLoaded"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
-                      "gap": "lg",
                       "children": [
                         {
                           "type": "stack",
                           "direction": "horizontal",
-                          "gap": "sm",
                           "align": "center",
                           "children": [
                             {
+                              "size": "lg",
                               "type": "icon",
-                              "name": "list-ordered",
-                              "size": "lg"
+                              "name": "list-ordered"
                             },
                             {
+                              "variant": "h2",
                               "type": "typography",
-                              "content": "AgentStepProgress",
-                              "variant": "h2"
+                              "content": "AgentStepProgress"
                             },
                             {
+                              "variant": "default",
                               "type": "badge",
-                              "label": "Idle",
-                              "variant": "default"
+                              "label": "Idle"
                             }
-                          ]
+                          ],
+                          "gap": "sm"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "wizard-progress",
                           "currentStep": "@entity.currentStep",
+                          "type": "wizard-progress",
                           "steps": [
                             {
                               "id": "0",
@@ -204,19 +220,22 @@
                               "title": "Validate"
                             },
                             {
-                              "id": "3",
-                              "title": "Complete"
+                              "title": "Complete",
+                              "id": "3"
                             }
                           ]
                         },
                         {
                           "type": "button",
-                          "label": "Start",
-                          "event": "START",
                           "variant": "primary",
-                          "icon": "play"
+                          "event": "START",
+                          "icon": "play",
+                          "label": "Start"
                         }
-                      ]
+                      ],
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "lg"
                     }
                   ]
                 ]
@@ -234,38 +253,37 @@
                   [
                     "set",
                     "@entity.currentStep",
-                    0
+                    0.0
                   ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
                       "gap": "lg",
+                      "type": "stack",
                       "children": [
                         {
                           "type": "stack",
                           "direction": "horizontal",
                           "gap": "sm",
-                          "align": "center",
                           "children": [
                             {
-                              "type": "icon",
                               "name": "loader",
-                              "size": "lg"
+                              "size": "lg",
+                              "type": "icon"
                             },
                             {
                               "type": "typography",
-                              "content": "AgentStepProgress",
-                              "variant": "h2"
+                              "variant": "h2",
+                              "content": "AgentStepProgress"
                             },
                             {
-                              "type": "badge",
                               "label": "In Progress",
+                              "type": "badge",
                               "variant": "warning"
                             }
-                          ]
+                          ],
+                          "align": "center"
                         },
                         {
                           "type": "divider"
@@ -279,8 +297,8 @@
                               "title": "Initialize"
                             },
                             {
-                              "id": "1",
-                              "title": "Process"
+                              "title": "Process",
+                              "id": "1"
                             },
                             {
                               "id": "2",
@@ -294,14 +312,14 @@
                         },
                         {
                           "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "sm",
                           "align": "center",
+                          "gap": "sm",
+                          "direction": "horizontal",
                           "children": [
                             {
                               "type": "stat-display",
-                              "label": "Current Step",
-                              "value": "@entity.currentStep"
+                              "value": "@entity.currentStep",
+                              "label": "Current Step"
                             },
                             {
                               "type": "stat-display",
@@ -311,25 +329,109 @@
                           ]
                         },
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "sm",
                           "children": [
                             {
+                              "icon": "chevron-right",
                               "type": "button",
-                              "label": "Advance",
                               "event": "ADVANCE",
-                              "variant": "primary",
-                              "icon": "chevron-right"
+                              "label": "Advance",
+                              "variant": "primary"
                             },
                             {
-                              "type": "button",
                               "label": "Reset",
                               "event": "RESET",
-                              "variant": "ghost",
-                              "icon": "rotate-ccw"
+                              "icon": "rotate-ccw",
+                              "type": "button",
+                              "variant": "ghost"
+                            }
+                          ],
+                          "direction": "horizontal",
+                          "type": "stack",
+                          "gap": "sm"
+                        }
+                      ],
+                      "direction": "vertical"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "idle",
+                "to": "idle",
+                "event": "RESET",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.status",
+                    "idle"
+                  ],
+                  [
+                    "set",
+                    "@entity.currentStep",
+                    0.0
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "children": [
+                        {
+                          "gap": "sm",
+                          "align": "center",
+                          "direction": "horizontal",
+                          "type": "stack",
+                          "children": [
+                            {
+                              "name": "list-ordered",
+                              "type": "icon",
+                              "size": "lg"
+                            },
+                            {
+                              "content": "AgentStepProgress",
+                              "variant": "h2",
+                              "type": "typography"
+                            },
+                            {
+                              "type": "badge",
+                              "label": "Idle",
+                              "variant": "default"
                             }
                           ]
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        {
+                          "steps": [
+                            {
+                              "title": "Initialize",
+                              "id": "0"
+                            },
+                            {
+                              "title": "Process",
+                              "id": "1"
+                            },
+                            {
+                              "title": "Validate",
+                              "id": "2"
+                            },
+                            {
+                              "title": "Complete",
+                              "id": "3"
+                            }
+                          ],
+                          "type": "wizard-progress",
+                          "currentStep": "@entity.currentStep"
+                        },
+                        {
+                          "type": "button",
+                          "event": "START",
+                          "label": "Start",
+                          "icon": "play",
+                          "variant": "primary"
                         }
                       ]
                     }
@@ -352,39 +454,38 @@
                     [
                       "+",
                       "@entity.currentStep",
-                      1
+                      1.0
                     ]
                   ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
                       "gap": "lg",
+                      "type": "stack",
                       "children": [
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
                           "gap": "sm",
+                          "type": "stack",
                           "align": "center",
                           "children": [
                             {
-                              "type": "icon",
                               "name": "loader",
-                              "size": "lg"
+                              "size": "lg",
+                              "type": "icon"
                             },
                             {
-                              "type": "typography",
                               "content": "AgentStepProgress",
-                              "variant": "h2"
+                              "variant": "h2",
+                              "type": "typography"
                             },
                             {
                               "type": "badge",
                               "label": "In Progress",
                               "variant": "warning"
                             }
-                          ]
+                          ],
+                          "direction": "horizontal"
                         },
                         {
                           "type": "divider"
@@ -398,8 +499,8 @@
                               "title": "Initialize"
                             },
                             {
-                              "id": "1",
-                              "title": "Process"
+                              "title": "Process",
+                              "id": "1"
                             },
                             {
                               "id": "2",
@@ -412,45 +513,46 @@
                           ]
                         },
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
                           "gap": "sm",
-                          "align": "center",
                           "children": [
                             {
                               "type": "stat-display",
-                              "label": "Current Step",
-                              "value": "@entity.currentStep"
+                              "value": "@entity.currentStep",
+                              "label": "Current Step"
                             },
                             {
                               "type": "stat-display",
                               "label": "Total Steps",
                               "value": "@entity.totalSteps"
                             }
-                          ]
+                          ],
+                          "type": "stack",
+                          "align": "center",
+                          "direction": "horizontal"
                         },
                         {
+                          "gap": "sm",
                           "type": "stack",
                           "direction": "horizontal",
-                          "gap": "sm",
                           "children": [
                             {
                               "type": "button",
+                              "icon": "chevron-right",
                               "label": "Advance",
-                              "event": "ADVANCE",
                               "variant": "primary",
-                              "icon": "chevron-right"
+                              "event": "ADVANCE"
                             },
                             {
                               "type": "button",
                               "label": "Reset",
-                              "event": "RESET",
                               "variant": "ghost",
-                              "icon": "rotate-ccw"
+                              "icon": "rotate-ccw",
+                              "event": "RESET"
                             }
                           ]
                         }
-                      ]
+                      ],
+                      "direction": "vertical"
                     }
                   ]
                 ]
@@ -474,32 +576,30 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
                       "direction": "vertical",
-                      "gap": "lg",
                       "children": [
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
                           "gap": "sm",
-                          "align": "center",
                           "children": [
                             {
+                              "size": "lg",
                               "type": "icon",
-                              "name": "check-circle",
-                              "size": "lg"
+                              "name": "check-circle"
                             },
                             {
+                              "variant": "h2",
                               "type": "typography",
-                              "content": "AgentStepProgress",
-                              "variant": "h2"
+                              "content": "AgentStepProgress"
                             },
                             {
-                              "type": "badge",
                               "label": "Completed",
-                              "variant": "success"
+                              "variant": "success",
+                              "type": "badge"
                             }
-                          ]
+                          ],
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "align": "center"
                         },
                         {
                           "type": "divider"
@@ -517,8 +617,8 @@
                               "title": "Process"
                             },
                             {
-                              "id": "2",
-                              "title": "Validate"
+                              "title": "Validate",
+                              "id": "2"
                             },
                             {
                               "id": "3",
@@ -532,13 +632,15 @@
                           "message": "All steps completed successfully."
                         },
                         {
-                          "type": "button",
                           "label": "Reset",
-                          "event": "RESET",
+                          "icon": "rotate-ccw",
                           "variant": "ghost",
-                          "icon": "rotate-ccw"
+                          "type": "button",
+                          "event": "RESET"
                         }
-                      ]
+                      ],
+                      "gap": "lg",
+                      "type": "stack"
                     }
                   ]
                 ]
@@ -557,38 +659,37 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
                       "direction": "vertical",
+                      "type": "stack",
                       "gap": "lg",
                       "children": [
                         {
-                          "type": "stack",
                           "direction": "horizontal",
-                          "gap": "sm",
                           "align": "center",
+                          "gap": "sm",
                           "children": [
                             {
                               "type": "icon",
-                              "name": "x-circle",
-                              "size": "lg"
+                              "size": "lg",
+                              "name": "x-circle"
                             },
                             {
                               "type": "typography",
-                              "content": "AgentStepProgress",
-                              "variant": "h2"
+                              "variant": "h2",
+                              "content": "AgentStepProgress"
                             },
                             {
                               "type": "badge",
                               "label": "Failed",
                               "variant": "destructive"
                             }
-                          ]
+                          ],
+                          "type": "stack"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "wizard-progress",
                           "currentStep": "@entity.currentStep",
                           "steps": [
                             {
@@ -604,117 +705,35 @@
                               "title": "Validate"
                             },
                             {
-                              "id": "3",
-                              "title": "Complete"
+                              "title": "Complete",
+                              "id": "3"
                             }
-                          ]
+                          ],
+                          "type": "wizard-progress"
                         },
                         {
                           "type": "alert",
-                          "variant": "error",
-                          "message": "Pipeline failed at the current step."
+                          "message": "Pipeline failed at the current step.",
+                          "variant": "error"
                         },
                         {
-                          "type": "stack",
                           "direction": "horizontal",
+                          "type": "stack",
                           "gap": "sm",
                           "children": [
                             {
                               "type": "stat-display",
-                              "label": "Failed At Step",
-                              "value": "@entity.currentStep"
+                              "value": "@entity.currentStep",
+                              "label": "Failed At Step"
                             }
                           ]
                         },
                         {
-                          "type": "button",
-                          "label": "Reset",
-                          "event": "RESET",
+                          "icon": "rotate-ccw",
                           "variant": "ghost",
-                          "icon": "rotate-ccw"
-                        }
-                      ]
-                    }
-                  ]
-                ]
-              },
-              {
-                "from": "idle",
-                "to": "idle",
-                "event": "RESET",
-                "effects": [
-                  [
-                    "set",
-                    "@entity.status",
-                    "idle"
-                  ],
-                  [
-                    "set",
-                    "@entity.currentStep",
-                    0
-                  ],
-                  [
-                    "render-ui",
-                    "main",
-                    {
-                      "type": "stack",
-                      "direction": "vertical",
-                      "gap": "lg",
-                      "children": [
-                        {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "sm",
-                          "align": "center",
-                          "children": [
-                            {
-                              "type": "icon",
-                              "name": "list-ordered",
-                              "size": "lg"
-                            },
-                            {
-                              "type": "typography",
-                              "content": "AgentStepProgress",
-                              "variant": "h2"
-                            },
-                            {
-                              "type": "badge",
-                              "label": "Idle",
-                              "variant": "default"
-                            }
-                          ]
-                        },
-                        {
-                          "type": "divider"
-                        },
-                        {
-                          "type": "wizard-progress",
-                          "currentStep": "@entity.currentStep",
-                          "steps": [
-                            {
-                              "id": "0",
-                              "title": "Initialize"
-                            },
-                            {
-                              "id": "1",
-                              "title": "Process"
-                            },
-                            {
-                              "id": "2",
-                              "title": "Validate"
-                            },
-                            {
-                              "id": "3",
-                              "title": "Complete"
-                            }
-                          ]
-                        },
-                        {
+                          "label": "Reset",
                           "type": "button",
-                          "label": "Start",
-                          "event": "START",
-                          "variant": "primary",
-                          "icon": "play"
+                          "event": "RESET"
                         }
                       ]
                     }
@@ -734,26 +753,21 @@
                   [
                     "set",
                     "@entity.currentStep",
-                    0
+                    0.0
                   ],
                   [
                     "render-ui",
                     "main",
                     {
                       "type": "stack",
-                      "direction": "vertical",
-                      "gap": "lg",
                       "children": [
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "sm",
                           "align": "center",
                           "children": [
                             {
-                              "type": "icon",
+                              "size": "lg",
                               "name": "list-ordered",
-                              "size": "lg"
+                              "type": "icon"
                             },
                             {
                               "type": "typography",
@@ -761,45 +775,50 @@
                               "variant": "h2"
                             },
                             {
-                              "type": "badge",
                               "label": "Idle",
-                              "variant": "default"
+                              "variant": "default",
+                              "type": "badge"
                             }
-                          ]
+                          ],
+                          "gap": "sm",
+                          "type": "stack",
+                          "direction": "horizontal"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "wizard-progress",
-                          "currentStep": "@entity.currentStep",
                           "steps": [
                             {
-                              "id": "0",
-                              "title": "Initialize"
+                              "title": "Initialize",
+                              "id": "0"
                             },
                             {
                               "id": "1",
                               "title": "Process"
                             },
                             {
-                              "id": "2",
-                              "title": "Validate"
+                              "title": "Validate",
+                              "id": "2"
                             },
                             {
                               "id": "3",
                               "title": "Complete"
                             }
-                          ]
+                          ],
+                          "type": "wizard-progress",
+                          "currentStep": "@entity.currentStep"
                         },
                         {
-                          "type": "button",
                           "label": "Start",
-                          "event": "START",
+                          "icon": "play",
+                          "type": "button",
                           "variant": "primary",
-                          "icon": "play"
+                          "event": "START"
                         }
-                      ]
+                      ],
+                      "direction": "vertical",
+                      "gap": "lg"
                     }
                   ]
                 ]
@@ -817,72 +836,72 @@
                   [
                     "set",
                     "@entity.currentStep",
-                    0
+                    0.0
                   ],
                   [
                     "render-ui",
                     "main",
                     {
                       "type": "stack",
-                      "direction": "vertical",
                       "gap": "lg",
                       "children": [
                         {
+                          "gap": "sm",
                           "type": "stack",
                           "direction": "horizontal",
-                          "gap": "sm",
-                          "align": "center",
                           "children": [
                             {
-                              "type": "icon",
+                              "size": "lg",
                               "name": "list-ordered",
-                              "size": "lg"
+                              "type": "icon"
                             },
                             {
-                              "type": "typography",
+                              "variant": "h2",
                               "content": "AgentStepProgress",
-                              "variant": "h2"
+                              "type": "typography"
                             },
                             {
                               "type": "badge",
-                              "label": "Idle",
-                              "variant": "default"
+                              "variant": "default",
+                              "label": "Idle"
                             }
-                          ]
+                          ],
+                          "align": "center"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "wizard-progress",
                           "currentStep": "@entity.currentStep",
                           "steps": [
                             {
-                              "id": "0",
-                              "title": "Initialize"
+                              "title": "Initialize",
+                              "id": "0"
                             },
                             {
-                              "id": "1",
-                              "title": "Process"
+                              "title": "Process",
+                              "id": "1"
                             },
                             {
-                              "id": "2",
-                              "title": "Validate"
+                              "title": "Validate",
+                              "id": "2"
                             },
                             {
                               "id": "3",
                               "title": "Complete"
                             }
-                          ]
+                          ],
+                          "type": "wizard-progress"
                         },
                         {
-                          "type": "button",
                           "label": "Start",
-                          "event": "START",
+                          "icon": "play",
                           "variant": "primary",
-                          "icon": "play"
+                          "event": "START",
+                          "type": "button"
                         }
-                      ]
+                      ],
+                      "direction": "vertical"
                     }
                   ]
                 ]
@@ -900,45 +919,42 @@
                   [
                     "set",
                     "@entity.currentStep",
-                    0
+                    0.0
                   ],
                   [
                     "render-ui",
                     "main",
                     {
                       "type": "stack",
-                      "direction": "vertical",
                       "gap": "lg",
                       "children": [
                         {
-                          "type": "stack",
                           "direction": "horizontal",
-                          "gap": "sm",
                           "align": "center",
                           "children": [
                             {
                               "type": "icon",
-                              "name": "list-ordered",
-                              "size": "lg"
+                              "size": "lg",
+                              "name": "list-ordered"
                             },
                             {
-                              "type": "typography",
                               "content": "AgentStepProgress",
+                              "type": "typography",
                               "variant": "h2"
                             },
                             {
+                              "variant": "default",
                               "type": "badge",
-                              "label": "Idle",
-                              "variant": "default"
+                              "label": "Idle"
                             }
-                          ]
+                          ],
+                          "type": "stack",
+                          "gap": "sm"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "wizard-progress",
-                          "currentStep": "@entity.currentStep",
                           "steps": [
                             {
                               "id": "0",
@@ -956,22 +972,26 @@
                               "id": "3",
                               "title": "Complete"
                             }
-                          ]
+                          ],
+                          "currentStep": "@entity.currentStep",
+                          "type": "wizard-progress"
                         },
                         {
+                          "event": "START",
                           "type": "button",
+                          "icon": "play",
                           "label": "Start",
-                          "event": "START",
-                          "variant": "primary",
-                          "icon": "play"
+                          "variant": "primary"
                         }
-                      ]
+                      ],
+                      "direction": "vertical"
                     }
                   ]
                 ]
               }
             ]
-          }
+          },
+          "scope": "instance"
         }
       ],
       "pages": [
@@ -987,4 +1007,4 @@
       ]
     }
   ]
-}
+}