@almadar/std 3.12.1 → 3.13.0

package/behaviors/exports/molecules/std-agent-planner.orb

@@ -0,0 +1,898 @@
+{
+  "name": "AgentPlannerOrbital",
+  "orbitals": [
+    {
+      "name": "AgentPlannerOrbital",
+      "entity": {
+        "name": "AgentPlanner",
+        "persistence": "runtime",
+        "fields": [
+          {
+            "name": "id",
+            "type": "string"
+          },
+          {
+            "name": "name",
+            "type": "string"
+          },
+          {
+            "name": "description",
+            "type": "string"
+          },
+          {
+            "name": "status",
+            "type": "string",
+            "default": "active",
+            "values": [
+              "active",
+              "inactive",
+              "pending"
+            ]
+          },
+          {
+            "name": "createdAt",
+            "type": "string"
+          },
+          {
+            "name": "task",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "category",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "steps",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "confidence",
+            "type": "number",
+            "default": 0
+          },
+          {
+            "name": "relevantMemories",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "memoryCount",
+            "type": "number",
+            "default": 0
+          },
+          {
+            "name": "error",
+            "type": "string",
+            "default": ""
+          }
+        ]
+      },
+      "traits": [
+        {
+          "name": "AgentPlannerPlanner",
+          "linkedEntity": "AgentPlanner",
+          "category": "interaction",
+          "emits": [
+            {
+              "event": "PLAN_READY"
+            }
+          ],
+          "stateMachine": {
+            "states": [
+              {
+                "name": "idle",
+                "isInitial": true
+              },
+              {
+                "name": "classifying"
+              },
+              {
+                "name": "recalling"
+              },
+              {
+                "name": "planning"
+              },
+              {
+                "name": "ready"
+              }
+            ],
+            "events": [
+              {
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "key": "PLAN",
+                "name": "Start Planning"
+              },
+              {
+                "key": "CLASSIFIED",
+                "name": "Task Classified",
+                "payload": [
+                  {
+                    "name": "category",
+                    "type": "string",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "key": "MEMORIES_LOADED",
+                "name": "Memories Loaded",
+                "payload": [
+                  {
+                    "name": "memories",
+                    "type": "string",
+                    "required": true
+                  },
+                  {
+                    "name": "count",
+                    "type": "number",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "key": "PLAN_GENERATED",
+                "name": "Plan Generated",
+                "payload": [
+                  {
+                    "name": "steps",
+                    "type": "string",
+                    "required": true
+                  },
+                  {
+                    "name": "confidence",
+                    "type": "number",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "key": "FAILED",
+                "name": "Failed",
+                "payload": [
+                  {
+                    "name": "error",
+                    "type": "string",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "key": "RESET",
+                "name": "Reset"
+              }
+            ],
+            "transitions": [
+              {
+                "from": "idle",
+                "to": "idle",
+                "event": "INIT",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "children": [
+                        {
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "sm",
+                          "align": "center",
+                          "children": [
+                            {
+                              "type": "icon",
+                              "name": "map",
+                              "size": "lg"
+                            },
+                            {
+                              "type": "typography",
+                              "content": "Task Planner",
+                              "variant": "h2"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        {
+                          "type": "card",
+                          "children": [
+                            {
+                              "type": "stack",
+                              "direction": "vertical",
+                              "gap": "md",
+                              "children": [
+                                {
+                                  "type": "typography",
+                                  "content": "Describe the task to plan",
+                                  "variant": "body"
+                                },
+                                {
+                                  "type": "form-section",
+                                  "entity": "AgentPlanner",
+                                  "mode": "edit",
+                                  "submitEvent": "PLAN",
+                                  "fields": [
+                                    "task"
+                                  ]
+                                }
+                              ]
+                            }
+                          ]
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "idle",
+                "to": "classifying",
+                "event": "PLAN",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.status",
+                    "classifying"
+                  ],
+                  [
+                    "agent/generate",
+                    [
+                      "string/concat",
+                      "Classify this task into exactly one category.\n",
+                      "Categories: ",
+                      "code, schema, design, debug, deploy",
+                      "\n",
+                      "Task: ",
+                      "@entity.task",
+                      "\n",
+                      "Return only the category name."
+                    ]
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "icon",
+                          "name": "tag",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "Classifying task...",
+                          "variant": "h3"
+                        },
+                        {
+                          "type": "spinner",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "@entity.task",
+                          "variant": "caption"
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "classifying",
+                "to": "recalling",
+                "event": "CLASSIFIED",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.category",
+                    "@payload.category"
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "recalling"
+                  ],
+                  [
+                    "agent/recall",
+                    [
+                      "string/concat",
+                      "@entity.category",
+                      " ",
+                      "@entity.task"
+                    ],
+                    5
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "icon",
+                          "name": "brain",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "Recalling relevant experience...",
+                          "variant": "h3"
+                        },
+                        {
+                          "type": "spinner",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "badge",
+                          "label": [
+                            "string/concat",
+                            "Category: ",
+                            "@entity.category"
+                          ]
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "recalling",
+                "to": "planning",
+                "event": "MEMORIES_LOADED",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.relevantMemories",
+                    "@payload.memories"
+                  ],
+                  [
+                    "set",
+                    "@entity.memoryCount",
+                    "@payload.count"
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "planning"
+                  ],
+                  [
+                    "agent/generate",
+                    [
+                      "string/concat",
+                      "Task: ",
+                      "@entity.task",
+                      "\n",
+                      "Category: ",
+                      "@entity.category",
+                      "\n",
+                      "Relevant experience:\n",
+                      "@entity.relevantMemories",
+                      "\n\n",
+                      "Generate a numbered step-by-step execution plan. ",
+                      "Include a confidence score (0-100) for how likely this plan will succeed."
+                    ]
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "icon",
+                          "name": "cpu",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "Generating plan...",
+                          "variant": "h3"
+                        },
+                        {
+                          "type": "spinner",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "md",
+                          "justify": "center",
+                          "children": [
+                            {
+                              "type": "badge",
+                              "label": [
+                                "string/concat",
+                                "Category: ",
+                                "@entity.category"
+                              ]
+                            },
+                            {
+                              "type": "badge",
+                              "label": [
+                                "string/concat",
+                                [
+                                  "string/of",
+                                  "@entity.memoryCount"
+                                ],
+                                " memories loaded"
+                              ]
+                            }
+                          ]
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "planning",
+                "to": "ready",
+                "event": "PLAN_GENERATED",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.steps",
+                    "@payload.steps"
+                  ],
+                  [
+                    "set",
+                    "@entity.confidence",
+                    "@payload.confidence"
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "ready"
+                  ],
+                  [
+                    "agent/memorize",
+                    [
+                      "string/concat",
+                      "Plan for ",
+                      "@entity.category",
+                      " task: ",
+                      "@entity.task"
+                    ],
+                    "pattern-affinity"
+                  ],
+                  [
+                    "emit",
+                    "PLAN_READY"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "children": [
+                        {
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "sm",
+                          "align": "center",
+                          "justify": "space-between",
+                          "children": [
+                            {
+                              "type": "stack",
+                              "direction": "horizontal",
+                              "gap": "sm",
+                              "align": "center",
+                              "children": [
+                                {
+                                  "type": "icon",
+                                  "name": "check-circle",
+                                  "size": "lg"
+                                },
+                                {
+                                  "type": "typography",
+                                  "content": "Plan Ready",
+                                  "variant": "h2"
+                                }
+                              ]
+                            },
+                            {
+                              "type": "button",
+                              "label": "New Plan",
+                              "event": "RESET",
+                              "variant": "ghost",
+                              "icon": "rotate-ccw"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        {
+                          "type": "simple-grid",
+                          "columns": 3,
+                          "children": [
+                            {
+                              "type": "stat-display",
+                              "label": "Category",
+                              "value": "@entity.category",
+                              "icon": "tag"
+                            },
+                            {
+                              "type": "stat-display",
+                              "label": "Confidence",
+                              "value": [
+                                "string/concat",
+                                [
+                                  "string/of",
+                                  "@entity.confidence"
+                                ],
+                                "%"
+                              ],
+                              "icon": "target"
+                            },
+                            {
+                              "type": "stat-display",
+                              "label": "Memories Used",
+                              "value": "@entity.memoryCount",
+                              "icon": "brain"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        {
+                          "type": "card",
+                          "children": [
+                            {
+                              "type": "stack",
+                              "direction": "vertical",
+                              "gap": "md",
+                              "children": [
+                                {
+                                  "type": "typography",
+                                  "content": "Task",
+                                  "variant": "caption"
+                                },
+                                {
+                                  "type": "typography",
+                                  "content": "@entity.task",
+                                  "variant": "body"
+                                },
+                                {
+                                  "type": "divider"
+                                },
+                                {
+                                  "type": "typography",
+                                  "content": "Execution Plan",
+                                  "variant": "caption"
+                                },
+                                {
+                                  "type": "typography",
+                                  "content": "@entity.steps",
+                                  "variant": "body"
+                                }
+                              ]
+                            }
+                          ]
+                        },
+                        {
+                          "type": "card",
+                          "children": [
+                            {
+                              "type": "stack",
+                              "direction": "vertical",
+                              "gap": "sm",
+                              "children": [
+                                {
+                                  "type": "typography",
+                                  "content": "Relevant Memories",
+                                  "variant": "caption"
+                                },
+                                {
+                                  "type": "typography",
+                                  "content": "@entity.relevantMemories",
+                                  "variant": "body"
+                                }
+                              ]
+                            }
+                          ]
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "classifying",
+                "to": "idle",
+                "event": "FAILED",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.error",
+                    "@payload.error"
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "error"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "icon",
+                          "name": "alert-triangle",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "Planning Failed",
+                          "variant": "h2"
+                        },
+                        {
+                          "type": "alert",
+                          "variant": "error",
+                          "message": "@entity.error"
+                        },
+                        {
+                          "type": "button",
+                          "label": "Try Again",
+                          "event": "RESET",
+                          "variant": "primary",
+                          "icon": "rotate-ccw"
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "recalling",
+                "to": "idle",
+                "event": "FAILED",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.error",
+                    "@payload.error"
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "error"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "icon",
+                          "name": "alert-triangle",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "Planning Failed",
+                          "variant": "h2"
+                        },
+                        {
+                          "type": "alert",
+                          "variant": "error",
+                          "message": "@entity.error"
+                        },
+                        {
+                          "type": "button",
+                          "label": "Try Again",
+                          "event": "RESET",
+                          "variant": "primary",
+                          "icon": "rotate-ccw"
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "planning",
+                "to": "idle",
+                "event": "FAILED",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.error",
+                    "@payload.error"
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "error"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "icon",
+                          "name": "alert-triangle",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "Planning Failed",
+                          "variant": "h2"
+                        },
+                        {
+                          "type": "alert",
+                          "variant": "error",
+                          "message": "@entity.error"
+                        },
+                        {
+                          "type": "button",
+                          "label": "Try Again",
+                          "event": "RESET",
+                          "variant": "primary",
+                          "icon": "rotate-ccw"
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "ready",
+                "to": "idle",
+                "event": "RESET",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.status",
+                    "idle"
+                  ],
+                  [
+                    "set",
+                    "@entity.task",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.category",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.steps",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.confidence",
+                    0
+                  ],
+                  [
+                    "set",
+                    "@entity.relevantMemories",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.memoryCount",
+                    0
+                  ],
+                  [
+                    "set",
+                    "@entity.error",
+                    ""
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "children": [
+                        {
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "sm",
+                          "align": "center",
+                          "children": [
+                            {
+                              "type": "icon",
+                              "name": "map",
+                              "size": "lg"
+                            },
+                            {
+                              "type": "typography",
+                              "content": "Task Planner",
+                              "variant": "h2"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        {
+                          "type": "card",
+                          "children": [
+                            {
+                              "type": "stack",
+                              "direction": "vertical",
+                              "gap": "md",
+                              "children": [
+                                {
+                                  "type": "typography",
+                                  "content": "Describe the task to plan",
+                                  "variant": "body"
+                                },
+                                {
+                                  "type": "form-section",
+                                  "entity": "AgentPlanner",
+                                  "mode": "edit",
+                                  "submitEvent": "PLAN",
+                                  "fields": [
+                                    "task"
+                                  ]
+                                }
+                              ]
+                            }
+                          ]
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              }
+            ]
+          }
+        }
+      ],
+      "pages": [
+        {
+          "name": "AgentPlannerPage",
+          "path": "/agentplanners",
+          "traits": [
+            {
+              "ref": "AgentPlannerPlanner"
+            }
+          ]
+        }
+      ]
+    }
+  ],
+  "description": "Composes classification, memory recall, and LLM completion into a task planning pipeline. Classifies the incoming task, recalls relevant memories for context, then generates a step-by-step execution plan with confidence scoring. Traits composed (inline, representing atom-level concerns): - PlannerClassifier: categorize the task type - PlannerMemory: recall relevant past patterns and plans - PlannerCompletion: generate the step-by-step plan via LLM"
+}