@tangle-network/agent-app 0.43.1 → 0.43.3

package/dist/sandbox-terminal-BIIC__CP.d.ts

@@ -0,0 +1,46 @@
+interface SandboxTerminalConnection {
+    runtimeUrl: string | null;
+    sidecarUrl: string | null;
+    token: string | null;
+    expiresAt: string | null;
+    status: string;
+    error: string | null;
+    loading: boolean;
+    sandboxId?: string;
+}
+interface SandboxTerminalConnectionResponse {
+    runtimeUrl?: string;
+    sidecarUrl?: string;
+    token?: string;
+    expiresAt?: string;
+    status?: string;
+    error?: string;
+    sandboxId?: string;
+}
+interface UseSandboxTerminalConnectionOptions {
+    workspaceId: string;
+    connectionUrl?: string | ((workspaceId: string) => string);
+    fetcher?: typeof fetch;
+    provisionPollIntervalMs?: number;
+    provisionPollTimeoutMs?: number;
+    tokenRefreshSkewMs?: number;
+}
+interface UseSandboxTerminalConnectionResult extends SandboxTerminalConnection {
+    connect: () => Promise<void>;
+}
+declare function useSandboxTerminalConnection(opts: UseSandboxTerminalConnectionOptions): UseSandboxTerminalConnectionResult;
+/**
+ * Stable-per-tab, unique-per-client terminal connection id.
+ *
+ * Persists in `sessionStorage` so a reload in the same tab reuses the id (the
+ * sidecar restores the same PTY session via `TerminalView.connectionId`), while
+ * separate tabs/windows each get a distinct id. Pass the result as
+ * `TerminalView`'s `connectionId`. Without it (e.g. gtm-agent today) every tab
+ * shares one connection id and their reconnects evict each other.
+ *
+ * Falls back to an ephemeral id when `sessionStorage` is unavailable (SSR,
+ * privacy mode) — still unique per call, just not reload-stable.
+ */
+declare function tabTerminalConnectionId(storageKey?: string): string;
+
+export { type SandboxTerminalConnection as S, type UseSandboxTerminalConnectionOptions as U, type SandboxTerminalConnectionResponse as a, type UseSandboxTerminalConnectionResult as b, tabTerminalConnectionId as t, useSandboxTerminalConnection as u };

package/dist/teams-react/index.js

@@ -1,12 +1,12 @@
+import {
+  InvitationsPanel
+} from "../chunk-7C64WKAH.js";
 import {
   InviteAcceptPage
 } from "../chunk-VCPZ3HTN.js";
 import {
   MembersPanel
 } from "../chunk-GNL3MG5J.js";
