@almadar/std 6.5.2 → 7.2.0

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

@@ -1,14 +1,14 @@
 {
   "name": "std-agent-memory",
   "version": "1.0.0",
-  "description": "Memory lifecycle atom for agent memory operations. Composes UI atoms (stdBrowse for memory table, stdModal for memorize form) with an agent trait that handles agent/memorize, agent/recall, agent/pin, agent/forget, agent/reinforce, and agent/decay operators.",
+  "description": "std-agent-memory as a Function",
   "orbitals": [
     {
       "name": "AgentMemoryOrbital",
       "entity": {
         "name": "AgentMemory",
-        "persistence": "persistent",
         "collection": "agentmemorys",
+        "persistence": "persistent",
         "fields": [
           {
             "name": "id",
@@ -49,7 +49,7 @@
           {
             "name": "strength",
             "type": "number",
-            "default": 1
+            "default": 1.0
           },
           {
             "name": "pinned",
@@ -71,40 +71,124 @@
       "traits": [
         {
           "name": "AgentMemoryBrowse",
-          "linkedEntity": "AgentMemory",
           "category": "interaction",
+          "linkedEntity": "AgentMemory",
+          "emits": [
+            {
+              "event": "AgentMemoryLoaded",
+              "description": "Fired when AgentMemory 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": "content",
+                  "type": "string"
+                },
+                {
+                  "name": "category",
+                  "type": "string"
+                },
+                {
+                  "name": "strength",
+                  "type": "number"
+                },
+                {
+                  "name": "pinned",
+                  "type": "boolean"
+                },
+                {
+                  "name": "scope",
+                  "type": "string"
+                },
+                {
+                  "name": "lastAccessedAt",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "AgentMemoryLoadFailed",
+              "description": "Fired when AgentMemory fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
+            }
+          ],
           "listens": [
             {
               "event": "MEMORIZED",
-              "scope": "external",
-              "triggers": "INIT"
+              "triggers": "INIT",
+              "source": {
+                "kind": "any"
+              }
             },
             {
               "event": "PINNED",
-              "scope": "external",
-              "triggers": "INIT"
+              "triggers": "INIT",
+              "source": {
+                "kind": "trait",
+                "trait": "AgentMemoryAgent"
+              }
             },
             {
               "event": "FORGOT",
-              "scope": "external",
-              "triggers": "INIT"
+              "triggers": "INIT",
+              "source": {
+                "kind": "trait",
+                "trait": "AgentMemoryAgent"
+              }
             },
             {
               "event": "REINFORCED",
-              "scope": "external",
-              "triggers": "INIT"
+              "triggers": "INIT",
+              "source": {
+                "kind": "trait",
+                "trait": "AgentMemoryAgent"
+              }
             },
             {
               "event": "DECAYED",
-              "scope": "external",
-              "triggers": "INIT"
+              "triggers": "INIT",
+              "source": {
+                "kind": "trait",
+                "trait": "AgentMemoryAgent"
+              }
             }
           ],
           "stateMachine": {
             "states": [
               {
-                "name": "browsing",
+                "name": "loading",
                 "isInitial": true
+              },
+              {
+                "name": "browsing"
+              },
+              {
+                "name": "error"
               }
             ],
             "events": [
@@ -113,20 +197,22 @@
                 "name": "Initialize"
               },
               {
-                "key": "MEMORIZE",
-                "name": "MEMORIZE"
+                "key": "AgentMemoryLoaded",
+                "name": "AgentMemory loaded"
               },
               {
-                "key": "RECALL",
-                "name": "RECALL"
-              },
-              {
-                "key": "DECAY",
-                "name": "DECAY"
+                "key": "AgentMemoryLoadFailed",
+                "name": "AgentMemory load failed",
+                "payload": [
+                  {
+                    "name": "message",
+                    "type": "string"
+                  }
+                ]
               },
               {
                 "key": "PIN",
-                "name": "PIN",
+                "name": "Pin",
                 "payload": [
                   {
                     "name": "id",
@@ -141,7 +227,7 @@
               },
               {
                 "key": "REINFORCE",
-                "name": "REINFORCE",
+                "name": "Reinforce",
                 "payload": [
                   {
                     "name": "id",
@@ -156,7 +242,7 @@
               },
               {
                 "key": "FORGET",
-                "name": "FORGET",
+                "name": "Forget",
                 "payload": [
                   {
                     "name": "id",
@@ -172,160 +258,341 @@
             ],
             "transitions": [
               {
-                "from": "browsing",
-                "to": "browsing",
+                "from": "loading",
+                "to": "loading",
                 "event": "INIT",
                 "effects": [
                   [
-                    "ref",
-                    "AgentMemory"
+                    "fetch",
+                    "AgentMemory",
+                    {
+                      "emit": {
+                        "success": "AgentMemoryLoaded",
+                        "failure": "AgentMemoryLoadFailed"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
+                      "direction": "vertical",
+                      "className": "py-12",
                       "type": "stack",
+                      "children": [
+                        {
+                          "type": "spinner",
+                          "size": "lg"
+                        },
+                        {
+                          "variant": "caption",
+                          "color": "muted",
+                          "content": "Loading memories…",
+                          "type": "typography"
+                        }
+                      ],
+                      "gap": "md",
+                      "align": "center"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "loading",
+                "to": "browsing",
+                "event": "AgentMemoryLoaded",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
                       "direction": "vertical",
-                      "gap": "lg",
                       "className": "max-w-5xl mx-auto w-full",
                       "children": [
                         {
+                          "align": "center",
+                          "gap": "md",
                           "type": "stack",
                           "direction": "horizontal",
-                          "gap": "md",
-                          "justify": "space-between",
-                          "align": "center",
                           "children": [
                             {
                               "type": "stack",
-                              "direction": "horizontal",
-                              "gap": "sm",
                               "align": "center",
                               "children": [
                                 {
                                   "type": "icon",
-                                  "name": "brain",
-                                  "size": "lg"
+                                  "size": "lg",
+                                  "name": "brain"
                                 },
                                 {
-                                  "type": "typography",
                                   "content": "AgentMemory Manager",
-                                  "variant": "h2"
+                                  "variant": "h2",
+                                  "type": "typography"
                                 }
-                              ]
+                              ],
+                              "direction": "horizontal",
+                              "gap": "sm"
                             },
                             {
                               "type": "stack",
-                              "direction": "horizontal",
                               "gap": "sm",
+                              "direction": "horizontal",
                               "children": [
                                 {
-                                  "type": "button",
                                   "label": "Memorize",
                                   "event": "MEMORIZE",
                                   "variant": "primary",
-                                  "icon": "plus"
+                                  "icon": "plus",
+                                  "type": "button"
                                 },
                                 {
                                   "type": "button",
                                   "label": "Recall",
+                                  "icon": "search",
                                   "event": "RECALL",
-                                  "variant": "secondary",
-                                  "icon": "search"
+                                  "variant": "secondary"
                                 },
                                 {
+                                  "icon": "clock",
                                   "type": "button",
-                                  "label": "Decay All",
                                   "event": "DECAY",
-                                  "variant": "ghost",
-                                  "icon": "clock"
+                                  "label": "Decay All",
+                                  "variant": "ghost"
                                 }
                               ]
                             }
-                          ]
+                          ],
+                          "justify": "space-between"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "data-grid",
-                          "entity": "AgentMemory",
-                          "emptyIcon": "inbox",
-                          "emptyTitle": "No memories yet",
-                          "emptyDescription": "Create your first memory to get started.",
                           "itemActions": [
                             {
-                              "label": "Pin",
                               "event": "PIN",
                               "variant": "ghost",
+                              "label": "Pin",
                               "size": "sm"
                             },
                             {
-                              "label": "Reinforce",
-                              "event": "REINFORCE",
+                              "size": "sm",
                               "variant": "ghost",
-                              "size": "sm"
+                              "label": "Reinforce",
+                              "event": "REINFORCE"
                             },
                             {
-                              "label": "Forget",
-                              "event": "FORGET",
+                              "size": "sm",
                               "variant": "danger",
-                              "size": "sm"
+                              "event": "FORGET",
+                              "label": "Forget"
                             }
                           ],
                           "columns": [
                             {
+                              "variant": "h4",
                               "name": "content",
                               "label": "Content",
-                              "variant": "h4",
                               "icon": "brain"
                             },
                             {
                               "name": "category",
                               "label": "Category",
-                              "variant": "badge",
-                              "colorMap": {
-                                "active": "success",
-                                "completed": "success",
-                                "done": "success",
-                                "pending": "warning",
-                                "draft": "warning",
-                                "scheduled": "warning",
-                                "inactive": "neutral",
-                                "archived": "neutral",
-                                "disabled": "neutral",
-                                "error": "destructive",
-                                "cancelled": "destructive",
-                                "failed": "destructive"
-                              }
+                              "variant": "badge"
                             },
                             {
-                              "name": "strength",
                               "label": "Strength",
-                              "variant": "caption"
+                              "variant": "caption",
+                              "name": "strength"
                             }
-                          ]
+                          ],
+                          "emptyDescription": "Create your first memory to get started.",
+                          "type": "data-grid",
+                          "entity": "AgentMemory",
+                          "emptyTitle": "No memories yet",
+                          "emptyIcon": "inbox"
                         }
-                      ]
+                      ],
+                      "type": "stack",
+                      "gap": "lg"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "loading",
+                "to": "error",
+                "event": "AgentMemoryLoadFailed",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "gap": "md",
+                      "direction": "vertical",
+                      "align": "center",
+                      "children": [
+                        {
+                          "size": "xl",
+                          "type": "icon",
+                          "name": "alert-triangle",
+                          "color": "destructive"
+                        },
+                        {
+                          "content": "Failed to load memories",
+                          "variant": "h3",
+                          "type": "typography"
+                        },
+                        {
+                          "color": "muted",
+                          "type": "typography",
+                          "content": "@payload.message",
+                          "variant": "body"
+                        },
+                        {
+                          "icon": "rotate-ccw",
+                          "label": "Retry",
+                          "event": "INIT",
+                          "type": "button",
+                          "variant": "primary"
+                        }
+                      ],
+                      "type": "stack",
+                      "className": "py-12"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "browsing",
+                "to": "loading",
+                "event": "INIT",
+                "effects": [
+                  [
+                    "fetch",
+                    "AgentMemory",
+                    {
+                      "emit": {
+                        "failure": "AgentMemoryLoadFailed",
+                        "success": "AgentMemoryLoaded"
+                      }
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "spinner",
+                      "size": "lg"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "error",
+                "to": "loading",
+                "event": "INIT",
+                "effects": [
+                  [
+                    "fetch",
+                    "AgentMemory",
+                    {
+                      "emit": {
+                        "failure": "AgentMemoryLoadFailed",
+                        "success": "AgentMemoryLoaded"
+                      }
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "size": "lg",
+                      "type": "spinner"
                     }
                   ]
                 ]
               }
             ]
-          }
+          },
+          "scope": "collection"
         },
         {
           "name": "AgentMemoryCreate",
-          "linkedEntity": "AgentMemory",
           "category": "interaction",
+          "linkedEntity": "AgentMemory",
           "emits": [
             {
-              "event": "SAVE",
-              "scope": "external"
+              "event": "MEMORIZED",
+              "scope": "external",
+              "payload": [
+                {
+                  "name": "id",
+                  "type": "string"
+                }
+              ]
             },
             {
-              "event": "MEMORIZED",
-              "scope": "external"
+              "event": "AgentMemoryLoaded",
+              "description": "Fired when AgentMemory 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": "content",
+                  "type": "string"
+                },
+                {
+                  "name": "category",
+                  "type": "string"
+                },
+                {
+                  "name": "strength",
+                  "type": "number"
+                },
+                {
+                  "name": "pinned",
+                  "type": "boolean"
+                },
+                {
+                  "name": "scope",
+                  "type": "string"
+                },
+                {
+                  "name": "lastAccessedAt",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "AgentMemoryLoadFailed",
+              "description": "Fired when AgentMemory fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
             }
           ],
           "stateMachine": {
@@ -345,7 +612,7 @@
               },
               {
                 "key": "MEMORIZE",
-                "name": "Open"
+                "name": "Memorize"
               },
               {
                 "key": "CLOSE",
@@ -361,6 +628,18 @@
                     "required": true
                   }
                 ]
+              },
+              {
+                "key": "MEMORIZED",
+                "name": "Memorized"
+              },
+              {
+                "key": "AgentMemoryLoaded",
+                "name": "AgentMemory loaded"
+              },
+              {
+                "key": "AgentMemoryLoadFailed",
+                "name": "AgentMemory load failed"
               }
             ],
             "transitions": [
@@ -370,8 +649,14 @@
                 "event": "INIT",
                 "effects": [
                   [
-                    "ref",
-                    "AgentMemory"
+                    "fetch",
+                    "AgentMemory",
+                    {
+                      "emit": {
+                        "failure": "AgentMemoryLoadFailed",
+                        "success": "AgentMemoryLoaded"
+                      }
+                    }
                   ]
                 ]
               },
@@ -386,7 +671,6 @@
                     {
                       "type": "stack",
                       "direction": "vertical",
-                      "gap": "md",
                       "children": [
                         {
                           "type": "stack",
@@ -394,14 +678,14 @@
                           "gap": "sm",
                           "children": [
                             {
+                              "size": "md",
                               "type": "icon",
-                              "name": "plus-circle",
-                              "size": "md"
+                              "name": "plus-circle"
                             },
                             {
                               "type": "typography",
-                              "content": "Memorize",
-                              "variant": "h3"
+                              "variant": "h3",
+                              "content": "Memorize"
                             }
                           ]
                         },
@@ -409,18 +693,19 @@
                           "type": "divider"
                         },
                         {
-                          "type": "form-section",
                           "entity": "AgentMemory",
                           "mode": "create",
-                          "submitEvent": "SAVE",
                           "cancelEvent": "CLOSE",
+                          "submitEvent": "SAVE",
                           "fields": [
                             "content",
                             "category",
                             "scope"
-                          ]
+                          ],
+                          "type": "form-section"
                         }
-                      ]
+                      ],
+                      "gap": "md"
                     }
                   ]
                 ]
@@ -435,6 +720,13 @@
                     "modal",
                     null
                   ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "box"
+                    }
+                  ],
                   [
                     "notify",
                     "Cancelled",
@@ -453,24 +745,35 @@
                     "AgentMemory",
                     "@payload.data"
                   ],
+                  [
+                    "emit",
+                    "MEMORIZED",
+                    {
+                      "id": "@payload.data.id"
+                    }
+                  ],
                   [
                     "render-ui",
                     "modal",
                     null
                   ],
                   [
-                    "emit",
-                    "MEMORIZED"
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "box"
+                    }
                   ]
                 ]
               }
             ]
-          }
+          },
+          "scope": "instance"
         },
         {
           "name": "AgentMemoryAgent",
-          "linkedEntity": "AgentMemory",
           "category": "interaction",
+          "linkedEntity": "AgentMemory",
           "emits": [
             {
               "event": "FORGOT",
@@ -511,6 +814,78 @@
                   "type": "string"
                 }
               ]
+            },
+            {
+              "event": "MEMORIZED",
+              "scope": "external",
+              "payload": [
+                {
+                  "name": "id",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "AgentMemoryLoaded",
+              "description": "Fired when AgentMemory 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": "content",
+                  "type": "string"
+                },
+                {
+                  "name": "category",
+                  "type": "string"
+                },
+                {
+                  "name": "strength",
+                  "type": "number"
+                },
+                {
+                  "name": "pinned",
+                  "type": "boolean"
+                },
+                {
+                  "name": "scope",
+                  "type": "string"
+                },
+                {
+                  "name": "lastAccessedAt",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "AgentMemoryLoadFailed",
+              "description": "Fired when AgentMemory fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
             }
           ],
           "stateMachine": {
@@ -539,6 +914,21 @@
                   }
                 ]
               },
