@almadar/std 6.5.2 → 7.2.0

package/behaviors/registry/atoms/std-service-llm.orb

@@ -1,7 +1,7 @@
 {
   "name": "std-service-llm",
   "version": "1.0.0",
-  "description": "LLM service integration behavior: generate, classify, summarize text. Wraps the `llm` integration with 4 actions via separate action events. Pure function: params in, OrbitalDefinition out.",
+  "description": "std-service-llm as a Function",
   "orbitals": [
     {
       "name": "ServiceLlmOrbital",
@@ -66,8 +66,69 @@
       "traits": [
         {
           "name": "ServiceLlmLlm",
-          "linkedEntity": "ServiceLlm",
           "category": "interaction",
+          "linkedEntity": "ServiceLlm",
+          "emits": [
+            {
+              "event": "ServiceLlmLoaded",
+              "description": "Fired when ServiceLlm finishes loading",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "id",
+                  "type": "string",
+                  "required": true
+                },
+                {
+                  "name": "inputText",
+                  "type": "string"
+                },
+                {
+                  "name": "action",
+                  "type": "string"
+                },
+                {
+                  "name": "result",
+                  "type": "string"
+                },
+                {
+                  "name": "llmStatus",
+                  "type": "string"
+                },
+                {
+                  "name": "error",
+                  "type": "string"
+                },
+                {
+                  "name": "name",
+                  "type": "string"
+                },
+                {
+                  "name": "description",
+                  "type": "string"
+                },
+                {
+                  "name": "status",
+                  "type": "string"
+                },
+                {
+                  "name": "createdAt",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "ServiceLlmLoadFailed",
+              "description": "Fired when ServiceLlm fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
+            }
+          ],
           "stateMachine": {
             "states": [
               {
@@ -123,13 +184,27 @@
                   }
                 ]
               },
+              {
+                "key": "RESET",
+                "name": "Reset"
+              },
               {
                 "key": "RETRY",
                 "name": "Retry"
               },
               {
-                "key": "RESET",
-                "name": "Reset"
+                "key": "ServiceLlmLoaded",
+                "name": "ServiceLlm loaded"
+              },
+              {
+                "key": "ServiceLlmLoadFailed",
+                "name": "ServiceLlm load failed",
+                "payload": [
+                  {
+                    "name": "message",
+                    "type": "string"
+                  }
+                ]
               }
             ],
             "transitions": [
@@ -140,74 +215,80 @@
                 "effects": [
                   [
                     "fetch",
-                    "ServiceLlm"
+                    "ServiceLlm",
+                    {
+                      "emit": {
+                        "failure": "ServiceLlmLoadFailed",
+                        "success": "ServiceLlmLoaded"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
-                      "gap": "lg",
-                      "align": "stretch",
                       "children": [
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "md",
-                          "align": "center",
                           "children": [
                             {
                               "type": "icon",
-                              "name": "brain",
-                              "size": "lg"
+                              "size": "lg",
+                              "name": "brain"
                             },
                             {
+                              "variant": "h2",
                               "type": "typography",
-                              "content": "ServiceLlm LLM",
-                              "variant": "h2"
+                              "content": "ServiceLlm LLM"
                             }
-                          ]
+                          ],
+                          "gap": "md",
+                          "direction": "horizontal",
+                          "align": "center",
+                          "type": "stack"
                         },
                         {
                           "type": "divider"
                         },
                         {
                           "type": "textarea",
+                          "placeholder": "Enter text for LLM processing...",
                           "label": "Input Text",
-                          "bind": "@entity.inputText",
-                          "placeholder": "Enter text for LLM processing..."
+                          "bind": "@entity.inputText"
                         },
                         {
-                          "type": "stack",
                           "direction": "horizontal",
+                          "type": "stack",
                           "gap": "sm",
                           "justify": "center",
                           "children": [
                             {
                               "type": "button",
-                              "label": "Generate",
                               "event": "GENERATE",
+                              "label": "Generate",
                               "variant": "primary",
                               "icon": "sparkles"
                             },
                             {
                               "type": "button",
-                              "label": "Classify",
-                              "event": "CLASSIFY",
                               "variant": "secondary",
-                              "icon": "tag"
+                              "icon": "tag",
+                              "event": "CLASSIFY",
+                              "label": "Classify"
                             },
                             {
-                              "type": "button",
                               "label": "Summarize",
-                              "event": "SUMMARIZE",
+                              "type": "button",
+                              "icon": "align-left",
                               "variant": "secondary",
-                              "icon": "align-left"
+                              "event": "SUMMARIZE"
                             }
                           ]
                         }
-                      ]
+                      ],
+                      "gap": "lg",
+                      "align": "stretch",
+                      "type": "stack",
+                      "direction": "vertical"
                     }
                   ]
                 ]
@@ -226,9 +307,9 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "loading-state",
+                      "message": "Running servicellm LLM task...",
                       "title": "Processing...",
-                      "message": "Running servicellm LLM task..."
+                      "type": "loading-state"
                     }
                   ],
                   [
@@ -255,9 +336,9 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "loading-state",
                       "title": "Processing...",
-                      "message": "Running servicellm LLM task..."
+                      "message": "Running servicellm LLM task...",
+                      "type": "loading-state"
                     }
                   ],
                   [
@@ -289,9 +370,9 @@
                     "render-ui",
                     "main",
                     {
+                      "message": "Running servicellm LLM task...",
                       "type": "loading-state",
-                      "title": "Processing...",
-                      "message": "Running servicellm LLM task..."
+                      "title": "Processing..."
                     }
                   ],
                   [
@@ -323,15 +404,15 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
                       "gap": "lg",
                       "align": "center",
+                      "direction": "vertical",
+                      "type": "stack",
                       "children": [
                         {
-                          "type": "icon",
+                          "size": "lg",
                           "name": "check-circle",
-                          "size": "lg"
+                          "type": "icon"
                         },
                         {
                           "type": "alert",
@@ -339,15 +420,15 @@
                           "message": "LLM task complete"
                         },
                         {
-                          "type": "typography",
                           "variant": "body",
-                          "content": "@entity.result"
+                          "content": "@entity.result",
+                          "type": "typography"
                         },
                         {
                           "type": "button",
+                          "variant": "ghost",
                           "label": "Start Over",
                           "event": "RESET",
-                          "variant": "ghost",
                           "icon": "rotate-ccw"
                         }
                       ]
@@ -374,38 +455,38 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
                       "direction": "vertical",
-                      "gap": "lg",
                       "align": "center",
+                      "gap": "lg",
+                      "type": "stack",
                       "children": [
                         {
+                          "onRetry": "RETRY",
                           "type": "error-state",
-                          "title": "LLM Failed",
                           "message": "@entity.error",
-                          "onRetry": "RETRY"
+                          "title": "LLM Failed"
                         },
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "sm",
                           "justify": "center",
                           "children": [
                             {
-                              "type": "button",
                               "label": "Retry",
-                              "event": "RETRY",
+                              "icon": "refresh-cw",
                               "variant": "primary",
-                              "icon": "refresh-cw"
+                              "event": "RETRY",
+                              "type": "button"
                             },
                             {
-                              "type": "button",
+                              "icon": "rotate-ccw",
                               "label": "Reset",
-                              "event": "RESET",
                               "variant": "ghost",
-                              "icon": "rotate-ccw"
+                              "event": "RESET",
+                              "type": "button"
                             }
-                          ]
+                          ],
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "sm"
                         }
                       ]
                     }
