npm - @almadar/std - Versions diffs - 6.1.0 → 6.1.7 - Mend

@almadar/std 6.1.0 → 6.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (446) hide show

package/{dist/exports → behaviors/registry}/organisms/std-agent-tutor.orb RENAMED Viewed

@@ -1,9 +1,20 @@
 {
-  "name": "AI Tutor",
+  "name": "std-agent-tutor",
   "version": "1.0.0",
+  "description": "Teaching assistant organism. Composes conversation + memory + classifier atoms with tabbed views and a concept browse list. Classifies student level, recalls prior learning from memory, generates explanations with context-aware difficulty, and tracks concept strength.",
   "orbitals": [
     {
       "name": "TutorSessionOrbital",
+      "uses": [
+        {
+          "from": "std/behaviors/std-browse",
+          "as": "Browse"
+        },
+        {
+          "from": "std/behaviors/std-tabs",
+          "as": "Tabs"
+        }
+      ],
       "entity": {
         "name": "TutorSession",
         "persistence": "runtime",
@@ -2145,10 +2156,6 @@
                         }
                       ]
                     }
-                  ],
-                  [
-                    "notify",
-                    "TutorChat created successfully"
                   ]
                 ]
               },
@@ -2282,10 +2289,6 @@
                         }
                       ]
                     }
-                  ],
-                  [
-                    "notify",
-                    "TutorChat deleted successfully"
                   ]
                 ]
               },
@@ -2419,10 +2422,6 @@
                         }
                       ]
                     }
-                  ],
-                  [
-                    "notify",
-                    "TutorChat deleted successfully"
                   ]
                 ]
               }
@@ -2729,23 +2728,28 @@
           "listens": [
             {
               "event": "MEMORIZED",
-              "triggers": "INIT"
+              "triggers": "INIT",
+              "scope": "internal"
             },
             {
               "event": "PINNED",
-              "triggers": "INIT"
+              "triggers": "INIT",
+              "scope": "internal"
             },
             {
               "event": "FORGOT",
-              "triggers": "INIT"
+              "triggers": "INIT",
+              "scope": "internal"
             },
             {
               "event": "REINFORCED",
-              "triggers": "INIT"
+              "triggers": "INIT",
+              "scope": "internal"
             },
             {
               "event": "DECAYED",
-              "triggers": "INIT"
+              "triggers": "INIT",
+              "scope": "internal"
             }
           ],
           "stateMachine": {
@@ -2991,10 +2995,12 @@
           "category": "interaction",
           "emits": [
             {
-              "event": "SAVE"
+              "event": "SAVE",
+              "scope": "internal"
             },
             {
-              "event": "MEMORIZED"
+              "event": "MEMORIZED",
+              "scope": "internal"
             }
           ],
           "stateMachine": {
@@ -3130,10 +3136,6 @@
                   [
                     "emit",
                     "MEMORIZED"
-                  ],
-                  [
-                    "notify",
-                    "Concept created successfully"
                   ]
                 ]
               }
@@ -3332,10 +3334,6 @@
                     "create",
                     "Concept",
                     "@payload.data"
-                  ],
-                  [
-                    "notify",
-                    "Concept created successfully"
                   ]
                 ]
               },
@@ -3525,10 +3523,12 @@
           "category": "interaction",
           "emits": [
             {
-              "event": "SAVE"
+              "event": "SAVE",
+              "scope": "internal"
             },
             {
-              "event": "CLASSIFIED"
+              "event": "CLASSIFIED",
+              "scope": "internal"
             }
           ],
           "stateMachine": {
@@ -3927,10 +3927,6 @@
                         }
                       ]
                     }
-                  ],
-                  [
-                    "notify",
-                    "StudentAssessment created successfully"
                   ]
                 ]
               }