-import {
-  InvitationsPanel
-} from "../chunk-7C64WKAH.js";
 import "../chunk-63CE7FEZ.js";
 export {
   InvitationsPanel,

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

@@ -1,8 +1,8 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { ComposerFile as ComposerFile$1 } from '@tangle-network/sandbox-ui/chat';
 import { S as StepAgentActivity } from '../agent-activity-C8ZG0F0M.js';
 import { a as FlowTrace } from '../flow-types-Cb_AblZs.js';
+export { S as SandboxTerminalConnection, a as SandboxTerminalConnectionResponse, U as UseSandboxTerminalConnectionOptions, b as UseSandboxTerminalConnectionResult, t as tabTerminalConnectionId, u as useSandboxTerminalConnection } from '../sandbox-terminal-BIIC__CP.js';
 import { C as CatalogModel } from '../model-catalog-BEAEVDaa.js';
 import { Harness } from '../harness/index.js';
 import '@tangle-network/agent-interface';
@@ -80,8 +80,15 @@ interface StreamChatOptions {
  */
 declare function streamChatTurn(opts: StreamChatOptions): Promise<ConsumeChatStreamResult>;
 
-/** Re-exported from sandbox-ui — the staged-attachment chip shape. */
-type ComposerFile = ComposerFile$1;
+interface ComposerFile {
+    id: string;
+    name: string;
+    size?: number;
+    kind: 'file' | 'folder';
+    /** Number of files inside, for a folder chip. */
+    fileCount?: number;
+    status: 'pending' | 'uploading' | 'ready' | 'error';
+}
 interface ChatComposerProps {
     /** Send the trimmed, non-empty message. Attached files travel separately via
      *  `onAttach` + `pendingFiles` (the host consumes and clears them on send). */
@@ -89,7 +96,8 @@ interface ChatComposerProps {
     /** Stop the in-flight turn; shown in place of Send while `isStreaming`. */
     onCancel?: () => void;
     isStreaming?: boolean;
-    /** Block input + send (e.g. while restoring). */
+    /** Block input + send (e.g. while restoring). Distinct from `isStreaming`,
+     *  which keeps the textarea editable so the next turn can be composed. */
     disabled?: boolean;
     placeholder?: string;
     /** Controlled value. Omit for self-managed internal state (cleared on send). */
@@ -97,13 +105,10 @@ interface ChatComposerProps {
     onValueChange?: (value: string) => void;
     /** Initial text in uncontrolled mode; ignored when `value` is provided. */
     initialValue?: string;
-    /** Inline controls (e.g. `<AgentSessionControls/>`), rendered in the control row. */
+    /** Inline controls (e.g. `<ModelPicker/>` + `<EffortPicker/>` or
+     *  `<AgentSessionControls/>`). Rendered in a row above the input by default. */
     controls?: ReactNode;
-    /**
-     * @deprecated The composer renders a single control row; this no longer moves
-     * the controls above the input. Retained for API compatibility.
-     */
-    controlsPlacement?: "above" | "footer";
+    controlsPlacement?: 'above' | 'footer';
     /** Attachments are opt-in: pass `onAttach` to show the attach button, accept
      *  drag-and-drop onto the input, and render `pendingFiles` chips. */
     onAttach?: (files: FileList) => void;
@@ -115,11 +120,11 @@ interface ChatComposerProps {
     dropDescription?: string;
     /** Cmd/Ctrl+L focuses the input and shows the hint. Default true. */
     focusShortcut?: boolean;
-    /** Send button label (aria/title; the button is an icon). Default "Send". */
+    /** Send button label. Default "Send". */
     sendLabel?: string;
     className?: string;
 }
-declare function ChatComposer({ onSend, onCancel, isStreaming, disabled, placeholder, value, onValueChange, initialValue, controls, onAttach, onAttachFolder, pendingFiles, onRemoveFile, accept, dropTitle, dropDescription, focusShortcut, sendLabel, className, }: ChatComposerProps): react.JSX.Element;
+declare function ChatComposer({ onSend, onCancel, isStreaming, disabled, placeholder, value, onValueChange, initialValue, controls, controlsPlacement, onAttach, onAttachFolder, pendingFiles, onRemoveFile, accept, dropTitle, dropDescription, focusShortcut, sendLabel, className, }: ChatComposerProps): react.JSX.Element;
 
 /**
  * Provider brand marks — real logo path data (simple-icons / SVG Logos, both
@@ -241,95 +246,6 @@ interface AgentActivityPanelProps {
  */
 declare function AgentActivityPanel({ fetchActivity, renderMissionRef, title, emptyLabel }: AgentActivityPanelProps): react.JSX.Element;
 
-interface SandboxTerminalConnection {
-    runtimeUrl: string | null;
-    sidecarUrl: string | null;
-    token: string | null;
-    expiresAt: string | null;
-    status: string;
-    error: string | null;
-    loading: boolean;
-    sandboxId?: string;
-}
-interface SandboxTerminalConnectionResponse {
-    runtimeUrl?: string;
-    sidecarUrl?: string;
-    token?: string;
-    expiresAt?: string;
-    status?: string;
-    error?: string;
-    sandboxId?: string;
-}
-interface UseSandboxTerminalConnectionOptions {
-    workspaceId: string;
-    connectionUrl?: string | ((workspaceId: string) => string);
-    fetcher?: typeof fetch;
-    provisionPollIntervalMs?: number;
-    provisionPollTimeoutMs?: number;
-    tokenRefreshSkewMs?: number;
-}
-interface UseSandboxTerminalConnectionResult extends SandboxTerminalConnection {
-    connect: () => Promise<void>;
-}
-declare function useSandboxTerminalConnection(opts: UseSandboxTerminalConnectionOptions): UseSandboxTerminalConnectionResult;
-/**
- * Stable-per-tab, unique-per-client terminal connection id.
- *
- * Persists in `sessionStorage` so a reload in the same tab reuses the id (the
- * sidecar restores the same PTY session via `TerminalView.connectionId`), while
- * separate tabs/windows each get a distinct id. Pass the result as
- * `TerminalView`'s `connectionId`. Without it (e.g. gtm-agent today) every tab
- * shares one connection id and their reconnects evict each other.
- *
- * Falls back to an ephemeral id when `sessionStorage` is unavailable (SSR,
- * privacy mode) — still unique per call, just not reload-stable.
- */
-declare function tabTerminalConnectionId(storageKey?: string): string;
-
-/**
- * `WorkspaceTerminalPanel` — the shared sandbox-terminal surface: a header with
- * a status badge, connect/provisioning/error states with a retry, and the lazy
- * `TerminalView` (from `@tangle-network/sandbox-ui`) mounted only once the
- * connection is live. creative-agent and gtm-agent each hand-roll a structurally
- * identical panel; only the copy and the status-tone map are app-specific, so
- * those are props and everything else lives here.
- *
- * Pair it with {@link useSandboxTerminalConnection} (the `connection` prop) and
- * {@link tabTerminalConnectionId} (the `connectionId` prop) so reloads restore
- * the same PTY and separate tabs don't evict each other.
- *
- * Styling matches the rest of `web-react`: Tailwind over the shared design
- * tokens; glyphs inline; no icon/UI library.
- */
-
-type TerminalStatusTone = 'idle' | 'connecting' | 'connected' | 'error';
-interface TerminalStatusDisplay {
-    tone: TerminalStatusTone;
-    label: string;
-}
-interface WorkspaceTerminalPanelProps {
-    /** Live connection state (from {@link useSandboxTerminalConnection}). */
-    connection: SandboxTerminalConnection;
-    /** Stable per-tab id (from {@link tabTerminalConnectionId}) so the sidecar
-     *  restores the same PTY across remounts and tabs don't collide. */
-    connectionId?: string;
-    /** Header title. Default "Terminal". */
-    title?: string;
-    /** Header subtitle / sandbox label. */
-    subtitle?: string;
-    /** Whether the terminal tab is visible (forwarded to `TerminalView` for fit). */
-    isActive?: boolean;
-    /** Reconnect handler — wire to the hook's `connect`. Shown on idle/error. */
-    onRetry?: () => void;
-    /** Map a `connection.status` to a badge tone + label. The default covers
-     *  idle/provisioning/running/error; override for app-specific vocabulary. */
-    statusDisplay?: (connection: SandboxTerminalConnection) => TerminalStatusDisplay;
-    /** Extra header content, right-aligned (actions, sandbox id, …). */
-    headerExtra?: ReactNode;
-    className?: string;
-}
-declare function WorkspaceTerminalPanel({ connection, connectionId, title, subtitle, isActive, onRetry, statusDisplay, headerExtra, className, }: WorkspaceTerminalPanelProps): ReactNode;
-
 /**
  * `SeatPaywall` — the shared "unlock this product" screen every agent app
  * shows when a user has no active seat and has spent past the free tier. One
@@ -639,4 +555,4 @@ declare function useThinkingSeconds(active: boolean): number;
  */
 declare function ChatMessages({ messages, models, renderMarkdown, renderExtras, userLabel, agentLabel, loading, approval, onToolCallClick, toolRenderers, error, onRetry, renderEmpty, emptyState, header, }: ChatMessagesProps): react.JSX.Element;
 
-export { type ActivityTone, type AgentActivityPage, AgentActivityPanel, type AgentActivityPanelProps, type AgentActivityRecord, AgentSessionControls, type AgentSessionControlsProps, CatalogModel, ChatComposer, type ChatComposerProps, type ChatEmptyDoor, ChatEmptyState, type ChatEmptyStateProps, type ChatMessageMetrics, type ChatMessageSegment, ChatMessages, type ChatMessagesProps, type ChatStreamCallbacks, type ChatStreamToolCall, type ChatStreamToolResult, type ChatToolCallInfo, type ChatUiMessage, type ComposerFile, type ConsumeChatStreamResult, DEFAULT_EFFORT_LEVELS, type EffortLevel, EffortPicker, type EffortPickerProps, FlowWaterfall, type FlowWaterfallProps, MissionActivityLane, type MissionActivityLaneProps, ModelPicker, type ModelPickerProps, type ProposalApprovalHandlers, ProviderLogo, type ProviderLogoProps, RunDrillIn, type RunDrillInProps, type SandboxTerminalConnection, type SandboxTerminalConnectionResponse, SeatPaywall, type SeatPaywallProps, type SmoothRevealOptions, type StreamChatOptions, type TerminalStatusDisplay, type TerminalStatusTone, type ToolDetailRenderers, type ToolRunRecord, type ToolRunStep, type UseSandboxTerminalConnectionOptions, type UseSandboxTerminalConnectionResult, type WaterfallRow, WorkspaceTerminalPanel, type WorkspaceTerminalPanelProps, activityTone, consumeChatStream, dispatchChatStreamLine, formatActivityCost, formatActivityDuration, formatModelCost, formatTokensPerSecond, mergeActivityPages, nextRevealCount, pendingApprovalOf, streamChatTurn, tabTerminalConnectionId, usePending, usePopover, useSandboxTerminalConnection, useSmoothText, useThinkingSeconds, waterfallLayout };
+export { type ActivityTone, type AgentActivityPage, AgentActivityPanel, type AgentActivityPanelProps, type AgentActivityRecord, AgentSessionControls, type AgentSessionControlsProps, CatalogModel, ChatComposer, type ChatComposerProps, type ChatEmptyDoor, ChatEmptyState, type ChatEmptyStateProps, type ChatMessageMetrics, type ChatMessageSegment, ChatMessages, type ChatMessagesProps, type ChatStreamCallbacks, type ChatStreamToolCall, type ChatStreamToolResult, type ChatToolCallInfo, type ChatUiMessage, type ComposerFile, type ConsumeChatStreamResult, DEFAULT_EFFORT_LEVELS, type EffortLevel, EffortPicker, type EffortPickerProps, FlowWaterfall, type FlowWaterfallProps, MissionActivityLane, type MissionActivityLaneProps, ModelPicker, type ModelPickerProps, type ProposalApprovalHandlers, ProviderLogo, type ProviderLogoProps, RunDrillIn, type RunDrillInProps, SeatPaywall, type SeatPaywallProps, type SmoothRevealOptions, type StreamChatOptions, type ToolDetailRenderers, type ToolRunRecord, type ToolRunStep, type WaterfallRow, activityTone, consumeChatStream, dispatchChatStreamLine, formatActivityCost, formatActivityDuration, formatModelCost, formatTokensPerSecond, mergeActivityPages, nextRevealCount, pendingApprovalOf, streamChatTurn, usePending, usePopover, useSmoothText, useThinkingSeconds, waterfallLayout };

package/dist/web-react/index.js

@@ -12,7 +12,6 @@ import {
   ProviderLogo,
   RunDrillIn,
   SeatPaywall,
-  WorkspaceTerminalPanel,
   activityTone,
   consumeChatStream,
   dispatchChatStreamLine,
@@ -24,14 +23,16 @@ import {
   nextRevealCount,
   pendingApprovalOf,
   streamChatTurn,
-  tabTerminalConnectionId,
   usePending,
   usePopover,
-  useSandboxTerminalConnection,
   useSmoothText,
   useThinkingSeconds,
   waterfallLayout
-} from "../chunk-7DPQ5VWR.js";
+} from "../chunk-VKHB7VP4.js";
+import {
+  tabTerminalConnectionId,
+  useSandboxTerminalConnection
+} from "../chunk-65P3HJY3.js";
 import "../chunk-2QI7XV2T.js";
 import "../chunk-E7QYOOON.js";
 export {
@@ -48,7 +49,6 @@ export {
   ProviderLogo,
   RunDrillIn,
   SeatPaywall,
-  WorkspaceTerminalPanel,
   activityTone,
   consumeChatStream,
   dispatchChatStreamLine,

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

@@ -0,0 +1,49 @@
+import { S as SandboxTerminalConnection } from '../sandbox-terminal-BIIC__CP.js';
+export { a as SandboxTerminalConnectionResponse, U as UseSandboxTerminalConnectionOptions, b as UseSandboxTerminalConnectionResult, t as tabTerminalConnectionId, u as useSandboxTerminalConnection } from '../sandbox-terminal-BIIC__CP.js';
+import { ReactNode } from 'react';
+
+/**
+ * `WorkspaceTerminalPanel` — the shared sandbox-terminal surface: a header with
+ * a status badge, connect/provisioning/error states with a retry, and the lazy
+ * `TerminalView` (from `@tangle-network/sandbox-ui`) mounted only once the
+ * connection is live. creative-agent and gtm-agent each hand-roll a structurally
+ * identical panel; only the copy and the status-tone map are app-specific, so
+ * those are props and everything else lives here.
+ *
+ * Pair it with {@link useSandboxTerminalConnection} (the `connection` prop) and
+ * {@link tabTerminalConnectionId} (the `connectionId` prop) so reloads restore
+ * the same PTY and separate tabs don't evict each other.
+ *
+ * Styling matches the rest of `web-react`: Tailwind over the shared design
+ * tokens; glyphs inline; no icon/UI library.
+ */
+
+type TerminalStatusTone = 'idle' | 'connecting' | 'connected' | 'error';
+interface TerminalStatusDisplay {
+    tone: TerminalStatusTone;
+    label: string;
+}
+interface WorkspaceTerminalPanelProps {
+    /** Live connection state (from {@link useSandboxTerminalConnection}). */
+    connection: SandboxTerminalConnection;
+    /** Stable per-tab id (from {@link tabTerminalConnectionId}) so the sidecar
+     *  restores the same PTY across remounts and tabs don't collide. */
+    connectionId?: string;
+    /** Header title. Default "Terminal". */
+    title?: string;
+    /** Header subtitle / sandbox label. */
+    subtitle?: string;
+    /** Whether the terminal tab is visible (forwarded to `TerminalView` for fit). */
+    isActive?: boolean;
+    /** Reconnect handler — wire to the hook's `connect`. Shown on idle/error. */
+    onRetry?: () => void;
+    /** Map a `connection.status` to a badge tone + label. The default covers
+     *  idle/provisioning/running/error; override for app-specific vocabulary. */
+    statusDisplay?: (connection: SandboxTerminalConnection) => TerminalStatusDisplay;
+    /** Extra header content, right-aligned (actions, sandbox id, …). */
+    headerExtra?: ReactNode;
+    className?: string;
+}
+declare function WorkspaceTerminalPanel({ connection, connectionId, title, subtitle, isActive, onRetry, statusDisplay, headerExtra, className, }: WorkspaceTerminalPanelProps): ReactNode;
+
+export { SandboxTerminalConnection, type TerminalStatusDisplay, type TerminalStatusTone, WorkspaceTerminalPanel, type WorkspaceTerminalPanelProps };

package/dist/web-react/terminal.js

@@ -0,0 +1,95 @@
+import {
+  tabTerminalConnectionId,
+  useSandboxTerminalConnection
+} from "../chunk-65P3HJY3.js";
+
+// src/web-react/workspace-terminal-panel.tsx
+import { lazy, Suspense } from "react";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+var TerminalView = lazy(
+  () => import("@tangle-network/sandbox-ui/terminal").then((m) => ({ default: m.TerminalView }))
+);
+var TONE_DOT = {
+  idle: "bg-muted-foreground/50",
+  connecting: "animate-pulse bg-warning",
+  connected: "bg-success",
+  error: "bg-destructive"
+};
+function defaultStatusDisplay(conn) {
+  if (conn.error) return { tone: "error", label: "Disconnected" };
+  if (conn.runtimeUrl && conn.token) return { tone: "connected", label: "Connected" };
+  if (conn.loading) return { tone: "connecting", label: conn.status === "provisioning" ? "Provisioning\u2026" : "Connecting\u2026" };
+  return { tone: "idle", label: "Idle" };
+}
+function WorkspaceTerminalPanel({
+  connection,
+  connectionId,
+  title = "Terminal",
+  subtitle,
+  isActive,
+  onRetry,
+  statusDisplay,
+  headerExtra,
+  className
+}) {
+  const status = (statusDisplay ?? defaultStatusDisplay)(connection);
+  const apiUrl = connection.runtimeUrl ?? connection.sidecarUrl;
+  const ready = Boolean(apiUrl && connection.token);
+  return /* @__PURE__ */ jsxs("div", { className: `flex h-full min-h-0 flex-col overflow-hidden rounded-xl border border-border bg-card ${className ?? ""}`, children: [
+    /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between gap-3 border-b border-border px-4 py-2.5", children: [
+      /* @__PURE__ */ jsxs("div", { className: "min-w-0", children: [
+        /* @__PURE__ */ jsx("p", { className: "truncate text-sm font-medium text-foreground", children: title }),
+        subtitle && /* @__PURE__ */ jsx("p", { className: "truncate text-xs text-muted-foreground", children: subtitle })
+      ] }),
+      /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2", children: [
+        /* @__PURE__ */ jsxs("span", { className: "flex items-center gap-1.5 text-xs text-muted-foreground", children: [
+          /* @__PURE__ */ jsx("span", { className: `h-1.5 w-1.5 rounded-full ${TONE_DOT[status.tone]}`, "aria-hidden": true }),
+          status.label
+        ] }),
+        headerExtra
+      ] })
+    ] }),
+    /* @__PURE__ */ jsx("div", { className: "relative min-h-0 flex-1", children: ready ? /* @__PURE__ */ jsx(Suspense, { fallback: /* @__PURE__ */ jsx(TerminalMessage, { children: "Loading terminal\u2026" }), children: /* @__PURE__ */ jsx(
+      TerminalView,
+      {
+        apiUrl,
+        token: connection.token,
+        connectionId,
+        title,
+        subtitle,
+        isActive
+      }
+    ) }) : /* @__PURE__ */ jsx(TerminalMessage, { children: connection.error ? /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx("p", { className: "text-sm text-destructive", children: connection.error }),
+      onRetry && /* @__PURE__ */ jsx(
+        "button",
+        {
+          type: "button",
+          onClick: onRetry,
+          className: "mt-3 inline-flex items-center justify-center rounded-lg border border-border px-3 py-1.5 text-sm font-medium text-foreground transition hover:bg-muted",
+          children: "Reconnect"
+        }
+      )
+    ] }) : connection.loading ? /* @__PURE__ */ jsx("p", { className: "text-sm text-muted-foreground", children: connection.status === "provisioning" ? "Provisioning sandbox\u2026" : "Connecting\u2026" }) : /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx("p", { className: "text-sm text-muted-foreground", children: "Terminal not connected." }),
+      onRetry && /* @__PURE__ */ jsx(
+        "button",
+        {
+          type: "button",
+          onClick: onRetry,
+          className: "mt-3 inline-flex items-center justify-center rounded-lg border border-border px-3 py-1.5 text-sm font-medium text-foreground transition hover:bg-muted",
+          children: "Connect"
+        }
+      )
+    ] }) }) })
+  ] });
+}
+function TerminalMessage({ children }) {
+  return /* @__PURE__ */ jsx("div", { className: "absolute inset-0 flex flex-col items-center justify-center p-6 text-center", children });
+}
+export {
+  WorkspaceTerminalPanel,
+  tabTerminalConnectionId,
+  useSandboxTerminalConnection
+};
+//# sourceMappingURL=terminal.js.map

