@almadar/std 6.5.2 → 7.2.0

package/behaviors/registry/atoms/std-agent-chat-thread.orb

@@ -1,14 +1,14 @@
 {
   "name": "std-agent-chat-thread",
   "version": "1.0.0",
-  "description": "Chat message thread atom for agent conversations. Displays a chronological list of messages (user, assistant, tool) with compose/send flow. Emits configurable send event for orchestrating traits to handle the actual agent call.",
+  "description": "std-agent-chat-thread as a Function",
   "orbitals": [
     {
       "name": "AgentChatThreadOrbital",
       "entity": {
         "name": "AgentChatThread",
-        "persistence": "persistent",
         "collection": "agentchatthreads",
+        "persistence": "persistent",
         "fields": [
           {
             "name": "id",
@@ -61,8 +61,8 @@
       "traits": [
         {
           "name": "AgentChatThreadThread",
-          "linkedEntity": "AgentChatThread",
           "category": "interaction",
+          "linkedEntity": "AgentChatThread",
           "emits": [
             {
               "event": "SEND_MESSAGE",
@@ -73,6 +73,60 @@
                   "type": "string"
                 }
               ]
+            },
+            {
+              "event": "AgentChatThreadLoaded",
+              "description": "Fired when AgentChatThread 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": "role",
+                  "type": "string"
+                },
+                {
+                  "name": "content",
+                  "type": "string"
+                },
+                {
+                  "name": "timestamp",
+                  "type": "string"
+                },
+                {
+                  "name": "toolName",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "AgentChatThreadLoadFailed",
+              "description": "Fired when AgentChatThread fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
             }
           ],
           "stateMachine": {
@@ -92,11 +146,15 @@
               },
               {
                 "key": "COMPOSE",
-                "name": "Compose Message"
+                "name": "Compose"
+              },
+              {
+                "key": "CLEAR",
+                "name": "Clear"
               },
               {
                 "key": "SEND",
-                "name": "Send Message",
+                "name": "Send",
                 "payload": [
                   {
                     "name": "content",
@@ -106,8 +164,22 @@
                 ]
               },
               {
-                "key": "CLEAR",
-                "name": "Clear Thread"
+                "key": "SEND_MESSAGE",
+                "name": "Send Message"
+              },
+              {
+                "key": "AgentChatThreadLoaded",
+                "name": "AgentChatThread loaded"
+              },
+              {
+                "key": "AgentChatThreadLoadFailed",
+                "name": "AgentChatThread load failed",
+                "payload": [
+                  {
+                    "name": "message",
+                    "type": "string"
+                  }
+                ]
               }
             ],
             "transitions": [
@@ -118,58 +190,61 @@
                 "effects": [
                   [
                     "fetch",
-                    "AgentChatThread"
+                    "AgentChatThread",
+                    {
+                      "emit": {
+                        "failure": "AgentChatThreadLoadFailed",
+                        "success": "AgentChatThreadLoaded"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
                       "direction": "vertical",
-                      "gap": "lg",
                       "children": [
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "sm",
-                          "justify": "space-between",
-                          "align": "center",
                           "children": [
                             {
-                              "type": "stack",
                               "direction": "horizontal",
                               "gap": "sm",
                               "align": "center",
                               "children": [
                                 {
+                                  "size": "lg",
                                   "type": "icon",
-                                  "name": "message-circle",
-                                  "size": "lg"
+                                  "name": "message-circle"
                                 },
                                 {
-                                  "type": "typography",
                                   "content": "AgentChatThread Thread",
-                                  "variant": "h2"
+                                  "variant": "h2",
+                                  "type": "typography"
                                 }
-                              ]
+                              ],
+                              "type": "stack"
                             },
                             {
-                              "type": "button",
                               "label": "New Message",
-                              "event": "COMPOSE",
+                              "icon": "plus",
+                              "type": "button",
                               "variant": "primary",
-                              "icon": "plus"
+                              "event": "COMPOSE"
                             }
-                          ]
+                          ],
+                          "type": "stack",
+                          "gap": "sm",
+                          "direction": "horizontal",
+                          "justify": "space-between",
+                          "align": "center"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "data-list",
                           "entity": "AgentChatThread",
-                          "emptyIcon": "message-circle",
                           "emptyTitle": "No messages yet",
+                          "emptyIcon": "message-circle",
                           "emptyDescription": "Start a conversation by sending a message.",
                           "renderItem": [
                             "fn",
@@ -181,37 +256,40 @@
                               "children": [
                                 {
                                   "type": "stack",
-                                  "direction": "horizontal",
-                                  "gap": "sm",
-                                  "align": "center",
                                   "children": [
                                     {
-                                      "type": "badge",
-                                      "label": "@item.role"
+                                      "label": "@item.role",
+                                      "type": "badge"
                                     },
                                     {
-                                      "type": "badge",
                                       "label": "@item.status",
-                                      "variant": "outline"
+                                      "variant": "outline",
+                                      "type": "badge"
                                     },
                                     {
-                                      "type": "typography",
                                       "variant": "caption",
                                       "color": "muted",
+                                      "type": "typography",
                                       "content": "@item.timestamp"
                                     }
-                                  ]
+                                  ],
+                                  "gap": "sm",
+                                  "direction": "horizontal",
+                                  "align": "center"
                                 },
                                 {
-                                  "type": "typography",
+                                  "content": "@item.content",
                                   "variant": "body",
-                                  "content": "@item.content"
+                                  "type": "typography"
                                 }
                               ]
                             }
-                          ]
+                          ],
+                          "type": "data-list"
                         }
-                      ]
+                      ],
+                      "gap": "lg",
+                      "type": "stack"
                     }
                   ]
                 ]
@@ -225,16 +303,8 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
-                      "gap": "lg",
                       "children": [
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "sm",
-                          "justify": "space-between",
-                          "align": "center",
                           "children": [
                             {
                               "type": "stack",
@@ -243,9 +313,9 @@
                               "align": "center",
                               "children": [
                                 {
+                                  "size": "lg",
                                   "type": "icon",
-                                  "name": "message-circle",
-                                  "size": "lg"
+                                  "name": "message-circle"
                                 },
                                 {
                                   "type": "typography",
@@ -255,187 +325,170 @@
                               ]
                             },
                             {
-                              "type": "button",
                               "label": "New Message",
                               "event": "COMPOSE",
                               "variant": "primary",
                               "icon": "plus",
+                              "type": "button",
                               "disabled": true
                             }
-                          ]
+                          ],
+                          "justify": "space-between",
+                          "direction": "horizontal",
+                          "type": "stack",
+                          "gap": "sm",
+                          "align": "center"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "data-list",
                           "entity": "AgentChatThread",
-                          "emptyIcon": "message-circle",
-                          "emptyTitle": "No messages yet",
                           "emptyDescription": "Start a conversation by sending a message.",
                           "renderItem": [
                             "fn",
                             "item",
                             {
-                              "type": "stack",
                               "direction": "vertical",
                               "gap": "xs",
+                              "type": "stack",
                               "children": [
                                 {
-                                  "type": "stack",
+                                  "align": "center",
                                   "direction": "horizontal",
+                                  "type": "stack",
                                   "gap": "sm",
-                                  "align": "center",
                                   "children": [
                                     {
-                                      "type": "badge",
-                                      "label": "@item.role"
+                                      "label": "@item.role",
+                                      "type": "badge"
                                     },
                                     {
-                                      "type": "badge",
                                       "label": "@item.status",
-                                      "variant": "outline"
+                                      "variant": "outline",
+                                      "type": "badge"
                                     },
                                     {
-                                      "type": "typography",
-                                      "variant": "caption",
+                                      "content": "@item.timestamp",
                                       "color": "muted",
-                                      "content": "@item.timestamp"
+                                      "type": "typography",
+                                      "variant": "caption"
                                     }
                                   ]
                                 },
                                 {
                                   "type": "typography",
-                                  "variant": "body",
-                                  "content": "@item.content"
+                                  "content": "@item.content",
+                                  "variant": "body"
                                 }
                               ]
                             }
-                          ]
+                          ],
+                          "emptyIcon": "message-circle",
+                          "type": "data-list",
+                          "emptyTitle": "No messages yet"
                         },
                         {
-                          "type": "form-section",
                           "title": "Compose Message",
+                          "type": "form-section",
                           "children": [
                             {
-                              "type": "textarea",
                               "label": "Message",
+                              "placeholder": "Type your message...",
                               "bind": "@entity.content",
-                              "placeholder": "Type your message..."
+                              "type": "textarea"
                             },
                             {
-                              "type": "stack",
-                              "direction": "horizontal",
-                              "gap": "sm",
                               "children": [
                                 {
-                                  "type": "button",
-                                  "label": "Send",
-                                  "event": "SEND",
                                   "variant": "primary",
-                                  "icon": "send"
+                                  "event": "SEND",
+                                  "icon": "send",
+                                  "type": "button",
+                                  "label": "Send"
                                 }
-                              ]
+                              ],
+                              "direction": "horizontal",
+                              "gap": "sm",
+                              "type": "stack"
                             }
                           ]
                         }
