@agg-build/hooks 1.2.12 → 1.3.0

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient } from '@tanstack/react-query';
 export { QueryClient, QueryClientProvider, useQueryClient } from '@tanstack/react-query';
 import * as _agg_build_sdk from '@agg-build/sdk';
-import { CandleBuilder, AggAuthStartBody, AggAuthStartResult, AggClientSessionInput, AggClient, RampQuote, RampQuoteRequest, RampWidgetSession, RampSessionRequest, QuoteManagedResponse, QuoteManagedParams, ExecuteManagedResponse, ExecuteManagedParams, GetPositionsParams, WsOrderSubmitted, WsBalanceUpdate, RedeemResponse, RedeemRequest, WsRedeemEvent, AggWebSocket, WsOrderEvent, WsWithdrawalLifecycleEvent, WsCandleInterval, WsTrade, AggregatedOrderbookResponse, AggLinkAccountBody, AggLinkAccountResult, AggLinkAccountConfirmResult, UserActivityQuery, UserActivityItem, PaginatedResponse, CandleInterval, OrderbookState, OrderbookQuoteResponse, OrderListQuery, TradeExecutorOrder, SmartRouteSide, SmartRouteResponse, MidpointRow, BatchMidpointsResponse, AppClientConfigResponse } from '@agg-build/sdk';
+import { CandleBuilder, AggAuthStartBody, AggAuthStartResult, AggClientSessionInput, AggClient, RampQuote, RampQuoteRequest, RampWidgetSession, RampSessionRequest, QuoteManagedResponse, QuoteManagedParams, ExecuteManagedResponse, ExecuteManagedParams, GetPositionsParams, WsOrderSubmitted, WsBalanceUpdate, RedeemResponse, RedeemRequest, WsRedeemEvent, AggWebSocket, WsOrderEvent, WsWithdrawalLifecycleEvent, WsCandleInterval, WsTrade, AggregatedOrderbookResponse, AggLinkAccountBody, AggLinkAccountResult, AggLinkAccountConfirmResult, Category, UserActivityQuery, UserActivityItem, PaginatedResponse, CandleInterval, OrderbookState, OrderbookQuoteResponse, OrderListQuery, TradeExecutorOrder, SmartRouteSide, ExecutionMode, SmartRouteResponse, MidpointRow, BatchMidpointsResponse, AppClientConfigResponse } from '@agg-build/sdk';
 export { TurnstileChallengeError } from '@agg-build/sdk';
 import React, { ReactNode } from 'react';
 export { UseManagedBalancesOptions, UseWithdrawEstimateParams, UseWithdrawFlowOptions, UseWithdrawFlowResult, UseWithdrawManagedOptions, UseWithdrawalLifecycleResult, WithdrawFeeEstimate, WithdrawalLifecycleState, useManagedBalances, useWithdrawEstimate, useWithdrawFlow, useWithdrawManaged, useWithdrawalLifecycle } from './withdraw.js';
