@almadar/std 16.237.0 → 16.238.0

package/behaviors/registry/agent/atoms/std-agent-tool-loop.orb

@@ -1,121 +1,67 @@
 {
-  "description": "Agent tool-loop molecule — call-tools, check response, emit result for iteration.",
+  "description": "std-agent-tool-loop — answers a conversation by operating the running app as the caller, through `call-service llm call-tools`. The `tools` allowlist names declared external inputs (addressed like a listens source: `Trait.EVENT`, `Orbital.Trait.EVENT`) and entities to read; each input fires as the signed-in user through the ordinary dispatch (guards and entity policies apply) and each read returns only the rows the caller may read. Headless: the conversation UI (std-agent-session) shows the reply; a failure shows as a toast. CONVERSE carries the conversation (and optionally what std-agent-memory recalled); REPLIED carries the reply, every tool step and the token usage; REPLY_FAILED carries the error. Compose with std-agent-session (the conversation) and std-agent-trace (the step record).",
   "ledger": {
     "entries": {
-      "ent_01M055GH3FGEA9J9DR8P9MCDGY": {
-        "bakedName": "ToolLoop",
-        "curName": "ToolLoop",
-        "id": "ent_01M055GH3FGEA9J9DR8P9MCDGY",
+      "ent_01M3TYMQFVS7RJC2HPKXYEF2VR": {
+        "bakedName": "AgentTurn",
+        "curName": "AgentTurn",
+        "id": "ent_01M3TYMQFVS7RJC2HPKXYEF2VR",
         "kind": "entity",
         "owner": "workspace",
         "renames": []
       },
-      "evt_01M055GH3FD4VY016QE79Y6A88": {
-        "bakedName": "LOOP_STEP",
-        "curName": "LOOP_STEP",
-        "id": "evt_01M055GH3FD4VY016QE79Y6A88",
+      "evt_01M3TYMQFV2QMJB3DDDPEZGXMD": {
+        "bakedName": "REPLIED",
+        "curName": "REPLIED",
+        "id": "evt_01M3TYMQFV2QMJB3DDDPEZGXMD",
         "kind": "event",
         "owner": "workspace",
-        "parent": "trt_01M055GH3FV9BGM02WMCQWK5ZD",
+        "parent": "trt_01M3TYMQFVRCVPTPEX7MQ97HQP",
         "renames": []
       },
-      "evt_01M055GH3FDECZ0ZVAY7TK7S54": {
-        "bakedName": "CONTINUE",
-        "curName": "CONTINUE",
-        "id": "evt_01M055GH3FDECZ0ZVAY7TK7S54",
+      "evt_01M3TYMQFVAN072R0C2Z5X5NPQ": {
+        "bakedName": "CONVERSE",
+        "curName": "CONVERSE",
+        "id": "evt_01M3TYMQFVAN072R0C2Z5X5NPQ",
         "kind": "event",
         "owner": "workspace",
-        "parent": "trt_01M055GH3FC9N1R6XWF3W7JHTV",
+        "parent": "trt_01M3TYMQFVRCVPTPEX7MQ97HQP",
         "renames": []
       },
-      "evt_01M055GH3FFMG0YJZMKXVFTSG1": {
-        "bakedName": "EXECUTE",
-        "curName": "EXECUTE",
-        "id": "evt_01M055GH3FFMG0YJZMKXVFTSG1",
+      "evt_01M3TYMQFVB6QA7HQ3KR6GGHHX": {
+        "bakedName": "ASK_FAILED",
+        "curName": "ASK_FAILED",
+        "id": "evt_01M3TYMQFVB6QA7HQ3KR6GGHHX",
         "kind": "event",
         "owner": "workspace",
-        "parent": "trt_01M055GH3FC9N1R6XWF3W7JHTV",
+        "parent": "trt_01M3TYMQFVRCVPTPEX7MQ97HQP",
         "renames": []
       },
-      "evt_01M055GH3FGE25ARQM0FVGKD69": {
-        "bakedName": "TOOLS_FAILED_1",
-        "curName": "TOOLS_FAILED_1",
-        "id": "evt_01M055GH3FGE25ARQM0FVGKD69",
+      "evt_01M3TYMQFVCJWHGK649HS8W7NA": {
+        "bakedName": "ANSWERED",
+        "curName": "ANSWERED",
+        "id": "evt_01M3TYMQFVCJWHGK649HS8W7NA",
         "kind": "event",
         "owner": "workspace",
-        "parent": "trt_01M055GH3FC9N1R6XWF3W7JHTV",
+        "parent": "trt_01M3TYMQFVRCVPTPEX7MQ97HQP",
         "renames": []
       },
-      "evt_01M055GH3FGS4RG4JA39C5EZ7C": {
-        "bakedName": "INIT",
-        "curName": "INIT",
-        "id": "evt_01M055GH3FGS4RG4JA39C5EZ7C",
-        "kind": "event",
-        "owner": "workspace",
-        "parent": "trt_01M055GH3FC9N1R6XWF3W7JHTV",
-        "renames": []
-      },
-      "evt_01M055GH3FHSNVWJJ354FYM8VB": {
-        "bakedName": "RESET",
-        "curName": "RESET",
-        "id": "evt_01M055GH3FHSNVWJJ354FYM8VB",
+      "evt_01M3TYMQFVSHRQ13G34DK0MC45": {
+        "bakedName": "REPLY_FAILED",
+        "curName": "REPLY_FAILED",
+        "id": "evt_01M3TYMQFVSHRQ13G34DK0MC45",
         "kind": "event",
         "owner": "workspace",
-        "parent": "trt_01M055GH3FV9BGM02WMCQWK5ZD",
+        "parent": "trt_01M3TYMQFVRCVPTPEX7MQ97HQP",
         "renames": []
       },
-      "evt_01M055GH3FKVEW82F74ZH77H58": {
+      "evt_01M3TYMQFVZA5GN37VNWYNEAZ3": {
         "bakedName": "INIT",
         "curName": "INIT",
-        "id": "evt_01M055GH3FKVEW82F74ZH77H58",
-        "kind": "event",
-        "owner": "workspace",
-        "parent": "trt_01M055GH3FV9BGM02WMCQWK5ZD",
-        "renames": []
-      },
-      "evt_01M055GH3FPRKJHHVCM1CCYEBK": {
-        "bakedName": "TOOLS_CALLED_2",
-        "curName": "TOOLS_CALLED_2",
-        "id": "evt_01M055GH3FPRKJHHVCM1CCYEBK",
-        "kind": "event",
-        "owner": "workspace",
-        "parent": "trt_01M055GH3FC9N1R6XWF3W7JHTV",
-        "renames": []
-      },
-      "evt_01M055GH3FQ1H1GN1SK2HZSD68": {
-        "bakedName": "RESET",
-        "curName": "RESET",
-        "id": "evt_01M055GH3FQ1H1GN1SK2HZSD68",
+        "id": "evt_01M3TYMQFVZA5GN37VNWYNEAZ3",
         "kind": "event",
         "owner": "workspace",
-        "parent": "trt_01M055GH3FC9N1R6XWF3W7JHTV",
-        "renames": []
-      },
-      "evt_01M055GH3FTKZT49GCR0057ZRX": {
-        "bakedName": "TOOLS_CALLED_1",
-        "curName": "TOOLS_CALLED_1",
-        "id": "evt_01M055GH3FTKZT49GCR0057ZRX",
-        "kind": "event",
-        "owner": "workspace",
-        "parent": "trt_01M055GH3FC9N1R6XWF3W7JHTV",
-        "renames": []
-      },
-      "evt_01M055GH3FVHPAJ5FM8M3KV7GJ": {
-        "bakedName": "TOOLS_FAILED_2",
-        "curName": "TOOLS_FAILED_2",
-        "id": "evt_01M055GH3FVHPAJ5FM8M3KV7GJ",
-        "kind": "event",
-        "owner": "workspace",
-        "parent": "trt_01M055GH3FC9N1R6XWF3W7JHTV",
-        "renames": []
-      },
-      "evt_01M055GH3FX0CKY2DD3716VYCD": {
-        "bakedName": "LOOP_STEP",
-        "curName": "LOOP_STEP",
-        "id": "evt_01M055GH3FX0CKY2DD3716VYCD",
-        "kind": "event",
-        "owner": "workspace",
-        "parent": "trt_01M055GH3FC9N1R6XWF3W7JHTV",
+        "parent": "trt_01M3TYMQFVRCVPTPEX7MQ97HQP",
         "renames": []
       },
       "orb_01M055GH3FETNDFWVCTDYA1Z10": {
@@ -134,18 +80,10 @@
         "owner": "workspace",
         "renames": []
       },
-      "trt_01M055GH3FC9N1R6XWF3W7JHTV": {
-        "bakedName": "ToolLoopExecution",
-        "curName": "ToolLoopExecution",
-        "id": "trt_01M055GH3FC9N1R6XWF3W7JHTV",
-        "kind": "trait",
-        "owner": "workspace",
-        "renames": []
-      },
-      "trt_01M055GH3FV9BGM02WMCQWK5ZD": {
-        "bakedName": "ToolLoopListener",
-        "curName": "ToolLoopListener",
-        "id": "trt_01M055GH3FV9BGM02WMCQWK5ZD",
+      "trt_01M3TYMQFVRCVPTPEX7MQ97HQP": {
+        "bakedName": "AgentToolLoop",
+        "curName": "AgentToolLoop",
+        "id": "trt_01M3TYMQFVRCVPTPEX7MQ97HQP",
         "kind": "trait",
         "owner": "workspace",
         "renames": []
@@ -159,130 +97,37 @@
       "entity": {
         "fields": [
           {
-            "default": [],
-            "items": {
-              "properties": {
-                "content": {
-                  "name": "content",
-                  "required": true,
-                  "type": "string"
-                },
-                "role": {
-                  "name": "role",
-                  "required": true,
-                  "type": "string"
-                },
-                "toolCallId": {
-                  "name": "toolCallId",
-                  "required": false,
-                  "type": "string"
-                },
-                "toolCalls": {
-                  "items": {
-                    "properties": {
-                      "function": {
-                        "name": "function",
-                        "properties": {
-                          "arguments": {
-                            "name": "arguments",
-                            "required": true,
-                            "type": "string"
-                          },
-                          "name": {
-                            "name": "name",
-                            "required": true,
-                            "type": "string"
-                          }
-                        },
-                        "required": false,
-                        "type": "object"
-                      },
-                      "id": {
-                        "name": "id",
-                        "required": true,
-                        "type": "string"
-                      },
-                      "type": {
-                        "name": "type",
-                        "required": false,
-                        "type": "string",
-                        "values": [
-                          "function"
-                        ]
-                      }
-                    },
-                    "type": "object"
-                  },
-                  "name": "toolCalls",
-                  "required": false,
-                  "type": "array"
-                }
-              },
-              "type": "object"
-            },
-            "name": "messages",
-            "type": "array"
-          },
-          {
-            "default": [],
-            "items": {
-              "properties": {
-                "description": {
-                  "name": "description",
-                  "required": true,
-                  "type": "string"
-                },
-                "name": {
-                  "name": "name",
-                  "required": true,
-                  "type": "string"
-                },
-                "schema": {
-                  "name": "schema",
-                  "properties": {
-                    "description": {
-                      "name": "description",
-                      "required": false,
-                      "type": "string"
-                    },
-                    "type": {
-                      "name": "type",
-                      "required": false,
-                      "type": "string"
-                    }
-                  },
-                  "required": false,
-                  "type": "object"
-                }
-              },
-              "type": "object"
-            },
-            "name": "tools",
-            "type": "array"
-          },
-          {
-            "default": "",
-            "name": "response",
+            "name": "id",
+            "required": true,
             "type": "string"
           },
-          {
-            "default": 0.0,
-            "name": "iterations",
-            "type": "number"
-          },
           {
             "default": "idle",
+            "description": "Where the current turn is.",
             "name": "status",
             "type": "string",
             "values": [
               "idle",
-              "calling",
-              "done"
+              "thinking",
+              "answered",
+              "failed"
             ]
+          },
+          {
+            "default": "",
+            "description": "The last reply.",
+            "name": "reply",
+            "type": "string"
+          },
+          {
+            "default": "",
+            "description": "Why the last turn failed.",
+            "name": "error",
+            "type": "string"
           }
         ],
-        "id": "ent_01M055GH3FGEA9J9DR8P9MCDGY",
-        "name": "ToolLoop",
+        "id": "ent_01M3TYMQFVS7RJC2HPKXYEF2VR",
+        "name": "AgentTurn",
         "persistence": "runtime"
       },
       "id": "orb_01M055GH3FETNDFWVCTDYA1Z10",
@@ -294,154 +139,338 @@
           "path": "/agent-tool-loop",
           "traits": [
             {
-              "ref": "ToolLoopExecution",
-              "refId": "trt_01M055GH3FC9N1R6XWF3W7JHTV"
-            },
-            {
-              "ref": "ToolLoopListener",
-              "refId": "trt_01M055GH3FV9BGM02WMCQWK5ZD"
+              "ref": "AgentToolLoop",
+              "refId": "trt_01M3TYMQFVRCVPTPEX7MQ97HQP"
             }
           ]
         }
       ],
       "traits": [
         {
-          "category": "lifecycle",
+          "category": "interaction",
+          "config": {
+            "instructions": {
+              "default": "You operate this app for the signed-in user. Use the tools to act and to look things up; when a tool reports that something was refused or denied, say so plainly.",
+              "description": "Standing instructions sent with every conversation.",
+              "label": "How should the assistant behave?",
+              "synonyms": "system prompt, persona, guidance",
+              "tier": "domain",
+              "type": "string"
+            },
+            "maxSteps": {
+              "default": 8.0,
+              "description": "How many model calls one request may take before it fails.",
+              "label": "Model round-trips per request",
+              "tier": "policy",
+              "type": "number"
+            },
+            "tools": {
+              "default": [],
+              "description": "The declared inputs it may fire (`{ event: Trait.EVENT }`) and the entities it may read (`{ read: Entity }`), as the signed-in user.",
+              "items": {
+                "properties": {
+                  "event": {
+                    "name": "event",
+                    "required": false,
+                    "type": "event"
+                  },
+                  "read": {
+                    "name": "read",
+                    "required": false,
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "What may the assistant do?",
+              "synonyms": "allowlist, abilities, actions, permissions",
+              "tier": "domain",
+              "type": "[AgentTool]"
+            }
+          },
           "effectRow": [
             {
-              "kind": "emit",
-              "resource": "LOOP_STEP"
+              "kind": "call-service",
+              "resource": "llm.call-tools"
             },
             {
-              "kind": "llm/call-tools"
+              "kind": "emit",
+              "resource": "REPLIED"
             },
             {
-              "kind": "set",
-              "resource": "@entity.iterations"
+              "kind": "emit",
+              "resource": "REPLY_FAILED"
             },
             {
-              "kind": "set",
-              "resource": "@entity.messages"
+              "kind": "render-ui",
+              "resource": "toast"
             },
             {
               "kind": "set",
-              "resource": "@entity.response"
+              "resource": "@entity.error"
             },
             {
               "kind": "set",
-              "resource": "@entity.status"
+              "resource": "@entity.reply"
             },
             {
               "kind": "set",
-              "resource": "@entity.tools"
+              "resource": "@entity.status"
             }
           ],
           "emits": [
             {
-              "event": "LOOP_STEP",
-              "eventId": "evt_01M055GH3FX0CKY2DD3716VYCD",
+              "description": "The assistant answered; carries every tool step it took and the tokens it used.",
+              "event": "REPLIED",
+              "eventId": "evt_01M3TYMQFV2QMJB3DDDPEZGXMD",
               "payloadSchema": [
                 {
-                  "name": "response",
+                  "name": "reply",
                   "required": true,
                   "type": "string"
                 },
                 {
-                  "name": "iteration",
+                  "entity": "AgentStep",
+                  "name": "steps",
+                  "properties": [
+                    {
+                      "name": "kind",
+                      "type": "string"
+                    },
+                    {
+                      "name": "target",
+                      "required": true,
+                      "type": "string"
+                    },
+                    {
+                      "name": "args",
+                      "required": true,
+                      "type": "string"
+                    },
+                    {
+                      "name": "ok",
+                      "required": true,
+                      "type": "boolean"
+                    },
+                    {
+                      "name": "detail",
+                      "type": "string"
+                    }
+                  ],
                   "required": true,
-                  "type": "number"
+                  "type": "[object]"
+                },
+                {
+                  "name": "usage",
+                  "properties": [
+                    {
+                      "name": "promptTokens",
+                      "required": true,
+                      "type": "number"
+                    },
+                    {
+                      "name": "completionTokens",
+                      "required": true,
+                      "type": "number"
+                    },
+                    {
+                      "name": "totalTokens",
+                      "required": true,
+                      "type": "number"
+                    },
+                    {
+                      "name": "modelCalls",
+                      "required": true,
+                      "type": "number"
+                    }
+                  ],
+                  "required": true,
+                  "type": "object"
+                }
+              ],
+              "scope": "external",
+              "synonyms": "answered, responded, done",
+              "tier": "domain"
+            },
+            {
+              "description": "The assistant could not answer (model unavailable, or out of steps).",
+              "event": "REPLY_FAILED",
+              "eventId": "evt_01M3TYMQFVSHRQ13G34DK0MC45",
+              "payloadSchema": [
+                {
+                  "name": "error",
+                  "required": true,
+                  "type": "string"
                 }
-              ]
+              ],
+              "scope": "external",
+              "synonyms": "failed, error, gave up",
+              "tier": "domain"
             },
             {
-              "event": "TOOLS_CALLED_1",
-              "eventId": "evt_01M055GH3FTKZT49GCR0057ZRX",
+              "event": "ANSWERED",
+              "eventId": "evt_01M3TYMQFVCJWHGK649HS8W7NA",
               "payloadSchema": [
                 {
-                  "name": "result",
+                  "name": "reply",
                   "required": true,
                   "type": "string"
+                },
+                {
+                  "entity": "AgentStep",
+                  "name": "steps",
+                  "properties": [
+                    {
+                      "name": "kind",
+                      "type": "string"
+                    },
+                    {
+                      "name": "target",
+                      "required": true,
+                      "type": "string"
+                    },
+                    {
+                      "name": "args",
+                      "required": true,
+                      "type": "string"
+                    },
+                    {
+                      "name": "ok",
+                      "required": true,
+                      "type": "boolean"
+                    },
+                    {
+                      "name": "detail",
+                      "type": "string"
+                    }
+                  ],
+                  "required": true,
+                  "type": "[object]"
+                },
+                {
+                  "name": "usage",
+                  "properties": [
+                    {
+                      "name": "promptTokens",
+                      "required": true,
+                      "type": "number"
+                    },
+                    {
+                      "name": "completionTokens",
+                      "required": true,
+                      "type": "number"
+                    },
+                    {
+                      "name": "totalTokens",
+                      "required": true,
+                      "type": "number"
+                    },
+                    {
+                      "name": "modelCalls",
+                      "required": true,
+                      "type": "number"
+                    }
+                  ],
+                  "required": true,
+                  "type": "object"
                 }
-              ]
+              ],
+              "scope": "internal",
+              "tier": "internal"
             },
             {
-              "event": "TOOLS_CALLED_2",
-              "eventId": "evt_01M055GH3FPRKJHHVCM1CCYEBK",
+              "event": "ASK_FAILED",
+              "eventId": "evt_01M3TYMQFVB6QA7HQ3KR6GGHHX",
               "payloadSchema": [
                 {
-                  "name": "result",
+                  "name": "error",
                   "required": true,
                   "type": "string"
                 }
-              ]
+              ],
+              "scope": "internal",
+              "tier": "internal"
             }
           ],
           "entityRefIds": {
-            "ToolLoop": "ent_01M055GH3FGEA9J9DR8P9MCDGY"
+            "AgentTurn": "ent_01M3TYMQFVS7RJC2HPKXYEF2VR"
           },
-          "id": "trt_01M055GH3FC9N1R6XWF3W7JHTV",
-          "linkedEntity": "ToolLoop",
-          "linkedEntityId": "ent_01M055GH3FGEA9J9DR8P9MCDGY",
-          "name": "ToolLoopExecution",
+          "id": "trt_01M3TYMQFVRCVPTPEX7MQ97HQP",
+          "linkedEntity": "AgentTurn",
+          "linkedEntityId": "ent_01M3TYMQFVS7RJC2HPKXYEF2VR",
+          "name": "AgentToolLoop",
           "scope": "instance",
           "stateMachine": {
             "events": [
               {
-                "id": "evt_01M055GH3FGS4RG4JA39C5EZ7C",
+                "id": "evt_01M3TYMQFVZA5GN37VNWYNEAZ3",
                 "key": "INIT",
                 "name": "Initialize"
               },
               {
-                "id": "evt_01M055GH3FFMG0YJZMKXVFTSG1",
-                "key": "EXECUTE",
-                "name": "Execute",
+                "description": "Answer this conversation; the last turn is the request. `context` is what the assistant remembers that may be relevant.",
+                "id": "evt_01M3TYMQFVAN072R0C2Z5X5NPQ",
+                "key": "CONVERSE",
+                "name": "Converse",
                 "payloadSchema": [
                   {
                     "name": "messages",
                     "properties": [
                       {
                         "name": "role",
-                        "required": true,
                         "type": "string"
                       },
                       {
                         "name": "content",
                         "required": true,
                         "type": "string"
+                      }
+                    ],
+                    "required": true,
+                    "type": "[object]"
+                  },
+                  {
+                    "name": "context",
+                    "type": "string"
+                  }
+                ],
+                "synonyms": "ask, chat, request"
+              },
+              {
+                "id": "evt_01M3TYMQFVCJWHGK649HS8W7NA",
+                "key": "ANSWERED",
+                "name": "Answered",
+                "payloadSchema": [
+                  {
+                    "name": "reply",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "entity": "AgentStep",
+                    "name": "steps",
+                    "properties": [
+                      {
+                        "name": "kind",
+                        "type": "string"
+                      },
+                      {
+                        "name": "target",
+                        "required": true,
+                        "type": "string"
                       },
                       {
-                        "name": "toolCalls",
-                        "properties": [
-                          {
-                            "name": "id",
-                            "required": true,
-                            "type": "string"
-                          },
-                          {
-                            "name": "type",
-                            "type": "string"
-                          },
-                          {
-                            "name": "function",
-                            "properties": [
-                              {
-                                "name": "name",
-                                "required": true,
-                                "type": "string"
-                              },
-                              {
-                                "name": "arguments",
-                                "required": true,
-                                "type": "string"
-                              }
-                            ],
-                            "type": "object"
-                          }
-                        ],
-                        "type": "[object]"
+                        "name": "args",
+                        "required": true,
+                        "type": "string"
                       },
                       {
-                        "name": "toolCallId",
+                        "name": "ok",
+                        "required": true,
+                        "type": "boolean"
+                      },
+                      {
+                        "name": "detail",
                         "type": "string"
                       }
                     ],
@@ -449,98 +478,135 @@
                     "type": "[object]"
                   },
                   {
-                    "name": "tools",
+                    "name": "usage",
                     "properties": [
                       {
-                        "name": "name",
+                        "name": "promptTokens",
                         "required": true,
-                        "type": "string"
+                        "type": "number"
                       },
                       {
-                        "name": "description",
+                        "name": "completionTokens",
                         "required": true,
-                        "type": "string"
+                        "type": "number"
                       },
                       {
-                        "name": "schema",
-                        "properties": [
-                          {
-                            "name": "type",
-                            "type": "string"
-                          },
-                          {
-                            "name": "description",
-                            "type": "string"
-                          }
-                        ],
-                        "type": "object"
+                        "name": "totalTokens",
+                        "required": true,
+                        "type": "number"
+                      },
+                      {
+                        "name": "modelCalls",
+                        "required": true,
+                        "type": "number"
                       }
                     ],
                     "required": true,
-                    "type": "[object]"
+                    "type": "object"
                   }
-                ]
+                ],
+                "tier": "internal"
               },
               {
-                "id": "evt_01M055GH3FTKZT49GCR0057ZRX",
-                "key": "TOOLS_CALLED_1",
-                "name": "Tools Called 1",
+                "id": "evt_01M3TYMQFVB6QA7HQ3KR6GGHHX",
+                "key": "ASK_FAILED",
+                "name": "Ask Failed",
                 "payloadSchema": [
                   {
-                    "name": "result",
+                    "name": "error",
                     "required": true,
                     "type": "string"
                   }
-                ]
-              },
-              {
-                "id": "evt_01M055GH3FGE25ARQM0FVGKD69",
-                "key": "TOOLS_FAILED_1",
-                "name": "Tools Failed 1"
+                ],
+                "tier": "internal"
               },
               {
-                "id": "evt_01M055GH3FPRKJHHVCM1CCYEBK",
-                "key": "TOOLS_CALLED_2",
-                "name": "Tools Called 2",
+                "description": "The assistant answered; carries every tool step it took and the tokens it used.",
+                "id": "evt_01M3TYMQFV2QMJB3DDDPEZGXMD",
+                "key": "REPLIED",
+                "name": "Replied",
                 "payloadSchema": [
                   {
-                    "name": "result",
+                    "name": "reply",
                     "required": true,
                     "type": "string"
+                  },
+                  {
+                    "entity": "AgentStep",
+                    "name": "steps",
+                    "properties": [
+                      {
+                        "name": "kind",
+                        "type": "string"
+                      },
+                      {
+                        "name": "target",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "args",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "ok",
+                        "required": true,
+                        "type": "boolean"
+                      },
+                      {
+                        "name": "detail",
+                        "type": "string"
+                      }
+                    ],
+                    "required": true,
+                    "type": "[object]"
+                  },
+                  {
+                    "name": "usage",
+                    "properties": [
+                      {
+                        "name": "promptTokens",
+                        "required": true,
+                        "type": "number"
+                      },
+                      {
+                        "name": "completionTokens",
+                        "required": true,
+                        "type": "number"
+                      },
+                      {
+                        "name": "totalTokens",
+                        "required": true,
+                        "type": "number"
+                      },
+                      {
+                        "name": "modelCalls",
+                        "required": true,
+                        "type": "number"
+                      }
+                    ],
+                    "required": true,
+                    "type": "object"
                   }
-                ]
-              },
-              {
-                "id": "evt_01M055GH3FVHPAJ5FM8M3KV7GJ",
-                "key": "TOOLS_FAILED_2",
-                "name": "Tools Failed 2"
-              },
-              {
-                "id": "evt_01M055GH3FDECZ0ZVAY7TK7S54",
-                "key": "CONTINUE",
-                "name": "Continue"
-              },
-              {
-                "id": "evt_01M055GH3FQ1H1GN1SK2HZSD68",
-                "key": "RESET",
-                "name": "Reset"
+                ],
+                "synonyms": "answered, responded, done",
+                "tier": "domain"
               },
               {
-                "id": "evt_01M055GH3FX0CKY2DD3716VYCD",
-                "key": "LOOP_STEP",
-                "name": "Loop Step",
+                "description": "The assistant could not answer (model unavailable, or out of steps).",
+                "id": "evt_01M3TYMQFVSHRQ13G34DK0MC45",
+                "key": "REPLY_FAILED",
+                "name": "Reply Failed",
                 "payloadSchema": [
                   {
-                    "name": "response",
+                    "name": "error",
                     "required": true,
                     "type": "string"
-                  },
-                  {
-                    "name": "iteration",
-                    "required": true,
-                    "type": "number"
                   }
-                ]
+                ],
+                "synonyms": "failed, error, gave up",
+                "tier": "domain"
               }
             ],
             "states": [
@@ -549,35 +615,12 @@
                 "name": "idle"
               },
               {
-                "name": "calling"
-              },
-              {
-                "name": "done"
+                "name": "thinking"
               }
             ],
             "transitions": [
               {
                 "effects": [
-                  [
-                    "set",
-                    "@entity.messages",
-                    []
-                  ],
-                  [
-                    "set",
-                    "@entity.tools",
-                    []
-                  ],
-                  [
-                    "set",
-                    "@entity.response",
-                    ""
-                  ],
-                  [
-                    "set",
-                    "@entity.iterations",
-                    0.0
-                  ],
                   [
                     "set",
                     "@entity.status",
@@ -585,7 +628,7 @@
                   ]
                 ],
                 "event": "INIT",
-                "eventId": "evt_01M055GH3FGS4RG4JA39C5EZ7C",
+                "eventId": "evt_01M3TYMQFVZA5GN37VNWYNEAZ3",
                 "from": "idle",
                 "to": "idle"
               },
@@ -593,432 +636,187 @@
                 "effects": [
                   [
                     "set",
-                    "@entity.messages",
-                    "@payload.messages"
-                  ],
-                  [
-                    "set",
-                    "@entity.tools",
-                    "@payload.tools"
+                    "@entity.status",
+                    "thinking"
                   ],
                   [
-                    "llm/call-tools",
-                    "@entity.messages",
-                    "@entity.tools",
+                    "call-service",
+                    "llm",
+                    "call-tools",
+                    {
+                      "instructions": [
+                        "if",
+                        [
+                          "=",
+                          [
+                            "str/default",
+                            "@payload.context",
+                            ""
+                          ],
+                          ""
+                        ],
+                        "@config.instructions",
+                        [
+                          "str/concat",
+                          "@config.instructions",
+                          "\n\nWhat you remember that may be relevant:\n",
+                          "@payload.context"
+                        ]
+                      ],
+                      "maxSteps": "@config.maxSteps",
+                      "messages": "@payload.messages",
+                      "tools": "@config.tools"
+                    },
                     {
                       "emit": {
-                        "failure": "TOOLS_FAILED_1",
-                        "success": "TOOLS_CALLED_1"
+                        "failure": "ASK_FAILED",
+                        "success": "ANSWERED"
                       }
                     }
                   ]
                 ],
-                "event": "EXECUTE",
-                "eventId": "evt_01M055GH3FFMG0YJZMKXVFTSG1",
+                "event": "CONVERSE",
+                "eventId": "evt_01M3TYMQFVAN072R0C2Z5X5NPQ",
                 "from": "idle",
-                "to": "calling"
+                "to": "thinking"
               },
               {
                 "effects": [
                   [
                     "set",
-                    "@entity.response",
-                    "@payload.result"
-                  ],
-                  [
-                    "set",
-                    "@entity.iterations",
-                    [
-                      "+",
-                      "@entity.iterations",
-                      1.0
-                    ]
+                    "@entity.status",
+                    "answered"
                   ],
                   [
                     "set",
-                    "@entity.status",
-                    "done"
+                    "@entity.reply",
+                    "@payload.reply"
                   ],
                   [
                     "emit",
-                    "LOOP_STEP",
+                    "REPLIED",
                     {
-                      "iteration": "@entity.iterations",
-                      "response": "@entity.response"
+                      "reply": "@payload.reply",
+                      "steps": "@payload.steps",
+                      "usage": "@payload.usage"
                     }
                   ]
                 ],
-                "event": "TOOLS_CALLED_1",
-                "eventId": "evt_01M055GH3FTKZT49GCR0057ZRX",
-                "from": "calling",
-                "to": "done"
+                "event": "ANSWERED",
+                "eventId": "evt_01M3TYMQFVCJWHGK649HS8W7NA",
+                "from": "thinking",
+                "to": "idle"
               },
               {
                 "effects": [
-                  [
-                    "set",
-                    "@entity.response",
-                    ""
-                  ],
                   [
                     "set",
                     "@entity.status",
-                    "done"
-                  ]
-                ],
-                "event": "TOOLS_FAILED_1",
-                "eventId": "evt_01M055GH3FGE25ARQM0FVGKD69",
-                "from": "calling",
-                "to": "done"
-              },
-              {
-                "effects": [
-                  [
-                    "set",
-                    "@entity.response",
-                    "@payload.result"
-                  ],
-                  [
-                    "set",
-                    "@entity.iterations",
-                    [
-                      "+",
-                      "@entity.iterations",
-                      1.0
-                    ]
+                    "failed"
                   ],
                   [
                     "set",
-                    "@entity.status",
-                    "done"
+                    "@entity.error",
+                    "@payload.error"
                   ],
                   [
                     "emit",
-                    "LOOP_STEP",
+                    "REPLY_FAILED",
                     {
-                      "iteration": "@entity.iterations",
-                      "response": "@entity.response"
+                      "error": "@payload.error"
                     }
-                  ]
-                ],
-                "event": "TOOLS_CALLED_2",
-                "eventId": "evt_01M055GH3FPRKJHHVCM1CCYEBK",
-                "from": "calling",
-                "to": "done"
-              },
-              {
-                "effects": [
-                  [
-                    "set",
-                    "@entity.response",
-                    ""
                   ],
                   [
-                    "set",
-                    "@entity.status",
-                    "done"
-                  ]
-                ],
-                "event": "TOOLS_FAILED_2",
-                "eventId": "evt_01M055GH3FVHPAJ5FM8M3KV7GJ",
-                "from": "calling",
-                "to": "done"
-              },
-              {
-                "effects": [
-                  [
-                    "set",
-                    "@entity.status",
-                    "done"
-                  ]
-                ],
-                "event": "INIT",
-                "eventId": "evt_01M055GH3FGS4RG4JA39C5EZ7C",
-                "from": "done",
-                "to": "done"
-              },
-              {
-                "effects": [
-                  [
-                    "llm/call-tools",
-                    "@entity.messages",
-                    "@entity.tools",
+                    "render-ui",
+                    "toast",
                     {
-                      "emit": {
-                        "failure": "TOOLS_FAILED_2",
-                        "success": "TOOLS_CALLED_2"
-                      }
+                      "message": "@payload.error",
+                      "type": "alert",
+                      "variant": "error"
                     }
                   ]
                 ],
-                "event": "CONTINUE",
-                "eventId": "evt_01M055GH3FDECZ0ZVAY7TK7S54",
-                "from": "done",
-                "to": "calling"
-              },
-              {
-                "effects": [
-                  [
-                    "set",
-                    "@entity.messages",
-                    []
-                  ],
-                  [
-                    "set",
-                    "@entity.tools",
-                    []
-                  ],
-                  [
-                    "set",
-                    "@entity.response",
-                    ""
-                  ],
-                  [
-                    "set",
-                    "@entity.iterations",
-                    0.0
-                  ],
-                  [
-                    "set",
-                    "@entity.status",
-                    "idle"
-                  ]
-                ],
-                "event": "RESET",
-                "eventId": "evt_01M055GH3FQ1H1GN1SK2HZSD68",
-                "from": "done",
+                "event": "ASK_FAILED",
+                "eventId": "evt_01M3TYMQFVB6QA7HQ3KR6GGHHX",
+                "from": "thinking",
                 "to": "idle"
               }
             ]
           }
-        },
-        {
-          "category": "lifecycle",
-          "effectRow": [
-            {
-              "kind": "set",
-              "resource": "@entity.status"
-            }
-          ],
-          "entityRefIds": {
-            "ToolLoop": "ent_01M055GH3FGEA9J9DR8P9MCDGY"
-          },
-          "id": "trt_01M055GH3FV9BGM02WMCQWK5ZD",
-          "linkedEntity": "ToolLoop",
-          "linkedEntityId": "ent_01M055GH3FGEA9J9DR8P9MCDGY",
-          "listens": [
-            {
-              "event": "LOOP_STEP",
-              "eventId": "evt_01M055GH3FX0CKY2DD3716VYCD",
-              "source": {
-                "kind": "trait",
-                "trait": "ToolLoopExecution",
-                "traitId": "trt_01M055GH3FC9N1R6XWF3W7JHTV"
-              },
-              "triggers": "LOOP_STEP",
-              "triggersId": "evt_01M055GH3FD4VY016QE79Y6A88"
-            }
-          ],
-          "name": "ToolLoopListener",
-          "scope": "instance",
-          "stateMachine": {
-            "events": [
-              {
-                "id": "evt_01M055GH3FKVEW82F74ZH77H58",
-                "key": "INIT",
-                "name": "Initialize"
-              },
-              {
-                "id": "evt_01M055GH3FD4VY016QE79Y6A88",
-                "key": "LOOP_STEP",
-                "name": "Loop Step"
-              },
-              {
-                "id": "evt_01M055GH3FHSNVWJJ354FYM8VB",
-                "key": "RESET",
-                "name": "Reset"
-              }
-            ],
-            "states": [
-              {
-                "isInitial": true,
-                "name": "waiting"
-              },
-              {
-                "name": "active"
-              }
-            ],
-            "transitions": [
-              {
-                "effects": [
-                  [
-                    "set",
-                    "@entity.status",
-                    "idle"
-                  ]
-                ],
-                "event": "INIT",
-                "eventId": "evt_01M055GH3FKVEW82F74ZH77H58",
-                "from": "waiting",
-                "to": "waiting"
-              },
-              {
-                "effects": [
-                  [
-                    "set",
-                    "@entity.status",
-                    "done"
-                  ]
-                ],
-                "event": "LOOP_STEP",
-                "eventId": "evt_01M055GH3FD4VY016QE79Y6A88",
-                "from": "waiting",
-                "to": "active"
-              },
-              {
-                "effects": [
-                  [
-                    "set",
-                    "@entity.status",
-                    "done"
-                  ]
-                ],
-                "event": "INIT",
-                "eventId": "evt_01M055GH3FKVEW82F74ZH77H58",
-                "from": "active",
-                "to": "active"
-              },
-              {
-                "effects": [
-                  [
-                    "set",
-                    "@entity.status",
-                    "idle"
-                  ]
-                ],
-                "event": "RESET",
-                "eventId": "evt_01M055GH3FHSNVWJJ354FYM8VB",
-                "from": "active",
-                "to": "waiting"
-              }
-            ]
-          }
         }
       ],
       "types": {
-        "LlmMessage": [
+        "AgentChatMessage": [
           {
             "name": "role",
-            "required": true,
             "type": "string"
           },
           {
             "name": "content",
             "required": true,
             "type": "string"
-          },
+          }
+        ],
+        "AgentStep": [
           {
-            "name": "toolCalls",
-            "properties": [
-              {
-                "name": "id",
-                "required": true,
-                "type": "string"
-              },
-              {
-                "name": "type",
-                "type": "string"
-              },
-              {
-                "name": "function",
-                "properties": [
-                  {
-                    "name": "name",
-                    "required": true,
-                    "type": "string"
-                  },
-                  {
-                    "name": "arguments",
-                    "required": true,
-                    "type": "string"
-                  }
-                ],
-                "type": "object"
-              }
-            ],
-            "type": "[object]"
+            "name": "kind",
+            "type": "string"
           },
           {
-            "name": "toolCallId",
+            "name": "target",
+            "required": true,
             "type": "string"
-          }
-        ],
-        "LlmToolCall": [
+          },
           {
-            "name": "id",
+            "name": "args",
             "required": true,
             "type": "string"
           },
           {
-            "name": "type",
+            "name": "ok",
+            "required": true,
+            "type": "boolean"
+          },
+          {
+            "name": "detail",
             "type": "string"
+          }
+        ],
+        "AgentTool": [
+          {
+            "name": "event",
+            "type": "event"
           },
           {
-            "name": "function",
-            "properties": [
-              {
-                "name": "name",
-                "required": true,
-                "type": "string"
-              },
-              {
-                "name": "arguments",
-                "required": true,
-                "type": "string"
-              }
-            ],
-            "type": "object"
+            "name": "read",
+            "type": "string"
           }
         ],
-        "LlmToolDef": [
+        "AgentUsage": [
           {
-            "name": "name",
+            "name": "promptTokens",
             "required": true,
-            "type": "string"
+            "type": "number"
           },
           {
-            "name": "description",
+            "name": "completionTokens",
             "required": true,
-            "type": "string"
+            "type": "number"
           },
           {
-            "name": "schema",
-            "properties": [
-              {
-                "name": "type",
-                "type": "string"
-              },
-              {
-                "name": "description",
-                "type": "string"
-              }
-            ],
-            "type": "object"
-          }
-        ],
-        "LlmToolSchema": [
-          {
-            "name": "type",
-            "type": "string"
+            "name": "totalTokens",
+            "required": true,
+            "type": "number"
           },
           {
-            "name": "description",
-            "type": "string"
+            "name": "modelCalls",
+            "required": true,
+            "type": "number"
           }
         ]
       }
     }
   ],
   "schemaVersion": 1,
-  "version": "1.0.0"
+  "version": "2.0.0"
 }