@almadar/std 6.5.2 → 7.2.0

package/behaviors/registry/atoms/std-agent-tool-call.orb

@@ -1,14 +1,14 @@
 {
   "name": "std-agent-tool-call",
   "version": "1.0.0",
-  "description": "Tool execution atom for agent tool invocation. Composes UI atoms (stdModal for invoke form, stdAgentActivityLog for call history) with an agent trait that handles agent/invoke and TOOL_STARTED/TOOL_COMPLETED emits.",
+  "description": "std-agent-tool-call as a Function",
   "orbitals": [
     {
       "name": "AgentToolCallOrbital",
       "entity": {
         "name": "AgentToolCall",
-        "persistence": "persistent",
         "collection": "agenttoolcalls",
+        "persistence": "persistent",
         "fields": [
           {
             "name": "id",
@@ -59,7 +59,7 @@
           {
             "name": "duration",
             "type": "number",
-            "default": 0
+            "default": 0.0
           },
           {
             "name": "action",
@@ -81,16 +81,88 @@
       "traits": [
         {
           "name": "AgentToolCallModal",
-          "linkedEntity": "AgentToolCall",
           "category": "interaction",
+          "linkedEntity": "AgentToolCall",
           "emits": [
             {
-              "event": "SAVE",
-              "scope": "external"
+              "event": "INVOKED",
+              "scope": "external",
+              "payload": [
+                {
+                  "name": "id",
+                  "type": "string"
+                }
+              ]
             },
             {
-              "event": "INVOKED",
-              "scope": "external"
+              "event": "AgentToolCallLoaded",
+              "description": "Fired when AgentToolCall 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": "toolName",
+                  "type": "string"
+                },
+                {
+                  "name": "args",
+                  "type": "string"
+                },
+                {
+                  "name": "result",
+                  "type": "string"
+                },
+                {
+                  "name": "error",
+                  "type": "string"
+                },
+                {
+                  "name": "duration",
+                  "type": "number"
+                },
+                {
+                  "name": "action",
+                  "type": "string"
+                },
+                {
+                  "name": "detail",
+                  "type": "string"
+                },
+                {
+                  "name": "timestamp",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "AgentToolCallLoadFailed",
+              "description": "Fired when AgentToolCall fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
             }
           ],
           "stateMachine": {
@@ -110,7 +182,7 @@
               },
               {
                 "key": "INVOKE",
-                "name": "Open"
+                "name": "Invoke"
               },
               {
                 "key": "CLOSE",
@@ -126,6 +198,24 @@
                     "required": true
                   }
                 ]
+              },
+              {
+                "key": "INVOKED",
+                "name": "Invoked"
+              },
+              {
+                "key": "AgentToolCallLoaded",
+                "name": "AgentToolCall loaded"
+              },
+              {
+                "key": "AgentToolCallLoadFailed",
+                "name": "AgentToolCall load failed",
+                "payload": [
+                  {
+                    "name": "message",
+                    "type": "string"
+                  }
+                ]
               }
             ],
             "transitions": [
@@ -142,12 +232,9 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
                       "gap": "lg",
                       "children": [
                         {
-                          "type": "stack",
                           "direction": "horizontal",
                           "gap": "md",
                           "justify": "space-between",
@@ -158,9 +245,9 @@
                               "gap": "md",
                               "children": [
                                 {
+                                  "size": "lg",
                                   "type": "icon",
-                                  "name": "wrench",
-                                  "size": "lg"
+                                  "name": "wrench"
                                 },
                                 {
                                   "type": "typography",
@@ -171,23 +258,26 @@
                             },
                             {
                               "type": "button",
-                              "label": "Open",
-                              "event": "INVOKE",
+                              "icon": "wrench",
                               "variant": "primary",
-                              "icon": "wrench"
+                              "label": "Open",
+                              "event": "INVOKE"
                             }
-                          ]
+                          ],
+                          "type": "stack"
                         },
                         {
                           "type": "divider"
                         },
                         {
                           "type": "empty-state",
+                          "description": "Click Open to view details in a modal overlay.",
                           "icon": "wrench",
-                          "title": "Nothing open",
-                          "description": "Click Open to view details in a modal overlay."
+                          "title": "Nothing open"
                         }
-                      ]
+                      ],
+                      "direction": "vertical",
+                      "type": "stack"
                     }
                   ]
                 ]
@@ -201,14 +291,10 @@
                     "render-ui",
                     "modal",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
                       "gap": "md",
                       "children": [
                         {
-                          "type": "stack",
                           "direction": "horizontal",
-                          "gap": "sm",
                           "children": [
                             {
                               "type": "icon",
@@ -216,27 +302,31 @@
                               "size": "md"
                             },
                             {
-                              "type": "typography",
                               "content": "Invoke Tool",
+                              "type": "typography",
                               "variant": "h3"
                             }
-                          ]
+                          ],
+                          "type": "stack",
+                          "gap": "sm"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "form-section",
-                          "entity": "AgentToolCall",
-                          "mode": "create",
-                          "submitEvent": "SAVE",
                           "cancelEvent": "CLOSE",
                           "fields": [
                             "toolName",
                             "args"
-                          ]
+                          ],
+                          "entity": "AgentToolCall",
+                          "type": "form-section",
+                          "mode": "create",
+                          "submitEvent": "SAVE"
                         }
-                      ]
+                      ],
+                      "type": "stack",
+                      "direction": "vertical"
                     }
                   ]
                 ]
