@tangle-network/agent-provider-tangle 1.1.5 → 1.1.6

package/dist/tangle-events.js

@@ -173,6 +173,15 @@ export function environmentEventFromSandboxEvent(event, expected = {}) {
         }
     }
     const usage = tokenUsageFromData(data);
+    const declaredModes = [record.usageMode, data.usageMode].filter((mode) => mode !== undefined);
+    if (declaredModes.some((mode) => mode !== "delta" && mode !== "cumulative") ||
+        (declaredModes.length === 2 && declaredModes[0] !== declaredModes[1])) {
+        throw new Error("Tangle Sandbox event contained invalid or conflicting usage modes");
+    }
+    // Only terminal turn receipts have established aggregate semantics.
+    // Other event names do not prove whether their usage is incremental.
+    const usageMode = declaredModes[0] ??
+        (record.type === "result" || record.type === "done" ? "cumulative" : undefined);
     // The session id reaches the normalized event whichever position carried it,
     // including the native id an execution-bound stream just accepted as content.
     const normalized = normalizeSandboxEvent(record.type, data, identity);
@@ -184,6 +193,7 @@ export function environmentEventFromSandboxEvent(event, expected = {}) {
         // Absent rather than zeroed: an event that reported no usage must not
         // contribute a total to whatever sums these events.
         ...(usage ? { usage } : {}),
+        ...(usageMode === undefined ? {} : { usageMode }),
         providerEvent: event,
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-provider-tangle",
-  "version": "1.1.5",
+  "version": "1.1.6",
   "description": "AgentEnvironmentProvider adapter for Tangle sandboxes",
   "type": "module",
   "license": "MIT",
@@ -91,7 +91,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@tangle-network/agent-interface": "^2.3.1"
+    "@tangle-network/agent-interface": "^2.4.0"
   },
   "peerDependencies": {
     "@tangle-network/sandbox": ">=0.34.6 <1.0.0"
@@ -108,7 +108,7 @@
     "@types/node": "26.4.1",
     "typescript": "7.0.2",
     "vitest": "4.1.11",
-    "@tangle-network/agent-provider-testkit": "0.9.2"
+    "@tangle-network/agent-provider-testkit": "0.10.0"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",