@almadar/std 6.5.2 → 7.2.0

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

@@ -1,14 +1,14 @@
 {
   "name": "std-agent-session",
   "version": "1.0.0",
-  "description": "Session lifecycle atom for agent session management. Composes UI atoms (stdBrowse for session list, stdModal for fork label form) with an agent trait that handles agent/fork, agent/label, and agent/session-id.",
+  "description": "std-agent-session as a Function",
   "orbitals": [
     {
       "name": "AgentSessionOrbital",
       "entity": {
         "name": "AgentSession",
-        "persistence": "persistent",
         "collection": "agentsessions",
+        "persistence": "persistent",
         "fields": [
           {
             "name": "id",
@@ -56,23 +56,84 @@
       "traits": [
         {
           "name": "AgentSessionBrowse",
-          "linkedEntity": "AgentSession",
           "category": "interaction",
+          "linkedEntity": "AgentSession",
+          "emits": [
+            {
+              "event": "AgentSessionLoaded",
+              "description": "Fired when AgentSession 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": "sessionId",
+                  "type": "string"
+                },
+                {
+                  "name": "parentId",
+                  "type": "string"
+                },
+                {
+                  "name": "label",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "AgentSessionLoadFailed",
+              "description": "Fired when AgentSession fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
+            }
+          ],
           "listens": [
             {
               "event": "FORKED",
-              "scope": "external",
-              "triggers": "INIT"
+              "triggers": "INIT",
+              "source": {
+                "kind": "trait",
+                "trait": "AgentSessionAgent"
+              }
             },
             {
               "event": "LABELED",
-              "scope": "external",
-              "triggers": "INIT"
+              "triggers": "INIT",
+              "source": {
+                "kind": "trait",
+                "trait": "AgentSessionLabel"
+              }
             },
             {
               "event": "ENDED",
-              "scope": "external",
-              "triggers": "INIT"
+              "triggers": "INIT",
+              "source": {
+                "kind": "trait",
+                "trait": "AgentSessionAgent"
+              }
             }
           ],
           "stateMachine": {
@@ -88,20 +149,22 @@
                 "name": "Initialize"
               },
               {
-                "key": "FORK",
-                "name": "FORK"
-              },
-              {
-                "key": "LABEL",
-                "name": "LABEL"
+                "key": "AgentSessionLoaded",
+                "name": "AgentSession loaded"
               },
               {
-                "key": "END",
-                "name": "END"
+                "key": "AgentSessionLoadFailed",
+                "name": "AgentSession load failed",
+                "payload": [
+                  {
+                    "name": "message",
+                    "type": "string"
+                  }
+                ]
               },
               {
                 "key": "VIEW",
-                "name": "VIEW",
+                "name": "View",
                 "payload": [
                   {
                     "name": "id",
@@ -129,28 +192,23 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
                       "gap": "lg",
-                      "className": "max-w-5xl mx-auto w-full",
                       "children": [
                         {
+                          "justify": "space-between",
                           "type": "stack",
                           "direction": "horizontal",
-                          "gap": "md",
-                          "justify": "space-between",
-                          "align": "center",
                           "children": [
                             {
+                              "gap": "sm",
                               "type": "stack",
                               "direction": "horizontal",
-                              "gap": "sm",
                               "align": "center",
                               "children": [
                                 {
+                                  "size": "lg",
                                   "type": "icon",
-                                  "name": "terminal",
-                                  "size": "lg"
+                                  "name": "terminal"
                                 },
                                 {
                                   "type": "typography",
@@ -161,75 +219,65 @@
                             },
                             {
                               "type": "stack",
-                              "direction": "horizontal",
                               "gap": "sm",
+                              "direction": "horizontal",
                               "children": [
                                 {
+                                  "icon": "git-branch",
+                                  "variant": "secondary",
                                   "type": "button",
                                   "label": "Fork",
-                                  "event": "FORK",
-                                  "variant": "secondary",
-                                  "icon": "git-branch"
+                                  "event": "FORK"
                                 },
                                 {
-                                  "type": "button",
-                                  "label": "Label",
                                   "event": "LABEL",
-                                  "variant": "secondary",
-                                  "icon": "tag"
+                                  "label": "Label",
+                                  "type": "button",
+                                  "icon": "tag",
+                                  "variant": "secondary"
                                 },
                                 {
-                                  "type": "button",
-                                  "label": "End",
                                   "event": "END",
                                   "variant": "ghost",
+                                  "label": "End",
+                                  "type": "button",
                                   "icon": "square"
                                 }
                               ]
                             }
-                          ]
+                          ],
+                          "align": "center",
+                          "gap": "md"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "data-grid",
-                          "entity": "AgentSession",
                           "emptyIcon": "inbox",
-                          "emptyTitle": "No sessions yet",
-                          "emptyDescription": "Start a new session to begin.",
-                          "itemActions": [
-                            {
-                              "label": "View",
-                              "event": "VIEW",
-                              "variant": "ghost",
-                              "size": "sm"
-                            }
-                          ],
                           "columns": [
                             {
+                              "variant": "h4",
                               "name": "sessionId",
                               "label": "Session ID",
-                              "variant": "h4",
                               "icon": "terminal"
                             },
                             {
-                              "name": "status",
-                              "label": "Status",
                               "variant": "badge",
+                              "label": "Status",
+                              "name": "status",
                               "colorMap": {
-                                "active": "success",
-                                "completed": "success",
-                                "done": "success",
-                                "pending": "warning",
-                                "draft": "warning",
-                                "scheduled": "warning",
+                                "cancelled": "destructive",
                                 "inactive": "neutral",
+                                "scheduled": "warning",
+                                "done": "success",
+                                "completed": "success",
+                                "failed": "destructive",
                                 "archived": "neutral",
+                                "active": "success",
+                                "pending": "warning",
                                 "disabled": "neutral",
-                                "error": "destructive",
-                                "cancelled": "destructive",
-                                "failed": "destructive"
+                                "draft": "warning",
+                                "error": "destructive"
                               }
                             },
                             {
@@ -237,28 +285,96 @@
                               "label": "Label",
                               "variant": "caption"
                             }
-                          ]
+                          ],
+                          "entity": "AgentSession",
+                          "type": "data-grid",
+                          "emptyDescription": "Start a new session to begin.",
+                          "itemActions": [
+                            {
+                              "size": "sm",
+                              "variant": "ghost",
+                              "label": "View",
+                              "event": "VIEW"
+                            }
+                          ],
+                          "emptyTitle": "No sessions yet"
                         }
-                      ]
+                      ],
+                      "className": "max-w-5xl mx-auto w-full",
+                      "type": "stack",
+                      "direction": "vertical"
                     }
                   ]
                 ]
               }
             ]
-          }
+          },
+          "scope": "collection"
         },
         {
           "name": "AgentSessionLabel",
-          "linkedEntity": "AgentSession",
           "category": "interaction",
+          "linkedEntity": "AgentSession",
           "emits": [
             {
-              "event": "SAVE",
-              "scope": "external"
+              "event": "LABELED",
+              "scope": "external",
+              "payload": [
+                {
+                  "name": "id",
+                  "type": "string"
+                }
+              ]
             },
             {
-              "event": "LABELED",
-              "scope": "external"
+              "event": "AgentSessionLoaded",
+              "description": "Fired when AgentSession 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": "sessionId",
+                  "type": "string"
+                },
+                {
+                  "name": "parentId",
+                  "type": "string"
+                },
+                {
+                  "name": "label",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "AgentSessionLoadFailed",
+              "description": "Fired when AgentSession fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
             }
           ],
           "stateMachine": {
@@ -278,7 +394,7 @@
               },
               {
                 "key": "LABEL",
-                "name": "Open"
+                "name": "Label"
               },
               {
                 "key": "CLOSE",
@@ -294,6 +410,24 @@
                     "required": true
                   }
                 ]
+              },
+              {
+                "key": "LABELED",
+                "name": "Labeled"
+              },
+              {
+                "key": "AgentSessionLoaded",
+                "name": "AgentSession loaded"
+              },
+              {
+                "key": "AgentSessionLoadFailed",
+                "name": "AgentSession load failed",
+                "payload": [
+                  {
+                    "name": "message",
+                    "type": "string"
+                  }
+                ]
               }
             ],
             "transitions": [
@@ -315,61 +449,67 @@
                 "effects": [
                   [
                     "fetch",
-                    "AgentSession"
+                    "AgentSession",
+                    {
+                      "emit": {
+                        "success": "AgentSessionLoaded",
+                        "failure": "AgentSessionLoadFailed"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "modal",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
                       "gap": "md",
+                      "direction": "vertical",
+                      "type": "stack",
                       "children": [
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
                           "gap": "sm",
+                          "direction": "horizontal",
                           "children": [
                             {
+                              "size": "md",
                               "type": "icon",
-                              "name": "tag",
-                              "size": "md"
+                              "name": "tag"
                             },
                             {
                               "type": "typography",
                               "content": "Label Session",
                               "variant": "h3"
                             }
-                          ]
+                          ],
+                          "type": "stack"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
                           "gap": "md",
+                          "direction": "horizontal",
+                          "type": "stack",
                           "children": [
                             {
-                              "type": "typography",
                               "variant": "caption",
+                              "type": "typography",
                               "content": "Session:"
                             },
                             {
-                              "type": "badge",
-                              "label": "@entity.sessionId"
+                              "label": "@entity.sessionId",
+                              "type": "badge"
                             }
                           ]
                         },
                         {
-                          "type": "form-section",
-                          "entity": "AgentSession",
-                          "mode": "edit",
                           "submitEvent": "SAVE",
                           "cancelEvent": "CLOSE",
+                          "mode": "edit",
+                          "entity": "AgentSession",
                           "fields": [
                             "label"
-                          ]
+                          ],
+                          "type": "form-section"
                         }
                       ]
                     }
@@ -386,6 +526,13 @@
                     "modal",
                     null
                   ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "box"
+                    }
+                  ],
                   [
                     "notify",
                     "Cancelled",
@@ -409,6 +556,13 @@
                     "modal",
                     null
                   ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "box"
+                    }
+                  ],
                   [
                     "emit",
                     "LABELED"
@@ -416,12 +570,13 @@
                 ]
               }
             ]