-                      ]
+                      ],
+                      "type": "stack",
+                      "gap": "lg",
+                      "direction": "vertical"
                     }
                   ]
                 ]
               },
               {
-                "from": "composing",
+                "from": "idle",
                 "to": "idle",
-                "event": "SEND",
+                "event": "CLEAR",
                 "effects": [
                   [
-                    "set",
-                    "@entity.content",
-                    "@payload.content"
-                  ],
-                  [
-                    "set",
-                    "@entity.role",
-                    "user"
-                  ],
-                  [
-                    "set",
-                    "@entity.timestamp",
-                    "@now"
-                  ],
-                  [
-                    "set",
-                    "@entity.status",
-                    "sent"
+                    "persist",
+                    "delete",
+                    "AgentChatThread"
                   ],
                   [
-                    "persist",
-                    "create",
+                    "fetch",
                     "AgentChatThread",
                     {
-                      "role": "user",
-                      "content": "@payload.content",
-                      "timestamp": "@now",
-                      "status": "sent"
+                      "emit": {
+                        "success": "AgentChatThreadLoaded",
+                        "failure": "AgentChatThreadLoadFailed"
+                      }
                     }
                   ],
-                  [
-                    "emit",
-                    "SEND_MESSAGE"
-                  ],
-                  [
-                    "fetch",
-                    "AgentChatThread"
-                  ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
                       "gap": "lg",
+                      "direction": "vertical",
                       "children": [
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "sm",
-                          "justify": "space-between",
                           "align": "center",
+                          "gap": "sm",
                           "children": [
                             {
                               "type": "stack",
-                              "direction": "horizontal",
-                              "gap": "sm",
                               "align": "center",
                               "children": [
                                 {
                                   "type": "icon",
-                                  "name": "message-circle",
-                                  "size": "lg"
+                                  "size": "lg",
+                                  "name": "message-circle"
                                 },
                                 {
-                                  "type": "typography",
                                   "content": "AgentChatThread Thread",
+                                  "type": "typography",
                                   "variant": "h2"
                                 }
-                              ]
+                              ],
+                              "direction": "horizontal",
+                              "gap": "sm"
                             },
                             {
-                              "type": "button",
-                              "label": "New Message",
                               "event": "COMPOSE",
+                              "type": "button",
+                              "icon": "plus",
                               "variant": "primary",
-                              "icon": "plus"
+                              "label": "New Message"
                             }
-                          ]
+                          ],
+                          "direction": "horizontal",
+                          "justify": "space-between",
+                          "type": "stack"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "data-list",
                           "entity": "AgentChatThread",
+                          "type": "data-list",
                           "emptyIcon": "message-circle",
                           "emptyTitle": "No messages yet",
                           "emptyDescription": "Start a conversation by sending a message.",
@@ -444,8 +497,6 @@
                             "item",
                             {
                               "type": "stack",
-                              "direction": "vertical",
-                              "gap": "xs",
                               "children": [
                                 {
                                   "type": "stack",
@@ -464,8 +515,8 @@
                                     },
                                     {
                                       "type": "typography",
-                                      "variant": "caption",
                                       "color": "muted",
+                                      "variant": "caption",
                                       "content": "@item.timestamp"
                                     }
                                   ]
@@ -475,53 +526,87 @@
                                   "variant": "body",
                                   "content": "@item.content"
                                 }
-                              ]
+                              ],
+                              "direction": "vertical",
+                              "gap": "xs"
                             }
                           ]
                         }
