@tangle-network/agent-app 0.40.0 → 0.41.0

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

@@ -229,6 +229,63 @@ 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
@@ -459,4 +516,4 @@ type ToolDetailRenderers = Record<string, (call: ChatToolCallInfo, message: Chat
  */
 declare function ChatMessages({ messages, models, renderMarkdown, renderExtras, userLabel, agentLabel, loading, approval, onToolCallClick, toolRenderers, error, onRetry, renderEmpty, }: ChatMessagesProps): react.JSX.Element;
 
-export { type ActivityTone, type AgentActivityPage, AgentActivityPanel, type AgentActivityPanelProps, type AgentActivityRecord, AgentSessionControls, type AgentSessionControlsProps, type ChatMessageMetrics, ChatMessages, type ChatMessagesProps, type ChatStreamCallbacks, type ChatStreamToolCall, type ChatStreamToolResult, type ChatToolCallInfo, type ChatUiMessage, type ConsumeChatStreamResult, 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 ToolDetailRenderers, type ToolRunRecord, type ToolRunStep, type UseSandboxTerminalConnectionOptions, type UseSandboxTerminalConnectionResult, type WaterfallRow, activityTone, consumeChatStream, dispatchChatStreamLine, formatActivityCost, formatActivityDuration, formatModelCost, formatTokensPerSecond, mergeActivityPages, nextRevealCount, pendingApprovalOf, streamChatTurn, usePending, usePopover, useSandboxTerminalConnection, useSmoothText, waterfallLayout };
+export { type ActivityTone, type AgentActivityPage, AgentActivityPanel, type AgentActivityPanelProps, type AgentActivityRecord, AgentSessionControls, type AgentSessionControlsProps, type ChatMessageMetrics, ChatMessages, type ChatMessagesProps, type ChatStreamCallbacks, type ChatStreamToolCall, type ChatStreamToolResult, type ChatToolCallInfo, type ChatUiMessage, type ConsumeChatStreamResult, 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, waterfallLayout };