package/dist/web-react/terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/web-react/workspace-terminal-panel.tsx"],"sourcesContent":["/**\n * `WorkspaceTerminalPanel` — the shared sandbox-terminal surface: a header with\n * a status badge, connect/provisioning/error states with a retry, and the lazy\n * `TerminalView` (from `@tangle-network/sandbox-ui`) mounted only once the\n * connection is live. creative-agent and gtm-agent each hand-roll a structurally\n * identical panel; only the copy and the status-tone map are app-specific, so\n * those are props and everything else lives here.\n *\n * Pair it with {@link useSandboxTerminalConnection} (the `connection` prop) and\n * {@link tabTerminalConnectionId} (the `connectionId` prop) so reloads restore\n * the same PTY and separate tabs don't evict each other.\n *\n * Styling matches the rest of `web-react`: Tailwind over the shared design\n * tokens; glyphs inline; no icon/UI library.\n */\n\nimport { lazy, Suspense, type ReactNode } from 'react'\n\nimport type { SandboxTerminalConnection } from './sandbox-terminal'\n\nconst TerminalView = lazy(() =>\n  import('@tangle-network/sandbox-ui/terminal').then((m) => ({ default: m.TerminalView })),\n)\n\nexport type TerminalStatusTone = 'idle' | 'connecting' | 'connected' | 'error'\n\nexport interface TerminalStatusDisplay {\n  tone: TerminalStatusTone\n  label: string\n}\n\nexport interface WorkspaceTerminalPanelProps {\n  /** Live connection state (from {@link useSandboxTerminalConnection}). */\n  connection: SandboxTerminalConnection\n  /** Stable per-tab id (from {@link tabTerminalConnectionId}) so the sidecar\n   *  restores the same PTY across remounts and tabs don't collide. */\n  connectionId?: string\n  /** Header title. Default \"Terminal\". */\n  title?: string\n  /** Header subtitle / sandbox label. */\n  subtitle?: string\n  /** Whether the terminal tab is visible (forwarded to `TerminalView` for fit). */\n  isActive?: boolean\n  /** Reconnect handler — wire to the hook's `connect`. Shown on idle/error. */\n  onRetry?: () => void\n  /** Map a `connection.status` to a badge tone + label. The default covers\n   *  idle/provisioning/running/error; override for app-specific vocabulary. */\n  statusDisplay?: (connection: SandboxTerminalConnection) => TerminalStatusDisplay\n  /** Extra header content, right-aligned (actions, sandbox id, …). */\n  headerExtra?: ReactNode\n  className?: string\n}\n\nconst TONE_DOT: Record<TerminalStatusTone, string> = {\n  idle: 'bg-muted-foreground/50',\n  connecting: 'animate-pulse bg-warning',\n  connected: 'bg-success',\n  error: 'bg-destructive',\n}\n\nfunction defaultStatusDisplay(conn: SandboxTerminalConnection): TerminalStatusDisplay {\n  if (conn.error) return { tone: 'error', label: 'Disconnected' }\n  if (conn.runtimeUrl && conn.token) return { tone: 'connected', label: 'Connected' }\n  if (conn.loading) return { tone: 'connecting', label: conn.status === 'provisioning' ? 'Provisioning…' : 'Connecting…' }\n  return { tone: 'idle', label: 'Idle' }\n}\n\nexport function WorkspaceTerminalPanel({\n  connection,\n  connectionId,\n  title = 'Terminal',\n  subtitle,\n  isActive,\n  onRetry,\n  statusDisplay,\n  headerExtra,\n  className,\n}: WorkspaceTerminalPanelProps): ReactNode {\n  const status = (statusDisplay ?? defaultStatusDisplay)(connection)\n  const apiUrl = connection.runtimeUrl ?? connection.sidecarUrl\n  const ready = Boolean(apiUrl && connection.token)\n\n  return (\n    <div className={`flex h-full min-h-0 flex-col overflow-hidden rounded-xl border border-border bg-card ${className ?? ''}`}>\n      <div className=\"flex items-center justify-between gap-3 border-b border-border px-4 py-2.5\">\n        <div className=\"min-w-0\">\n          <p className=\"truncate text-sm font-medium text-foreground\">{title}</p>\n          {subtitle && <p className=\"truncate text-xs text-muted-foreground\">{subtitle}</p>}\n        </div>\n        <div className=\"flex items-center gap-2\">\n          <span className=\"flex items-center gap-1.5 text-xs text-muted-foreground\">\n            <span className={`h-1.5 w-1.5 rounded-full ${TONE_DOT[status.tone]}`} aria-hidden />\n            {status.label}\n          </span>\n          {headerExtra}\n        </div>\n      </div>\n\n      <div className=\"relative min-h-0 flex-1\">\n        {ready ? (\n          <Suspense fallback={<TerminalMessage>Loading terminal…</TerminalMessage>}>\n            <TerminalView\n              apiUrl={apiUrl as string}\n              token={connection.token as string}\n              connectionId={connectionId}\n              title={title}\n              subtitle={subtitle}\n              isActive={isActive}\n            />\n          </Suspense>\n        ) : (\n          <TerminalMessage>\n            {connection.error ? (\n              <>\n                <p className=\"text-sm text-destructive\">{connection.error}</p>\n                {onRetry && (\n                  <button\n                    type=\"button\"\n                    onClick={onRetry}\n                    className=\"mt-3 inline-flex items-center justify-center rounded-lg border border-border px-3 py-1.5 text-sm font-medium text-foreground transition hover:bg-muted\"\n                  >\n                    Reconnect\n                  </button>\n                )}\n              </>\n            ) : connection.loading ? (\n              <p className=\"text-sm text-muted-foreground\">\n                {connection.status === 'provisioning' ? 'Provisioning sandbox…' : 'Connecting…'}\n              </p>\n            ) : (\n              <>\n                <p className=\"text-sm text-muted-foreground\">Terminal not connected.</p>\n                {onRetry && (\n                  <button\n                    type=\"button\"\n                    onClick={onRetry}\n                    className=\"mt-3 inline-flex items-center justify-center rounded-lg border border-border px-3 py-1.5 text-sm font-medium text-foreground transition hover:bg-muted\"\n                  >\n                    Connect\n                  </button>\n                )}\n              </>\n            )}\n          </TerminalMessage>\n        )}\n      </div>\n    </div>\n  )\n}\n\nfunction TerminalMessage({ children }: { children: ReactNode }): ReactNode {\n  return <div className=\"absolute inset-0 flex flex-col items-center justify-center p-6 text-center\">{children}</div>\n}\n"],"mappings":";;;;;;AAgBA,SAAS,MAAM,gBAAgC;AAqEvC,SA4BM,UA3BJ,KADF;AAjER,IAAM,eAAe;AAAA,EAAK,MACxB,OAAO,qCAAqC,EAAE,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE;AACzF;AA+BA,IAAM,WAA+C;AAAA,EACnD,MAAM;AAAA,EACN,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,OAAO;AACT;AAEA,SAAS,qBAAqB,MAAwD;AACpF,MAAI,KAAK,MAAO,QAAO,EAAE,MAAM,SAAS,OAAO,eAAe;AAC9D,MAAI,KAAK,cAAc,KAAK,MAAO,QAAO,EAAE,MAAM,aAAa,OAAO,YAAY;AAClF,MAAI,KAAK,QAAS,QAAO,EAAE,MAAM,cAAc,OAAO,KAAK,WAAW,iBAAiB,uBAAkB,mBAAc;AACvH,SAAO,EAAE,MAAM,QAAQ,OAAO,OAAO;AACvC;AAEO,SAAS,uBAAuB;AAAA,EACrC;AAAA,EACA;AAAA,EACA,QAAQ;AAAA,EACR;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAA2C;AACzC,QAAM,UAAU,iBAAiB,sBAAsB,UAAU;AACjE,QAAM,SAAS,WAAW,cAAc,WAAW;AACnD,QAAM,QAAQ,QAAQ,UAAU,WAAW,KAAK;AAEhD,SACE,qBAAC,SAAI,WAAW,wFAAwF,aAAa,EAAE,IACrH;AAAA,yBAAC,SAAI,WAAU,8EACb;AAAA,2BAAC,SAAI,WAAU,WACb;AAAA,4BAAC,OAAE,WAAU,gDAAgD,iBAAM;AAAA,QAClE,YAAY,oBAAC,OAAE,WAAU,0CAA0C,oBAAS;AAAA,SAC/E;AAAA,MACA,qBAAC,SAAI,WAAU,2BACb;AAAA,6BAAC,UAAK,WAAU,2DACd;AAAA,8BAAC,UAAK,WAAW,4BAA4B,SAAS,OAAO,IAAI,CAAC,IAAI,eAAW,MAAC;AAAA,UACjF,OAAO;AAAA,WACV;AAAA,QACC;AAAA,SACH;AAAA,OACF;AAAA,IAEA,oBAAC,SAAI,WAAU,2BACZ,kBACC,oBAAC,YAAS,UAAU,oBAAC,mBAAgB,oCAAiB,GACpD;AAAA,MAAC;AAAA;AAAA,QACC;AAAA,QACA,OAAO,WAAW;AAAA,QAClB;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA;AAAA,IACF,GACF,IAEA,oBAAC,mBACE,qBAAW,QACV,iCACE;AAAA,0BAAC,OAAE,WAAU,4BAA4B,qBAAW,OAAM;AAAA,MACzD,WACC;AAAA,QAAC;AAAA;AAAA,UACC,MAAK;AAAA,UACL,SAAS;AAAA,UACT,WAAU;AAAA,UACX;AAAA;AAAA,MAED;AAAA,OAEJ,IACE,WAAW,UACb,oBAAC,OAAE,WAAU,iCACV,qBAAW,WAAW,iBAAiB,+BAA0B,oBACpE,IAEA,iCACE;AAAA,0BAAC,OAAE,WAAU,iCAAgC,qCAAuB;AAAA,MACnE,WACC;AAAA,QAAC;AAAA;AAAA,UACC,MAAK;AAAA,UACL,SAAS;AAAA,UACT,WAAU;AAAA,UACX;AAAA;AAAA,MAED;AAAA,OAEJ,GAEJ,GAEJ;AAAA,KACF;AAEJ;AAEA,SAAS,gBAAgB,EAAE,SAAS,GAAuC;AACzE,SAAO,oBAAC,SAAI,WAAU,8EAA8E,UAAS;AAC/G;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-app",
-  "version": "0.43.1",
+  "version": "0.43.3",
   "packageManager": "pnpm@10.33.4",
   "description": "Application-shell framework for Tangle agent products: a bounded tool loop, the structured agent→app tool side channel, integration-hub client, per-workspace billing, and crypto — composed over the Tangle agent substrate through typed seams.",
   "keywords": [
@@ -158,6 +158,11 @@
       "import": "./dist/web-react/index.js",
       "default": "./dist/web-react/index.js"
     },
+    "./web-react/terminal": {
+      "types": "./dist/web-react/terminal.d.ts",
+      "import": "./dist/web-react/terminal.js",
+      "default": "./dist/web-react/terminal.js"
+    },
     "./composer": {
       "types": "./dist/composer/index.d.ts",
       "import": "./dist/composer/index.js",