@tangle-network/sandbox-ui 0.104.1 → 0.105.1

package/dist/chat.d.ts

@@ -60,10 +60,9 @@ declare function ReasoningLevelPicker({ value, onChange, disabled, className, tr
 /**
  * Limits applied when staging files onto a composer.
  *
- * @deprecated Composer-only helper of the legacy AgentComposer. Use
- * ChatComposer from `@tangle-network/agent-app/web-react` — the canonical
- * composer. AgentComposer is frozen and will be removed at sandbox-ui's next
- * breaking release.
+ * Serves {@link AgentComposer}'s attachment lifecycle. `ChatComposer` in
+ * `@tangle-network/agent-app/web-react` stages files without a validation or
+ * retry step, so it has no equivalent.
  */
 interface ComposerFileValidationConfig {
     /** Reject any single file larger than this. */
@@ -81,10 +80,9 @@ interface ComposerFileValidationConfig {
 }
 /** A file that failed validation, paired with a human-readable reason.
  *
- * @deprecated Composer-only helper of the legacy AgentComposer. Use
- * ChatComposer from `@tangle-network/agent-app/web-react` — the canonical
- * composer. AgentComposer is frozen and will be removed at sandbox-ui's next
- * breaking release. */
+ * Serves {@link AgentComposer}'s attachment lifecycle. `ChatComposer` in
+ * `@tangle-network/agent-app/web-react` stages files without a validation or
+ * retry step, so it has no equivalent. */
 interface ComposerFileRejection {
     file: File;
     reason: string;
@@ -94,10 +92,9 @@ interface ComposerFileRejection {
  * grammar as the native `<input accept>` attribute. An undefined or empty
  * `accept` accepts everything.
  *
- * @deprecated Composer-only helper of the legacy AgentComposer. Use
- * ChatComposer from `@tangle-network/agent-app/web-react` — the canonical
- * composer. AgentComposer is frozen and will be removed at sandbox-ui's next
- * breaking release.
+ * Serves {@link AgentComposer}'s attachment lifecycle. `ChatComposer` in
+ * `@tangle-network/agent-app/web-react` stages files without a validation or
+ * retry step, so it has no equivalent.
  */
 declare function isAcceptedType(file: File, accept?: string): boolean;
 /**
@@ -107,10 +104,9 @@ declare function isAcceptedType(file: File, accept?: string): boolean;
  * file and the limit it broke. Pure data in, pure data out — no throwing,
  * no console noise, so callers decide how to surface rejections.
  *
- * @deprecated Composer-only helper of the legacy AgentComposer. Use
- * ChatComposer from `@tangle-network/agent-app/web-react` — the canonical
- * composer. AgentComposer is frozen and will be removed at sandbox-ui's next
- * breaking release.
+ * Serves {@link AgentComposer}'s attachment lifecycle. `ChatComposer` in
+ * `@tangle-network/agent-app/web-react` stages files without a validation or
+ * retry step, so it has no equivalent.
  */
 declare function validateComposerFiles(files: File[] | FileList, config: ComposerFileValidationConfig): {
     accepted: File[];
@@ -120,9 +116,9 @@ declare function validateComposerFiles(files: File[] | FileList, config: Compose
 /** A selectable item in the `@`-mention popover. Generic — file semantics live
  * in the consuming app, not here.
  *
- * @deprecated Part of the legacy AgentComposer API. Use ChatComposer from
- * `@tangle-network/agent-app/web-react` — the canonical composer. AgentComposer
- * is frozen and will be removed at sandbox-ui's next breaking release. */
+ * Part of the {@link AgentComposer} API. `ChatComposer` in
+ * `@tangle-network/agent-app/web-react` has no equivalent — see
+ * {@link AgentComposer} for which composer fits a surface. */
 interface MentionItem {
     id: string;
     label: string;
@@ -134,9 +130,9 @@ interface MentionItem {
  * TipTap rich input that renders mentions as atomic pills; absent ⇒ exactly
  * today's plain-textarea behavior. Data-agnostic: the app supplies items.
  *
- * @deprecated Part of the legacy AgentComposer API. Use ChatComposer from
- * `@tangle-network/agent-app/web-react` — the canonical composer. AgentComposer
- * is frozen and will be removed at sandbox-ui's next breaking release.
+ * Part of the {@link AgentComposer} API. `ChatComposer` in
+ * `@tangle-network/agent-app/web-react` has no equivalent — see
+ * {@link AgentComposer} for which composer fits a surface.
  */
 interface AgentComposerMention {
     /** The character that opens the popover. Default "@". */
@@ -159,9 +155,9 @@ interface AgentComposerMention {
 }
 /** A staged attachment shown as a chip above the input.
  *
- * @deprecated Part of the legacy AgentComposer API. Use ChatComposer from
- * `@tangle-network/agent-app/web-react` — the canonical composer. AgentComposer
- * is frozen and will be removed at sandbox-ui's next breaking release. */
+ * Part of the {@link AgentComposer} API. `ChatComposer` in
+ * `@tangle-network/agent-app/web-react` has no equivalent — see
+ * {@link AgentComposer} for which composer fits a surface. */
 interface ComposerFile {
     id: string;
     name: string;
@@ -181,9 +177,9 @@ interface ComposerFile {
 }
 /** Context the agent will see alongside the next message.
  *
- * @deprecated Part of the legacy AgentComposer API. Use ChatComposer from
- * `@tangle-network/agent-app/web-react` — the canonical composer. AgentComposer
- * is frozen and will be removed at sandbox-ui's next breaking release. */
+ * Part of the {@link AgentComposer} API. `ChatComposer` in
+ * `@tangle-network/agent-app/web-react` has no equivalent — see
+ * {@link AgentComposer} for which composer fits a surface. */
 interface ComposerContextItem {
     id: string;
     label: string;
@@ -192,11 +188,11 @@ interface ComposerContextItem {
     onRemove?: () => void;
 }
 /**
- * Props of the legacy {@link AgentComposer}.
+ * Props of {@link AgentComposer}.
  *
- * @deprecated Part of the legacy AgentComposer API. Use ChatComposer from
- * `@tangle-network/agent-app/web-react` — the canonical composer. AgentComposer
- * is frozen and will be removed at sandbox-ui's next breaking release.
+ * Part of the {@link AgentComposer} API. `ChatComposer` in
+ * `@tangle-network/agent-app/web-react` has no equivalent — see
+ * {@link AgentComposer} for which composer fits a surface.
  */
 interface AgentComposerProps {
     /** Composer text (controlled). */
@@ -288,25 +284,35 @@ interface AgentComposerProps {
     autoFocus?: boolean;
 }
 /**
- * @deprecated Use `ChatComposer` from `@tangle-network/agent-app/web-react` —
- * the canonical composer. It adds send-failure recovery, seeds, control
- * placement, floating elevation, and the circular icon send via
- * `sendVariant="icon"`. Plan a port, not a rename: 14 of the 28 props here
- * have no same-named counterpart there, among them `contextItems`, `mention`,
- * `trailing`, `maxHeight`, `minRows`, and `autoFocus`. The control model also
- * differs — this component requires `value` and `onChange` and calls
- * `onSubmit` with no arguments, while `ChatComposer` can own its draft and
- * gives the message to a refusable `onSend`. This slot-shell is frozen and
- * will be removed at sandbox-ui's next breaking release.
+ * Sibling of `ChatComposer` in `@tangle-network/agent-app/web-react`, not a
+ * predecessor of it. The two composers cover different jobs, and neither is a
+ * superset of the other, so pick by the features a surface needs.
  *
- * The canonical agent chat input: one rounded surface holding an auto-growing
+ * Reach for `AgentComposer` when the surface needs `@`-mentions (`mention`,
+ * backed by a lazily loaded rich-text input that renders mention pills),
+ * `contextItems`, or the full attachment lifecycle — `attachments` plus
+ * `onRejectFiles` and `onRetryFile`. It also owns `autoFocus`,
+ * `canSubmitAttachmentsOnly`, `trailing`, `maxHeight`, and `minRows`.
+ *
+ * Reach for `ChatComposer` when the surface is a plain send box. It owns
+ * send-failure recovery (`onSendFailed`, `sendFailureMessage`), one-shot
+ * prefill (`seed`), `controlsPlacement`, `floating`, `sendVariant`,
+ * parts-aware sends (`onSendParts`), and an uncontrolled mode
+ * (`initialValue`) — none of which exist here.
+ *
+ * Moving between them is a port, not a rename: the control models differ. This
+ * component requires `value` and `onChange` and calls `onSubmit` with no
+ * arguments, while `ChatComposer` can own its draft and hands the message to a
+ * refusable `onSend`.
+ *
+ * The input itself: one rounded surface holding an auto-growing
  * textarea and a bottom row that runs left → right — attach buttons, the
  * control strip (supplied via the required `controls` prop), trailing slot,
  * and the send button on the far right. The strip is explicit: the canonical
  * pickers are `ModelPicker` / `EffortPicker` / `AgentSessionControls` from
  * `@tangle-network/agent-app/web-react` — this component only owns the slot.
  *
- * Opt-in extras make it the superset of every app's hand-rolled composer:
+ * Opt-in extras cover what apps otherwise hand-roll:
  * file/folder attachments with drag-and-drop + chips + clipboard paste
  * (`onAttach` also gates pasting files onto the textarea, auto-naming
  * generic clipboard image blobs `pasted-image-<n>.<ext>`), a streaming Stop
@@ -323,10 +329,9 @@ declare function AgentComposer({ value, onChange, onSubmit, placeholder, disable
  * importing it never pulls the lazily-loaded editor chunk into a consumer's
  * bundle.
  *
- * @deprecated Mention-pill contract of the legacy AgentComposer mention
- * feature. Use ChatComposer from `@tangle-network/agent-app/web-react` — the
- * canonical composer. AgentComposer is frozen and will be removed at
- * sandbox-ui's next breaking release.
+ * Mention-pill contract of {@link AgentComposer}'s mention feature.
+ * `ChatComposer` in `@tangle-network/agent-app/web-react` has no mention
+ * support, so it has no equivalent.
  */
 declare const MENTION_PILL_CLASS: string;
 

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

@@ -3,7 +3,7 @@ import { useState, useEffect, useRef, useCallback } from "react";
 function createEmptyBatch() {
   return { data: "", waiters: [] };
 }
-var WS_OPEN_TIMEOUT_MS = 1e4;
+var WS_READY_TIMEOUT_MS = 1e4;
 function toWsUrl(apiUrl, sessionId) {
   try {
     const base = typeof window !== "undefined" ? window.location.href : void 0;
@@ -64,6 +64,7 @@ function usePtySession({
   const reconnectRef = useRef(null);
   const shouldDeleteSessionRef = useRef(false);
   const transportReadyRef = useRef(false);
+  const protocolFailureRef = useRef(false);
   const colsRef = useRef(DEFAULT_TERMINAL_COLS);
   const rowsRef = useRef(DEFAULT_TERMINAL_ROWS);
   const wsRef = useRef(null);
@@ -169,13 +170,25 @@ function usePtySession({
         resolve(ok);
       };
       const handshakeTimer = setTimeout(() => {
-        if (opened) return;
         try {
           ws.close();
         } catch {
         }
         settle(false);
-      }, WS_OPEN_TIMEOUT_MS);
+      }, WS_READY_TIMEOUT_MS);
+      const failProtocol = (message) => {
+        protocolFailureRef.current = true;
+        transportReadyRef.current = false;
+        if (wsRef.current === ws) wsRef.current = null;
+        setIsConnected(false);
+        setError(message);
+        rejectPendingInput(message);
+        try {
+          ws.close();
+        } catch {
+        }
+        settle(false);
+      };
       ws.onopen = () => {
         opened = true;
         if (pendingWsRef.current !== ws || !mountedRef.current) {
@@ -212,12 +225,8 @@ function usePtySession({
             return;
           }
         }
+        if (protocolFailureRef.current) return;
         wsRef.current = ws;
-        transportReadyRef.current = true;
-        setIsConnected(true);
-        setError(null);
-        retryCountRef.current = 0;
-        settle(true);
       };
       ws.onmessage = (ev) => {
         if (!mountedRef.current) return;
@@ -239,17 +248,38 @@ function usePtySession({
         if (typeof data === "string") {
           try {
             const event = JSON.parse(text);
-            if (event?.type === "ready") {
-              return;
-            }
-            if (event?.type === "error") {
-              const message = typeof event.message === "string" ? event.message : "Terminal WebSocket error";
-              setError(message);
-              return;
-            }
-            if (event?.type === "exit") {
-              setIsConnected(false);
-              return;
+            if (event !== null && typeof event === "object" && !Array.isArray(event)) {
+              const controlFrame = event;
+              switch (controlFrame.type) {
+                case "ready":
+                  transportReadyRef.current = true;
+                  setIsConnected(true);
+                  setError(null);
+                  retryCountRef.current = 0;
+                  settle(true);
+                  return;
+                case "error": {
+                  const message = typeof controlFrame.message === "string" ? controlFrame.message : "Terminal WebSocket error";
+                  if (!transportReadyRef.current) {
+                    failProtocol(message);
+                  } else {
+                    setError(message);
+                  }
+                  return;
+                }
+                case "exit":
+                  transportReadyRef.current = false;
+                  setIsConnected(false);
+                  return;
+                case "rec":
+                case "rec.done":
+                  return;
+                default: {
+                  const frameType = typeof controlFrame.type === "string" ? controlFrame.type : "<missing type>";
+                  failProtocol(`Unknown terminal control frame: ${frameType}`);
+                  return;
+                }
+              }
             }
           } catch {
           }
@@ -263,6 +293,7 @@ function usePtySession({
           pendingWsRef.current = null;
         }
         const wasActive = wsRef.current === ws;
+        const wasReady = wasActive && transportReadyRef.current;
         if (wasActive) {
           wsRef.current = null;
           transportReadyRef.current = false;
@@ -271,7 +302,11 @@ function usePtySession({
           settle(false);
           return;
         }
-        if (!wasActive || !mountedRef.current) return;
+        if (!wasReady) {
+          settle(false);
+          return;
+        }
+        if (protocolFailureRef.current || !wasActive || !mountedRef.current) return;
         setIsConnected(false);
         if (sessionIdRef.current) {
           retryTimerRef.current = setTimeout(() => {
@@ -286,7 +321,7 @@ function usePtySession({
         }
       };
     });
-  }, [apiUrl]);
+  }, [apiUrl, rejectPendingInput]);
   const connectStream = useCallback(async (sessionId) => {
     if (exactAttachRequiredRef.current) {
       throw new Error(
@@ -387,6 +422,7 @@ function usePtySession({
   const connect = useCallback(async () => {
     cleanup();
     const myGen = ++connectGenRef.current;
+    protocolFailureRef.current = false;
     retryCountRef.current = 0;
     setError(null);
     if (exactAttachRequiredRef.current && (!incarnationIdRef.current || !controlRef.current)) {
@@ -402,6 +438,7 @@ function usePtySession({
       inputAbortRef.current = new AbortController();
       const directWsOk = await connectWs(connectionId, { initOnOpen: true });
       if (!mountedRef.current || connectGenRef.current !== myGen) return;
+      if (protocolFailureRef.current) return;
       ensureDrainRunningRef.current?.();
       if (directWsOk) {
         return;
@@ -442,6 +479,7 @@ function usePtySession({
       inputAbortRef.current = new AbortController();
       const wsOk = await connectWs(sessionId, { initOnOpen: true });
       if (!mountedRef.current || connectGenRef.current !== myGen) return;
+      if (protocolFailureRef.current) return;
       ensureDrainRunningRef.current?.();
       if (wsOk) {
         return;
@@ -564,6 +602,10 @@ function usePtySession({
         resolve();
         return;
       }
+      if (protocolFailureRef.current) {
+        reject(new Error("Terminal protocol failure"));
+        return;
+      }
       pendingBatchRef.current.data += command;
       pendingBatchRef.current.waiters.push({ resolve, reject });
       ensureDrainRunning();

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

@@ -1,6 +1,6 @@
 import {
   usePtySession
-} from "./chunk-7KB22BLB.js";
+} from "./chunk-FW77EXKG.js";
 
 // src/terminal/terminal-view.tsx
 import "@xterm/xterm/css/xterm.css";

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

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

package/dist/hooks.d.ts

@@ -51,8 +51,9 @@ interface UsePtySessionReturn {
  *      - Server → client: BINARY frames carrying PTY output; TEXT frames
  *        carrying lifecycle/control messages.
  *      - Client → server: TEXT frames carrying JSON input/resize messages.
- *   2. If direct WS does not reach OPEN within WS_OPEN_TIMEOUT_MS, or it
- *      errors before opening, fall back to the older terminal contract:
+ *   2. If direct WS does not reach server `ready` within
+ *      WS_READY_TIMEOUT_MS, or it errors before ready, fall back to the older
+ *      terminal contract:
  *      - POST /terminals creates the session.
  *      - GET /terminals/:id/ws tries the older WS transport.
  *      - GET /terminals/:id/stream (SSE for output)

package/dist/hooks.js

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

package/dist/index.js

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

package/dist/terminal.js

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

package/dist/workbench.js

@@ -12,12 +12,12 @@ import {
   buildUnifiedPatch,
   computeDiffStats,
   resolveLanguage
-} from "./chunk-NAWEV5UJ.js";
+} from "./chunk-NT6SCOY2.js";
 import "./chunk-PZVUIUUW.js";
 import "./chunk-K4Q4E7D7.js";
 import "./chunk-OMUIPJQZ.js";
-import "./chunk-4VLVVKQZ.js";
-import "./chunk-7KB22BLB.js";
+import "./chunk-MXQT46AZ.js";
+import "./chunk-FW77EXKG.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.1",
+  "version": "0.105.1",
   "description": "Unified UI component library for Tangle Sandbox — primitives, chat, dashboard, terminal, editor, and workspace components",
   "repository": {
     "type": "git",