@almadar/std 6.1.0 → 6.1.7

package/dist/behaviors/registry/molecules/std-agent-tool-loop.orb

@@ -0,0 +1,2507 @@
+{
+  "name": "std-agent-tool-loop",
+  "version": "1.0.0",
+  "description": "std-agent-tool-loop -- Tool execution loop",
+  "orbitals": [
+    {
+      "name": "AgentToolLoopOrbital",
+      "uses": [
+        {
+          "from": "std/behaviors/std-agent-completion",
+          "as": "AgentCompletion"
+        },
+        {
+          "from": "std/behaviors/std-agent-context-window",
+          "as": "AgentContextWindow"
+        },
+        {
+          "from": "std/behaviors/std-agent-step-progress",
+          "as": "AgentStepProgress"
+        },
+        {
+          "from": "std/behaviors/std-agent-tool-call",
+          "as": "AgentToolCall"
+        }
+      ],
+      "entity": {
+        "name": "AgentToolLoop",
+        "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": "plan",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "iterations",
+            "type": "number",
+            "default": 0
+          },
+          {
+            "name": "maxIterations",
+            "type": "number",
+            "default": 10
+          },
+          {
+            "name": "result",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "currentTool",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "lastToolResult",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "error",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "currentStep",
+            "type": "number",
+            "default": 0
+          },
+          {
+            "name": "totalSteps",
+            "type": "number",
+            "default": 4
+          },
+          {
+            "name": "steps",
+            "type": "string",
+            "default": "Plan,Execute,Check,Complete"
+          },
+          {
+            "name": "toolName",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "args",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "prompt",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "response",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "provider",
+            "type": "string",
+            "default": "anthropic"
+          },
+          {
+            "name": "model",
+            "type": "string",
+            "default": "claude-sonnet-4-20250514"
+          },
+          {
+            "name": "tokenCount",
+            "type": "number",
+            "default": 0
+          },
+          {
+            "name": "maxTokens",
+            "type": "number",
+            "default": 200000
+          },
+          {
+            "name": "usage",
+            "type": "number",
+            "default": 0
+          },
+          {
+            "name": "current",
+            "type": "number",
+            "default": 0
+          },
+          {
+            "name": "max",
+            "type": "number",
+            "default": 200000
+          },
+          {
+            "name": "threshold",
+            "type": "number",
+            "default": 0.85
+          },
+          {
+            "name": "lastCompactedAt",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "action",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "detail",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "timestamp",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "duration",
+            "type": "number",
+            "default": 0
+          }
+        ]
+      },
+      "traits": [
+        {
+          "name": "AgentToolLoopLoop",
+          "linkedEntity": "AgentToolLoop",
+          "category": "interaction",
+          "stateMachine": {
+            "states": [
+              {
+                "name": "idle",
+                "isInitial": true
+              },
+              {
+                "name": "planning"
+              },
+              {
+                "name": "executing"
+              },
+              {
+                "name": "checking"
+              },
+              {
+                "name": "completed"
+              },
+              {
+                "name": "failed"
+              }
+            ],
+            "events": [
+              {
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "key": "EXECUTE",
+                "name": "Execute"
+              },
+              {
+                "key": "PLAN_GENERATED",
+                "name": "Plan Generated",
+                "payload": [
+                  {
+                    "name": "plan",
+                    "type": "string",
+                    "required": true
+                  },
+                  {
+                    "name": "toolName",
+                    "type": "string",
+                    "required": true
+                  },
+                  {
+                    "name": "toolArgs",
+                    "type": "object",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "key": "TOOL_RESULT",
+                "name": "Tool Result",
+                "payload": [
+                  {
+                    "name": "output",
+                    "type": "string",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "key": "CHECK_PASSED",
+                "name": "Check Passed",
+                "payload": [
+                  {
+                    "name": "result",
+                    "type": "string",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "key": "CHECK_NEEDS_MORE",
+                "name": "Check Needs More",
+                "payload": [
+                  {
+                    "name": "toolName",
+                    "type": "string",
+                    "required": true
+                  },
+                  {
+                    "name": "toolArgs",
+                    "type": "object",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "key": "MAX_ITERATIONS",
+                "name": "Max Iterations Reached",
+                "payload": [
+                  {
+                    "name": "error",
+                    "type": "string",
+                    "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": "repeat",
+                              "size": "lg"
+                            },
+                            {
+                              "type": "typography",
+                              "content": "Tool Execution Loop",
+                              "variant": "h2"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        {
+                          "type": "card",
+                          "children": [
+                            {
+                              "type": "stack",
+                              "direction": "vertical",
+                              "gap": "md",
+                              "children": [
+                                {
+                                  "type": "typography",
+                                  "content": "Describe the task to execute with tools",
+                                  "variant": "body"
+                                },
+                                {
+                                  "type": "form-section",
+                                  "entity": "AgentToolLoop",
+                                  "mode": "edit",
+                                  "submitEvent": "EXECUTE",
+                                  "fields": [
+                                    "task"
+                                  ]
+                                }
+                              ]
+                            }
+                          ]
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "idle",
+                "to": "planning",
+                "event": "EXECUTE",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.status",
+                    "planning"
+                  ],
+                  [
+                    "set",
+                    "@entity.iterations",
+                    0
+                  ],
+                  [
+                    "agent/generate",
+                    [
+                      "str/concat",
+                      "Task: ",
+                      "@entity.task",
+                      "\n\nAvailable tools: ",
+                      [
+                        "str/join",
+                        [
+                          "agent/tools"
+                        ],
+                        ", "
+                      ],
+                      "\n\nGenerate a step-by-step plan. Return the first tool to call and its arguments."
+                    ]
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "icon",
+                          "name": "brain",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "Planning execution...",
+                          "variant": "h3"
+                        },
+                        {
+                          "type": "spinner",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "@entity.task",
+                          "variant": "caption"
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "planning",
+                "to": "executing",
+                "event": "PLAN_GENERATED",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.plan",
+                    "@payload.plan"
+                  ],
+                  [
+                    "set",
+                    "@entity.currentTool",
+                    "@payload.toolName"
+                  ],
+                  [
+                    "set",
+                    "@entity.iterations",
+                    [
+                      "+",
+                      "@entity.iterations",
+                      1
+                    ]
+                  ],
+                  [
+                    "agent/invoke",
+                    "@payload.toolName",
+                    "@payload.toolArgs"
+                  ],
+                  [
+                    "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": "tool",
+                                  "size": "lg"
+                                },
+                                {
+                                  "type": "typography",
+                                  "content": "Executing Tool",
+                                  "variant": "h2"
+                                }
+                              ]
+                            },
+                            {
+                              "type": "badge",
+                              "label": [
+                                "str/concat",
+                                "Iteration ",
+                                "@entity.iterations",
+                                "/",
+                                "@entity.maxIterations"
+                              ]
+                            }
+                          ]
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        {
+                          "type": "card",
+                          "children": [
+                            {
+                              "type": "stack",
+                              "direction": "vertical",
+                              "gap": "sm",
+                              "children": [
+                                {
+                                  "type": "typography",
+                                  "content": "Current Tool",
+                                  "variant": "caption"
+                                },
+                                {
+                                  "type": "typography",
+                                  "content": "@entity.currentTool",
+                                  "variant": "h4"
+                                },
+                                {
+                                  "type": "spinner",
+                                  "size": "md"
+                                }
+                              ]
+                            }
+                          ]
+                        },
+                        {
+                          "type": "card",
+                          "children": [
+                            {
+                              "type": "stack",
+                              "direction": "vertical",
+                              "gap": "sm",
+                              "children": [
+                                {
+                                  "type": "typography",
+                                  "content": "Plan",
+                                  "variant": "caption"
+                                },
+                                {
+                                  "type": "typography",
+                                  "content": "@entity.plan",
+                                  "variant": "body"
+                                }
+                              ]
+                            }
+                          ]
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "executing",
+                "to": "checking",
+                "event": "TOOL_RESULT",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.lastToolResult",
+                    "@payload.output"
+                  ],
+                  [
+                    "agent/generate",
+                    [
+                      "str/concat",
+                      "Task: ",
+                      "@entity.task",
+                      "\nPlan: ",
+                      "@entity.plan",
+                      "\nTool output: ",
+                      "@payload.output",
+                      "\n\nIs the task complete? If yes, provide the final result. If no, specify the next tool and arguments."
+                    ]
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "icon",
+                          "name": "eye",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "Checking result...",
+                          "variant": "h3"
+                        },
+                        {
+                          "type": "spinner",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "badge",
+                          "label": [
+                            "str/concat",
+                            "Iteration ",
+                            "@entity.iterations"
+                          ]
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "checking",
+                "to": "completed",
+                "event": "CHECK_PASSED",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.result",
+                    "@payload.result"
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "completed"
+                  ],
+                  [
+                    "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": "Loop Complete",
+                                  "variant": "h2"
+                                }
+                              ]
+                            },
+                            {
+                              "type": "button",
+                              "label": "New Task",
+                              "event": "RESET",
+                              "variant": "ghost",
+                              "icon": "rotate-ccw"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        {
+                          "type": "simple-grid",
+                          "cols": 2,
+                          "children": [
+                            {
+                              "type": "stat-display",
+                              "label": "Iterations",
+                              "value": "@entity.iterations",
+                              "icon": "repeat"
+                            },
+                            {
+                              "type": "stat-display",
+                              "label": "Status",
+                              "value": "@entity.status",
+                              "icon": "check"
+                            }
+                          ]
+                        },
+                        {
+                          "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": "Result",
+                                  "variant": "caption"
+                                },
+                                {
+                                  "type": "typography",
+                                  "content": "@entity.result",
+                                  "variant": "body"
+                                }
+                              ]
+                            }
+                          ]
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "checking",
+                "to": "executing",
+                "event": "CHECK_NEEDS_MORE",
+                "guards": [
+                  [
+                    "math/lt",
+                    "@entity.iterations",
+                    10
+                  ]
+                ],
+                "effects": [
+                  [
+                    "set",
+                    "@entity.currentTool",
+                    "@payload.toolName"
+                  ],
+                  [
+                    "set",
+                    "@entity.iterations",
+                    [
+                      "+",
+                      "@entity.iterations",
+                      1
+                    ]
+                  ],
+                  [
+                    "if",
+                    [
+                      ">=",
+                      [
+                        "agent/context-usage"
+                      ],
+                      0.8
+                    ],
+                    [
+                      "agent/compact",
+                      "hybrid"
+                    ],
+                    [
+                      "log",
+                      "Context below compact threshold"
+                    ]
+                  ],
+                  [
+                    "agent/invoke",
+                    "@payload.toolName",
+                    "@payload.toolArgs"
+                  ],
+                  [
+                    "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": "tool",
+                                  "size": "lg"
+                                },
+                                {
+                                  "type": "typography",
+                                  "content": "Executing Tool",
+                                  "variant": "h2"
+                                }
+                              ]
+                            },
+                            {
+                              "type": "badge",
+                              "label": [
+                                "str/concat",
+                                "Iteration ",
+                                "@entity.iterations",
+                                "/",
+                                "@entity.maxIterations"
+                              ]
+                            }
+                          ]
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        {
+                          "type": "card",
+                          "children": [
+                            {
+                              "type": "stack",
+                              "direction": "vertical",
+                              "gap": "sm",
+                              "children": [
+                                {
+                                  "type": "typography",
+                                  "content": "Current Tool",
+                                  "variant": "caption"
+                                },
+                                {
+                                  "type": "typography",
+                                  "content": "@entity.currentTool",
+                                  "variant": "h4"
+                                },
+                                {
+                                  "type": "spinner",
+                                  "size": "md"
+                                }
+                              ]
+                            }
+                          ]
+                        },
+                        {
+                          "type": "card",
+                          "children": [
+                            {
+                              "type": "stack",
+                              "direction": "vertical",
+                              "gap": "sm",
+                              "children": [
+                                {
+                                  "type": "typography",
+                                  "content": "Plan",
+                                  "variant": "caption"
+                                },
+                                {
+                                  "type": "typography",
+                                  "content": "@entity.plan",
+                                  "variant": "body"
+                                }
+                              ]
+                            }
+                          ]
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "checking",
+                "to": "failed",
+                "event": "MAX_ITERATIONS",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.error",
+                    "@payload.error"
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "failed"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "icon",
+                          "name": "x-circle",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "Loop Failed",
+                          "variant": "h2"
+                        },
+                        {
+                          "type": "alert",
+                          "variant": "error",
+                          "message": "@entity.error"
+                        },
+                        {
+                          "type": "simple-grid",
+                          "cols": 2,
+                          "children": [
+                            {
+                              "type": "stat-display",
+                              "label": "Iterations Used",
+                              "value": "@entity.iterations",
+                              "icon": "repeat"
+                            },
+                            {
+                              "type": "stat-display",
+                              "label": "Max Allowed",
+                              "value": "@entity.maxIterations",
+                              "icon": "shield"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "button",
+                          "label": "Retry",
+                          "event": "RESET",
+                          "variant": "primary",
+                          "icon": "rotate-ccw"
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "planning",
+                "to": "failed",
+                "event": "FAILED",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.error",
+                    "@payload.error"
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "failed"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "icon",
+                          "name": "x-circle",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "Loop Failed",
+                          "variant": "h2"
+                        },
+                        {
+                          "type": "alert",
+                          "variant": "error",
+                          "message": "@entity.error"
+                        },
+                        {
+                          "type": "simple-grid",
+                          "cols": 2,
+                          "children": [
+                            {
+                              "type": "stat-display",
+                              "label": "Iterations Used",
+                              "value": "@entity.iterations",
+                              "icon": "repeat"
+                            },
+                            {
+                              "type": "stat-display",
+                              "label": "Max Allowed",
+                              "value": "@entity.maxIterations",
+                              "icon": "shield"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "button",
+                          "label": "Retry",
+                          "event": "RESET",
+                          "variant": "primary",
+                          "icon": "rotate-ccw"
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "executing",
+                "to": "failed",
+                "event": "FAILED",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.error",
+                    "@payload.error"
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "failed"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "icon",
+                          "name": "x-circle",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "Loop Failed",
+                          "variant": "h2"
+                        },
+                        {
+                          "type": "alert",
+                          "variant": "error",
+                          "message": "@entity.error"
+                        },
+                        {
+                          "type": "simple-grid",
+                          "cols": 2,
+                          "children": [
+                            {
+                              "type": "stat-display",
+                              "label": "Iterations Used",
+                              "value": "@entity.iterations",
+                              "icon": "repeat"
+                            },
+                            {
+                              "type": "stat-display",
+                              "label": "Max Allowed",
+                              "value": "@entity.maxIterations",
+                              "icon": "shield"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "button",
+                          "label": "Retry",
+                          "event": "RESET",
+                          "variant": "primary",
+                          "icon": "rotate-ccw"
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "completed",
+                "to": "idle",
+                "event": "RESET",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.status",
+                    "idle"
+                  ],
+                  [
+                    "set",
+                    "@entity.task",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.plan",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.result",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.currentTool",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.lastToolResult",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.iterations",
+                    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": "repeat",
+                              "size": "lg"
+                            },
+                            {
+                              "type": "typography",
+                              "content": "Tool Execution Loop",
+                              "variant": "h2"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        {
+                          "type": "card",
+                          "children": [
+                            {
+                              "type": "stack",
+                              "direction": "vertical",
+                              "gap": "md",
+                              "children": [
+                                {
+                                  "type": "typography",
+                                  "content": "Describe the task to execute with tools",
+                                  "variant": "body"
+                                },
+                                {
+                                  "type": "form-section",
+                                  "entity": "AgentToolLoop",
+                                  "mode": "edit",
+                                  "submitEvent": "EXECUTE",
+                                  "fields": [
+                                    "task"
+                                  ]
+                                }
+                              ]
+                            }
+                          ]
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "failed",
+                "to": "idle",
+                "event": "RESET",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.status",
+                    "idle"
+                  ],
+                  [
+                    "set",
+                    "@entity.task",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.plan",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.result",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.currentTool",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.lastToolResult",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.iterations",
+                    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": "repeat",
+                              "size": "lg"
+                            },
+                            {
+                              "type": "typography",
+                              "content": "Tool Execution Loop",
+                              "variant": "h2"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        {
+                          "type": "card",
+                          "children": [
+                            {
+                              "type": "stack",
+                              "direction": "vertical",
+                              "gap": "md",
+                              "children": [
+                                {
+                                  "type": "typography",
+                                  "content": "Describe the task to execute with tools",
+                                  "variant": "body"
+                                },
+                                {
+                                  "type": "form-section",
+                                  "entity": "AgentToolLoop",
+                                  "mode": "edit",
+                                  "submitEvent": "EXECUTE",
+                                  "fields": [
+                                    "task"
+                                  ]
+                                }
+                              ]
+                            }
+                          ]
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "ref": "AgentStepProgress.traits.AgentStepProgressProgress",
+          "name": "ToolLoopStepProgress",
+          "linkedEntity": "AgentToolLoop",
+          "listens": [],
+          "emitsScope": "internal",
+          "effects": {
+            "INIT": [
+              [
+                "fetch",
+                "AgentToolLoop"
+              ],
+              [
+                "render-ui",
+                "main",
+                {
+                  "type": "stack",
+                  "direction": "vertical",
+                  "gap": "lg",
+                  "children": [
+                    {
+                      "type": "stack",
+                      "direction": "horizontal",
+                      "gap": "sm",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "icon",
+                          "name": "list-ordered",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "AgentToolLoop",
+                          "variant": "h2"
+                        },
+                        {
+                          "type": "badge",
+                          "label": "Idle",
+                          "variant": "default"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "divider"
+                    },
+                    {
+                      "type": "wizard-progress",
+                      "currentStep": "@entity.currentStep",
+                      "steps": [
+                        {
+                          "id": "0",
+                          "title": "Plan"
+                        },
+                        {
+                          "id": "1",
+                          "title": "Execute"
+                        },
+                        {
+                          "id": "2",
+                          "title": "Check"
+                        },
+                        {
+                          "id": "3",
+                          "title": "Complete"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "button",
+                      "label": "Start",
+                      "event": "START",
+                      "variant": "primary",
+                      "icon": "play"
+                    }
+                  ]
+                }
+              ]
+            ],
+            "START": [
+              [
+                "set",
+                "@entity.status",
+                "in_progress"
+              ],
+              [
+                "set",
+                "@entity.currentStep",
+                0
+              ],
+              [
+                "render-ui",
+                "main",
+                {
+                  "type": "stack",
+                  "direction": "vertical",
+                  "gap": "lg",
+                  "children": [
+                    {
+                      "type": "stack",
+                      "direction": "horizontal",
+                      "gap": "sm",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "icon",
+                          "name": "loader",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "AgentToolLoop",
+                          "variant": "h2"
+                        },
+                        {
+                          "type": "badge",
+                          "label": "In Progress",
+                          "variant": "warning"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "divider"
+                    },
+                    {
+                      "type": "wizard-progress",
+                      "currentStep": "@entity.currentStep",
+                      "steps": [
+                        {
+                          "id": "0",
+                          "title": "Plan"
+                        },
+                        {
+                          "id": "1",
+                          "title": "Execute"
+                        },
+                        {
+                          "id": "2",
+                          "title": "Check"
+                        },
+                        {
+                          "id": "3",
+                          "title": "Complete"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "stack",
+                      "direction": "horizontal",
+                      "gap": "sm",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "stat-display",
+                          "label": "Current Step",
+                          "value": "@entity.currentStep"
+                        },
+                        {
+                          "type": "stat-display",
+                          "label": "Total Steps",
+                          "value": "@entity.totalSteps"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "stack",
+                      "direction": "horizontal",
+                      "gap": "sm",
+                      "children": [
+                        {
+                          "type": "button",
+                          "label": "Advance",
+                          "event": "ADVANCE",
+                          "variant": "primary",
+                          "icon": "chevron-right"
+                        },
+                        {
+                          "type": "button",
+                          "label": "Reset",
+                          "event": "RESET",
+                          "variant": "ghost",
+                          "icon": "rotate-ccw"
+                        }
+                      ]
+                    }
+                  ]
+                }
+              ]
+            ],
+            "ADVANCE": [
+              [
+                "set",
+                "@entity.currentStep",
+                [
+                  "+",
+                  "@entity.currentStep",
+                  1
+                ]
+              ],
+              [
+                "render-ui",
+                "main",
+                {
+                  "type": "stack",
+                  "direction": "vertical",
+                  "gap": "lg",
+                  "children": [
+                    {
+                      "type": "stack",
+                      "direction": "horizontal",
+                      "gap": "sm",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "icon",
+                          "name": "loader",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "AgentToolLoop",
+                          "variant": "h2"
+                        },
+                        {
+                          "type": "badge",
+                          "label": "In Progress",
+                          "variant": "warning"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "divider"
+                    },
+                    {
+                      "type": "wizard-progress",
+                      "currentStep": "@entity.currentStep",
+                      "steps": [
+                        {
+                          "id": "0",
+                          "title": "Plan"
+                        },
+                        {
+                          "id": "1",
+                          "title": "Execute"
+                        },
+                        {
+                          "id": "2",
+                          "title": "Check"
+                        },
+                        {
+                          "id": "3",
+                          "title": "Complete"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "stack",
+                      "direction": "horizontal",
+                      "gap": "sm",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "stat-display",
+                          "label": "Current Step",
+                          "value": "@entity.currentStep"
+                        },
+                        {
+                          "type": "stat-display",
+                          "label": "Total Steps",
+                          "value": "@entity.totalSteps"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "stack",
+                      "direction": "horizontal",
+                      "gap": "sm",
+                      "children": [
+                        {
+                          "type": "button",
+                          "label": "Advance",
+                          "event": "ADVANCE",
+                          "variant": "primary",
+                          "icon": "chevron-right"
+                        },
+                        {
+                          "type": "button",
+                          "label": "Reset",
+                          "event": "RESET",
+                          "variant": "ghost",
+                          "icon": "rotate-ccw"
+                        }
+                      ]
+                    }
+                  ]
+                }
+              ]
+            ],
+            "COMPLETE": [
+              [
+                "set",
+                "@entity.status",
+                "completed"
+              ],
+              [
+                "set",
+                "@entity.currentStep",
+                "@entity.totalSteps"
+              ],
+              [
+                "render-ui",
+                "main",
+                {
+                  "type": "stack",
+                  "direction": "vertical",
+                  "gap": "lg",
+                  "children": [
+                    {
+                      "type": "stack",
+                      "direction": "horizontal",
+                      "gap": "sm",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "icon",
+                          "name": "check-circle",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "AgentToolLoop",
+                          "variant": "h2"
+                        },
+                        {
+                          "type": "badge",
+                          "label": "Completed",
+                          "variant": "success"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "divider"
+                    },
+                    {
+                      "type": "wizard-progress",
+                      "currentStep": "@entity.totalSteps",
+                      "steps": [
+                        {
+                          "id": "0",
+                          "title": "Plan"
+                        },
+                        {
+                          "id": "1",
+                          "title": "Execute"
+                        },
+                        {
+                          "id": "2",
+                          "title": "Check"
+                        },
+                        {
+                          "id": "3",
+                          "title": "Complete"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "alert",
+                      "variant": "success",
+                      "message": "All steps completed successfully."
+                    },
+                    {
+                      "type": "button",
+                      "label": "Reset",
+                      "event": "RESET",
+                      "variant": "ghost",
+                      "icon": "rotate-ccw"
+                    }
+                  ]
+                }
+              ]
+            ],
+            "FAIL": [
+              [
+                "set",
+                "@entity.status",
+                "failed"
+              ],
+              [
+                "render-ui",
+                "main",
+                {
+                  "type": "stack",
+                  "direction": "vertical",
+                  "gap": "lg",
+                  "children": [
+                    {
+                      "type": "stack",
+                      "direction": "horizontal",
+                      "gap": "sm",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "icon",
+                          "name": "x-circle",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "AgentToolLoop",
+                          "variant": "h2"
+                        },
+                        {
+                          "type": "badge",
+                          "label": "Failed",
+                          "variant": "destructive"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "divider"
+                    },
+                    {
+                      "type": "wizard-progress",
+                      "currentStep": "@entity.currentStep",
+                      "steps": [
+                        {
+                          "id": "0",
+                          "title": "Plan"
+                        },
+                        {
+                          "id": "1",
+                          "title": "Execute"
+                        },
+                        {
+                          "id": "2",
+                          "title": "Check"
+                        },
+                        {
+                          "id": "3",
+                          "title": "Complete"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "alert",
+                      "variant": "error",
+                      "message": "Pipeline failed at the current step."
+                    },
+                    {
+                      "type": "stack",
+                      "direction": "horizontal",
+                      "gap": "sm",
+                      "children": [
+                        {
+                          "type": "stat-display",
+                          "label": "Failed At Step",
+                          "value": "@entity.currentStep"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "button",
+                      "label": "Reset",
+                      "event": "RESET",
+                      "variant": "ghost",
+                      "icon": "rotate-ccw"
+                    }
+                  ]
+                }
+              ]
+            ],
+            "RESET": [
+              [
+                "set",
+                "@entity.status",
+                "idle"
+              ],
+              [
+                "set",
+                "@entity.currentStep",
+                0
+              ],
+              [
+                "render-ui",
+                "main",
+                {
+                  "type": "stack",
+                  "direction": "vertical",
+                  "gap": "lg",
+                  "children": [
+                    {
+                      "type": "stack",
+                      "direction": "horizontal",
+                      "gap": "sm",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "icon",
+                          "name": "list-ordered",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "AgentToolLoop",
+                          "variant": "h2"
+                        },
+                        {
+                          "type": "badge",
+                          "label": "Idle",
+                          "variant": "default"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "divider"
+                    },
+                    {
+                      "type": "wizard-progress",
+                      "currentStep": "@entity.currentStep",
+                      "steps": [
+                        {
+                          "id": "0",
+                          "title": "Plan"
+                        },
+                        {
+                          "id": "1",
+                          "title": "Execute"
+                        },
+                        {
+                          "id": "2",
+                          "title": "Check"
+                        },
+                        {
+                          "id": "3",
+                          "title": "Complete"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "button",
+                      "label": "Start",
+                      "event": "START",
+                      "variant": "primary",
+                      "icon": "play"
+                    }
+                  ]
+                }
+              ]
+            ]
+          }
+        },
+        {
+          "ref": "AgentCompletion.traits.AgentCompletionModal",
+          "name": "ToolLoopCompletionFlow",
+          "linkedEntity": "AgentToolLoop",
+          "listens": [],
+          "emitsScope": "internal",
+          "effects": {
+            "INIT": [
+              [
+                "ref",
+                "AgentToolLoop"
+              ],
+              [
+                "render-ui",
+                "main",
+                {
+                  "type": "stack",
+                  "direction": "vertical",
+                  "gap": "lg",
+                  "children": [
+                    {
+                      "type": "stack",
+                      "direction": "horizontal",
+                      "gap": "md",
+                      "justify": "space-between",
+                      "children": [
+                        {
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "md",
+                          "children": [
+                            {
+                              "type": "icon",
+                              "name": "sparkles",
+                              "size": "lg"
+                            },
+                            {
+                              "type": "typography",
+                              "content": "AgentToolLoop",
+                              "variant": "h2"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "button",
+                          "label": "Open",
+                          "event": "GENERATE",
+                          "variant": "primary",
+                          "icon": "sparkles"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "divider"
+                    },
+                    {
+                      "type": "empty-state",
+                      "icon": "sparkles",
+                      "title": "Nothing open",
+                      "description": "Click Open to view details in a modal overlay."
+                    }
+                  ]
+                }
+              ]
+            ],
+            "GENERATE": [
+              [
+                "render-ui",
+                "modal",
+                {
+                  "type": "stack",
+                  "direction": "vertical",
+                  "gap": "md",
+                  "children": [
+                    {
+                      "type": "stack",
+                      "direction": "horizontal",
+                      "gap": "sm",
+                      "children": [
+                        {
+                          "type": "icon",
+                          "name": "sparkles",
+                          "size": "md"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "AgentToolLoop",
+                          "variant": "h3"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "divider"
+                    },
+                    {
+                      "type": "stack",
+                      "direction": "horizontal",
+                      "gap": "sm",
+                      "children": [
+                        {
+                          "type": "badge",
+                          "label": "@entity.provider"
+                        },
+                        {
+                          "type": "badge",
+                          "label": "@entity.model"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "form-section",
+                      "entity": "AgentToolLoop",
+                      "mode": "create",
+                      "submitEvent": "SAVE",
+                      "cancelEvent": "CLOSE",
+                      "fields": [
+                        "prompt"
+                      ]
+                    }
+                  ]
+                }
+              ]
+            ],
+            "CLOSE": [
+              [
+                "render-ui",
+                "modal",
+                null
+              ],
+              [
+                "notify",
+                "Cancelled",
+                "info"
+              ],
+              [
+                "ref",
+                "AgentToolLoop"
+              ],
+              [
+                "render-ui",
+                "main",
+                {
+                  "type": "stack",
+                  "direction": "vertical",
+                  "gap": "lg",
+                  "children": [
+                    {
+                      "type": "stack",
+                      "direction": "horizontal",
+                      "gap": "md",
+                      "justify": "space-between",
+                      "children": [
+                        {
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "md",
+                          "children": [
+                            {
+                              "type": "icon",
+                              "name": "sparkles",
+                              "size": "lg"
+                            },
+                            {
+                              "type": "typography",
+                              "content": "AgentToolLoop",
+                              "variant": "h2"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "button",
+                          "label": "Open",
+                          "event": "GENERATE",
+                          "variant": "primary",
+                          "icon": "sparkles"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "divider"
+                    },
+                    {
+                      "type": "empty-state",
+                      "icon": "sparkles",
+                      "title": "Nothing open",
+                      "description": "Click Open to view details in a modal overlay."
+                    }
+                  ]
+                }
+              ]
+            ],
+            "SAVE": [
+              [
+                "persist",
+                "create",
+                "AgentToolLoop",
+                "@payload.data"
+              ],
+              [
+                "render-ui",
+                "modal",
+                null
+              ],
+              [
+                "emit",
+                "GENERATED"
+              ],
+              [
+                "ref",
+                "AgentToolLoop"
+              ],
+              [
+                "render-ui",
+                "main",
+                {
+                  "type": "stack",
+                  "direction": "vertical",
+                  "gap": "lg",
+                  "children": [
+                    {
+                      "type": "stack",
+                      "direction": "horizontal",
+                      "gap": "md",
+                      "justify": "space-between",
+                      "children": [
+                        {
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "md",
+                          "children": [
+                            {
+                              "type": "icon",
+                              "name": "sparkles",
+                              "size": "lg"
+                            },
+                            {
+                              "type": "typography",
+                              "content": "AgentToolLoop",
+                              "variant": "h2"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "button",
+                          "label": "Open",
+                          "event": "GENERATE",
+                          "variant": "primary",
+                          "icon": "sparkles"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "divider"
+                    },
+                    {
+                      "type": "empty-state",
+                      "icon": "sparkles",
+                      "title": "Nothing open",
+                      "description": "Click Open to view details in a modal overlay."
+                    }
+                  ]
+                }
+              ]
+            ]
+          }
+        },
+        {
+          "ref": "AgentToolCall.traits.AgentToolCallModal",
+          "name": "ToolLoopToolCallFlow",
+          "linkedEntity": "AgentToolLoop",
+          "listens": [],
+          "emitsScope": "internal",
+          "effects": {
+            "INIT": [
+              [
+                "ref",
+                "AgentToolLoop"
+              ],
+              [
+                "render-ui",
+                "main",
+                {
+                  "type": "stack",
+                  "direction": "vertical",
+                  "gap": "lg",
+                  "children": [
+                    {
+                      "type": "stack",
+                      "direction": "horizontal",
+                      "gap": "md",
+                      "justify": "space-between",
+                      "children": [
+                        {
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "md",
+                          "children": [
+                            {
+                              "type": "icon",
+                              "name": "wrench",
+                              "size": "lg"
+                            },
+                            {
+                              "type": "typography",
+                              "content": "Invoke Tool",
+                              "variant": "h2"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "button",
+                          "label": "Open",
+                          "event": "INVOKE",
+                          "variant": "primary",
+                          "icon": "wrench"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "divider"
+                    },
+                    {
+                      "type": "empty-state",
+                      "icon": "wrench",
+                      "title": "Nothing open",
+                      "description": "Click Open to view details in a modal overlay."
+                    }
+                  ]
+                }
+              ]
+            ],
+            "INVOKE": [
+              [
+                "render-ui",
+                "modal",
+                {
+                  "type": "stack",
+                  "direction": "vertical",
+                  "gap": "md",
+                  "children": [
+                    {
+                      "type": "stack",
+                      "direction": "horizontal",
+                      "gap": "sm",
+                      "children": [
+                        {
+                          "type": "icon",
+                          "name": "wrench",
+                          "size": "md"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "Invoke Tool",
+                          "variant": "h3"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "divider"
+                    },
+                    {
+                      "type": "form-section",
+                      "entity": "AgentToolLoop",
+                      "mode": "create",
+                      "submitEvent": "SAVE",
+                      "cancelEvent": "CLOSE",
+                      "fields": [
+                        "toolName",
+                        "args"
+                      ]
+                    }
+                  ]
+                }
+              ]
+            ],
+            "CLOSE": [
+              [
+                "render-ui",
+                "modal",
+                null
+              ],
+              [
+                "notify",
+                "Cancelled",
+                "info"
+              ],
+              [
+                "ref",
+                "AgentToolLoop"
+              ],
+              [
+                "render-ui",
+                "main",
+                {
+                  "type": "stack",
+                  "direction": "vertical",
+                  "gap": "lg",
+                  "children": [
+                    {
+                      "type": "stack",
+                      "direction": "horizontal",
+                      "gap": "md",
+                      "justify": "space-between",
+                      "children": [
+                        {
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "md",
+                          "children": [
+                            {
+                              "type": "icon",
+                              "name": "wrench",
+                              "size": "lg"
+                            },
+                            {
+                              "type": "typography",
+                              "content": "Invoke Tool",
+                              "variant": "h2"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "button",
+                          "label": "Open",
+                          "event": "INVOKE",
+                          "variant": "primary",
+                          "icon": "wrench"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "divider"
+                    },
+                    {
+                      "type": "empty-state",
+                      "icon": "wrench",
+                      "title": "Nothing open",
+                      "description": "Click Open to view details in a modal overlay."
+                    }
+                  ]
+                }
+              ]
+            ],
+            "SAVE": [
+              [
+                "persist",
+                "create",
+                "AgentToolLoop",
+                "@payload.data"
+              ],
+              [
+                "render-ui",
+                "modal",
+                null
+              ],
+              [
+                "emit",
+                "INVOKED"
+              ],
+              [
+                "ref",
+                "AgentToolLoop"
+              ],
+              [
+                "render-ui",
+                "main",
+                {
+                  "type": "stack",
+                  "direction": "vertical",
+                  "gap": "lg",
+                  "children": [
+                    {
+                      "type": "stack",
+                      "direction": "horizontal",
+                      "gap": "md",
+                      "justify": "space-between",
+                      "children": [
+                        {
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "md",
+                          "children": [
+                            {
+                              "type": "icon",
+                              "name": "wrench",
+                              "size": "lg"
+                            },
+                            {
+                              "type": "typography",
+                              "content": "Invoke Tool",
+                              "variant": "h2"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "button",
+                          "label": "Open",
+                          "event": "INVOKE",
+                          "variant": "primary",
+                          "icon": "wrench"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "divider"
+                    },
+                    {
+                      "type": "empty-state",
+                      "icon": "wrench",
+                      "title": "Nothing open",
+                      "description": "Click Open to view details in a modal overlay."
+                    }
+                  ]
+                }
+              ]
+            ]
+          }
+        },
+        {
+          "ref": "AgentContextWindow.traits.AgentContextWindowGauge",
+          "name": "ToolLoopContextMonitor",
+          "linkedEntity": "AgentToolLoop",
+          "listens": [],
+          "emitsScope": "internal",
+          "effects": {
+            "INIT": [
+              [
+                "fetch",
+                "AgentToolLoop"
+              ],
+              [
+                "render-ui",
+                "main",
+                {
+                  "type": "stack",
+                  "direction": "vertical",
+                  "gap": "lg",
+                  "children": [
+                    {
+                      "type": "stack",
+                      "direction": "horizontal",
+                      "gap": "sm",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "icon",
+                          "name": "gauge",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "Token Usage",
+                          "variant": "h2"
+                        },
+                        {
+                          "type": "badge",
+                          "label": "Normal",
+                          "variant": "default"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "divider"
+                    },
+                    {
+                      "type": "progress-bar",
+                      "value": "@entity.current",
+                      "max": "@entity.max"
+                    },
+                    {
+                      "type": "stack",
+                      "direction": "horizontal",
+                      "gap": "md",
+                      "children": [
+                        {
+                          "type": "stat-display",
+                          "label": "Tokens Used",
+                          "value": "@entity.current"
+                        },
+                        {
+                          "type": "stat-display",
+                          "label": "Max Tokens",
+                          "value": "@entity.max"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "button",
+                      "label": "Reset",
+                      "event": "RESET",
+                      "variant": "ghost",
+                      "icon": "rotate-ccw"
+                    }
+                  ]
+                }
+              ]
+            ]
+          }
+        }
+      ],
+      "pages": [
+        {
+          "name": "AgentToolLoopPage",
+          "path": "/agenttoolloops",
+          "traits": [
+            {
+              "ref": "AgentToolLoopLoop"
+            },
+            {
+              "ref": "ToolLoopStepProgress"
+            },
+            {
+              "ref": "ToolLoopCompletionFlow"
+            },
+            {
+              "ref": "ToolLoopToolCallFlow"
+            },
+            {
+              "ref": "ToolLoopContextMonitor"
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}