@tangle-network/agent-provider-tangle 0.8.0 → 0.9.0

package/README.md

@@ -15,6 +15,8 @@ const provider = createTangleProvider({
 
 Detached dispatch returns the immutable Sandbox execution receipt in `controlRef`.
 The adapter validates its complete capability document and omits optional environment methods whose capabilities are disabled.
+Created and reconstructed environments expose a recursively frozen Sandbox metadata snapshot for constant-time annotation checks.
+Sandbox metadata can include caller-authored values and does not authenticate its author.
 Reconstruct an exact session with `environment.session(reference.id, { controlRef: reference.controlRef })`; replay cursors are exclusive at both the agent interface and Sandbox session stream.
 Result, replay, and cancel operations select that exact execution instead of whichever execution most recently changed the shared session.
 Session status with an exact control reference reports a state only when the payload names that execution; a payload bound to a different or unnamed execution reports `unknown`.

package/dist/tangle-environment.js

@@ -60,6 +60,7 @@ export async function sandboxInstanceAsEnvironment(box, providerName, client, de
         id: environmentId,
         provider: providerName,
         ...(box.name ? { name: boundedString(box.name, "Tangle environment name") } : {}),
+        ...(box.metadata ? { metadata: snapshotMetadata(box.metadata) } : {}),
         capabilities,
         async status(options) {
             assertOptionKeys(options, ["signal"], "Tangle environment status");
@@ -212,3 +213,14 @@ export async function sandboxInstanceAsEnvironment(box, providerName, client, de
             : {}),
     };
 }
+function snapshotMetadata(metadata) {
+    return deepFreeze(structuredClone(metadata));
+}
+function deepFreeze(value, seen = new Set()) {
+    if (value === null || typeof value !== "object" || seen.has(value))
+        return value;
+    seen.add(value);
+    for (const child of Object.values(value))
+        deepFreeze(child, seen);
+    return Object.freeze(value);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-provider-tangle",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "AgentEnvironmentProvider adapter for Tangle sandboxes",
   "type": "module",
   "license": "MIT",
@@ -69,7 +69,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@tangle-network/agent-interface": "0.50.0"
+    "@tangle-network/agent-interface": "0.51.0"
   },
   "peerDependencies": {
     "@tangle-network/sandbox": ">=0.19.6 <1.0.0"
@@ -86,7 +86,7 @@
     "@types/node": "25.6.0",
     "typescript": "^6.0.3",
     "vitest": "^4.1.5",
-    "@tangle-network/agent-provider-testkit": "0.7.0"
+    "@tangle-network/agent-provider-testkit": "0.7.1"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",