@@ -296,6 +296,7 @@ type VenueEvent = {
         category: {
             id: string;
             name: string;
+            displayName: string | null;
             parentId: string | null;
             eventCount: number;
         };
@@ -656,7 +657,14 @@ interface AggUiLabels {
     userProfile: {
         activity: {
             depositType: string;
+            redeemType: string;
             withdrawalType: string;
+            redeemStatusTitles: {
+                pending: string;
+                completed: string;
+                failed: string;
+                canceled: string;
+            };
             depositTitles: {
                 connectedWallet: string;
                 externalWallet: string;
@@ -772,6 +780,8 @@ interface AggUiLabels {
         marketPlural: string;
         venueSingular: string;
         venuePlural: string;
+        matched: string;
+        matchedCount: (count: number) => string;
         priceGap: string;
     };
     eventItemDetails: {
@@ -944,7 +954,7 @@ interface AggUiLabels {
         /**
          * Source-chain balance changed between quote and submit. Covers
          * Limitless Base USDC, Polymarket pUSD, Solana SPL InsufficientFunds,
-         * BNB BEP20 transfer-exceeds-balance.
+         * BNB BEP20 transfer-exceeds-balance/allowance.
          */
         sourceBalanceChanged: string;
         /**
@@ -1008,6 +1018,8 @@ interface AggUiLabels {
         feeBreakdownVenueFees: string;
         feeBreakdownBridgeFees: string;
         feeBreakdownExecutionGas: string;
+        feeBreakdownAggMarket: string;
+        feeBreakdownPlatformFeeBadge: string;
         feeBreakdownTotalFees: string;
         toWin: (tab: "buy" | "sell") => string;
         buyingOutcome: (label: string) => string;
@@ -1231,6 +1243,19 @@ interface AggUiLabels {
             failedTitle: string;
             failedMessage: (errorReason?: string) => string;
         };
+        claim: {
+            pendingTitle: string;
+            pendingMessage: string;
+            submittedTitle: string;
+            submittedMessage: string;
+            successTitle: string;
+            successMessage: string;
+            partialTitle: string;
+            partialMessage: (errorReason?: string) => string;
+            failedTitle: string;
+            failedMessage: (errorReason?: string) => string;
+            missingOutcomeMessage: string;
+        };
     };
 }
 type DeepPartial<TValue> = {
@@ -1260,6 +1285,8 @@ interface AggUiFeatureFlagsConfig {
     enableAnimations: boolean;
     /** Enable live updates */
     enableLiveUpdates: boolean;
+    /** Enable compact price-gap signals on aggregated event tiles. */
+    enablePriceGap: boolean;
     /** Enable fee UI in trading flows */
     showFeesBreakdown: boolean;
     /** Enable gradients */
@@ -1653,6 +1680,7 @@ declare const invalidateBalanceQueries: (queryClient: QueryClient, options?: Inv
 declare const invalidatePositionQueries: (queryClient: QueryClient, options?: InvalidateBalanceQueriesOptions) => void;
 declare const userActivityQueryKeys: {
     all: () => readonly ["user-activity"];
+    feed: (type?: string | null, limit?: number | null) => readonly ["user-activity", string, number];
 };
 type UserActivityInvalidationStrategy = "remove" | "invalidate";
 interface InvalidateUserActivityOptions {
@@ -1694,6 +1722,13 @@ interface InvalidateUserMoneyStateOptions {
  * current-user (no money fields change on deposit/withdraw today).
  */
 declare const invalidateUserMoneyState: (queryClient: QueryClient, options?: InvalidateUserMoneyStateOptions) => void;
+/**
+ * Refresh every user-facing cache touched by a winnings claim attempt. Claims
+ * can change the visible claimable count, the active/closed position buckets,
+ * balances, and activity rows. Run this from mutation `onSettled` so rejected
+ * attempts also clear stale pending UI.
+ */
+declare const invalidateUserClaimState: (queryClient: QueryClient, options?: InvalidateUserMoneyStateOptions) => void;
 
 declare function useRampQuotes(): _tanstack_react_query.UseMutationResult<RampQuote[], Error, RampQuoteRequest, unknown>;
 
@@ -1701,9 +1736,16 @@ declare function useRampSession(): _tanstack_react_query.UseMutationResult<RampW
 
 declare const executionKeys: {
     all: () => readonly ["execution"];
-    balances: () => readonly ["execution", "balances"];
-    positions: (cursor?: string | null, limit?: number | null, status?: "active" | "closed" | null) => readonly ["execution", "positions", string | null, number | null, "closed" | "active" | null];
+    balances: (mode?: string | null) => readonly ["execution", "balances", string] | readonly ["execution", "balances"];
+    positions: (cursor?: string | null, limit?: number | null, status?: "active" | "closed" | null, mode?: string | null) => readonly ["execution", "positions", string | null, number | null, "closed" | "active" | null, string] | readonly ["execution", "positions", string | null, number | null, "closed" | "active" | null];
     positionsPrefix: () => readonly ["execution", "positions"];
+    claimablePositionsCount: () => readonly ["execution", "positions", "claimable-count"];
+    /**
+     * @deprecated Misnomer — claimable (redeemStatus "eligible") groups live in
+     * the ACTIVE bucket, not closed (won-but-unclaimed stays Active until a
+     * redeem stamps redeemedAt). Same key value as `claimablePositionsCount`;
+     * kept so existing invalidation call sites keep matching.
+     */
     claimableClosedPositionsCount: () => readonly ["execution", "positions", "claimable-count"];
     orders: (status?: string | null, cursor?: string | null, limit?: number | null) => readonly ["execution", "orders", string | null, string | null, number | null];
     ordersPrefix: () => readonly ["execution", "orders"];
@@ -1955,6 +1997,7 @@ interface ExecutionTerminalOrderEvent {
 interface UseExecutionProgressOptions {
     orderIds: string[] | null;
     enabled: boolean;
+    mode?: "live" | "paper";
 }
 interface UseExecutionProgressResult {
     phase: ExecutionProgressPhase;
@@ -1963,7 +2006,7 @@ interface UseExecutionProgressResult {
     dagProgress: DagStepProgress | null;
     terminalOrderEvents: ExecutionTerminalOrderEvent[];
 }
-declare function useExecutionProgress({ orderIds, enabled, }: UseExecutionProgressOptions): UseExecutionProgressResult;
+declare function useExecutionProgress({ orderIds, enabled, mode, }: UseExecutionProgressOptions): UseExecutionProgressResult;
 
 interface ClosedPositionTotals {
     totalTraded: number;
@@ -2154,6 +2197,19 @@ interface GeoBlockState {
  */
 declare function useGeoBlock(): GeoBlockState;
 
+type VenueAvailabilityState = "available" | "geoblocked" | "hidden";
+declare const normalizeVenueId: (venueId: string) => string;
+declare const isVenueDisabledByConfig: (venueId: string, disabledVenues?: readonly string[]) => boolean;
+declare const getVisibleVenuesByConfig: <TVenue extends {
+    id: string;
+}>(venues: readonly TVenue[], disabledVenues?: readonly string[]) => TVenue[];
+declare const getVisibleVenueIdsByConfig: <TVenueId extends string>(venueIds: readonly TVenueId[], disabledVenues?: readonly string[]) => TVenueId[];
+declare const getVenueAvailabilityState: ({ venueId, disabledVenues, isLocationBlocked, }: {
+    venueId: string;
+    disabledVenues?: readonly string[];
+    isLocationBlocked?: boolean;
+}) => VenueAvailabilityState;
+
 interface UseAggAuthOptions {
     signMessage?: (message: string) => Promise<string>;
     address?: string;
@@ -2198,14 +2254,23 @@ interface UseCategoriesOptions {
     /** Page size when using cursor pagination. Default 20. */
     limit?: number;
 }
+interface UseCategoryChildrenOptions {
+    /** Optional query-key scope to isolate caches across different surfaces. */
+    queryKeyScope?: string;
+    /** Parent category ids whose first child page should be fetched. */
+    parentIds?: readonly (string | null | undefined)[];
+    enabled?: boolean;
+    /** Page size for each child query. Default 20. */
+    limit?: number;
+}
 /**
  * Fetch categories via the API with cursor-based pagination.
  * Use fetchNextPage for "Load more". Same pattern as useVenueEvents.
  */
 declare function useCategories(options?: UseCategoriesOptions): {
-    categories: _agg_build_sdk.Category[];
+    categories: Category[];
     hasNextPage: boolean;
-    data: _tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<_agg_build_sdk.Category>, unknown>;
+    data: _tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<Category>, unknown>;
     error: Error;
     isError: true;
     isPending: false;
@@ -2215,8 +2280,8 @@ declare function useCategories(options?: UseCategoriesOptions): {
     isSuccess: false;
     isPlaceholderData: false;
     status: "error";
-    fetchNextPage: (options?: _tanstack_react_query.FetchNextPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<_agg_build_sdk.Category>, unknown>, Error>>;
-    fetchPreviousPage: (options?: _tanstack_react_query.FetchPreviousPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<_agg_build_sdk.Category>, unknown>, Error>>;
+    fetchNextPage: (options?: _tanstack_react_query.FetchNextPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<Category>, unknown>, Error>>;
+    fetchPreviousPage: (options?: _tanstack_react_query.FetchPreviousPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<Category>, unknown>, Error>>;
     hasPreviousPage: boolean;
     isFetchNextPageError: boolean;
     isFetchingNextPage: boolean;
@@ -2235,13 +2300,13 @@ declare function useCategories(options?: UseCategoriesOptions): {
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<_agg_build_sdk.Category>, unknown>, Error>>;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<Category>, unknown>, Error>>;
     fetchStatus: _tanstack_react_query.FetchStatus;
-    promise: Promise<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<_agg_build_sdk.Category>, unknown>>;
+    promise: Promise<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<Category>, unknown>>;
 } | {
-    categories: _agg_build_sdk.Category[];
+    categories: Category[];
     hasNextPage: boolean;
-    data: _tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<_agg_build_sdk.Category>, unknown>;
+    data: _tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<Category>, unknown>;
     error: null;
     isError: false;
     isPending: false;
@@ -2253,8 +2318,8 @@ declare function useCategories(options?: UseCategoriesOptions): {
     isSuccess: true;
     isPlaceholderData: false;
     status: "success";
-    fetchNextPage: (options?: _tanstack_react_query.FetchNextPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<_agg_build_sdk.Category>, unknown>, Error>>;
-    fetchPreviousPage: (options?: _tanstack_react_query.FetchPreviousPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<_agg_build_sdk.Category>, unknown>, Error>>;
+    fetchNextPage: (options?: _tanstack_react_query.FetchNextPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<Category>, unknown>, Error>>;
+    fetchPreviousPage: (options?: _tanstack_react_query.FetchPreviousPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<Category>, unknown>, Error>>;
     hasPreviousPage: boolean;
     isFetchingNextPage: boolean;
     isFetchingPreviousPage: boolean;
@@ -2271,11 +2336,11 @@ declare function useCategories(options?: UseCategoriesOptions): {
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<_agg_build_sdk.Category>, unknown>, Error>>;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<Category>, unknown>, Error>>;
     fetchStatus: _tanstack_react_query.FetchStatus;
-    promise: Promise<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<_agg_build_sdk.Category>, unknown>>;
+    promise: Promise<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<Category>, unknown>>;
 } | {
-    categories: _agg_build_sdk.Category[];
+    categories: Category[];
     hasNextPage: boolean;
     data: undefined;
     error: Error;
@@ -2289,8 +2354,8 @@ declare function useCategories(options?: UseCategoriesOptions): {
     isSuccess: false;
     isPlaceholderData: false;
     status: "error";
-    fetchNextPage: (options?: _tanstack_react_query.FetchNextPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<_agg_build_sdk.Category>, unknown>, Error>>;
-    fetchPreviousPage: (options?: _tanstack_react_query.FetchPreviousPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<_agg_build_sdk.Category>, unknown>, Error>>;
+    fetchNextPage: (options?: _tanstack_react_query.FetchNextPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<Category>, unknown>, Error>>;
+    fetchPreviousPage: (options?: _tanstack_react_query.FetchPreviousPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<Category>, unknown>, Error>>;
     hasPreviousPage: boolean;
     isFetchingNextPage: boolean;
     isFetchingPreviousPage: boolean;
@@ -2307,11 +2372,11 @@ declare function useCategories(options?: UseCategoriesOptions): {
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<_agg_build_sdk.Category>, unknown>, Error>>;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<Category>, unknown>, Error>>;
     fetchStatus: _tanstack_react_query.FetchStatus;
-    promise: Promise<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<_agg_build_sdk.Category>, unknown>>;
+    promise: Promise<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<Category>, unknown>>;
 } | {
-    categories: _agg_build_sdk.Category[];
+    categories: Category[];
     hasNextPage: boolean;
     data: undefined;
     error: null;
@@ -2325,8 +2390,8 @@ declare function useCategories(options?: UseCategoriesOptions): {
     isSuccess: false;
     isPlaceholderData: false;
     status: "pending";
-    fetchNextPage: (options?: _tanstack_react_query.FetchNextPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<_agg_build_sdk.Category>, unknown>, Error>>;
-    fetchPreviousPage: (options?: _tanstack_react_query.FetchPreviousPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<_agg_build_sdk.Category>, unknown>, Error>>;
+    fetchNextPage: (options?: _tanstack_react_query.FetchNextPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<Category>, unknown>, Error>>;
+    fetchPreviousPage: (options?: _tanstack_react_query.FetchPreviousPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<Category>, unknown>, Error>>;
     hasPreviousPage: boolean;
     isFetchingNextPage: boolean;
     isFetchingPreviousPage: boolean;
@@ -2343,11 +2408,11 @@ declare function useCategories(options?: UseCategoriesOptions): {
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<_agg_build_sdk.Category>, unknown>, Error>>;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<Category>, unknown>, Error>>;
     fetchStatus: _tanstack_react_query.FetchStatus;
-    promise: Promise<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<_agg_build_sdk.Category>, unknown>>;
+    promise: Promise<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<Category>, unknown>>;
 } | {
-    categories: _agg_build_sdk.Category[];
+    categories: Category[];
     hasNextPage: boolean;
     data: undefined;
     error: null;
@@ -2360,8 +2425,8 @@ declare function useCategories(options?: UseCategoriesOptions): {
     isSuccess: false;
     isPlaceholderData: false;
     status: "pending";
-    fetchNextPage: (options?: _tanstack_react_query.FetchNextPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<_agg_build_sdk.Category>, unknown>, Error>>;
-    fetchPreviousPage: (options?: _tanstack_react_query.FetchPreviousPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<_agg_build_sdk.Category>, unknown>, Error>>;
+    fetchNextPage: (options?: _tanstack_react_query.FetchNextPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<Category>, unknown>, Error>>;
+    fetchPreviousPage: (options?: _tanstack_react_query.FetchPreviousPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<Category>, unknown>, Error>>;
     hasPreviousPage: boolean;
     isFetchingNextPage: boolean;
     isFetchingPreviousPage: boolean;
@@ -2379,13 +2444,13 @@ declare function useCategories(options?: UseCategoriesOptions): {
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<_agg_build_sdk.Category>, unknown>, Error>>;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<Category>, unknown>, Error>>;
     fetchStatus: _tanstack_react_query.FetchStatus;
-    promise: Promise<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<_agg_build_sdk.Category>, unknown>>;
+    promise: Promise<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<Category>, unknown>>;
 } | {
-    categories: _agg_build_sdk.Category[];
+    categories: Category[];
     hasNextPage: boolean;
-    data: _tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<_agg_build_sdk.Category>, unknown>;
+    data: _tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<Category>, unknown>;
     isError: false;
     error: null;
     isPending: false;
@@ -2397,8 +2462,8 @@ declare function useCategories(options?: UseCategoriesOptions): {
     isFetchNextPageError: false;
     isFetchPreviousPageError: false;
     status: "success";
-    fetchNextPage: (options?: _tanstack_react_query.FetchNextPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<_agg_build_sdk.Category>, unknown>, Error>>;
-    fetchPreviousPage: (options?: _tanstack_react_query.FetchPreviousPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<_agg_build_sdk.Category>, unknown>, Error>>;
+    fetchNextPage: (options?: _tanstack_react_query.FetchNextPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<Category>, unknown>, Error>>;
+    fetchPreviousPage: (options?: _tanstack_react_query.FetchPreviousPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<Category>, unknown>, Error>>;
     hasPreviousPage: boolean;
     isFetchingNextPage: boolean;
     isFetchingPreviousPage: boolean;
@@ -2415,15 +2480,27 @@ declare function useCategories(options?: UseCategoriesOptions): {
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<_agg_build_sdk.Category>, unknown>, Error>>;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<Category>, unknown>, Error>>;
     fetchStatus: _tanstack_react_query.FetchStatus;
-    promise: Promise<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<_agg_build_sdk.Category>, unknown>>;
+    promise: Promise<_tanstack_react_query.InfiniteData<_agg_build_sdk.PaginatedResponse<Category>, unknown>>;
+};
+/**
+ * Fetch the first page of children for multiple parent categories.
+ * This is intentionally first-page only: it is used to render folder affordances
+ * and keep already-open branches visible without issuing one-off queries inside
+ * the component tree for every rendered row.
+ */
+declare function useCategoryChildren(options?: UseCategoryChildrenOptions): {
+    queries: _tanstack_react_query.UseQueryResult<_agg_build_sdk.PaginatedResponse<Category>, Error>[];
+    childrenByParentId: Map<string, Category[]>;
+    isLoading: boolean;
 };
 
 declare function useDebouncedValue<T>(value: T, delay: number): T;
 
 interface UseExecutionOrdersOptions extends Omit<GetOrdersQuery, "cursor"> {
     enabled?: boolean;
+    mode?: "live" | "paper";
     refetchIntervalMs?: number | false;
 }
 declare function useExecutionOrders(options?: UseExecutionOrdersOptions): {
@@ -2891,6 +2968,7 @@ declare function useExternalId(options?: UseExternalIdOptions): UseExternalIdRet
 
 interface UseExecutionPositionsOptions extends Omit<GetPositionsQuery, "cursor"> {
     enabled?: boolean;
+    mode?: "live" | "paper";
 }
 declare function useExecutionPositions(options?: UseExecutionPositionsOptions): {
     positions: PositionGroup[];
@@ -3523,6 +3601,51 @@ interface UseMarketOrderbookResult {
  */
 declare function useMarketOrderbook(options: UseMarketOrderbookOptions): UseMarketOrderbookResult;
 
+interface UseMarketArbResult {
+    /** Live arbReturn for the market, or null if no data received yet. */
+    arbReturn: number | null;
+    /** True once at least one live update (or a cached seed) has been received. */
+    isLive: boolean;
+}
+interface UseArbFeedResult {
+    /**
+     * Live arbReturn keyed by marketId.
+     * Values are the most-recently received arbReturn for each market.
+     */
+    byMarket: Map<string, number>;
+    /**
+     * MAX arbReturn keyed by venueEventId.
+     * Derived from byMarket by scanning all markets that share a venueEventId and
+     * taking the maximum. Rebuilt fully on every batch so it is correct even when
+     * a market's arb DROPS between batches.
+     */
+    byEvent: Map<string, number>;
+}
+/**
+ * Subscribe to real-time arbReturn updates for a single market.
+ *
+ * Seeds initial state from the WS cache (`ws.getArb`) if available, then
+ * streams live updates via `ws.subscribeArb`. Unsubscribes on unmount or when
+ * `marketId` changes.
+ *
+ * Returns `{ arbReturn: number | null; isLive: boolean }`.
+ * `isLive` is true once at least one value (cached or live) is received.
+ */
+declare function useMarketArb(marketId: string | null): UseMarketArbResult;
+/**
+ * Subscribe to the coalesced arb-return feed.
+ *
+ * Maintains a `byMarket` map (marketId → arbReturn) and derives a `byEvent`
+ * map (venueEventId → max arbReturn across all markets in that event).
+ *
+ * `byEvent` is ALWAYS fully rebuilt from `byMarket` on each batch so that
+ * dropping arb values (e.g. m2 goes from 0.30 → 0.02) are reflected correctly
+ * — there is no stale running-max accumulation.
+ *
+ * Returns `{ byMarket: Map<string, number>; byEvent: Map<string, number> }`.
+ */
+declare function useArbFeed(): UseArbFeedResult;
+
 interface OrderbookResult {
     market: VenueMarket;
     outcome: VenueMarketOutcome;
@@ -3892,6 +4015,8 @@ interface UseSmartRouteOptions {
     side?: SmartRouteSide | null;
     /** Trade direction: "buy" (default) or "sell". */
     tradeSide?: "buy" | "sell" | null;
+    /** Trading mode. Defaults to live. */
+    mode?: ExecutionMode | null;
     /** Maximum USDC spend for the quote. Required for buy; optional for sell when sellShares is given. */
     maxSpend?: number;
     /** Sell only: target number of contracts to sell. */
@@ -5236,26 +5361,14 @@ declare function useVenueMarketMidpoints(options: UseVenueMarketMidpointsOptions
     promise: Promise<BatchMidpointsResponse>;
 };
 
-interface PriceGapMarket {
-    id: string;
-    matchedVenueMarkets?: Array<{
-        id: string;
-    }> | null;
-}
-interface ComputePriceGapsInput {
-    markets: PriceGapMarket[];
-    midpointsByVenueMarketId: Map<string, number | null>;
-}
-/**
- * Returns Map<targetVenueMarketId, gapPct> for markets whose gap is >= MIN_PRICE_GAP_PCT.
- *
- * Gap = max over matched siblings of
- *   `Math.abs(ownMidpoint - siblingMidpoint) / ownMidpoint * 100`
- *
- * Skip markets whose own midpoint is null/<=0. Skip sibling pairings whose
- * midpoint is null/<=0. Omit markets whose resulting gap is < MIN_PRICE_GAP_PCT.
- */
-declare function computePriceGaps(input: ComputePriceGapsInput): Map<string, number>;
+declare const MIN_PRICE_GAP_PCT = 3;
+declare const MAX_PRICE_GAP_PCT = 50;
+type PriceGapValue = number;
+type ComputePriceGapsOptions = {
+    markets: readonly VenueMarket[];
+    midpointsByVenueMarketId: ReadonlyMap<string, number | null | undefined>;
+};
+declare const computePriceGaps: ({ markets, midpointsByVenueMarketId, }: ComputePriceGapsOptions) => Map<string, PriceGapValue>;
 
 /**
  * Fetch REST midpoints for a *dynamic* set of venue markets and cache them
@@ -5323,5 +5436,10 @@ interface UseAppConfigResult {
  * Cached for 5 minutes — config rarely changes at runtime.
  */
 declare function useAppConfig(): UseAppConfigResult;
+/**
+ * Read the current App's UI config from the React Query cache without starting a fetch.
+ * Use this in surfaces that open after config has already been loaded by a parent screen.
+ */
+declare function useCachedAppConfig(): UseAppConfigResult;
 
-export { AUTH_CHOOSER_OPEN_EVENT, type AggAuthContextValue, type AggAuthSignInOptions, type AggBalanceContextValue, AggBalanceProvider, AggProvider, type AggProviderProps, AggProvider as AggSdkProvider, type AggProviderProps as AggSdkProviderProps, type AggUiConfig, type AggUiConfigInput, type AggUiLabels, type AggUiLabelsInput, AggUiProvider, CHART_TIME_RANGES, CONFIRMED_MATCH_STATUSES, type ChartTimeRange, type ClosedPositionTotals, type ComputePriceGapsInput, DEFAULT_AGG_ROOT_CLASS_NAME, type DagStepProgress, type EventListStateContextValue, EventListStateProvider, type EventListStateSnapshot, type EventTradingContextValue, type EventTradingState, type ExecutionProgressPhase, type ExecutionTerminalOrderEvent, type GeoBlockState, type GetOrdersQuery, type GetPositionsQuery, type InvalidateUserActivityOptions, type InvalidateUserMoneyStateOptions, type LiveBestPrices, type LiveCandle, type MarketChartCandle, type MarketChartData, type MarketChartVenueData, type MarketOrderbookData, type MarketOrderbookIntegrity, MarketStatus, type MarketTradingState, MatchStatus, MatchType, type OrderEligibility, type OrderEligibilityReason, type OrderListItem, type OrderbookResult, type PositionGroup, type PriceGapMarket, type RedeemEvent, type RedeemLegLifecycle, type RedeemLifecycleState, RedeemRejectedError, type RollingChartWindow, type ScaledCandlePoint, type SdkUiConfig, type SdkUiConfigInput, type SdkUiProviderProps, type ThemeMode, TradeSide, type TradingAction, type TradingState, type TradingStateBase, type TradingStateKind, type UseAggAuthOptions, type UseAggAuthReturn, type UseAppConfigResult, type UseCategoriesOptions, type UseEnrichedVenueEventOptions, type UseExecuteManagedOptions, type UseExecutionOrdersOptions, type UseExecutionPositionsOptions, type UseExecutionProgressOptions, type UseExecutionProgressResult, type UseExternalIdOptions, type UseExternalIdReturn, type UseLinkAccountReturn, type UseLiveCandleOverlayOptions, type UseLiveCandleOverlayResult, type UseLiveCandlesOptions, type UseLiveCandlesResult, type UseLiveMarketResult, type UseMarketChartOptions, type UseMarketChartResult, type UseMarketOrderbookOptions, type UseMarketOrderbookResult, type UseMarketOrderbookVenueOutcome, type UseMarketSearchOptions, type UseMidpointsResult, type UseOrderBookOptions, type UseOrderbookQuoteOptions, type UseOrderbookQuoteResult, type UseOrdersOptions, type UsePositionsOptions, type UseQuoteManagedOptions, type UseRedeemLifecycleInput, type UseRollingChartWindowOptions, type UseSearchOptions, type UseSmartRouteOptions, type UseSmartRouteResult, type UseTradableVenuesResult, type UseUserActivityOptions, type UseUserHoldingsOptions, type UseVenueEventOptions, type UseVenueEventsOptions, type UseVenueMarketMidpointsOptions, type UseVenueMarketsOptions, type UseVisibleIdsOptions, type UseVisibleIdsResult, type UserActivityInvalidationStrategy, Venue, type VenueEvent, type VenueEventWithMarkets, type VenueMarket, type VenueMarketOutcome, type WalletActionSendTokenParams, type WalletActions, computeClosedPositionTotals, computePriceGaps, defaultAggUiConfig, defaultAggUiConfig as defaultSdkUiConfig, executionKeys, findLivePriceById, getBuilder, getOrCreateBuilder, getWalletAddressFromUserProfile, invalidateBalanceQueries, invalidatePositionQueries, invalidateUserActivityQueries, invalidateUserMoneyState, mergeBestPricesPreferringLive, optimizedImageUrl, parseEmail, parseEmailStrict, rangeToSeconds, requestAggAuthChooserOpen, resolveAggUiLabels, resolveDefaultMarket as resolveDefaultTradingMarket, resolveEventTradingState, resolveMarketTradingState, resolveMarketWinningOutcome, resolveOrderEligibility, resolveRollingWindow, resolveTradingStateKind, sortVenues, timeRangeToInterval, tradingReducer, useAggAuth, useAggAuthContext, useAggAuthState, useAggBalance, useAggBalanceContext, useAggBalanceState, useAggClient, useAggLabels, useAggUiConfig, useAggWebSocket, useAppConfig, useCategories, useDebouncedValue, useEnrichedVenueEvent, useEventListState, useEventOrderbookData, useEventTradingContext, useExecuteManaged, useExecutionOrders, useExecutionPositions, useExecutionProgress, useExternalId, useGeoBlock, useLabels, useLinkAccount, useLiveBestPrices, useLiveCandleOverlay, useLiveCandles, useLiveMarket, useLiveMarketStores, useLiveOutcomePrices, useLiveTrades, useMarketChart, useMarketOrderbook, useMarketSearch, useMidpoints, useOnBalanceUpdate, useOnOrderEvent, useOnOrderSubmitted, useOnRedeemEvent, useOnWithdrawalLifecycle, useOptionalAggClient, useOrderBook, useOrderbookQuote, useOrders, usePositions, useQuoteManaged, useRampQuotes, useRampSession, useRedeem, useRedeemEligibleCount, useRedeemLifecycle, useRedeemLifecycles, useRollingChartWindow, useSdkLabels, useSdkUiConfig, useSearch, useSmartRoute, useTradableVenues, useUserActivity, useUserHoldings, useVenueEvent, useVenueEvents, useVenueMarketMidpoints, useVenueMarkets, useViewportMidpoints, useVisibleIds, userActivityQueryKeys };
+export { AUTH_CHOOSER_OPEN_EVENT, type AggAuthContextValue, type AggAuthSignInOptions, type AggBalanceContextValue, AggBalanceProvider, AggProvider, type AggProviderProps, AggProvider as AggSdkProvider, type AggProviderProps as AggSdkProviderProps, type AggUiConfig, type AggUiConfigInput, type AggUiLabels, type AggUiLabelsInput, AggUiProvider, CHART_TIME_RANGES, CONFIRMED_MATCH_STATUSES, type ChartTimeRange, type ClosedPositionTotals, type ComputePriceGapsOptions, DEFAULT_AGG_ROOT_CLASS_NAME, type DagStepProgress, type EventListStateContextValue, EventListStateProvider, type EventListStateSnapshot, type EventTradingContextValue, type EventTradingState, type ExecutionProgressPhase, type ExecutionTerminalOrderEvent, type GeoBlockState, type GetOrdersQuery, type GetPositionsQuery, type InvalidateUserActivityOptions, type InvalidateUserMoneyStateOptions, type LiveBestPrices, type LiveCandle, MAX_PRICE_GAP_PCT, MIN_PRICE_GAP_PCT, type MarketChartCandle, type MarketChartData, type MarketChartVenueData, type MarketOrderbookData, type MarketOrderbookIntegrity, MarketStatus, type MarketTradingState, MatchStatus, MatchType, type OrderEligibility, type OrderEligibilityReason, type OrderListItem, type OrderbookResult, type PositionGroup, type PriceGapValue, type RedeemEvent, type RedeemLegLifecycle, type RedeemLifecycleState, RedeemRejectedError, type RollingChartWindow, type ScaledCandlePoint, type SdkUiConfig, type SdkUiConfigInput, type SdkUiProviderProps, type ThemeMode, TradeSide, type TradingAction, type TradingState, type TradingStateBase, type TradingStateKind, type UseAggAuthOptions, type UseAggAuthReturn, type UseAppConfigResult, type UseArbFeedResult, type UseCategoriesOptions, type UseCategoryChildrenOptions, type UseEnrichedVenueEventOptions, type UseExecuteManagedOptions, type UseExecutionOrdersOptions, type UseExecutionPositionsOptions, type UseExecutionProgressOptions, type UseExecutionProgressResult, type UseExternalIdOptions, type UseExternalIdReturn, type UseLinkAccountReturn, type UseLiveCandleOverlayOptions, type UseLiveCandleOverlayResult, type UseLiveCandlesOptions, type UseLiveCandlesResult, type UseLiveMarketResult, type UseMarketArbResult, type UseMarketChartOptions, type UseMarketChartResult, type UseMarketOrderbookOptions, type UseMarketOrderbookResult, type UseMarketOrderbookVenueOutcome, type UseMarketSearchOptions, type UseMidpointsResult, type UseOrderBookOptions, type UseOrderbookQuoteOptions, type UseOrderbookQuoteResult, type UseOrdersOptions, type UsePositionsOptions, type UseQuoteManagedOptions, type UseRedeemLifecycleInput, type UseRollingChartWindowOptions, type UseSearchOptions, type UseSmartRouteOptions, type UseSmartRouteResult, type UseTradableVenuesResult, type UseUserActivityOptions, type UseUserHoldingsOptions, type UseVenueEventOptions, type UseVenueEventsOptions, type UseVenueMarketMidpointsOptions, type UseVenueMarketsOptions, type UseVisibleIdsOptions, type UseVisibleIdsResult, type UserActivityInvalidationStrategy, Venue, type VenueAvailabilityState, type VenueEvent, type VenueEventWithMarkets, type VenueMarket, type VenueMarketOutcome, type WalletActionSendTokenParams, type WalletActions, computeClosedPositionTotals, computePriceGaps, defaultAggUiConfig, defaultAggUiConfig as defaultSdkUiConfig, executionKeys, findLivePriceById, getBuilder, getOrCreateBuilder, getVenueAvailabilityState, getVisibleVenueIdsByConfig, getVisibleVenuesByConfig, getWalletAddressFromUserProfile, invalidateBalanceQueries, invalidatePositionQueries, invalidateUserActivityQueries, invalidateUserClaimState, invalidateUserMoneyState, isVenueDisabledByConfig, mergeBestPricesPreferringLive, normalizeVenueId, optimizedImageUrl, parseEmail, parseEmailStrict, rangeToSeconds, requestAggAuthChooserOpen, resolveAggUiLabels, resolveDefaultMarket as resolveDefaultTradingMarket, resolveEventTradingState, resolveMarketTradingState, resolveMarketWinningOutcome, resolveOrderEligibility, resolveRollingWindow, resolveTradingStateKind, sortVenues, timeRangeToInterval, tradingReducer, useAggAuth, useAggAuthContext, useAggAuthState, useAggBalance, useAggBalanceContext, useAggBalanceState, useAggClient, useAggLabels, useAggUiConfig, useAggWebSocket, useAppConfig, useArbFeed, useCachedAppConfig, useCategories, useCategoryChildren, useDebouncedValue, useEnrichedVenueEvent, useEventListState, useEventOrderbookData, useEventTradingContext, useExecuteManaged, useExecutionOrders, useExecutionPositions, useExecutionProgress, useExternalId, useGeoBlock, useLabels, useLinkAccount, useLiveBestPrices, useLiveCandleOverlay, useLiveCandles, useLiveMarket, useLiveMarketStores, useLiveOutcomePrices, useLiveTrades, useMarketArb, useMarketChart, useMarketOrderbook, useMarketSearch, useMidpoints, useOnBalanceUpdate, useOnOrderEvent, useOnOrderSubmitted, useOnRedeemEvent, useOnWithdrawalLifecycle, useOptionalAggClient, useOrderBook, useOrderbookQuote, useOrders, usePositions, useQuoteManaged, useRampQuotes, useRampSession, useRedeem, useRedeemEligibleCount, useRedeemLifecycle, useRedeemLifecycles, useRollingChartWindow, useSdkLabels, useSdkUiConfig, useSearch, useSmartRoute, useTradableVenues, useUserActivity, useUserHoldings, useVenueEvent, useVenueEvents, useVenueMarketMidpoints, useVenueMarkets, useViewportMidpoints, useVisibleIds, userActivityQueryKeys };