@@ -264,50 +354,50 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
                       "direction": "vertical",
                       "gap": "lg",
+                      "type": "stack",
                       "children": [
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "md",
-                          "justify": "space-between",
                           "children": [
                             {
-                              "type": "stack",
                               "direction": "horizontal",
+                              "type": "stack",
                               "gap": "md",
                               "children": [
                                 {
-                                  "type": "icon",
+                                  "size": "lg",
                                   "name": "wrench",
-                                  "size": "lg"
+                                  "type": "icon"
                                 },
                                 {
+                                  "variant": "h2",
                                   "type": "typography",
-                                  "content": "Invoke Tool",
-                                  "variant": "h2"
+                                  "content": "Invoke Tool"
                                 }
                               ]
                             },
                             {
-                              "type": "button",
                               "label": "Open",
                               "event": "INVOKE",
+                              "icon": "wrench",
                               "variant": "primary",
-                              "icon": "wrench"
+                              "type": "button"
                             }
-                          ]
+                          ],
+                          "justify": "space-between",
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "md"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "empty-state",
-                          "icon": "wrench",
+                          "description": "Click Open to view details in a modal overlay.",
                           "title": "Nothing open",
-                          "description": "Click Open to view details in a modal overlay."
+                          "type": "empty-state",
+                          "icon": "wrench"
                         }
                       ]
                     }
@@ -343,62 +433,63 @@
                     "main",
                     {
                       "type": "stack",
-                      "direction": "vertical",
-                      "gap": "lg",
                       "children": [
                         {
                           "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "md",
-                          "justify": "space-between",
                           "children": [
                             {
-                              "type": "stack",
-                              "direction": "horizontal",
                               "gap": "md",
                               "children": [
                                 {
-                                  "type": "icon",
+                                  "size": "lg",
                                   "name": "wrench",
-                                  "size": "lg"
+                                  "type": "icon"
                                 },
                                 {
                                   "type": "typography",
                                   "content": "Invoke Tool",
                                   "variant": "h2"
                                 }
-                              ]
+                              ],
+                              "type": "stack",
+                              "direction": "horizontal"
                             },
                             {
+                              "variant": "primary",
                               "type": "button",
+                              "icon": "wrench",
                               "label": "Open",
-                              "event": "INVOKE",
-                              "variant": "primary",
-                              "icon": "wrench"
+                              "event": "INVOKE"
                             }
-                          ]
+                          ],
+                          "gap": "md",
+                          "justify": "space-between",
+                          "direction": "horizontal"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "empty-state",
-                          "icon": "wrench",
+                          "description": "Click Open to view details in a modal overlay.",
                           "title": "Nothing open",
-                          "description": "Click Open to view details in a modal overlay."
+                          "type": "empty-state",
+                          "icon": "wrench"
                         }
-                      ]
+                      ],
+                      "gap": "lg",
+                      "direction": "vertical"
                     }
                   ]
                 ]
               }
             ]
-          }
+          },
+          "scope": "instance"
         },
         {
           "name": "AgentToolCallAgent",
-          "linkedEntity": "AgentToolCall",
           "category": "interaction",
+          "linkedEntity": "AgentToolCall",
           "emits": [
             {
               "event": "TOOL_STARTED",
@@ -441,13 +532,86 @@
                   "type": "string"
                 }
               ]
+            },
+            {
+              "event": "AgentToolCallLoaded",
+              "description": "Fired when AgentToolCall 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": "toolName",
+                  "type": "string"
+                },
+                {
+                  "name": "args",
+                  "type": "string"
+                },
+                {
+                  "name": "result",
+                  "type": "string"
+                },
+                {
+                  "name": "error",
+                  "type": "string"
+                },
+                {
+                  "name": "duration",
+                  "type": "number"
+                },
+                {
+                  "name": "action",
+                  "type": "string"
+                },
+                {
+                  "name": "detail",
+                  "type": "string"
+                },
+                {
+                  "name": "timestamp",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "AgentToolCallLoadFailed",
+              "description": "Fired when AgentToolCall fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
             }
           ],
           "listens": [
             {
               "event": "INVOKED",
               "triggers": "INVOKED",
-              "scope": "external"
+              "source": {
+                "kind": "trait",
+                "trait": "AgentToolCallModal"
+              }
             }
           ],
           "stateMachine": {
@@ -482,18 +646,37 @@
                   }
                 ]
               },