@@ -413,9 +494,9 @@
                 ]
               },
               {
-                "from": "error",
+                "from": "complete",
                 "to": "idle",
-                "event": "RETRY",
+                "event": "RESET",
                 "effects": [
                   [
                     "set",
@@ -426,66 +507,66 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
                       "gap": "lg",
+                      "type": "stack",
                       "align": "stretch",
+                      "direction": "vertical",
                       "children": [
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "md",
                           "align": "center",
                           "children": [
                             {
+                              "size": "lg",
                               "type": "icon",
-                              "name": "brain",
-                              "size": "lg"
+                              "name": "brain"
                             },
                             {
-                              "type": "typography",
                               "content": "ServiceLlm LLM",
-                              "variant": "h2"
+                              "variant": "h2",
+                              "type": "typography"
                             }
-                          ]
+                          ],
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "md"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "textarea",
-                          "label": "Input Text",
                           "bind": "@entity.inputText",
+                          "label": "Input Text",
+                          "type": "textarea",
                           "placeholder": "Enter text for LLM processing..."
                         },
                         {
                           "type": "stack",
-                          "direction": "horizontal",
                           "gap": "sm",
                           "justify": "center",
                           "children": [
                             {
                               "type": "button",
-                              "label": "Generate",
-                              "event": "GENERATE",
                               "variant": "primary",
-                              "icon": "sparkles"
+                              "event": "GENERATE",
+                              "icon": "sparkles",
+                              "label": "Generate"
                             },
                             {
-                              "type": "button",
-                              "label": "Classify",
-                              "event": "CLASSIFY",
                               "variant": "secondary",
-                              "icon": "tag"
+                              "icon": "tag",
+                              "label": "Classify",
+                              "type": "button",
+                              "event": "CLASSIFY"
                             },
                             {
-                              "type": "button",
                               "label": "Summarize",
                               "event": "SUMMARIZE",
-                              "variant": "secondary",
-                              "icon": "align-left"
+                              "type": "button",
+                              "icon": "align-left",
+                              "variant": "secondary"
                             }
-                          ]
+                          ],
+                          "direction": "horizontal"
                         }
                       ]
                     }