-          }
+          },
+          "scope": "collection"
         },
         {
           "name": "AgentSessionAgent",
-          "linkedEntity": "AgentSession",
           "category": "interaction",
+          "linkedEntity": "AgentSession",
           "emits": [
             {
               "event": "ENDED",
@@ -442,18 +597,74 @@
                   "type": "string"
                 }
               ]
+            },
+            {
+              "event": "AgentSessionLoaded",
+              "description": "Fired when AgentSession 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": "sessionId",
+                  "type": "string"
+                },
+                {
+                  "name": "parentId",
+                  "type": "string"
+                },
+                {
+                  "name": "label",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "AgentSessionLoadFailed",
+              "description": "Fired when AgentSession fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
             }
           ],
           "listens": [
             {
               "event": "ENDED",
               "triggers": "INIT",
-              "scope": "external"
+              "source": {
+                "kind": "trait",
+                "trait": "AgentSessionAgent"
+              }
             },
             {
               "event": "FORKED",
               "triggers": "INIT",
-              "scope": "external"
+              "source": {
+                "kind": "trait",
+                "trait": "AgentSessionAgent"
+              }
             }
           ],
           "stateMachine": {
@@ -476,7 +687,7 @@
               },
               {
                 "key": "FORK",
-                "name": "Fork Session"
+                "name": "Fork"
               },
               {
                 "key": "DO_LABEL",
@@ -489,10 +700,6 @@
                   }
                 ]
               },
