tangle-network · drewstone · Aug 13, 2026 · Aug 13, 2026
diff --git a/.changeset/lucky-pans-clap.md b/.changeset/lucky-pans-clap.md
diff --git a/.changeset/tidy-moons-report.md b/.changeset/tidy-moons-report.md
diff --git a/packages/agent-core/CHANGELOG.md b/packages/agent-core/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tangle-network/agent-core
 
+## 0.7.2
+
+### Patch Changes
+
+- Updated dependencies [bdb076b]
+  - @tangle-network/agent-interface@0.50.0
+
 ## 0.7.1
 
 ### Patch Changes

diff --git a/packages/agent-core/package.json b/packages/agent-core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-core",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "description": "Core transport interfaces, event utilities, auth, SSE parsing, and resilience primitives for talking to Tangle agents",
   "type": "module",
   "license": "MIT",
@@ -170,7 +170,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@tangle-network/agent-interface": "0.49.0",
+    "@tangle-network/agent-interface": "0.50.0",
     "zod": "catalog:"
   },
   "devDependencies": {

diff --git a/packages/agent-interface/CHANGELOG.md b/packages/agent-interface/CHANGELOG.md
@@ -1,5 +1,17 @@
 # @tangle-network/agent-interface
 
+## 0.50.0
+
+### Minor Changes
+
+- bdb076b: Add the environment-scoped capability document.
+
+  `AgentEnvironment.capabilities` is an optional document that describes one environment.
+  A capability the connected deployment decides cannot be stated by `AgentEnvironmentProvider.capabilities()`, because one provider reaches deployments of different ages; a provider that measures such a capability per environment publishes the measured answer here, and the operations that environment exposes match it.
+
+  `runAgentEnvironmentProviderConformance` and `runSessionReplayConformance` now bind every environment-scoped check to that document when the environment publishes one, and to the provider document otherwise.
+  The provider report gains `environmentCapabilities`, which is the document the checks ran against.
+
 ## 0.49.0
 
 ### Minor Changes

diff --git a/packages/agent-interface/package.json b/packages/agent-interface/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-interface",
-  "version": "0.49.0",
+  "version": "0.50.0",
   "type": "module",
   "sideEffects": false,
   "license": "MIT",

diff --git a/packages/agent-provider-cli-bridge/CHANGELOG.md b/packages/agent-provider-cli-bridge/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tangle-network/agent-provider-cli-bridge
 
+## 0.6.3
+
+### Patch Changes
+
+- Updated dependencies [bdb076b]
+  - @tangle-network/agent-interface@0.50.0
+
 ## 0.6.2
 
 ### Patch Changes

diff --git a/packages/agent-provider-cli-bridge/package.json b/packages/agent-provider-cli-bridge/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-provider-cli-bridge",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "description": "AgentEnvironmentProvider adapter for cli-bridge /v1/chat/completions",
   "type": "module",
   "license": "MIT",
@@ -62,7 +62,7 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@tangle-network/agent-interface": "0.49.0",
+    "@tangle-network/agent-interface": "0.50.0",
     "undici": "catalog:"
   },
   "devDependencies": {

diff --git a/packages/agent-provider-computesdk/CHANGELOG.md b/packages/agent-provider-computesdk/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tangle-network/agent-provider-computesdk
 
+## 0.3.7
+
+### Patch Changes
+
+- Updated dependencies [bdb076b]
+  - @tangle-network/agent-interface@0.50.0
+
 ## 0.3.6
 
 ### Patch Changes

diff --git a/packages/agent-provider-computesdk/package.json b/packages/agent-provider-computesdk/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-provider-computesdk",
-  "version": "0.3.6",
+  "version": "0.3.7",
   "description": "AgentEnvironmentProvider adapter for ComputeSDK-compatible sandboxes",
   "type": "module",
   "license": "MIT",
@@ -44,7 +44,7 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@tangle-network/agent-interface": "0.49.0"
+    "@tangle-network/agent-interface": "0.50.0"
   },
   "peerDependencies": {
     "computesdk": "^4.1.3"

diff --git a/packages/agent-provider-daytona/CHANGELOG.md b/packages/agent-provider-daytona/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tangle-network/agent-provider-daytona
 
+## 0.3.7
+
+### Patch Changes
+
+- Updated dependencies [bdb076b]
+  - @tangle-network/agent-interface@0.50.0
+
 ## 0.3.6
 
 ### Patch Changes

diff --git a/packages/agent-provider-daytona/package.json b/packages/agent-provider-daytona/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-provider-daytona",
-  "version": "0.3.6",
+  "version": "0.3.7",
   "description": "AgentEnvironmentProvider adapter for Daytona workspaces",
   "type": "module",
   "license": "MIT",
@@ -44,7 +44,7 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@tangle-network/agent-interface": "0.49.0"
+    "@tangle-network/agent-interface": "0.50.0"
   },
   "peerDependencies": {
     "@daytonaio/sdk": "^0.192.0"

diff --git a/packages/agent-provider-e2b/CHANGELOG.md b/packages/agent-provider-e2b/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tangle-network/agent-provider-e2b
 
+## 0.3.7
+
+### Patch Changes
+
+- Updated dependencies [bdb076b]
+  - @tangle-network/agent-interface@0.50.0
+
 ## 0.3.6
 
 ### Patch Changes

diff --git a/packages/agent-provider-e2b/package.json b/packages/agent-provider-e2b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-provider-e2b",
-  "version": "0.3.6",
+  "version": "0.3.7",
   "description": "AgentEnvironmentProvider adapter for E2B sandboxes",
   "type": "module",
   "license": "MIT",
@@ -44,7 +44,7 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@tangle-network/agent-interface": "0.49.0"
+    "@tangle-network/agent-interface": "0.50.0"
   },
   "peerDependencies": {
     "e2b": "^2.31.0"

diff --git a/packages/agent-provider-tangle/CHANGELOG.md b/packages/agent-provider-tangle/CHANGELOG.md
@@ -1,5 +1,28 @@
 # @tangle-network/agent-provider-tangle
 
+## 0.8.0
+
+### Minor Changes
+
+- bdb076b: Derive retained control from deployment capability discovery, and publish the result on the environment.
+
+  Composing an environment now calls `box.capabilities()` once and takes every deployment-decided claim from that document instead of from the linked Sandbox SDK's method surface.
+  The narrowed document is published as `environment.capabilities`, which is the document to read before offering an operation: the operations an environment exposes match it exactly, while `provider.capabilities()` states the adapter's ceiling before any sandbox exists.
+
+  Every flag the capability document carries now gates the claims it backs.
+  `streaming.detach` and `streaming.turnIdempotency` need `dispatch.runControlRef` with `dispatch.executionIdOnAdmission`; `streaming.replay` needs `runs.eventReplay`; `sessions.continue`, `retainedControl`, and `session.cancelRun` need those plus `cancel.canonicalRunCancellation`, `cancel.digestBound`, `cancel.idempotent`, and `runs.executionScopedStatus`.
+  Detached dispatch also needs a session handle, because a detached run is reachable only through one.
+
+  Four inputs claim nothing: an SDK older than 0.22.0, a sandbox that is not running, a `null` document, and a capability read that fails.
+  Such environments omit `dispatch` and `session`.
+  A document that leaves a flag unset drops the claims that flag gates and keeps the rest, so it can still carry `streaming.detach` and `streaming.replay`.
+  A failed read no longer fails `create()` and no longer deletes the sandbox a cold provision has already paid for; it claims nothing and reports the failure on the warning channel.
+
+### Patch Changes
+
+- Updated dependencies [bdb076b]
+  - @tangle-network/agent-interface@0.50.0
+
 ## 0.7.3
 
 ### Patch Changes

diff --git a/packages/agent-provider-tangle/package.json b/packages/agent-provider-tangle/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-provider-tangle",
-  "version": "0.7.3",
+  "version": "0.8.0",
   "description": "AgentEnvironmentProvider adapter for Tangle sandboxes",
   "type": "module",
   "license": "MIT",
@@ -84,7 +84,7 @@
     "test": "vitest run src"
   },
   "dependencies": {
-    "@tangle-network/agent-interface": "0.49.0"
+    "@tangle-network/agent-interface": "0.50.0"
   },
   "peerDependencies": {
     "@tangle-network/sandbox": ">=0.19.6 <1.0.0"

diff --git a/packages/agent-provider-testkit/CHANGELOG.md b/packages/agent-provider-testkit/CHANGELOG.md
@@ -1,5 +1,22 @@
 # @tangle-network/agent-provider-testkit
 
+## 0.7.0
+
+### Minor Changes
+
+- bdb076b: Add the environment-scoped capability document.
+
+  `AgentEnvironment.capabilities` is an optional document that describes one environment.
+  A capability the connected deployment decides cannot be stated by `AgentEnvironmentProvider.capabilities()`, because one provider reaches deployments of different ages; a provider that measures such a capability per environment publishes the measured answer here, and the operations that environment exposes match it.
+
+  `runAgentEnvironmentProviderConformance` and `runSessionReplayConformance` now bind every environment-scoped check to that document when the environment publishes one, and to the provider document otherwise.
+  The provider report gains `environmentCapabilities`, which is the document the checks ran against.
+
+### Patch Changes
+
+- Updated dependencies [bdb076b]
+  - @tangle-network/agent-interface@0.50.0
+
 ## 0.6.4
 
 ### Patch Changes

diff --git a/packages/agent-provider-testkit/package.json b/packages/agent-provider-testkit/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-provider-testkit",
-  "version": "0.6.4",
+  "version": "0.7.0",
   "description": "Framework-neutral conformance checks for AgentEnvironmentProvider implementations",
   "type": "module",
   "license": "MIT",
@@ -66,7 +66,7 @@
     "test": "vitest run src"
   },
   "dependencies": {
-    "@tangle-network/agent-interface": "0.49.0"
+    "@tangle-network/agent-interface": "0.50.0"
   },
   "devDependencies": {
     "@types/node": "catalog:",