-                      ]
+                      ],
+                      "type": "stack"
                     }
                   ]
                 ]
               },
               {
-                "from": "idle",
+                "from": "composing",
                 "to": "idle",
-                "event": "CLEAR",
+                "event": "SEND",
                 "effects": [
+                  [
+                    "set",
+                    "@entity.content",
+                    "@payload.content"
+                  ],
+                  [
+                    "set",
+                    "@entity.role",
+                    "user"
+                  ],
+                  [
+                    "set",
+                    "@entity.timestamp",
+                    "@now"
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "sent"
+                  ],
                   [
                     "persist",
-                    "delete",
-                    "AgentChatThread"
+                    "create",
+                    "AgentChatThread",
+                    {
+                      "timestamp": "@now",
+                      "content": "@payload.content",
+                      "status": "sent",
+                      "role": "user"
+                    }
+                  ],
+                  [
+                    "emit",
+                    "SEND_MESSAGE"
                   ],
                   [
                     "fetch",
-                    "AgentChatThread"
+                    "AgentChatThread",
+                    {
+                      "emit": {
+                        "success": "AgentChatThreadLoaded",
+                        "failure": "AgentChatThreadLoadFailed"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
                       "direction": "vertical",
+                      "type": "stack",
                       "gap": "lg",
                       "children": [
                         {
-                          "type": "stack",
                           "direction": "horizontal",
-                          "gap": "sm",
-                          "justify": "space-between",
+                          "type": "stack",
                           "align": "center",
                           "children": [
                             {
-                              "type": "stack",
                               "direction": "horizontal",
-                              "gap": "sm",
-                              "align": "center",
                               "children": [
                                 {
-                                  "type": "icon",
                                   "name": "message-circle",
+                                  "type": "icon",
                                   "size": "lg"
                                 },
                                 {
@@ -529,7 +614,10 @@
                                   "content": "AgentChatThread Thread",
                                   "variant": "h2"
                                 }
-                              ]
+                              ],
+                              "type": "stack",
+                              "gap": "sm",
+                              "align": "center"
                             },
                             {
                               "type": "button",
@@ -538,56 +626,58 @@
                               "variant": "primary",
                               "icon": "plus"
                             }
-                          ]
+                          ],
+                          "justify": "space-between",
+                          "gap": "sm"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "data-list",
-                          "entity": "AgentChatThread",
-                          "emptyIcon": "message-circle",
-                          "emptyTitle": "No messages yet",
                           "emptyDescription": "Start a conversation by sending a message.",
                           "renderItem": [
                             "fn",
                             "item",
                             {
-                              "type": "stack",
                               "direction": "vertical",
+                              "type": "stack",
                               "gap": "xs",
                               "children": [
                                 {
-                                  "type": "stack",
-                                  "direction": "horizontal",
                                   "gap": "sm",
-                                  "align": "center",
                                   "children": [
                                     {
-                                      "type": "badge",
-                                      "label": "@item.role"
+                                      "label": "@item.role",
+                                      "type": "badge"
                                     },
                                     {
                                       "type": "badge",
-                                      "label": "@item.status",
-                                      "variant": "outline"
+                                      "variant": "outline",
+                                      "label": "@item.status"
                                     },
                                     {
+                                      "color": "muted",
                                       "type": "typography",
                                       "variant": "caption",
-                                      "color": "muted",
                                       "content": "@item.timestamp"
                                     }
-                                  ]
+                                  ],
+                                  "type": "stack",
+                                  "direction": "horizontal",
+                                  "align": "center"
                                 },
                                 {
                                   "type": "typography",
-                                  "variant": "body",
-                                  "content": "@item.content"
+                                  "content": "@item.content",
+                                  "variant": "body"
                                 }
                               ]
                             }
-                          ]
+                          ],
+                          "type": "data-list",
+                          "entity": "AgentChatThread",
+                          "emptyTitle": "No messages yet",
+                          "emptyIcon": "message-circle"
                         }
                       ]
                     }