-              {
-                "key": "END",
-                "name": "End Session"
-              },
               {
                 "key": "LABELED",
                 "name": "Labeled",
@@ -504,14 +711,29 @@
                   }
                 ]
               },
+              {
+                "key": "END",
+                "name": "End"
+              },
+              {
+                "key": "ENDED",
+                "name": "Ended"
+              },
               {
                 "key": "FORKED",
-                "name": "Forked",
+                "name": "Forked"
+              },
+              {
+                "key": "AgentSessionLoaded",
+                "name": "AgentSession loaded"
+              },
+              {
+                "key": "AgentSessionLoadFailed",
+                "name": "AgentSession load failed",
                 "payload": [
                   {
-                    "name": "data",
-                    "type": "object",
-                    "required": true
+                    "name": "message",
+                    "type": "string"
                   }
                 ]
               }
@@ -524,7 +746,13 @@
                 "effects": [
                   [
                     "fetch",
-                    "AgentSession"
+                    "AgentSession",
+                    {
+                      "emit": {
+                        "failure": "AgentSessionLoadFailed",
+                        "success": "AgentSessionLoaded"
+                      }
+                    }
                   ],
                   [
                     "agent/session-id"
@@ -538,10 +766,10 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "empty-state",
                       "icon": "git-branch",
                       "title": "Session",
-                      "description": "Session is ready"
+                      "description": "Session is ready",
+                      "type": "empty-state"
                     }
                   ]
                 ]