@@ -493,9 +574,9 @@
                 ]
               },
               {
-                "from": "complete",
+                "from": "error",
                 "to": "idle",
-                "event": "RESET",
+                "event": "RETRY",
                 "effects": [
                   [
                     "set",
@@ -506,26 +587,24 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
-                      "gap": "lg",
                       "align": "stretch",
+                      "type": "stack",
                       "children": [
                         {
                           "type": "stack",
-                          "direction": "horizontal",
                           "gap": "md",
+                          "direction": "horizontal",
                           "align": "center",
                           "children": [
                             {
-                              "type": "icon",
+                              "size": "lg",
                               "name": "brain",
-                              "size": "lg"
+                              "type": "icon"
                             },
                             {
-                              "type": "typography",
+                              "variant": "h2",
                               "content": "ServiceLlm LLM",
-                              "variant": "h2"
+                              "type": "typography"
                             }
                           ]
                         },
@@ -533,20 +612,16 @@
                           "type": "divider"
                         },
                         {
-                          "type": "textarea",
                           "label": "Input Text",
                           "bind": "@entity.inputText",
+                          "type": "textarea",
                           "placeholder": "Enter text for LLM processing..."
                         },
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "sm",
-                          "justify": "center",
                           "children": [
                             {
-                              "type": "button",
                               "label": "Generate",
+                              "type": "button",
                               "event": "GENERATE",
                               "variant": "primary",
                               "icon": "sparkles"
@@ -559,15 +634,21 @@
                               "icon": "tag"
                             },
                             {
-                              "type": "button",
-                              "label": "Summarize",
                               "event": "SUMMARIZE",
+                              "type": "button",
                               "variant": "secondary",
+                              "label": "Summarize",
                               "icon": "align-left"
                             }
-                          ]
+                          ],
+                          "type": "stack",
+                          "gap": "sm",
+                          "direction": "horizontal",
+                          "justify": "center"
                         }
-                      ]
+                      ],
+                      "gap": "lg",
+                      "direction": "vertical"
                     }
                   ]
                 ]
@@ -586,16 +667,11 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
                       "direction": "vertical",
                       "gap": "lg",
-                      "align": "stretch",
                       "children": [
                         {
-                          "type": "stack",
                           "direction": "horizontal",
-                          "gap": "md",
-                          "align": "center",
                           "children": [
                             {
                               "type": "icon",
@@ -604,39 +680,42 @@
                             },
                             {
                               "type": "typography",
-                              "content": "ServiceLlm LLM",
-                              "variant": "h2"
+                              "variant": "h2",
+                              "content": "ServiceLlm LLM"
                             }
-                          ]
+                          ],
+                          "gap": "md",
+                          "type": "stack",
+                          "align": "center"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "textarea",
-                          "label": "Input Text",
                           "bind": "@entity.inputText",
+                          "label": "Input Text",
+                          "type": "textarea",
                           "placeholder": "Enter text for LLM processing..."
                         },
                         {
-                          "type": "stack",
                           "direction": "horizontal",
                           "gap": "sm",
+                          "type": "stack",
                           "justify": "center",
                           "children": [
                             {
-                              "type": "button",
-                              "label": "Generate",
                               "event": "GENERATE",
                               "variant": "primary",
-                              "icon": "sparkles"
+                              "type": "button",
+                              "icon": "sparkles",
+                              "label": "Generate"
                             },
                             {
-                              "type": "button",
                               "label": "Classify",
-                              "event": "CLASSIFY",
                               "variant": "secondary",
-                              "icon": "tag"
+                              "event": "CLASSIFY",
+                              "icon": "tag",
+                              "type": "button"
                             },
                             {
                               "type": "button",
@@ -647,13 +726,16 @@
                             }
                           ]
                         }
-                      ]
+                      ],
+                      "type": "stack",
+                      "align": "stretch"
                     }
                   ]
                 ]
               }
             ]
-          }
+          },
+          "scope": "instance"
         }
       ],
       "pages": [
@@ -669,4 +751,4 @@
       ]
     }
   ]
-}
+}