@tangle-network/agent-app 0.27.2 → 0.28.0

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

@@ -1,9 +1,9 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
 import { S as StepAgentActivity } from '../agent-activity-C8ZG0F0M.js';
-import { FlowTrace } from '../trace/index.js';
-import { Harness } from '../harness/index.js';
+import { a as FlowTrace } from '../flow-types-Cb_AblZs.js';
 import { C as CatalogModel } from '../model-catalog-BEAEVDaa.js';
+import { Harness } from '../harness/index.js';
 
 /**
  * Client-side chat-stream consumption — the NDJSON parse loop every agent
@@ -248,8 +248,10 @@ declare function useSandboxTerminalConnection(opts: UseSandboxTerminalConnection
 interface SeatPaywallProps {
     /** Human product name shown in the headline, e.g. "Creative". */
     product: string;
-    /** Fired when the user clicks the unlock CTA — route them to checkout. */
-    onCheckout: () => void;
+    /** Fired when the user clicks the unlock CTA — route them to checkout. When
+     *  it returns a promise the button shows a pending state and ignores repeat
+     *  clicks until it settles (no double-charge on a slow checkout open). */
+    onCheckout: () => void | Promise<void>;
     /** Monthly seat price in whole dollars. Default 100. */
     priceUsd?: number;
     /** Included monthly AI usage in whole dollars. Default 50. */
@@ -266,6 +268,59 @@ interface SeatPaywallProps {
  */
 declare function SeatPaywall({ product, onCheckout, priceUsd, includedUsageUsd, tagline, ctaLabel, }: SeatPaywallProps): ReactNode;
 
+/**
+ * Keyboard + pointer model for a trigger-and-popover pair, dependency-free.
+ * Outside-mousedown and Escape both close; Escape also returns focus to the
+ * trigger so keyboard users aren't dropped at the top of the document. The
+ * returned `triggerProps` carry the ARIA contract (`aria-haspopup`/
+ * `aria-expanded`); spread them onto the trigger button.
+ */
+declare function usePopover(open: boolean, setOpen: (open: boolean) => void): {
+    containerRef: react.RefObject<HTMLDivElement | null>;
+    triggerRef: react.RefObject<HTMLButtonElement | null>;
+    triggerProps: {
+        ref: react.RefObject<HTMLButtonElement | null>;
+        'aria-haspopup': true;
+        'aria-expanded': boolean;
+    };
+};
+/**
+ * Guard an async action against double-submit. `run` ignores re-entrant calls
+ * while a promise is in flight and flips `pending` so the caller can disable
+ * the control — the fix for double-charge / double-approve on a slow network.
+ * Settles (success or throw) before clearing, and no-ops state updates after
+ * unmount.
+ */
+declare function usePending(): {
+    pending: boolean;
+    run: (action: () => void | Promise<void>) => void;
+};
+interface ModelPickerProps {
+    value: string;
+    onChange: (id: string) => void;
+    /** Catalogue models — from `GET`ing the app's catalogue route (see
+     *  `runtime/model-catalog`), plus any product-specific entries appended. */
+    models: CatalogModel[];
+    loading?: boolean;
+    /** Render a provider logo/badge; default is a generic sparkle. */
+    renderProviderBadge?: (provider: string) => ReactNode;
+    /** Section label for `featured` models. */
+    recommendedLabel?: string;
+}
+/**
+ * Searchable model picker pill + popover: a featured/recommended section
+ * first, then per-provider groups in catalogue order (the server already
+ * sorts providers by tier).
+ */
+declare function ModelPicker({ value, onChange, models, loading, renderProviderBadge, recommendedLabel }: ModelPickerProps): react.JSX.Element;
+interface EffortPickerProps {
+    value: string;
+    onChange: (id: string) => void;
+}
+/** 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;
+
 interface AgentSessionControlsProps {
     /** Catalog models — canonical provider-prefixed ids. */
     models: CatalogModel[];
@@ -304,31 +359,6 @@ interface ChatMessageMetrics {
 declare function formatModelCost(msg: ChatMessageMetrics, models: CatalogModel[]): string | null;
 /** "38 tok/s" from completion tokens over first-token→end duration; null when unknown. */
 declare function formatTokensPerSecond(msg: ChatMessageMetrics): string | null;
-interface ModelPickerProps {
-    value: string;
-    onChange: (id: string) => void;
-    /** Catalogue models — from `GET`ing the app's catalogue route (see
-     *  `runtime/model-catalog`), plus any product-specific entries appended. */
-    models: CatalogModel[];
-    loading?: boolean;
-    /** Render a provider logo/badge; default is a generic sparkle. */
-    renderProviderBadge?: (provider: string) => ReactNode;
-    /** Section label for `featured` models. */
-    recommendedLabel?: string;
-}
-/**
- * Searchable model picker pill + popover: a featured/recommended section
- * first, then per-provider groups in catalogue order (the server already
- * sorts providers by tier).
- */
-declare function ModelPicker({ value, onChange, models, loading, renderProviderBadge, recommendedLabel }: ModelPickerProps): react.JSX.Element;
-interface EffortPickerProps {
-    value: string;
-    onChange: (id: string) => void;
-}
-/** 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;
 /** One step of a retained tool run (e.g. a sandbox command + its output). */
 interface ToolRunStep {
     at: string;
@@ -398,6 +428,16 @@ interface ChatMessagesProps {
     onToolCallClick?: (call: ChatToolCallInfo, message: ChatUiMessage) => void;
     /** Per-tool custom detail renderers for expanded tool cards. */
     toolRenderers?: ToolDetailRenderers;
+    /** Stream-error affordance: when the turn failed (a thrown transport error or
+     *  a loop-level `onErrorEvent`), pass the message here to render an error row.
+     *  A failed turn otherwise just stops with no UI signal. */
+    error?: string | null;
+    /** Retry control shown on the error row; omit to render the error without a
+     *  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). */
+    renderEmpty?: () => ReactNode;
 }
 interface ProposalApprovalHandlers {
     onApprove: (proposalId: string, toolCallId: string) => void | Promise<void>;
@@ -412,6 +452,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, }: ChatMessagesProps): react.JSX.Element;
+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, 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 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 };