+              {
+                "key": "INVOKED",
+                "name": "Invoked"
+              },
               {
                 "key": "CANCEL",
                 "name": "Cancel"
               },
               {
-                "key": "INVOKED",
-                "name": "Invoked",
+                "key": "TOOL_STARTED",
+                "name": "Tool Started"
+              },
+              {
+                "key": "TOOL_COMPLETED",
+                "name": "Tool Completed"
+              },
+              {
+                "key": "LOG_ENTRY",
+                "name": "Log Entry"
+              },
+              {
+                "key": "AgentToolCallLoaded",
+                "name": "AgentToolCall loaded"
+              },
+              {
+                "key": "AgentToolCallLoadFailed",
+                "name": "AgentToolCall load failed",
                 "payload": [
                   {
-                    "name": "data",
-                    "type": "object",
-                    "required": true
+                    "name": "message",
+                    "type": "string"
                   }
                 ]
               }
@@ -506,15 +689,21 @@
                 "effects": [
                   [
                     "fetch",
-                    "AgentToolCall"
+                    "AgentToolCall",
+                    {
+                      "emit": {
+                        "success": "AgentToolCallLoaded",
+                        "failure": "AgentToolCallLoadFailed"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
                       "type": "empty-state",
-                      "icon": "wrench",
                       "title": "Tool Call",
+                      "icon": "wrench",
                       "description": "Tool Call is ready"
                     }
                   ]
@@ -581,42 +770,74 @@
                 ]
               },
               {
-                "from": "completed",
-                "to": "executing",
+                "from": "executing",
+                "to": "completed",
                 "event": "DO_INVOKE",
                 "effects": [
                   [
                     "set",
-                    "@entity.toolName",
-                    "@payload.data.toolName"
+                    "@entity.status",
+                    "completed"
                   ],
                   [
                     "set",
-                    "@entity.args",
-                    "@payload.data.args"
+                    "@entity.result",
+                    "@payload.data.result"
+                  ],
+                  [
+                    "emit",
+                    "TOOL_COMPLETED"
                   ],
+                  [
+                    "emit",
+                    "LOG_ENTRY"
+                  ]
+                ]
+              },
+              {
+                "from": "executing",
+                "to": "failed",
+                "event": "CANCEL",
+                "guard": [
+                  "=",
+                  "@entity.status",
+                  "executing"
+                ],
+                "effects": [
                   [
                     "set",
                     "@entity.status",
-                    "executing"
+                    "failed"
                   ],
                   [
-                    "emit",
-                    "TOOL_STARTED"
+                    "set",
+                    "@entity.error",
+                    "Cancelled"
                   ],
                   [
                     "emit",
-                    "LOG_ENTRY"
+                    "TOOL_COMPLETED"
+                  ]
+                ]
+              },
+              {
+                "from": "executing",
+                "to": "idle",
+                "event": "CANCEL",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.status",
+                    "idle"
                   ],
                   [
-                    "agent/invoke",
-                    "@payload.data.toolName",
-                    "@payload.data.args"
+                    "emit",
+                    "TOOL_COMPLETED"
                   ]
                 ]
               },
               {
-                "from": "failed",
+                "from": "completed",
                 "to": "executing",
                 "event": "DO_INVOKE",
                 "effects": [
@@ -651,74 +872,43 @@
                 ]
               },
               {
-                "from": "executing",
-                "to": "completed",
+                "from": "failed",
+                "to": "executing",
                 "event": "DO_INVOKE",
                 "effects": [
                   [
                     "set",
-                    "@entity.status",
-                    "completed"
+                    "@entity.toolName",
+                    "@payload.data.toolName"
                   ],
                   [
                     "set",
-                    "@entity.result",
-                    "@payload.data.result"
-                  ],
-                  [
-                    "emit",
-                    "TOOL_COMPLETED"
+                    "@entity.args",
+                    "@payload.data.args"
                   ],
-                  [
-                    "emit",
-                    "LOG_ENTRY"
-                  ]
-                ]
-              },
-              {
-                "from": "executing",
-                "to": "failed",
-                "event": "CANCEL",
-                "guard": [
-                  "=",
-                  "@entity.status",
-                  "executing"
-                ],
-                "effects": [
                   [
                     "set",
                     "@entity.status",
-                    "failed"
+                    "executing"
                   ],
                   [
-                    "set",
-                    "@entity.error",
-                    "Cancelled"
+                    "emit",
+                    "TOOL_STARTED"
                   ],
                   [
                     "emit",
-                    "TOOL_COMPLETED"
-                  ]
-                ]
-              },
-              {
-                "from": "executing",
-                "to": "idle",
-                "event": "CANCEL",
-                "effects": [
-                  [
-                    "set",
-                    "@entity.status",
-                    "idle"
+                    "LOG_ENTRY"
                   ],
                   [
-                    "emit",
-                    "TOOL_COMPLETED"
+                    "agent/invoke",
+                    "@payload.data.toolName",
+                    "@payload.data.args"
                   ]
                 ]
               }
             ]
-          }
+          },
+          "scope": "instance"
         }
       ],
       "pages": [
@@ -737,4 +927,4 @@
       ]
     }
   ]
-}
+}