@agg-build/sdk 4.17.4 → 4.19.0

package/dist/index.mjs

@@ -1,3 +1,65 @@
+import {
+  CandleBuilder
+} from "./chunk-VD5UTAVD.mjs";
+import {
+  ACTIVE_VENUES,
+  AccountProvider,
+  AccountType,
+  AggWebSocket,
+  CONFIRMED_MATCH_STATUSES,
+  Chain,
+  DEFAULT_BALANCE_REFILL_DAILY_CAP_RAW,
+  DEFAULT_BALANCE_REFILL_MAX_FEE_RAW,
+  IMAGE_SIZES,
+  INACTIVE_VENUES,
+  ImageSize,
+  LIMIT_PRICE_RAW_SCALE,
+  MarketStatus,
+  MatchStatus,
+  MatchType,
+  OrderStatus,
+  OrderType,
+  RETINA_IMAGE_SIZES,
+  TimeInForce,
+  TradeSide,
+  VENUES,
+  VENUE_CHAIN_IDS,
+  Venue,
+  adjustLimitPriceRawToTick,
+  applyOrderbookDelta,
+  buildVenueUrl,
+  computeBestSplitsByAmount,
+  computeChecksum,
+  enumGuard,
+  formatMarketQuestion,
+  formatOutcomeLabel,
+  formatOutcomeTitle,
+  getBalanceRefillMaximumRaw,
+  getEffectiveDisabledVenues,
+  getWalletAddressFromUserProfile,
+  hasShape,
+  isBalanceRefillWithinDailyCap,
+  isEmail,
+  isEnum,
+  isFiniteNonNeg,
+  isNonEmptyString,
+  isVenueActive,
+  isVenueDataVisible,
+  isVenueInactive,
+  loadImmutableHistory,
+  normalizeVenueMarketCluster,
+  optimizedImageUrl,
+  orderbookCrc32,
+  parse,
+  parseEmail,
+  parseEmailStrict,
+  projectedOrderbookChecksum,
+  readChartHistoryText,
+  retinaImageUrl,
+  safeParse,
+  snapshotToOrderbook,
+  sortVenues
+} from "./chunk-QXBVA5TW.mjs";
 import {
   __async,
   __objRest,
@@ -5,686 +67,26 @@ import {
   __spreadValues
 } from "./chunk-WNQUEZJF.mjs";
 
-// ../common/src/enums/venue.ts
-var Venue = /* @__PURE__ */ ((Venue3) => {
-  Venue3["kalshi"] = "kalshi";
-  Venue3["polymarket"] = "polymarket";
-  Venue3["limitless"] = "limitless";
-  Venue3["opinion"] = "opinion";
-  Venue3["predict"] = "predict";
-  Venue3["pred"] = "pred";
-  Venue3["probable"] = "probable";
-  Venue3["myriad"] = "myriad";
-  Venue3["hyperliquid"] = "hyperliquid";
-  Venue3["novig"] = "novig";
-  Venue3["prophetx"] = "prophetx";
-  return Venue3;
-})(Venue || {});
-var VENUES = [
-  "kalshi" /* kalshi */,
-  "polymarket" /* polymarket */,
-  "limitless" /* limitless */,
-  "opinion" /* opinion */,
-  "predict" /* predict */,
-  "pred" /* pred */,
-  "probable" /* probable */,
-  "myriad" /* myriad */,
-  "hyperliquid" /* hyperliquid */,
-  "novig" /* novig */,
-  "prophetx" /* prophetx */
-];
-var VENUE_CHAIN_IDS = {
-  ["kalshi" /* kalshi */]: 792703809,
-  ["polymarket" /* polymarket */]: 137,
-  ["limitless" /* limitless */]: 8453,
-  ["predict" /* predict */]: 56,
-  ["pred" /* pred */]: 8453,
-  ["myriad" /* myriad */]: 56,
-  ["hyperliquid" /* hyperliquid */]: 1337,
-  ["novig" /* novig */]: 792703809,
-  ["prophetx" /* prophetx */]: 792703809
-};
-var ACTIVE_VENUES = [
-  "kalshi" /* kalshi */,
-  "polymarket" /* polymarket */,
-  "limitless" /* limitless */,
-  "opinion" /* opinion */,
-  "predict" /* predict */,
-  "pred" /* pred */,
-  "probable" /* probable */,
-  "myriad" /* myriad */,
-  "hyperliquid" /* hyperliquid */,
-  "novig" /* novig */,
-  "prophetx" /* prophetx */
-];
-var INACTIVE_VENUES = [];
-var DEFAULT_DISABLED_VENUES = ["pred" /* pred */, "novig" /* novig */, "prophetx" /* prophetx */];
-var ACTIVE_VENUE_SET = new Set(ACTIVE_VENUES);
-var INACTIVE_VENUE_SET = new Set(INACTIVE_VENUES);
-function normalizeVenue(venue) {
-  return venue.trim().toLowerCase();
-}
-function isVenueActive(venue) {
-  if (ACTIVE_VENUE_SET.has(venue)) return true;
-  if (INACTIVE_VENUE_SET.has(venue)) return false;
-  return ACTIVE_VENUE_SET.has(normalizeVenue(venue));
-}
-function isVenueInactive(venue) {
-  if (INACTIVE_VENUE_SET.has(venue)) return true;
-  if (ACTIVE_VENUE_SET.has(venue)) return false;
-  return INACTIVE_VENUE_SET.has(normalizeVenue(venue));
-}
-function isVenueDataVisible(venue, dataVisibleOverride = []) {
-  if (isVenueActive(venue)) return true;
-  const n = normalizeVenue(venue);
-  return dataVisibleOverride.some((v) => normalizeVenue(v) === n);
-}
-function getEffectiveDisabledVenues(disabledVenues, dataVisibleVenues = []) {
-  if (disabledVenues === void 0) {
-    const disabled2 = new Set(DEFAULT_DISABLED_VENUES);
-    for (const venue of dataVisibleVenues) disabled2.delete(normalizeVenue(venue));
-    return VENUES.filter((venue) => disabled2.has(venue));
-  }
-  const disabled = new Set(disabledVenues.map(normalizeVenue));
-  return VENUES.filter((venue) => disabled.has(venue));
-}
-
-// ../common/src/enums/image-size.ts
-var ImageSize = /* @__PURE__ */ ((ImageSize2) => {
-  ImageSize2[ImageSize2["sm"] = 44] = "sm";
-  ImageSize2[ImageSize2["md"] = 48] = "md";
-  ImageSize2[ImageSize2["lg"] = 60] = "lg";
-  ImageSize2[ImageSize2["original"] = 0] = "original";
-  return ImageSize2;
-})(ImageSize || {});
-var IMAGE_SIZES = [44 /* sm */, 48 /* md */, 60 /* lg */];
-
-// ../common/src/enums/account.ts
-var AccountType = /* @__PURE__ */ ((AccountType2) => {
-  AccountType2["oauth"] = "oauth";
-  AccountType2["siwe"] = "siwe";
-  AccountType2["siws"] = "siws";
-  AccountType2["email"] = "email";
-  return AccountType2;
-})(AccountType || {});
-var AccountProvider = /* @__PURE__ */ ((AccountProvider2) => {
-  AccountProvider2["wallet"] = "wallet";
-  AccountProvider2["solana_wallet"] = "solana_wallet";
-  AccountProvider2["google"] = "google";
-  AccountProvider2["twitter"] = "twitter";
-  AccountProvider2["apple"] = "apple";
-  AccountProvider2["email"] = "email";
-  return AccountProvider2;
-})(AccountProvider || {});
-
-// ../common/src/enums/chain.ts
-var Chain = /* @__PURE__ */ ((Chain2) => {
-  Chain2["evm"] = "evm";
-  Chain2["svm"] = "svm";
-  return Chain2;
-})(Chain || {});
-
-// ../common/src/enums/market-status.ts
-var MatchStatus = /* @__PURE__ */ ((MatchStatus3) => {
-  MatchStatus3["pending"] = "pending";
-  MatchStatus3["unmatched"] = "unmatched";
-  MatchStatus3["review"] = "review";
-  MatchStatus3["matched"] = "matched";
-  MatchStatus3["verified"] = "verified";
-  MatchStatus3["rejected"] = "rejected";
-  return MatchStatus3;
-})(MatchStatus || {});
-var MatchType = /* @__PURE__ */ ((MatchType2) => {
-  MatchType2["manual"] = "manual";
-  MatchType2["llm"] = "llm";
-  return MatchType2;
-})(MatchType || {});
-var CONFIRMED_MATCH_STATUSES = ["matched" /* matched */, "verified" /* verified */];
-var MarketStatus = /* @__PURE__ */ ((MarketStatus3) => {
-  MarketStatus3["open"] = "open";
-  MarketStatus3["closed"] = "closed";
-  MarketStatus3["resolved"] = "resolved";
-  MarketStatus3["unopened"] = "unopened";
-  MarketStatus3["paused"] = "paused";
-  return MarketStatus3;
-})(MarketStatus || {});
-
-// ../common/src/enums/trading.ts
-var OrderStatus = /* @__PURE__ */ ((OrderStatus2) => {
-  OrderStatus2["pending"] = "pending";
-  OrderStatus2["signing"] = "signing";
-  OrderStatus2["pending_bridge"] = "pending_bridge";
-  OrderStatus2["submitting"] = "submitting";
-  OrderStatus2["submitted"] = "submitted";
-  OrderStatus2["open"] = "open";
-  OrderStatus2["partially_filled_open"] = "partially_filled_open";
-  OrderStatus2["cancel_pending"] = "cancel_pending";
-  OrderStatus2["filled"] = "filled";
-  OrderStatus2["partial_fill"] = "partial_fill";
-  OrderStatus2["failed"] = "failed";
-  OrderStatus2["expired"] = "expired";
-  OrderStatus2["cancelled"] = "cancelled";
-  return OrderStatus2;
-})(OrderStatus || {});
-var TradeSide = /* @__PURE__ */ ((TradeSide2) => {
-  TradeSide2["Buy"] = "buy";
-  TradeSide2["Sell"] = "sell";
-  return TradeSide2;
-})(TradeSide || {});
-var OrderType = /* @__PURE__ */ ((OrderType2) => {
-  OrderType2["Market"] = "market";
-  OrderType2["Limit"] = "limit";
-  return OrderType2;
-})(OrderType || {});
-var TimeInForce = /* @__PURE__ */ ((TimeInForce2) => {
-  TimeInForce2["GTC"] = "GTC";
-  TimeInForce2["GTD"] = "GTD";
-  TimeInForce2["FOK"] = "FOK";
-  TimeInForce2["FAK"] = "FAK";
-  TimeInForce2["IOC"] = "IOC";
-  TimeInForce2["ALO"] = "ALO";
-  return TimeInForce2;
-})(TimeInForce || {});
-
-// ../common/src/utils/format-market-display.ts
-function formatOutcomeLabel(venue, outcome, _market) {
-  return outcome.label;
-}
-function formatMarketQuestion(venue, market) {
-  var _a, _b, _c, _d;
-  if ((_a = market.shortTitle) == null ? void 0 : _a.trim()) return market.shortTitle.trim();
-  if (venue === "kalshi" /* kalshi */) {
-    const firstTitle = (_d = (_c = (_b = market.venueMarketOutcomes) == null ? void 0 : _b[0]) == null ? void 0 : _c.title) == null ? void 0 : _d.trim();
-    if (firstTitle) return firstTitle;
-  }
-  return market.question.trim();
-}
-function formatOutcomeTitle(_venue, outcome, market) {
-  var _a, _b;
-  const outcomes = (_a = market.venueMarketOutcomes) != null ? _a : [];
-  if (outcomes.length >= 2) {
-    const normalized = outcomes.map((o) => {
-      var _a2, _b2;
-      return (_b2 = (_a2 = o.title) == null ? void 0 : _a2.trim()) != null ? _b2 : "";
-    });
-    const hasAnyTitle = normalized.some((t) => t.length > 0);
-    if (hasAnyTitle && normalized.every((t) => t === normalized[0])) return null;
-  }
-  const title = (_b = outcome.title) == null ? void 0 : _b.trim();
-  if (title) return title;
-  return deriveOverUnderTitle(outcome.label, market.question);
-}
-var OVER_UNDER_QUESTION = /\bO\/U\s+\d/i;
-function deriveOverUnderTitle(label, question) {
-  if (!question || !OVER_UNDER_QUESTION.test(question)) return null;
-  const normalized = label.trim().toLowerCase();
-  if (normalized === "yes") return "Over";
-  if (normalized === "no") return "Under";
-  return null;
-}
-
-// ../common/src/utils/auth.ts
-function getWalletAddressFromUserProfile(user) {
-  var _a, _b, _c, _d, _e;
-  const oauthWallet = (_b = (_a = user == null ? void 0 : user.accounts) == null ? void 0 : _a.find(
-    (a) => a.type === "oauth" /* oauth */ && String(a.provider).toLowerCase() === "wallet"
-  )) != null ? _b : null;
-  if (oauthWallet == null ? void 0 : oauthWallet.providerAccountId) return oauthWallet.providerAccountId;
-  const siweAccount = (_d = (_c = user == null ? void 0 : user.accounts) == null ? void 0 : _c.find((a) => a.type === "siwe" /* siwe */)) != null ? _d : null;
-  return (_e = siweAccount == null ? void 0 : siweAccount.providerAccountId) != null ? _e : void 0;
-}
-
-// ../common/src/utils/validate.ts
-function safeParse(value, guard) {
-  if (guard(value)) return { success: true, data: value };
-  return { success: false };
-}
-function parse(value, guard, message = "Validation failed") {
-  if (guard(value)) return value;
-  const err = new Error(message);
-  err.issues = [{ message }];
-  throw err;
-}
-function isEnum(values) {
-  return (v) => typeof v === "string" && values.has(v);
-}
-function enumGuard(source) {
-  const values = new Set(Array.isArray(source) ? source : Object.values(source));
-  return isEnum(values);
-}
-function isFiniteNonNeg(v) {
-  return typeof v === "number" && Number.isFinite(v) && v >= 0;
-}
-function isNonEmptyString(v) {
-  return typeof v === "string" && v.length > 0;
-}
-function hasShape(v, checks) {
-  if (typeof v !== "object" || v === null) return false;
-  const obj = v;
-  for (const [key, check] of Object.entries(checks)) {
-    if (!(key in obj) || !check(obj[key])) return false;
-  }
-  return true;
+// src/retry-after.ts
+function parseRetryAfterSeconds(value) {
+  if (typeof value !== "number" || !Number.isFinite(value) || value < 0) return void 0;
+  const milliseconds = value * 1e3;
+  return Number.isSafeInteger(milliseconds) ? milliseconds : void 0;
 }
-var EMAIL_MSG = "Enter a valid email address.";
-var EMAIL_MAX_LEN = 254;
-function isEmail(v) {
-  const n = v.length;
-  if (n === 0 || n > EMAIL_MAX_LEN) return false;
-  let atIdx = -1;
-  for (let i = 0; i < n; i++) {
-    const c = v.charCodeAt(i);
-    if (c === 32 || c >= 9 && c <= 13) return false;
-    if (c === 64) {
-      if (atIdx !== -1) return false;
-      atIdx = i;
-    }
-  }
-  if (atIdx <= 0 || atIdx === n - 1) return false;
-  for (let i = atIdx + 2; i < n - 1; i++) {
-    if (v.charCodeAt(i) === 46) return true;
-  }
-  return false;
-}
-function parseEmail(raw) {
-  const email = raw.trim();
-  if (!isEmail(email)) {
-    return { success: false, error: { issues: [{ message: EMAIL_MSG }] } };
-  }
-  return { success: true, data: { email } };
-}
-function parseEmailStrict(raw) {
-  var _a;
-  const result = parseEmail(raw);
-  if (!result.success) {
-    const err = new Error(EMAIL_MSG);
-    err.issues = (_a = result.error) == null ? void 0 : _a.issues;
-    throw err;
-  }
-  return result.data;
+function parseRetryAfterHeader(value, now = Date.now()) {
+  if (!value) return void 0;
+  const text = value.trim();
+  if (/^\d+$/.test(text)) return parseRetryAfterSeconds(Number(text));
+  if (!/^(Mon|Tue|Wed|Thu|Fri|Sat|Sun), \d{2} (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec) \d{4} \d{2}:\d{2}:\d{2} GMT$/.test(
+    text
+  ))
+    return void 0;
+  const timestamp = Date.parse(text);
+  if (!Number.isFinite(timestamp) || new Date(timestamp).toUTCString() !== text) return void 0;
+  const milliseconds = timestamp - now;
+  return Number.isSafeInteger(milliseconds) && milliseconds >= 0 ? milliseconds : void 0;
 }
 
-// ../common/src/utils/trading-splits.ts
-function computeBestSplitsByAmount(selections, side, maxDollarAmount) {
-  var _a;
-  if (selections.length === 0 || maxDollarAmount <= 0) {
-    return { splits: [], totalSize: 0, totalCost: 0 };
-  }
-  const levels = [];
-  for (const o of selections) {
-    const venue = o.market.venue;
-    const venueMarketOutcomeId = o.outcome.id;
-    const outcomeExternalIdentifier = (_a = o.outcome.externalIdentifier) != null ? _a : void 0;
-    if (side === "buy" /* Buy */) {
-      [...o.orderbook.asks].sort((a, b) => a.price - b.price).forEach(
-        (l) => {
-          var _a2;
-          return levels.push({
-            venue,
-            venueMarketOutcomeId,
-            outcomeExternalIdentifier,
-            price: l.price,
-            size: l.size,
-            negRisk: (_a2 = o.orderbook.negRisk) != null ? _a2 : false
-          });
-        }
-      );
-    } else {
-      [...o.orderbook.bids].sort((a, b) => b.price - a.price).forEach(
-        (l) => {
-          var _a2;
-          return levels.push({
-            venue,
-            venueMarketOutcomeId,
-            outcomeExternalIdentifier,
-            price: 1 - l.price,
-            size: l.size,
-            negRisk: (_a2 = o.orderbook.negRisk) != null ? _a2 : false
-          });
-        }
-      );
-    }
-  }
-  levels.sort((a, b) => a.price - b.price);
-  let totalCost = 0;
-  const fills = [];
-  for (const l of levels) {
-    if (totalCost >= maxDollarAmount) break;
-    const remainingBudget = maxDollarAmount - totalCost;
-    const maxSizeAtLevel = Math.min(l.size, remainingBudget / l.price);
-    if (maxSizeAtLevel <= 0) continue;
-    const take = maxSizeAtLevel;
-    fills.push({
-      venue: l.venue,
-      venueMarketOutcomeId: l.venueMarketOutcomeId,
-      outcomeExternalIdentifier: l.outcomeExternalIdentifier,
-      price: l.price,
-      size: take,
-      negRisk: l.negRisk
-    });
-    totalCost += l.price * take;
-  }
-  if (fills.length === 0) {
-    return { splits: [], totalSize: 0, totalCost: 0 };
-  }
-  const byOutcome = {};
-  for (const f of fills) {
-    const key = `${f.venue}:${f.venueMarketOutcomeId}`;
-    const existing = byOutcome[key];
-    if (!existing) {
-      byOutcome[key] = {
-        size: f.size,
-        venue: f.venue,
-        venueMarketOutcomeId: f.venueMarketOutcomeId,
-        outcomeExternalIdentifier: f.outcomeExternalIdentifier,
-        negRisk: f.negRisk
-      };
-    } else {
-      existing.size += f.size;
-    }
-  }
-  const splits = [];
-  let totalSize = 0;
-  for (const key in byOutcome) {
-    const { size, venue, venueMarketOutcomeId, outcomeExternalIdentifier, negRisk } = byOutcome[key];
-    totalSize += size;
-    let price = 0;
-    if (size > 0) {
-      const outcomeFills = fills.filter(
-        (f) => f.venue === venue && f.venueMarketOutcomeId === venueMarketOutcomeId
-      );
-      if (side === "buy" /* Buy */) {
-        const rawPrice = Math.max(...outcomeFills.map((f) => f.price));
-        price = Math.ceil(rawPrice * 100) / 100;
-      } else {
-        const rawPrice = Math.min(...outcomeFills.map((f) => 1 - f.price));
-        price = Math.floor(rawPrice * 100) / 100;
-      }
-    }
-    splits.push({
-      venue,
-      venueMarketOutcomeId,
-      side,
-      price,
-      size,
-      negRisk,
-      outcomeExternalIdentifier
-    });
-  }
-  return {
-    splits,
-    totalSize,
-    totalCost
-  };
-}
-
-// ../common/src/utils/image-url.ts
-function pickVariant(px) {
-  if (px <= 44 /* sm */) return 44 /* sm */;
-  if (px <= 48 /* md */) return 48 /* md */;
-  if (px <= 60 /* lg */) return 60 /* lg */;
-  return 0 /* original */;
-}
-var VARIANT_RE = /\/(original|raw|\d+)\.webp$/;
-function optimizedImageUrl(url, maxPx) {
-  if (!url) return void 0;
-  if (!VARIANT_RE.test(url)) return url;
-  const variant = pickVariant(maxPx);
-  const filename = variant === 0 /* original */ ? "original.webp" : `${variant}.webp`;
-  return url.replace(VARIANT_RE, `/${filename}`);
-}
-
-// ../common/src/utils/venue-market-cluster.ts
-var toNonEmptyString = (value) => {
-  if (typeof value !== "string") return void 0;
-  const trimmedValue = value.trim();
-  return trimmedValue ? trimmedValue : void 0;
-};
-var addGraphEdge = (adjacencyById, fromMarketId, toMarketId) => {
-  var _a, _b;
-  if (fromMarketId === toMarketId) return;
-  const fromNeighbors = (_a = adjacencyById.get(fromMarketId)) != null ? _a : /* @__PURE__ */ new Set();
-  fromNeighbors.add(toMarketId);
-  adjacencyById.set(fromMarketId, fromNeighbors);
-  const toNeighbors = (_b = adjacencyById.get(toMarketId)) != null ? _b : /* @__PURE__ */ new Set();
-  toNeighbors.add(fromMarketId);
-  adjacencyById.set(toMarketId, toNeighbors);
-};
-var collectDirectRelationMarkets = (market) => {
-  var _a, _b, _c;
-  const relationMarkets = [];
-  const seenRelationIds = /* @__PURE__ */ new Set();
-  const addRelationMarket = (relationMarket) => {
-    if (!relationMarket) return;
-    if (seenRelationIds.has(relationMarket.id)) return;
-    seenRelationIds.add(relationMarket.id);
-    relationMarkets.push(relationMarket);
-  };
-  for (const matchedVenueMarket of (_a = market.matchedVenueMarkets) != null ? _a : []) {
-    addRelationMarket(matchedVenueMarket);
-  }
-  addRelationMarket((_c = (_b = market.matchEntry) == null ? void 0 : _b.targetVenueMarket) != null ? _c : void 0);
-  return relationMarkets;
-};
-var dedupeSourceMarketsById = (markets) => {
-  const seenMarketIds = /* @__PURE__ */ new Set();
-  return markets.filter((market) => {
-    if (seenMarketIds.has(market.id)) {
-      return false;
-    }
-    seenMarketIds.add(market.id);
-    return true;
-  });
-};
-var collectUniqueRelatedMarkets = (markets, sourceMarketsById) => {
-  const relatedMarketsById = /* @__PURE__ */ new Map();
-  for (const market of markets) {
-    for (const relatedMarket of collectDirectRelationMarkets(market)) {
-      if (sourceMarketsById.has(relatedMarket.id) || relatedMarketsById.has(relatedMarket.id)) {
-        continue;
-      }
-      relatedMarketsById.set(relatedMarket.id, relatedMarket);
-    }
-  }
-  return Array.from(relatedMarketsById.values());
-};
-var normalizeVenueMarketCluster = (markets, selectedMarketId) => {
-  var _a, _b;
-  if (markets.length === 0) return [];
-  const orderedSourceMarkets = dedupeSourceMarketsById(markets);
-  const sourceMarketsById = new Map(orderedSourceMarkets.map((market) => [market.id, market]));
-  const orderedRelatedMarkets = collectUniqueRelatedMarkets(
-    orderedSourceMarkets,
-    sourceMarketsById
-  );
-  const relatedMarketsById = new Map(orderedRelatedMarkets.map((market) => [market.id, market]));
-  const resolvedSelectedMarketId = toNonEmptyString(selectedMarketId);
-  if (!resolvedSelectedMarketId) {
-    return [...orderedSourceMarkets, ...orderedRelatedMarkets];
-  }
-  const adjacencyById = /* @__PURE__ */ new Map();
-  for (const market of orderedSourceMarkets) {
-    for (const relatedMarket of collectDirectRelationMarkets(market)) {
-      addGraphEdge(adjacencyById, market.id, relatedMarket.id);
-    }
-    const targetVenueMarketId = toNonEmptyString((_a = market.matchEntry) == null ? void 0 : _a.targetVenueMarketId);
-    if (targetVenueMarketId) {
-      addGraphEdge(adjacencyById, market.id, targetVenueMarketId);
-    }
-  }
-  if (!sourceMarketsById.has(resolvedSelectedMarketId) && !relatedMarketsById.has(resolvedSelectedMarketId)) {
-    return [];
-  }
-  const visitedMarketIds = /* @__PURE__ */ new Set();
-  const queue = [resolvedSelectedMarketId];
-  while (queue.length > 0) {
-    const currentMarketId = queue.shift();
-    if (!currentMarketId || visitedMarketIds.has(currentMarketId)) {
-      continue;
-    }
-    visitedMarketIds.add(currentMarketId);
-    const neighborMarketIds = adjacencyById.get(currentMarketId);
-    for (const neighborMarketId of Array.from(neighborMarketIds != null ? neighborMarketIds : /* @__PURE__ */ new Set())) {
-      if (!visitedMarketIds.has(neighborMarketId)) {
-        queue.push(neighborMarketId);
-      }
-    }
-  }
-  const orderedClusterMarkets = [];
-  const appendedMarketIds = /* @__PURE__ */ new Set();
-  const appendMarket = (market) => {
-    if (!market) return;
-    if (!visitedMarketIds.has(market.id)) return;
-    if (appendedMarketIds.has(market.id)) return;
-    appendedMarketIds.add(market.id);
-    orderedClusterMarkets.push(market);
-  };
-  appendMarket(
-    (_b = sourceMarketsById.get(resolvedSelectedMarketId)) != null ? _b : relatedMarketsById.get(resolvedSelectedMarketId)
-  );
-  for (const market of orderedSourceMarkets) {
-    appendMarket(market);
-  }
-  for (const market of orderedRelatedMarkets) {
-    appendMarket(market);
-  }
-  return orderedClusterMarkets;
-};
-
-// ../common/src/utils/sort-venues.ts
-var VENUE_SORT_ORDER = [
-  "polymarket" /* polymarket */,
-  "hyperliquid" /* hyperliquid */,
-  "predict" /* predict */,
-  "prophetx" /* prophetx */,
-  "kalshi" /* kalshi */,
-  "limitless" /* limitless */,
-  "myriad" /* myriad */,
-  "pred" /* pred */,
-  "probable" /* probable */,
-  "novig" /* novig */,
-  "opinion" /* opinion */
-];
-var venueOrderIndex = new Map(VENUE_SORT_ORDER.map((v, i) => [v, i]));
-var getVenueOrder = (venue) => {
-  var _a;
-  return (_a = venueOrderIndex.get(venue)) != null ? _a : VENUE_SORT_ORDER.length;
-};
-var sortVenues = (venues) => [...venues].sort((a, b) => getVenueOrder(a) - getVenueOrder(b));
-
-// ../common/src/utils/venue-url.ts
-function buildVenueUrl(venue, opts) {
-  switch (venue) {
-    case "kalshi": {
-      const series = opts.seriesExternalId;
-      const event = opts.eventExternalId;
-      if (series && event) {
-        return `https://kalshi.com/markets/${series.toLowerCase()}/${event.toLowerCase()}`;
-      }
-      return null;
-    }
-    case "polymarket": {
-      if (opts.eventSlug) return `https://polymarket.com/event/${opts.eventSlug}`;
-      if (opts.conditionId) return `https://polymarket.com/market/${opts.conditionId}`;
-      return null;
-    }
-    case "predict": {
-      if (opts.eventSlug) return `https://predict.fun/market/${opts.eventSlug}`;
-      return null;
-    }
-    case "pred": {
-      if (opts.eventSlug) return `https://www.pred.app/trade/${opts.eventSlug}`;
-      return null;
-    }
-    case "limitless": {
-      if (opts.eventSlug) return `https://limitless.exchange/markets/${opts.eventSlug}`;
-      return null;
-    }
-    case "opinion": {
-      if (opts.eventSlug) return `https://www.opinion.trade/market/${opts.eventSlug}`;
-      return null;
-    }
-    case "myriad": {
-      if (opts.eventSlug) return `https://myriad.markets/markets/${opts.eventSlug}`;
-      return null;
-    }
-    case "hyperliquid": {
-      if (opts.eventSlug) return `https://app.hyperliquid.xyz/trade/${opts.eventSlug}`;
-      return null;
-    }
-    case "probable": {
-      if (opts.eventSlug) return `https://probable.markets/event/${opts.eventSlug}`;
-      return null;
-    }
-    case "novig": {
-      if (opts.outcomeExternalId && opts.partnerId) {
-        return opts.platform === "native" ? `novigapp://events/${opts.outcomeExternalId}/${opts.partnerId}` : `https://novig.com/events/${opts.outcomeExternalId}/${opts.partnerId}`;
-      }
-      return null;
-    }
-    default:
-      return null;
-  }
-}
-
-// ../common/src/utils/limit-price-ticks.ts
-var LIMIT_PRICE_RAW_SCALE = BigInt(1e6);
-var resolveTickSizeRaw = (tickSize) => {
-  const scaledTick = tickSize * Number(LIMIT_PRICE_RAW_SCALE);
-  const roundedTick = Math.round(scaledTick);
-  if (!Number.isFinite(scaledTick) || roundedTick <= 0 || Math.abs(scaledTick - roundedTick) > 1e-6) {
-    throw new RangeError(`Unsupported limit-order tick size: ${tickSize}`);
-  }
-  return BigInt(roundedTick);
-};
-var adjustLimitPriceRawToTick = ({
-  limitPriceRaw,
-  side,
-  tickSize
-}) => {
-  const originalPrice = BigInt(limitPriceRaw);
-  const originalPriceRaw = originalPrice.toString();
-  if (tickSize == null) {
-    return {
-      adjusted: false,
-      adjustedPriceRaw: originalPriceRaw,
-      originalPriceRaw,
-      tickSizeRaw: null
-    };
-  }
-  const tickSizeRaw = resolveTickSizeRaw(tickSize);
-  const remainder = originalPrice % tickSizeRaw;
-  if (remainder === BigInt(0)) {
-    return {
-      adjusted: false,
-      adjustedPriceRaw: originalPriceRaw,
-      originalPriceRaw,
-      tickSizeRaw: tickSizeRaw.toString()
-    };
-  }
-  const adjustedPrice = side === "buy" ? originalPrice - remainder : originalPrice + (tickSizeRaw - remainder);
-  return {
-    adjusted: true,
-    adjustedPriceRaw: adjustedPrice.toString(),
-    originalPriceRaw,
-    tickSizeRaw: tickSizeRaw.toString()
-  };
-};
-
-// ../common/src/utils/balance-refill.ts
-var DEFAULT_BALANCE_REFILL_DAILY_CAP_RAW = "1002000000";
-var DEFAULT_BALANCE_REFILL_MAX_FEE_RAW = "2000000";
-var getBalanceRefillMaximumRaw = (dailyCapRaw, maxFeeRaw) => {
-  const dailyCap = BigInt(dailyCapRaw);
-  const maximumFee = BigInt(maxFeeRaw);
-  if (dailyCap <= maximumFee) return "0";
-  return (dailyCap - maximumFee).toString();
-};
-var isBalanceRefillWithinDailyCap = (minimumRaw, refillAmountRaw, dailyCapRaw, maxFeeRaw) => {
-  const maximum = BigInt(getBalanceRefillMaximumRaw(dailyCapRaw, maxFeeRaw));
-  return BigInt(minimumRaw) <= maximum && BigInt(refillAmountRaw) <= maximum;
-};
-
 // src/errors.ts
 var TurnstileChallengeError = class extends Error {
   constructor(siteKey) {
@@ -700,6 +102,7 @@ var AggApiError = class _AggApiError extends Error {
     this.status = status;
     if (init.code !== void 0) this.code = init.code;
     if (init.retryable !== void 0) this.retryable = init.retryable;
+    if (init.retryAfterMs !== void 0) this.retryAfterMs = init.retryAfterMs;
     if (init.errors !== void 0) this.errors = init.errors;
     Object.setPrototypeOf(this, _AggApiError.prototype);
   }
@@ -855,931 +258,6 @@ var RECURRENCE_CADENCES = [
   "P1Y"
 ];
 
-// src/orderbook-utils.ts
-var PRICE_KEY_SCALE = 1e9;
-function crc32(str) {
-  let crc = 4294967295;
-  for (let i = 0; i < str.length; i++) {
-    crc ^= str.charCodeAt(i);
-    for (let j = 0; j < 8; j++) {
-      crc = crc >>> 1 ^ (crc & 1 ? 3988292384 : 0);
-    }
-  }
-  return (crc ^ 4294967295) >>> 0;
-}
-function computeChecksum(book) {
-  let checksum = 0;
-  for (const b of book.bids) checksum ^= crc32(`B${b.price}:${b.size}`);
-  for (const a of book.asks) checksum ^= crc32(`A${a.price}:${a.size}`);
-  return checksum >>> 0;
-}
-function attributedToLevel(wire) {
-  return { price: wire[0], size: wire[1], venues: __spreadValues({}, wire[2]) };
-}
-function venueLevelToLevel(wire) {
-  return { price: wire[0], size: wire[1] };
-}
-function convertVenueBooks(raw) {
-  const result = {};
-  for (const [venue, book] of Object.entries(raw)) {
-    result[venue] = {
-      bids: book.bids.map(venueLevelToLevel),
-      asks: book.asks.map(venueLevelToLevel)
-    };
-  }
-  return result;
-}
-function snapshotToOrderbook(snapshot) {
-  return {
-    marketId: snapshot.outcomeId,
-    outcomeId: snapshot.outcomeId,
-    bids: snapshot.bids.map(attributedToLevel),
-    asks: snapshot.asks.map(attributedToLevel),
-    venueOrderbooks: convertVenueBooks(snapshot.venueOrderbooks),
-    venues: __spreadValues({}, snapshot.venues),
-    midpoint: snapshot.midpoint,
-    spread: snapshot.spread,
-    seq: snapshot.seq,
-    checksum: snapshot.checksum,
-    timestamp: snapshot.timestamp
-  };
-}
-function applyOrderbookDelta(state, delta) {
-  var _a, _b;
-  const bids = applyChanges([...state.bids], delta.bidChanges, "desc");
-  const asks = applyChanges([...state.asks], delta.askChanges, "asc");
-  const impliedBidChangesByVenue = deriveVenueChangesFromAttributedChanges(
-    state.bids,
-    delta.bidChanges
-  );
-  const impliedAskChangesByVenue = deriveVenueChangesFromAttributedChanges(
-    state.asks,
-    delta.askChanges
-  );
-  const venueOrderbooks = __spreadValues({}, state.venueOrderbooks);
-  const venuesWithDelta = /* @__PURE__ */ new Set([
-    ...Object.keys(delta.venueDeltaBooks),
-    ...Object.keys(impliedBidChangesByVenue),
-    ...Object.keys(impliedAskChangesByVenue)
-  ]);
-  for (const venue of venuesWithDelta) {
-    const explicitChanges = delta.venueDeltaBooks[venue];
-    const bidChanges = mergeVenueLevelChanges(
-      explicitChanges == null ? void 0 : explicitChanges.bidChanges,
-      impliedBidChangesByVenue[venue]
-    );
-    const askChanges = mergeVenueLevelChanges(
-      explicitChanges == null ? void 0 : explicitChanges.askChanges,
-      impliedAskChangesByVenue[venue]
-    );
-    if (bidChanges.length === 0 && askChanges.length === 0) continue;
-    const existing = (_a = venueOrderbooks[venue]) != null ? _a : { bids: [], asks: [] };
-    venueOrderbooks[venue] = {
-      bids: applyVenueChanges([...existing.bids], bidChanges, "desc"),
-      asks: applyVenueChanges([...existing.asks], askChanges, "asc")
-    };
-  }
-  return {
-    marketId: state.marketId,
-    outcomeId: (_b = state.outcomeId) != null ? _b : delta.outcomeId,
-    bids,
-    asks,
-    venueOrderbooks,
-    venues: __spreadValues(__spreadValues({}, state.venues), delta.venues),
-    midpoint: delta.midpoint,
-    spread: delta.spread,
-    seq: delta.seq,
-    checksum: delta.checksum,
-    timestamp: delta.timestamp
-  };
-}
-function toPriceKey(price) {
-  return String(Math.round(price * PRICE_KEY_SCALE));
-}
-function applyChanges(levels, changes, sort) {
-  const levelsByPrice = new Map(levels.map((level) => [toPriceKey(level.price), level]));
-  for (const [price, size, venues] of changes) {
-    const key = toPriceKey(price);
-    if (size === 0) {
-      levelsByPrice.delete(key);
-      continue;
-    }
-    levelsByPrice.set(key, {
-      price,
-      size,
-      venues: __spreadValues({}, venues != null ? venues : {})
-    });
-  }
-  levels = [...levelsByPrice.values()];
-  levels.sort(sort === "desc" ? (a, b) => b.price - a.price : (a, b) => a.price - b.price);
-  return levels;
-}
-function applyVenueChanges(levels, changes, sort) {
-  const levelsByPrice = new Map(levels.map((level) => [toPriceKey(level.price), level]));
-  for (const [price, size] of changes) {
-    const key = toPriceKey(price);
-    if (size === 0) {
-      levelsByPrice.delete(key);
-      continue;
-    }
-    levelsByPrice.set(key, { price, size });
-  }
-  levels = [...levelsByPrice.values()];
-  levels.sort(sort === "desc" ? (a, b) => b.price - a.price : (a, b) => a.price - b.price);
-  return levels;
-}
-function mergeVenueLevelChanges(primary, fallback) {
-  if (!(primary == null ? void 0 : primary.length)) return fallback ? [...fallback] : [];
-  if (!(fallback == null ? void 0 : fallback.length)) return [...primary];
-  const changesByPrice = /* @__PURE__ */ new Map();
-  for (const change of fallback) {
-    changesByPrice.set(toPriceKey(change[0]), change);
-  }
-  for (const change of primary) {
-    changesByPrice.set(toPriceKey(change[0]), change);
-  }
-  return [...changesByPrice.values()];
-}
-function deriveVenueChangesFromAttributedChanges(previousLevels, changes) {
-  var _a, _b;
-  const previousLevelsByPrice = new Map(
-    previousLevels.map((level) => [toPriceKey(level.price), level])
-  );
-  const venueChanges = {};
-  for (const [price, size, nextVenuesRaw] of changes) {
-    const key = toPriceKey(price);
-    const previousLevel = previousLevelsByPrice.get(key);
-    const previousVenues = (_a = previousLevel == null ? void 0 : previousLevel.venues) != null ? _a : {};
-    const nextVenues = nextVenuesRaw != null ? nextVenuesRaw : {};
-    const affectedVenues = /* @__PURE__ */ new Set([...Object.keys(previousVenues), ...Object.keys(nextVenues)]);
-    for (const venue of affectedVenues) {
-      const nextSize = Number((_b = nextVenues[venue]) != null ? _b : 0);
-      if (!Number.isFinite(nextSize)) continue;
-      if (!venueChanges[venue]) {
-        venueChanges[venue] = [];
-      }
-      venueChanges[venue].push([price, nextSize]);
-    }
-    if (size === 0) {
-      previousLevelsByPrice.delete(key);
-      continue;
-    }
-    previousLevelsByPrice.set(key, {
-      price,
-      size,
-      venues: __spreadValues({}, nextVenues)
-    });
-  }
-  return venueChanges;
-}
-
-// src/agg-websocket.ts
-var RECONNECT_BASE_MS = 1e3;
-var RECONNECT_MAX_MS = 3e4;
-var STALE_TIMEOUT_MS = 45e3;
-var ORDERBOOK_DEBUG_TOP_LEVELS = 5;
-var AggWebSocket = class {
-  constructor(options) {
-    this.ws = null;
-    // ── Subscription tracking ──
-    this.subs = /* @__PURE__ */ new Map();
-    this.pendingSubs = /* @__PURE__ */ new Set();
-    this.pendingTradeSubs = /* @__PURE__ */ new Set();
-    this.pendingResnapshots = /* @__PURE__ */ new Set();
-    // ── Post-connect batching (coalesces same-tick sub/unsub calls into one frame) ──
-    this.pendingFlushSubs = /* @__PURE__ */ new Set();
-    this.pendingFlushUnsubs = /* @__PURE__ */ new Set();
-    this.pendingFlushTradeSubs = /* @__PURE__ */ new Set();
-    this.pendingFlushTradeUnsubs = /* @__PURE__ */ new Set();
-    this.pendingFlushArbSubs = /* @__PURE__ */ new Set();
-    this.pendingFlushArbUnsubs = /* @__PURE__ */ new Set();
-    this.flushScheduled = false;
-    // ── Arb subscriptions ──
-    this.arbSubs = /* @__PURE__ */ new Map();
-    this.arbFeedCbs = /* @__PURE__ */ new Set();
-    /** Latest arb market update per marketId (last-value-wins, loss-tolerant). */
-    this.latestArb = /* @__PURE__ */ new Map();
-    // ── Orderbook state per market ──
-    this.books = /* @__PURE__ */ new Map();
-    /** Markets currently resyncing (awaiting snapshot after seq gap / checksum mismatch). */
-    this.resyncing = /* @__PURE__ */ new Set();
-    // ── Connection state ──
-    this.connecting = false;
-    this._connected = false;
-    this.reconnectAttempts = 0;
-    this.reconnectTimer = null;
-    this.staleTimer = null;
-    this.lastMessageTime = 0;
-    this.destroyed = false;
-    var _a, _b;
-    this.url = options.url;
-    this.callbacks = (_a = options.callbacks) != null ? _a : {};
-    this.initialToken = options.initialToken;
-    this.enableLogs = (_b = options.enableLogs) != null ? _b : false;
-  }
-  // ── Public API ──
-  get connected() {
-    return this._connected;
-  }
-  /** Get the current orderbook state for an outcome (or null if no snapshot received yet). */
-  getBook(outcomeId) {
-    var _a;
-    return (_a = this.books.get(outcomeId)) != null ? _a : null;
-  }
-  /** Whether an outcome is currently resyncing (waiting for fresh snapshot). */
-  isResyncing(outcomeId) {
-    return this.resyncing.has(outcomeId);
-  }
-  /** Get the latest arb update for a market (or null if none received yet). */
-  getArb(marketId) {
-    var _a;
-    return (_a = this.latestArb.get(marketId)) != null ? _a : null;
-  }
-  /**
-   * Subscribe to per-market arb updates for a given marketId.
-   * Ref-counted: multiple callers for the same marketId share one server subscription.
-   * Returns an unsubscribe function.
-   */
-  subscribeArb(marketId, cb) {
-    let entry = this.arbSubs.get(marketId);
-    if (!entry) {
-      entry = { refCount: 0, cbs: /* @__PURE__ */ new Set() };
-      this.arbSubs.set(marketId, entry);
-      this.ensureConnected();
-      if (this._connected) {
-        this.pendingFlushArbUnsubs.delete(marketId);
-        this.pendingFlushArbSubs.add(marketId);
-        this.scheduleFlush();
-      }
-    }
-    entry.cbs.add(cb);
-    entry.refCount++;
-    return () => {
-      const e = this.arbSubs.get(marketId);
-      if (!e) return;
-      e.cbs.delete(cb);
-      e.refCount--;
-      if (e.refCount <= 0) {
-        this.arbSubs.delete(marketId);
-        if (this._connected) {
-          if (this.pendingFlushArbSubs.has(marketId)) {
-            this.pendingFlushArbSubs.delete(marketId);
-          } else {
-            this.pendingFlushArbUnsubs.add(marketId);
-            this.scheduleFlush();
-          }
-        }
-      }
-    };
-  }
-  /**
-   * Subscribe to the global arb-feed batches.
-   * Only one server subscription is maintained regardless of how many callers.
-   * Returns an unsubscribe function.
-   */
-  subscribeArbFeed(cb) {
-    const wasEmpty = this.arbFeedCbs.size === 0;
-    this.arbFeedCbs.add(cb);
-    if (wasEmpty) {
-      this.ensureConnected();
-      if (this._connected) {
-        this.send({ action: "subscribe", channel: "arb-feed" });
-      }
-    }
-    return () => {
-      this.arbFeedCbs.delete(cb);
-      if (this.arbFeedCbs.size === 0 && this._connected) {
-        this.send({ action: "unsubscribe", channel: "arb-feed" });
-      }
-    };
-  }
-  /**
-   * Subscribe to a feed by outcome ID.
-   * @param outcomeId  The venueMarketOutcomeId to subscribe to.
-   * @param channel    "orderbook" (default) or "trades".
-   * Returns an unsubscribe function (ref-counted).
-   */
-  subscribe(outcomeId, channel = "orderbook") {
-    if (channel === "trades") {
-      return this._subscribeTrades(outcomeId);
-    }
-    let sub = this.subs.get(outcomeId);
-    if (!sub) {
-      sub = { refCount: 0, tradeRefs: 0 };
-      this.subs.set(outcomeId, sub);
-      this.pendingSubs.add(outcomeId);
-      this.ensureConnected();
-      if (this._connected) {
-        this.pendingFlushUnsubs.delete(outcomeId);
-        this.pendingFlushSubs.add(outcomeId);
-        this.pendingSubs.delete(outcomeId);
-        this.scheduleFlush();
-      }
-    }
-    sub.refCount++;
-    return () => {
-      const s = this.subs.get(outcomeId);
-      if (!s) return;
-      s.refCount--;
-      if (s.refCount <= 0 && s.tradeRefs <= 0) {
-        this.subs.delete(outcomeId);
-        this.books.delete(outcomeId);
-        this.resyncing.delete(outcomeId);
-        if (this._connected) {
-          if (this.pendingFlushSubs.has(outcomeId)) {
-            this.pendingFlushSubs.delete(outcomeId);
-          } else {
-            this.pendingFlushUnsubs.add(outcomeId);
-            this.scheduleFlush();
-          }
-        }
-        this.pendingSubs.delete(outcomeId);
-        this.pendingResnapshots.delete(outcomeId);
-      }
-    };
-  }
-  /**
-   * Subscribe to an outcome's trade feed.
-   * @deprecated Use `subscribe(outcomeId, "trades")` instead.
-   * Returns an unsubscribe function.
-   */
-  subscribeTrades(outcomeId) {
-    return this._subscribeTrades(outcomeId);
-  }
-  _subscribeTrades(outcomeId) {
-    let sub = this.subs.get(outcomeId);
-    if (!sub) {
-      sub = { refCount: 0, tradeRefs: 0 };
-      this.subs.set(outcomeId, sub);
-    }
-    if (sub.tradeRefs === 0) {
-      this.pendingTradeSubs.add(outcomeId);
-      this.ensureConnected();
-      if (this._connected) {
-        this.pendingFlushTradeUnsubs.delete(outcomeId);
-        this.pendingFlushTradeSubs.add(outcomeId);
-        this.pendingTradeSubs.delete(outcomeId);
-        this.scheduleFlush();
-      }
-    }
-    sub.tradeRefs++;
-    return () => {
-      const s = this.subs.get(outcomeId);
-      if (!s) return;
-      s.tradeRefs--;
-      if (s.tradeRefs <= 0) {
-        s.tradeRefs = 0;
-        if (this._connected) {
-          if (this.pendingFlushTradeSubs.has(outcomeId)) {
-            this.pendingFlushTradeSubs.delete(outcomeId);
-          } else {
-            this.pendingFlushTradeUnsubs.add(outcomeId);
-            this.scheduleFlush();
-          }
-        }
-        this.pendingTradeSubs.delete(outcomeId);
-        this.pendingResnapshots.delete(outcomeId);
-        if (s.refCount <= 0) {
-          this.subs.delete(outcomeId);
-        }
-      }
-    };
-  }
-  /** Send a JWT to authenticate (or re-authenticate) the connection. */
-  authenticate(token) {
-    if (this._connected) {
-      this.send({ action: "authenticate", token });
-    }
-  }
-  /** Request a fresh snapshot for one or more subscribed outcomes. */
-  resnapshot(outcomeIdOrIds) {
-    const outcomeIds = Array.isArray(outcomeIdOrIds) ? outcomeIdOrIds : [outcomeIdOrIds];
-    outcomeIds.forEach((outcomeId) => {
-      this.requestResnapshot(outcomeId, true);
-    });
-  }
-  /** Connect (idempotent). Called automatically on first subscribe. */
-  connect() {
-    this.ensureConnected();
-  }
-  /** Disconnect and clean up. Reusable — call connect() to reconnect. */
-  disconnect() {
-    var _a, _b;
-    this.cancelReconnect();
-    this.cancelStaleTimer();
-    this._connected = false;
-    this.connecting = false;
-    if (this.ws) {
-      this.ws.onclose = null;
-      this.ws.close();
-      this.ws = null;
-    }
-    (_b = (_a = this.callbacks).onConnectionStateChange) == null ? void 0 : _b.call(_a, false);
-  }
-  /** Permanently destroy. Cannot reconnect after this. */
-  destroy() {
-    this.destroyed = true;
-    this.disconnect();
-    this.subs.clear();
-    this.books.clear();
-    this.resyncing.clear();
-    this.pendingSubs.clear();
-    this.pendingTradeSubs.clear();
-    this.pendingResnapshots.clear();
-    this.pendingFlushSubs.clear();
-    this.pendingFlushUnsubs.clear();
-    this.pendingFlushTradeSubs.clear();
-    this.pendingFlushTradeUnsubs.clear();
-    this.arbSubs.clear();
-    this.arbFeedCbs.clear();
-    this.latestArb.clear();
-    this.pendingFlushArbSubs.clear();
-    this.pendingFlushArbUnsubs.clear();
-    this.flushScheduled = false;
-  }
-  /** Update callbacks (e.g., after React re-render). */
-  setCallbacks(callbacks) {
-    this.callbacks = callbacks;
-  }
-  // ── Connection management ──
-  ensureConnected() {
-    var _a;
-    if (this.destroyed) return;
-    if (((_a = this.ws) == null ? void 0 : _a.readyState) === WebSocket.OPEN || this.connecting) return;
-    this.doConnect();
-  }
-  doConnect() {
-    if (this.destroyed) return;
-    this.connecting = true;
-    const ws = new WebSocket(this.url);
-    this.ws = ws;
-    ws.onopen = () => {
-      this.connecting = false;
-      this.reconnectAttempts = 0;
-      this.resetStaleTimer();
-      if (this.initialToken) {
-        this.send({ action: "authenticate", token: this.initialToken });
-      }
-    };
-    ws.onmessage = (event) => {
-      this.lastMessageTime = Date.now();
-      this.resetStaleTimer();
-      try {
-        const raw = JSON.parse(event.data);
-        this.handleMessage(raw);
-      } catch (e) {
-      }
-    };
-    ws.onclose = () => {
-      var _a, _b;
-      this.ws = null;
-      this.connecting = false;
-      const wasConnected = this._connected;
-      this._connected = false;
-      this.cancelStaleTimer();
-      if (wasConnected) {
-        (_b = (_a = this.callbacks).onConnectionStateChange) == null ? void 0 : _b.call(_a, false);
-      }
-      if (!this.destroyed && (this.subs.size > 0 || this.arbSubs.size > 0 || this.arbFeedCbs.size > 0)) {
-        this.scheduleReconnect();
-      }
-    };
-    ws.onerror = () => {
-    };
-  }
-  scheduleReconnect() {
-    this.cancelReconnect();
-    const delay = Math.min(
-      RECONNECT_BASE_MS * Math.pow(2, this.reconnectAttempts),
-      RECONNECT_MAX_MS
-    );
-    this.reconnectAttempts++;
-    this.emitDiagnostic({ type: "reconnect", attempt: this.reconnectAttempts, delayMs: delay });
-    this.reconnectTimer = setTimeout(() => {
-      this.reconnectTimer = null;
-      this.doConnect();
-    }, delay);
-  }
-  cancelReconnect() {
-    if (this.reconnectTimer) {
-      clearTimeout(this.reconnectTimer);
-      this.reconnectTimer = null;
-    }
-  }
-  // ── Staleness detection ──
-  resetStaleTimer() {
-    this.cancelStaleTimer();
-    this.staleTimer = setTimeout(() => {
-      const age = Date.now() - this.lastMessageTime;
-      this.emitDiagnostic({ type: "stale_connection", lastMessageAge: age });
-      if (this.ws) {
-        this.ws.close();
-      }
-    }, STALE_TIMEOUT_MS);
-  }
-  cancelStaleTimer() {
-    if (this.staleTimer) {
-      clearTimeout(this.staleTimer);
-      this.staleTimer = null;
-    }
-  }
-  // ── Message handling ──
-  handleMessage(raw) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p;
-    const type = raw.type;
-    switch (type) {
-      case "orderbook_snapshot":
-        this.handleSnapshot(raw);
-        break;
-      case "orderbook_delta":
-        this.handleDelta(raw);
-        break;
-      case "trade":
-        this.handleTrade(raw);
-        break;
-      case "heartbeat":
-        this.handleHeartbeat(raw);
-        break;
-      case "subscribed":
-        (_b = (_a = this.callbacks).onSubscribed) == null ? void 0 : _b.call(_a, raw);
-        break;
-      case "unsubscribed":
-        (_d = (_c = this.callbacks).onUnsubscribed) == null ? void 0 : _d.call(_c, raw);
-        break;
-      case "connected":
-        this.handleConnected(raw);
-        break;
-      case "authenticated":
-        (_f = (_e = this.callbacks).onAuthenticated) == null ? void 0 : _f.call(_e, raw);
-        break;
-      case "market_resolved":
-        this.handleMarketResolved(raw);
-        break;
-      case "error":
-        (_h = (_g = this.callbacks).onError) == null ? void 0 : _h.call(_g, raw);
-        break;
-      case "order_submitted":
-        this.handleOrderSubmitted(raw);
-        break;
-      case "balance_update":
-        this.handleBalanceUpdate(raw);
-        break;
-      case "order_event":
-        (_j = (_i = this.callbacks).onOrderEvent) == null ? void 0 : _j.call(_i, raw);
-        break;
-      case "redeem_event":
-        this.handleRedeemEvent(raw);
-        break;
-      case "withdrawal_lifecycle":
-        (_l = (_k = this.callbacks).onWithdrawalLifecycle) == null ? void 0 : _l.call(_k, raw);
-        break;
-      case "arb_market_update": {
-        const arbMsg = raw;
-        this.latestArb.set(arbMsg.marketId, arbMsg);
-        const arbEntry = this.arbSubs.get(arbMsg.marketId);
-        if (arbEntry) {
-          for (const cb of arbEntry.cbs) cb(arbMsg);
-        }
-        (_n = (_m = this.callbacks).onArbMarket) == null ? void 0 : _n.call(_m, arbMsg);
-        break;
-      }
-      case "arb_feed_batch": {
-        const feedMsg = raw;
-        for (const cb of this.arbFeedCbs) cb(feedMsg);
-        (_p = (_o = this.callbacks).onArbFeed) == null ? void 0 : _p.call(_o, feedMsg);
-        break;
-      }
-    }
-  }
-  /**
-   * Server confirmed the connection — gateway has validated our appId and is
-   * ready to accept subscriptions. Now flush all pending subs.
-   */
-  handleConnected(msg) {
-    var _a, _b, _c, _d;
-    this._connected = true;
-    (_b = (_a = this.callbacks).onConnectionStateChange) == null ? void 0 : _b.call(_a, true);
-    (_d = (_c = this.callbacks).onConnected) == null ? void 0 : _d.call(_c, msg);
-    const orderbookSet = new Set(this.activeOrderbookMarkets());
-    this.pendingSubs.forEach((id) => orderbookSet.add(id));
-    this.pendingFlushSubs.forEach((id) => orderbookSet.add(id));
-    const orderbookIds = Array.from(orderbookSet);
-    if (orderbookIds.length > 0) {
-      this.sendSubscribe(orderbookIds);
-    }
-    this.pendingSubs.clear();
-    this.pendingFlushSubs.clear();
-    this.pendingFlushUnsubs.clear();
-    const tradeSet = new Set(this.activeTradeMarkets());
-    this.pendingTradeSubs.forEach((id) => tradeSet.add(id));
-    this.pendingFlushTradeSubs.forEach((id) => tradeSet.add(id));
-    const tradeIds = Array.from(tradeSet);
-    if (tradeIds.length > 0) {
-      this.send({ action: "subscribe", channel: "trades", outcomeIds: tradeIds });
-    }
-    this.pendingTradeSubs.clear();
-    this.pendingFlushTradeSubs.clear();
-    this.pendingFlushTradeUnsubs.clear();
-    const resnapshotIds = Array.from(this.pendingResnapshots);
-    if (resnapshotIds.length > 0) {
-      this.send({ action: "resnapshot", channel: "orderbook", outcomeIds: resnapshotIds });
-    }
-    this.pendingResnapshots.clear();
-    const arbSet = new Set(this.activeArbMarkets());
-    this.pendingFlushArbSubs.forEach((id) => arbSet.add(id));
-    const arbIds = Array.from(arbSet);
-    if (arbIds.length > 0) {
-      this.send({ action: "subscribe", channel: "arb", marketIds: arbIds });
-    }
-    this.pendingFlushArbSubs.clear();
-    this.pendingFlushArbUnsubs.clear();
-    if (this.arbFeedCbs.size > 0) {
-      this.send({ action: "subscribe", channel: "arb-feed" });
-    }
-  }
-  handleSnapshot(raw) {
-    var _a, _b;
-    const msg = __spreadProps(__spreadValues({}, raw), { timestamp: raw.timestamp / 1e3 });
-    const book = snapshotToOrderbook(msg);
-    this.books.set(msg.outcomeId, book);
-    this.resyncing.delete(msg.outcomeId);
-    this.pendingResnapshots.delete(msg.outcomeId);
-    this.debugOrderbook("snapshot_applied", {
-      outcomeId: msg.outcomeId,
-      seq: msg.seq,
-      checksum: msg.checksum,
-      bidsTop: this.summarizeTopLevels(book.bids),
-      asksTop: this.summarizeTopLevels(book.asks)
-    });
-    (_b = (_a = this.callbacks).onSnapshot) == null ? void 0 : _b.call(_a, msg.outcomeId, book);
-  }
-  handleDelta(raw) {
-    var _a, _b;
-    const outcomeId = raw.outcomeId;
-    const current = this.books.get(outcomeId);
-    const deltaTop = {
-      bids: raw.bidChanges.slice(0, ORDERBOOK_DEBUG_TOP_LEVELS).map(([price, size]) => ({
-        price,
-        size
-      })),
-      asks: raw.askChanges.slice(0, ORDERBOOK_DEBUG_TOP_LEVELS).map(([price, size]) => ({
-        price,
-        size
-      }))
-    };
-    this.debugOrderbook("delta_received", {
-      outcomeId,
-      seq: raw.seq,
-      checksum: raw.checksum,
-      hasCurrentBook: Boolean(current),
-      deltaTop
-    });
-    if (!current) {
-      this.debugOrderbook("delta_missing_snapshot", { outcomeId, seq: raw.seq });
-      this.requestResnapshot(outcomeId);
-      return;
-    }
-    if (raw.seq <= current.seq) {
-      this.debugOrderbook("delta_stale_ignored", {
-        outcomeId,
-        currentSeq: current.seq,
-        receivedSeq: raw.seq
-      });
-      return;
-    }
-    if (raw.seq > current.seq + 1) {
-      this.debugOrderbook("delta_seq_gap", {
-        outcomeId,
-        expectedSeq: current.seq + 1,
-        receivedSeq: raw.seq
-      });
-      this.emitDiagnostic({
-        type: "seq_gap",
-        marketId: outcomeId,
-        outcomeId,
-        expected: current.seq + 1,
-        received: raw.seq
-      });
-      this.requestResnapshot(outcomeId);
-      return;
-    }
-    const msg = __spreadProps(__spreadValues({}, raw), { timestamp: raw.timestamp / 1e3 });
-    const newBook = applyOrderbookDelta(current, msg);
-    this.debugOrderbook("delta_applied_locally", {
-      outcomeId,
-      fromSeq: current.seq,
-      toSeq: newBook.seq,
-      beforeTop: {
-        bids: this.summarizeTopLevels(current.bids),
-        asks: this.summarizeTopLevels(current.asks)
-      },
-      afterTop: {
-        bids: this.summarizeTopLevels(newBook.bids),
-        asks: this.summarizeTopLevels(newBook.asks)
-      }
-    });
-    const computed = computeChecksum(newBook);
-    if (computed !== msg.checksum) {
-      this.debugOrderbook("delta_checksum_mismatch", {
-        outcomeId,
-        seq: msg.seq,
-        expected: msg.checksum,
-        computed
-      });
-      this.emitDiagnostic({
-        type: "checksum_mismatch",
-        marketId: outcomeId,
-        outcomeId,
-        expected: msg.checksum,
-        computed
-      });
-      this.requestResnapshot(outcomeId);
-      return;
-    }
-    this.books.set(outcomeId, newBook);
-    this.debugOrderbook("delta_committed", {
-      outcomeId,
-      seq: newBook.seq,
-      checksum: newBook.checksum,
-      bidsTop: this.summarizeTopLevels(newBook.bids),
-      asksTop: this.summarizeTopLevels(newBook.asks)
-    });
-    (_b = (_a = this.callbacks).onDelta) == null ? void 0 : _b.call(_a, outcomeId, newBook);
-  }
-  handleTrade(raw) {
-    var _a, _b;
-    const msg = __spreadProps(__spreadValues({}, raw), { timestamp: raw.timestamp / 1e3 });
-    (_b = (_a = this.callbacks).onTrade) == null ? void 0 : _b.call(_a, msg);
-  }
-  handleHeartbeat(raw) {
-    var _a, _b;
-    const msg = __spreadProps(__spreadValues({}, raw), { ts: raw.ts / 1e3 });
-    (_b = (_a = this.callbacks).onHeartbeat) == null ? void 0 : _b.call(_a, msg);
-  }
-  handleMarketResolved(raw) {
-    var _a, _b;
-    const msg = __spreadProps(__spreadValues({}, raw), { timestamp: raw.timestamp / 1e3 });
-    this.books.delete(msg.outcomeId);
-    this.pendingResnapshots.delete(msg.outcomeId);
-    this.resyncing.delete(msg.outcomeId);
-    (_b = (_a = this.callbacks).onMarketResolved) == null ? void 0 : _b.call(_a, msg);
-  }
-  handleOrderSubmitted(raw) {
-    var _a, _b;
-    const msg = __spreadProps(__spreadValues({}, raw), { timestamp: raw.timestamp / 1e3 });
-    (_b = (_a = this.callbacks).onOrderSubmitted) == null ? void 0 : _b.call(_a, msg);
-  }
-  handleBalanceUpdate(raw) {
-    var _a, _b;
-    const msg = __spreadProps(__spreadValues({}, raw), { timestamp: raw.timestamp / 1e3 });
-    (_b = (_a = this.callbacks).onBalanceUpdate) == null ? void 0 : _b.call(_a, msg);
-  }
-  handleRedeemEvent(raw) {
-    var _a, _b;
-    const msg = __spreadProps(__spreadValues({}, raw), { timestamp: raw.timestamp / 1e3 });
-    (_b = (_a = this.callbacks).onRedeemEvent) == null ? void 0 : _b.call(_a, msg);
-  }
-  // ── Resnapshot ──
-  requestResnapshot(outcomeId, force = false) {
-    if (this.resyncing.has(outcomeId) && !force) return;
-    this.resyncing.add(outcomeId);
-    if (this._connected) {
-      this.send({ action: "resnapshot", channel: "orderbook", outcomeIds: [outcomeId] });
-      this.pendingResnapshots.delete(outcomeId);
-      return;
-    }
-    this.pendingResnapshots.add(outcomeId);
-    this.ensureConnected();
-  }
-  // ── Helpers ──
-  /**
-   * Schedule a microtask that flushes queued subscribe/unsubscribe frames.
-   * Coalesces multiple same-tick sub/unsub calls into at most one frame per
-   * channel+action pair.
-   */
-  scheduleFlush() {
-    if (this.flushScheduled) return;
-    this.flushScheduled = true;
-    queueMicrotask(() => {
-      this.flushScheduled = false;
-      if (!this._connected) {
-        this.pendingFlushSubs.clear();
-        this.pendingFlushUnsubs.clear();
-        this.pendingFlushTradeSubs.clear();
-        this.pendingFlushTradeUnsubs.clear();
-        this.pendingFlushArbSubs.clear();
-        this.pendingFlushArbUnsubs.clear();
-        return;
-      }
-      this.flushPending();
-    });
-  }
-  flushPending() {
-    for (const id of [...this.pendingFlushSubs]) {
-      if (this.pendingFlushUnsubs.has(id)) {
-        this.pendingFlushSubs.delete(id);
-        this.pendingFlushUnsubs.delete(id);
-      }
-    }
-    if (this.pendingFlushSubs.size > 0) {
-      this.sendSubscribe(Array.from(this.pendingFlushSubs));
-      this.pendingFlushSubs.clear();
-    }
-    if (this.pendingFlushUnsubs.size > 0) {
-      this.send({
-        action: "unsubscribe",
-        channel: "orderbook",
-        outcomeIds: Array.from(this.pendingFlushUnsubs)
-      });
-      this.pendingFlushUnsubs.clear();
-    }
-    for (const id of [...this.pendingFlushTradeSubs]) {
-      if (this.pendingFlushTradeUnsubs.has(id)) {
-        this.pendingFlushTradeSubs.delete(id);
-        this.pendingFlushTradeUnsubs.delete(id);
-      }
-    }
-    if (this.pendingFlushTradeSubs.size > 0) {
-      this.send({
-        action: "subscribe",
-        channel: "trades",
-        outcomeIds: Array.from(this.pendingFlushTradeSubs)
-      });
-      this.pendingFlushTradeSubs.clear();
-    }
-    if (this.pendingFlushTradeUnsubs.size > 0) {
-      this.send({
-        action: "unsubscribe",
-        channel: "trades",
-        outcomeIds: Array.from(this.pendingFlushTradeUnsubs)
-      });
-      this.pendingFlushTradeUnsubs.clear();
-    }
-    for (const id of [...this.pendingFlushArbSubs]) {
-      if (this.pendingFlushArbUnsubs.has(id)) {
-        this.pendingFlushArbSubs.delete(id);
-        this.pendingFlushArbUnsubs.delete(id);
-      }
-    }
-    if (this.pendingFlushArbSubs.size > 0) {
-      this.send({
-        action: "subscribe",
-        channel: "arb",
-        marketIds: Array.from(this.pendingFlushArbSubs)
-      });
-      this.pendingFlushArbSubs.clear();
-    }
-    if (this.pendingFlushArbUnsubs.size > 0) {
-      this.send({
-        action: "unsubscribe",
-        channel: "arb",
-        marketIds: Array.from(this.pendingFlushArbUnsubs)
-      });
-      this.pendingFlushArbUnsubs.clear();
-    }
-  }
-  sendSubscribe(outcomeIds) {
-    this.send({ action: "subscribe", channel: "orderbook", outcomeIds });
-  }
-  send(msg) {
-    var _a;
-    if (((_a = this.ws) == null ? void 0 : _a.readyState) === WebSocket.OPEN) {
-      this.ws.send(JSON.stringify(msg));
-    }
-  }
-  activeOrderbookMarkets() {
-    const markets = [];
-    this.subs.forEach((sub, id) => {
-      if (sub.refCount > 0) markets.push(id);
-    });
-    return markets;
-  }
-  activeTradeMarkets() {
-    const markets = [];
-    this.subs.forEach((sub, id) => {
-      if (sub.tradeRefs > 0) markets.push(id);
-    });
-    return markets;
-  }
-  activeArbMarkets() {
-    return Array.from(this.arbSubs.keys());
-  }
-  emitDiagnostic(event) {
-    var _a, _b;
-    (_b = (_a = this.callbacks).onDiagnostics) == null ? void 0 : _b.call(_a, event);
-  }
-  summarizeTopLevels(levels) {
-    return levels.slice(0, ORDERBOOK_DEBUG_TOP_LEVELS).map((level) => ({ price: level.price, size: level.size }));
-  }
-  debugOrderbook(event, payload) {
-    if (!this.isOrderbookDebugEnabled()) return;
-    console.debug(`[AggWebSocket][orderbook] ${event}`, payload);
-  }
-  isOrderbookDebugEnabled() {
-    return this.enableLogs;
-  }
-};
-
 // src/client.ts
 var COOKIE_REFRESH_DELIVERY = "cookie-refresh";
 var DEFAULT_MIDPOINT_IDS_PER_REQUEST = 75;
@@ -1870,7 +348,7 @@ var AggClient = class {
     this.authChannel = null;
     /** In-flight refresh promise — serializes concurrent 401 retries so only one refresh runs. */
     this.pendingRefresh = null;
-    var _a, _b;
+    var _a, _b, _c;
     if (!options.appId && !options.adminKey) {
       throw new Error("AggClient requires at least one of appId or adminKey");
     }
@@ -1880,9 +358,11 @@ var AggClient = class {
     this.signer = options.signer;
     this.baseUrl = options.baseUrl.replace(/\/$/, "");
     this.wsUrl = options.wsUrl;
+    this.preferImmutableHistory = (_a = options.preferImmutableHistory) != null ? _a : false;
+    this.webSocketFactory = options.webSocketFactory;
     this.authOptions = options.auth;
-    this.storageKey = `agg_auth_${(_a = this._appId) != null ? _a : "default"}`;
-    this.authDelivery = (_b = options.authDelivery) != null ? _b : "body";
+    this.storageKey = `agg_auth_${(_b = this._appId) != null ? _b : "default"}`;
+    this.authDelivery = (_c = options.authDelivery) != null ? _c : "body";
     this.shouldPersistSession = options.persistSession !== false;
     this.restoreSession();
     this.initAuthChannel();
@@ -2010,7 +490,7 @@ var AggClient = class {
    * @param path - API path (e.g. `/venue-events`)
    * @param init - Fetch init options, plus optional `query` object for URL search params
    */
-  request(path, init) {
+  request(path, init, decode) {
     return __async(this, null, function* () {
       const response = yield this.rawFetch(path, init);
       if (response.status === 401 && this.accessToken && !AUTH_PATHS.has(path)) {
@@ -2021,7 +501,7 @@ var AggClient = class {
             return this.throwResponseError(retryResponse);
           }
           if (retryResponse.status === 204) return void 0;
-          return retryResponse.json();
+          return decode ? decode(retryResponse) : retryResponse.json();
         } catch (e) {
           this.clearAccessToken();
           return this.throwResponseError(response);
@@ -2031,7 +511,7 @@ var AggClient = class {
         return this.throwResponseError(response);
       }
       if (response.status === 204) return void 0;
-      return response.json();
+      return decode ? decode(response) : response.json();
     });
   }
   rawFetch(path, init) {
@@ -2068,12 +548,15 @@ var AggClient = class {
   }
   throwResponseError(response) {
     return __async(this, null, function* () {
+      var _a;
       let message = response.status === 404 ? "Market not found" : `AGG API error: ${response.status} ${response.statusText}`;
       let code;
       let retryable;
+      let retryAfterMs = parseRetryAfterHeader((_a = response.headers) == null ? void 0 : _a.get("Retry-After"));
       let errors;
       try {
         const body = yield response.json();
+        retryAfterMs != null ? retryAfterMs : retryAfterMs = parseRetryAfterSeconds(body == null ? void 0 : body.retryAfter);
         if (typeof body.message === "string" && body.message.length > 0) {
           message = body.message;
         }
@@ -2092,7 +575,7 @@ var AggClient = class {
         }
       } catch (e) {
       }
-      throw new AggApiError(message, response.status, { code, retryable, errors });
+      throw new AggApiError(message, response.status, { code, retryable, retryAfterMs, errors });
     });
   }
   /**
@@ -2519,14 +1002,19 @@ Issued At: ${issuedAt}`;
    *
    * Pass `quoteId` to fetch every leg of a multi-venue split route in
    * one call — `useQuoteSummary(quoteId)` reduces the list into a
-   * rollup (total cost, share-weighted avg price, to-win).
+   * rollup (total cost, share-weighted avg price, to-win). Pass
+   * `venueMarketIds` to narrow to the orders on those markets. Sent as
+   * repeated params in one request; batch long lists yourself (or use
+   * `useExecutionOrdersForMarkets`) to keep the URL short.
    */
   getExecutionOrders() {
     return __async(this, arguments, function* (params = {}) {
+      var _a;
       const query = {};
       if (params.orderId) query.orderId = params.orderId;
       if (params.quoteId) query.quoteId = params.quoteId;
       if (params.externalId) query.externalId = params.externalId;
+      if ((_a = params.venueMarketIds) == null ? void 0 : _a.length) query.venueMarketIds = params.venueMarketIds;
       if (params.status) query.status = params.status;
       if (params.orderType) query.orderType = params.orderType;
       if (params.mode) query.mode = params.mode;
@@ -2563,6 +1051,23 @@ Issued At: ${issuedAt}`;
       });
     });
   }
+  /**
+   * Per-app trader leaderboard ranked by realized P&L or volume over an
+   * inclusive UTC day range. `rank` is exact within the top 100.
+   */
+  getLeaderboard() {
+    return __async(this, arguments, function* (params = {}) {
+      const query = {};
+      if (params.from) query.from = params.from;
+      if (params.to) query.to = params.to;
+      if (params.metric) query.metric = params.metric;
+      if (params.limit != null) query.limit = String(params.limit);
+      if (params.cursor) query.cursor = params.cursor;
+      return this.request("/leaderboard", {
+        query: Object.keys(query).length ? query : void 0
+      });
+    });
+  }
   /** List execution positions for the authenticated user (cursor pagination). */
   getExecutionPositions() {
     return __async(this, arguments, function* (params = {}) {
@@ -2576,16 +1081,92 @@ Issued At: ${issuedAt}`;
       });
     });
   }
-  /** Get managed wallet balances, including per-chain cash balances and per-venue position balances. */
+  /**
+   * Get cash balances and per-venue position balances.
+   *
+   * `custody: "self"` returns the wallets linked to this account — plus their
+   * Polymarket deposit and legacy wallets — instead of the managed wallet. Each
+   * chain row then carries `address` and `custodyKind`; `positions` is
+   * account-wide either way.
+   *
+   * Caveat on the headline number: a chain row with `custodyKind:
+   * "POLYMARKET_LEGACY"` and `legacyKind: "proxy"` holds funds that can only
+   * be spent on Polymarket, but it still counts towards its token's
+   * `totalRaw`/`availableRaw` (a token's totals are always the sum of its
+   * chain rows). If you show "spendable anywhere", subtract those rows.
+   */
   getManagedBalances() {
     return __async(this, arguments, function* (params = {}) {
       const query = {};
       if (params.mode) query.mode = params.mode;
+      if (params.custody) query.custody = params.custody;
       return this.request("/execution/balances", {
         query: Object.keys(query).length ? query : void 0
       });
     });
   }
+  /** Read hosted custody status without creating a signing wallet or account. */
+  getHostedVenueAccount(_0) {
+    return __async(this, arguments, function* (venue, params = {}) {
+      return this.request(
+        `/users/me/venue-accounts/${encodeURIComponent(venue)}`,
+        {
+          query: params.mode ? { mode: params.mode } : void 0
+        }
+      );
+    });
+  }
+  /** Owned exact ledger entries; not balances, fill fees or withdrawal finality. */
+  getHostedVenueActivity(_0) {
+    return __async(this, arguments, function* (venue, params = {}) {
+      return this.request(
+        `/users/me/venue-accounts/${encodeURIComponent(venue)}/activity`,
+        {
+          query: __spreadValues(__spreadValues({}, params.mode ? { mode: params.mode } : {}), params.page !== void 0 ? { page: String(params.page) } : {})
+        }
+      );
+    });
+  }
+  /** Explicit hosted-account creation; no signing wallet or credential upload. */
+  provisionHostedVenueAccount(venue, body) {
+    return __async(this, null, function* () {
+      return this.request(
+        `/users/me/venue-accounts/${encodeURIComponent(venue)}`,
+        {
+          method: "POST",
+          body: JSON.stringify(body)
+        }
+      );
+    });
+  }
+  /** Fetch the owned hosted account's verified Solana USDC deposit address. */
+  getHostedVenueDepositAddress(_0) {
+    return __async(this, arguments, function* (venue, params = {}) {
+      return this.request(
+        `/users/me/venue-accounts/${encodeURIComponent(venue)}/deposit-address`,
+        { query: params.mode ? { mode: params.mode } : void 0 }
+      );
+    });
+  }
+  /** Submit exactly one explicit hosted withdrawal under a caller idempotency key. */
+  withdrawHostedVenue(venue, body) {
+    return __async(this, null, function* () {
+      return this.request(
+        `/users/me/venue-accounts/${encodeURIComponent(venue)}/withdrawals`,
+        { method: "POST", body: JSON.stringify(body) }
+      );
+    });
+  }
+  /** Read only Agg's persisted withdrawal state; this never replays a native request. */
+  getHostedVenueWithdrawal(_0, _1) {
+    return __async(this, arguments, function* (venue, withdrawalId, params = {}) {
+      if (!withdrawalId) throw new Error("withdrawalId is required");
+      return this.request(
+        `/users/me/venue-accounts/${encodeURIComponent(venue)}/withdrawals/${encodeURIComponent(withdrawalId)}`,
+        { query: params.mode ? { mode: params.mode } : void 0 }
+      );
+    });
+  }
   /** Store or replace encrypted credentials for a venue. Secrets are never returned. */
   upsertVenueKey(body) {
     return __async(this, null, function* () {
@@ -2708,21 +1289,32 @@ Issued At: ${issuedAt}`;
     });
   }
   /**
-   * Cancel an execution by order id. Self-custody needs Polymarket ClobAuth
+   * Cancel an agg order by id. Self-custody needs Polymarket ClobAuth
    * or a fresh Hyperliquid cancel action signed by the EOA/client-held agent.
    */
   cancelManagedOrder(orderId, options) {
     return __async(this, null, function* () {
-      return this.request(
-        `/execution/orders/${encodeURIComponent(orderId)}/cancel`,
-        {
-          method: "POST",
-          body: JSON.stringify(
-            (options == null ? void 0 : options.cancelSignature) ? { cancelSignature: options.cancelSignature } : {}
-          ),
-          signal: options == null ? void 0 : options.signal
-        }
-      );
+      return this.request("/execution/orders/cancel", {
+        method: "POST",
+        body: JSON.stringify(__spreadValues({
+          orderId
+        }, (options == null ? void 0 : options.cancelSignature) ? { cancelSignature: options.cancelSignature } : {})),
+        signal: options == null ? void 0 : options.signal
+      });
+    });
+  }
+  /**
+   * Cancel a Polymarket or Hyperliquid limit order that one of the user's
+   * linked self-custody wallets placed outside AGG. `signerAddress` must be
+   * that wallet and must have produced `cancelSignature`.
+   */
+  cancelVenueOrder(params, options) {
+    return __async(this, null, function* () {
+      return this.request("/execution/orders/cancel", {
+        method: "POST",
+        body: JSON.stringify(params),
+        signal: options == null ? void 0 : options.signal
+      });
     });
   }
   // --- Venue events & venue markets (primary) ---
@@ -2755,6 +1347,17 @@ Issued At: ${issuedAt}`;
     });
   }
   /** Get a single venue event by ID. Requires appId or admin auth. */
+  getEventBootstrap(eventId, options) {
+    return __async(this, null, function* () {
+      return this.request(
+        `/venue-events/${encodeURIComponent(eventId)}/bootstrap`,
+        {
+          query: (options == null ? void 0 : options.limit) ? { limit: String(options.limit) } : void 0,
+          signal: options == null ? void 0 : options.signal
+        }
+      );
+    });
+  }
   getVenueEventById(id, options) {
     return __async(this, null, function* () {
       return this.request(`/venue-events/${encodeURIComponent(id)}`, {
@@ -2883,14 +1486,15 @@ Issued At: ${issuedAt}`;
     });
   }
   /** List venue markets with optional filters. Requires appId or admin auth. Supports cursor-based pagination. */
-  getVenueMarkets(options) {
+  getVenueMarkets(options, requestOptions) {
     return __async(this, null, function* () {
-      var _a;
+      var _a, _b;
       const query = {};
       if (options == null ? void 0 : options.venue) query.venue = options.venue;
+      if ((_a = options == null ? void 0 : options.externalIdentifier) == null ? void 0 : _a.length) query.externalIdentifier = options.externalIdentifier;
       if (options == null ? void 0 : options.venueEventId) query.venueEventId = options.venueEventId;
       if ((options == null ? void 0 : options.cluster) === false) query.cluster = "false";
-      if ((_a = options == null ? void 0 : options.search) == null ? void 0 : _a.trim()) query.search = options.search.trim();
+      if ((_b = options == null ? void 0 : options.search) == null ? void 0 : _b.trim()) query.search = options.search.trim();
       if (options == null ? void 0 : options.matchStatus) query.matchStatus = options.matchStatus;
       if (options == null ? void 0 : options.status) query.status = options.status;
       if ((options == null ? void 0 : options.aggKey) && options.aggKey.length > 0) query.aggKey = options.aggKey;
@@ -2910,7 +1514,8 @@ Issued At: ${issuedAt}`;
       if (options == null ? void 0 : options.sortDir) query.sortDir = options.sortDir;
       if (options == null ? void 0 : options.context) query.context = options.context;
       return this.request("/venue-markets", {
-        query: Object.keys(query).length > 0 ? query : void 0
+        query: Object.keys(query).length > 0 ? query : void 0,
+        signal: requestOptions == null ? void 0 : requestOptions.signal
       });
     });
   }
@@ -3012,7 +1617,7 @@ Issued At: ${issuedAt}`;
    * format intentionally omits the param so the server hits the cheaper
    * (and longer-TTL) light cache slot.
    */
-  search(params) {
+  search(params, options) {
     return __async(this, null, function* () {
       const query = {
         q: params.q,
@@ -3023,8 +1628,10 @@ Issued At: ${issuedAt}`;
       if (params.limit != null) query.limit = String(params.limit);
       if (params.cursor) query.cursor = params.cursor;
       if (params.deep) query.deepSearch = "true";
+      if (params.mode) query.mode = params.mode;
       return this.request("/search", {
-        query
+        query,
+        signal: options == null ? void 0 : options.signal
       });
     });
   }
@@ -3086,6 +1693,7 @@ Issued At: ${issuedAt}`;
   /** Get the canonical TradingView-style bar series for a single venue market outcome. */
   getChartBars(params, options) {
     return __async(this, null, function* () {
+      var _a, _b;
       const resolution = mapChartResolution(params.resolution);
       const query = {
         venueMarketOutcomeId: params.venueMarketOutcomeId,
@@ -3094,12 +1702,39 @@ Issued At: ${issuedAt}`;
       if (resolution) query.resolution = resolution;
       if (params.from != null) query.from = String(params.from);
       if (params.countBack != null) query.countBack = String(params.countBack);
+      if (options == null ? void 0 : options.decode) {
+        const text = yield this.request(
+          "/charts/bars",
+          { query, signal: options.signal },
+          (response) => readChartHistoryText(response)
+        );
+        (_a = options.signal) == null ? void 0 : _a.throwIfAborted();
+        const decoded = yield options.decode(text);
+        (_b = options.signal) == null ? void 0 : _b.throwIfAborted();
+        return decoded;
+      }
       return this.request("/charts/bars", {
         query,
         signal: options == null ? void 0 : options.signal
       });
     });
   }
+  getChartHistoryManifest(params, options) {
+    return __async(this, null, function* () {
+      const query = {
+        venueMarketOutcomeId: params.venueMarketOutcomeId,
+        to: String(params.to)
+      };
+      const resolution = mapChartResolution(params.resolution);
+      if (resolution) query.resolution = resolution;
+      if (params.from != null) query.from = String(params.from);
+      if (params.countBack != null) query.countBack = String(params.countBack);
+      return this.request("/charts/history/manifest", {
+        query,
+        signal: options == null ? void 0 : options.signal
+      });
+    });
+  }
   // --- Batch orderbooks ---
   /** Get live per-venue orderbooks for the explicit venueMarketIds requested. */
   getOrderbooks(params, options) {
@@ -3194,22 +1829,34 @@ Issued At: ${issuedAt}`;
       return params.side ? __spreadProps(__spreadValues({}, response), { side: params.side }) : response;
     });
   }
+  /** Seed subscribed outcomes with one bounded batch of compatible snapshots. */
+  getOutcomeOrderbooks(params, options) {
+    return __async(this, null, function* () {
+      return this.request("/orderbooks/outcomes", {
+        query: __spreadValues({
+          venueMarketOutcomeIds: params.venueMarketOutcomeIds.join(",")
+        }, params.depth == null ? {} : { depth: String(params.depth) }),
+        signal: options == null ? void 0 : options.signal
+      });
+    });
+  }
   /**
    * Create an AggWebSocket instance configured with this client's appId and optional auth token.
    * Requires `wsUrl` to be set in the client options.
    */
   createWebSocket(callbacks, options) {
-    var _a;
+    var _a, _b;
     if (!this.wsUrl) {
       throw new Error("AggClient.createWebSocket() requires wsUrl to be set in client options");
     }
     const url = new URL(this.wsUrl);
     if (this._appId) url.searchParams.set("appId", this._appId);
-    return new AggWebSocket({
+    const createSocket = (_a = this.webSocketFactory) != null ? _a : ((socketOptions) => new AggWebSocket(socketOptions));
+    return createSocket({
       url: url.toString(),
       callbacks,
       initialToken: this.accessToken,
-      enableLogs: (_a = options == null ? void 0 : options.enableLogs) != null ? _a : false
+      enableLogs: (_b = options == null ? void 0 : options.enableLogs) != null ? _b : false
     });
   }
   /** Execute a previously quoted managed trade. Returns pending order IDs. */
@@ -3505,138 +2152,6 @@ Issued At: ${issuedAt}`;
 // src/best-split.ts
 var computeBestSplitsByAmount2 = computeBestSplitsByAmount;
 
-// src/candle-builder.ts
-var INTERVAL_SECS = {
-  "1m": 60,
-  "5m": 300,
-  "1h": 3600,
-  "1d": 86400
-};
-var ALL_INTERVALS = ["1m", "5m", "1h", "1d"];
-var MAX_CLOSED = 500;
-var CandleBuilder = class {
-  constructor() {
-    this.forming = /* @__PURE__ */ new Map();
-    this.closedMap = /* @__PURE__ */ new Map();
-    this.listeners = /* @__PURE__ */ new Set();
-    this._midpoint = null;
-    this.dirty = false;
-    this.scheduled = false;
-    for (const interval of ALL_INTERVALS) {
-      this.closedMap.set(interval, []);
-    }
-  }
-  /** Feed a midpoint (from orderbook delta). Updates O/H/L/C for all intervals. */
-  addMidpoint(midpoint, timestampSecs) {
-    if (!Number.isFinite(midpoint) || !Number.isFinite(timestampSecs)) return;
-    this._midpoint = midpoint;
-    for (const interval of ALL_INTERVALS) {
-      this.updateCandle(interval, midpoint, timestampSecs);
-    }
-    this.markDirty();
-  }
-  /** Feed a trade. Updates volume + refines H/L/C from trade price. */
-  addTrade(price, size, timestampSecs) {
-    if (!Number.isFinite(price) || !Number.isFinite(size) || !Number.isFinite(timestampSecs))
-      return;
-    for (const interval of ALL_INTERVALS) {
-      this.updateCandle(interval, price, timestampSecs, size);
-    }
-    this.markDirty();
-  }
-  /** Current forming candle for an interval. */
-  getForming(interval) {
-    var _a;
-    return (_a = this.forming.get(interval)) != null ? _a : null;
-  }
-  /** Closed candles for an interval (ring buffer, max 500, newest last). */
-  getClosed(interval) {
-    var _a;
-    return (_a = this.closedMap.get(interval)) != null ? _a : [];
-  }
-  /** Current midpoint (latest value fed). */
-  get midpoint() {
-    return this._midpoint;
-  }
-  /**
-   * Subscribe to state changes. Returns unsubscribe function.
-   * BATCHED: callbacks fire at most once per rAF frame (~16ms).
-   * In non-browser environments, falls back to 16ms setTimeout.
-   */
-  onChange(listener) {
-    this.listeners.add(listener);
-    return () => {
-      this.listeners.delete(listener);
-    };
-  }
-  /** Clear all state (on reconnect). */
-  reset() {
-    this.forming.clear();
-    for (const interval of ALL_INTERVALS) {
-      this.closedMap.set(interval, []);
-    }
-    this._midpoint = null;
-    this.dirty = false;
-  }
-  /** Clear all state AND unsubscribe all listeners. Called on store eviction. */
-  dispose() {
-    this.reset();
-    this.listeners.clear();
-  }
-  updateCandle(interval, price, timestampSecs, tradeSize) {
-    const secs = INTERVAL_SECS[interval];
-    const openTime = Math.floor(timestampSecs / secs) * secs;
-    const current = this.forming.get(interval);
-    if (current && current.openTime !== openTime) {
-      const closed = this.closedMap.get(interval);
-      closed.push(__spreadProps(__spreadValues({}, current), { isFinal: true }));
-      if (closed.length > MAX_CLOSED) closed.shift();
-      this.forming.set(interval, {
-        openTime,
-        o: price,
-        h: price,
-        l: price,
-        c: price,
-        v: tradeSize != null ? tradeSize : 0,
-        tradeCount: tradeSize != null ? 1 : 0,
-        isFinal: false
-      });
-    } else if (!current) {
-      this.forming.set(interval, {
-        openTime,
-        o: price,
-        h: price,
-        l: price,
-        c: price,
-        v: tradeSize != null ? tradeSize : 0,
-        tradeCount: tradeSize != null ? 1 : 0,
-        isFinal: false
-      });
-    } else {
-      current.h = Math.max(current.h, price);
-      current.l = Math.min(current.l, price);
-      current.c = price;
-      if (tradeSize != null) {
-        current.v += tradeSize;
-        current.tradeCount += 1;
-      }
-    }
-  }
-  markDirty() {
-    this.dirty = true;
-    if (this.scheduled) return;
-    this.scheduled = true;
-    const tick = typeof requestAnimationFrame === "function" ? requestAnimationFrame : (fn) => setTimeout(fn, 16);
-    tick(() => {
-      this.scheduled = false;
-      if (this.dirty) {
-        this.dirty = false;
-        this.listeners.forEach((l) => l());
-      }
-    });
-  }
-};
-
 // src/market-aggregator.ts
 function mergeCandles(candles) {
   const valid = candles.filter((c2) => c2 != null);
@@ -3715,6 +2230,7 @@ export {
   OrderStatus,
   OrderType,
   RECURRENCE_CADENCES,
+  RETINA_IMAGE_SIZES,
   SELF_CUSTODY_FILL_TIMEOUT_MS,
   SELF_CUSTODY_POLL_INTERVAL_MS,
   TERMINAL_EXECUTION_STATES,
@@ -3748,13 +2264,17 @@ export {
   isVenueActive,
   isVenueDataVisible,
   isVenueInactive,
+  loadImmutableHistory,
   mergeCandles,
   mergeClosedCandles,
   normalizeVenueMarketCluster,
   optimizedImageUrl,
+  orderbookCrc32,
   parse,
   parseEmail,
   parseEmailStrict,
+  projectedOrderbookChecksum,
+  retinaImageUrl,
   safeParse,
   snapshotToOrderbook,
   sortVenues,