@tangle-network/agent-provider-tangle 1.1.3 → 1.1.4

package/README.md

@@ -1,7 +1,7 @@
 # @tangle-network/agent-provider-tangle
 
 Wraps `@tangle-network/sandbox` as an `AgentEnvironmentProvider`.
-The peer range is `>=0.34.6 <1.0.0`, and this package is developed and tested against 0.36.4.
+The peer range is `>=0.34.6 <1.0.0`, and this package is developed and tested against 0.37.0.
 The floor is 0.34.6 because exact interactive attachment needs the host receiver, and workspace branching needs keyed snapshots, durable restores, inventory recovery, and cleanup.
 The provider fails closed when the configured backend or its catalog entry cannot be read.
 Newer SDKs may also provide `getBackend()` as a lookup over the same catalog.
@@ -119,6 +119,7 @@ Each deployment flag this adapter reads gates the claims it backs, and no flag i
 | `runs.eventReplay`                | `streaming.replay`, `sessions.continue`, `retainedControl`, `session.cancelRun`                              |
 | `runs.executionScopedStatus`      | `sessions.continue`, `retainedControl`, `session.cancelRun`                                                  |
 | `interactions.responseDedupe`     | `interactions`, `environment.respondToInteraction`, `session.respondToInteraction`                           |
+| `interactiveAgent.*`              | `interactiveAgent`, exact control, and generation-fenced terminal input and resize                           |
 
 Detached dispatch carries the caller's exact reference and refuses a receipt that does not name the execution back, so it needs both `dispatch` flags and a session handle to reach the run through.
 `sessions.continue`, `retainedControl`, and `session.cancelRun` need every flag in the table, because the capability schema refuses a partial retained-control block and each identity rests on its own flag.
@@ -333,6 +334,11 @@ Every reference states an expiry one detach window past the newest activity the
 `close()` reports `closed` only when the socket delivered an exit; Sandbox exposes no terminal delete, so an unproven close reports `unknown` rather than claiming a termination that did not happen.
 An attach whose runtime metadata lacks a name, shell, working directory, geometry, timestamps, running state, or detach window fails closed with `unknown`, because a reference cannot state facts the runtime did not report.
 
+The exact interactive adapter validates control before attach, prompt, and stop operations.
+An attached terminal sends input and resize operations through its authenticated terminal connection.
+The sidecar authorizes those mutations, so the provider does not add a second REST request before each operation.
+Terminal close only detaches the caller's socket, so it stays available after control moves to a newer coordinator.
+
 Pass `exactProcess: {}` only when the Sandbox deployment supports `agent: false` creates and reports `metadata.runtimeMode: "control"`.
 The optional capability creates an ephemeral sandbox with an authenticated control service but no managed agent workload or agent credentials, explicit resources, exact blocked/domain egress, bounded binary file reads, shell-free launch, and recoverable process output plus terminal reason.
 Set `teamId` inside `exactProcess` to scope create, lookup, and recovery to one team.

package/dist/tangle-interactive.js

@@ -186,7 +186,7 @@ export function createTangleInteractiveAgentRegistry(box, providerName, environm
                         await terminal.detach().catch(() => undefined);
                         throw error;
                     }
-                    return validatedTerminal(terminal, exactRequest.control, validateControl, ref);
+                    return validatedTerminal(terminal, exactRequest.control, ref);
                 },
                 async sendPrompt(command, options) {
                     assertOptionKeys(options, ["signal"], "Tangle interactive agent prompt");
@@ -246,7 +246,7 @@ function isSandboxInteractiveSession(value) {
         "stop",
     ].every((key) => typeof candidate[key] === "function");
 }
-function validatedTerminal(terminal, control, validate, expectedRef) {
+function validatedTerminal(terminal, control, expectedRef) {
     const boundControl = Object.freeze({ ...control });
     return {
         get ref() {
@@ -261,19 +261,12 @@ function validatedTerminal(terminal, control, validate, expectedRef) {
             return TerminalReplayWindowSchema.parse(terminal.cursors);
         },
         control: boundControl,
-        async input(input, options) {
-            await validate(boundControl, options);
-            await terminal.input(input, options);
-        },
-        async resize(resize, options) {
-            await validate(boundControl, options);
-            await terminal.resize(resize, options);
-        },
+        // The authenticated terminal transport authorizes input and resize.
+        // A REST preflight adds latency and can race the authoritative operation.
+        input: (input, options) => terminal.input(input, options),
+        resize: (resize, options) => terminal.resize(resize, options),
         detach: (options) => terminal.detach(options),
-        async close(options) {
-            await validate(boundControl, options);
-            return terminal.close(options);
-        },
+        close: (options) => terminal.close(options),
         events: (options) => terminal.events(options),
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-provider-tangle",
-  "version": "1.1.3",
+  "version": "1.1.4",
   "description": "AgentEnvironmentProvider adapter for Tangle sandboxes",
   "type": "module",
   "license": "MIT",
@@ -102,13 +102,13 @@
     }
   },
   "devDependencies": {
-    "@tangle-network/agent-eval": "0.173.0",
-    "@tangle-network/agent-runtime": "0.190.0",
-    "@tangle-network/sandbox": "0.36.4",
-    "@types/node": "26.4.0",
+    "@tangle-network/agent-eval": "0.173.1",
+    "@tangle-network/agent-runtime": "0.192.2",
+    "@tangle-network/sandbox": "0.37.0",
+    "@types/node": "26.4.1",
     "typescript": "7.0.2",
     "vitest": "4.1.11",
-    "@tangle-network/agent-provider-testkit": "0.9.1"
+    "@tangle-network/agent-provider-testkit": "0.9.2"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",