@tangle-network/sandbox-ui 0.104.0 → 0.104.1

package/dist/{chunk-WYMAC3T3.js → chunk-4VLVVKQZ.js}

@@ -1,6 +1,6 @@
 import {
   usePtySession
-} from "./chunk-KEYPUGS3.js";
+} from "./chunk-7KB22BLB.js";
 
 // src/terminal/terminal-view.tsx
 import "@xterm/xterm/css/xterm.css";
@@ -41,6 +41,8 @@ function TerminalView({
   subtitle = "Connected to PTY session",
   isActive = true,
   connectionId,
+  incarnationId,
+  control,
   fontSize = 13
 }) {
   const resolvedTheme = useMemo(
@@ -71,7 +73,9 @@ function TerminalView({
     apiUrl,
     token,
     onData,
-    connectionId
+    connectionId,
+    incarnationId,
+    control
   });
   useEffect(() => {
     if (!containerRef.current) return;

package/dist/{chunk-KEYPUGS3.js → chunk-7KB22BLB.js}

@@ -37,7 +37,14 @@ function createTerminalConnectionId() {
   }
   return `terminal-${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
 }
-function usePtySession({ apiUrl, token, onData, connectionId: providedConnectionId }) {
+function usePtySession({
+  apiUrl,
+  token,
+  onData,
+  connectionId: providedConnectionId,
+  incarnationId,
+  control
+}) {
   const [isConnected, setIsConnected] = useState(false);
   const [error, setError] = useState(null);
   const sessionIdRef = useRef(null);
@@ -48,6 +55,11 @@ function usePtySession({ apiUrl, token, onData, connectionId: providedConnection
   const mountedRef = useRef(true);
   const onDataRef = useRef(onData);
   const tokenRef = useRef(token);
+  const incarnationIdRef = useRef(incarnationId);
+  const controlRef = useRef(control);
+  const exactAttachRequiredRef = useRef(
+    incarnationId !== void 0 || control !== void 0
+  );
   const connectStreamRef = useRef(null);
   const reconnectRef = useRef(null);
   const shouldDeleteSessionRef = useRef(false);
@@ -177,8 +189,17 @@ function usePtySession({ apiUrl, token, onData, connectionId: providedConnection
         pendingWsRef.current = null;
         if (options.initOnOpen) {
           try {
+            const initIncarnationId = incarnationIdRef.current;
+            const initControl = controlRef.current;
+            if (exactAttachRequiredRef.current && (!initIncarnationId || !initControl)) {
+              throw new Error(
+                "Interactive terminal identity is incomplete"
+              );
+            }
             ws.send(JSON.stringify({
               type: "init",
+              ...initIncarnationId !== void 0 ? { incarnationId: initIncarnationId } : {},
+              ...initControl !== void 0 ? { control: initControl } : {},
               cols: colsRef.current,
               rows: rowsRef.current
             }));
@@ -267,6 +288,11 @@ function usePtySession({ apiUrl, token, onData, connectionId: providedConnection
     });
   }, [apiUrl]);
   const connectStream = useCallback(async (sessionId) => {
+    if (exactAttachRequiredRef.current) {
+      throw new Error(
+        "Interactive terminal requires an exact WebSocket attachment"
+      );
+    }
     abortStream();
     setError(null);
     try {
@@ -354,12 +380,19 @@ function usePtySession({ apiUrl, token, onData, connectionId: providedConnection
   }, [apiUrl, abortStream]);
   onDataRef.current = onData;
   tokenRef.current = token;
+  incarnationIdRef.current = incarnationId;
+  controlRef.current = control;
+  exactAttachRequiredRef.current = incarnationId !== void 0 || control !== void 0;
   connectStreamRef.current = connectStream;
   const connect = useCallback(async () => {
     cleanup();
     const myGen = ++connectGenRef.current;
     retryCountRef.current = 0;
     setError(null);
+    if (exactAttachRequiredRef.current && (!incarnationIdRef.current || !controlRef.current)) {
+      setError("Interactive terminal identity is incomplete");
+      return;
+    }
     try {
       const connectionId = providedConnectionId ?? createTerminalConnectionId();
       if (!mountedRef.current) return;
@@ -373,6 +406,11 @@ function usePtySession({ apiUrl, token, onData, connectionId: providedConnection
       if (directWsOk) {
         return;
       }
+      if (exactAttachRequiredRef.current) {
+        throw new Error(
+          "Interactive terminal WebSocket attach failed; exact identity was not accepted"
+        );
+      }
       sessionIdRef.current = null;
       transportReadyRef.current = false;
       if (inputAbortRef.current) {
@@ -434,6 +472,11 @@ function usePtySession({ apiUrl, token, onData, connectionId: providedConnection
         console.warn("Terminal resize over WS failed; falling back to HTTP", err);
       }
     }
+    if (exactAttachRequiredRef.current) {
+      throw new Error(
+        "Interactive terminal is not attached with its exact identity"
+      );
+    }
     try {
       const res = await fetch(`${apiUrl}/terminals/${sid}`, {
         method: "PATCH",
@@ -469,6 +512,16 @@ function usePtySession({ apiUrl, token, onData, connectionId: providedConnection
         }
         continue;
       }
+      if (exactAttachRequiredRef.current) {
+        for (const w of batch.waiters) {
+          w.reject(
+            new Error(
+              "Interactive terminal is not attached with its exact identity"
+            )
+          );
+        }
+        continue;
+      }
       try {
         const res = await fetch(`${apiUrl}/terminals/${sid}/input`, {
           method: "POST",

package/dist/{chunk-K5RMJOH6.js → chunk-NAWEV5UJ.js}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-K4Q4E7D7.js";
 import {
   TerminalView
-} from "./chunk-WYMAC3T3.js";
+} from "./chunk-4VLVVKQZ.js";
 import {
   cn
 } from "./chunk-EI44GEQ5.js";

package/dist/hooks.d.ts

@@ -1,11 +1,11 @@
 export { AgentStreamEvent, AppendUserMessageOptions, ApplySdkEventOptions, AuthUser, AutomationStreamEvent, BeginAssistantMessageOptions, BotStreamEvent, CompleteAssistantMessageOptions, ConnectionState, RealtimeSessionOptions, RealtimeSessionRegistry, RealtimeSessionRegistryProps, RealtimeSessionState, RealtimeSessionTarget, SSEEvent, SdkSessionAttachment, SdkSessionEvent, SdkSessionSeed, TaskStreamEvent, TerminalStreamEvent, UseAuthOptions, UseAuthResult, UseRunGroupsOptions, UseSSEStreamOptions, UseSSEStreamResult, UseSdkSessionOptions, UseSdkSessionReturn, UseToolCallStreamReturn, createAuthFetcher, useApiKey, useAuth, useAutoScroll, useDropdownMenu, useLiveTime, useRealtimeSession, useRunCollapseState, useRunGroups, useSSEStream, useSdkSession, useToolCallStream } from '@tangle-network/ui/hooks';
+import { AgentInteractiveSessionControlClaim } from '@tangle-network/agent-interface';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { Session } from './types.js';
 export { e as SESSION_STREAM_RECONNECT_DELAY_MS, f as SendMessageOptions, S as SessionInfo, g as SessionStreamError, a as SidecarAuth, U as UseSessionStreamOptions, b as UseSessionStreamResult, c as UseSidecarAuthOptions, u as useSessionStream, d as useSidecarAuth } from './sdk-hooks-Cjt_Wq7g.js';
 import '@tangle-network/ui/types';
 import '@tangle-network/ui/stores';
 import '@tangle-network/ui/sdk-hooks';
-import '@tangle-network/agent-interface';
 
 interface UsePtySessionOptions {
     /** Base URL of the sidecar (e.g. "http://localhost:9100"). */
@@ -22,6 +22,13 @@ interface UsePtySessionOptions {
      * so the session does not survive a remount.
      */
     connectionId?: string;
+    /**
+     * Exact incarnation issued for an interactive agent session. When present,
+     * it must be sent with `control` on every WebSocket init frame.
+     */
+    incarnationId?: string;
+    /** Write claim for the exact interactive agent session. */
+    control?: AgentInteractiveSessionControlClaim;
 }
 interface UsePtySessionReturn {
     /** Whether the underlying transport is connected and receiving data. */
@@ -58,7 +65,7 @@ interface UsePtySessionReturn {
  * preserved as a fallback so the hook keeps working against
  * deployments that have not yet shipped the WS endpoint.
  */
-declare function usePtySession({ apiUrl, token, onData, connectionId: providedConnectionId }: UsePtySessionOptions): UsePtySessionReturn;
+declare function usePtySession({ apiUrl, token, onData, connectionId: providedConnectionId, incarnationId, control, }: UsePtySessionOptions): UsePtySessionReturn;
 
 /**
  * Sandbox-level telemetry collected by the sidecar from cgroup v2

package/dist/hooks.js

@@ -26,7 +26,7 @@ import {
 } from "./chunk-3GX5BSD4.js";
 import {
   usePtySession
-} from "./chunk-KEYPUGS3.js";
+} from "./chunk-7KB22BLB.js";
 import "./chunk-CZ7CSFO4.js";
 export {
   RealtimeSessionRegistry,

package/dist/index.js

@@ -153,7 +153,7 @@ import {
   buildUnifiedPatch,
   computeDiffStats,
   resolveLanguage
-} from "./chunk-K5RMJOH6.js";
+} from "./chunk-NAWEV5UJ.js";
 import {
   FileArtifactPane,
   FilePreview,
@@ -238,10 +238,10 @@ import {
   UsageChart,
   formatPrice
 } from "./chunk-OMUIPJQZ.js";
-import "./chunk-WYMAC3T3.js";
+import "./chunk-4VLVVKQZ.js";
 import {
   usePtySession
-} from "./chunk-KEYPUGS3.js";
+} from "./chunk-7KB22BLB.js";
 import {
   Avatar,
   AvatarFallback,

package/dist/terminal.d.ts

@@ -1,4 +1,5 @@
 import * as React from 'react';
+import { AgentInteractiveSessionControlClaim } from '@tangle-network/agent-interface';
 
 interface TerminalTheme {
     background: string;
@@ -52,8 +53,12 @@ interface TerminalViewProps {
      * session per mount.
      */
     connectionId?: string;
+    /** Exact incarnation issued for an interactive agent session. */
+    incarnationId?: string;
+    /** Write claim for the exact interactive agent session. */
+    control?: AgentInteractiveSessionControlClaim;
 }
 declare const DEFAULT_TERMINAL_THEME: TerminalTheme;
-declare function TerminalView({ apiUrl, token, theme, title, subtitle, isActive, connectionId, fontSize, }: TerminalViewProps): React.JSX.Element;
+declare function TerminalView({ apiUrl, token, theme, title, subtitle, isActive, connectionId, incarnationId, control, fontSize, }: TerminalViewProps): React.JSX.Element;
 
 export { DEFAULT_TERMINAL_THEME, type TerminalTheme, TerminalView, type TerminalViewProps };

package/dist/terminal.js

@@ -1,8 +1,8 @@
 import {
   DEFAULT_TERMINAL_THEME,
   TerminalView
-} from "./chunk-WYMAC3T3.js";
-import "./chunk-KEYPUGS3.js";
+} from "./chunk-4VLVVKQZ.js";
+import "./chunk-7KB22BLB.js";
 import "./chunk-CZ7CSFO4.js";
 export {
   DEFAULT_TERMINAL_THEME,

package/dist/workbench.js

@@ -12,12 +12,12 @@ import {
   buildUnifiedPatch,
   computeDiffStats,
   resolveLanguage
-} from "./chunk-K5RMJOH6.js";
+} from "./chunk-NAWEV5UJ.js";
 import "./chunk-PZVUIUUW.js";
 import "./chunk-K4Q4E7D7.js";
 import "./chunk-OMUIPJQZ.js";
-import "./chunk-WYMAC3T3.js";
-import "./chunk-KEYPUGS3.js";
+import "./chunk-4VLVVKQZ.js";
+import "./chunk-7KB22BLB.js";
 import "./chunk-2XPJ2XF7.js";
 import "./chunk-RQZRXKMR.js";
 import "./chunk-BGVEHENC.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/sandbox-ui",
-  "version": "0.104.0",
+  "version": "0.104.1",
   "description": "Unified UI component library for Tangle Sandbox — primitives, chat, dashboard, terminal, editor, and workspace components",
   "repository": {
     "type": "git",