@tangle-network/agent-app 0.44.59 → 0.44.60

package/dist/web-react/terminal.d.ts

@@ -8,8 +8,24 @@ interface SandboxTerminalConnection {
     error: string | null;
     loading: boolean;
     sandboxId?: string;
+    connectionId?: string;
 }
-/** Define the response structure for a sandbox terminal connection including URLs, token, status, and errors */
+/**
+ * Define the response structure for a sandbox terminal connection including URLs, token, status, and errors
+ *
+ * Transport-agnostic by construction (#341/#349): the browser-direct
+ * scoped-token route (`createSandboxTerminalConnectionRoute`,
+ * `src/sandbox/terminal-connection.ts`) returns `sidecarUrl` only — no
+ * `runtimeUrl` — while the (now `@deprecated`) same-origin proxy route
+ * returns both. `useSandboxTerminalConnection` below resolves
+ * `runtimeUrl ?? sidecarUrl` so either shape lands on the same connection
+ * state without a hook change.
+ *
+ * `connectionId` is the id the route's minted token's `sid` is bound to
+ * (echoed back from the `connectionId` the hook sent) — pass it straight
+ * through as `TerminalView`'s `connectionId` prop, since any other value
+ * fails the WS upgrade on the current platform.
+ */
 interface SandboxTerminalConnectionResponse {
     runtimeUrl?: string;
     sidecarUrl?: string;
@@ -18,11 +34,23 @@ interface SandboxTerminalConnectionResponse {
     status?: string;
     error?: string;
     sandboxId?: string;
+    connectionId?: string;
 }
-/** Define options for configuring a sandbox terminal connection including workspace ID and connection parameters */
+/**
+ * Define options for configuring a sandbox terminal connection including workspace ID and connection parameters
+ *
+ * `connectionId`, when set, is passed to
+ * `createSandboxTerminalConnectionRoute` as the `connectionId` query
+ * parameter — pass `tabTerminalConnectionId()` here so the route mints a
+ * token whose `sid` is bound to the same id `TerminalView` will dial. Give
+ * `TerminalView` the response's echoed `connectionId` (not this input
+ * value) alongside `sidecarUrl` as `apiUrl` and `token`, since a product's
+ * `resolveConnectionId` seam may rewrite it server-side.
+ */
 interface UseSandboxTerminalConnectionOptions {
     workspaceId: string;
     connectionUrl?: string | ((workspaceId: string) => string);
+    connectionId?: string;
     fetcher?: typeof fetch;
     provisionPollIntervalMs?: number;
     provisionPollTimeoutMs?: number;
@@ -32,7 +60,24 @@ interface UseSandboxTerminalConnectionOptions {
 interface UseSandboxTerminalConnectionResult extends SandboxTerminalConnection {
     connect: () => Promise<void>;
 }
-/** Manage and maintain a sandbox terminal connection with automatic polling and token refresh handling */
+/**
+ * Manage and maintain a sandbox terminal connection with automatic polling and token refresh handling
+ *
+ * Transport-agnostic (#341/#349): this hook does not care whether
+ * `connectionUrl` is backed by the fleet-default browser-direct
+ * scoped-token route (`createSandboxTerminalConnectionRoute`,
+ * `src/sandbox/terminal-connection.ts`, `sidecarUrl` only) or the
+ * `@deprecated` same-origin proxy route (`runtimeUrl` + `sidecarUrl`) — it
+ * resolves `runtimeUrl ?? sidecarUrl` either way.
+ *
+ * Pass `tabTerminalConnectionId()` as `opts.connectionId` — the hook forwards
+ * it as the `connectionId` query parameter the browser-direct route requires
+ * to mint a token whose `sid` is bound to that exact id (the orchestrator's
+ * terminal WS gate fails closed on any other value). Give `TerminalView` the
+ * RESULT's echoed `connectionId` (not the input value — a product's
+ * `resolveConnectionId` seam may rewrite it), the resolved `sidecarUrl`/
+ * `runtimeUrl` as `apiUrl`, and `token` as its token prop.
+ */
 declare function useSandboxTerminalConnection(opts: UseSandboxTerminalConnectionOptions): UseSandboxTerminalConnectionResult;
 /**
  * Stable-per-tab, unique-per-client terminal connection id.

package/dist/web-react/terminal.js

@@ -1,7 +1,7 @@
 import {
   tabTerminalConnectionId,
   useSandboxTerminalConnection
-} from "../chunk-HCOROIRT.js";
+} from "../chunk-S4YW2Y52.js";
 export {
   tabTerminalConnectionId,
   useSandboxTerminalConnection

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-app",
-  "version": "0.44.59",
+  "version": "0.44.60",
   "packageManager": "pnpm@11.17.0",
   "description": "Build agent applications with typed chat, tools, sandboxes, integrations, billing, and evaluation.",
   "keywords": [