@tangle-network/agent-app 0.42.5 → 0.42.7

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

@@ -375,13 +375,32 @@ interface ModelPickerProps {
  * sorts providers by tier).
  */
 declare function ModelPicker({ value, onChange, models, loading, renderProviderBadge, recommendedLabel }: ModelPickerProps): react.JSX.Element;
+/** One reasoning-budget level: the engine `id` is unchanged (the value the
+ *  product sends to the loop); only the user-facing `label` is renamed to the
+ *  plainer "how hard should it think" vocabulary from docs/product-surfaces.md.
+ *  `low`→Quick, `medium`→Standard, `high`→Extended. The mapping is overridable
+ *  via `EffortPickerProps.levels`, so a product can relabel without losing the
+ *  ids the runtime expects. */
+interface EffortLevel {
+    id: string;
+    label: string;
+}
+declare const DEFAULT_EFFORT_LEVELS: readonly EffortLevel[];
 interface EffortPickerProps {
     value: string;
     onChange: (id: string) => void;
+    /** Selectable levels (engine id + user-facing label). Defaults to the plain
+     *  "Thinking" vocabulary; override to relabel without changing the ids the
+     *  runtime receives. */
+    levels?: readonly EffortLevel[];
+    /** Prefix shown before the active level on the pill — the "what is this"
+     *  context the bare value lacked. Default "Thinking". Pass '' to hide it. */
+    label?: string;
 }
-/** Reasoning-effort selector pill, styled to match {@link ModelPicker}. Show
- *  it only when the selected model `supportsReasoning`. */
-declare function EffortPicker({ value, onChange }: EffortPickerProps): react.JSX.Element;
+/** Thinking-budget selector pill, styled to match {@link ModelPicker}. Show
+ *  it only when the selected model `supportsReasoning`. "Thinking" is the
+ *  plain-English name for what was internally called "effort". */
+declare function EffortPicker({ value, onChange, levels, label }: EffortPickerProps): react.JSX.Element;
 
 interface AgentSessionControlsProps {
     /** Catalog models — canonical provider-prefixed ids. */
@@ -514,9 +533,41 @@ interface ChatMessagesProps {
      *  retry button (e.g. when the product retries automatically). */
     onRetry?: () => void;
     /** Zero-state renderer, shown when there are no messages and the turn is
-     *  neither loading nor errored. Omit to render nothing (current behavior). */
+     *  neither loading nor errored. When omitted, a branded first-run state is
+     *  shown ({@link ChatEmptyState}); pass `() => null` to render nothing. */
     renderEmpty?: () => ReactNode;
+    /** First-run state config used when `renderEmpty` is not supplied. Lets a
+     *  product set the headline and the "doors" (e.g. start from a template, ask
+     *  the agent) without replacing the whole zero-state. */
+    emptyState?: ChatEmptyStateProps;
+    /** Optional branded header slot rendered above the thread. Off by default to
+     *  preserve the current layout; pass `{ title }` (or your own node via
+     *  `header`) to show the Tangle mark + product title in the chat shell. */
+    header?: ReactNode;
 }
+/** One starting "door" in the chat first-run state — a concrete, labeled action
+ *  (start from a template, do it by hand, ask the agent), not a placeholder. */
+interface ChatEmptyDoor {
+    label: string;
+    description?: string;
+    onSelect: () => void;
+}
+interface ChatEmptyStateProps {
+    /** Product name shown next to the Tangle mark. Default "Agent". */
+    productName?: string;
+    /** Headline. Default frames delegation, not messaging. */
+    headline?: string;
+    /** Subline under the headline. */
+    subline?: string;
+    /** Up to three concrete starting doors. Omit for a mark-and-prompt-only state. */
+    doors?: ChatEmptyDoor[];
+}
+/**
+ * Branded chat first-run state: the Tangle mark, a delegation-framed prompt, and
+ * up to three concrete doors. Replaces the blank thread that read as "empty or
+ * broken". Concrete + actionable — never a "coming soon" placeholder.
+ */
+declare function ChatEmptyState({ productName, headline, subline, doors, }: ChatEmptyStateProps): react.JSX.Element;
 interface ProposalApprovalHandlers {
     onApprove: (proposalId: string, toolCallId: string) => void | Promise<void>;
     onReject: (proposalId: string, toolCallId: string) => void | Promise<void>;
@@ -530,6 +581,6 @@ type ToolDetailRenderers = Record<string, (call: ChatToolCallInfo, message: Chat
  * model id, tokens/sec, and cost, plus a collapsible thinking section and
  * tool-call chips.
  */
-declare function ChatMessages({ messages, models, renderMarkdown, renderExtras, userLabel, agentLabel, loading, approval, onToolCallClick, toolRenderers, error, onRetry, renderEmpty, }: ChatMessagesProps): react.JSX.Element;
+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, type ChatMessageMetrics, type ChatMessageSegment, 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 };
+export { type ActivityTone, type AgentActivityPage, AgentActivityPanel, type AgentActivityPanelProps, type AgentActivityRecord, AgentSessionControls, type AgentSessionControlsProps, type ChatEmptyDoor, ChatEmptyState, type ChatEmptyStateProps, type ChatMessageMetrics, type ChatMessageSegment, ChatMessages, type ChatMessagesProps, type ChatStreamCallbacks, type ChatStreamToolCall, type ChatStreamToolResult, type ChatToolCallInfo, type ChatUiMessage, 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, waterfallLayout };