@almadar/std 16.238.0 → 16.241.0

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

@@ -1,5 +1,5 @@
 {
-  "description": "std-agent-trace — the persisted record of what an in-app assistant did. Each REPLIED (from std-agent-tool-loop) stores one AgentRun row: the reply, every tool step (which input or entity, the arguments, whether it took effect and why not), the tokens and the model calls; each REPLY_FAILED stores a failed run with its error. The record verification grades and later optimisation reads, in one format for tests and production. AgentTraceRecorder is headless; AgentRunBrowse is the run list. Rows carry ownerId (the real @user); the binding organism scopes @read.",
+  "description": "std-agent-trace — the persisted record of what an in-app assistant did. Each REPLIED (from std-agent-tool-loop) stores one AgentRun row: the reply, every step (each model call, each tool used with its arguments, whether it took effect and why not), the tokens and the model calls; each REPLY_FAILED stores a failed run with its error. The record verification grades and later optimisation reads, in one format for tests and production. AgentTraceRecorder is headless; AgentRunBrowse is the run list. Rows carry ownerId (the real @user); the binding organism scopes @read.",
   "ledger": {
     "entries": {
       "ent_01M3TYMQNB6WGTST5HMRSNMPX3": {
@@ -161,41 +161,205 @@
           },
           {
             "default": [],
-            "description": "Every tool use, in order.",
+            "description": "Every step, in order: each model call, each tool used and what the app answered.",
             "items": {
               "properties": {
-                "args": {
-                  "name": "args",
-                  "required": true,
-                  "type": "string"
-                },
-                "detail": {
-                  "name": "detail",
-                  "required": false,
-                  "type": "string"
-                },
-                "kind": {
-                  "name": "kind",
-                  "required": false,
-                  "type": "string",
-                  "values": [
-                    "input",
-                    "read",
-                    "invalid"
-                  ]
+                "AgentLlmResponseActivity": {
+                  "name": "AgentLlmResponseActivity",
+                  "properties": {
+                    "content": {
+                      "name": "content",
+                      "required": true,
+                      "type": "string"
+                    },
+                    "llm": {
+                      "name": "llm",
+                      "properties": {
+                        "attempt": {
+                          "name": "attempt",
+                          "required": false,
+                          "type": "number"
+                        },
+                        "cachedPromptTokens": {
+                          "name": "cachedPromptTokens",
+                          "required": false,
+                          "type": "number"
+                        },
+                        "completionTokens": {
+                          "name": "completionTokens",
+                          "required": false,
+                          "type": "number"
+                        },
+                        "costUSD": {
+                          "name": "costUSD",
+                          "required": false,
+                          "type": "number"
+                        },
+                        "durationMs": {
+                          "name": "durationMs",
+                          "required": true,
+                          "type": "number"
+                        },
+                        "model": {
+                          "name": "model",
+                          "required": true,
+                          "type": "string"
+                        },
+                        "promptTokens": {
+                          "name": "promptTokens",
+                          "required": false,
+                          "type": "number"
+                        },
+                        "provider": {
+                          "name": "provider",
+                          "required": true,
+                          "type": "string"
+                        },
+                        "service": {
+                          "name": "service",
+                          "required": true,
+                          "type": "string"
+                        },
+                        "systemPrompt": {
+                          "name": "systemPrompt",
+                          "required": true,
+                          "type": "string"
+                        },
+                        "toolCallsJson": {
+                          "name": "toolCallsJson",
+                          "required": false,
+                          "type": "string"
+                        },
+                        "userPrompt": {
+                          "name": "userPrompt",
+                          "required": true,
+                          "type": "string"
+                        }
+                      },
+                      "required": false,
+                      "type": "object"
+                    },
+                    "timestamp": {
+                      "name": "timestamp",
+                      "required": true,
+                      "type": "number"
+                    },
+                    "type": {
+                      "name": "type",
+                      "required": true,
+                      "type": "string",
+                      "values": [
+                        "llm_response"
+                      ]
+                    }
+                  },
+                  "type": "object"
                 },
-                "ok": {
-                  "name": "ok",
-                  "required": true,
-                  "type": "boolean"
+                "AgentToolCallActivity": {
+                  "name": "AgentToolCallActivity",
+                  "properties": {
+                    "argsText": {
+                      "name": "argsText",
+                      "required": true,
+                      "type": "string"
+                    },
+                    "isExecuting": {
+                      "name": "isExecuting",
+                      "required": false,
+                      "type": "boolean"
+                    },
+                    "kind": {
+                      "name": "kind",
+                      "required": false,
+                      "type": "string",
+                      "values": [
+                        "input",
+                        "read",
+                        "invalid"
+                      ]
+                    },
+                    "timestamp": {
+                      "name": "timestamp",
+                      "required": true,
+                      "type": "number"
+                    },
+                    "tool": {
+                      "name": "tool",
+                      "required": true,
+                      "type": "string"
+                    },
+                    "type": {
+                      "name": "type",
+                      "required": true,
+                      "type": "string",
+                      "values": [
+                        "tool_call"
+                      ]
+                    }
+                  },
+                  "type": "object"
                 },
-                "target": {
-                  "name": "target",
-                  "required": true,
-                  "type": "string"
+                "AgentToolResultActivity": {
+                  "name": "AgentToolResultActivity",
+                  "properties": {
+                    "detail": {
+                      "name": "detail",
+                      "required": false,
+                      "type": "string"
+                    },
+                    "kind": {
+                      "name": "kind",
+                      "required": false,
+                      "type": "string",
+                      "values": [
+                        "input",
+                        "read",
+                        "invalid"
+                      ]
+                    },
+                    "resultText": {
+                      "name": "resultText",
+                      "required": true,
+                      "type": "string"
+                    },
+                    "rows": {
+                      "name": "rows",
+                      "required": false,
+                      "type": "number"
+                    },
+                    "success": {
+                      "name": "success",
+                      "required": true,
+                      "type": "boolean"
+                    },
+                    "timestamp": {
+                      "name": "timestamp",
+                      "required": true,
+                      "type": "number"
+                    },
+                    "tool": {
+                      "name": "tool",
+                      "required": true,
+                      "type": "string"
+                    },
+                    "type": {
+                      "name": "type",
+                      "required": true,
+                      "type": "string",
+                      "values": [
+                        "tool_result"
+                      ]
+                    }
+                  },
+                  "type": "object"
                 }
               },
-              "type": "object"
+              "type": "union",
+              "values": [
+                "AgentToolCallActivity",
+                "AgentToolResultActivity",
+                "AgentLlmResponseActivity"
+              ]
             },
             "name": "steps",
             "synonyms": "actions, tool calls, trace",
@@ -315,33 +479,8 @@
                   },
                   {
                     "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]"
+                    "type": "[AgentActivity]"
                   },
                   {
                     "name": "usage",
@@ -529,32 +668,7 @@
                     },
                     {
                       "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"
-                        }
-                      ],
-                      "type": "[object]"
+                      "type": "[AgentActivity]"
                     },
                     {
                       "name": "promptTokens",
@@ -665,7 +779,7 @@
                       },
                       {
                         "name": "steps",
-                        "type": "[AgentStep]"
+                        "type": "[AgentActivity]"
                       },
                       {
                         "name": "promptTokens",
@@ -790,6 +904,11 @@
                               ],
                               "type": "typography",
                               "variant": "caption"
+                            },
+                            {
+                              "activities": "@item.steps",
+                              "followLatest": false,
+                              "type": "agent-activity-feed"
                             }
                           ],
                           "direction": "vertical",
@@ -846,29 +965,206 @@
         }
       ],
       "types": {
-        "AgentStep": [
+        "AgentLlmCall": [
+          {
+            "name": "service",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "provider",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "model",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "systemPrompt",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "userPrompt",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "toolCallsJson",
+            "type": "string"
+          },
+          {
+            "name": "attempt",
+            "type": "number"
+          },
+          {
+            "name": "durationMs",
+            "required": true,
+            "type": "number"
+          },
+          {
+            "name": "promptTokens",
+            "type": "number"
+          },
+          {
+            "name": "completionTokens",
+            "type": "number"
+          },
+          {
+            "name": "cachedPromptTokens",
+            "type": "number"
+          },
+          {
+            "name": "costUSD",
+            "type": "number"
+          }
+        ],
+        "AgentLlmResponseActivity": [
+          {
+            "name": "type",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "content",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "llm",
+            "properties": [
+              {
+                "name": "service",
+                "required": true,
+                "type": "string"
+              },
+              {
+                "name": "provider",
+                "required": true,
+                "type": "string"
+              },
+              {
+                "name": "model",
+                "required": true,
+                "type": "string"
+              },
+              {
+                "name": "systemPrompt",
+                "required": true,
+                "type": "string"
+              },
+              {
+                "name": "userPrompt",
+                "required": true,
+                "type": "string"
+              },
+              {
+                "name": "toolCallsJson",
+                "type": "string"
+              },
+              {
+                "name": "attempt",
+                "type": "number"
+              },
+              {
+                "name": "durationMs",
+                "required": true,
+                "type": "number"
+              },
+              {
+                "name": "promptTokens",
+                "type": "number"
+              },
+              {
+                "name": "completionTokens",
+                "type": "number"
+              },
+              {
+                "name": "cachedPromptTokens",
+                "type": "number"
+              },
+              {
+                "name": "costUSD",
+                "type": "number"
+              }
+            ],
+            "type": "object"
+          },
+          {
+            "name": "timestamp",
+            "required": true,
+            "type": "number"
+          }
+        ],
+        "AgentToolCallActivity": [
+          {
+            "name": "type",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "tool",
+            "required": true,
+            "type": "string"
+          },
           {
             "name": "kind",
+            "type": "AgentToolKind"
+          },
+          {
+            "name": "argsText",
+            "required": true,
             "type": "string"
           },
           {
-            "name": "target",
+            "name": "timestamp",
+            "required": true,
+            "type": "number"
+          },
+          {
+            "name": "isExecuting",
+            "type": "boolean"
+          }
+        ],
+        "AgentToolResultActivity": [
+          {
+            "name": "type",
             "required": true,
             "type": "string"
           },
           {
-            "name": "args",
+            "name": "tool",
             "required": true,
             "type": "string"
           },
           {
-            "name": "ok",
+            "name": "kind",
+            "type": "AgentToolKind"
+          },
+          {
+            "name": "success",
             "required": true,
             "type": "boolean"
           },
           {
             "name": "detail",
             "type": "string"
+          },
+          {
+            "name": "rows",
+            "type": "number"
+          },
+          {
+            "name": "resultText",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "timestamp",
+            "required": true,
+            "type": "number"
           }
         ],
         "AgentUsage": [