@@ -606,7 +696,13 @@
                   ],
                   [
                     "fetch",
-                    "AgentChatThread"
+                    "AgentChatThread",
+                    {
+                      "emit": {
+                        "success": "AgentChatThreadLoaded",
+                        "failure": "AgentChatThreadLoadFailed"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
@@ -617,36 +713,36 @@
                       "gap": "lg",
                       "children": [
                         {
-                          "type": "stack",
                           "direction": "horizontal",
-                          "gap": "sm",
                           "justify": "space-between",
                           "align": "center",
+                          "gap": "sm",
+                          "type": "stack",
                           "children": [
                             {
-                              "type": "stack",
-                              "direction": "horizontal",
-                              "gap": "sm",
-                              "align": "center",
                               "children": [
                                 {
-                                  "type": "icon",
+                                  "size": "lg",
                                   "name": "message-circle",
-                                  "size": "lg"
+                                  "type": "icon"
                                 },
                                 {
                                   "type": "typography",
                                   "content": "AgentChatThread Thread",
                                   "variant": "h2"
                                 }
-                              ]
+                              ],
+                              "type": "stack",
+                              "gap": "sm",
+                              "align": "center",
+                              "direction": "horizontal"
                             },
                             {
                               "type": "button",
-                              "label": "New Message",
+                              "icon": "plus",
                               "event": "COMPOSE",
-                              "variant": "primary",
-                              "icon": "plus"
+                              "label": "New Message",
+                              "variant": "primary"
                             }
                           ]
                         },
@@ -654,39 +750,36 @@
                           "type": "divider"
                         },
                         {
-                          "type": "data-list",
                           "entity": "AgentChatThread",
-                          "emptyIcon": "message-circle",
-                          "emptyTitle": "No messages yet",
                           "emptyDescription": "Start a conversation by sending a message.",
+                          "emptyTitle": "No messages yet",
+                          "type": "data-list",
+                          "emptyIcon": "message-circle",
                           "renderItem": [
                             "fn",
                             "item",
                             {
-                              "type": "stack",
-                              "direction": "vertical",
-                              "gap": "xs",
                               "children": [
                                 {
-                                  "type": "stack",
                                   "direction": "horizontal",
-                                  "gap": "sm",
                                   "align": "center",
+                                  "gap": "sm",
+                                  "type": "stack",
                                   "children": [
                                     {
-                                      "type": "badge",
-                                      "label": "@item.role"
+                                      "label": "@item.role",
+                                      "type": "badge"
                                     },
                                     {
-                                      "type": "badge",
+                                      "variant": "outline",
                                       "label": "@item.status",
-                                      "variant": "outline"
+                                      "type": "badge"
                                     },
                                     {
-                                      "type": "typography",
-                                      "variant": "caption",
                                       "color": "muted",
-                                      "content": "@item.timestamp"
+                                      "content": "@item.timestamp",
+                                      "type": "typography",
+                                      "variant": "caption"
                                     }
                                   ]
                                 },
@@ -695,7 +788,10 @@
                                   "variant": "body",
                                   "content": "@item.content"
                                 }
-                              ]
+                              ],
+                              "type": "stack",
+                              "direction": "vertical",
+                              "gap": "xs"
                             }
                           ]
                         }
@@ -705,7 +801,8 @@
                 ]
               }
             ]
-          }
+          },
+          "scope": "collection"
         }
       ],
       "pages": [
@@ -721,4 +818,4 @@
       ]
     }
   ]
-}
+}