@@ -567,9 +795,9 @@
                     "create",
                     "AgentSession",
                     {
-                      "sessionId": "@entity.sessionId",
-                      "parentId": "@entity.parentId",
                       "status": "forked",
+                      "parentId": "@entity.parentId",
+                      "sessionId": "@entity.sessionId",
                       "createdAt": "@now"
                     }
                   ],
@@ -579,6 +807,59 @@
                   ]
                 ]
               },
+              {
+                "from": "active",
+                "to": "active",
+                "event": "DO_LABEL",
+                "effects": [
+                  [
+                    "agent/label",
+                    "@payload.data.label"
+                  ],
+                  [
+                    "set",
+                    "@entity.label",
+                    "@payload.data.label"
+                  ]
+                ]
+              },
+              {
+                "from": "active",
+                "to": "active",
+                "event": "LABELED",
+                "effects": [
+                  [
+                    "agent/label",
+                    "@entity.label"
+                  ],
+                  [
+                    "fetch",
+                    "AgentSession",
+                    {
+                      "emit": {
+                        "success": "AgentSessionLoaded",
+                        "failure": "AgentSessionLoadFailed"
+                      }
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "active",
+                "to": "ended",
+                "event": "END",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.status",
+                    "ended"
+                  ],
+                  [
+                    "emit",
+                    "ENDED"
+                  ]
+                ]
+              },
               {
                 "from": "forked",
                 "to": "forked",
@@ -612,22 +893,6 @@
                   ]
                 ]
               },
-              {
-                "from": "active",
-                "to": "active",
-                "event": "DO_LABEL",
-                "effects": [
-                  [
-                    "agent/label",
-                    "@payload.data.label"
-                  ],
-                  [
-                    "set",
-                    "@entity.label",
-                    "@payload.data.label"
-                  ]
-                ]
-              },
               {
                 "from": "forked",
                 "to": "forked",
@@ -644,21 +909,6 @@
                   ]
                 ]
               },
-              {
-                "from": "active",
-                "to": "active",
-                "event": "LABELED",
-                "effects": [
-                  [
-                    "agent/label",
-                    "@entity.label"
-                  ],
-                  [
-                    "fetch",
-                    "AgentSession"
-                  ]
-                ]
-              },
               {
                 "from": "forked",
                 "to": "forked",
@@ -670,23 +920,13 @@
                   ],
                   [
                     "fetch",
-                    "AgentSession"
-                  ]
-                ]
-              },
-              {
-                "from": "active",
-                "to": "ended",
-                "event": "END",
-                "effects": [
-                  [
-                    "set",
-                    "@entity.status",
-                    "ended"
-                  ],
-                  [
-                    "emit",
-                    "ENDED"
+                    "AgentSession",
+                    {
+                      "emit": {
+                        "success": "AgentSessionLoaded",
+                        "failure": "AgentSessionLoadFailed"
+                      }
+                    }
                   ]
                 ]
               },
@@ -713,7 +953,13 @@
                 "effects": [
                   [
                     "fetch",
-                    "AgentSession"
+                    "AgentSession",
+                    {
+                      "emit": {
+                        "success": "AgentSessionLoaded",
+                        "failure": "AgentSessionLoadFailed"
+                      }
+                    }
                   ],
                   [
                     "agent/session-id"
@@ -732,16 +978,17 @@
                     "render-ui",
                     "main",
                     {
+                      "description": "Session is ready",
                       "type": "empty-state",
-                      "icon": "git-branch",
                       "title": "Session",
-                      "description": "Session is ready"
+                      "icon": "git-branch"
                     }
                   ]
                 ]
               }
             ]
-          }
+          },
+          "scope": "collection"
         }
       ],
       "pages": [
@@ -763,4 +1010,4 @@
       ]
     }
   ]
-}
+}