+              {
+                "key": "DECAY",
+                "name": "Decay"
+              },
+              {
+                "key": "MEMORIZED",
+                "name": "Memorized",
+                "payload": [
+                  {
+                    "name": "data",
+                    "type": "object",
+                    "required": true
+                  }
+                ]
+              },
               {
                 "key": "RECALL",
                 "name": "Recall",
@@ -584,19 +974,28 @@
                 ]
               },
               {
-                "key": "DECAY",
-                "name": "Decay"
+                "key": "FORGOT",
+                "name": "Forgot"
               },
               {
-                "key": "MEMORIZED",
-                "name": "Memorized",
-                "payload": [
-                  {
-                    "name": "data",
-                    "type": "object",
-                    "required": true
-                  }
-                ]
+                "key": "REINFORCED",
+                "name": "Reinforced"
+              },
+              {
+                "key": "DECAYED",
+                "name": "Decayed"
+              },
+              {
+                "key": "PINNED",
+                "name": "Pinned"
+              },
+              {
+                "key": "AgentMemoryLoaded",
+                "name": "AgentMemory loaded"
+              },
+              {
+                "key": "AgentMemoryLoadFailed",
+                "name": "AgentMemory load failed"
               }
             ],
             "transitions": [
@@ -607,16 +1006,22 @@
                 "effects": [
                   [
                     "fetch",
-                    "AgentMemory"
+                    "AgentMemory",
+                    {
+                      "emit": {
+                        "success": "AgentMemoryLoaded",
+                        "failure": "AgentMemoryLoadFailed"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "empty-state",
-                      "icon": "brain",
                       "title": "Memory",
-                      "description": "Memory is ready"
+                      "icon": "brain",
+                      "description": "Memory is ready",
+                      "type": "empty-state"
                     }
                   ]
                 ]
@@ -636,6 +1041,47 @@
                     "create",
                     "AgentMemory",
                     "@payload.data"
+                  ],
+                  [
+                    "emit",
+                    "MEMORIZED",
+                    {
+                      "id": "@payload.data.id"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "idle",
+                "to": "idle",
+                "event": "DECAY",
+                "effects": [
+                  [
+                    "agent/decay"
+                  ],
+                  [
+                    "emit",
+                    "DECAYED",
+                    {
+                      "id": ""
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "idle",
+                "to": "active",
+                "event": "MEMORIZED",
+                "effects": [
+                  [
+                    "fetch",
+                    "AgentMemory",
+                    {
+                      "emit": {
+                        "failure": "AgentMemoryLoadFailed",
+                        "success": "AgentMemoryLoaded"
+                      }
+                    }
                   ]
                 ]
               },
@@ -673,7 +1119,10 @@
                   ],
                   [
                     "emit",
-                    "PINNED"
+                    "PINNED",
+                    {
+                      "id": "@payload.id"
+                    }
                   ]
                 ]
               },
@@ -688,7 +1137,10 @@
                   ],
                   [
                     "emit",
-                    "FORGOT"
+                    "FORGOT",
+                    {
+                      "id": "@payload.id"
+                    }
                   ]
                 ]
               },
@@ -703,21 +1155,10 @@
                   ],
                   [
                     "emit",
-                    "REINFORCED"
-                  ]
-                ]
-              },
-              {
-                "from": "idle",
-                "to": "idle",
-                "event": "DECAY",
-                "effects": [
-                  [
-                    "agent/decay"
-                  ],
-                  [
-                    "emit",
-                    "DECAYED"
+                    "REINFORCED",
+                    {
+                      "id": "@payload.id"
+                    }
                   ]
                 ]
               },
@@ -731,23 +1172,16 @@
                   ],
                   [
                     "emit",
-                    "DECAYED"
-                  ]
-                ]
-              },
-              {
-                "from": "idle",
-                "to": "active",
-                "event": "MEMORIZED",
-                "effects": [
-                  [
-                    "fetch",
-                    "AgentMemory"
+                    "DECAYED",
+                    {
+                      "id": ""
+                    }
                   ]
                 ]
               }
             ]
-          }
+          },
+          "scope": "collection"
         }
       ],
       "pages": [
@@ -769,4 +1203,4 @@
       ]
     }
   ]
-}
+}