@@ -4508,142 +4504,112 @@
       },
       "traits": [
         {
+          "ref": "Tabs.traits.TabContentTabs",
           "name": "TutorTabs",
           "linkedEntity": "TutorSession",
-          "category": "interaction",
-          "stateMachine": {
-            "states": [
-              {
-                "name": "idle",
-                "isInitial": true
-              }
-            ],
-            "events": [
-              {
-                "key": "INIT",
-                "name": "Initialize"
-              },
-              {
-                "key": "SELECT_TAB",
-                "name": "Select Tab",
-                "payload": [
-                  {
-                    "name": "tab",
-                    "type": "string",
-                    "required": true
-                  }
-                ]
-              }
-            ],
-            "transitions": [
-              {
-                "from": "idle",
-                "to": "idle",
-                "event": "INIT",
-                "effects": [
-                  [
-                    "fetch",
-                    "TutorSession"
+          "effects": {
+            "INIT": [
+              [
+                "fetch",
+                "TutorSession"
+              ],
+              [
+                "render-ui",
+                "main",
+                {
+                  "type": "dashboard-layout",
+                  "appName": "AI Tutor",
+                  "navItems": [
+                    {
+                      "label": "Teach",
+                      "href": "/teach",
+                      "icon": "book-open"
+                    },
+                    {
+                      "label": "Quiz",
+                      "href": "/quiz",
+                      "icon": "help-circle"
+                    },
+                    {
+                      "label": "Concepts",
+                      "href": "/concepts",
+                      "icon": "brain"
+                    }
                   ],
-                  [
-                    "render-ui",
-                    "main",
+                  "children": [
                     {
-                      "type": "dashboard-layout",
-                      "appName": "AI Tutor",
-                      "navItems": [
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "children": [
                         {
-                          "label": "Teach",
-                          "href": "/teach",
-                          "icon": "book-open"
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "sm",
+                          "align": "center",
+                          "children": [
+                            {
+                              "type": "icon",
+                              "name": "graduation-cap",
+                              "size": "lg"
+                            },
+                            {
+                              "type": "typography",
+                              "content": "AI Tutor",
+                              "variant": "h2"
+                            }
+                          ]
                         },
                         {
-                          "label": "Quiz",
-                          "href": "/quiz",
-                          "icon": "help-circle"
+                          "type": "divider"
                         },
                         {
-                          "label": "Concepts",
-                          "href": "/concepts",
-                          "icon": "brain"
-                        }
-                      ],
-                      "children": [
+                          "type": "tabs",
+                          "tabs": [
+                            {
+                              "label": "Teach",
+                              "value": "teach"
+                            },
+                            {
+                              "label": "Quiz",
+                              "value": "quiz"
+                            },
+                            {
+                              "label": "Progress",
+                              "value": "progress"
+                            }
+                          ],
+                          "defaultActiveTab": "teach",
+                          "onTabChange": "SELECT_TAB"
+                        },
                         {
-                          "type": "stack",
-                          "direction": "vertical",
-                          "gap": "lg",
-                          "children": [
+                          "type": "divider"
+                        },
+                        {
+                          "type": "data-grid",
+                          "entity": "TutorSession",
+                          "emptyIcon": "inbox",
+                          "emptyTitle": "No tutorsessions yet",
+                          "emptyDescription": "Add tutorsessions to see them here.",
+                          "className": "transition-shadow hover:shadow-md cursor-pointer",
+                          "renderItem": [
+                            "fn",
+                            "item",
                             {
                               "type": "stack",
-                              "direction": "horizontal",
+                              "direction": "vertical",
                               "gap": "sm",
-                              "align": "center",
                               "children": [
-                                {
-                                  "type": "icon",
-                                  "name": "graduation-cap",
-                                  "size": "lg"
-                                },
                                 {
                                   "type": "typography",
-                                  "content": "AI Tutor",
-                                  "variant": "h2"
-                                }
-                              ]
-                            },
-                            {
-                              "type": "divider"
-                            },
-                            {
-                              "type": "tabs",
-                              "tabs": [
-                                {
-                                  "label": "Teach",
-                                  "value": "teach"
-                                },
-                                {
-                                  "label": "Quiz",
-                                  "value": "quiz"
+                                  "variant": "h4",
+                                  "content": "@item.topic"
                                 },
                                 {
-                                  "label": "Progress",
-                                  "value": "progress"
-                                }
-                              ],
-                              "defaultActiveTab": "teach",
-                              "onTabChange": "SELECT_TAB"
-                            },
-                            {
-                              "type": "divider"
-                            },
-                            {
-                              "type": "data-grid",
-                              "entity": "TutorSession",
-                              "emptyIcon": "inbox",
-                              "emptyTitle": "No tutorsessions yet",
-                              "emptyDescription": "Add tutorsessions to see them here.",
-                              "className": "transition-shadow hover:shadow-md cursor-pointer",
-                              "renderItem": [
-                                "fn",
-                                "item",
-                                {
-                                  "type": "stack",
-                                  "direction": "vertical",
-                                  "gap": "sm",
-                                  "children": [
-                                    {
-                                      "type": "typography",
-                                      "variant": "h4",
-                                      "content": "@item.topic"
-                                    },
-                                    {
-                                      "type": "typography",
-                                      "variant": "caption",
-                                      "color": "muted",
-                                      "content": "@item.teach"
-                                    }
-                                  ]
+                                  "type": "typography",
+                                  "variant": "caption",
+                                  "color": "muted",
+                                  "content": "@item.teach"
                                 }
                               ]
                             }
@@ -4652,117 +4618,112 @@
                       ]
                     }
                   ]
-                ]
-              },
-              {
-                "from": "idle",
-                "to": "idle",
-                "event": "SELECT_TAB",
-                "effects": [
-                  [
-                    "fetch",
-                    "TutorSession"
+                }
+              ]
+            ],
+            "SELECT_TAB": [
+              [
+                "fetch",
+                "TutorSession"
+              ],
+              [
+                "render-ui",
+                "main",
+                {
+                  "type": "dashboard-layout",
+                  "appName": "AI Tutor",
+                  "navItems": [
+                    {
+                      "label": "Teach",
+                      "href": "/teach",
+                      "icon": "book-open"
+                    },
+                    {
+                      "label": "Quiz",
+                      "href": "/quiz",
+                      "icon": "help-circle"
+                    },
+                    {
+                      "label": "Concepts",
+                      "href": "/concepts",
+                      "icon": "brain"
+                    }
                   ],
-                  [
-                    "render-ui",
-                    "main",
+                  "children": [
                     {
-                      "type": "dashboard-layout",
-                      "appName": "AI Tutor",
-                      "navItems": [
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "children": [
                         {
-                          "label": "Teach",
-                          "href": "/teach",
-                          "icon": "book-open"
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "sm",
+                          "align": "center",
+                          "children": [
+                            {
+                              "type": "icon",
+                              "name": "graduation-cap",
+                              "size": "lg"
+                            },
+                            {
+                              "type": "typography",
+                              "content": "AI Tutor",
+                              "variant": "h2"
+                            }
+                          ]
                         },
                         {
-                          "label": "Quiz",
-                          "href": "/quiz",
-                          "icon": "help-circle"
+                          "type": "divider"
                         },
                         {
-                          "label": "Concepts",
-                          "href": "/concepts",
-                          "icon": "brain"
-                        }
-                      ],
-                      "children": [
+                          "type": "tabs",
+                          "tabs": [
+                            {
+                              "label": "Teach",
+                              "value": "teach"
+                            },
+                            {
+                              "label": "Quiz",
+                              "value": "quiz"
+                            },
+                            {
+                              "label": "Progress",
+                              "value": "progress"
+                            }
+                          ],
+                          "defaultActiveTab": "teach",
+                          "activeTab": "@payload.tab",
+                          "onTabChange": "SELECT_TAB"
+                        },
                         {
-                          "type": "stack",
-                          "direction": "vertical",
-                          "gap": "lg",
-                          "children": [
+                          "type": "divider"
+                        },
+                        {
+                          "type": "data-grid",
+                          "entity": "TutorSession",
+                          "emptyIcon": "inbox",
+                          "emptyTitle": "No tutorsessions yet",
+                          "emptyDescription": "Add tutorsessions to see them here.",
+                          "className": "transition-shadow hover:shadow-md cursor-pointer",
+                          "renderItem": [
+                            "fn",
+                            "item",
                             {
                               "type": "stack",
-                              "direction": "horizontal",
+                              "direction": "vertical",
                               "gap": "sm",
-                              "align": "center",
                               "children": [
-                                {
-                                  "type": "icon",
-                                  "name": "graduation-cap",
-                                  "size": "lg"
-                                },
                                 {
                                   "type": "typography",
-                                  "content": "AI Tutor",
-                                  "variant": "h2"
-                                }
-                              ]
-                            },
-                            {
-                              "type": "divider"
-                            },
-                            {
-                              "type": "tabs",
-                              "tabs": [
-                                {
-                                  "label": "Teach",
-                                  "value": "teach"
-                                },
-                                {
-                                  "label": "Quiz",
-                                  "value": "quiz"
+                                  "variant": "h4",
+                                  "content": "@item.topic"
                                 },
                                 {
-                                  "label": "Progress",
-                                  "value": "progress"
-                                }
-                              ],
-                              "defaultActiveTab": "teach",
-                              "activeTab": "@payload.tab",
-                              "onTabChange": "SELECT_TAB"
-                            },
-                            {
-                              "type": "divider"
-                            },
-                            {
-                              "type": "data-grid",
-                              "entity": "TutorSession",
-                              "emptyIcon": "inbox",
-                              "emptyTitle": "No tutorsessions yet",
-                              "emptyDescription": "Add tutorsessions to see them here.",
-                              "className": "transition-shadow hover:shadow-md cursor-pointer",
-                              "renderItem": [
-                                "fn",
-                                "item",
-                                {
-                                  "type": "stack",
-                                  "direction": "vertical",
-                                  "gap": "sm",
-                                  "children": [
-                                    {
-                                      "type": "typography",
-                                      "variant": "h4",
-                                      "content": "@item.topic"
-                                    },
-                                    {
-                                      "type": "typography",
-                                      "variant": "caption",
-                                      "color": "muted",
-                                      "content": "@item.teach"
-                                    }
-                                  ]
+                                  "type": "typography",
+                                  "variant": "caption",
+                                  "color": "muted",
+                                  "content": "@item.teach"
                                 }
                               ]
                             }
@@ -4771,8 +4732,8 @@
                       ]
                     }
                   ]
-                ]
-              }
+                }
+              ]
             ]
           }
         }
@@ -4787,6 +4748,12 @@
             }
           ]
         }
+      ],
+      "uses": [
+        {
+          "from": "std/behaviors/std-tabs",
+          "as": "Tabs"
+        }
       ]
     },
     {
@@ -4820,168 +4787,134 @@
       },
       "traits": [
         {
+          "ref": "Browse.traits.BrowseItemBrowse",
           "name": "ConceptsBrowse",
           "linkedEntity": "Concept",
-          "category": "interaction",
-          "stateMachine": {
-            "states": [
-              {
-                "name": "browsing",
-                "isInitial": true
-              }
-            ],
-            "events": [
-              {
-                "key": "INIT",
-                "name": "Initialize"
-              },
-              {
-                "key": "VIEW",
-                "name": "VIEW",
-                "payload": [
-                  {
-                    "name": "id",
-                    "type": "string",
-                    "required": true
-                  },
-                  {
-                    "name": "row",
-                    "type": "object"
-                  }
-                ]
-              }
-            ],
-            "transitions": [
-              {
-                "from": "browsing",
-                "to": "browsing",
-                "event": "INIT",
-                "effects": [
-                  [
-                    "ref",
-                    "Concept"
+          "effects": {
+            "INIT": [
+              [
+                "ref",
+                "Concept"
+              ],
+              [
+                "render-ui",
+                "main",
+                {
+                  "type": "dashboard-layout",
+                  "appName": "AI Tutor",
+                  "navItems": [
+                    {
+                      "label": "Teach",
+                      "href": "/teach",
+                      "icon": "book-open"
+                    },
+                    {
+                      "label": "Quiz",
+                      "href": "/quiz",
+                      "icon": "help-circle"
+                    },
+                    {
+                      "label": "Concepts",
+                      "href": "/concepts",
+                      "icon": "brain"
+                    }
                   ],
-                  [
-                    "render-ui",
-                    "main",
+                  "children": [
                     {
-                      "type": "dashboard-layout",
-                      "appName": "AI Tutor",
-                      "navItems": [
-                        {
-                          "label": "Teach",
-                          "href": "/teach",
-                          "icon": "book-open"
-                        },
-                        {
-                          "label": "Quiz",
-                          "href": "/quiz",
-                          "icon": "help-circle"
-                        },
-                        {
-                          "label": "Concepts",
-                          "href": "/concepts",
-                          "icon": "brain"
-                        }
-                      ],
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "className": "max-w-5xl mx-auto w-full",
                       "children": [
                         {
                           "type": "stack",
-                          "direction": "vertical",
-                          "gap": "lg",
-                          "className": "max-w-5xl mx-auto w-full",
+                          "direction": "horizontal",
+                          "gap": "md",
+                          "justify": "space-between",
+                          "align": "center",
                           "children": [
                             {
                               "type": "stack",
                               "direction": "horizontal",
-                              "gap": "md",
-                              "justify": "space-between",
+                              "gap": "sm",
                               "align": "center",
                               "children": [
                                 {
-                                  "type": "stack",
-                                  "direction": "horizontal",
-                                  "gap": "sm",
-                                  "align": "center",
-                                  "children": [
-                                    {
-                                      "type": "icon",
-                                      "name": "brain",
-                                      "size": "lg"
-                                    },
-                                    {
-                                      "type": "typography",
-                                      "content": "Learned Concepts",
-                                      "variant": "h2"
-                                    }
-                                  ]
+                                  "type": "icon",
+                                  "name": "brain",
+                                  "size": "lg"
+                                },
+                                {
+                                  "type": "typography",
+                                  "content": "Learned Concepts",
+                                  "variant": "h2"
                                 }
                               ]
-                            },
+                            }
+                          ]
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        {
+                          "type": "data-grid",
+                          "entity": "Concept",
+                          "emptyIcon": "inbox",
+                          "emptyTitle": "No concepts yet",
+                          "emptyDescription": "Complete lessons and quizzes to build your concept library.",
+                          "itemActions": [
                             {
-                              "type": "divider"
+                              "label": "View",
+                              "event": "VIEW",
+                              "variant": "ghost",
+                              "size": "sm"
+                            }
+                          ],
+                          "columns": [
+                            {
+                              "name": "content",
+                              "label": "Content",
+                              "variant": "h4",
+                              "icon": "brain"
                             },
                             {
-                              "type": "data-grid",
-                              "entity": "Concept",
-                              "emptyIcon": "inbox",
-                              "emptyTitle": "No concepts yet",
-                              "emptyDescription": "Complete lessons and quizzes to build your concept library.",
-                              "itemActions": [
-                                {
-                                  "label": "View",
-                                  "event": "VIEW",
-                                  "variant": "ghost",
-                                  "size": "sm"
-                                }
-                              ],
-                              "columns": [
-                                {
-                                  "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"
-                                  }
-                                },
-                                {
-                                  "name": "strength",
-                                  "label": "Strength",
-                                  "variant": "caption"
-                                }
-                              ]
+                              "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"
+                              }
                             },
                             {
-                              "type": "floating-action-button",
-                              "icon": "plus",
-                              "event": "INIT",
-                              "label": "Create",
-                              "tooltip": "Create"
+                              "name": "strength",
+                              "label": "Strength",
+                              "variant": "caption"
                             }
                           ]
+                        },
+                        {
+                          "type": "floating-action-button",
+                          "icon": "plus",
+                          "event": "INIT",
+                          "label": "Create",
+                          "tooltip": "Create"
                         }
                       ]
                     }
                   ]
-                ]
-              }
+                }
+              ]
             ]
           }
         }
@@ -4996,8 +4929,13 @@
             }
           ]
         }
+      ],
+      "uses": [
+        {
+          "from": "std/behaviors/std-browse",
+          "as": "Browse"
+        }
       ]
     }
-  ],
-  "description": "Teaching assistant organism. Composes conversation + memory + classifier atoms with tabbed views and a concept browse list. Classifies student level, recalls prior learning from memory, generates explanations with context-aware difficulty, and tracks concept strength. Composed from: - stdAgentConversation: multi-turn teaching interaction - stdAgentMemory: tracks concept strength per student topic - stdAgentClassifier: classifies student level - stdTabs: Teach / Quiz / Progress tab navigation - stdBrowse: browsable concepts list with strength tracking Cross-trait events: - ASSESSMENT_DONE (Teaching -> Quiz): student assessed, generate quiz - QUIZ_GRADED (Quiz -> Memory): reinforce or decay concept based on answer Pages: /teach (initial), /quiz, /concepts (2026-04-08). The canonical source for std behaviors is now the registry `.orb` file at `packages/almadar-std/behaviors/registry/<level>/<name>.orb`, which is generated from this TS source by `tools/almadar-behavior-ts-to-orb/` and consumed by the compiler's embedded loader. Consumers should import behaviors via `.lolo`/`.orb` `uses` declarations and reference them as `Alias.entity` / `Alias.traits.X` / `Alias.pages.X`, applying overrides at the call site (`linkedEntity`, `name`, `events`, `effects`, `listens`, `emitsScope`). The TS `*Params` interface and the exported factory functions remain ONLY as the authoring path for the converter; they are NOT a stable public API and may change without notice. See `docs/Almadar_Orb_Behaviors.md` for the orbital-as-function model and `docs/LOLO_Gaps.md` for the migration plan."
-}
+  ]
+}